@riverbankcms/sdk 0.130.2 → 0.134.0

package/dist/_dts/api/src/navigation/types.d.ts

@@ -6,11 +6,12 @@
  * matcher, and dashboard management layers.
  */
 import type { DbRow } from '../../../db/src/index';
+import type { ResolvedInternalLinkEntityType } from '../../../blocks/src/index';
 export type InternalLinkRoutablePayload = {
     kind: 'internal';
     routeId: string;
     entityId: string;
-    entityType: 'page' | 'content';
+    entityType: ResolvedInternalLinkEntityType;
     href: string;
     title: string;
     typeLabel: string;
@@ -64,13 +65,9 @@ export type NavigationLinkInput = PageLinkPayload | EntryLinkPayload | {
     kind: 'url';
     href: string;
 } | PortalLinkPayload | CartLinkPayload;
-export type RoutableContentItem = {
+type RoutableContentItemBase = {
     routeId: string;
     entityId: string;
-    entityType: 'page' | 'content';
-    identifier: string | null;
-    contentTypeKey?: string | null;
-    contentTypeName?: string | null;
     title: string;
     draftTitle: string | null;
     path: string;
@@ -80,6 +77,25 @@ export type RoutableContentItem = {
     typeLabel: string;
     updatedAt: string | null;
 };
+export type PageRoutableContentItem = RoutableContentItemBase & {
+    entityType: 'page';
+    identifier: string | null;
+    contentTypeKey: 'page';
+    contentTypeName: 'Page';
+};
+export type EntryRoutableContentItem = RoutableContentItemBase & {
+    entityType: 'content';
+    identifier: string | null;
+    contentTypeKey: string;
+    contentTypeName: string | null;
+};
+export type PageSurfaceRoutableContentItem = RoutableContentItemBase & {
+    entityType: 'pageSurface';
+    identifier: null;
+    contentTypeKey: null;
+    contentTypeName: null;
+};
+export type RoutableContentItem = PageRoutableContentItem | EntryRoutableContentItem | PageSurfaceRoutableContentItem;
 export type SitemapRouteItem = {
     path: string;
     lastModified: string | null;
@@ -146,3 +162,4 @@ export interface NavigationItemInput {
     isCta?: boolean;
     children?: NavigationItemInput[];
 }
+export {};

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

@@ -23,7 +23,7 @@ export type { DashboardMoneyNavSurfaceId, DashboardShopNavSurfaceId, } from './n
 export type { ActionableNavigationMenuMatchPlan, NavigationMenuIdentifier, NavigationMenuIdentifierParseError, NavigationMenuIdentity, NavigationMenuIdentityInput, NavigationMenuMatchCandidate, NavigationMenuMatchFailure, NavigationMenuMatchInput, NavigationMenuMatchPlan, } from './navigation/identity';
 export { linkPayloadToValue, linkValueToPayload, toInternalLinkValue, toPersistableNavigationLinkValue, } from './navigation/linkValue';
 export type { PersistableNavigationLinkError, PersistableNavigationLinkResult, PersistableNavigationLinkValue, } from './navigation/linkValue';
-export type { CartLinkLabelConfig, CartLinkPayload, EntryLinkPayload, InternalLinkRoutablePayload, LinkResolutionOptions, LinkPayload, NavigationLinkInput, NavigationUrlType, PageLinkPayload, PortalLinkPayload, ResolvedNavigationLink, RoutableContentItem, SitemapRouteItem, } from './navigation/types';
+export type { CartLinkLabelConfig, CartLinkPayload, EntryLinkPayload, InternalLinkRoutablePayload, PageRoutableContentItem, EntryRoutableContentItem, PageSurfaceRoutableContentItem, LinkResolutionOptions, LinkPayload, NavigationLinkInput, NavigationUrlType, PageLinkPayload, PortalLinkPayload, ResolvedNavigationLink, RoutableContentItem, SitemapRouteItem, } from './navigation/types';
 export { matchNavigationItems } from './navigation/matcher';
 export type { ItemMatch, MatchResult } from './navigation/matcher';
 export type { EntryNavLinkInfo, NavigationItemForMatching, NavigationItemInput, NavigationReferenceMaps, PageNavLinkInfo, } from './navigation/types';

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

@@ -0,0 +1,15 @@
+import type { BookingPaymentTermsConfig, BookingPricing, PublicBookingPaymentTermsAvailability } from "./bookingConfig";
+import type { BookingConsent } from "../../core/src/index";
+export type PublicBookingService = {
+    id: string;
+    siteId: string;
+    title: string;
+    description: string | null;
+    durationMinutes: number;
+    pricing?: BookingPricing;
+    priceAmount: number | null;
+    priceCurrency: string | null;
+    paymentTerms: BookingPaymentTermsConfig;
+    paymentTermsAvailability: PublicBookingPaymentTermsAvailability;
+    consent?: BookingConsent;
+};

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

@@ -0,0 +1,11 @@
+export declare const PUBLIC_EVENT_ENDPOINT_DEFINITIONS: {
+    resolveEventSubroute: {
+        path: "/public/sites/{siteId}/events/subroutes/resolve";
+        method: "GET";
+        revalidate: 60;
+        tags: ("riverbank:site:{siteId}:public-events" | "event-subroute")[];
+        auth: "public";
+        responseKind: "json";
+        errors: never[];
+    };
+};

package/dist/_dts/api/src/publicExperience/eventEndpoints.d.ts

@@ -4,9 +4,10 @@
  * Merged into `PublicExperienceAPIEndpoints` by `../publicExperienceEndpoints`.
  */
 import type { APIEndpoint } from '../apiEndpointTypes';
-import type { PublicEventBookingAvailability, PublicEventPricing } from '../../../core/src/index';
+import type { BookingConsent, PublicEventBookingAvailability, PublicEventPricing } from '../../../core/src/index';
 import type { PublicEventDestination } from '../event-listing-destination';
-import type { BookingPaymentTermsConfig, BookingPricing, DirectCheckoutCollectionOptionKind, EventAttendanceMode, EventDeliveryMode, EventPricingMode, EventPreset, PublicEventEligibilityTicketTypeRecord, PublicEventTicketTypeRecord } from '../bookingConfig';
+import type { BookingPaymentTermsConfig, BookingPricing, DirectCheckoutCollectionOptionKind, EventAttendanceMode, EventDeliveryMode, EventPricingMode, PublicEventEligibilityTicketTypeRecord, PublicEventTicketTypeRecord } from '../bookingConfig';
+import type { EventPreset } from '../../../core/src/index';
 import type { PublicTeamMemberSummary } from '../teamMembers';
 import type { EventTicketLineSummaryResponse, EventTicketSelectionRequest, PublicEventLoaderParams, PublicEventRecurrence, PublicEventScheduleScope } from './sharedTypes';
 export type PublicEventAPIEndpoints = {
@@ -89,6 +90,7 @@ export type PublicEventAPIEndpoints = {
         status?: 'active' | 'draft' | 'cancelled' | 'completed' | 'archived';
         pricing: PublicEventPricing<PublicEventTicketTypeRecord>;
         paymentTerms: BookingPaymentTermsConfig;
+        consent: BookingConsent | null;
         accessRestriction: 'none' | 'category';
         allowedCategoryIds: string[];
         requireGuestDetails?: boolean;
@@ -130,20 +132,32 @@ export type PublicEventAPIEndpoints = {
             upcomingCount: number;
         }>;
     }>;
-    resolveEventOccurrence: APIEndpoint<never, {
+    resolveEventSubroute: APIEndpoint<never, {
         siteId: string;
-        eventSeriesIds: string;
+        kind: 'event-occurrence' | 'event-run';
+        subjectKind: 'eventOffering' | 'eventSeries';
+        subjectId: string;
         segment: string;
     }, {
-        occurrence: {
-            id: string;
-            seriesId: string;
-            startsAt: string;
-            endsAt: string;
-            timeZone: string;
-            status: string;
-            capacityOverride: number | null;
-            overridesJson: Record<string, unknown>;
+        subroute: {
+            kind: 'event-occurrence';
+            occurrence: {
+                id: string;
+                seriesId: string;
+                startsAt: string;
+                endsAt: string;
+                timeZone: string;
+                status: string;
+                capacityOverride: number | null;
+                overridesJson: Record<string, unknown>;
+            };
+        } | {
+            kind: 'event-run';
+            run: {
+                seriesId: string;
+                identifier: string;
+                name: string | null;
+            };
         } | null;
     }>;
     registerForEvent: APIEndpoint<{
@@ -156,6 +170,7 @@ export type PublicEventAPIEndpoints = {
         phone?: string;
         notes?: string;
         formData?: Record<string, unknown>;
+        consentAccepted?: boolean;
         altchaSolution?: string | null;
         paymentMethod?: 'free' | 'pass' | 'membership' | 'stripe' | 'pass_bundle' | 'membership_bundle';
         customerPassId?: string;

package/dist/_dts/api/src/publicExperience/sharedTypes.d.ts

@@ -33,6 +33,8 @@ export type PublicEventLoaderParams = {
     eventPresets?: string;
     scheduleScope?: string;
     seriesId?: string;
+    seriesIds?: string;
+    runSeriesId?: string;
     seriesSlug?: string;
     includeOccurrenceId?: string;
     detailLevel?: string;

package/dist/_dts/api/src/publicExperience/wholeSeriesEndpoints.d.ts

@@ -12,6 +12,7 @@ export type PublicWholeSeriesAPIEndpoints = {
     listPublicWholeSeriesOfferings: APIEndpoint<never, {
         siteId: string;
         limit?: string;
+        eventSeriesIds?: string;
         stage?: string;
     }, Array<{
         eventSeriesId: string;
@@ -59,6 +60,7 @@ export type PublicWholeSeriesAPIEndpoints = {
         name: string;
         phone?: string;
         formData?: Record<string, unknown>;
+        consentAccepted?: boolean;
         altchaSolution?: string | null;
         paymentMethod?: 'free' | 'membership';
         customerMembershipId?: string;
@@ -126,6 +128,7 @@ export type PublicWholeSeriesAPIEndpoints = {
         name: string;
         phone?: string;
         formData?: Record<string, unknown>;
+        consentAccepted?: boolean;
         altchaSolution?: string | null;
         discountCode?: string;
         successUrl: string;

package/dist/_dts/api/src/sdk-event-upsert.d.ts

@@ -19,18 +19,18 @@ export declare const sdkEventUpsertOptionalFieldSchemas: {
         cancelled: "cancelled";
     }>>;
     readonly visibility: z.ZodOptional<z.ZodEnum<{
-        public: "public";
         private: "private";
+        public: "public";
         unlisted: "unlisted";
     }>>;
     readonly preset: z.ZodOptional<z.ZodEnum<{
         course: "course";
         event: "event";
-        term: "term";
-        performance: "performance";
         class: "class";
+        term: "term";
         workshop: "workshop";
         retreat: "retreat";
+        performance: "performance";
     }>>;
     readonly bookingScope: z.ZodOptional<z.ZodEnum<{
         single_occurrence: "single_occurrence";

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

@@ -0,0 +1,29 @@
+import type { ConfiguredSiteVerticalBookingConfig, SiteVerticalConfigIssue } from '../../core/src/index';
+import type { BookingSettingsCommandWarning } from '@riverbankcms/site-commands';
+import type { SdkCommandApplicationResult } from './sdkContracts';
+/** A non-fatal warning emitted when a historical booking config cannot be read. */
+export type SdkPullSettingsWarning = Readonly<{
+    code: 'invalid_booking_vertical_config';
+    issues: readonly SiteVerticalConfigIssue[];
+}>;
+type SdkConfigureBookingVerticalRequestBase = Readonly<{
+    verticalConfig: ConfiguredSiteVerticalBookingConfig;
+}>;
+/**
+ * Preview may establish the first observed revision. Apply must always carry
+ * that observation; `null` means the caller observed no persisted row.
+ */
+export type SdkConfigureBookingVerticalRequest = Readonly<SdkConfigureBookingVerticalRequestBase & {
+    mode: 'preview';
+    expectedRevision?: string | null;
+}> | Readonly<SdkConfigureBookingVerticalRequestBase & {
+    mode: 'apply';
+    expectedRevision: string | null;
+}>;
+export type SdkConfigureBookingVerticalResponse = SdkCommandApplicationResult<Readonly<{
+    verticalConfig: ConfiguredSiteVerticalBookingConfig;
+    revision: string | null;
+}>> & Readonly<{
+    warnings?: readonly BookingSettingsCommandWarning[];
+}>;
+export {};

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

@@ -8,9 +8,14 @@ import type { SdkEventPricing, SdkEventPricingInput } from './sdk-event-pricing'
 import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from './sdk-event-payment-terms';
 import type { SdkPullEventOccurrence } from './sdk-event-schedule';
 import type { SiteCommandApplicationResult } from '@riverbankcms/site-commands';
-import type { EventPreset } from './bookingConfig';
+import type { EventPreset } from '../../core/src/index';
 import type { SdkThemeWire } from './sdkThemeWire';
+import type { SdkCatalogButtonStyleControl } from './sdkThemeCatalogContracts';
+export type { SdkCatalogButtonRole, SdkCatalogButtonStyleControl, } from './sdkThemeCatalogContracts';
 import type { SdkPullEventCategory } from './sdkEventCategoryContracts';
+import type { SdkPullSettings } from './sdkSettingsContracts';
+export type { SdkConfigureBookingVerticalRequest, SdkConfigureBookingVerticalResponse, SdkPullSettingsWarning, } from './sdkBookingVerticalContracts';
+export type { SdkPullSettings, SdkPullSettingsResponse } from './sdkSettingsContracts';
 export type { SdkPullEventCategory } from './sdkEventCategoryContracts';
 import type { SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun } from './sdkManagedEventContracts';
 export type { SdkEventOccurrenceDeletionEligibility, SdkEventOccurrenceProvenance, SdkManagementEvent, SdkManagementEventOccurrence, SdkManagementEventRun, } from './sdkManagedEventContracts';
@@ -275,7 +280,7 @@ export interface SdkBackfillIdentifiersResult {
 export interface ManagementMediaAsset {
     id: string;
     siteId: string;
-    identifier: string | null;
+    identifier: string;
     storageBucket: string;
     storagePath: string;
     filename: string;
@@ -301,7 +306,7 @@ export interface SdkMediaFinalizeUploadResponse {
     storagePath: string;
     status: 'created' | 'exists';
     assetId: string;
-    identifier: string | null;
+    identifier: string;
 }
 export interface SdkPullMeta {
     pulledAt: string;
@@ -491,26 +496,6 @@ export interface SdkPullNavigationResponse {
     menus: SdkPullNavigationMenu[];
     meta: SdkPullMeta;
 }
-export interface SdkPullSettings {
-    /** Site title (stored on `sites.title`). Present on pull; writable via PATCH. */
-    siteTitle?: string;
-    homepageId: string | null;
-    seoDefaults: {
-        title?: string;
-        description?: string;
-        ogImage?: string;
-        allowIndexingInProduction?: boolean;
-    } | null;
-    logoIdentifier?: string | null;
-    faviconIdentifier?: string | null;
-}
-export interface SdkPullSettingsResponse {
-    settings: SdkPullSettings;
-    warnings?: string[];
-    meta: SdkPullMeta & {
-        updatedAt: string | null;
-    };
-}
 export interface SdkPullFormField {
     id: string;
     label: string;
@@ -600,15 +585,7 @@ export interface SdkCatalogButtonStyle {
     accessibilityLabel: string;
     tags: Record<string, string>;
     defaultParameters: Record<string, unknown>;
-    controls: Array<{
-        kind: 'choice';
-        parameter: string;
-        label: string;
-        options: Array<{
-            value: string;
-            label: string;
-        }>;
-    }>;
+    controls: SdkCatalogButtonStyleControl[];
 }
 export interface SdkCatalogPalette {
     /** Human-readable source alias. */

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

@@ -0,0 +1,23 @@
+/** SDK management endpoints that do not belong to a CRUD resource family. */
+export declare const SDK_ENDPOINT_DEFINITIONS: {
+    sdkUpdateSettings: {
+        path: "/sdk/{siteId}/settings";
+        method: "PATCH";
+        auth: "service";
+        responseKind: "json";
+        errors: ("validation:invalid_input" | "server:internal_error")[];
+    };
+    sdkConfigureBookingVertical: {
+        path: "/sdk/{siteId}/settings/booking/vertical";
+        method: "POST";
+        auth: "service";
+        responseKind: "json";
+    };
+    sdkSetupRevalidationWebhook: {
+        path: "/sdk/{siteId}/webhooks/revalidation/setup";
+        method: "POST";
+        auth: "service";
+        responseKind: "json";
+        errors: ("validation:invalid_input" | "server:internal_error")[];
+    };
+};

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

@@ -0,0 +1,25 @@
+import type { ConfiguredSiteVerticalBookingConfig } from '../../core/src/index';
+import type { SdkPullMeta } from './sdkContracts';
+import type { SdkPullSettingsWarning } from './sdkBookingVerticalContracts';
+export interface SdkPullSettings {
+    /** Site title (stored on `sites.title`). Present on pull; writable via PATCH. */
+    siteTitle?: string;
+    homepageId: string | null;
+    seoDefaults: {
+        title?: string;
+        description?: string;
+        ogImage?: string;
+        allowIndexingInProduction?: boolean;
+    } | null;
+    logoIdentifier?: string | null;
+    faviconIdentifier?: string | null;
+    /** Optional, configured booking vertical for SDK-owned booking surfaces. */
+    verticalConfig?: ConfiguredSiteVerticalBookingConfig;
+}
+export interface SdkPullSettingsResponse {
+    settings: SdkPullSettings;
+    warnings?: readonly (string | SdkPullSettingsWarning)[];
+    meta: SdkPullMeta & {
+        updatedAt: string | null;
+    };
+}

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

@@ -0,0 +1,20 @@
+import type { VariantRole } from '../../theme-core/src/buttons/index';
+export type SdkCatalogButtonRole = VariantRole;
+export type SdkCatalogButtonStyleControl = Readonly<{
+    kind: 'choice';
+    parameter: string;
+    label: string;
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+}> | Readonly<{
+    kind: 'button-hover-by-role';
+    parameter: string;
+    label: string;
+    roles: SdkCatalogButtonRole[];
+    options: Array<{
+        value: string;
+        label: string;
+    }>;
+}>;