@riverbankcms/sdk 0.138.0 → 0.140.0

package/dist/_dts/api/src/accessAdmin.d.ts

@@ -1,14 +1,13 @@
-import type { MembershipSummary } from "../../billing/src/membership/index";
-import type { BillingInterval } from "../../billing/src/plans/types";
-import type { CamelizeKeys, DbRow, SupportedAdminRole } from "../../db/src/index";
-import { z } from "zod";
-import type { PageRecord } from "./contentRuntime";
-import type { SiteDeploymentMode } from "./siteSettings";
-import type { SiteRole } from "./siteMembers";
-import type { SiteAccessSummary, SitePlanSummaryResponse } from "./siteAccessAdmin";
-import type { AdminAddAllowedDomainBodyInput } from "./schemas/admin-allowed-domains";
-import type { AdminCreateUserBodyInput } from "./schemas/admin-users";
-export type { SiteAccessSummary, SitePlanSummaryResponse, } from "./siteAccessAdmin";
+import type { CamelizeKeys, DbRow, SupportedAdminRole } from '../../db/src/index';
+import { z } from 'zod';
+import type { PageRecord } from './contentRuntime';
+import type { SiteDeploymentMode } from './siteSettings';
+import type { SiteRole } from './siteMembers';
+import type { SiteAccessSummary, SitePlanSummaryResponse } from './siteAccessAdmin';
+import type { AdminAddAllowedDomainBodyInput } from './schemas/admin-allowed-domains';
+import type { AdminCreateUserBodyInput } from './schemas/admin-users';
+export type { SiteAccessSummary, SitePlanSummaryResponse, } from './siteAccessAdmin';
+export type { AdminChangePlanRequest, AdminChangePlanResponse, ChangePlanRequest, ChangePlanResponse, } from './billingEndpointTypes';
 /**
  * Access, Domain, and Admin Contracts
  *
@@ -19,8 +18,8 @@ export type { SiteAccessSummary, SitePlanSummaryResponse, } from "./siteAccessAd
  * Note: Do NOT use these API types as validation schemas. They capture wire shapes,
  * while the owning auth/domain/admin services still validate and normalize inputs.
  */
-type AdminInviteRow = DbRow<"admin_invites">;
-type AllowedEmailDomainRow = DbRow<"allowed_email_domains">;
+type AdminInviteRow = DbRow<'admin_invites'>;
+type AllowedEmailDomainRow = DbRow<'allowed_email_domains'>;
 export type AdminInvite = CamelizeKeys<AdminInviteRow>;
 export type AllowedEmailDomain = CamelizeKeys<AllowedEmailDomainRow>;
 export type SiteMemberProfile = {
@@ -77,25 +76,7 @@ export type ListSiteMembersResponse = {
     access: SiteAccessSummary;
     plan: SitePlanSummaryResponse;
 };
-export type AuthFieldKey = "email" | "password" | "confirmPassword" | "name" | "terms" | "magicLink";
-export type AuthSubmissionErrorReason = "validation" | "spam_protection" | "supabase" | "already_registered" | "rate_limited" | "email" | "closed" | "invalid_credentials" | "not_confirmed" | "not_allowed";
-export type AuthSubmissionSuccess = {
-    status: "success";
-    message: string;
-    redirectTo?: string;
-    flash?: Record<string, unknown>;
-};
-export type AuthSubmissionError = {
-    status: "error";
-    reason: AuthSubmissionErrorReason;
-    message: string;
-    fieldErrors?: Partial<Record<AuthFieldKey, string>>;
-    retryAfterSeconds?: number;
-};
-export type AuthSubmissionResult = AuthSubmissionSuccess | AuthSubmissionError;
-export type ReauthSubmissionResult = AuthSubmissionResult & {
-    setReenrollCookie?: boolean;
-};
+export type { AuthFieldKey, AuthRegistrationNext, AuthSubmissionError, AuthSubmissionErrorReason, AuthSubmissionResult, AuthSubmissionSuccess, ReauthSubmissionResult, } from './authSubmission';
 export type DomainAvailability = {
     domain: string;
     available: boolean;
@@ -103,9 +84,9 @@ export type DomainAvailability = {
     currency?: string;
     premium?: boolean;
     reason?: string;
-    source?: "lookup" | "suggestion" | "heuristic";
+    source?: 'lookup' | 'suggestion' | 'heuristic';
 };
-export type SiteDomainRecord = CamelizeKeys<DbRow<"site_domains">>;
+export type SiteDomainRecord = CamelizeKeys<DbRow<'site_domains'>>;
 export type SiteDomainContactPayload = {
     firstName: string;
     lastName: string;
@@ -174,7 +155,7 @@ export type RegisterDomainRequestPayload = {
     saveContactToProfile?: boolean;
 };
 export type DomainConfigResult = {
-    status: "pending_vercel" | "pending_email" | "pending_dns" | "ready" | "failed";
+    status: 'pending_vercel' | 'pending_email' | 'pending_dns' | 'ready' | 'failed';
     error?: string;
     vercelVerified?: boolean;
     resendDomainId?: string;
@@ -187,9 +168,9 @@ export type RegisterDomainResponse = {
     };
     configResult: DomainConfigResult;
 };
-export type RegistrarLifecycleState = "registered" | "configuring" | "awaiting_registrant_verification" | "ready" | "renewal_at_risk" | "renewal_failed" | "transfer_out_requested" | "expired" | "redemption" | "suspended";
-export type RegistrarLifecycleMutationOutcome = "succeeded" | "pending" | "repaired";
-export type RegistrarLifecycleMutationOperation = "update_contact" | "enable_privacy" | "disable_privacy" | "enable_auto_renew" | "disable_auto_renew" | "unlock" | "retrieve_epp";
+export type RegistrarLifecycleState = 'registered' | 'configuring' | 'awaiting_registrant_verification' | 'ready' | 'renewal_at_risk' | 'renewal_failed' | 'transfer_out_requested' | 'expired' | 'redemption' | 'suspended';
+export type RegistrarLifecycleMutationOutcome = 'succeeded' | 'pending' | 'repaired';
+export type RegistrarLifecycleMutationOperation = 'update_contact' | 'enable_privacy' | 'disable_privacy' | 'enable_auto_renew' | 'disable_auto_renew' | 'unlock' | 'retrieve_epp';
 export type RegistrarLifecycleMutationBase<TOperation extends RegistrarLifecycleMutationOperation> = {
     operation: TOperation;
     outcome: RegistrarLifecycleMutationOutcome;
@@ -197,22 +178,22 @@ export type RegistrarLifecycleMutationBase<TOperation extends RegistrarLifecycle
     responseCode?: number;
     providerDetail?: string;
 };
-export type RegistrarLifecycleMutationResponse = RegistrarLifecycleMutationBase<"update_contact"> | (RegistrarLifecycleMutationBase<"enable_privacy" | "disable_privacy"> & {
+export type RegistrarLifecycleMutationResponse = RegistrarLifecycleMutationBase<'update_contact'> | (RegistrarLifecycleMutationBase<'enable_privacy' | 'disable_privacy'> & {
     privacyEnabled: boolean;
-}) | (RegistrarLifecycleMutationBase<"enable_auto_renew" | "disable_auto_renew"> & {
+}) | (RegistrarLifecycleMutationBase<'enable_auto_renew' | 'disable_auto_renew'> & {
     autoRenew: boolean;
-}) | (RegistrarLifecycleMutationBase<"unlock"> & {
-    lifecycleState: "transfer_out_requested";
-}) | (RegistrarLifecycleMutationBase<"retrieve_epp"> & {
-    lifecycleState: "transfer_out_requested";
+}) | (RegistrarLifecycleMutationBase<'unlock'> & {
+    lifecycleState: 'transfer_out_requested';
+}) | (RegistrarLifecycleMutationBase<'retrieve_epp'> & {
+    lifecycleState: 'transfer_out_requested';
 } & ({
-    eppCodeDelivery: "provider_delivered";
+    eppCodeDelivery: 'provider_delivered';
 } | {
-    eppCodeDelivery: "returned";
+    eppCodeDelivery: 'returned';
     eppCode: string;
 }));
 export type ExposedRegistrarLifecycleMutationResponse = Extract<RegistrarLifecycleMutationResponse, {
-    operation: "update_contact" | "enable_privacy" | "disable_privacy" | "enable_auto_renew" | "disable_auto_renew";
+    operation: 'update_contact' | 'enable_privacy' | 'disable_privacy' | 'enable_auto_renew' | 'disable_auto_renew';
 }>;
 export type RegistrarLifecycleResponse = {
     domain: SiteDomainRecord;
@@ -224,16 +205,16 @@ export type RegistrarBooleanMutationRequest = {
 export type RegistrarRenewalCostEstimate = {
     amount: number;
     currency?: string;
-    source: "provider_quote" | "manual" | "last_registration";
+    source: 'provider_quote' | 'manual' | 'last_registration';
 };
-export type RegistrarProviderName = "namesilo";
-export type RegistrarRenewalRiskReason = "auto_renew_disabled" | "insufficient_registrar_funds";
-export type RegistrarRenewalManualReviewReason = "not_managed_by_registrar" | "registered_domain_missing_registrar" | "missing_expiry" | "invalid_expiry" | "invalid_registrar_balance" | "invalid_renewal_cost_estimate" | "missing_renewal_cost_estimate" | "registrar_balance_unavailable" | "registrar_balance_unsupported" | "currency_mismatch";
-export type RegistrarRenewalManualReviewReasonWithoutExpiry = "not_managed_by_registrar" | "registered_domain_missing_registrar" | "missing_expiry" | "invalid_expiry";
+export type RegistrarProviderName = 'namesilo';
+export type RegistrarRenewalRiskReason = 'auto_renew_disabled' | 'insufficient_registrar_funds';
+export type RegistrarRenewalManualReviewReason = 'not_managed_by_registrar' | 'registered_domain_missing_registrar' | 'missing_expiry' | 'invalid_expiry' | 'invalid_registrar_balance' | 'invalid_renewal_cost_estimate' | 'missing_renewal_cost_estimate' | 'registrar_balance_unavailable' | 'registrar_balance_unsupported' | 'currency_mismatch';
+export type RegistrarRenewalManualReviewReasonWithoutExpiry = 'not_managed_by_registrar' | 'registered_domain_missing_registrar' | 'missing_expiry' | 'invalid_expiry';
 export type RegistrarRenewalManualReviewReasonWithExpiry = Exclude<RegistrarRenewalManualReviewReason, RegistrarRenewalManualReviewReasonWithoutExpiry>;
-export type RegistrarRenewalFailedReason = "past_expiry" | "renewal_failed_lifecycle" | "expired_lifecycle" | "redemption_lifecycle" | "suspended_lifecycle";
+export type RegistrarRenewalFailedReason = 'past_expiry' | 'renewal_failed_lifecycle' | 'expired_lifecycle' | 'redemption_lifecycle' | 'suspended_lifecycle';
 export type RegistrarRenewalPosture = {
-    kind: "funded";
+    kind: 'funded';
     domain: string;
     provider: RegistrarProviderName;
     expiresAt: string;
@@ -241,67 +222,70 @@ export type RegistrarRenewalPosture = {
     availableBalance: number;
     renewalCost: RegistrarRenewalCostEstimate;
 } | {
-    kind: "at_risk";
+    kind: 'at_risk';
     domain: string;
     provider: RegistrarProviderName;
     expiresAt: string;
     daysUntilExpiry: number;
-    reasons: readonly [RegistrarRenewalRiskReason, ...RegistrarRenewalRiskReason[]];
+    reasons: readonly [
+        RegistrarRenewalRiskReason,
+        ...RegistrarRenewalRiskReason[]
+    ];
     availableBalance?: number;
     renewalCost?: RegistrarRenewalCostEstimate;
 } | {
-    kind: "failed";
+    kind: 'failed';
     domain: string;
     provider: RegistrarProviderName | null;
     reason: RegistrarRenewalFailedReason;
     expiresAt: string;
 } | {
-    kind: "manual_review";
+    kind: 'manual_review';
     domain: string;
     provider: RegistrarProviderName | null;
     reason: RegistrarRenewalManualReviewReasonWithoutExpiry;
 } | {
-    kind: "manual_review";
+    kind: 'manual_review';
     domain: string;
     provider: RegistrarProviderName;
     reason: RegistrarRenewalManualReviewReasonWithExpiry;
     expiresAt: string;
 };
-export type ManagedDomainBillingAddOnStatus = "pending_acceptance" | "accepted" | "sync_failed" | "registrar_failed" | "registrar_succeeded_persist_failed" | "active" | "ending" | "ended" | "failed";
+export type ManagedDomainBillingAddOnStatus = 'pending_acceptance' | 'accepted' | 'sync_failed' | 'registrar_failed' | 'registrar_succeeded_persist_failed' | 'active' | 'ending' | 'ended' | 'failed';
 export type ManagedDomainBillingAddOnPosture = {
-    kind: "unknown_renewal_cost";
-    reason: "missing_renewal_cost" | "unsupported_renewal_currency" | "invalid_renewal_cost";
+    kind: 'unknown_renewal_cost';
+    reason: 'missing_renewal_cost' | 'unsupported_renewal_currency' | 'invalid_renewal_cost';
 } | {
-    kind: "included_allowance";
+    kind: 'included_allowance';
     renewalCost: RegistrarRenewalCostEstimate;
     includedAnnualAllowance: number;
 } | {
-    kind: "add_on_current";
+    kind: 'add_on_current';
     componentId: string;
     renewalCost: RegistrarRenewalCostEstimate;
     acceptedRegistrarAnnualCost: number;
     monthlyAmountCents: number;
-    monthlyCurrency: "gbp";
+    monthlyCurrency: 'gbp';
 } | {
-    kind: "add_on_price_drift";
+    kind: 'add_on_price_drift';
     componentId: string;
-    reason: "renewal_cost_changed" | "now_within_allowance";
+    reason: 'renewal_cost_changed' | 'now_within_allowance';
     renewalCost: RegistrarRenewalCostEstimate;
     acceptedRegistrarAnnualCost: number;
     monthlyAmountCents: number;
-    monthlyCurrency: "gbp";
+    monthlyCurrency: 'gbp';
 } | {
-    kind: "missing_add_on";
+    kind: 'missing_add_on';
     renewalCost: RegistrarRenewalCostEstimate;
     includedAnnualAllowance: number;
 } | {
-    kind: "inactive_add_on";
+    kind: 'inactive_add_on';
     componentId: string;
-    status: Exclude<ManagedDomainBillingAddOnStatus, "active">;
+    status: Exclude<ManagedDomainBillingAddOnStatus, 'active'>;
     renewalCost: RegistrarRenewalCostEstimate;
     includedAnnualAllowance: number;
 } | {
-    kind: "invalid_add_on_snapshot";
+    kind: 'invalid_add_on_snapshot';
     componentId: string;
     renewalCost: RegistrarRenewalCostEstimate;
 };
@@ -314,7 +298,7 @@ export type RegistrarAccountBalance = {
 } | {
     success: false;
     provider: RegistrarProviderName;
-    reason: "unsupported" | "provider_error";
+    reason: 'unsupported' | 'provider_error';
     error: string;
 };
 export type RegistrarRenewalPostureResponse = {
@@ -342,12 +326,12 @@ export type BulkOperationResult = {
 };
 export type InviteSiteMemberRequest = {
     email: string;
-    role: "team_member";
+    role: 'team_member';
     staffMemberId: string;
     staffCapabilities: StaffOperationalCapability[];
 } | {
     email: string;
-    role: "editor" | "administrator";
+    role: 'editor' | 'administrator';
 };
 export type InviteSiteMemberEmailResult = {
     ok: true;
@@ -361,9 +345,9 @@ export type InviteSiteMemberResponse = {
     email?: InviteSiteMemberEmailResult;
 };
 export type UpdateSiteMemberRoleRequest = {
-    role: "editor" | "administrator";
+    role: 'editor' | 'administrator';
 } | {
-    role: "team_member";
+    role: 'team_member';
     staffMemberId?: string;
     staffCapabilities: StaffOperationalCapability[];
 };
@@ -387,7 +371,7 @@ export type ResendSiteInvitationResponse = {
     invitation: SiteInvitation;
     email: {
         ok: true;
-        status: "sent" | "recently_sent" | "in_progress";
+        status: 'sent' | 'recently_sent' | 'in_progress';
     };
 };
 export type TransferSiteOwnershipRequest = {
@@ -428,8 +412,8 @@ export type AcceptSiteInvitationResponse = {
 };
 export type MfaFactorSummary = {
     id: string;
-    type: "totp" | "phone" | (string & {});
-    status: "verified" | "unverified" | "pending" | "failed" | (string & {});
+    type: 'totp' | 'phone' | (string & {});
+    status: 'verified' | 'unverified' | 'pending' | 'failed' | (string & {});
     friendlyName: string | null;
     createdAt: string | null;
     updatedAt: string | null;
@@ -447,7 +431,7 @@ export type MfaOverviewPayload = {
 };
 export type MfaTotpEnrollResponse = {
     factorId: string;
-    type: "totp";
+    type: 'totp';
     friendlyName: string | null;
     secret: string;
     uri: string;
@@ -602,45 +586,31 @@ export type AdminDeleteUserResponse = {
     deletedSiteIds: string[];
 } | {
     ok: false;
-    reason: "owns_sites";
+    reason: 'owns_sites';
     ownedSites: AdminOwnedSiteSummary[];
 } | {
     ok: false;
-    reason: "self_delete_forbidden";
+    reason: 'self_delete_forbidden';
 } | {
     ok: false;
-    reason: "fk_restrict";
+    reason: 'fk_restrict';
     message: string;
 } | {
     ok: false;
-    reason: "auth_delete_failed";
+    reason: 'auth_delete_failed';
     message: string;
 } | {
     ok: false;
-    reason: "site_delete_failed";
+    reason: 'site_delete_failed';
     deletedSiteIds: string[];
     failedSiteId: string;
     message: string;
 };
-export type ChangePlanRequest = {
-    planId: string;
-    interval: BillingInterval;
-    prorationBehavior?: "create_prorations" | "always_invoice" | "none";
-};
-export type ChangePlanResponse = {
-    membership: MembershipSummary | null;
-};
-export type AdminChangePlanRequest = ChangePlanRequest & {
-    userId: string;
-    reason?: string;
-    bypassProration?: boolean;
-};
-export type AdminChangePlanResponse = ChangePlanResponse;
 export type BillingPriceOverride = {
     id: string;
     userId: string;
     planId: string;
-    interval: "month" | "year";
+    interval: 'month' | 'year';
     amountCents: number;
     currency: string;
     validFrom: string | null;
@@ -654,7 +624,7 @@ export type BillingPriceOverride = {
 export type AdminGetPriceOverrideQuery = {
     userId: string;
     planId: string;
-    interval: "month" | "year";
+    interval: 'month' | 'year';
 };
 export type AdminGetPriceOverrideResponse = {
     hasOverride: boolean;
@@ -664,7 +634,7 @@ export type AdminGetPriceOverrideResponse = {
 export type AdminUpsertPriceOverrideRequest = {
     userId: string;
     planId: string;
-    interval: "month" | "year";
+    interval: 'month' | 'year';
     amountCents: number;
     currency?: string;
     validFrom?: string | null;
@@ -677,7 +647,7 @@ export type AdminUpsertPriceOverrideResponse = {
 export type AdminDeletePriceOverrideRequest = {
     userId: string;
     planId: string;
-    interval: "month" | "year";
+    interval: 'month' | 'year';
     reason?: string;
 };
 export type AdminDeletePriceOverrideResponse = {

package/dist/_dts/api/src/aiEndpoints.d.ts

@@ -4,8 +4,9 @@ import type { AiPatchApplyResponse, AiPatchDryRunResponse, AiPatchRequest } from
 import type { ApplyAiDesignerPageOpsRequest, ApplyAiDesignerPageOpsResponse, ApplyAiDesignerThemePatchRequest, ApplyAiDesignerThemePatchResponse, PageConvertJobEventsResponse, PageConvertJobGetResponse, PageConvertJobRunResponse, PageConvertJobsCreateRequest, PageConvertJobsCreateResponse, PageConvertJobsListResponse, PageConvertResponse, PlaygroundProposeRequest } from "./aiPlayground";
 import type { AiGenerateSiteRequest, AiGenerateSiteResponse } from "./siteGeneration";
 import type { AcknowledgeLaunchRequirementRequest, AcknowledgeLaunchRequirementResponse, AiSiteWizardIntakeTriageRequest, AiSiteWizardIntakeTriageResponse, AiSiteWizardSuggestGoalsRequest, AiSiteWizardSuggestGoalsResponse, AiSiteWizardTelemetryRequest, AiSiteWizardTelemetryResponse, GoLiveSiteRequest, GoLiveSiteResponse, OnboardingPreviewStatusResponse, OnboardingPreviewThemesResponse, PublicOnboardingAttemptPayload, PublicOnboardingAttemptProgressResponse, PublicOnboardingAttemptResponse, PublicOnboardingAttemptRunResponse, PublicOnboardingLogoUploadRequest, PublicOnboardingLogoUploadResponse, PublicOnboardingLogoUploadUrlRequest, PublicOnboardingLogoUploadUrlResponse, ResendOnboardingPreviewConfirmationResponse } from "./siteOnboarding";
+import type { PublicOnboardingAttemptConfirmationResendResponse } from "./onboarding/confirmationResend";
 export type AiAPIEndpointName = "aiAssistantChatSite" | "aiDesignerChat" | "aiContentUpdateChat" | "aiChat" | "aiDesignerThemeApply" | "aiDesignerPageOpsApply" | "aiCreateBriefChat" | "aiPatchDryRun" | "aiPatchApply" | "aiPlaygroundProposeMulti" | "aiPlaygroundProposeMultiGet" | "aiPlaygroundPageConvert" | "aiPlaygroundPageConvertJobsCreate" | "aiPlaygroundPageConvertJobsList" | "aiPlaygroundPageConvertJobGet" | "aiPlaygroundPageConvertJobRun" | "aiPlaygroundPageConvertJobEvents" | "aiGenerateSite" | "aiSiteWizardSuggestGoals" | "aiSiteWizardIntakeTriage" | "aiSiteWizardTelemetry";
-export type LaunchReadinessAPIEndpointName = "getOnboardingPreviewStatus" | "listOnboardingPreviewThemes" | "acknowledgeLaunchRequirement" | "goLiveSite" | "resendOnboardingPreviewConfirmation" | "createPublicOnboardingAttempt" | "createPublicOnboardingLogoUploadUrl" | "uploadPublicOnboardingLogo" | "getPublicOnboardingAttempt" | "getPublicOnboardingAttemptProgress" | "updatePublicOnboardingAttempt" | "runPublicOnboardingAttempt";
+export type LaunchReadinessAPIEndpointName = "getOnboardingPreviewStatus" | "listOnboardingPreviewThemes" | "acknowledgeLaunchRequirement" | "goLiveSite" | "resendOnboardingPreviewConfirmation" | "createPublicOnboardingAttempt" | "createPublicOnboardingLogoUploadUrl" | "uploadPublicOnboardingLogo" | "getPublicOnboardingAttempt" | "getPublicOnboardingAttemptProgress" | "updatePublicOnboardingAttempt" | "runPublicOnboardingAttempt" | "resendPublicOnboardingAttemptConfirmation";
 /**
  * AI and launch-readiness endpoints stay together because the generated site flow spans
  * designer chat/apply tools, site generation, and preview-to-go-live onboarding steps.
@@ -118,6 +119,9 @@ export type AiAndLaunchReadinessAPIEndpointDefinitions = {
     runPublicOnboardingAttempt: APIEndpoint<never, {
         attemptToken: string;
     }, PublicOnboardingAttemptRunResponse>;
+    resendPublicOnboardingAttemptConfirmation: APIEndpoint<never, {
+        attemptToken: string;
+    }, PublicOnboardingAttemptConfirmationResendResponse>;
     aiSiteWizardSuggestGoals: APIEndpoint<AiSiteWizardSuggestGoalsRequest, {
         siteId: string;
     }, AiSiteWizardSuggestGoalsResponse>;

package/dist/_dts/api/src/authSubmission.d.ts

@@ -0,0 +1,46 @@
+/**
+ * What the auth entry forms — sign in, register, forgot password, reauth —
+ * hand back to the browser.
+ *
+ * One shape for all of them, so the submit half they share can pass the
+ * server's answer through without knowing which form produced it.
+ */
+export type AuthFieldKey = 'email' | 'password' | 'confirmPassword' | 'name' | 'terms' | 'magicLink';
+export type AuthSubmissionErrorReason = 'validation' | 'spam_protection' | 'supabase' | 'already_registered' | 'rate_limited' | 'email' | 'closed' | 'invalid_credentials' | 'not_confirmed' | 'not_allowed';
+/**
+ * What the browser should do once a registration succeeds.
+ *
+ * This is the server's single answer, and the register page obeys it rather
+ * than deciding for itself. It has to be the server's call: what separates the
+ * two arms is the onboarding attempt behind the sign-up, and the register page
+ * deliberately does not load the attempt.
+ *
+ * `redirectTo` on the result below is derived from this and means the same
+ * thing, so the two cannot disagree.
+ */
+export type AuthRegistrationNext = Readonly<{
+    kind: 'redirect';
+    to: string;
+}> | Readonly<{
+    kind: 'await_email_confirmation';
+    email: string;
+}>;
+export type AuthSubmissionSuccess = {
+    status: 'success';
+    message: string;
+    redirectTo?: string;
+    /** Registration only; sign-in and reauth carry `redirectTo` alone. */
+    next?: AuthRegistrationNext;
+    flash?: Record<string, unknown>;
+};
+export type AuthSubmissionError = {
+    status: 'error';
+    reason: AuthSubmissionErrorReason;
+    message: string;
+    fieldErrors?: Partial<Record<AuthFieldKey, string>>;
+    retryAfterSeconds?: number;
+};
+export type AuthSubmissionResult = AuthSubmissionSuccess | AuthSubmissionError;
+export type ReauthSubmissionResult = AuthSubmissionResult & {
+    setReenrollCookie?: boolean;
+};

package/dist/_dts/api/src/billing.d.ts

@@ -1,6 +1,10 @@
 import type { ChangePlanRequest, ChangePlanResponse } from './types';
 import type { ApiClient } from './request';
+import type { BillingPlanId } from '../../billing/src/plans/types';
 import type { BillingComponentSummaryAddOnComponent, BillingComponentSummaryBasePlanComponent, BillingComponentSummaryComponent, BillingComponentSummarySiteComponent } from '../../billing/src/components/index';
+export type BillingPortalSessionResponse = Readonly<{
+    url: string;
+}>;
 import type { StripeAutomaticTaxIssue, StripeAutomaticTaxReadiness, StripeAutomaticTaxStatus } from '@riverbankcms/billing/tax/automatic-tax';
 import type { StripeConnectRestrictions } from '@riverbankcms/billing/stripe/connect-restrictions';
 import type { SiteBillingArrangement } from '../../billing/src/site-arrangements';
@@ -9,7 +13,7 @@ export type BillingStatusResponse = {
     subscriptionStatus: string | null;
     isPastDue: boolean;
     isUnpaid: boolean;
-    planId: string | null;
+    planId: BillingPlanId | null;
     needsAttention: boolean;
     status: string | null;
     setupRequired: boolean;
@@ -22,11 +26,17 @@ export type BillingStatusResponse = {
     totalSetupCostCents: number;
     totalSetupCostFormatted: string;
 };
+export type BillingCheckoutContinuation = {
+    kind: 'site_publish';
+    siteId: string;
+};
 export type BillingCheckoutRequest = {
     /** Plan ID (e.g., 'solo') */
-    planId: string;
+    planId: BillingPlanId;
     /** Billing interval */
-    interval: "monthly" | "annual";
+    interval: 'monthly';
+    /** Optional validated dashboard surface to resume after Checkout. */
+    continuation?: BillingCheckoutContinuation;
 };
 export type BillingCheckoutResponse = {
     sessionId: string;
@@ -57,8 +67,8 @@ export type BillingSummaryResponse = {
     } | null;
 };
 export type BillingSummaryComponent = BillingComponentSummaryComponent;
-export type BillingSummaryComponentKind = BillingSummaryComponent["kind"];
-export type BillingSummaryComponentSource = BillingSummaryComponent["source"];
+export type BillingSummaryComponentKind = BillingSummaryComponent['kind'];
+export type BillingSummaryComponentSource = BillingSummaryComponent['source'];
 export type BillingSummaryBasePlanComponent = BillingComponentSummaryBasePlanComponent;
 export type BillingSummarySiteComponent = BillingComponentSummarySiteComponent;
 export type BillingSummaryAddOnComponent = BillingComponentSummaryAddOnComponent;
@@ -94,9 +104,10 @@ export type StripeConnectDisconnectResponse = {
     success: boolean;
     message: string;
 };
-export declare function changePlan(apiClient: ApiClient, { planId, interval, prorationBehavior, options, }: ChangePlanRequest & {
+export declare function changePlan(apiClient: ApiClient, { attemptId, planId, interval, prorationBehavior, options, }: ChangePlanRequest & {
     options?: RequestInit;
 }): Promise<ChangePlanResponse>;
-export declare function billingCheckout(apiClient: ApiClient, { planId, interval, options, }: BillingCheckoutRequest & {
+export declare function createBillingPortalSession(apiClient: ApiClient, options?: RequestInit): Promise<BillingPortalSessionResponse>;
+export declare function billingCheckout(apiClient: ApiClient, { planId, interval, continuation, options, }: BillingCheckoutRequest & {
     options?: RequestInit;
 }): Promise<BillingCheckoutResponse>;

package/dist/_dts/api/src/billingEndpointDefinitions.d.ts

@@ -0,0 +1,23 @@
+export declare const BILLING_ENDPOINT_DEFINITIONS: {
+    adminChangePlan: {
+        path: "/admin/billing/plan";
+        method: "POST";
+        tags: ("admin" | "billing")[];
+        auth: "admin";
+        responseKind: "json";
+    };
+    changePlan: {
+        path: "/billing/plan/change";
+        method: "POST";
+        tags: "billing"[];
+        auth: "user";
+        responseKind: "json";
+    };
+    createBillingPortalSession: {
+        path: "/billing/portal/session";
+        method: "POST";
+        tags: "billing"[];
+        auth: "user";
+        responseKind: "json";
+    };
+};

package/dist/_dts/api/src/billingEndpointTypes.d.ts

@@ -0,0 +1,26 @@
+import type { MembershipSummary } from '../../billing/src/membership/index';
+import type { BillingInterval } from '../../billing/src/plans/types';
+import type { APIEndpoint } from './apiEndpointTypes';
+import type { BillingPortalSessionResponse } from './billing';
+export type ChangePlanRequest = Readonly<{
+    attemptId: string;
+    planId: string;
+    interval: 'monthly';
+    prorationBehavior?: 'create_prorations' | 'always_invoice' | 'none';
+}>;
+export type ChangePlanResponse = Readonly<{
+    membership: MembershipSummary | null;
+}>;
+export type AdminChangePlanRequest = Readonly<Omit<ChangePlanRequest, 'interval' | 'attemptId'> & {
+    attemptId?: string;
+    userId: string;
+    interval: BillingInterval;
+    reason?: string;
+    bypassProration?: boolean;
+}>;
+export type AdminChangePlanResponse = ChangePlanResponse;
+export type BillingAPIEndpoints = Readonly<{
+    adminChangePlan: APIEndpoint<AdminChangePlanRequest, never, AdminChangePlanResponse>;
+    changePlan: APIEndpoint<ChangePlanRequest, never, ChangePlanResponse>;
+    createBillingPortalSession: APIEndpoint<never, never, BillingPortalSessionResponse>;
+}>;

package/dist/_dts/api/src/blocks.d.ts

@@ -123,6 +123,7 @@ type MutateBlockArgs = ({
 } & {
     data: SaveBlockContentFullBody['data'];
     optimisticHash?: string | null;
+    expectedMailingListProviderScope?: SaveBlockContentFullBody['expected_mailing_list_provider_scope'];
     options?: RequestInit;
 }) | ({
     siteId: string;
@@ -131,6 +132,7 @@ type MutateBlockArgs = ({
     path: SaveBlockContentPatchBody['path'];
     value: SaveBlockContentPatchBody['value'];
     optimisticHash?: string | null;
+    expectedMailingListProviderScope?: SaveBlockContentPatchBody['expected_mailing_list_provider_scope'];
     options?: RequestInit;
 });
 export declare function mutateBlockContent(apiClient: ApiClient, args: MutateBlockArgs): Promise<SaveBlockContentResponse>;

package/dist/_dts/api/src/bookingRecords.d.ts

@@ -11,9 +11,9 @@ import type { EventTicketBreakdownLine } from './bookingOperations';
  * request/response shapes; booking services still own validation and normalization.
  */
 export type BookingEventSeriesAttendeeGuest = {
+    /** The guest's participant participation row: the canonical guest slot. */
     id: string;
     participantId?: string | null;
-    participantParticipationId?: string | null;
     participantCustomerId?: string | null;
     participantEmail?: string | null;
     participantUpdatedAt?: string | null;
@@ -556,7 +556,6 @@ export type ParticipantIdentityRectificationSourceSurface = 'event_registration_
 export type ParticipantIdentityRectificationSourceContext = {
     surface: ParticipantIdentityRectificationSourceSurface;
     eventAttendeeId?: string | null;
-    eventGuestId?: string | null;
     participantParticipationId?: string | null;
 };
 export type RectifyBookingParticipantIdentityRequest = {

package/dist/_dts/api/src/commercePortalEndpoints.d.ts

@@ -1,4 +1,4 @@
-import type { AppointmentBookingQuestionsTaskDetail, CustomerEventSeriesRegistration, CustomerEventRegistration, CustomerMembership, CustomerOrder, CustomerPass, EventGuest, MagicLinkRequest, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalCancelMembershipAtPeriodEndResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCreditResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalEventTicket, PortalWholeSeriesBookingQuestionsResponse, PortalEventBookingQuestionsResponse, PortalMeResponse, PortalMeUpdateRequest, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsResponse, PortalUpdateEventBookingQuestionsRequest, PortalUpdateEventBookingQuestionsResponse, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, UpdateEventGuestsRequest } from '../../blocks/src/api';
+import type { AppointmentBookingQuestionsTaskDetail, CustomerEventSeriesRegistration, CustomerEventRegistration, CustomerPortalWaitlistEntry, CustomerMembership, CustomerOrder, CustomerPass, EventGuest, MagicLinkRequest, PortalCancelWholeSeriesRegistrationRequest, PortalCancelWholeSeriesRegistrationResult, PortalCancelAppointmentRequest, PortalCancelAppointmentResult, PortalCancelEventRegistrationRequest, PortalCancelEventRegistrationResult, PortalCancelMembershipAtPeriodEndResult, PortalRescheduleAppointmentRequest, PortalRescheduleAppointmentResponse, PortalCreditResponse, PortalDigitalProductAccessResponse, PortalDigitalProductDownloadUrlResponse, PortalDigitalProductsResponse, PortalEventTicket, PortalWholeSeriesBookingQuestionsResponse, PortalEventBookingQuestionsResponse, PortalMeResponse, PortalMeUpdateRequest, PortalOrderCheckoutRequest, PortalOrderCheckoutResponse, PortalUpdateWholeSeriesBookingQuestionsRequest, PortalUpdateWholeSeriesBookingQuestionsResponse, PortalUpdateEventBookingQuestionsRequest, PortalUpdateEventBookingQuestionsResponse, PortalTransferEventRegistrationRequest, PortalTransferEventRegistrationResult, UpdateEventGuestsRequest } from '../../blocks/src/api';
 import type { APIEndpoint } from './apiEndpointTypes';
 import type { DeleteAccountRequest, DeleteAccountResponse } from './accessAdmin';
 import type { AiPlaygroundApplyRequest, AiPlaygroundApplyResponse } from './aiPlayground';
@@ -111,8 +111,15 @@ export type CommercePortalAPIEndpoints = {
         status?: 'confirmed' | 'waitlist' | 'cancelled';
         limit?: string;
         offset?: string;
+        waitlistEntryId?: string;
     }, {
         registrations: CustomerEventRegistration[];
+        waitlists: CustomerPortalWaitlistEntry[];
+    }>;
+    portalCancelWaitlistEntry: APIEndpoint<never, {
+        entryId: string;
+    }, {
+        outcome: 'cancelled';
     }>;
     portalGetAppointments: APIEndpoint<never, {
         upcoming?: string;

package/dist/_dts/api/src/communications.d.ts

@@ -106,7 +106,6 @@ export type GetNewsletterSettingsResponse = {
     settings: NewsletterSettingsRecord | null;
 };
 export type UpdateNewsletterSettingsRequest = Partial<{
-    doubleOptIn: boolean;
     trackOpens: boolean;
     trackClicks: boolean;
     fromName: string | null;