@riverbankcms/sdk 0.77.1 → 0.78.2

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

@@ -0,0 +1,2 @@
+import type { RiverbankSiteConfig, SdkWorkflowConfig } from '../../api/src/sdkContracts';
+export declare function listManualEntryWorkflows(sdkConfig: RiverbankSiteConfig | null | undefined, contentType: string): SdkWorkflowConfig[];

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

@@ -0,0 +1,76 @@
+type FooterBlocksFooterMode = 'default' | 'blocks' | 'default+blocks' | 'none';
+export type FooterBlocksEditorBlock = Readonly<{
+    id: string;
+    kind: string;
+    kindLabel: string;
+    purpose: 'footer';
+    content: Record<string, unknown>;
+    editable: boolean;
+    readOnlyReason?: string | null;
+}>;
+export type FooterBlocksEditorLoadResponse = Readonly<{
+    blocks: FooterBlocksEditorBlock[];
+    footerMode: FooterBlocksFooterMode;
+}>;
+type FooterBlocksResponse = FooterBlocksEditorLoadResponse;
+type FooterBlock = FooterBlocksEditorBlock;
+type UpdatePayload = Readonly<{
+    blocks: Array<Readonly<{
+        id: string;
+        content: Record<string, unknown>;
+    }>>;
+    removedBlockIds?: string[];
+}>;
+export type FooterBlocksEditorReadyState = Readonly<{
+    tag: 'ready';
+    footerMode: FooterBlocksResponse['footerMode'];
+    blocks: FooterBlock[];
+    initialOrder: string[];
+    removedBlockIds: ReadonlySet<string>;
+    validationMessage: string | null;
+    previewExpanded: boolean;
+}>;
+export type FooterBlocksEditorState = Readonly<{
+    tag: 'loading';
+}> | Readonly<{
+    tag: 'error';
+    message: string;
+}> | FooterBlocksEditorReadyState;
+export type FooterBlocksEditorAction = Readonly<{
+    type: 'load-started';
+}> | Readonly<{
+    type: 'load-succeeded';
+    response: FooterBlocksResponse;
+}> | Readonly<{
+    type: 'load-failed';
+    message: string;
+}> | Readonly<{
+    type: 'block-moved';
+    blockId: string;
+    direction: -1 | 1;
+}> | Readonly<{
+    type: 'block-removed';
+    blockId: string;
+}> | Readonly<{
+    type: 'preview-toggled';
+    expanded: boolean;
+}> | Readonly<{
+    type: 'validation-message-set';
+    message: string | null;
+}>;
+export type FooterBlocksPreviewState = Readonly<{
+    blocks: Array<Readonly<{
+        id: string;
+        content: Record<string, unknown>;
+        kind: string;
+        kindLabel: string;
+        readOnlyReason: string | null;
+    }>>;
+    removedBlockIds: string[];
+}>;
+export declare function createInitialFooterBlocksEditorState(): FooterBlocksEditorState;
+export declare function footerBlocksEditorReducer(state: FooterBlocksEditorState, action: FooterBlocksEditorAction): FooterBlocksEditorState;
+export declare function selectFooterBlocksStructuralChanges(state: FooterBlocksEditorState): boolean;
+export declare function buildFooterBlocksUpdatePayload(state: FooterBlocksEditorReadyState, getDraftContent: (block: FooterBlock) => Record<string, unknown> | null): UpdatePayload;
+export declare function selectFooterBlocksPreview(state: FooterBlocksEditorReadyState, getDraftContent: (block: FooterBlock) => Record<string, unknown> | null): FooterBlocksPreviewState | null;
+export {};

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

@@ -23,6 +23,11 @@ export { useStoreBinding, parseEditorPath } from './primitives/shared';
 export type { PathInfo } from './primitives/shared';
 export * from './ai/overlayHelpers';
 export { diffPaths, isUnpublishedChangesDebugEnabled } from './debug/unpublishedChangesDebug';
-export { canRedoHistory, canUndoHistory, createHistoryState, asEditorBlockId, pushHistoryEntry, redoHistory, replaceHistoryPresent, undoHistory, type HistoryState, type EditorBlockId, } from './ui/editorHistory';
+export { listManualEntryWorkflows } from './entryWorkflows';
+export { pageWorkflowDraftContent, pageWorkflowPublishedContent, type PageWorkflowDraftSource, type PageWorkflowPublishedSource, } from './pageWorkflowContent';
+export { contentTypeEditorContentReducer, createInitialContentTypeEditorContentState, type ContentTypeEditorContentAction, type ContentTypeEditorContentState, } from './contentTypeEditorContentState';
+export { buildFooterBlocksUpdatePayload, createInitialFooterBlocksEditorState, footerBlocksEditorReducer, selectFooterBlocksPreview, selectFooterBlocksStructuralChanges, type FooterBlocksEditorBlock, type FooterBlocksEditorAction, type FooterBlocksEditorLoadResponse, type FooterBlocksEditorReadyState, type FooterBlocksEditorState, type FooterBlocksPreviewState, } from './footerBlocksEditorState';
+export { asContentEntrySnapshotSource, createContentEntriesDefinitionPlan, createPageSnapshot, createPagesDefinitionPlan, createSnapshotDefaults, getDefaultEntityLabel, mapPageRecordToSnapshot, type ContentEntriesDefinitionPlanOptions, type ContentEntryDefinitionPlan, type DefinitionServices, type PageEntrySnapshot, type PagesDefinitionPlanOptions, type SnapshotDefaults, } from './definitions/factory';
+export { canRedoHistory, canUndoHistory, createHistoryState, unsafeAsEditorBlockId, pushHistoryEntry, redoHistory, replaceHistoryPresent, undoHistory, type HistoryState, type EditorBlockId, } from './ui/editorHistory';
 export { classifyHistoryShortcut, isNativeHistoryTarget, type HistoryShortcutCommand } from './historyShortcuts';
 export type { ContentEntryControllerOptions, ContentEntryControllerState, DraftWorkflowStatus, MetadataAutosaveConfig, MetadataKindConfig, } from './types';

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

@@ -0,0 +1,29 @@
+import type { WorkflowPageDraftContent, WorkflowPagePublishedContent } from '../../api/src/content-editor';
+type PageRouteCanonicalUrl = Readonly<{
+    canonicalUrl?: string | null;
+}>;
+export type PageWorkflowDraftSource = Readonly<{
+    draftTitle?: string | null;
+    draftSlug?: string | null;
+    draftStatus?: string | null;
+    scheduledPublishAt?: string | null;
+    draftMetaTitle?: string | null;
+    draftMetaDescription?: string | null;
+    canonicalUrl?: string | null;
+    ogImageId?: string | null;
+    route?: PageRouteCanonicalUrl | null;
+}>;
+export type PageWorkflowPublishedSource = Readonly<{
+    title?: string | null;
+    slug?: string | null;
+    status?: string | null;
+    publishedAt?: string | null;
+    publishedMetaTitle?: string | null;
+    publishedMetaDescription?: string | null;
+    canonicalUrl?: string | null;
+    ogImageId?: string | null;
+    route?: PageRouteCanonicalUrl | null;
+}>;
+export declare function pageWorkflowDraftContent(page: PageWorkflowDraftSource): WorkflowPageDraftContent;
+export declare function pageWorkflowPublishedContent(page: PageWorkflowPublishedSource): WorkflowPagePublishedContent | null;
+export {};

package/dist/_dts/content-editor/src/ui/editorSnapshot.d.ts

@@ -1,5 +1,5 @@
-import { asEditorBlockId, asEditorBlockValues, asEditorContentValues, asEditorEntryId, asEditorMetadataValues, asEditorPageId, asEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
-export { asEditorBlockId, asEditorBlockValues, asEditorContentValues, asEditorEntryId, asEditorMetadataValues, asEditorPageId, asEditorSiteId, type EditorBlockId, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorSiteId, };
+import { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockBaselineInput, type EditorBlockId, type EditorBlockPublishedBaselineInput, type EditorDraftBlockBaselineUpdateMetaInput, type EditorDraftBlockInitMetaInput, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorPersistedBlock, type EditorSiteId, type EditorStructuralCommand, type EditorStructuralDraftSnapshot, type EditorSyncState, type EditorValueRecord } from '../../../core/src/index';
+export { unsafeAsEditorBlockId, unsafeAsEditorBlockValues, unsafeAsEditorContentValues, unsafeAsEditorEntryId, unsafeAsEditorMetadataValues, unsafeAsEditorPageId, unsafeAsEditorSiteId, type EditorBlockId, type EditorBlockValues, type EditorContentValues, type EditorEntryId, type EditorMetadataValues, type EditorPageId, type EditorSiteId, };
 export type EditorCommand = {
     type: 'set-metadata-value';
     path: string;

package/dist/_dts/content-model/src/content-types/schema.d.ts

@@ -8,13 +8,13 @@ declare const BaseContentFieldSchema: z.ZodObject<{
         number: "number";
         boolean: "boolean";
         date: "date";
+        text: "text";
+        textarea: "textarea";
+        select: "select";
         url: "url";
         media: "media";
         button: "button";
         link: "link";
-        select: "select";
-        textarea: "textarea";
-        text: "text";
         richText: "richText";
         file: "file";
         datetime: "datetime";
@@ -94,6 +94,12 @@ declare const RoutingSchema: z.ZodObject<{
         }>>;
     }, z.core.$strip>>>;
 }, z.core.$strip>;
+declare const OrderingSchema: z.ZodDefault<z.ZodObject<{
+    mode: z.ZodDefault<z.ZodEnum<{
+        manual: "manual";
+        default: "default";
+    }>>;
+}, z.core.$strip>>;
 export declare const ContentTypeSchemaZ: z.ZodObject<{
     version: z.ZodDefault<z.ZodNumber>;
     fields: z.ZodDefault<z.ZodArray<z.ZodType<ContentFieldSchemaType, unknown, z.core.$ZodTypeInternals<ContentFieldSchemaType, unknown>>>>;
@@ -123,9 +129,17 @@ export declare const ContentTypeSchemaZ: z.ZodObject<{
         singular: z.ZodString;
         plural: z.ZodString;
     }, z.core.$strip>>;
+    ordering: z.ZodOptional<z.ZodDefault<z.ZodObject<{
+        mode: z.ZodDefault<z.ZodEnum<{
+            manual: "manual";
+            default: "default";
+        }>>;
+    }, z.core.$strip>>>;
 }, z.core.$strip>;
 export type RoutingConfig = z.infer<typeof RoutingSchema>;
 export type ContentTypeSchema = z.infer<typeof ContentTypeSchemaZ>;
 export type ContentFieldConfig = z.infer<typeof ContentFieldSchema>;
+export type ContentTypeOrderingConfig = z.infer<typeof OrderingSchema>;
 export declare function parseContentTypeSchema(input: unknown): ContentTypeSchema;
+export declare function isManualEntryOrderingEnabled(schema: Pick<ContentTypeSchema, 'ordering'> | null | undefined): boolean;
 export {};

package/dist/_dts/content-model/src/index.d.ts

@@ -18,3 +18,4 @@ export * from './templates/fieldPaths';
 export * from './templates/bindingValidation';
 export * from './templates/manifestAdapter';
 export * from './templates/auditBindings';
+export * from './templates/editorState';

package/dist/_dts/content-model/src/routeTemplate.d.ts

@@ -40,4 +40,8 @@ export declare function fixedPathOrNull(routeTemplate: RouteTemplate): string |
 /** Returns the first path segment, or undefined when the template has no fixed prefix segment. */
 export declare function getRouteTemplatePrefix(routeTemplate: RouteTemplate): string | undefined;
 export declare function expandSlug(routeTemplate: RouteTemplate, slug: string): string;
+export declare function buildContentEntryRoutePath(input: Readonly<{
+    routePattern: string | null;
+    slug: string;
+}>): string;
 export declare function describeRouteTemplateParseError(error: RouteTemplateParseError): string;

package/dist/_dts/content-model/src/templates/bindingTypeCompatibility.d.ts

@@ -6,7 +6,9 @@
  */
 import type { ContentFieldConfig } from '../content-types/schema';
 export type ContentFieldType = ContentFieldConfig['type'];
-export type BlockFieldType = 'text' | 'number' | 'slug' | 'url' | 'richText' | 'media' | 'file' | 'boolean' | 'select' | 'reference' | 'link' | 'date' | 'datetime';
+export type BlockFieldType = 'text' | 'number' | 'slug' | 'url' | 'richText' | 'media' | 'file' | 'boolean' | 'select' | 'reference' | 'link' | 'date' | 'datetime' | 'repeater';
+export type ScalarBlockFieldType = Exclude<BlockFieldType, 'repeater'>;
+export declare function isScalarBlockFieldType(type: string): type is ScalarBlockFieldType;
 export type MetaFieldType = 'text' | 'date' | 'enum';
 /**
  * Canonical meta-field registry.

package/dist/_dts/content-model/src/templates/bindingValidation.d.ts

@@ -24,7 +24,8 @@
  */
 import type { ContentTypeSchema } from '../content-types/schema';
 import { type TemplateBindingTransformName, type TemplateBindingValue, type TemplateBlockDefinition, type TemplateDefinition } from './types';
-import { type BlockFieldType, type ContentFieldType } from './bindingTypeCompatibility';
+import { type BlockFieldType, type ContentFieldType, type ScalarBlockFieldType } from './bindingTypeCompatibility';
+import { type RepeaterFieldShape } from './fieldPaths';
 /**
  * Structural shape this validator needs from a block manifest. Decouples
  * `@riverbankcms/content-model` from the heavy `BlockManifest` type in
@@ -37,14 +38,19 @@ export interface BlockManifestForValidation {
     /** Flattened list of bindable fields the manifest exposes. */
     fields: readonly BlockFieldTarget[];
 }
-export interface BlockFieldTarget {
+export type BlockFieldTarget = Readonly<{
     /** Field id (top-level or dot-notated for nested manifest paths). */
     id: string;
     /** Target type from the bindings compatibility matrix. */
-    type: BlockFieldType;
+    type: ScalarBlockFieldType;
     /** Whether the binding for this target must be present. */
     required: boolean;
-}
+}> | Readonly<{
+    id: string;
+    type: 'repeater';
+    required: boolean;
+    shape: RepeaterFieldShape;
+}>;
 export type GetBlockManifestForValidation = (kind: string) => BlockManifestForValidation | undefined;
 /** Discriminated union of every validation failure this validator emits. */
 export type BindingValidationError = Readonly<{

package/dist/_dts/content-model/src/templates/editorState.d.ts

@@ -0,0 +1,25 @@
+import type { TemplateBindingValue } from './types';
+export type TemplateEditorBindingDescriptor = TemplateBindingValue | Record<string, unknown>;
+export type TemplateEditorBindings = Record<string, TemplateEditorBindingDescriptor>;
+export type TemplateEditorBlockBindings = Record<string, TemplateEditorBindings>;
+export type TemplateEditorBlockBindingSource = Readonly<{
+    id: string;
+    scope: string;
+    bindings?: Record<string, unknown> | null;
+}>;
+export type ParsedTemplateEditorBindings = Readonly<{
+    ok: true;
+    bindings: TemplateEditorBindings;
+}> | Readonly<{
+    ok: false;
+    message: string;
+}>;
+export declare function normalizeTemplateEditorBindings(bindings: Record<string, unknown> | null | undefined): TemplateEditorBindings;
+export declare function serializeTemplateEditorBindingsJson(bindings: TemplateEditorBindings): string;
+export declare function parseTemplateEditorBindingsJson(jsonValue: string): ParsedTemplateEditorBindings;
+export declare function mergeTemplateBindingEdits(currentBindings: TemplateEditorBindings, editedBindings: TemplateEditorBindings): TemplateEditorBindings;
+export declare function setTemplateEditorBinding(bindings: TemplateEditorBindings, propId: string, binding: TemplateEditorBindingDescriptor): TemplateEditorBindings;
+export declare function removeTemplateEditorBinding(bindings: TemplateEditorBindings, propId: string): TemplateEditorBindings;
+export declare function createEntryTemplateBindingRecords(blocks: readonly TemplateEditorBlockBindingSource[]): TemplateEditorBlockBindings;
+export declare function setTemplateBlockBinding(allBindings: TemplateEditorBlockBindings, blockId: string, propId: string, binding: TemplateEditorBindingDescriptor): TemplateEditorBlockBindings;
+export declare function removeTemplateBlockBinding(allBindings: TemplateEditorBlockBindings, blockId: string, propId: string): TemplateEditorBlockBindings;

package/dist/_dts/content-model/src/templates/fieldPaths.d.ts

@@ -6,6 +6,25 @@ export type FieldPathOption = {
     type: string;
     category: 'meta' | 'content';
 };
+export type RepeaterFieldShape = Readonly<{
+    kind: 'supported';
+    itemFields: readonly RepeaterItemFieldDescriptor[];
+}> | Readonly<{
+    kind: 'unsupported';
+    reason: 'missing_item_schema' | 'polymorphic_unsupported' | 'nested_repeater_unsupported' | 'unsupported_item_field';
+}>;
+export type RepeaterItemFieldDescriptor = Readonly<{
+    id: string;
+    type: string;
+    required: boolean;
+}>;
+export type FieldPathDescriptor = Readonly<{
+    kind: 'scalar';
+    type: string;
+}> | Readonly<{
+    kind: 'repeater';
+    shape: RepeaterFieldShape;
+}>;
 /**
  * Extract all available field paths from a content type schema
  * for use in binding editor autocomplete.
@@ -15,6 +34,7 @@ export declare function getAvailableFieldPaths(schema: ContentTypeSchema): Field
  * Get field type from path for validation
  */
 export declare function getFieldTypeFromPath(schema: ContentTypeSchema, path: string): string | null;
+export declare function getFieldDescriptorFromPath(schema: ContentTypeSchema, path: string): FieldPathDescriptor | null;
 /**
  * Validate if a path exists in the schema
  */

package/dist/_dts/content-model/src/templates/manifestAdapter.d.ts

@@ -37,7 +37,7 @@ export interface AdaptableManifestField {
     id: string;
     type: string;
     required?: boolean;
-    /** Group/modal containers carry children under `schema.fields`. */
+    /** Group/modal and SDK-style monomorphic repeater containers carry children under `schema.fields`. */
     schema?: {
         fields?: ReadonlyArray<AdaptableManifestField>;
     };
@@ -49,6 +49,8 @@ export interface AdaptableManifestField {
     repeatedItem?: {
         fields?: ReadonlyArray<AdaptableManifestField>;
     };
+    polymorphic?: boolean;
+    itemTypes?: unknown;
 }
 /**
  * Classification of every value `FieldDefinition['type']` can take.
@@ -59,10 +61,11 @@ export interface AdaptableManifestField {
  *
  *   - `leaf`: directly bindable; maps onto the `BlockFieldType` matrix.
  *   - `composite`: walked recursively (children become flattened targets).
+ *   - `whole`: bindable only as the whole field.
  *   - `opaque`: dashboard-only or polymorphic types whose leaves can't be
  *     enumerated structurally. Skipped entirely.
  */
-type FieldTypeClassification = 'leaf' | 'composite' | 'opaque';
+type FieldTypeClassification = 'leaf' | 'composite' | 'whole' | 'opaque';
 export declare const FIELD_TYPE_CLASSIFICATION: Readonly<Record<string, FieldTypeClassification>>;
 /**
  * Build the validator-facing shape from a block manifest. Composite fields

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

@@ -1,3 +1,4 @@
+import { type Result } from './result';
 /**
  * Branded ID types for domain entities.
  *
@@ -5,14 +6,22 @@
  * accidentally pass an EventInstanceId where a ProductId is expected.
  *
  * Usage:
- *   const instanceId = asEventInstanceId('abc-123')
- *   const productId = asProductId('def-456')
- *   // instanceId cannot be assigned to productId — compile error
+ *   const parsed = parseSiteId(input)
+ *   const productId = unsafeAsProductId(validatedProductId)
+ *   // parsed SiteId cannot be assigned to productId — compile error
  */
 declare const __brand: unique symbol;
 export type Brand<T, B extends string> = T & {
     readonly [__brand]: B;
 };
+export type BrandedIdParseError = {
+    kind: 'not_string';
+} | {
+    kind: 'empty_string';
+} | {
+    kind: 'invalid_uuid';
+};
+export declare function expectParsedBrandedId<TBrand>(result: Result<TBrand, BrandedIdParseError>): TBrand;
 export type EventInstanceId = Brand<string, 'EventInstanceId'>;
 export type SiteId = Brand<string, 'SiteId'>;
 export type PageId = Brand<string, 'PageId'>;
@@ -115,99 +124,113 @@ export type EntryId = Brand<string, 'EntryId'>;
 export type PreviewEntryId = EntryId & {
     readonly __preview: true;
 };
-export declare const asEntryId: (id: string) => EntryId;
+export declare const unsafeAsEntryId: (id: string) => EntryId;
 /**
  * Mint a preview-fixture entry id. Unsafe at the type level because the
  * function can't verify the input string is actually shaped as a preview
  * id — the predicate `isPreviewEntryId` is the recommended narrowing path.
  */
 export declare const unsafeAsPreviewEntryId: (id: string) => PreviewEntryId;
-export declare const asEventInstanceId: (id: string) => EventInstanceId;
-export declare const asSiteId: (id: string) => SiteId;
-export declare const asPageId: (id: string) => PageId;
-export declare const asOccurrenceId: (id: string) => OccurrenceId;
-export declare const asEventSeriesId: (id: string) => EventSeriesId;
-export declare const asTicketTypeId: (id: string) => TicketTypeId;
-export declare const asEventCategoryId: (id: string) => EventCategoryId;
-export declare const asVenueId: (id: string) => VenueId;
-export declare const asPricingOptionId: (id: string) => PricingOptionId;
-export declare const asMoneyDateString: (value: string) => MoneyDateString;
-export declare const asStripeCheckoutSessionId: (value: string) => StripeCheckoutSessionId;
-export declare const asProductId: (id: string) => ProductId;
-export declare const asProductVariantId: (id: string) => ProductVariantId;
-export declare const asProductCategoryId: (id: string) => ProductCategoryId;
-export declare const asMediaAssetId: (id: string) => MediaAssetId;
-export declare const asUploadSessionId: (id: string) => UploadSessionId;
-export declare const asStorageBucketName: (value: string) => StorageBucketName;
-export declare const asStoragePath: (value: string) => StoragePath;
+export declare const unsafeAsEventInstanceId: (id: string) => EventInstanceId;
+export declare const unsafeAsSiteId: (id: string) => SiteId;
+export declare const unsafeAsPageId: (id: string) => PageId;
+export declare const unsafeAsOccurrenceId: (id: string) => OccurrenceId;
+export declare const unsafeAsEventSeriesId: (id: string) => EventSeriesId;
+export declare const unsafeAsTicketTypeId: (id: string) => TicketTypeId;
+export declare const unsafeAsEventCategoryId: (id: string) => EventCategoryId;
+export declare const unsafeAsVenueId: (id: string) => VenueId;
+export declare const unsafeAsPricingOptionId: (id: string) => PricingOptionId;
+export declare const unsafeAsMoneyDateString: (value: string) => MoneyDateString;
+export declare const unsafeAsStripeCheckoutSessionId: (value: string) => StripeCheckoutSessionId;
+export declare const unsafeAsProductId: (id: string) => ProductId;
+export declare const unsafeAsProductVariantId: (id: string) => ProductVariantId;
+export declare const unsafeAsProductCategoryId: (id: string) => ProductCategoryId;
+export declare const unsafeAsMediaAssetId: (id: string) => MediaAssetId;
+export declare const unsafeAsUploadSessionId: (id: string) => UploadSessionId;
+export declare const unsafeAsStorageBucketName: (value: string) => StorageBucketName;
+export declare const unsafeAsStoragePath: (value: string) => StoragePath;
 export declare const unsafeAsRelativeStoragePath: (value: string) => RelativeStoragePath;
 export declare const unsafeAsSiteScopedStoragePath: (value: string) => SiteScopedStoragePath;
-/** @deprecated Use `unsafeAsRelativeStoragePath` to make the unchecked cast explicit. */
-export declare const asRelativeStoragePath: (value: string) => RelativeStoragePath;
-/** @deprecated Use `unsafeAsSiteScopedStoragePath` to make the unchecked cast explicit. */
-export declare const asSiteScopedStoragePath: (value: string) => SiteScopedStoragePath;
 export declare const unsafeAsFileChecksumSha256: (value: string) => FileChecksumSha256;
-export declare const asDetectedMimeType: (value: string) => DetectedMimeType;
-export declare const asDeclaredMimeType: (value: string) => DeclaredMimeType;
-export declare const asOriginalFilename: (value: string) => OriginalFilename;
+export declare const unsafeAsDetectedMimeType: (value: string) => DetectedMimeType;
+export declare const unsafeAsDeclaredMimeType: (value: string) => DeclaredMimeType;
+export declare const unsafeAsOriginalFilename: (value: string) => OriginalFilename;
 export declare const unsafeAsSafeDownloadFilename: (value: string) => SafeDownloadFilename;
 export declare const unsafeAsPositiveByteCount: (value: number) => PositiveByteCount;
 export declare const unsafeAsPositiveSeconds: (value: number) => PositiveSeconds;
-export declare const asBookingSessionId: (id: string) => BookingSessionId;
-export declare const asEntitlementId: (id: string) => EntitlementId;
-export declare const asSiteFontId: (id: string) => SiteFontId;
-export declare const asUserId: (id: string) => UserId;
-export declare const asFormId: (id: string) => FormId;
-export declare const asFormSubmissionId: (id: string) => FormSubmissionId;
-export declare const asPassId: (id: string) => PassId;
-export declare const asMembershipId: (id: string) => MembershipId;
-export declare const asCourseId: (id: string) => CourseId;
-export declare const asCustomerId: (id: string) => CustomerId;
-export declare const asOrderId: (id: string) => OrderId;
-export declare const asOrderItemId: (id: string) => OrderItemId;
-export declare const asCheckoutLineId: (id: string) => CheckoutLineId;
-export declare const asAttendeeId: (id: string) => AttendeeId;
-export declare const asCustomerPassId: (id: string) => CustomerPassId;
-export declare const asCustomerMembershipId: (id: string) => CustomerMembershipId;
-export declare const asEnrollmentId: (id: string) => EnrollmentId;
-export declare const asAppointmentId: (id: string) => AppointmentId;
-export declare const asAppointmentServiceId: (id: string) => AppointmentServiceId;
-export declare const asAppointmentResourceId: (id: string) => AppointmentResourceId;
-export declare const asStaffMemberId: (id: string) => StaffMemberId;
-export declare const asBookingCalendarFeedTokenId: (id: string) => BookingCalendarFeedTokenId;
-export declare const asBookingCalendarFeedTokenPublicId: (id: string) => BookingCalendarFeedTokenPublicId;
-export declare const asBookingCalendarFeedTokenSecret: (value: string) => BookingCalendarFeedTokenSecret;
-export declare const asBookingCalendarFeedTokenSecretHash: (value: string) => BookingCalendarFeedTokenSecretHash;
-export declare const asContentEntryId: (id: string) => ContentEntryId;
-export declare const asStripeInvoiceId: (id: string) => StripeInvoiceId;
-export declare const asNewsletterSubscriberId: (id: string) => NewsletterSubscriberId;
-export declare const asEmailAuditRowId: (id: string) => EmailAuditRowId;
-export declare const asWaitlistEntryId: (id: string) => WaitlistEntryId;
-export declare const asWaitlistHoldId: (id: string) => WaitlistHoldId;
-export declare const asShipmentId: (id: string) => ShipmentId;
-export declare const asActivityLogEntryId: (id: string) => ActivityLogEntryId;
-export declare const asDemoBlueprintId: (id: string) => DemoBlueprintId;
-export declare const asDemoBlueprintVersionId: (id: string) => DemoBlueprintVersionId;
-export declare const asDemoInstanceId: (id: string) => DemoInstanceId;
-export declare const asDemoClaimId: (id: string) => DemoClaimId;
-export declare const asDemoLifecycleAuditEventId: (id: string) => DemoLifecycleAuditEventId;
-export declare const asDemoRuntimeId: (id: string) => DemoRuntimeId;
-export declare const asDemoCapability: (value: string) => DemoCapability;
-export declare const asDemoPaymentFlowId: (id: string) => DemoPaymentFlowId;
+export declare const unsafeAsBookingSessionId: (id: string) => BookingSessionId;
+export declare const unsafeAsEntitlementId: (id: string) => EntitlementId;
+export declare const unsafeAsSiteFontId: (id: string) => SiteFontId;
+export declare const unsafeAsUserId: (id: string) => UserId;
+export declare const unsafeAsFormId: (id: string) => FormId;
+export declare const unsafeAsFormSubmissionId: (id: string) => FormSubmissionId;
+export declare const unsafeAsPassId: (id: string) => PassId;
+export declare const unsafeAsMembershipId: (id: string) => MembershipId;
+export declare const unsafeAsCourseId: (id: string) => CourseId;
+export declare const unsafeAsCustomerId: (id: string) => CustomerId;
+export declare const unsafeAsOrderId: (id: string) => OrderId;
+export declare const unsafeAsOrderItemId: (id: string) => OrderItemId;
+export declare const unsafeAsCheckoutLineId: (id: string) => CheckoutLineId;
+export declare const unsafeAsAttendeeId: (id: string) => AttendeeId;
+export declare const unsafeAsCustomerPassId: (id: string) => CustomerPassId;
+export declare const unsafeAsCustomerMembershipId: (id: string) => CustomerMembershipId;
+export declare const unsafeAsEnrollmentId: (id: string) => EnrollmentId;
+export declare const unsafeAsAppointmentId: (id: string) => AppointmentId;
+export declare const unsafeAsAppointmentServiceId: (id: string) => AppointmentServiceId;
+export declare const unsafeAsAppointmentResourceId: (id: string) => AppointmentResourceId;
+export declare const unsafeAsStaffMemberId: (id: string) => StaffMemberId;
+export declare const unsafeAsBookingCalendarFeedTokenId: (id: string) => BookingCalendarFeedTokenId;
+export declare const unsafeAsBookingCalendarFeedTokenPublicId: (id: string) => BookingCalendarFeedTokenPublicId;
+export declare const unsafeAsBookingCalendarFeedTokenSecret: (value: string) => BookingCalendarFeedTokenSecret;
+export declare const unsafeAsBookingCalendarFeedTokenSecretHash: (value: string) => BookingCalendarFeedTokenSecretHash;
+export declare const unsafeAsContentEntryId: (id: string) => ContentEntryId;
+export declare const unsafeAsStripeInvoiceId: (id: string) => StripeInvoiceId;
+export declare const unsafeAsNewsletterSubscriberId: (id: string) => NewsletterSubscriberId;
+export declare const unsafeAsEmailAuditRowId: (id: string) => EmailAuditRowId;
+export declare const unsafeAsWaitlistEntryId: (id: string) => WaitlistEntryId;
+export declare const unsafeAsWaitlistHoldId: (id: string) => WaitlistHoldId;
+export declare const unsafeAsShipmentId: (id: string) => ShipmentId;
+export declare const unsafeAsActivityLogEntryId: (id: string) => ActivityLogEntryId;
+export declare const unsafeAsDemoBlueprintId: (id: string) => DemoBlueprintId;
+export declare const unsafeAsDemoBlueprintVersionId: (id: string) => DemoBlueprintVersionId;
+export declare const unsafeAsDemoInstanceId: (id: string) => DemoInstanceId;
+export declare const unsafeAsDemoClaimId: (id: string) => DemoClaimId;
+export declare const unsafeAsDemoLifecycleAuditEventId: (id: string) => DemoLifecycleAuditEventId;
+export declare const unsafeAsDemoRuntimeId: (id: string) => DemoRuntimeId;
+export declare const unsafeAsDemoCapability: (value: string) => DemoCapability;
+export declare const unsafeAsDemoPaymentFlowId: (id: string) => DemoPaymentFlowId;
 export declare const unsafeAsDemoClaimTtlHours: (value: number) => DemoClaimTtlHours;
-export declare const asGiftingOfferId: (id: string) => GiftingOfferId;
-export declare const asGiftingInstrumentId: (id: string) => GiftingInstrumentId;
-export declare const asBookingRequirementId: (id: string) => BookingRequirementId;
-export declare const asBookingRequirementEvidenceId: (id: string) => BookingRequirementEvidenceId;
-export declare const asBookingRequirementDocumentUploadId: (id: string) => BookingRequirementDocumentUploadId;
-export declare const asBookingRequirementEvidenceAttachmentId: (id: string) => BookingRequirementEvidenceAttachmentId;
-export declare const asParticipantId: (id: string) => ParticipantId;
-export declare const asParticipantParticipationId: (id: string) => ParticipantParticipationId;
-export declare const asParticipantRosterAssertionJobId: (id: string) => ParticipantRosterAssertionJobId;
-export declare const asParticipantBookingQuestionsTaskId: (id: string) => ParticipantBookingQuestionsTaskId;
-export declare const asEventAttendeeGuestId: (id: string) => EventAttendeeGuestId;
-export declare const asPersonRecordId: (id: string) => PersonRecordId;
-export declare const asEncounterRecordId: (id: string) => EncounterRecordId;
-export declare const asRecordEntryId: (id: string) => RecordEntryId;
-export declare const asProtectedPayloadKeyVersion: (id: string) => ProtectedPayloadKeyVersion;
+export declare const unsafeAsGiftingOfferId: (id: string) => GiftingOfferId;
+export declare const unsafeAsGiftingInstrumentId: (id: string) => GiftingInstrumentId;
+export declare const unsafeAsBookingRequirementId: (id: string) => BookingRequirementId;
+export declare const unsafeAsBookingRequirementEvidenceId: (id: string) => BookingRequirementEvidenceId;
+export declare const unsafeAsBookingRequirementDocumentUploadId: (id: string) => BookingRequirementDocumentUploadId;
+export declare const unsafeAsBookingRequirementEvidenceAttachmentId: (id: string) => BookingRequirementEvidenceAttachmentId;
+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;
+export declare const unsafeAsProtectedPayloadKeyVersion: (id: string) => ProtectedPayloadKeyVersion;
+export declare const parseSiteId: (value: unknown) => Result<SiteId, BrandedIdParseError>;
+export declare const parseOccurrenceId: (value: unknown) => Result<OccurrenceId, BrandedIdParseError>;
+export declare const parseTicketTypeId: (value: unknown) => Result<TicketTypeId, BrandedIdParseError>;
+export declare const parsePricingOptionId: (value: unknown) => Result<PricingOptionId, BrandedIdParseError>;
+export declare const parseUserId: (value: unknown) => Result<UserId, BrandedIdParseError>;
+export declare const parseProductId: (value: unknown) => Result<ProductId, BrandedIdParseError>;
+export declare const parseProductVariantId: (value: unknown) => Result<ProductVariantId, BrandedIdParseError>;
+export declare const parseProductCategoryId: (value: unknown) => Result<ProductCategoryId, BrandedIdParseError>;
+export declare const parseMediaAssetId: (value: unknown) => Result<MediaAssetId, BrandedIdParseError>;
+export declare const parseContentEntryId: (value: unknown) => Result<ContentEntryId, BrandedIdParseError>;
+export declare const parsePassId: (value: unknown) => Result<PassId, BrandedIdParseError>;
+export declare const parseMembershipId: (value: unknown) => Result<MembershipId, BrandedIdParseError>;
+export declare const parseCourseId: (value: unknown) => Result<CourseId, BrandedIdParseError>;
+export declare const parseAppointmentId: (value: unknown) => Result<AppointmentId, BrandedIdParseError>;
+export declare const parseAttendeeId: (value: unknown) => Result<AttendeeId, BrandedIdParseError>;
+export declare const parseCustomerId: (value: unknown) => Result<CustomerId, BrandedIdParseError>;
+export declare const parseCustomerMembershipId: (value: unknown) => Result<CustomerMembershipId, BrandedIdParseError>;
+export declare const parseEventSeriesId: (value: unknown) => Result<EventSeriesId, BrandedIdParseError>;
 export {};

package/dist/_dts/core/src/csv-cells.d.ts

@@ -0,0 +1,10 @@
+import type { CsvCell } from './csv-types';
+export declare const csvEmptyCell: () => CsvCell;
+export declare const csvTextCell: (value: string | null | undefined) => CsvCell;
+export declare const csvIntegerCell: (value: number | null | undefined) => CsvCell;
+export declare const csvDecimalCell: (value: number | null | undefined, decimals: number) => CsvCell;
+export declare const csvMoneyCentsCell: (cents: number | null | undefined, currency: string | null | undefined) => CsvCell;
+export declare const csvIsoDateCell: (value: string | null | undefined) => CsvCell;
+export declare const csvIsoDateTimeCell: (value: string | null | undefined) => CsvCell;
+export declare const csvBooleanCell: (value: boolean | null | undefined) => CsvCell;
+export declare function formatCsvCell(cell: CsvCell): string;

package/dist/_dts/core/src/csv-date-filter.d.ts

@@ -0,0 +1,27 @@
+import type { CsvExportDatePolicy, CsvExportId, ExportDateBasis, ExportDateFilterError, ExportDateRange, ResolvedExportDateWindow } from './csv-types';
+export type ResolveExportDateWindowInput = Readonly<{
+    exportId: CsvExportId;
+    policy: CsvExportDatePolicy;
+    range: ExportDateRange;
+    requestedBasis?: ExportDateBasis;
+    timeZone: string;
+    today?: Date;
+}>;
+export type ResolveExportDateWindowInputFor<Basis extends ExportDateBasis> = Readonly<{
+    exportId: CsvExportId;
+    policy: CsvExportDatePolicy<Basis>;
+    range: ExportDateRange;
+    requestedBasis?: Basis;
+    timeZone: string;
+    today?: Date;
+}>;
+export type ResolveExportDateWindowResult<Basis extends ExportDateBasis = ExportDateBasis> = Readonly<{
+    ok: true;
+    window: ResolvedExportDateWindow<Basis>;
+}> | Readonly<{
+    ok: false;
+    error: ExportDateFilterError;
+}>;
+export declare function resolveExportDateWindow<Basis extends ExportDateBasis>(input: ResolveExportDateWindowInputFor<Basis>): ResolveExportDateWindowResult<Basis>;
+export declare function resolveExportDateWindow(input: ResolveExportDateWindowInput): ResolveExportDateWindowResult;
+export declare function describeExportDateBasis(basis: ExportDateBasis): string;

package/dist/_dts/core/src/csv-escape.d.ts

@@ -0,0 +1 @@
+export declare function csvEscape(value: string): string;

package/dist/_dts/core/src/csv-filename.d.ts

@@ -0,0 +1,18 @@
+import type { SafeCsvFilename } from './csv-types';
+export type SafeCsvFilenameResult = Readonly<{
+    ok: true;
+    filename: SafeCsvFilename;
+}> | Readonly<{
+    ok: false;
+    filename: string;
+}>;
+export declare function toSafeCsvFilename(value: string): SafeCsvFilenameResult;
+export declare function assertSafeCsvFilename(value: string): SafeCsvFilename;
+export declare const unsafeCsvFilename: typeof assertSafeCsvFilename;
+export declare function csvFilenameDateRange(input: Readonly<{
+    from?: string | null;
+    to?: string | null;
+    fallback?: string | null;
+    prefix?: string | null;
+}>): string;
+export declare function contentDispositionForCsv(filename: SafeCsvFilename): string;