@ankhorage/studio 2.0.23 → 2.0.25

package/dist/ui/admin/pages/ThemeTypographyWeightEditor.js.map

@@ -1 +1 @@
-{"version":3,"file":"ThemeTypographyWeightEditor.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/ThemeTypographyWeightEditor.tsx"],"names":[],"mappings":"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"}
+{"version":3,"file":"ThemeTypographyWeightEditor.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/ThemeTypographyWeightEditor.tsx"],"names":[],"mappings":"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"}

package/dist/ui/admin/pages/adminApiOperations.d.ts

@@ -12,5 +12,9 @@ export interface ApiOperationRow {
     readonly apiProtocol: 'graphql' | 'rest';
     readonly testable: boolean;
 }
+/***
+ * Flatten canonical API definitions, endpoints, and operations into administration-table rows with inherited path/origin metadata.
+ * @todo Move this external-API administration projection from `ui/` into the external-apis application/presentation model domain.
+ */
 export declare function collectApiOperationRows(apis: ApiDefinitionList): ApiOperationRow[];
 //# sourceMappingURL=adminApiOperations.d.ts.map

package/dist/ui/admin/pages/adminApiOperations.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adminApiOperations.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminApiOperations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAkBlF"}
+{"version":3,"file":"adminApiOperations.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminApiOperations.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,2BAA2B,CAAC;AAEnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,WAAW,EAAE,MAAM,CAAC;IAC7B,QAAQ,CAAC,IAAI,CAAC,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,QAAQ,EAAE,MAAM,CAAC;IAC1B,QAAQ,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC;IAC/B,QAAQ,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,QAAQ,CAAC,SAAS,EAAE,UAAU,GAAG,UAAU,CAAC;IAC5C,QAAQ,CAAC,WAAW,EAAE,SAAS,GAAG,MAAM,CAAC;IACzC,QAAQ,CAAC,QAAQ,EAAE,OAAO,CAAC;CAC5B;AAED;;;GAGG;AACH,wBAAgB,uBAAuB,CAAC,IAAI,EAAE,iBAAiB,GAAG,eAAe,EAAE,CAkBlF"}

package/dist/ui/admin/pages/adminApiOperations.js

@@ -1,3 +1,7 @@
+/***
+ * Flatten canonical API definitions, endpoints, and operations into administration-table rows with inherited path/origin metadata.
+ * @todo Move this external-API administration projection from `ui/` into the external-apis application/presentation model domain.
+ */
 export function collectApiOperationRows(apis) {
     return apis.flatMap((api) => Object.entries(api.endpoints).flatMap(([endpointId, endpoint]) => Object.entries(endpoint.operations).map(([operationId, operation]) => ({
         apiId: api.id,

package/dist/ui/admin/pages/adminApiOperations.js.map

@@ -1 +1 @@
-{"version":3,"file":"adminApiOperations.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminApiOperations.ts"],"names":[],"mappings":"AAgBA,MAAM,UAAU,uBAAuB,CAAC,IAAuB;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAC/D,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,UAAU;QACV,WAAW;QACX,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,IAAI;QAChC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI;QAC7C,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,WAAW,EAAE,GAAG,CAAC,QAAQ;QACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,KAAK,UAAU;KACpC,CAAC,CAAC,CACJ,CACF,CAAC;AACJ,CAAC"}
+{"version":3,"file":"adminApiOperations.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminApiOperations.ts"],"names":[],"mappings":"AAgBA;;;GAGG;AACH,MAAM,UAAU,uBAAuB,CAAC,IAAuB;IAC7D,OAAO,IAAI,CAAC,OAAO,CAAC,CAAC,GAAG,EAAE,EAAE,CAC1B,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC,OAAO,CAAC,CAAC,CAAC,UAAU,EAAE,QAAQ,CAAC,EAAE,EAAE,CAC/D,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,UAAU,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,WAAW,EAAE,SAAS,CAAC,EAAE,EAAE,CAAC,CAAC;QACrE,KAAK,EAAE,GAAG,CAAC,EAAE;QACb,UAAU;QACV,WAAW;QACX,IAAI,EAAE,SAAS,CAAC,IAAI;QACpB,MAAM,EAAE,SAAS,CAAC,MAAM;QACxB,QAAQ,EAAE,SAAS,CAAC,QAAQ;QAC5B,MAAM,EAAE,SAAS,CAAC,MAAM,IAAI,IAAI;QAChC,IAAI,EAAE,SAAS,CAAC,IAAI,IAAI,QAAQ,CAAC,IAAI,IAAI,IAAI;QAC7C,SAAS,EAAE,GAAG,CAAC,MAAM;QACrB,WAAW,EAAE,GAAG,CAAC,QAAQ;QACzB,QAAQ,EAAE,GAAG,CAAC,MAAM,KAAK,UAAU;KACpC,CAAC,CAAC,CACJ,CACF,CAAC;AACJ,CAAC"}

package/dist/ui/admin/pages/adminAuthCredentialFlow.d.ts

@@ -15,6 +15,10 @@ export type StoredOAuthCredentialLinkResult = {
     readonly pendingLink: StoredOAuthCredentialLink;
     readonly message: string;
 };
+/***
+ * Persist a newly stored OAuth credential reference into auth settings, rollback the optimistic manifest mutation on flush failure, and refresh health on success.
+ * @todo Move this transaction/orchestration from admin UI into the auth application domain.
+ */
 export declare function persistStoredOAuthCredentialLink(args: {
     readonly link: StoredOAuthCredentialLink;
     readonly mutateAuthSettings: (mutation: StudioAuthSettingsMutation) => StudioAuthSettings | null;
@@ -22,11 +26,14 @@ export declare function persistStoredOAuthCredentialLink(args: {
     readonly refreshHealth: () => Promise<void>;
     readonly toMessage: (error: unknown) => string;
 }): Promise<StoredOAuthCredentialLinkResult>;
+/*** Apply one stored OAuth credential link to the local auth draft without persistence side effects. */
 export declare function patchLocalAuthDraftWithStoredOAuthCredentialLink(settings: StudioAuthSettings, link: StoredOAuthCredentialLink): StudioAuthSettings;
+/*** Persist one credential link and patch the local draft only when persistence succeeds. */
 export declare function persistStoredOAuthCredentialLinkAndPatchLocalDraft(args: {
     readonly link: StoredOAuthCredentialLink;
     readonly persistCredentialLink: (link: StoredOAuthCredentialLink) => Promise<StoredOAuthCredentialLinkResult>;
     readonly patchDraft: (mutation: (current: StudioAuthSettings) => StudioAuthSettings) => void;
 }): Promise<StoredOAuthCredentialLinkResult>;
+/*** Insert or update the OAuth provider matching a stored credential link while preserving unrelated auth settings. */
 export declare function applyStoredOAuthCredentialLink(settings: StudioAuthSettings | null, link: StoredOAuthCredentialLink): StudioAuthSettings;
 //# sourceMappingURL=adminAuthCredentialFlow.d.ts.map

package/dist/ui/admin/pages/adminAuthCredentialFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adminAuthCredentialFlow.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthCredentialFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAE5F,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,uBAAuB,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IAC9F,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,+BAA+B,GACvC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAWN,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,kBAAkB,GAAG,IAAI,CAAC;IACjG,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAChD,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAoB3C;AAED,wBAAgB,gDAAgD,CAC9D,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,yBAAyB,GAC9B,kBAAkB,CAEpB;AAED,wBAAsB,kDAAkD,CAAC,IAAI,EAAE;IAC7E,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,qBAAqB,EAAE,CAC9B,IAAI,EAAE,yBAAyB,KAC5B,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,kBAAkB,KAAK,IAAI,CAAC;CAC9F,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAQ3C;AAED,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,IAAI,EAAE,yBAAyB,GAC9B,kBAAkB,CAsBpB"}
+{"version":3,"file":"adminAuthCredentialFlow.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthCredentialFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,uBAAuB,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAGzF,OAAO,KAAK,EAAE,kBAAkB,EAAE,0BAA0B,EAAE,MAAM,uBAAuB,CAAC;AAE5F,MAAM,WAAW,yBAAyB;IACxC,QAAQ,CAAC,UAAU,EAAE,mBAAmB,CAAC;IACzC,QAAQ,CAAC,aAAa,EAAE,MAAM,CAAC;IAC/B,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;IAChC,QAAQ,CAAC,gBAAgB,EAAE,IAAI,CAAC,uBAAuB,EAAE,gBAAgB,GAAG,SAAS,GAAG,IAAI,CAAC,CAAC;IAC9F,QAAQ,CAAC,cAAc,EAAE,MAAM,CAAC;CACjC;AAED,MAAM,MAAM,+BAA+B,GACvC;IACE,QAAQ,CAAC,EAAE,EAAE,IAAI,CAAC;IAClB,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,GACD;IACE,QAAQ,CAAC,EAAE,EAAE,KAAK,CAAC;IACnB,QAAQ,CAAC,WAAW,EAAE,yBAAyB,CAAC;IAChD,QAAQ,CAAC,OAAO,EAAE,MAAM,CAAC;CAC1B,CAAC;AAWN;;;GAGG;AACH,wBAAsB,gCAAgC,CAAC,IAAI,EAAE;IAC3D,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,kBAAkB,EAAE,CAAC,QAAQ,EAAE,0BAA0B,KAAK,kBAAkB,GAAG,IAAI,CAAC;IACjG,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,aAAa,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,CAAC;IAC5C,QAAQ,CAAC,SAAS,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,MAAM,CAAC;CAChD,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAoB3C;AAED,wGAAwG;AACxG,wBAAgB,gDAAgD,CAC9D,QAAQ,EAAE,kBAAkB,EAC5B,IAAI,EAAE,yBAAyB,GAC9B,kBAAkB,CAEpB;AAED,6FAA6F;AAC7F,wBAAsB,kDAAkD,CAAC,IAAI,EAAE;IAC7E,QAAQ,CAAC,IAAI,EAAE,yBAAyB,CAAC;IACzC,QAAQ,CAAC,qBAAqB,EAAE,CAC9B,IAAI,EAAE,yBAAyB,KAC5B,OAAO,CAAC,+BAA+B,CAAC,CAAC;IAC9C,QAAQ,CAAC,UAAU,EAAE,CAAC,QAAQ,EAAE,CAAC,OAAO,EAAE,kBAAkB,KAAK,kBAAkB,KAAK,IAAI,CAAC;CAC9F,GAAG,OAAO,CAAC,+BAA+B,CAAC,CAQ3C;AAED,uHAAuH;AACvH,wBAAgB,8BAA8B,CAC5C,QAAQ,EAAE,kBAAkB,GAAG,IAAI,EACnC,IAAI,EAAE,yBAAyB,GAC9B,kBAAkB,CAsBpB"}

package/dist/ui/admin/pages/adminAuthCredentialFlow.js

@@ -1,4 +1,8 @@
 import { DEFAULT_AUTH_FLOW } from '@ankhorage/contracts';
+/***
+ * Persist a newly stored OAuth credential reference into auth settings, rollback the optimistic manifest mutation on flush failure, and refresh health on success.
+ * @todo Move this transaction/orchestration from admin UI into the auth application domain.
+ */
 export async function persistStoredOAuthCredentialLink(args) {
     let rollback;
     args.mutateAuthSettings((current) => {
@@ -19,9 +23,11 @@ export async function persistStoredOAuthCredentialLink(args) {
     await args.refreshHealth();
     return { ok: true, message: args.link.successMessage };
 }
+/*** Apply one stored OAuth credential link to the local auth draft without persistence side effects. */
 export function patchLocalAuthDraftWithStoredOAuthCredentialLink(settings, link) {
     return applyStoredOAuthCredentialLink(settings, link);
 }
+/*** Persist one credential link and patch the local draft only when persistence succeeds. */
 export async function persistStoredOAuthCredentialLinkAndPatchLocalDraft(args) {
     const result = await args.persistCredentialLink(args.link);
     if (result.ok) {
@@ -29,6 +35,7 @@ export async function persistStoredOAuthCredentialLinkAndPatchLocalDraft(args) {
     }
     return result;
 }
+/*** Insert or update the OAuth provider matching a stored credential link while preserving unrelated auth settings. */
 export function applyStoredOAuthCredentialLink(settings, link) {
     const nextSettings = settings ?? createDefaultAuthSettings();
     const oauth = nextSettings.oauth ?? createDefaultOAuthSettings();
@@ -51,6 +58,7 @@ export function applyStoredOAuthCredentialLink(settings, link) {
         },
     };
 }
+/*** Capture the pre-transaction auth/provider shape required to safely undo one optimistic credential-link mutation. */
 function createStoredOAuthCredentialRollback(settings, link) {
     const oauth = settings?.oauth;
     const previousProvider = oauth?.providers.find((provider) => provider.id === link.providerId) ?? null;
@@ -70,6 +78,7 @@ function createStoredOAuthCredentialRollback(settings, link) {
         insertedProvider,
     };
 }
+/*** Roll back only the credential-link structure introduced by the matching optimistic transaction. */
 function rollbackStoredOAuthCredentialLink(settings, rollback) {
     if (!settings?.oauth)
         return settings;
@@ -91,6 +100,7 @@ function rollbackStoredOAuthCredentialLink(settings, rollback) {
     };
     return removeTransactionIntroducedStructure(nextSettings, rollback);
 }
+/*** Restore a provider's previous optional credential reference while retaining other concurrent provider edits. */
 function restoreProviderCredentialsRef(currentProvider, previousProvider) {
     const { credentialsRef: _currentCredentialsRef, ...currentWithoutCredentialsRef } = currentProvider;
     if (previousProvider.credentialsRef === undefined) {
@@ -101,6 +111,7 @@ function restoreProviderCredentialsRef(currentProvider, previousProvider) {
         credentialsRef: previousProvider.credentialsRef,
     };
 }
+/*** Remove the provider inserted by a failed transaction or strip only its failed credential reference when other provider fields changed concurrently. */
 function removeInsertedOrFailedCredentialsRef(providers, rollback) {
     return providers.flatMap((provider) => {
         if (provider.id !== rollback.providerId)
@@ -111,9 +122,14 @@ function removeInsertedOrFailedCredentialsRef(providers, rollback) {
         return [providerWithoutCredentialsRef];
     });
 }
+/***
+ * Compare two JSON-compatible values by their serialized representation.
+ * @utility @ankhorage/utility/equality
+ */
 function areOAuthProvidersEqual(left, right) {
     return JSON.stringify(left) === JSON.stringify(right);
 }
+/*** Remove auth/OAuth shells that were created solely for a failed credential-link transaction. */
 function removeTransactionIntroducedStructure(settings, rollback) {
     const withoutIntroducedOAuth = !rollback.oauthExistedBefore && settings.oauth && isDefaultOAuthSettings(settings.oauth)
         ? omitOAuth(settings)
@@ -125,15 +141,21 @@ function removeTransactionIntroducedStructure(settings, rollback) {
     }
     return withoutIntroducedOAuth;
 }
+/***
+ * Return an object copy without one known property; parameterizing the property key yields a reusable immutable omit primitive.
+ * @utility @ankhorage/utility/object
+ */
 function omitOAuth(settings) {
     const { oauth: _oauth, ...rest } = settings;
     return rest;
 }
+/*** Return whether an OAuth settings object exactly matches the default shell introduced by the credential flow. */
 function isDefaultOAuthSettings(oauth) {
     return (oauth.enabled === false &&
         oauth.callbackRoute === '/auth/callback' &&
         oauth.providers.length === 0);
 }
+/*** Return whether auth settings exactly match the default auth shell introduced by this flow. */
 function isDefaultAuthShell(settings) {
     return (settings.scope === 'none' &&
         settings.provider === 'supabase' &&
@@ -143,6 +165,7 @@ function isDefaultAuthShell(settings) {
         settings.signUp === undefined &&
         settings.profile === undefined);
 }
+/*** Create the default Studio auth shell required before adding an OAuth credential link. */
 function createDefaultAuthSettings() {
     return {
         scope: 'none',
@@ -152,6 +175,7 @@ function createDefaultAuthSettings() {
         oauth: createDefaultOAuthSettings(),
     };
 }
+/*** Create the default OAuth configuration shell used when auth settings do not yet contain OAuth state. */
 function createDefaultOAuthSettings() {
     return {
         enabled: false,
@@ -159,6 +183,10 @@ function createDefaultOAuthSettings() {
         providers: [],
     };
 }
+/***
+ * Immutably insert or replace an array entry selected by a key projection; this instance keys OAuth providers by id.
+ * @utility @ankhorage/utility/array
+ */
 function upsertOAuthProvider(providers, provider) {
     const index = providers.findIndex((candidate) => candidate.id === provider.id);
     if (index < 0)

package/dist/ui/admin/pages/adminAuthCredentialFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"adminAuthCredentialFlow.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthCredentialFlow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAgCzD,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,IAMtD;IACC,IAAI,QAAwC,CAAC;IAC7C,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,EAAE;QAClC,QAAQ,GAAG,mCAAmC,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iCAAiC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,iFAAiF,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;SAC5I,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;AACzD,CAAC;AAED,MAAM,UAAU,gDAAgD,CAC9D,QAA4B,EAC5B,IAA+B;IAE/B,OAAO,8BAA8B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,kDAAkD,CAAC,IAMxE;IACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1B,gDAAgD,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,MAAM,UAAU,8BAA8B,CAC5C,QAAmC,EACnC,IAA+B;IAE/B,MAAM,YAAY,GAAG,QAAQ,IAAI,yBAAyB,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,0BAA0B,EAAE,CAAC;IACjE,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7F,MAAM,YAAY,GAAG,gBAAgB;QACnC,CAAC,CAAC;YACE,GAAG,gBAAgB;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC;QACH,CAAC,CAAC;YACE,EAAE,EAAE,IAAI,CAAC,UAAU;YACnB,GAAG,IAAI,CAAC,gBAAgB;YACxB,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;IAEN,OAAO;QACL,GAAG,YAAY;QACf,KAAK,EAAE;YACL,GAAG,KAAK;YACR,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC;SAC9D;KACF,CAAC;AACJ,CAAC;AAED,SAAS,mCAAmC,CAC1C,QAAmC,EACnC,IAA+B;IAE/B,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,CAAC;IAC9B,MAAM,gBAAgB,GACpB,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAC/E,MAAM,YAAY,GAAG,8BAA8B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,gBAAgB,GACpB,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC;QAChF;YACC,EAAE,EAAE,IAAI,CAAC,UAAU;YACnB,GAAG,IAAI,CAAC,gBAAgB;YACxB,cAAc,EAAE,IAAI,CAAC,cAAc;SACD,CAAC;IAEvC,OAAO;QACL,iBAAiB,EAAE,QAAQ,KAAK,IAAI;QACpC,kBAAkB,EAAE,KAAK,KAAK,SAAS;QACvC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,gBAAgB;QAChB,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,SAAS,iCAAiC,CACxC,QAAmC,EACnC,QAAuC;IAEvC,IAAI,CAAC,QAAQ,EAAE,KAAK;QAAE,OAAO,QAAQ,CAAC;IAEtC,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CACnD,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,CAClD,CAAC;IAEF,MAAM,EAAE,gBAAgB,EAAE,GAAG,QAAQ,CAAC;IACtC,MAAM,SAAS,GACb,eAAe,EAAE,cAAc,KAAK,QAAQ,CAAC,cAAc;QACzD,CAAC,CAAC,gBAAgB,KAAK,IAAI;YACzB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACxC,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU;gBACjC,CAAC,CAAC,6BAA6B,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAC3D,CAAC,CAAC,QAAQ,CACb;YACH,CAAC,CAAC,oCAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC5E,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;IAE/B,MAAM,YAAY,GAAuB;QACvC,GAAG,QAAQ;QACX,KAAK,EAAE;YACL,GAAG,QAAQ,CAAC,KAAK;YACjB,SAAS;SACV;KACF,CAAC;IAEF,OAAO,oCAAoC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED,SAAS,6BAA6B,CACpC,eAAwC,EACxC,gBAAyC;IAEzC,MAAM,EAAE,cAAc,EAAE,sBAAsB,EAAE,GAAG,4BAA4B,EAAE,GAC/E,eAAe,CAAC;IAClB,IAAI,gBAAgB,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,OAAO;QACL,GAAG,eAAe;QAClB,cAAc,EAAE,gBAAgB,CAAC,cAAc;KAChD,CAAC;AACJ,CAAC;AAED,SAAS,oCAAoC,CAC3C,SAA6C,EAC7C,QAAuC;IAEvC,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpC,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU;YAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC;YAAE,OAAO,EAAE,CAAC;QAE3E,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,6BAA6B,EAAE,GAAG,QAAQ,CAAC;QACvF,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED,SAAS,sBAAsB,CAC7B,IAA6B,EAC7B,KAA8B;IAE9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,SAAS,oCAAoC,CAC3C,QAA4B,EAC5B,QAAuC;IAEvC,MAAM,sBAAsB,GAC1B,CAAC,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,KAAK,IAAI,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC;QACtF,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC;IAEf,IACE,CAAC,QAAQ,CAAC,iBAAiB;QAC3B,sBAAsB,CAAC,KAAK,KAAK,SAAS;QAC1C,kBAAkB,CAAC,sBAAsB,CAAC,EAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED,SAAS,SAAS,CAAC,QAA4B;IAC7C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,sBAAsB,CAAC,KAA+C;IAC7E,OAAO,CACL,KAAK,CAAC,OAAO,KAAK,KAAK;QACvB,KAAK,CAAC,aAAa,KAAK,gBAAgB;QACxC,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAC7B,CAAC;AACJ,CAAC;AAED,SAAS,kBAAkB,CAAC,QAA4B;IACtD,OAAO,CACL,QAAQ,CAAC,KAAK,KAAK,MAAM;QACzB,QAAQ,CAAC,QAAQ,KAAK,UAAU;QAChC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;QACnE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO;QAC1C,QAAQ,CAAC,MAAM,KAAK,SAAS;QAC7B,QAAQ,CAAC,OAAO,KAAK,SAAS,CAC/B,CAAC;AACJ,CAAC;AAED,SAAS,yBAAyB;IAChC,OAAO;QACL,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,EAAE,GAAG,iBAAiB,EAAE;QAC9B,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;QAClC,KAAK,EAAE,0BAA0B,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,SAAS,0BAA0B;IACjC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,gBAAgB;QAC/B,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED,SAAS,mBAAmB,CAC1B,SAAgE,EAChE,QAAiC;IAEjC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/E,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CACjD,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAChD,CAAC;AACJ,CAAC"}
+{"version":3,"file":"adminAuthCredentialFlow.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthCredentialFlow.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAC;AAgCzD;;;GAGG;AACH,MAAM,CAAC,KAAK,UAAU,gCAAgC,CAAC,IAMtD;IACC,IAAI,QAAwC,CAAC;IAC7C,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,EAAE;QAClC,QAAQ,GAAG,mCAAmC,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;QACnE,OAAO,8BAA8B,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CAAC;IAC5D,CAAC,CAAC,CAAC;IAEH,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC7B,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,CAAC,kBAAkB,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,iCAAiC,CAAC,OAAO,EAAE,QAAQ,CAAC,CAAC,CAAC;QAC3F,OAAO;YACL,EAAE,EAAE,KAAK;YACT,WAAW,EAAE,IAAI,CAAC,IAAI;YACtB,OAAO,EAAE,GAAG,IAAI,CAAC,IAAI,CAAC,aAAa,iFAAiF,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE;SAC5I,CAAC;IACJ,CAAC;IAED,MAAM,IAAI,CAAC,aAAa,EAAE,CAAC;IAC3B,OAAO,EAAE,EAAE,EAAE,IAAI,EAAE,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,CAAC;AACzD,CAAC;AAED,wGAAwG;AACxG,MAAM,UAAU,gDAAgD,CAC9D,QAA4B,EAC5B,IAA+B;IAE/B,OAAO,8BAA8B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;AACxD,CAAC;AAED,6FAA6F;AAC7F,MAAM,CAAC,KAAK,UAAU,kDAAkD,CAAC,IAMxE;IACC,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAC3D,IAAI,MAAM,CAAC,EAAE,EAAE,CAAC;QACd,IAAI,CAAC,UAAU,CAAC,CAAC,OAAO,EAAE,EAAE,CAC1B,gDAAgD,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,CACrE,CAAC;IACJ,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,uHAAuH;AACvH,MAAM,UAAU,8BAA8B,CAC5C,QAAmC,EACnC,IAA+B;IAE/B,MAAM,YAAY,GAAG,QAAQ,IAAI,yBAAyB,EAAE,CAAC;IAC7D,MAAM,KAAK,GAAG,YAAY,CAAC,KAAK,IAAI,0BAA0B,EAAE,CAAC;IACjE,MAAM,gBAAgB,GAAG,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC,CAAC;IAC7F,MAAM,YAAY,GAAG,gBAAgB;QACnC,CAAC,CAAC;YACE,GAAG,gBAAgB;YACnB,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC;QACH,CAAC,CAAC;YACE,EAAE,EAAE,IAAI,CAAC,UAAU;YACnB,GAAG,IAAI,CAAC,gBAAgB;YACxB,cAAc,EAAE,IAAI,CAAC,cAAc;SACpC,CAAC;IAEN,OAAO;QACL,GAAG,YAAY;QACf,KAAK,EAAE;YACL,GAAG,KAAK;YACR,SAAS,EAAE,mBAAmB,CAAC,KAAK,CAAC,SAAS,EAAE,YAAY,CAAC;SAC9D;KACF,CAAC;AACJ,CAAC;AAED,wHAAwH;AACxH,SAAS,mCAAmC,CAC1C,QAAmC,EACnC,IAA+B;IAE/B,MAAM,KAAK,GAAG,QAAQ,EAAE,KAAK,CAAC;IAC9B,MAAM,gBAAgB,GACpB,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC;IAC/E,MAAM,YAAY,GAAG,8BAA8B,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IACpE,MAAM,gBAAgB,GACpB,YAAY,CAAC,KAAK,EAAE,SAAS,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,IAAI,CAAC,UAAU,CAAC;QAChF;YACC,EAAE,EAAE,IAAI,CAAC,UAAU;YACnB,GAAG,IAAI,CAAC,gBAAgB;YACxB,cAAc,EAAE,IAAI,CAAC,cAAc;SACD,CAAC;IAEvC,OAAO;QACL,iBAAiB,EAAE,QAAQ,KAAK,IAAI;QACpC,kBAAkB,EAAE,KAAK,KAAK,SAAS;QACvC,UAAU,EAAE,IAAI,CAAC,UAAU;QAC3B,cAAc,EAAE,IAAI,CAAC,cAAc;QACnC,gBAAgB;QAChB,gBAAgB;KACjB,CAAC;AACJ,CAAC;AAED,uGAAuG;AACvG,SAAS,iCAAiC,CACxC,QAAmC,EACnC,QAAuC;IAEvC,IAAI,CAAC,QAAQ,EAAE,KAAK;QAAE,OAAO,QAAQ,CAAC;IAEtC,MAAM,eAAe,GAAG,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CACnD,CAAC,QAAQ,EAAE,EAAE,CAAC,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU,CAClD,CAAC;IAEF,MAAM,EAAE,gBAAgB,EAAE,GAAG,QAAQ,CAAC;IACtC,MAAM,SAAS,GACb,eAAe,EAAE,cAAc,KAAK,QAAQ,CAAC,cAAc;QACzD,CAAC,CAAC,gBAAgB,KAAK,IAAI;YACzB,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE,EAAE,CACxC,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU;gBACjC,CAAC,CAAC,6BAA6B,CAAC,QAAQ,EAAE,gBAAgB,CAAC;gBAC3D,CAAC,CAAC,QAAQ,CACb;YACH,CAAC,CAAC,oCAAoC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,EAAE,QAAQ,CAAC;QAC5E,CAAC,CAAC,QAAQ,CAAC,KAAK,CAAC,SAAS,CAAC;IAE/B,MAAM,YAAY,GAAuB;QACvC,GAAG,QAAQ;QACX,KAAK,EAAE;YACL,GAAG,QAAQ,CAAC,KAAK;YACjB,SAAS;SACV;KACF,CAAC;IAEF,OAAO,oCAAoC,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;AACtE,CAAC;AAED,oHAAoH;AACpH,SAAS,6BAA6B,CACpC,eAAwC,EACxC,gBAAyC;IAEzC,MAAM,EAAE,cAAc,EAAE,sBAAsB,EAAE,GAAG,4BAA4B,EAAE,GAC/E,eAAe,CAAC;IAClB,IAAI,gBAAgB,CAAC,cAAc,KAAK,SAAS,EAAE,CAAC;QAClD,OAAO,4BAA4B,CAAC;IACtC,CAAC;IAED,OAAO;QACL,GAAG,eAAe;QAClB,cAAc,EAAE,gBAAgB,CAAC,cAAc;KAChD,CAAC;AACJ,CAAC;AAED,2JAA2J;AAC3J,SAAS,oCAAoC,CAC3C,SAA6C,EAC7C,QAAuC;IAEvC,OAAO,SAAS,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,EAAE;QACpC,IAAI,QAAQ,CAAC,EAAE,KAAK,QAAQ,CAAC,UAAU;YAAE,OAAO,CAAC,QAAQ,CAAC,CAAC;QAC3D,IAAI,sBAAsB,CAAC,QAAQ,EAAE,QAAQ,CAAC,gBAAgB,CAAC;YAAE,OAAO,EAAE,CAAC;QAE3E,MAAM,EAAE,cAAc,EAAE,eAAe,EAAE,GAAG,6BAA6B,EAAE,GAAG,QAAQ,CAAC;QACvF,OAAO,CAAC,6BAA6B,CAAC,CAAC;IACzC,CAAC,CAAC,CAAC;AACL,CAAC;AAED;;;GAGG;AACH,SAAS,sBAAsB,CAC7B,IAA6B,EAC7B,KAA8B;IAE9B,OAAO,IAAI,CAAC,SAAS,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;AACxD,CAAC;AAED,mGAAmG;AACnG,SAAS,oCAAoC,CAC3C,QAA4B,EAC5B,QAAuC;IAEvC,MAAM,sBAAsB,GAC1B,CAAC,QAAQ,CAAC,kBAAkB,IAAI,QAAQ,CAAC,KAAK,IAAI,sBAAsB,CAAC,QAAQ,CAAC,KAAK,CAAC;QACtF,CAAC,CAAC,SAAS,CAAC,QAAQ,CAAC;QACrB,CAAC,CAAC,QAAQ,CAAC;IAEf,IACE,CAAC,QAAQ,CAAC,iBAAiB;QAC3B,sBAAsB,CAAC,KAAK,KAAK,SAAS;QAC1C,kBAAkB,CAAC,sBAAsB,CAAC,EAC1C,CAAC;QACD,OAAO,IAAI,CAAC;IACd,CAAC;IAED,OAAO,sBAAsB,CAAC;AAChC,CAAC;AAED;;;GAGG;AACH,SAAS,SAAS,CAAC,QAA4B;IAC7C,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,IAAI,EAAE,GAAG,QAAQ,CAAC;IAC5C,OAAO,IAAI,CAAC;AACd,CAAC;AAED,oHAAoH;AACpH,SAAS,sBAAsB,CAAC,KAA+C;IAC7E,OAAO,CACL,KAAK,CAAC,OAAO,KAAK,KAAK;QACvB,KAAK,CAAC,aAAa,KAAK,gBAAgB;QACxC,KAAK,CAAC,SAAS,CAAC,MAAM,KAAK,CAAC,CAC7B,CAAC;AACJ,CAAC;AAED,kGAAkG;AAClG,SAAS,kBAAkB,CAAC,QAA4B;IACtD,OAAO,CACL,QAAQ,CAAC,KAAK,KAAK,MAAM;QACzB,QAAQ,CAAC,QAAQ,KAAK,UAAU;QAChC,IAAI,CAAC,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,KAAK,IAAI,CAAC,SAAS,CAAC,iBAAiB,CAAC;QACnE,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,MAAM,KAAK,CAAC;QACxC,QAAQ,CAAC,MAAM,CAAC,WAAW,CAAC,CAAC,CAAC,KAAK,OAAO;QAC1C,QAAQ,CAAC,MAAM,KAAK,SAAS;QAC7B,QAAQ,CAAC,OAAO,KAAK,SAAS,CAC/B,CAAC;AACJ,CAAC;AAED,6FAA6F;AAC7F,SAAS,yBAAyB;IAChC,OAAO;QACL,KAAK,EAAE,MAAM;QACb,QAAQ,EAAE,UAAU;QACpB,IAAI,EAAE,EAAE,GAAG,iBAAiB,EAAE;QAC9B,MAAM,EAAE,EAAE,WAAW,EAAE,CAAC,OAAO,CAAC,EAAE;QAClC,KAAK,EAAE,0BAA0B,EAAE;KACpC,CAAC;AACJ,CAAC;AAED,4GAA4G;AAC5G,SAAS,0BAA0B;IACjC,OAAO;QACL,OAAO,EAAE,KAAK;QACd,aAAa,EAAE,gBAAgB;QAC/B,SAAS,EAAE,EAAE;KACd,CAAC;AACJ,CAAC;AAED;;;GAGG;AACH,SAAS,mBAAmB,CAC1B,SAAgE,EAChE,QAAiC;IAEjC,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,EAAE,KAAK,QAAQ,CAAC,EAAE,CAAC,CAAC;IAC/E,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,CAAC,GAAG,SAAS,EAAE,QAAQ,CAAC,CAAC;IAC/C,OAAO,SAAS,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,cAAc,EAAE,EAAE,CACjD,cAAc,KAAK,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC,SAAS,CAChD,CAAC;AACJ,CAAC"}

package/dist/ui/admin/pages/adminAuthHealthFlow.d.ts

@@ -8,11 +8,19 @@ export type AuthHealthRefreshResult = {
 };
 export declare class AuthHealthRefreshCoordinator {
     private latestRequestId;
+    /***
+     * Run one asynchronous refresh and apply only the result belonging to the latest request generation.
+     * @utility @ankhorage/utility/async
+     */
     refresh(args: {
         readonly loadHealth: () => Promise<ProjectAuthHealth>;
         readonly onHealth: (health: ProjectAuthHealth) => void;
         readonly onError: (error: unknown) => void;
     }): Promise<AuthHealthRefreshResult>;
+    /***
+     * Return whether a request generation is still the newest generation owned by the coordinator.
+     * @utility @ankhorage/utility/async
+     */
     private isLatest;
 }
 //# sourceMappingURL=adminAuthHealthFlow.d.ts.map

package/dist/ui/admin/pages/adminAuthHealthFlow.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adminAuthHealthFlow.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthHealthFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEN,qBAAa,4BAA4B;IACvC,OAAO,CAAC,eAAe,CAAK;IAEtB,OAAO,CAAC,IAAI,EAAE;QAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACtD,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;QACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KAC5C,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgBpC,OAAO,CAAC,QAAQ;CAGjB"}
+{"version":3,"file":"adminAuthHealthFlow.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthHealthFlow.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,4BAA4B,CAAC;AAEpE,MAAM,MAAM,uBAAuB,GAC/B;IACE,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC;IACvB,QAAQ,CAAC,MAAM,EAAE,iBAAiB,CAAC;CACpC,GACD;IACE,QAAQ,CAAC,OAAO,EAAE,KAAK,CAAC;IACxB,QAAQ,CAAC,KAAK,CAAC,EAAE,OAAO,CAAC;CAC1B,CAAC;AAEN,qBAAa,4BAA4B;IACvC,OAAO,CAAC,eAAe,CAAK;IAE5B;;;OAGG;IACG,OAAO,CAAC,IAAI,EAAE;QAClB,QAAQ,CAAC,UAAU,EAAE,MAAM,OAAO,CAAC,iBAAiB,CAAC,CAAC;QACtD,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,iBAAiB,KAAK,IAAI,CAAC;QACvD,QAAQ,CAAC,OAAO,EAAE,CAAC,KAAK,EAAE,OAAO,KAAK,IAAI,CAAC;KAC5C,GAAG,OAAO,CAAC,uBAAuB,CAAC;IAgBpC;;;OAGG;IACH,OAAO,CAAC,QAAQ;CAGjB"}

package/dist/ui/admin/pages/adminAuthHealthFlow.js

@@ -1,5 +1,9 @@
 export class AuthHealthRefreshCoordinator {
     latestRequestId = 0;
+    /***
+     * Run one asynchronous refresh and apply only the result belonging to the latest request generation.
+     * @utility @ankhorage/utility/async
+     */
     async refresh(args) {
         const requestId = this.latestRequestId + 1;
         this.latestRequestId = requestId;
@@ -17,6 +21,10 @@ export class AuthHealthRefreshCoordinator {
             return { applied: false, error };
         }
     }
+    /***
+     * Return whether a request generation is still the newest generation owned by the coordinator.
+     * @utility @ankhorage/utility/async
+     */
     isLatest(requestId) {
         return requestId === this.latestRequestId;
     }

package/dist/ui/admin/pages/adminAuthHealthFlow.js.map

@@ -1 +1 @@
-{"version":3,"file":"adminAuthHealthFlow.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthHealthFlow.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,4BAA4B;IAC/B,eAAe,GAAG,CAAC,CAAC;IAE5B,KAAK,CAAC,OAAO,CAAC,IAIb;QACC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACzD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAChE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAEO,QAAQ,CAAC,SAAiB;QAChC,OAAO,SAAS,KAAK,IAAI,CAAC,eAAe,CAAC;IAC5C,CAAC;CACF"}
+{"version":3,"file":"adminAuthHealthFlow.js","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthHealthFlow.ts"],"names":[],"mappings":"AAYA,MAAM,OAAO,4BAA4B;IAC/B,eAAe,GAAG,CAAC,CAAC;IAE5B;;;OAGG;IACH,KAAK,CAAC,OAAO,CAAC,IAIb;QACC,MAAM,SAAS,GAAG,IAAI,CAAC,eAAe,GAAG,CAAC,CAAC;QAC3C,IAAI,CAAC,eAAe,GAAG,SAAS,CAAC;QAEjC,IAAI,CAAC;YACH,MAAM,MAAM,GAAG,MAAM,IAAI,CAAC,UAAU,EAAE,CAAC;YACvC,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC;YACzD,IAAI,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAC;YACtB,OAAO,EAAE,OAAO,EAAE,IAAI,EAAE,MAAM,EAAE,CAAC;QACnC,CAAC;QAAC,OAAO,KAAK,EAAE,CAAC;YACf,IAAI,CAAC,IAAI,CAAC,QAAQ,CAAC,SAAS,CAAC;gBAAE,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;YAChE,IAAI,CAAC,OAAO,CAAC,KAAK,CAAC,CAAC;YACpB,OAAO,EAAE,OAAO,EAAE,KAAK,EAAE,KAAK,EAAE,CAAC;QACnC,CAAC;IACH,CAAC;IAED;;;OAGG;IACK,QAAQ,CAAC,SAAiB;QAChC,OAAO,SAAS,KAAK,IAAI,CAAC,eAAe,CAAC;IAC5C,CAAC;CACF"}

package/dist/ui/admin/pages/adminAuthSessionModel.d.ts

@@ -13,23 +13,83 @@ export declare class AuthAdminWriteCoordinator {
     private readonly activeProviderIds;
     private readonly activeCredentialRefs;
     private readonly activeCredentialSecretCleanupRefs;
+    /***
+     * Return whether the coordinator currently holds its exclusive whole-resource write lock.
+     * @utility @ankhorage/utility/concurrency
+     */
     isFullAuthSaveActive(): boolean;
+    /***
+     * Return whether any keyed transaction is currently active.
+     * @utility @ankhorage/utility/concurrency
+     */
     isAnyCredentialTransactionActive(): boolean;
+    /***
+     * Return whether one primary key currently owns an active keyed transaction.
+     * @utility @ankhorage/utility/concurrency
+     */
     isProviderBusy(providerId: AuthOAuthProviderId): boolean;
+    /***
+     * Return whether one secondary key is reserved either by a transaction or a cleanup operation.
+     * @utility @ankhorage/utility/concurrency
+     */
     isCredentialRefBusy(credentialsRef: string): boolean;
+    /***
+     * Return an immutable snapshot copy of currently busy primary keys.
+     * @utility @ankhorage/utility/collection
+     */
     getBusyProviderIds(): ReadonlySet<AuthOAuthProviderId>;
+    /***
+     * Return an immutable snapshot copy of currently busy secondary transaction keys.
+     * @utility @ankhorage/utility/collection
+     */
     getBusyCredentialRefs(): ReadonlySet<string>;
+    /***
+     * Return an immutable snapshot copy of secondary keys currently reserved for cleanup.
+     * @utility @ankhorage/utility/collection
+     */
     getBusyCredentialSecretCleanupRefs(): ReadonlySet<string>;
+    /***
+     * Execute an exclusive whole-resource asynchronous operation unless any conflicting whole/keyed operation is active.
+     * @utility @ankhorage/utility/concurrency
+     */
     runFullAuthSave<T>(operation: () => Promise<T>): Promise<AuthAdminWriteResult<T>>;
+    /***
+     * Execute an asynchronous operation while atomically reserving a primary and secondary key and rejecting conflicting reservations.
+     * @utility @ankhorage/utility/concurrency
+     */
     runCredentialTransaction<T>(providerId: AuthOAuthProviderId, credentialsRef: string, operation: () => Promise<T>): Promise<AuthAdminWriteResult<T>>;
+    /***
+     * Execute an asynchronous cleanup while reserving one secondary key against concurrent transaction/cleanup use.
+     * @utility @ankhorage/utility/concurrency
+     */
     runCredentialSecretCleanup<T>(credentialsRef: string, operation: () => Promise<T>): Promise<AuthAdminWriteResult<T>>;
 }
 export declare class AuthAdminPendingCredentialRecoveryStore {
     private readonly linksByProviderId;
+    /***
+     * Return all values currently held by a keyed in-memory registry.
+     * @utility @ankhorage/utility/registry
+     */
     list(): readonly StoredOAuthCredentialLink[];
+    /***
+     * Resolve one registry value by primary key, normalizing a miss to null.
+     * @utility @ankhorage/utility/registry
+     */
     get(providerId: AuthOAuthProviderId): StoredOAuthCredentialLink | null;
+    /***
+     * Insert or replace one registry value using a key derived from the value.
+     * @utility @ankhorage/utility/registry
+     */
     set(link: StoredOAuthCredentialLink): void;
+    /***
+     * Delete one registry value by primary key.
+     * @utility @ankhorage/utility/registry
+     */
     clear(providerId: AuthOAuthProviderId): void;
+    /***
+     * Delete and return every registry value matching a secondary-key predicate.
+     * @utility @ankhorage/utility/registry
+     */
     clearByCredentialsRef(credentialsRef: string): readonly StoredOAuthCredentialLink[];
 }
 export interface AuthAdminProjectSessionSnapshot {
@@ -43,15 +103,24 @@ export declare class AuthAdminProjectSession {
     readonly projectId: string;
     private readonly writeCoordinator;
     private readonly pendingRecovery;
+    /*** Create the auth-admin application session for one Studio project. */
     constructor(projectId: string);
+    /*** Project auth-admin transaction and pending-recovery state into an immutable UI snapshot. */
     getSnapshot(): AuthAdminProjectSessionSnapshot;
+    /*** Store one pending OAuth credential link that needs later recovery/persistence. */
     setPendingCredentialLink(link: StoredOAuthCredentialLink): void;
+    /*** Clear the pending OAuth credential link for one provider. */
     clearPendingCredentialLink(providerId: AuthOAuthProviderId): void;
+    /*** Clear and return all pending links backed by one credential reference. */
     clearPendingCredentialLinksByCredentialsRef(credentialsRef: string): readonly StoredOAuthCredentialLink[];
+    /*** Delegate a whole-auth save to the session's write coordinator. */
     runFullAuthSave<T>(operation: () => Promise<T>): Promise<AuthAdminWriteResult<T>>;
+    /*** Delegate a provider/credential transaction to the session's write coordinator. */
     runCredentialTransaction<T>(providerId: AuthOAuthProviderId, credentialsRef: string, operation: () => Promise<T>): Promise<AuthAdminWriteResult<T>>;
+    /*** Delegate credential-secret cleanup to the session's write coordinator. */
     runCredentialSecretCleanup<T>(credentialsRef: string, operation: () => Promise<T>): Promise<AuthAdminWriteResult<T>>;
 }
+/*** Clear pending local credential links after their backing local project secret was actually removed. */
 export declare function clearPendingCredentialLinksForRemovedProjectSecret(args: {
     readonly session: {
         readonly clearPendingCredentialLinksByCredentialsRef: (credentialsRef: string) => readonly StoredOAuthCredentialLink[];
@@ -60,6 +129,10 @@ export declare function clearPendingCredentialLinksForRemovedProjectSecret(args:
     readonly ref: string;
     readonly removed: boolean;
 }): readonly StoredOAuthCredentialLink[];
+/***
+ * Rebase an editable auth draft onto canonical OAuth credential references while preserving all other draft edits.
+ * @todo Move this auth reconciliation policy from `ui/` into the auth application/domain layer.
+ */
 export declare function rebaseAuthDraftOntoCanonicalCredentialRefs(args: {
     readonly draft: StudioAuthSettings;
     readonly canonical: StudioAuthSettings | null;

package/dist/ui/admin/pages/adminAuthSessionModel.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"adminAuthSessionModel.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthSessionModel.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"adminAuthSessionModel.d.ts","sourceRoot":"","sources":["../../../../src/ui/admin/pages/adminAuthSessionModel.ts"],"names":[],"mappings":"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"}

package/dist/ui/admin/pages/adminAuthSessionModel.js

@@ -3,28 +3,60 @@ export class AuthAdminWriteCoordinator {
     activeProviderIds = new Set();
     activeCredentialRefs = new Set();
     activeCredentialSecretCleanupRefs = new Set();
+    /***
+     * Return whether the coordinator currently holds its exclusive whole-resource write lock.
+     * @utility @ankhorage/utility/concurrency
+     */
     isFullAuthSaveActive() {
         return this.fullAuthSaveActive;
     }
+    /***
+     * Return whether any keyed transaction is currently active.
+     * @utility @ankhorage/utility/concurrency
+     */
     isAnyCredentialTransactionActive() {
         return this.activeProviderIds.size > 0;
     }
+    /***
+     * Return whether one primary key currently owns an active keyed transaction.
+     * @utility @ankhorage/utility/concurrency
+     */
     isProviderBusy(providerId) {
         return this.activeProviderIds.has(providerId);
     }
+    /***
+     * Return whether one secondary key is reserved either by a transaction or a cleanup operation.
+     * @utility @ankhorage/utility/concurrency
+     */
     isCredentialRefBusy(credentialsRef) {
         return (this.activeCredentialRefs.has(credentialsRef) ||
             this.activeCredentialSecretCleanupRefs.has(credentialsRef));
     }
+    /***
+     * Return an immutable snapshot copy of currently busy primary keys.
+     * @utility @ankhorage/utility/collection
+     */
     getBusyProviderIds() {
         return new Set(this.activeProviderIds);
     }
+    /***
+     * Return an immutable snapshot copy of currently busy secondary transaction keys.
+     * @utility @ankhorage/utility/collection
+     */
     getBusyCredentialRefs() {
         return new Set(this.activeCredentialRefs);
     }
+    /***
+     * Return an immutable snapshot copy of secondary keys currently reserved for cleanup.
+     * @utility @ankhorage/utility/collection
+     */
     getBusyCredentialSecretCleanupRefs() {
         return new Set(this.activeCredentialSecretCleanupRefs);
     }
+    /***
+     * Execute an exclusive whole-resource asynchronous operation unless any conflicting whole/keyed operation is active.
+     * @utility @ankhorage/utility/concurrency
+     */
     async runFullAuthSave(operation) {
         if (this.fullAuthSaveActive)
             return { ok: false, reason: 'full_auth_save_busy' };
@@ -39,6 +71,10 @@ export class AuthAdminWriteCoordinator {
             this.fullAuthSaveActive = false;
         }
     }
+    /***
+     * Execute an asynchronous operation while atomically reserving a primary and secondary key and rejecting conflicting reservations.
+     * @utility @ankhorage/utility/concurrency
+     */
     async runCredentialTransaction(providerId, credentialsRef, operation) {
         if (this.fullAuthSaveActive)
             return { ok: false, reason: 'full_auth_save_busy' };
@@ -60,6 +96,10 @@ export class AuthAdminWriteCoordinator {
             this.activeProviderIds.delete(providerId);
         }
     }
+    /***
+     * Execute an asynchronous cleanup while reserving one secondary key against concurrent transaction/cleanup use.
+     * @utility @ankhorage/utility/concurrency
+     */
     async runCredentialSecretCleanup(credentialsRef, operation) {
         if (this.activeCredentialRefs.has(credentialsRef)) {
             return { ok: false, reason: 'credential_transaction_busy' };
@@ -78,18 +118,38 @@ export class AuthAdminWriteCoordinator {
 }
 export class AuthAdminPendingCredentialRecoveryStore {
     linksByProviderId = new Map();
+    /***
+     * Return all values currently held by a keyed in-memory registry.
+     * @utility @ankhorage/utility/registry
+     */
     list() {
         return [...this.linksByProviderId.values()];
     }
+    /***
+     * Resolve one registry value by primary key, normalizing a miss to null.
+     * @utility @ankhorage/utility/registry
+     */
     get(providerId) {
         return this.linksByProviderId.get(providerId) ?? null;
     }
+    /***
+     * Insert or replace one registry value using a key derived from the value.
+     * @utility @ankhorage/utility/registry
+     */
     set(link) {
         this.linksByProviderId.set(link.providerId, link);
     }
+    /***
+     * Delete one registry value by primary key.
+     * @utility @ankhorage/utility/registry
+     */
     clear(providerId) {
         this.linksByProviderId.delete(providerId);
     }
+    /***
+     * Delete and return every registry value matching a secondary-key predicate.
+     * @utility @ankhorage/utility/registry
+     */
     clearByCredentialsRef(credentialsRef) {
         const cleared = [];
         for (const link of this.linksByProviderId.values()) {
@@ -105,9 +165,11 @@ export class AuthAdminProjectSession {
     projectId;
     writeCoordinator = new AuthAdminWriteCoordinator();
     pendingRecovery = new AuthAdminPendingCredentialRecoveryStore();
+    /*** Create the auth-admin application session for one Studio project. */
     constructor(projectId) {
         this.projectId = projectId;
     }
+    /*** Project auth-admin transaction and pending-recovery state into an immutable UI snapshot. */
     getSnapshot() {
         return {
             pendingCredentialLinks: this.pendingRecovery.list(),
@@ -117,30 +179,41 @@ export class AuthAdminProjectSession {
             fullAuthSaveBusy: this.writeCoordinator.isFullAuthSaveActive(),
         };
     }
+    /*** Store one pending OAuth credential link that needs later recovery/persistence. */
     setPendingCredentialLink(link) {
         this.pendingRecovery.set(link);
     }
+    /*** Clear the pending OAuth credential link for one provider. */
     clearPendingCredentialLink(providerId) {
         this.pendingRecovery.clear(providerId);
     }
+    /*** Clear and return all pending links backed by one credential reference. */
     clearPendingCredentialLinksByCredentialsRef(credentialsRef) {
         return this.pendingRecovery.clearByCredentialsRef(credentialsRef);
     }
+    /*** Delegate a whole-auth save to the session's write coordinator. */
     async runFullAuthSave(operation) {
         return await this.writeCoordinator.runFullAuthSave(operation);
     }
+    /*** Delegate a provider/credential transaction to the session's write coordinator. */
     async runCredentialTransaction(providerId, credentialsRef, operation) {
         return await this.writeCoordinator.runCredentialTransaction(providerId, credentialsRef, operation);
     }
+    /*** Delegate credential-secret cleanup to the session's write coordinator. */
     async runCredentialSecretCleanup(credentialsRef, operation) {
         return await this.writeCoordinator.runCredentialSecretCleanup(credentialsRef, operation);
     }
 }
+/*** Clear pending local credential links after their backing local project secret was actually removed. */
 export function clearPendingCredentialLinksForRemovedProjectSecret(args) {
     if (!args.removed || args.environment !== 'local')
         return [];
     return args.session.clearPendingCredentialLinksByCredentialsRef(args.ref);
 }
+/***
+ * Rebase an editable auth draft onto canonical OAuth credential references while preserving all other draft edits.
+ * @todo Move this auth reconciliation policy from `ui/` into the auth application/domain layer.
+ */
 export function rebaseAuthDraftOntoCanonicalCredentialRefs(args) {
     const canonicalOauth = args.canonical?.oauth;
     const canonicalProvidersById = new Map(canonicalOauth?.providers.map((provider) => [provider.id, provider]) ?? []);