@riverbankcms/sdk 0.151.0 → 0.152.0

package/dist/_dts/core/src/demo-claim-readiness.d.ts

@@ -0,0 +1,18 @@
+import type { DemoClaimId, DemoBlueprintVersionId, SiteId } from './branded';
+export type DemoClaimReadiness = Readonly<{
+    status: 'preparing';
+    claimId: DemoClaimId;
+    blueprintVersionId: DemoBlueprintVersionId;
+}> | Readonly<{
+    status: 'ready';
+    claimId: DemoClaimId;
+    blueprintVersionId: DemoBlueprintVersionId;
+    siteId: SiteId;
+    expiresAt: string;
+}> | Readonly<{
+    status: 'ended';
+    claimId: DemoClaimId;
+}> | Readonly<{
+    status: 'setup_failed';
+    claimId: DemoClaimId;
+}>;

package/dist/_dts/core/src/demo-lifecycle-status.d.ts

@@ -2,7 +2,7 @@ export declare const demoBlueprintStatusValues: readonly ["draft", "published",
 export type DemoBlueprintStatus = (typeof demoBlueprintStatusValues)[number];
 export declare const demoInstanceStatusValues: readonly ["warming", "available", "claimed", "expired", "showcase", "failed"];
 export type DemoInstanceStatus = (typeof demoInstanceStatusValues)[number];
-export declare const demoClaimStatusValues: readonly ["active", "expired", "released"];
+export declare const demoClaimStatusValues: readonly ["preparing", "active", "expired", "released"];
 export type DemoClaimStatus = (typeof demoClaimStatusValues)[number];
 export declare const demoBlueprintArtifactKindValues: readonly ["recipe"];
 export type DemoBlueprintArtifactKind = (typeof demoBlueprintArtifactKindValues)[number];

package/dist/_dts/core/src/demo-warm-pool-target.d.ts

@@ -1,5 +1,5 @@
 import { type Result } from './result';
-export declare const DEFAULT_DEMO_WARM_POOL_TARGET = 0;
+export declare const DEFAULT_DEMO_WARM_POOL_TARGET = 1;
 export declare const MAX_DEMO_WARM_POOL_TARGET = 20;
 export type DemoWarmPoolTargetError = Readonly<{
     kind: 'invalid_demo_warm_pool_target';

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

@@ -15,12 +15,14 @@ export * from './event-page-surface-subject';
 export * from './event-page-selection';
 export * from './public-event-booking-availability';
 export * from './money-input';
+export * from './ticket-quantity';
 export * from './booking-flexible-balance';
 export * from './booking-refunds';
 export * from './booking-instalments';
 export * from './booking-instalment-deposit';
 export * from './booking-live-payment-terms';
 export * from './booking-payment-options';
+export * from './appointment-booking-terms';
 export * from './booking-date-time';
 export * from './booking-consent';
 export * from './appointment-service-categories';
@@ -54,6 +56,7 @@ 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-targeting-availability';
 export * from './mailing-list-runtime';
 export * from './mailing-list-targeting-parser';
 export * from './mailing-list-submission';
@@ -86,3 +89,4 @@ export * from './navigation-portal-labels';
 export * from './event-preset-vocabulary';
 export * from './event-catalogue';
 export * from './patch';
+export * from './demo-claim-readiness';

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

@@ -0,0 +1,68 @@
+import type { MailingListRuntimeContext, MailingListRuntimeProvider } from './mailing-list-runtime';
+import { type MailingListDefaultTargeting, type MailingListPlacementTargeting } from './mailing-list-targeting';
+type CustomTargeting = Exclude<MailingListPlacementTargeting, {
+    mode: 'default';
+}>;
+type Catalog<P extends MailingListRuntimeProvider['provider']> = Extract<MailingListRuntimeProvider, {
+    provider: P;
+}>;
+type Targeting<P extends CustomTargeting['provider']> = Extract<CustomTargeting, {
+    provider: P;
+}>;
+type Choice = Readonly<{
+    id: string | number;
+    name: string;
+}>;
+type MailchimpAudience = Catalog<'mailchimp'>['audiences'][number];
+/** Provider and placement stay correlated after the assessment has matched them. */
+export type MailingListMatchedTargeting = Readonly<{
+    provider: 'native';
+    catalog: Catalog<'native'>;
+    targeting: Targeting<'native'>;
+}> | Readonly<{
+    provider: 'brevo';
+    catalog: Catalog<'brevo'>;
+    targeting: Targeting<'brevo'>;
+}> | Readonly<{
+    provider: 'mailchimp';
+    catalog: Catalog<'mailchimp'>;
+    targeting: Targeting<'mailchimp'>;
+    audience: MailchimpAudience;
+}>;
+export type MailingListResolvedCustomTargeting = MailingListMatchedTargeting & Readonly<{
+    mode: 'custom';
+    choices: readonly Choice[];
+    selectedChoices: readonly Choice[];
+}>;
+export type MailingListResolvedTargeting = MailingListResolvedCustomTargeting | Readonly<{
+    mode: 'default';
+    provider: MailingListRuntimeProvider['provider'];
+    targeting: MailingListDefaultTargeting;
+    destination: Choice;
+}>;
+export type MailingListMissingAudienceTargeting = Readonly<{
+    mode: 'custom';
+    provider: 'mailchimp';
+    catalog: Catalog<'mailchimp'>;
+    targeting: Targeting<'mailchimp'>;
+}>;
+export type MailingListTargetingAvailability = Readonly<{
+    tag: 'available';
+    value: MailingListResolvedTargeting;
+}> | Readonly<{
+    tag: 'unavailable';
+    reason: 'setup_missing' | 'provider_mismatch' | 'default_missing';
+    targeting: MailingListPlacementTargeting;
+}> | Readonly<{
+    tag: 'unavailable';
+    reason: 'audience_missing';
+    value: MailingListMissingAudienceTargeting;
+}> | Readonly<{
+    tag: 'unavailable';
+    reason: 'choices_missing';
+    missingIds: readonly (string | number)[];
+    value: MailingListResolvedCustomTargeting;
+}>;
+export declare function resolveMailingListDefaultDestination(provider: MailingListRuntimeProvider): Choice | null;
+export declare function assessMailingListTargeting(context: MailingListRuntimeContext | undefined, targeting: MailingListPlacementTargeting): MailingListTargetingAvailability;
+export {};

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

@@ -5,6 +5,7 @@ import { type Result } from './result';
 export type MailingListDefaultTargeting = Readonly<{
     mode: 'default';
 }>;
+export declare const DEFAULT_MAILING_LIST_TARGETING: MailingListDefaultTargeting;
 export type NativeMailingListCustomTargeting = Readonly<{
     mode: 'custom';
     provider: 'native';
@@ -41,6 +42,7 @@ export type MailchimpMailingListCustomTargeting = Readonly<{
 }>;
 export type MailingListPlacementTargeting = MailingListDefaultTargeting | NativeMailingListCustomTargeting | BrevoMailingListCustomTargeting | MailchimpMailingListCustomTargeting;
 export declare function sameMailingListPlacementTargeting(left: MailingListPlacementTargeting, right: MailingListPlacementTargeting): boolean;
+export declare function mailingListTargetingChoiceIds(targeting: Exclude<MailingListPlacementTargeting, MailingListDefaultTargeting>): readonly (string | number)[];
 export type MailingListVisitorSelection = Readonly<{
     provider: 'native';
     topicIds: readonly NativeMailingListTopicId[];

package/dist/_dts/core/src/ticket-quantity.d.ts

@@ -0,0 +1,13 @@
+import type { Brand } from './branded';
+import { type Result } from './result';
+/** A whole number of booked places, at least one. */
+export type PositiveTicketQuantity = Brand<number, 'PositiveTicketQuantity'>;
+export declare function toPositiveTicketQuantity(value: number): Result<PositiveTicketQuantity, 'invalid_quantity'>;
+/**
+ * The places a booking holds: the sum of its ticket lines' quantities. The one
+ * derivation for selections, persisted lines and a booking outcome's lines;
+ * null when the total is not a positive whole number.
+ */
+export declare function deriveTotalTicketQuantity(lines: readonly Readonly<{
+    quantity: number;
+}>[]): PositiveTicketQuantity | null;

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -5911,51 +5911,61 @@ export type Database = {
             };
             demo_claims: {
                 Row: {
+                    blueprint_version_id: string | null;
                     claimant_email: string;
                     claimant_user_id: string | null;
-                    claimed_at: string;
+                    claimed_at: string | null;
                     created_at: string;
-                    expires_at: string;
+                    expires_at: string | null;
                     id: string;
-                    instance_id: string;
+                    instance_id: string | null;
                     metadata: Json;
                     release_reason: string | null;
                     released_at: string | null;
-                    site_id: string;
+                    site_id: string | null;
                     status: string;
                     updated_at: string;
                 };
                 Insert: {
+                    blueprint_version_id?: string | null;
                     claimant_email: string;
                     claimant_user_id?: string | null;
-                    claimed_at?: string;
+                    claimed_at?: string | null;
                     created_at?: string;
-                    expires_at: string;
+                    expires_at?: string | null;
                     id?: string;
-                    instance_id: string;
+                    instance_id?: string | null;
                     metadata?: Json;
                     release_reason?: string | null;
                     released_at?: string | null;
-                    site_id: string;
+                    site_id?: string | null;
                     status?: string;
                     updated_at?: string;
                 };
                 Update: {
+                    blueprint_version_id?: string | null;
                     claimant_email?: string;
                     claimant_user_id?: string | null;
-                    claimed_at?: string;
+                    claimed_at?: string | null;
                     created_at?: string;
-                    expires_at?: string;
+                    expires_at?: string | null;
                     id?: string;
-                    instance_id?: string;
+                    instance_id?: string | null;
                     metadata?: Json;
                     release_reason?: string | null;
                     released_at?: string | null;
-                    site_id?: string;
+                    site_id?: string | null;
                     status?: string;
                     updated_at?: string;
                 };
                 Relationships: [
+                    {
+                        foreignKeyName: "demo_claims_blueprint_version_id_fkey";
+                        columns: ["blueprint_version_id"];
+                        isOneToOne: false;
+                        referencedRelation: "demo_blueprint_versions";
+                        referencedColumns: ["id"];
+                    },
                     {
                         foreignKeyName: "demo_claims_instance_id_fkey";
                         columns: ["instance_id"];
@@ -18998,27 +19008,9 @@ export type Database = {
                 Args: {
                     p_blueprint_id: string;
                     p_claimant_email: string;
-                    p_claimant_user_id?: string;
-                    p_claimed_at: string;
-                    p_expires_at: string;
+                    p_claimant_user_id: string;
                 };
-                Returns: {
-                    claim_claimant_email: string;
-                    claim_claimant_user_id: string;
-                    claim_claimed_at: string;
-                    claim_expires_at: string;
-                    claim_id: string;
-                    claim_instance_id: string;
-                    claim_site_id: string;
-                    claim_status: string;
-                    instance_blueprint_id: string;
-                    instance_blueprint_version_id: string;
-                    instance_claimed_at: string;
-                    instance_expires_at: string;
-                    instance_id: string;
-                    instance_site_id: string;
-                    instance_status: string;
-                }[];
+                Returns: Json;
             };
             claim_order_flexible_balance_payment_for_booking: {
                 Args: {
@@ -19402,6 +19394,12 @@ export type Database = {
                 };
                 Returns: boolean;
             };
+            complete_preparing_demo_claim_atomic: {
+                Args: {
+                    p_claim_id: string;
+                };
+                Returns: Json;
+            };
             connect_brevo_account_v1: {
                 Args: {
                     p_account_email: string;
@@ -19872,6 +19870,12 @@ export type Database = {
                 };
                 Returns: Json;
             };
+            demo_claim_expires_at: {
+                Args: {
+                    p_claimed_at: string;
+                };
+                Returns: string;
+            };
             discard_authoritative_page_surface_draft: {
                 Args: {
                     p_expected_content_draft_updated_at: string;
@@ -20339,6 +20343,13 @@ export type Database = {
                 };
                 Returns: string;
             };
+            grant_demo_administrator_membership: {
+                Args: {
+                    p_site_id: string;
+                    p_user_id: string;
+                };
+                Returns: undefined;
+            };
             guard_site_stripe_account_change: {
                 Args: {
                     p_account_email?: string;
@@ -21541,6 +21552,14 @@ export type Database = {
                 };
                 Returns: undefined;
             };
+            request_demo_claim_atomic: {
+                Args: {
+                    p_blueprint_id: string;
+                    p_claimant_email: string;
+                    p_claimant_user_id: string;
+                };
+                Returns: Json;
+            };
             request_order_payment_plan_collection_closure: {
                 Args: {
                     p_plan_id: string;

package/dist/_dts/editor/src/chrome/chromeLayers.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Where preview and editor chrome stacks against the site it shows. Sites
+ * float their own overlays (the event booking bar sits at 12000 and its
+ * booking panel at 14000): the chrome stays above a site's floating bars, so
+ * its controls stay clickable while viewing, and below a site's modal panel.
+ */
+export declare const PREVIEW_CHROME_Z_INDEX = 13000;

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

@@ -1,4 +1,5 @@
 export { EditorChrome } from './chrome/EditorChrome';
+export { PREVIEW_CHROME_Z_INDEX } from './chrome/chromeLayers';
 export { EditorStatusBar } from './chrome/EditorStatusBar';
 export { buildEditorStatusBarPresentationProps } from './chrome/statusBarPresentation';
 export type { DraftWorkflowStatus, EditorHistoryBarControls, EditorStatusBarProps, EditorStatusBarToolbar, StatusBarMenuItem, } from './chrome/EditorStatusBar';

package/dist/_dts/editor-blocks/src/widgets/link/LinkAddressInput.d.ts

@@ -0,0 +1,8 @@
+export declare function LinkAddressInput({ kind, text, invalid, disabled, onChange, destination }: {
+    kind: 'external' | 'custom';
+    text: string;
+    invalid: boolean;
+    disabled?: boolean;
+    onChange: (text: string) => void;
+    destination?: string;
+}): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/link/LinkContentList.d.ts

@@ -0,0 +1,12 @@
+import type { RoutableContentItem } from '../../../../api/src/navigation';
+import type { InternalReference } from './draft';
+import type { RoutableContentState } from './types';
+export declare function LinkContentList({ content, value, query, onQuery, onSelect, disabled, onRefresh }: {
+    content: RoutableContentState;
+    value: InternalReference | null;
+    query: string;
+    onQuery: (query: string) => void;
+    onSelect: (item: RoutableContentItem) => void;
+    disabled?: boolean;
+    onRefresh?: () => void;
+}): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/link/LinkPicker.d.ts

@@ -1,6 +1,7 @@
-import type { RoutableContentItem } from '../../../../api/src/navigation';
+import { type RoutableContentItem } from '../../../../api/src/navigation';
 import type { SiteId } from '../../../../core/src/index';
 import type { LinkValue } from '../../../../blocks/src/index';
+import type { RoutableContentResource } from './types';
 import type { LinkWidgetAdapters } from './types';
 export type LinkPickerProps = {
     siteId?: SiteId;
@@ -10,5 +11,8 @@ export type LinkPickerProps = {
     initialItems?: RoutableContentItem[];
     className?: string;
     adapters?: LinkWidgetAdapters;
+    content?: RoutableContentResource;
+    onCancel?: () => void;
+    actionLabel?: string;
 };
 export declare function LinkPicker(props: LinkPickerProps): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/link/LinkPickerDialog.d.ts

@@ -1,10 +1,10 @@
 import type { LinkValue } from '../../../../blocks/src/index';
-import type { LinkPickerProps } from './LinkPicker';
+import { type LinkPickerProps } from './LinkPicker';
 type LinkPickerDialogProps = {
     open: boolean;
     onOpenChange: (open: boolean) => void;
     value: LinkValue | null;
     onSave: (value: LinkValue | null) => void;
-} & Pick<LinkPickerProps, 'siteId' | 'disabled' | 'initialItems' | 'adapters'>;
-export declare function LinkPickerDialog({ open, onOpenChange, value, onSave, siteId, disabled, initialItems, adapters, }: LinkPickerDialogProps): import("react").JSX.Element;
+} & Pick<LinkPickerProps, 'siteId' | 'disabled' | 'initialItems' | 'adapters' | 'content'>;
+export declare function LinkPickerDialog({ open, onOpenChange, value, onSave, ...options }: LinkPickerDialogProps): import("react").JSX.Element;
 export {};

package/dist/_dts/editor-blocks/src/widgets/link/LinkSummary.d.ts

@@ -1,4 +1,10 @@
-import { type LinkValue } from '../../../../blocks/src/index';
-export declare function LinkSummary({ value }: {
+import type { LinkValue } from '../../../../blocks/src/index';
+import { type LinkPresentation } from './presentation';
+import type { RoutableContentState } from './types';
+export declare function LinkPresentationContent({ presentation }: {
+    presentation: LinkPresentation;
+}): import("react").JSX.Element;
+export declare function LinkSummary({ value, content }: {
     value: LinkValue | null;
+    content?: RoutableContentState;
 }): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/link/LinkWidget.d.ts

@@ -1,8 +1,8 @@
 import { type ReactNode } from 'react';
-import { type LinkValue } from '../../../../blocks/src/index';
+import type { LinkValue } from '../../../../blocks/src/index';
 import type { RoutableContentItem } from '../../../../api/src/navigation';
 import type { SiteId } from '../../../../core/src/index';
-import type { LinkWidgetAdapters } from './types';
+import type { LinkWidgetAdapters, RoutableContentResource } from './types';
 export type LinkWidgetProps = {
     siteId?: SiteId;
     value: LinkValue | null;
@@ -10,9 +10,10 @@ export type LinkWidgetProps = {
     disabled?: boolean;
     initialItems?: RoutableContentItem[];
     adapters?: LinkWidgetAdapters;
+    content?: RoutableContentResource;
     label?: ReactNode;
     description?: ReactNode;
     fieldPath?: string;
     mode?: 'inline' | 'dialog';
 };
-export declare function LinkWidget({ siteId, value, onChange, disabled, initialItems, adapters, label, description, fieldPath, mode, }: LinkWidgetProps): import("react").JSX.Element;
+export declare function LinkWidget({ value, onChange, label, description, fieldPath, mode, content: supplied, ...options }: LinkWidgetProps): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/link/LinkWidgetContext.d.ts

@@ -1,7 +1,7 @@
 import { type ReactNode } from 'react';
 import type { RoutableContentItem } from '../../../../api/src/navigation';
 import type { SiteId } from '../../../../core/src/index';
-import type { LinkWidgetAdapters } from './types';
+import type { LinkWidgetAdapters, RoutableContentResource } from './types';
 /**
  * Context value for LinkWidget
  *
@@ -12,6 +12,7 @@ export type LinkWidgetContextValue = {
     siteId?: SiteId;
     adapters?: LinkWidgetAdapters;
     initialItems?: RoutableContentItem[];
+    content?: RoutableContentResource;
 };
 /**
  * Provider for LinkWidget context

package/dist/_dts/editor-blocks/src/widgets/link/draft.d.ts

@@ -0,0 +1,44 @@
+import { type LinkValue } from '../../../../blocks/src/index';
+import type { RoutableContentState } from './types';
+export type InternalReference = Extract<LinkValue, {
+    kind: 'internal' | 'page' | 'entry';
+}>;
+export type LinkTab = 'internal' | 'external' | 'custom';
+type EditingLinkDraft = Readonly<{
+    kind: 'editing';
+    tab: LinkTab;
+    internal: InternalReference | null;
+    external: string;
+    custom: string;
+}>;
+export type LinkDraft = EditingLinkDraft | Readonly<{
+    kind: 'cleared';
+    tab: 'internal';
+    internal: null;
+    external: '';
+    custom: '';
+}>;
+export type LinkDraftEvent = {
+    type: 'clear';
+} | {
+    type: 'tab';
+    tab: LinkTab;
+} | {
+    type: 'internal';
+    value: InternalReference;
+} | {
+    type: 'external' | 'custom';
+    text: string;
+};
+export type LinkDraftDecision = {
+    kind: 'valid';
+    value: LinkValue | null;
+} | {
+    kind: 'invalid';
+    reason: 'external' | 'custom' | 'missing' | 'selection';
+};
+export declare function createLinkDraft(value: LinkValue | null): EditingLinkDraft;
+export declare function reduceLinkDraft(draft: LinkDraft, event: LinkDraftEvent): LinkDraft;
+export declare function decideLinkDraft(draft: LinkDraft, content: RoutableContentState): LinkDraftDecision;
+export declare function isLinkTab(value: string): value is LinkTab;
+export {};

package/dist/_dts/editor-blocks/src/widgets/link/presentation.d.ts

@@ -0,0 +1,13 @@
+import { type LinkValue } from '../../../../blocks/src/index';
+import type { RoutableContentItem } from '../../../../api/src/navigation';
+import type { RoutableContentState } from './types';
+export type LinkPresentation = Readonly<{
+    title: string;
+    typeLabel?: string;
+    href?: string;
+    missing?: boolean;
+}>;
+export declare function presentLink(value: LinkValue | null, content: RoutableContentState): LinkPresentation;
+export declare const publicationLabels: {
+    readonly [Status in RoutableContentItem['status']]: Status extends 'published' ? null : Capitalize<Status>;
+};

package/dist/_dts/editor-blocks/src/widgets/link/types.d.ts

@@ -8,3 +8,17 @@ export type CreateLinkWidgetOptions = {
     adapters?: LinkWidgetAdapters;
     initialItems?: RoutableContentItem[];
 };
+export type RoutableContentState = {
+    kind: 'unavailable';
+} | {
+    kind: 'loading';
+} | {
+    kind: 'error';
+} | {
+    kind: 'ready';
+    items: RoutableContentItem[];
+};
+export type RoutableContentResource = Readonly<{
+    state: RoutableContentState;
+    refresh?: () => void;
+}>;

package/dist/_dts/editor-blocks/src/widgets/link/useRoutableContent.d.ts

@@ -0,0 +1,2 @@
+import type { CreateLinkWidgetOptions, RoutableContentResource } from './types';
+export declare function useRoutableContent({ siteId, adapters, initialItems }: CreateLinkWidgetOptions): RoutableContentResource;

package/dist/_dts/editor-blocks/src/widgets/link/utils.d.ts

@@ -1,6 +1,7 @@
-import { type RoutableContentItem } from '../../../../api/src/navigation';
-import { type LinkValue } from '../../../../blocks/src/index';
-export declare function toInternalLinkValue(item: RoutableContentItem): LinkValue;
+import type { RoutableContentItem } from '../../../../api/src/navigation';
+import type { LinkValue } from '../../../../blocks/src/index';
 export declare function getMatchingInternalItem(items: RoutableContentItem[], value: LinkValue | null): RoutableContentItem | null;
-export declare function isSameLinkValue(a: LinkValue | null, b: LinkValue | null): boolean;
 export declare function getDisplayTitle(item: Pick<RoutableContentItem, 'title' | 'draftTitle'>): string;
+export declare function filterRoutableItems(items: RoutableContentItem[], query: string): RoutableContentItem[];
+export declare function isDomainLookingCustomPath(value: string): boolean;
+export declare function isSelectableRoutableItem(item: RoutableContentItem): boolean;

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/MailingListTargetingField.d.ts

@@ -6,7 +6,7 @@ export declare function MailingListTargetingControl({ context, targeting, onChan
     context: Extract<MailingListRuntimeContext, {
         tag: 'configured';
     }>;
-    targeting: MailingListPlacementTargeting;
+    targeting: unknown;
     onChange: (value: MailingListPlacementTargeting) => void;
     name: string;
 }>): import("react").JSX.Element;

package/dist/_dts/editor-blocks/src/widgets/mailing-list-targeting/targetingState.d.ts

@@ -1,4 +1,4 @@
-import { type MailingListPlacementTargeting, type MailingListRuntimeContext } from '../../../../core/src/index';
+import { type MailingListPlacementTargeting, type MailingListRuntimeContext, type MailingListResolvedCustomTargeting, type MailingListMissingAudienceTargeting } from '../../../../core/src/index';
 type ConfiguredContext = Extract<MailingListRuntimeContext, {
     tag: 'configured';
 }>;
@@ -8,12 +8,17 @@ type CustomTargeting = Exclude<MailingListPlacementTargeting, {
 /** The name of the site's default topic/list/audience, or null when it no longer exists. */
 export declare function defaultItemName(context: ConfiguredContext): string | null;
 /** What the editor is choosing between, in the provider's own words. */
-export declare function choiceNoun(context: ConfiguredContext, form?: 'singular' | 'plural'): string;
+export declare function choiceNoun(provider: ConfiguredContext['provider']['provider'], form?: 'singular' | 'plural'): string;
 export declare function providerDisplayName(context: ConfiguredContext): string;
-export declare function providerDefaultIsAvailable(context: ConfiguredContext): boolean;
-export declare function createInitialCustom(context: ConfiguredContext): CustomTargeting;
-export declare function changeSelectionMode(context: ConfiguredContext, targeting: CustomTargeting, mode: 'fixed' | 'visitor_choice'): CustomTargeting;
-export declare function canOfferVisitorChoice(context: ConfiguredContext, targeting: CustomTargeting): boolean;
-export declare function toggle(values: readonly string[], id: string): string[];
-export declare function toggleRequired(values: readonly string[], id: string): string[];
+export declare function createInitialCustom(context: ConfiguredContext): CustomTargeting | null;
+export type TargetingTransition = Readonly<{
+    tag: 'changed';
+    targeting: CustomTargeting;
+}> | Readonly<{
+    tag: 'refused';
+    reason: 'last_choice' | 'invalid_choice' | 'no_interests' | 'audience_missing';
+}>;
+type EditableTargeting = MailingListResolvedCustomTargeting | MailingListMissingAudienceTargeting;
+export declare function changeSelectionMode(matched: EditableTargeting, mode: 'fixed' | 'visitor_choice'): TargetingTransition;
+export declare function toggleTargetingChoice(targeting: CustomTargeting, rawId: string): TargetingTransition;
 export {};

package/dist/_dts/media-core/src/fileStorage.d.ts

@@ -1,5 +1,6 @@
 import { type SafeDownloadFilename, type SiteScopedStoragePath, type SiteId, type StorageBucketName, type StoragePath, type UploadSessionId, type UserId, type MediaAssetId, type Result } from '../../core/src/index';
 import type { StorageClass } from './fileDomain';
+import { type WritableStoragePathError } from './storageObjectKey';
 export declare const FILE_STORAGE_BUCKETS: {
     readonly publicSite: StorageBucketName;
     readonly privateSite: StorageBucketName;
@@ -16,7 +17,7 @@ export declare const DURABLE_FILE_FOLDER = "files";
 export declare const SDK_UPLOAD_STAGING_PREFIX = "sdk-staging";
 export declare const PRIVATE_SITE_FILE_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime"];
 export declare const TEMP_UPLOAD_BUCKET_MIME_TYPES: readonly ["application/pdf", "application/vnd.openxmlformats-officedocument.wordprocessingml.document", "text/plain", "application/rtf", "text/rtf", "image/jpeg", "image/png", "image/webp", "image/gif", "image/avif", "image/heic", "image/heif", "image/svg+xml", "text/csv", "application/csv", "application/vnd.ms-excel", "application/zip", "application/x-zip-compressed", "audio/mpeg", "audio/mp4", "audio/wav", "audio/x-wav", "audio/ogg", "audio/webm", "audio/flac", "video/mp4", "video/webm", "video/quicktime", "font/woff2", "application/font-woff2", "application/x-font-woff2", "application/octet-stream"];
-export type FileStoragePathError = 'unsafe-path-segment';
+export type FileStoragePathError = WritableStoragePathError;
 export type StagedUploadStoragePathInput = {
     readonly userId: UserId;
     readonly siteId: SiteId;
@@ -35,12 +36,12 @@ export type DurableFileStoragePathInput = {
 export declare function storageBucketForStorageClass(storageClass: StorageClass): StorageBucketName;
 /**
  * Builds the `temp-uploads` object path allowed by Storage RLS:
- * `temp-file-uploads/{userId}/{siteId}/{uploadSessionId}/{safeDownloadFilename}`.
+ * `temp-file-uploads/{userId}/{siteId}/{uploadSessionId}/{storageObjectFilename}`.
  */
 export declare function buildStagedUploadStoragePath(input: StagedUploadStoragePathInput): Result<StoragePath, FileStoragePathError>;
 /**
  * Builds the durable site-scoped object path allowed by public/private site-file RLS:
- * `sites/{siteId}/files/{fileAssetId}/{safeDownloadFilename}`.
+ * `sites/{siteId}/files/{fileAssetId}/{storageObjectFilename}`.
  */
 export declare function buildDurableFileStoragePath(input: DurableFileStoragePathInput): Result<SiteScopedStoragePath, FileStoragePathError>;
 export declare function parseStoragePath(value: string): Result<StoragePath, FileStoragePathError>;

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

@@ -1,6 +1,7 @@
 export * from './types';
 export * from './fileDomain';
 export * from './fileStorage';
+export * from './storageObjectKey';
 export * from './storagePathDomain';
 export * from './fileSafety';
 export * from './filePersistence';