@riverbankcms/sdk 0.138.0 → 0.140.0

package/dist/_dts/commerce/src/purchase/orderItemMetadata.d.ts

@@ -1,16 +1,11 @@
+import { type StripeBookingCommissionOrderItemMetadata } from './stripeCommissionMetadata';
+export { parseStripeBookingCommissionMetadata, type StripeBookingCommissionOrderItemMetadata } from './stripeCommissionMetadata';
 import { type BrandedIdParseError, type CheckoutLineId, type RetiredCourseId, type CustomerId, type DatedOfferingCapacityHoldAuditRef, type DatedOfferingCapacityHoldId, type EventSeriesId, type EventInstanceId, type OccurrenceId, type PassId, type PricingOptionId, type Result } from '../../../core/src/index';
 import type { OrderItemKind } from './orderTypes';
 export type CheckoutLineMetadata = Readonly<{
     checkoutLineId?: CheckoutLineId;
     displayName?: string;
 }>;
-export type StripeBookingCommissionOrderItemMetadata = Readonly<{
-    stripeBookingCommission?: Readonly<{
-        kind: 'application_fee_amount';
-        amountCents: number;
-        percent: number;
-    }>;
-}>;
 export type SlidingScaleOrderItemPricingSnapshot = Readonly<{
     kind: 'sliding_scale';
     version: 1;
@@ -31,8 +26,17 @@ export declare const DATED_OFFERING_ORDER_ITEM_ENGINE_METADATA_KEYS: {
     readonly courseId: "courseId";
     readonly customerId: "customerId";
     readonly eventSeriesId: "eventSeriesId";
-    readonly nonCashProjectionIdempotencyKey: "datedOfferingNonCashProjectionIdempotencyKey";
+    readonly settlementKind: "datedOfferingEngineSettlementKind";
 };
+/**
+ * How a shared whole-series registration order item was settled.
+ *
+ * A checkout item is the one that consumed a capacity hold and carries its
+ * ids; a non-cash item names its settlement outright, because there is no hold
+ * to identify it by. The registration itself is `event_series_registration_id`
+ * on the row.
+ */
+export type DatedOfferingOrderItemSettlementKind = 'non_cash_registration';
 export type DatedOfferingOrderItemEngineMetadata = Readonly<{
     datedOfferingEngineContractVersion: 'shared_v1';
     datedOfferingEngineRouteKind: 'shared_whole_series_registration';
@@ -44,10 +48,24 @@ export type DatedOfferingOrderItemEngineMetadata = Readonly<{
 export type DatedOfferingNonCashOrderItemEngineMetadata = Readonly<{
     datedOfferingEngineContractVersion: 'shared_v1';
     datedOfferingEngineRouteKind: 'shared_whole_series_registration';
-    datedOfferingNonCashProjectionIdempotencyKey: string;
+    datedOfferingEngineSettlementKind: DatedOfferingOrderItemSettlementKind;
     customerId: CustomerId;
     eventSeriesId: EventSeriesId;
 }>;
+/**
+ * What each arm forbids the other from carrying.
+ *
+ * Both arms share the same version and route literals, so without these a
+ * hybrid carrying hold identity *and* a settlement kind satisfies the union —
+ * exactly the object both parsers below reject.
+ */
+type NoDatedOfferingSettlementKind = Readonly<{
+    datedOfferingEngineSettlementKind?: never;
+}>;
+type NoDatedOfferingCapacityHold = Readonly<{
+    datedOfferingCapacityHoldId?: never;
+    datedOfferingCapacityHoldAuditRef?: never;
+}>;
 export type DatedOfferingOrderItemEngineMetadataParseError = Readonly<{
     kind: 'invalid_engine_contract';
 }> | Readonly<{
@@ -71,11 +89,11 @@ export type DatedOfferingMetadataRefParseError = Readonly<{
     kind: 'invalid_uuid';
 }>;
 type LegacyDatedOfferingOrderItemEngineMetadata = Readonly<{
-    [TKey in keyof DatedOfferingOrderItemEngineMetadata]?: never;
+    [TKey in keyof DatedOfferingOrderItemEngineMetadata | keyof DatedOfferingNonCashOrderItemEngineMetadata]?: never;
 }>;
 export type EventSeriesRegistrationEngineMetadata = (LegacyDatedOfferingOrderItemEngineMetadata & Readonly<{
     courseId: RetiredCourseId;
-}>) | DatedOfferingOrderItemEngineMetadata | DatedOfferingNonCashOrderItemEngineMetadata;
+}>) | (DatedOfferingOrderItemEngineMetadata & NoDatedOfferingSettlementKind) | (DatedOfferingNonCashOrderItemEngineMetadata & NoDatedOfferingCapacityHold);
 export type EventTicketOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & BookableOrderItemPricingMetadata & Readonly<{
     eventSeriesId: string;
     occurrenceId: OccurrenceId;
@@ -87,7 +105,7 @@ export type EventTicketOrderItemMetadata = CheckoutLineMetadata & StripeBookingC
     attendeeEmail: string;
     attendeeName: string;
 }>;
-export type ProductOrderItemMetadata = CheckoutLineMetadata & Readonly<{
+export type ProductOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & Readonly<{
     productType?: 'physical' | 'digital';
     requiresShipping?: boolean;
 }>;
@@ -101,7 +119,7 @@ export type PassBundleFulfillmentMetadata = Readonly<{
 }>;
 export type CreditProductUseCase = 'event_pass' | 'appointment_package';
 export declare function normalizeOrderCreditProductUseCase(value: unknown): Result<CreditProductUseCase, string>;
-export type PassOrderItemMetadata = CheckoutLineMetadata & Readonly<{
+export type PassOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & Readonly<{
     passId: PassId;
     productUseCase?: CreditProductUseCase;
     creditsTotal: number;
@@ -131,7 +149,7 @@ export type MembershipBundleFulfillmentMetadata = Readonly<{
     attendeeName: string;
     membershipName: string;
 }>;
-export type MembershipOrderItemMetadata = CheckoutLineMetadata & Readonly<{
+export type MembershipOrderItemMetadata = CheckoutLineMetadata & StripeBookingCommissionOrderItemMetadata & Readonly<{
     bundleFulfillment?: MembershipBundleFulfillmentMetadata;
 }>;
 export type OrderItemMetadataByKind = {
@@ -143,7 +161,6 @@ export type OrderItemMetadataByKind = {
     membership: MembershipOrderItemMetadata;
 };
 export type OrderItemMetadata = OrderItemMetadataByKind[OrderItemKind];
-export declare function parseStripeBookingCommissionMetadata(raw: Record<string, unknown>): Result<StripeBookingCommissionOrderItemMetadata, string>;
 export declare function parseBookableOrderItemPricingMetadata(raw: Record<string, unknown>): Result<BookableOrderItemPricingMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'event_ticket', raw: unknown): Result<EventTicketOrderItemMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'product', raw: unknown): Result<ProductOrderItemMetadata, string>;
@@ -151,4 +168,3 @@ export declare function parseOrderItemMetadata(kind: 'pass', raw: unknown): Resu
 export declare function parseOrderItemMetadata(kind: 'event_series_registration', raw: unknown): Result<EventSeriesRegistrationOrderItemMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'appointment', raw: unknown): Result<AppointmentOrderItemMetadata, string>;
 export declare function parseOrderItemMetadata(kind: 'membership', raw: unknown): Result<MembershipOrderItemMetadata, string>;
-export {};

package/dist/_dts/commerce/src/purchase/stripeCommissionMetadata.d.ts

@@ -0,0 +1,34 @@
+import { type Result } from '../../../core/src/index';
+import { z } from 'zod';
+/** Reasons are payment evidence, not an independent pricing policy. */
+export declare const STRIPE_COMMISSION_FREE_REASONS: readonly ["managed_billing", "no_commission_plan", "billing_evidence_invalid", "fee_rounds_to_zero", "non_commissionable_scope", "payment_not_stripe"];
+export type StripeCommissionFreeReason = (typeof STRIPE_COMMISSION_FREE_REASONS)[number];
+declare const commissionEvidenceSchema: z.ZodDiscriminatedUnion<[z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    sourcePlanId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"commission_free">;
+    reason: z.ZodEnum<{
+        managed_billing: "managed_billing";
+        no_commission_plan: "no_commission_plan";
+        billing_evidence_invalid: "billing_evidence_invalid";
+        fee_rounds_to_zero: "fee_rounds_to_zero";
+        non_commissionable_scope: "non_commissionable_scope";
+        payment_not_stripe: "payment_not_stripe";
+    }>;
+}, z.core.$strip>, z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    sourcePlanId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"application_fee_amount">;
+    amountCents: z.ZodNumber;
+    percent: z.ZodNumber;
+}, z.core.$strip>, z.ZodObject<{
+    currency: z.ZodOptional<z.ZodString>;
+    sourcePlanId: z.ZodOptional<z.ZodString>;
+    kind: z.ZodLiteral<"application_fee_percent">;
+    percent: z.ZodNumber;
+}, z.core.$strip>], "kind">;
+export type StripeBookingCommissionOrderItemMetadata = Readonly<{
+    stripeBookingCommission?: z.infer<typeof commissionEvidenceSchema>;
+}>;
+export declare function parseStripeBookingCommissionMetadata(raw: Record<string, unknown>): Result<StripeBookingCommissionOrderItemMetadata, string>;
+export {};

package/dist/_dts/content-editor/src/controller/EntryControllerProvider.d.ts

@@ -1,5 +1,5 @@
 import { type ContentEntrySnapshot, type ContentTypeSchema, type ToolbarState } from '../../../content-model/src/index';
-import type { EditorBlockId } from '../../../core/src/index';
+import type { EditorBlockId, MailingListProviderScope } from '../../../core/src/index';
 import type { BlockItem } from '../../../editor-blocks/src/block-editor/types';
 import { type ReactNode } from 'react';
 import { type PublishOptions } from '../hooks/useEntryActions';
@@ -90,6 +90,7 @@ type BaseInternalProps = {
     onEntryUpdated?: (response: unknown) => void;
     historyShortcutsEnabled?: boolean;
     resolveBlockManifest?: ResolveBlockManifest;
+    getExpectedMailingListProviderScope?: () => MailingListProviderScope | null;
 };
 type EditorOwnerServiceProps = Readonly<{
     owner: {

package/dist/_dts/content-editor/src/footerEngagementDraft.d.ts

@@ -1,26 +1,15 @@
-import { type FooterEngagementSection, type Result } from '../../core/src/index';
+import { type FooterEngagementSection, type MailingListPlacementTargeting, type Result } from '../../core/src/index';
 type FooterEngagementDraftBase = Readonly<{
     treatment: FooterEngagementSection['treatment'];
     heading: string;
     intro: string;
 }>;
-type FooterMailingCopyDraft = Readonly<{
-    buttonLabel: string;
-    successMessage: string;
-    privacyNote: string;
-}>;
 export type FooterEngagementDraft = (FooterEngagementDraftBase & Readonly<{
     kind: 'standard-contact';
     formId: string;
-}>) | (FooterEngagementDraftBase & FooterMailingCopyDraft & Readonly<{
+}>) | (FooterEngagementDraftBase & Readonly<{
     kind: 'mailing-list';
-    destination: Readonly<{
-        provider: 'riverbank';
-        listId: string;
-    }> | Readonly<{
-        provider: 'mailchimp';
-        audienceId: string;
-    }>;
+    targeting: MailingListPlacementTargeting;
 }>);
 export type FooterEngagementDraftEvent = Readonly<{
     type: 'select-kind';
@@ -38,20 +27,13 @@ export type FooterEngagementDraftEvent = Readonly<{
     type: 'set-form';
     formId: string;
 }> | Readonly<{
-    type: 'select-mailing-provider';
-    provider: 'riverbank' | 'mailchimp';
-}> | Readonly<{
-    type: 'set-mailing-destination';
-    id: string;
-}> | Readonly<{
-    type: 'set-mailing-copy';
-    field: keyof FooterMailingCopyDraft;
-    value: string;
+    type: 'set-mailing-targeting';
+    targeting: MailingListPlacementTargeting;
 }>;
 export declare function reduceFooterEngagementDraft(draft: FooterEngagementDraft, event: FooterEngagementDraftEvent): FooterEngagementDraft;
 export declare function createFooterEngagementDraft(section: FooterEngagementSection | null): FooterEngagementDraft;
 type DraftParseError = Readonly<{
     message: string;
 }>;
-export declare function parseFooterEngagementDraft(draft: FooterEngagementDraft, currentId: string, mailchimpConnectionId: string): Result<FooterEngagementSection, DraftParseError>;
+export declare function parseFooterEngagementDraft(draft: FooterEngagementDraft, currentId: string): Result<FooterEngagementSection, DraftParseError>;
 export {};

package/dist/_dts/content-editor/src/hooks/useBlockAutosave.d.ts

@@ -1,3 +1,4 @@
+import { type MailingListProviderScope } from '../../../core/src/index';
 import type { ApiClient } from '../services';
 import type { EditorUiStoreInstance } from '../ui/editorUiStore';
 export type BlockAutosaveOptions = {
@@ -10,6 +11,7 @@ export type BlockAutosaveOptions = {
     /** Whether this entry has a route (pages have blocks, content entries don't) */
     hasRoute: boolean;
     owner: BlockAutosaveOwner;
+    getExpectedMailingListProviderScope?: () => MailingListProviderScope | null;
 };
 export type BlockAutosaveOwner = Readonly<{
     kind: 'contentEntry';
@@ -32,4 +34,4 @@ export declare function planBlockSaveRevisionForOwner(owner: BlockAutosaveOwner,
  *
  * Only enabled for pages (hasRoute=true), as content entries don't have blocks.
  */
-export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, owner, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;
+export declare function useBlockAutosave({ uiStore, apiClient, siteId, hasRoute, owner, getExpectedMailingListProviderScope, }: BlockAutosaveOptions): import("./useSimpleAutosave").AutosaveHandle;

package/dist/_dts/content-editor/src/useFooterComposerState.d.ts

@@ -32,8 +32,10 @@ export declare function useFooterComposerState({ apiClient, canEdit, initialTarg
     compositionSnapshot: FooterCompositionSnapshot | null;
     engagementOptions: Readonly<{
         forms: readonly import("../../api/src/footerSettings").FooterFormSummary[];
-        newsletterLists: readonly import("../../api/src/index").NewsletterListRecord[];
-        mailchimp: import("../../api/src/index").ListMailchimpAudiencesResponse;
+        mailingList: import("../../core/src/index").MailingListRuntimeContext;
+        expectedMailingListProviderScope: import("../../core/src/index").MailingListProviderScope | null;
+        confirmation: import("../../core/src/index").ConfiguredMailingListProvider["confirmation"] | null;
+        canManageMailingListSetup: boolean;
     }> | null;
     load: () => Promise<void>;
     loadError: string | null;

package/dist/_dts/core/src/branded.d.ts

@@ -60,7 +60,6 @@ export type BookingSessionId = Brand<string, 'BookingSessionId'>;
 export type DatedOfferingCapacityHoldId = Brand<string, 'DatedOfferingCapacityHoldId'>;
 export type DatedOfferingCapacityHoldAuditRef = Brand<string, 'DatedOfferingCapacityHoldAuditRef'>;
 export type DatedOfferingRevocationAuditEventId = Brand<string, 'DatedOfferingRevocationAuditEventId'>;
-export type DatedOfferingNonCashProjectionClaimToken = Brand<string, 'DatedOfferingNonCashProjectionClaimToken'>;
 export type DatedOfferingWaitlistCapacityEffectId = Brand<string, 'DatedOfferingWaitlistCapacityEffectId'>;
 export type DatedOfferingWaitlistCapacityEffectClaimToken = Brand<string, 'DatedOfferingWaitlistCapacityEffectClaimToken'>;
 export type DatedOfferingRunCancellationOperationId = Brand<string, 'DatedOfferingRunCancellationOperationId'>;
@@ -99,7 +98,6 @@ export type EventRegistrationCommandId = Brand<string, 'EventRegistrationCommand
  * is meant.
  */
 export type EventRegistrationCommandRowId = Brand<string, 'EventRegistrationCommandRowId'>;
-export type EventRegistrationProjectionClaimToken = Brand<string, 'EventRegistrationProjectionClaimToken'>;
 export type CustomerPassId = Brand<string, 'CustomerPassId'>;
 export type CustomerMembershipId = Brand<string, 'CustomerMembershipId'>;
 export type AppointmentId = Brand<string, 'AppointmentId'>;
@@ -146,7 +144,6 @@ export type ParticipantId = Brand<string, 'ParticipantId'>;
 export type ParticipantParticipationId = Brand<string, 'ParticipantParticipationId'>;
 export type ParticipantRosterAssertionJobId = Brand<string, 'ParticipantRosterAssertionJobId'>;
 export type ParticipantBookingQuestionsTaskId = Brand<string, 'ParticipantBookingQuestionsTaskId'>;
-export type EventAttendeeGuestId = Brand<string, 'EventAttendeeGuestId'>;
 export type PersonRecordId = Brand<string, 'PersonRecordId'>;
 export type EncounterRecordId = Brand<string, 'EncounterRecordId'>;
 export type RecordEntryId = Brand<string, 'RecordEntryId'>;
@@ -212,7 +209,6 @@ export declare const unsafeAsBookingSessionId: (id: string) => BookingSessionId;
 export declare const unsafeAsDatedOfferingCapacityHoldId: (value: string) => DatedOfferingCapacityHoldId;
 export declare const unsafeAsDatedOfferingCapacityHoldAuditRef: (value: string) => DatedOfferingCapacityHoldAuditRef;
 export declare const unsafeAsDatedOfferingRevocationAuditEventId: (value: string) => DatedOfferingRevocationAuditEventId;
-export declare const unsafeAsDatedOfferingNonCashProjectionClaimToken: (value: string) => DatedOfferingNonCashProjectionClaimToken;
 export declare const unsafeAsDatedOfferingWaitlistCapacityEffectId: (value: string) => DatedOfferingWaitlistCapacityEffectId;
 export declare const unsafeAsDatedOfferingWaitlistCapacityEffectClaimToken: (value: string) => DatedOfferingWaitlistCapacityEffectClaimToken;
 export declare const unsafeAsDatedOfferingRunCancellationOperationId: (value: string) => DatedOfferingRunCancellationOperationId;
@@ -236,7 +232,6 @@ export declare const unsafeAsCheckoutLineId: (id: string) => CheckoutLineId;
 export declare const unsafeAsAttendeeId: (id: string) => AttendeeId;
 export declare const unsafeAsEventRegistrationCommandId: (id: string) => EventRegistrationCommandId;
 export declare const unsafeAsEventRegistrationCommandRowId: (id: string) => EventRegistrationCommandRowId;
-export declare const unsafeAsEventRegistrationProjectionClaimToken: (id: string) => EventRegistrationProjectionClaimToken;
 export declare const unsafeAsCustomerPassId: (id: string) => CustomerPassId;
 export declare const unsafeAsCustomerMembershipId: (id: string) => CustomerMembershipId;
 export declare const unsafeAsAppointmentId: (id: string) => AppointmentId;
@@ -282,7 +277,6 @@ export declare const unsafeAsParticipantId: (id: string) => ParticipantId;
 export declare const unsafeAsParticipantParticipationId: (id: string) => ParticipantParticipationId;
 export declare const unsafeAsParticipantRosterAssertionJobId: (id: string) => ParticipantRosterAssertionJobId;
 export declare const unsafeAsParticipantBookingQuestionsTaskId: (id: string) => ParticipantBookingQuestionsTaskId;
-export declare const unsafeAsEventAttendeeGuestId: (id: string) => EventAttendeeGuestId;
 export declare const unsafeAsPersonRecordId: (id: string) => PersonRecordId;
 export declare const unsafeAsEncounterRecordId: (id: string) => EncounterRecordId;
 export declare const unsafeAsRecordEntryId: (id: string) => RecordEntryId;
@@ -318,11 +312,9 @@ export declare const parseAppointmentReservationRunId: (value: unknown) => Resul
 export declare const parseAttendeeId: (value: unknown) => Result<AttendeeId, BrandedIdParseError>;
 export declare const parseEventRegistrationCommandId: (value: unknown) => Result<EventRegistrationCommandId, BrandedIdParseError>;
 export declare const parseEventRegistrationCommandRowId: (value: unknown) => Result<EventRegistrationCommandRowId, BrandedIdParseError>;
-export declare const parseEventRegistrationProjectionClaimToken: (value: unknown) => Result<EventRegistrationProjectionClaimToken, BrandedIdParseError>;
 export declare const parseDatedOfferingCapacityHoldId: (value: unknown) => Result<DatedOfferingCapacityHoldId, BrandedIdParseError>;
 export declare const parseDatedOfferingCapacityHoldAuditRef: (value: unknown) => Result<DatedOfferingCapacityHoldAuditRef, BrandedIdParseError>;
 export declare const parseDatedOfferingRevocationAuditEventId: (value: unknown) => Result<DatedOfferingRevocationAuditEventId, BrandedIdParseError>;
-export declare const parseDatedOfferingNonCashProjectionClaimToken: (value: unknown) => Result<DatedOfferingNonCashProjectionClaimToken, BrandedIdParseError>;
 export declare const parseDatedOfferingWaitlistCapacityEffectId: (value: unknown) => Result<DatedOfferingWaitlistCapacityEffectId, BrandedIdParseError>;
 export declare const parseDatedOfferingWaitlistCapacityEffectClaimToken: (value: unknown) => Result<DatedOfferingWaitlistCapacityEffectClaimToken, BrandedIdParseError>;
 export declare const parseDatedOfferingRunCancellationOperationId: (value: unknown) => Result<DatedOfferingRunCancellationOperationId, BrandedIdParseError>;

package/dist/_dts/core/src/footer-engagement.d.ts

@@ -1,5 +1,5 @@
 import { type FormId } from './branded';
-import { type NewsletterSignupAuthoringDestination } from './newsletter-signup-destination';
+import type { MailingListPlacementTargeting } from './mailing-list-targeting';
 import { type Result } from './result';
 import type { FooterCompositionError, FooterModuleId } from './footer-composition-types';
 export type FooterEngagementTreatment = 'integrated' | 'separate-row';
@@ -9,12 +9,8 @@ export type FooterEngagementSource = Readonly<{
     intro: string | null;
 }> | Readonly<{
     kind: 'mailing-list';
-    destination: NewsletterSignupAuthoringDestination;
+    targeting: MailingListPlacementTargeting;
     intro: string | null;
-    buttonLabel: string;
-    successMessage: string;
-    privacyNote: string | null;
-    fieldPreset: 'emailOnly';
 }>;
 export type FooterEngagementSection = Readonly<{
     id: FooterModuleId;

package/dist/_dts/core/src/index.d.ts

@@ -35,13 +35,20 @@ export * from './participants';
 export * from './participant-identity';
 export * from './public-url-validation';
 export * from './public-profile';
+export * from './public-experience';
 export * from './rich-text';
 export * from './footer-composition';
 export * from './footer-navigation-layout';
 export * from './footer-arrangement';
 export * from './footer-composition-types';
 export * from './footer-engagement';
-export * from './newsletter-signup-destination';
+export * from './mailing-list-identifiers';
+export * from './mailing-list-setup';
+export * from './mailing-list-setup-parser';
+export * from './mailing-list-targeting';
+export * from './mailing-list-runtime';
+export * from './mailing-list-targeting-parser';
+export * from './mailing-list-submission';
 export * from './number-input';
 export * from './field-errors';
 export * from './form-submission-preview';
@@ -63,5 +70,7 @@ export { disabledSelection, enabledSelection, plannerNoChange, plannerPatch, pla
 export type { DisabledSelection, EnabledSelection, OptionalSelection, PlannerNoChange, PlannerPatch, PlannerUpdate, PlanningClock, PlanningDateInput, PlanningTimeOptions, } from './planner';
 export { isValidBookingTimeZone, parseBookingTimeZone, type BookingTimeZone, type BookingTimeZoneParseError, } from './booking-time-zone';
 export { CANCELLED_SESSION_STATUS, firstLiveRunSessionStartMs, isWholeSeriesRegistrationOpen, orderedLiveRunSessions, resolveWholeSeriesBookingPhase, resolveWholeSeriesRunLifecycle, type WholeSeriesBookingPhase, type WholeSeriesRunLifecycle, type WholeSeriesScheduleSession, } from './whole-series-run-schedule';
+export * from './public-read-cache-contract';
 export * from './booking-verticals';
 export * from './event-series-behaviour';
+export * from './navigation-locations';

package/dist/_dts/core/src/mailing-list-identifiers.d.ts

@@ -0,0 +1,21 @@
+import type { Brand } from './branded';
+export type NewsletterListId = Brand<string, 'NewsletterListId'>;
+export type MailchimpConnectionId = Brand<string, 'MailchimpConnectionId'>;
+export type MailchimpAccountId = Brand<string, 'MailchimpAccountId'>;
+export type MailchimpAudienceId = Brand<string, 'MailchimpAudienceId'>;
+export type MailchimpInterestId = Brand<string, 'MailchimpInterestId'>;
+export type MailchimpTagName = Brand<string, 'MailchimpTagName'>;
+export type BrevoConnectionId = Brand<string, 'BrevoConnectionId'>;
+export type BrevoAccountId = Brand<string, 'BrevoAccountId'>;
+export type BrevoListId = Brand<number, 'BrevoListId'>;
+export type BrevoConfirmationTemplateId = Brand<number, 'BrevoConfirmationTemplateId'>;
+export declare function parseNewsletterListId(value: unknown): NewsletterListId | null;
+export declare function parseMailchimpConnectionId(value: unknown): MailchimpConnectionId | null;
+export declare function parseMailchimpAccountId(value: unknown): MailchimpAccountId | null;
+export declare function parseMailchimpAudienceId(value: unknown): MailchimpAudienceId | null;
+export declare function parseMailchimpInterestId(value: unknown): MailchimpInterestId | null;
+export declare function parseMailchimpTagName(value: unknown): MailchimpTagName | null;
+export declare function parseBrevoConnectionId(value: unknown): BrevoConnectionId | null;
+export declare function parseBrevoAccountId(value: unknown): BrevoAccountId | null;
+export declare function parseBrevoListId(value: unknown): BrevoListId | null;
+export declare function parseBrevoConfirmationTemplateId(value: unknown): BrevoConfirmationTemplateId | null;

package/dist/_dts/core/src/mailing-list-runtime.d.ts

@@ -0,0 +1,42 @@
+import type { BrevoListId, MailchimpAudienceId, MailchimpInterestId } from './mailing-list-identifiers';
+import { type Result } from './result';
+import type { MailingListGlobalForm, MailingListSetupRevision, NativeMailingListTopicId } from './mailing-list-setup';
+export type MailingListRuntimeContext = Readonly<{
+    tag: 'not_configured';
+}> | Readonly<{
+    tag: 'configured';
+    revision: MailingListSetupRevision;
+    form: MailingListGlobalForm;
+    provider: MailingListRuntimeProvider;
+}>;
+export type MailingListRuntimeProvider = Readonly<{
+    provider: 'native';
+    defaultTopicId: NativeMailingListTopicId;
+    topics: readonly Readonly<{
+        id: NativeMailingListTopicId;
+        name: string;
+    }>[];
+}> | Readonly<{
+    provider: 'brevo';
+    defaultListId: BrevoListId;
+    lists: readonly Readonly<{
+        id: BrevoListId;
+        name: string;
+    }>[];
+}> | Readonly<{
+    provider: 'mailchimp';
+    defaultAudienceId: MailchimpAudienceId;
+    audiences: readonly Readonly<{
+        id: MailchimpAudienceId;
+        name: string;
+        interests: readonly Readonly<{
+            id: MailchimpInterestId;
+            name: string;
+            categoryName: string;
+        }>[];
+    }>[];
+}>;
+export type MailingListRuntimeContextParseError = Readonly<{
+    tag: 'invalid_mailing_list_runtime_context';
+}>;
+export declare function parseMailingListRuntimeContext(value: unknown): Result<MailingListRuntimeContext, MailingListRuntimeContextParseError>;

package/dist/_dts/core/src/mailing-list-setup-parser.d.ts

@@ -0,0 +1,14 @@
+import type { ConfiguredMailingListProvider, MailingListGlobalForm, MailingListSetupRevision, MailingListSiteSetup } from './mailing-list-setup';
+import { type Result } from './result';
+export type MailingListSetupParseError = Readonly<{
+    tag: 'invalid_mailing_list_setup';
+    field: 'shape' | 'tag' | 'siteId' | 'revision' | 'form' | 'provider' | 'connectionId' | 'accountId' | 'defaultTargetId' | 'confirmation';
+}>;
+export type MailingListGlobalFormParseError = Readonly<{
+    tag: 'invalid_mailing_list_global_form';
+    field: 'shape' | 'fields' | 'includeOptionalPhone' | 'buttonLabel' | 'successMessage' | 'privacyNote';
+}>;
+export declare function parseMailingListGlobalForm(value: unknown): Result<MailingListGlobalForm, MailingListGlobalFormParseError>;
+export declare function parseMailingListSiteSetup(value: unknown): Result<MailingListSiteSetup, MailingListSetupParseError>;
+export declare function parseConfiguredMailingListProvider(value: unknown): Result<ConfiguredMailingListProvider, MailingListSetupParseError>;
+export declare function parseMailingListSetupRevision(value: unknown): MailingListSetupRevision | null;

package/dist/_dts/core/src/mailing-list-setup.d.ts

@@ -0,0 +1,142 @@
+import type { Brand, SiteId } from './branded';
+import { type BrevoAccountId, type BrevoConfirmationTemplateId, type BrevoConnectionId, type BrevoListId, type MailchimpAccountId, type MailchimpAudienceId, type MailchimpConnectionId, type NewsletterListId } from './mailing-list-identifiers';
+import { type Result } from './result';
+export type MailingListProvider = 'native' | 'mailchimp' | 'brevo';
+/** The name shown to people for each provider; the native one is the product brand. */
+export declare function mailingListProviderName(provider: MailingListProvider): string;
+export type NativeMailingListTopicId = NewsletterListId;
+export type MailingListSetupRevision = Brand<number, 'MailingListSetupRevision'>;
+export type MailingListProfileField = 'name' | 'first_name' | 'last_name' | 'company' | 'phone';
+export type MailingListGlobalFields = Readonly<{
+    preset: 'emailOnly';
+}> | Readonly<{
+    preset: 'emailName';
+    name: 'required' | 'optional';
+}> | Readonly<{
+    preset: 'emailFirstLast';
+    firstName: 'required' | 'optional';
+    lastName: 'required' | 'optional';
+}> | Readonly<{
+    preset: 'emailNameCompany';
+    name: 'required' | 'optional';
+    company: 'required' | 'optional';
+}>;
+export type MailingListGlobalForm = Readonly<{
+    fields: MailingListGlobalFields;
+    includeOptionalPhone: boolean;
+    buttonLabel: string;
+    successMessage: string;
+    privacyNote: string | null;
+}>;
+export declare const DEFAULT_MAILING_LIST_SUCCESS_MESSAGE = "Thanks \u2014 you're on the list.";
+/**
+ * Seeded into a new setup so every signup form carries a preferences/unsubscribe
+ * reassurance out of the box. Administrators can edit or clear it.
+ */
+export declare const DEFAULT_MAILING_LIST_PRIVACY_NOTE = "Change your preferences or unsubscribe at any time.";
+export type ToggleConfirmation = Readonly<{
+    tag: 'off';
+}> | Readonly<{
+    tag: 'on';
+}>;
+export type BrevoConfirmation = Readonly<{
+    tag: 'off';
+}> | Readonly<{
+    tag: 'on';
+    templateId: BrevoConfirmationTemplateId;
+    redirectUrl: string;
+}>;
+export type NativeMailingListSetup = Readonly<{
+    provider: 'native';
+    defaultTopicId: NativeMailingListTopicId;
+    confirmation: ToggleConfirmation;
+}>;
+export type MailchimpMailingListSetup = Readonly<{
+    provider: 'mailchimp';
+    connectionId: MailchimpConnectionId;
+    accountId: MailchimpAccountId;
+    defaultAudienceId: MailchimpAudienceId;
+    confirmation: ToggleConfirmation;
+}>;
+export type BrevoMailingListSetup = Readonly<{
+    provider: 'brevo';
+    connectionId: BrevoConnectionId;
+    accountId: BrevoAccountId;
+    defaultListId: BrevoListId;
+    confirmation: BrevoConfirmation;
+}>;
+export type ConfiguredMailingListProvider = NativeMailingListSetup | MailchimpMailingListSetup | BrevoMailingListSetup;
+export type MailingListSiteSetup = Readonly<{
+    tag: 'not_configured';
+    siteId: SiteId;
+}> | Readonly<{
+    tag: 'configured';
+    siteId: SiteId;
+    revision: MailingListSetupRevision;
+    form: MailingListGlobalForm;
+    provider: ConfiguredMailingListProvider;
+}>;
+export type MailingListDestinationFieldRequirements = Readonly<{
+    destinationKey: string;
+    requiredFields: readonly MailingListProfileField[];
+    acceptedFields: readonly MailingListProfileField[];
+}>;
+export type MailingListFieldCompatibilityIssue = Readonly<{
+    tag: 'destination_requires_uncollected_field';
+    destinationKey: string;
+    field: MailingListProfileField;
+}> | Readonly<{
+    tag: 'destination_requires_site_required_field';
+    destinationKey: string;
+    field: MailingListProfileField;
+}> | Readonly<{
+    tag: 'destination_rejects_required_site_field';
+    destinationKey: string;
+    field: MailingListProfileField;
+}> | Readonly<{
+    tag: 'destination_rejects_collected_site_field';
+    destinationKey: string;
+    field: MailingListProfileField;
+}>;
+export type MailingListFieldCompatibilityPlan = Readonly<{
+    tag: 'compatible';
+}> | Readonly<{
+    tag: 'blocked';
+    issues: readonly [
+        MailingListFieldCompatibilityIssue,
+        ...MailingListFieldCompatibilityIssue[]
+    ];
+}>;
+export declare function planMailingListFieldCompatibility(input: Readonly<{
+    form: MailingListGlobalForm;
+    destinations: readonly MailingListDestinationFieldRequirements[];
+}>): MailingListFieldCompatibilityPlan;
+export type MailingListSetupSwitchPlan = Readonly<{
+    tag: 'activate';
+    affectedPlacementCount: 0;
+}> | Readonly<{
+    tag: 'update_same_scope';
+    affectedPlacementCount: number;
+}> | Readonly<{
+    tag: 'replace_scope';
+    affectedPlacementCount: number;
+}>;
+export declare function planMailingListSetupSwitch(input: Readonly<{
+    previousScope: MailingListProviderScope | null;
+    nextScope: MailingListProviderScope;
+    placementModes: readonly ('default' | 'custom')[];
+    defaultChanged: boolean;
+}>): MailingListSetupSwitchPlan;
+export type MailingListProviderScope = Readonly<{
+    provider: 'native';
+}> | Readonly<{
+    provider: 'mailchimp';
+    accountId: MailchimpAccountId;
+}> | Readonly<{
+    provider: 'brevo';
+    accountId: BrevoAccountId;
+}>;
+export declare function mailingListProviderScopeFromConfigured(provider: ConfiguredMailingListProvider): MailingListProviderScope;
+export declare function parseMailingListProviderScope(value: unknown): Result<MailingListProviderScope, 'invalid_mailing_list_provider_scope'>;
+export declare function sameMailingListProviderScope(previous: MailingListProviderScope, next: MailingListProviderScope): boolean;
+export declare function countDefaultMailingListPlacements(placementModes: readonly ('default' | 'custom')[]): number;