@fonderie/client 1.4.0 → 1.6.0

package/dist/index.d.cts

@@ -506,6 +506,60 @@ interface IAdminIssueTokenInput {
 interface IAdminIssuedToken extends IAdminTokenRecord {
     token: string;
 }
+interface IAdminOperator {
+    id: string;
+    email: string;
+    name: string | null;
+    scopes: AdminScope[];
+    enrolled: boolean;
+    backupCodesLeft: number;
+    locked: boolean;
+    createdBy: string;
+    createdAt: string;
+    lastLoginAt: string | null;
+    disabledAt: string | null;
+}
+interface IAdminOperatorLink {
+    id: string;
+    kind: 'invite' | 'recovery';
+    email: string;
+    scopes: AdminScope[];
+    createdBy: string;
+    createdAt: string;
+    expiresAt: string;
+}
+interface IAdminOperatorsReport {
+    operators: IAdminOperator[];
+    links: IAdminOperatorLink[];
+}
+interface IAdminCreatedLink {
+    id: string;
+    email: string;
+    scopes?: AdminScope[];
+    expiresAt: string;
+    token: string;
+    url: string;
+}
+type AdminSessionState = 'signed-out' | 'needs-2fa' | 'needs-enrollment' | 'signed-in';
+interface IAdminSession {
+    state: AdminSessionState;
+    operator: IAdminOperator | null;
+    claimable?: boolean;
+    stepUpFresh?: boolean;
+    backupCodes?: string[];
+    backupCodesLeft?: number;
+}
+interface IAdminEnrollment {
+    secret: string;
+    uri: string;
+    account: string;
+    issuer: string;
+}
+type IAdminSecondFactor = {
+    code: string;
+} | {
+    backupCode: string;
+};
 interface IAdminLogEntry {
     id: string;
     at: string;
@@ -1404,6 +1458,9 @@ interface ISetConfigInput {
     description?: string;
     active?: boolean;
     ifVersion?: number;
+    /** Required to change an existing key's value kind (on/off → text, list → object);
+     * without it the server answers 409 CONFIG_TYPE_CHANGE. */
+    allowTypeChange?: boolean;
 }
 interface ISetSecretInput {
     value: string;
@@ -1444,7 +1501,7 @@ declare class ConfigAdminClient {
 
 interface IAdminClientOptions {
     baseUrl: string;
-    adminToken: string;
+    adminToken?: string;
     prefix?: string;
     actor?: string;
 }
@@ -1479,6 +1536,55 @@ declare class AdminClient {
      * module is behind, and 422 when any pending file deletes data.
      */
     applyMigrations(module: string, expect: readonly string[]): Promise<IApiResponse<IAdminMigrationModule>>;
+    /** Who is signed in, and whether the console can still be claimed. */
+    session(): Promise<IApiResponse<IAdminSession>>;
+    /** The one-time claim. Needs the ROOT token as this client's adminToken. */
+    claim(input: {
+        email: string;
+        password: string;
+        name?: string;
+    }): Promise<IApiResponse<IAdminSession>>;
+    login(input: {
+        email: string;
+        password: string;
+    }): Promise<IApiResponse<IAdminSession>>;
+    /** The authenticator secret and otpauth URI to scan while enrolling. */
+    enrollment(): Promise<IApiResponse<IAdminEnrollment>>;
+    /** Confirms the first code. The response carries the backup codes, once. */
+    confirmEnrollment(code: string): Promise<IApiResponse<IAdminSession>>;
+    /** The second factor after the password: an authenticator code or a backup code. */
+    verify(factor: IAdminSecondFactor): Promise<IApiResponse<IAdminSession>>;
+    /** A fresh code for the next five minutes of dangerous actions. */
+    stepUp(factor: IAdminSecondFactor): Promise<IApiResponse<{
+        stepUpFresh: boolean;
+        backupCodesLeft?: number;
+    }>>;
+    logout(): Promise<IApiResponse<undefined>>;
+    /** What an invite or recovery link is for, before setting a password. */
+    inspectLink(token: string): Promise<IApiResponse<{
+        kind: "invite" | "recovery";
+        email: string;
+    }>>;
+    redeemLink(input: {
+        token: string;
+        password: string;
+        name?: string;
+    }): Promise<IApiResponse<IAdminSession>>;
+    operators(): Promise<IApiResponse<IAdminOperatorsReport>>;
+    /** An invite link, shown once. Needs the highest scope and a fresh code. */
+    inviteOperator(input: {
+        email: string;
+        scopes: AdminScope[];
+        expiresInHours?: number;
+    }): Promise<IApiResponse<IAdminCreatedLink>>;
+    /** Lost password or authenticator: a single-use link; signs them out everywhere. */
+    recoverOperator(id: string): Promise<IApiResponse<IAdminCreatedLink>>;
+    updateOperator(id: string, input: {
+        scopes?: AdminScope[];
+        name?: string;
+        disabled?: boolean;
+    }): Promise<IApiResponse<IAdminOperator>>;
+    revokeOperatorLink(id: string): Promise<IApiResponse<undefined>>;
 }
 
 interface IAuthAdminClientOptions {
@@ -1643,5 +1749,25 @@ declare function castConfigValue(type: ConfigValueType, raw: string): CastResult
  */
 declare const CONFIG_KEY_PATTERN: RegExp;
 declare function configKeyProblem(key: string): string | null;
+interface IInferredConfigValue {
+    type: ConfigValueType;
+    value: unknown;
+    /** Human label for the detected shape: Text, Number, On/off, Object, List. */
+    label: string;
+    /**
+     * True when the input could equally be meant as text — "true", "42". The
+     * editor offers "save as text instead" for exactly these, and never needs
+     * to ask about anything else.
+     */
+    ambiguous: boolean;
+}
+/** Human label for a stored value's shape. */
+declare function configValueLabel(value: unknown): string;
+/**
+ * Work out what an operator typed, without asking. Objects and lists (JSON
+ * starting with { or [), on/off (true/false), plain numbers, and text for
+ * everything else — including anything that merely resembles a number.
+ */
+declare function inferConfigValue(raw: string): IInferredConfigValue;
 
-export { AdminClient, type AdminRouteGuard, type AdminScope, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminDoctorReport, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, castConfigValue, configKeyProblem, configValueType, createMemoryCache, describeLocation, formatConfigValue, isMfaRequired };
+export { AdminClient, type AdminRouteGuard, type AdminScope, type AdminSessionState, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminCreatedLink, type IAdminDoctorReport, type IAdminEnrollment, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminOperator, type IAdminOperatorLink, type IAdminOperatorsReport, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSecondFactor, type IAdminSession, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInferredConfigValue, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, castConfigValue, configKeyProblem, configValueLabel, configValueType, createMemoryCache, describeLocation, formatConfigValue, inferConfigValue, isMfaRequired };

package/dist/index.d.ts

@@ -506,6 +506,60 @@ interface IAdminIssueTokenInput {
 interface IAdminIssuedToken extends IAdminTokenRecord {
     token: string;
 }
+interface IAdminOperator {
+    id: string;
+    email: string;
+    name: string | null;
+    scopes: AdminScope[];
+    enrolled: boolean;
+    backupCodesLeft: number;
+    locked: boolean;
+    createdBy: string;
+    createdAt: string;
+    lastLoginAt: string | null;
+    disabledAt: string | null;
+}
+interface IAdminOperatorLink {
+    id: string;
+    kind: 'invite' | 'recovery';
+    email: string;
+    scopes: AdminScope[];
+    createdBy: string;
+    createdAt: string;
+    expiresAt: string;
+}
+interface IAdminOperatorsReport {
+    operators: IAdminOperator[];
+    links: IAdminOperatorLink[];
+}
+interface IAdminCreatedLink {
+    id: string;
+    email: string;
+    scopes?: AdminScope[];
+    expiresAt: string;
+    token: string;
+    url: string;
+}
+type AdminSessionState = 'signed-out' | 'needs-2fa' | 'needs-enrollment' | 'signed-in';
+interface IAdminSession {
+    state: AdminSessionState;
+    operator: IAdminOperator | null;
+    claimable?: boolean;
+    stepUpFresh?: boolean;
+    backupCodes?: string[];
+    backupCodesLeft?: number;
+}
+interface IAdminEnrollment {
+    secret: string;
+    uri: string;
+    account: string;
+    issuer: string;
+}
+type IAdminSecondFactor = {
+    code: string;
+} | {
+    backupCode: string;
+};
 interface IAdminLogEntry {
     id: string;
     at: string;
@@ -1404,6 +1458,9 @@ interface ISetConfigInput {
     description?: string;
     active?: boolean;
     ifVersion?: number;
+    /** Required to change an existing key's value kind (on/off → text, list → object);
+     * without it the server answers 409 CONFIG_TYPE_CHANGE. */
+    allowTypeChange?: boolean;
 }
 interface ISetSecretInput {
     value: string;
@@ -1444,7 +1501,7 @@ declare class ConfigAdminClient {
 
 interface IAdminClientOptions {
     baseUrl: string;
-    adminToken: string;
+    adminToken?: string;
     prefix?: string;
     actor?: string;
 }
@@ -1479,6 +1536,55 @@ declare class AdminClient {
      * module is behind, and 422 when any pending file deletes data.
      */
     applyMigrations(module: string, expect: readonly string[]): Promise<IApiResponse<IAdminMigrationModule>>;
+    /** Who is signed in, and whether the console can still be claimed. */
+    session(): Promise<IApiResponse<IAdminSession>>;
+    /** The one-time claim. Needs the ROOT token as this client's adminToken. */
+    claim(input: {
+        email: string;
+        password: string;
+        name?: string;
+    }): Promise<IApiResponse<IAdminSession>>;
+    login(input: {
+        email: string;
+        password: string;
+    }): Promise<IApiResponse<IAdminSession>>;
+    /** The authenticator secret and otpauth URI to scan while enrolling. */
+    enrollment(): Promise<IApiResponse<IAdminEnrollment>>;
+    /** Confirms the first code. The response carries the backup codes, once. */
+    confirmEnrollment(code: string): Promise<IApiResponse<IAdminSession>>;
+    /** The second factor after the password: an authenticator code or a backup code. */
+    verify(factor: IAdminSecondFactor): Promise<IApiResponse<IAdminSession>>;
+    /** A fresh code for the next five minutes of dangerous actions. */
+    stepUp(factor: IAdminSecondFactor): Promise<IApiResponse<{
+        stepUpFresh: boolean;
+        backupCodesLeft?: number;
+    }>>;
+    logout(): Promise<IApiResponse<undefined>>;
+    /** What an invite or recovery link is for, before setting a password. */
+    inspectLink(token: string): Promise<IApiResponse<{
+        kind: "invite" | "recovery";
+        email: string;
+    }>>;
+    redeemLink(input: {
+        token: string;
+        password: string;
+        name?: string;
+    }): Promise<IApiResponse<IAdminSession>>;
+    operators(): Promise<IApiResponse<IAdminOperatorsReport>>;
+    /** An invite link, shown once. Needs the highest scope and a fresh code. */
+    inviteOperator(input: {
+        email: string;
+        scopes: AdminScope[];
+        expiresInHours?: number;
+    }): Promise<IApiResponse<IAdminCreatedLink>>;
+    /** Lost password or authenticator: a single-use link; signs them out everywhere. */
+    recoverOperator(id: string): Promise<IApiResponse<IAdminCreatedLink>>;
+    updateOperator(id: string, input: {
+        scopes?: AdminScope[];
+        name?: string;
+        disabled?: boolean;
+    }): Promise<IApiResponse<IAdminOperator>>;
+    revokeOperatorLink(id: string): Promise<IApiResponse<undefined>>;
 }
 
 interface IAuthAdminClientOptions {
@@ -1643,5 +1749,25 @@ declare function castConfigValue(type: ConfigValueType, raw: string): CastResult
  */
 declare const CONFIG_KEY_PATTERN: RegExp;
 declare function configKeyProblem(key: string): string | null;
+interface IInferredConfigValue {
+    type: ConfigValueType;
+    value: unknown;
+    /** Human label for the detected shape: Text, Number, On/off, Object, List. */
+    label: string;
+    /**
+     * True when the input could equally be meant as text — "true", "42". The
+     * editor offers "save as text instead" for exactly these, and never needs
+     * to ask about anything else.
+     */
+    ambiguous: boolean;
+}
+/** Human label for a stored value's shape. */
+declare function configValueLabel(value: unknown): string;
+/**
+ * Work out what an operator typed, without asking. Objects and lists (JSON
+ * starting with { or [), on/off (true/false), plain numbers, and text for
+ * everything else — including anything that merely resembles a number.
+ */
+declare function inferConfigValue(raw: string): IInferredConfigValue;
 
-export { AdminClient, type AdminRouteGuard, type AdminScope, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminDoctorReport, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, castConfigValue, configKeyProblem, configValueType, createMemoryCache, describeLocation, formatConfigValue, isMfaRequired };
+export { AdminClient, type AdminRouteGuard, type AdminScope, type AdminSessionState, AuditAdminClient, AuditClient, AuthAdminClient, AuthClient, BillingAdminClient, BillingClient, CONFIG_KEY_PATTERN, CONFIG_VALUE_TYPES, type CastResult, ConfigAdminClient, ConfigClient, type ConfigValueType, CourierAdminClient, type CustomerLabelType, type CustomerSex, type CustomerType, CustomersClient, FonderieApiError, FonderieClient, type IAcceptInvitationResult, type IAddAddressInput, type IAddEmailInput, type IAddPhoneInput, type IAddRelationshipInput, type IAddressDTO, type IAdminAttention, type IAdminAttentionItem, type IAdminAuditQuery, type IAdminCatalog, type IAdminCheckResult, type IAdminClientOptions, type IAdminCreatedLink, type IAdminDoctorReport, type IAdminEnrollment, type IAdminEnvironmentReport, type IAdminGrantInput, type IAdminIssueTokenInput, type IAdminIssuedToken, type IAdminLedgerQuery, type IAdminLogEntry, type IAdminLogPage, type IAdminLogQuery, type IAdminLoginHistoryQuery, type IAdminManifest, type IAdminMigrationModule, type IAdminMigrationsReport, type IAdminModuleEntry, type IAdminOperator, type IAdminOperatorLink, type IAdminOperatorsReport, type IAdminPendingMigration, type IAdminPlanInput, type IAdminReadiness, type IAdminReadinessProblem, type IAdminRouteEntry, type IAdminRoutesReport, type IAdminSecondFactor, type IAdminSession, type IAdminSubscriptionDTO, type IAdminSubscriptionPage, type IAdminSubscriptionsQuery, type IAdminTokenRecord, type IAdminTokensReport, type IAdminUserDTO, type IAdminUserPageResult, type IAdminUsersQuery, type IAdminWalletDTO, type IAdminWalletLedgerPage, type IApiError, type IApiResponse, type IAppleNativeInput, type IAuditAdminClientOptions, type IAuditEventDTO, type IAuditPageResult, type IAuthAdminClientOptions, type IBillingAdminClientOptions, type IBlacklistCustomerInput, type ICache, type ICancelSubscriptionInput, type IChangePasswordInput, type ICheckoutInput, type ICheckoutUrlResult, type IClientAuthConfig, type IConfigAdminClientOptions, type IConfigEntry, type IConfigRevision, type ICourierAdminClientOptions, type ICreateCustomerInput, type ICreatePlanInput, type ICreateRoleInput, type ICreateWebhookEndpointInput, type ICreateWorkspaceInput, type ICustomerAddressDTO, type ICustomerAddressListResult, type ICustomerAddressResult, type ICustomerDTO, type ICustomerDetailD2DTO, type ICustomerDetailDTO, type ICustomerEmailDTO, type ICustomerEmailListResult, type ICustomerEmailResult, type ICustomerLabelDTO, type ICustomerLabelListResult, type ICustomerListResult, type ICustomerNoteDTO, type ICustomerNoteListResult, type ICustomerNoteResult, type ICustomerPhoneDTO, type ICustomerPhoneListResult, type ICustomerPhoneResult, type ICustomerRelationshipDTO, type ICustomerRelationshipExpandedD2DTO, type ICustomerRelationshipExpandedDTO, type ICustomerRelationshipListResult, type ICustomerRelationshipResult, type ICustomerResult, type ICustomerShallowDTO, type ICustomerTagListResult, type IFonderieClientOptions, type IGetCustomerInput, type IGetLoginHistoryInput, type IInferredConfigValue, type IInvitationDTO, type IInvitationListResult, type IInviteEntry, type IInviteResult, type IInvoiceDTO, type IInvoicesResult, type IListAuditEventsInput, type IListCustomersInput, type ILoginEventDTO, type ILoginHistoryPageResult, type ILoginInput, type ILoginResult, type IMeResult, type IMediaAssetDTO, type IMediaAssetResult, type IMemberDTO, type IMemberListResult, type IMemoryCacheOptions, type IMfaEnabledResult, type IMfaRequiredResult, type IMfaSetupResult, type IPaymentMethodDTO, type IPaymentMethodResult, type IPlanDTO, type IPlanFeature, type IPlanListResult, type IPlanResult, type IPortalUrlResult, type IPreviewTemplateInput, type IReadOptions, type IRecordUsageInput, type IRefreshResult, type IRegisterInput, type IRegisterResult, type IRemoteConfigState, type IRenderedTemplateResult, type IRequestConfig, type IRequestLocationDTO, type IResendVerificationResult, type IResetPasswordInput, type IRevealSecretResult, type IRoleDTO, type IRoleListResult, type IRolePermission, type IRolePermissionInput, type IRolePermissionsResult, type IRoleResult, type IRollbackInput, type IRollbackTemplateInput, type ISecretEntry, type ISecretRevision, type ISessionDTO, type ISessionsResult, type ISetConfigInput, type ISetSecretInput, type ISetTemplateInput, type ISubscriptionChangeResult, type ISubscriptionDTO, type ISubscriptionResult, type ITemplateEntry, type ITemplateRevision, type ITestWebhookResult, type ITokens, type IUpdateCustomerInput, type IUpdatePlanInput, type IUpdatePreferencesInput, type IUpdateProfileInput, type IUpdateRoleInput, type IUpdateSettingsInput, type IUpdateWebhookEndpointInput, type IUpdateWorkspaceInput, type IUploadMediaInput, type IUsageResult, type IUserDTO, type IUserPreferences, type IVerifyEmailResult, type IWalletCheckoutInput, type IWalletDTO, type IWalletPreferencesInput, type IWalletPurchaseInput, type IWalletPurchaseResult, type IWalletResult, type IWalletTransactionDTO, type IWalletTransactionsResult, type IWebhookDeliveryDTO, type IWebhookDeliveryListResult, type IWebhookEndpointCreatedDTO, type IWebhookEndpointDTO, type IWebhookEndpointListResult, type IWorkspaceAddressDTO, type IWorkspaceDTO, type IWorkspaceListResult, type IWorkspaceResult, type IWorkspaceSettingsDTO, type IWorkspaceSettingsResult, MediaClient, type MigrationImpact, type SubscriberType, WebhooksClient, WorkspacesClient, castConfigValue, configKeyProblem, configValueLabel, configValueType, createMemoryCache, describeLocation, formatConfigValue, inferConfigValue, isMfaRequired };

package/dist/index.js

@@ -1865,6 +1865,75 @@ var AdminClient = class {
       { expect }
     );
   }
+  // ── operator sign-in (the served console's gate) ──────────────────────
+  // Cookie-based: the server sets an HttpOnly session cookie; nothing here
+  // ever holds it. Omit adminToken on this client — except for claim().
+  /** Who is signed in, and whether the console can still be claimed. */
+  session() {
+    return this.get("/session");
+  }
+  /** The one-time claim. Needs the ROOT token as this client's adminToken. */
+  claim(input) {
+    return this.call("POST", "/session/claim", input);
+  }
+  login(input) {
+    return this.call("POST", "/session/login", input);
+  }
+  /** The authenticator secret and otpauth URI to scan while enrolling. */
+  enrollment() {
+    return this.get("/session/enrollment");
+  }
+  /** Confirms the first code. The response carries the backup codes, once. */
+  confirmEnrollment(code) {
+    return this.call("POST", "/session/enrollment", { code });
+  }
+  /** The second factor after the password: an authenticator code or a backup code. */
+  verify(factor) {
+    return this.call("POST", "/session/verify", factor);
+  }
+  /** A fresh code for the next five minutes of dangerous actions. */
+  stepUp(factor) {
+    return this.call(
+      "POST",
+      "/session/step-up",
+      factor
+    );
+  }
+  logout() {
+    return this.call("DELETE", "/session");
+  }
+  /** What an invite or recovery link is for, before setting a password. */
+  inspectLink(token) {
+    return this.call(
+      "POST",
+      "/session/link/inspect",
+      { token }
+    );
+  }
+  redeemLink(input) {
+    return this.call("POST", "/session/link", input);
+  }
+  // ── managing operators ─────────────────────────────────────────────────
+  operators() {
+    return this.get("/access/operators");
+  }
+  /** An invite link, shown once. Needs the highest scope and a fresh code. */
+  inviteOperator(input) {
+    return this.call("POST", "/access/operators/invites", input);
+  }
+  /** Lost password or authenticator: a single-use link; signs them out everywhere. */
+  recoverOperator(id) {
+    return this.call(
+      "POST",
+      `/access/operators/${encodeURIComponent(id)}/recovery`
+    );
+  }
+  updateOperator(id, input) {
+    return this.call("PUT", `/access/operators/${encodeURIComponent(id)}`, input);
+  }
+  revokeOperatorLink(id) {
+    return this.call("DELETE", `/access/operators/links/${encodeURIComponent(id)}`);
+  }
 };
 
 // src/modules/auth-admin.ts
@@ -2180,6 +2249,35 @@ function configKeyProblem(key) {
   if (!key) return "Enter a key.";
   return CONFIG_KEY_PATTERN.test(key) ? null : 'Start with a letter; use letters, digits, ".", "_" or "-" (max 128).';
 }
+var PLAIN_NUMBER = /^-?(0|[1-9]\d*)(\.\d+)?$/;
+function configValueLabel(value) {
+  if (typeof value === "string") return "Text";
+  if (typeof value === "number") return "Number";
+  if (typeof value === "boolean") return "On/off";
+  if (Array.isArray(value)) return "List";
+  if (value === null) return "Empty";
+  return "Object";
+}
+function inferConfigValue(raw) {
+  const t = raw.trim();
+  if (t === "true" || t === "false") {
+    return { type: "boolean", value: t === "true", label: "On/off", ambiguous: true };
+  }
+  if (PLAIN_NUMBER.test(t)) {
+    const n = Number(t);
+    if (Number.isFinite(n) && String(n) === t) return { type: "number", value: n, label: "Number", ambiguous: true };
+  }
+  if (t.startsWith("{") || t.startsWith("[")) {
+    try {
+      const parsed = JSON.parse(t);
+      if (parsed !== null && typeof parsed === "object") {
+        return { type: "json", value: parsed, label: Array.isArray(parsed) ? "List" : "Object", ambiguous: false };
+      }
+    } catch {
+    }
+  }
+  return { type: "string", value: raw, label: "Text", ambiguous: false };
+}
 export {
   AdminClient,
   AuditAdminClient,
@@ -2201,10 +2299,12 @@ export {
   WorkspacesClient,
   castConfigValue,
   configKeyProblem,
+  configValueLabel,
   configValueType,
   createMemoryCache,
   describeLocation,
   formatConfigValue,
+  inferConfigValue,
   isMfaRequired
 };
 //# sourceMappingURL=index.js.map