add-cms

source/admin/packages/decap-cms-ui-auth/CHANGELOG.md

@@ -0,0 +1,8 @@
+# Change Log
+
+All notable changes to this project will be documented in this file.
+See [Conventional Commits](https://conventionalcommits.org) for commit guidelines.
+
+## 3.2.3 (2025-07-31)
+
+**Note:** Version bump only for package decap-cms-ui-auth

source/admin/packages/decap-cms-ui-auth/README.md

@@ -0,0 +1,28 @@
+# decap-cms-ui-auth
+
+Authentication UI pages used by the decap-cms-backend-* packages.
+
+## Common Behavior
+
+* An authenticator must return the following fields:
+  * email
+  * token?
+  * expires?
+
+## Components
+
+* **NetlifyAuthenticationPage**
+    * Username and password fields that are passed to Netlify Identity.
+    * Requires a static `authClient` value set before login will work, expected to be set by the backend implementation.
+  * Returns object that satisfies the GitGatewayUser type (and inherited Credentials type) from Netlify
+* **PKCEAuthenticationPage**
+    * OAuth2 PKCE flow with optional OIDC auto-configuration.
+    * Returns object that satisfies the GitGatewayUser type (and inherited Credentials type), with additional data:
+        * token (part of Credentials definition): the access token
+        * idToken: if available
+        * claims: if available (decoded access token)
+        * idClaims: if available (decoded ID token)
+        * email: mapped email value from the token claims, if available
+        * user_metadata.full_name: mapped value from the token claims, if available
+        * user_metadata.avatar_url: mapped value from the token claims, if available
+

source/admin/packages/decap-cms-ui-auth/index.d.ts

@@ -0,0 +1,16 @@
+declare module 'decap-cms-ui-auth' {
+  import React from 'react';
+
+  import type { Implementation } from 'decap-cms-lib-util/src';
+
+  class PKCEAuthenticationPage extends React.Component {
+    constructor({ backend }: { backend: Implementation });
+    handleLogin(e: ChangeEvent<HTMLInputElement>): void;
+  }
+  class NetlifyAuthenticationPage extends React.Component {
+    handleLogin(e: ChangeEvent<HTMLInputElement>): void;
+    static authClient: () => Promise;
+  }
+
+  export { PKCEAuthenticationPage, NetlifyAuthenticationPage };
+}