@riverbankcms/sdk 0.129.0 → 0.130.0

package/dist/_dts/sdk/src/client/management/types.d.ts

@@ -1,1069 +0,0 @@
-/**
- * Management Client Types
- *
- * Type definitions for the SDK management client used for write operations.
- */
-import type { LinkPayload, NavigationLinkInput } from '../../public-api/contracts';
-import type { APIEndpoints } from '../../../../api/src/index';
-import type { SiteCommandOf } from '../../../../site-commands/src/index';
-import type { SdkEventPricing, SdkEventPricingInput, SdkEventTicketTypeInput } from '../../../../api/src/sdk-event-pricing';
-import type { SdkEventPaymentTerms, SdkEventPaymentTermsInput } from '../../../../api/src/sdk-event-payment-terms';
-import type { SdkEventUpsertBody } from '../../../../api/src/sdk-event-upsert';
-import type { SdkAddEventOccurrenceRequest, SdkEventOccurrenceCapacityIntent, SdkEventOccurrenceScheduleInput, SdkManagementEventOccurrence, SdkManagementEventSeries, SdkFooterContent, SdkPullEventSeries } from '../../../../api/src/sdkContracts';
-import type { SdkPullTruncationMeta } from '../../../../api/src/sdkContracts';
-import type { SdkCapabilitiesResponse, SdkCatalogBlocksResponse, SdkCatalogContentTypesResponse, SdkCatalogThemeResponse, SdkDemoContentResponse } from '../../../../api/src/sdkContracts';
-import type { SdkEntryPublishErrorCode, SdkPagePublishErrorCode, SdkPublicationOutcome } from '../../../../api/src/sdkContracts';
-import type { ButtonStyleSelection } from '../../../../theme-core/src/buttons/index';
-import type { Theme } from '../../contracts';
-import type { RichTextDoc } from '../../../../core/src/index';
-export type SdkDeletePageResponse = NonNullable<APIEndpoints['sdkDeletePage']['response']>;
-export type SdkGetPageBlockResponse = NonNullable<APIEndpoints['sdkGetPageBlock']['response']>;
-export type SdkPatchPageBlockBody = NonNullable<APIEndpoints['sdkPatchPageBlock']['body']>;
-export type SdkPatchPageBlockResponse = NonNullable<APIEndpoints['sdkPatchPageBlock']['response']>;
-export type SdkPullEntriesAllResponse = NonNullable<APIEndpoints['sdkPullEntriesAll']['response']>;
-export type SdkUpsertEntryResponse = NonNullable<APIEndpoints['sdkUpsertEntry']['response']>;
-export type SdkUpsertPageResponse = NonNullable<APIEndpoints['sdkUpsertPage']['response']>;
-export interface ManagementClientConfig {
-    /**
-     * Dashboard URL (e.g., http://localhost:4000 or https://dashboard.riverbankcms.com)
-     */
-    dashboardUrl: string;
-    /**
-     * Management API key (format: bld_mgmt_sk_...)
-     */
-    managementApiKey: string;
-    /**
-     * Site ID to operate on
-     */
-    siteId: string;
-    /**
-     * Request timeout in milliseconds
-     * @default 30000
-     */
-    timeout?: number;
-}
-export interface ManagementEntry {
-    id: string;
-    identifier: string;
-    contentType: string;
-    /** Slug for URL routing - only present for routable content types */
-    slug?: string;
-    title: string;
-    data: Record<string, unknown>;
-    publishedData: Record<string, unknown> | null;
-    status: 'draft' | 'published';
-    hasUnpublishedChanges: boolean;
-    createdAt: string;
-    updatedAt: string;
-    publishedAt: string | null;
-    manualOrder: number;
-    blocks?: EntrySlotBlocks;
-}
-export interface EntrySlotBlock {
-    identifier: string | null;
-    kind: string;
-    content: Record<string, unknown>;
-}
-export type EntrySlotBlocks = Record<string, EntrySlotBlock[]>;
-export interface EntrySlotBlockInput {
-    identifier?: string | null;
-    kind: string;
-    content: Record<string, unknown>;
-}
-export type EntrySlotBlocksInput = Record<string, EntrySlotBlockInput[]>;
-export interface EntryUpsertInput {
-    identifier: string;
-    contentType: string;
-    data: Record<string, unknown>;
-    slug?: string;
-    manualOrder?: number;
-    blocks?: EntrySlotBlocksInput;
-    /**
-     * Publication intent. 'draft' (default) writes a draft only; 'publish' runs
-     * the publish operation after a successful save. Save and publish are not
-     * atomic — a publish that fails after a successful save is reported in-band on
-     * the response, not as an error.
-     */
-    publication?: 'draft' | 'publish';
-}
-/**
- * The entry shape upsert responses carry — the wire envelope omits
- * `publishedData` (the caller just wrote the draft; fetch with `get` when the
- * published side is needed).
- */
-export type UpsertedManagementEntry = Omit<ManagementEntry, 'publishedData'>;
-/**
- * Result of an entry upsert with `publication: 'publish'`. The promise resolves
- * even when the publish stage failed — the save succeeded and the entry exists
- * as a draft; branch on `publication.published`.
- */
-export interface EntryPublishUpsertResult {
-    entry: UpsertedManagementEntry;
-    publication: SdkPublicationOutcome<SdkEntryPublishErrorCode>;
-}
-export interface ManagementPage {
-    id: string;
-    identifier: string | null;
-    title: string;
-    path: string;
-    status: 'draft' | 'published';
-    hasUnpublishedChanges: boolean;
-    createdAt: string;
-    updatedAt: string;
-    publishedAt: string | null;
-}
-export interface PageUpsertInput {
-    identifier: string;
-    title: string;
-    path: string;
-    seoTitle?: string;
-    seoDescription?: string;
-    /**
-     * Publication intent. 'draft' (default) writes a draft only; 'publish' runs
-     * page publish after a successful save. Save and publish are non-atomic; a
-     * publish failure after a successful save is reported in-band, not as an error.
-     */
-    publication?: 'draft' | 'publish';
-}
-/**
- * Result of a page upsert with `publication: 'publish'`. Resolves even when the
- * publish stage failed — the save succeeded; branch on `publication.published`.
- */
-export interface PagePublishUpsertResult {
-    page: ManagementPage;
-    publication: SdkPublicationOutcome<SdkPagePublishErrorCode>;
-}
-export interface ManagementBlock {
-    id: string;
-    identifier: string | null;
-    kind: string;
-    position: number;
-    data: Record<string, unknown>;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface BlockUpsertInput {
-    identifier: string;
-    kind: string;
-    data: Record<string, unknown>;
-    position?: number;
-}
-export interface ManagementNavigationMenu {
-    id: string;
-    identifier: string | null;
-    name: string;
-    isPrimary: boolean;
-    isFooter: boolean;
-    footerRole: 'main' | 'legal-policy' | null;
-    items: ManagementNavigationItem[];
-    createdAt: string;
-    updatedAt: string;
-}
-export interface ManagementNavigationItem {
-    id: string;
-    label: string;
-    link: LinkPayload | null;
-    /** Whether this item should render as a CTA-style navigation action. */
-    isCta?: boolean;
-    position: number;
-    children?: ManagementNavigationItem[];
-    /** Resolved identifier for internal links (populated on pull) */
-    resolvedIdentifier?: string | null;
-    /** Resolved content type key for entry links (populated on pull) */
-    resolvedContentType?: string | null;
-}
-export interface PulledNavigationItem {
-    id: string;
-    menuId: string;
-    label: string;
-    link: LinkPayload | null;
-    /** Whether this item should render as a CTA-style navigation action. */
-    isCta?: boolean;
-    position: number;
-    parentId: string | null;
-    children?: PulledNavigationItem[];
-    /** Resolved identifier for internal links (populated on pull) */
-    resolvedIdentifier?: string | null;
-    /** Resolved content type key for entry links (populated on pull) */
-    resolvedContentType?: string | null;
-}
-export interface PulledNavigationMenu {
-    id: string;
-    siteId: string;
-    identifier: string | null;
-    name: string;
-    isPrimary: boolean;
-    isFooter: boolean;
-    footerRole: 'main' | 'legal-policy' | null;
-    items: PulledNavigationItem[];
-    createdAt: string;
-    updatedAt: string;
-}
-export interface NavigationMenuUpsertInput {
-    identifier?: string;
-    name: string;
-    isPrimary?: boolean;
-    isFooter?: boolean;
-    footerRole?: 'main' | 'legal-policy' | null;
-    items: NavigationItemInput[];
-}
-export interface NavigationItemInput {
-    label: string;
-    /** Link configuration. Required for non-dropdown items. */
-    link?: NavigationLinkInput;
-    /** Whether this item should render as a CTA-style navigation action. */
-    isCta?: boolean;
-    children?: NavigationItemInput[];
-}
-export interface ManagementSettings {
-    homepageId: string | null;
-    seoDefaults: {
-        title?: string;
-        description?: string;
-        ogImage?: string;
-        allowIndexingInProduction?: boolean;
-    } | null;
-    logoIdentifier?: string | null;
-    faviconIdentifier?: string | null;
-}
-export interface SettingsUpdateInput {
-    homepageId?: string | null;
-    seoDefaults?: {
-        title?: string;
-        description?: string;
-        ogImage?: string;
-        allowIndexingInProduction?: boolean;
-    } | null;
-    logoIdentifier?: string | null;
-    faviconIdentifier?: string | null;
-}
-export interface ManagementWebhookEndpoint {
-    id: string;
-    name: string;
-    url: string;
-    events: string[];
-    enabled: boolean;
-    hasSecret: boolean;
-    createdAt: string;
-    updatedAt: string;
-    siteId: string;
-    failureCount: number;
-    lastFailureAt: string | null;
-    lastSuccessAt: string | null;
-    lastTriggeredAt: string | null;
-}
-export interface SetupRevalidationWebhookInput {
-    url: string;
-    name?: string;
-    rotateSecret?: boolean;
-    dryRun?: boolean;
-    vercel?: boolean;
-}
-export interface RevalidationWebhookPlannedEndpoint {
-    name: string;
-    url: string;
-    events: string[];
-    enabled: boolean;
-    rotateSecret: boolean;
-}
-export type SetupRevalidationWebhookResult = {
-    dryRun: true;
-    action: 'would_create' | 'would_update' | 'would_rotate' | 'would_leave_unchanged';
-    endpoint: ManagementWebhookEndpoint | null;
-    plannedEndpoint: RevalidationWebhookPlannedEndpoint;
-    message: string;
-    checklist: string[];
-} | {
-    dryRun: false;
-    action: 'created' | 'rotated';
-    endpoint: ManagementWebhookEndpoint;
-    plannedEndpoint: RevalidationWebhookPlannedEndpoint;
-    secret: string;
-    message: string;
-    checklist: string[];
-} | {
-    dryRun: false;
-    action: 'updated' | 'unchanged';
-    endpoint: ManagementWebhookEndpoint;
-    plannedEndpoint: RevalidationWebhookPlannedEndpoint;
-    message: string;
-    checklist: string[];
-};
-/**
- * Form field definition.
- */
-export interface ManagementFormField {
-    id: string;
-    label: string;
-    type: string;
-    required?: boolean;
-    placeholder?: string;
-    helpText?: string;
-    layout?: {
-        width?: 'full' | 'half';
-    };
-    options?: Array<{
-        value: string;
-        label: string;
-    }>;
-    multiple?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    min?: number;
-    max?: number;
-}
-/**
- * Form schema structure containing field definitions.
- */
-export interface ManagementFormSchema {
-    version?: string;
-    fields: ManagementFormField[];
-}
-/**
- * Form settings - generic object to support all form types.
- */
-export type ManagementFormSettings = Record<string, unknown>;
-/**
- * Form entity for SDK management operations.
- */
-export interface ManagementForm {
-    id: string;
-    slug: string;
-    name: string;
-    schema: ManagementFormSchema;
-    settings: ManagementFormSettings;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Input for creating or updating a form.
- */
-export interface FormUpsertInput {
-    slug: string;
-    name: string;
-    schema: ManagementFormSchema;
-    settings?: ManagementFormSettings;
-}
-/**
- * Venue address structure.
- */
-export interface VenueAddress {
-    line1?: string;
-    line2?: string;
-    city?: string;
-    region?: string;
-    postcode?: string;
-    country?: string;
-}
-/**
- * Venue location coordinates.
- */
-export interface VenueLocation {
-    lat?: number;
-    lng?: number;
-}
-/**
- * Venue entity for SDK management operations.
- */
-export interface ManagementVenue {
-    id: string;
-    slug: string;
-    title: string;
-    description: string | null;
-    timezone: string | null;
-    capacity: number | null;
-    address: VenueAddress;
-    location: VenueLocation | null;
-    mapEmbed: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Input for creating or updating a venue.
- */
-export interface VenueUpsertInput {
-    slug: string;
-    title: string;
-    description?: string | null;
-    timezone?: string | null;
-    capacity?: number | null;
-    address?: VenueAddress;
-    location?: VenueLocation | null;
-    mapEmbed?: string | null;
-}
-/**
- * Event category entity for SDK management operations.
- */
-export interface ManagementEventCategory {
-    id: string;
-    identifier: string;
-    name: string;
-    description: string | null;
-    color: string | null;
-    sortOrder: number;
-    createdAt: string;
-    updatedAt: string;
-}
-/**
- * Input for creating or updating an event category.
- */
-export interface EventCategoryUpsertInput {
-    identifier: string;
-    name: string;
-    description?: string | null;
-    color?: string | null;
-    sortOrder?: number;
-}
-/**
- * Schedule configuration for an event series.
- */
-export interface EventSchedule {
-    recurrenceRule: string | null;
-    /** Date used for the first occurrence; required for one-off SDK-managed events. */
-    startDate?: string | null;
-    defaultStartTime: string;
-    durationMinutes: number;
-}
-export interface EventStartEndSchedule {
-    /** Start/end schedules are currently supported for one-off SDK-managed events only. */
-    recurrenceRule?: null;
-    /** ISO datetime. Local datetime strings are treated as event-local wall time by the API. */
-    startsAt: string;
-    /** ISO datetime. Must be after startsAt and no more than the shared event duration maximum. */
-    endsAt: string;
-    durationMinutes?: never;
-}
-export interface EventStartDurationSchedule {
-    /** Start/duration schedules are currently supported for one-off SDK-managed events only. */
-    recurrenceRule?: null;
-    /** ISO datetime. Local datetime strings are treated as event-local wall time by the API. */
-    startsAt: string;
-    /** Must be no more than the shared event duration maximum. */
-    durationMinutes: number;
-    endsAt?: never;
-}
-export type EventScheduleUpsertInput = EventSchedule | EventStartEndSchedule | EventStartDurationSchedule;
-export type EventTicketTypeInput = SdkEventTicketTypeInput;
-/**
- * Pricing configuration for an event series.
- */
-export type EventPricing = SdkEventPricing;
-export type EventPricingInput = SdkEventPricingInput;
-export type EventPaymentTerms = SdkEventPaymentTerms;
-export type EventPaymentTermsInput = SdkEventPaymentTermsInput;
-/**
- * Event content data (embedded from content_entry).
- */
-export interface EventContent {
-    summary?: string;
-    body?: string | RichTextDoc;
-    image?: Record<string, unknown> & {
-        identifier: string;
-    };
-    [key: string]: unknown;
-}
-export type ManagementEventSeries = SdkManagementEventSeries;
-export type ManagementEventOccurrence = SdkManagementEventOccurrence;
-export type EventOccurrenceScheduleInput = SdkEventOccurrenceScheduleInput;
-export type AddEventOccurrenceInput = SdkAddEventOccurrenceRequest;
-export type EventOccurrenceCapacityIntent = SdkEventOccurrenceCapacityIntent;
-export type EventSeriesUpsertInput = SdkEventUpsertBody;
-export interface ManagementMediaAsset {
-    id: string;
-    siteId: string;
-    identifier: string | null;
-    storageBucket: string;
-    storagePath: string;
-    filename: string;
-    mimeType: string;
-    width: number | null;
-    height: number | null;
-    bytes: number | null;
-    checksumSha256: string | null;
-    createdAt: string;
-    updatedAt: string;
-}
-export interface MediaResolveResponse {
-    assets: ManagementMediaAsset[];
-    missingIdentifiers: string[];
-    missingAssetIds: string[];
-}
-/**
- * Explicitly separates an existing-theme update from first-theme provisioning.
- * Initialization never accepts a separately authoritative Theme payload.
- */
-export type ThemeUpsertInput = NonNullable<APIEndpoints['sdkUpsertTheme']['body']>;
-/** Updates an existing theme selection with a caller-supplied theme. */
-export type ThemeUpsertUpdateInput = Extract<ThemeUpsertInput, {
-    kind: 'update';
-}>;
-/** Creates the first theme by compiling this complete style-selection command. */
-export type ThemeUpsertInitializeInput = Extract<ThemeUpsertInput, {
-    kind: 'initialize';
-}>;
-/**
- * Response from theme upsert operation.
- */
-export interface ThemeUpsertResult {
-    themeId: string;
-    selectionId: string;
-    savedAt: string;
-}
-export type SiteStyleSelectionApplyCommand = SiteCommandOf<'applySiteStyleSelection'>;
-export type SiteStyleSelectionApplyCommandInput = SiteStyleSelectionApplyCommand['input'];
-/**
- * Public SDK delta contract. `siteStyleRef` is command orchestration identity;
- * semantic style changes live only in the `changes` batch.
- */
-export type ThemeStyleSelectionApplyInput = Omit<SiteStyleSelectionApplyCommandInput, 'changes'> & Readonly<{
-    siteStyleRef: string;
-    baseSelectionVersion: number;
-    selectionId?: string | null;
-    changes: readonly [
-        SiteStyleSelectionApplyCommandInput['changes'][number],
-        ...SiteStyleSelectionApplyCommandInput['changes'][number][]
-    ];
-}>;
-export interface ThemeStyleSelectionApplyResult {
-    success: boolean;
-    themeId: string;
-    selectionId: string;
-    selectionVersion: number;
-    selectionUpdatedAt: string | null;
-    savedAt: string;
-    theme: Theme;
-    siteStyleId: string;
-    buttonStyleSelection: ButtonStyleSelection;
-    headerLookId: string | null;
-    headerLayoutId: string | null;
-    headerStyleId: string | null;
-    footerLookId: string | null;
-}
-/**
- * Footer content for SDK management operations.
- * The footer sync boundary carries the complete composition and its optimistic
- * concurrency revision.
- */
-export type FooterContent = ManagementFooterContent;
-/**
- * Footer content as returned from CMS.
- */
-export type ManagementFooterContent = SdkFooterContent;
-/**
- * Input for upserting footer content.
- */
-export type FooterContentUpsertInput = NonNullable<APIEndpoints['sdkUpsertFooter']['body']>;
-export interface PulledFooter {
-    footer: ManagementFooterContent | null;
-    meta: {
-        pulledAt: string;
-        updatedAt: string | null;
-    };
-}
-export interface PulledEntries {
-    contentType: string;
-    entries: Array<{
-        identifier: string;
-        data: Record<string, unknown>;
-        status: 'draft' | 'published';
-        hasUnpublishedChanges: boolean;
-        /** Slug for URL routing - only present for routable content types */
-        slug?: string;
-        /**
-         * Canonical entry title (route title for routable content types).
-         */
-        title: string;
-        manualOrder?: number;
-        blocks?: EntrySlotBlocks;
-    }>;
-    meta: {
-        pulledAt: string;
-        manualOrder?: string[];
-        entries: Record<string, {
-            createdAt: string;
-            updatedAt: string;
-            publishedAt: string | null;
-        }>;
-        truncation?: SdkPullTruncationMeta;
-    };
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        hasMore: boolean;
-    };
-}
-export interface PulledPages {
-    pages: Array<{
-        id: string;
-        identifier: string;
-        title: string;
-        path: string;
-        status: 'draft' | 'published';
-        hasUnpublishedChanges: boolean;
-        updatedAt: string;
-        createdAt: string;
-        publishedAt: string | null;
-        blocks: Array<{
-            id: string;
-            identifier: string;
-            kind: string;
-            position: number;
-            data: Record<string, unknown>;
-            createdAt: string;
-            updatedAt: string;
-        }>;
-    }>;
-    meta: {
-        pulledAt: string;
-    };
-}
-export interface PulledNavigation {
-    menus: PulledNavigationMenu[];
-    meta: {
-        pulledAt: string;
-    };
-}
-/**
- * Cross-type overview of everything with pending (unpublished) changes.
- * Mirrors `SdkPullDraftsResponse` in `@riverbankcms/api`; kept structurally in
- * sync by the API↔SDK typetest.
- */
-export interface PulledDrafts {
-    pages: Array<{
-        identifier: string;
-        hasUnpublishedChanges: boolean;
-        status: 'draft' | 'published';
-    }>;
-    entries: Array<{
-        contentType: string;
-        identifier: string;
-        status: 'draft' | 'published';
-    }>;
-    summary: {
-        pageCount: number;
-        entryCount: number;
-    };
-    meta: {
-        pulledAt: string;
-    };
-}
-export interface PulledSettings {
-    settings: ManagementSettings;
-    warnings?: string[];
-    meta: {
-        pulledAt: string;
-        updatedAt: string | null;
-    };
-}
-export interface PulledForms {
-    forms: Array<{
-        slug: string;
-        name: string;
-        schema: ManagementFormSchema;
-        settings: ManagementFormSettings;
-        updatedAt: string;
-        createdAt: string;
-    }>;
-    meta: {
-        pulledAt: string;
-    };
-}
-export interface PulledTheme {
-    theme: Theme | null;
-    themeId: string | null;
-    selectionId: string | null;
-    meta: {
-        pulledAt: string;
-        updatedAt: string | null;
-    };
-}
-export interface PulledVenues {
-    venues: Array<{
-        slug: string;
-        title: string;
-        description: string | null;
-        timezone: string | null;
-        capacity: number | null;
-        address: VenueAddress;
-        location: VenueLocation | null;
-        mapEmbed: string | null;
-        updatedAt: string;
-        createdAt: string;
-    }>;
-    meta: {
-        pulledAt: string;
-    };
-}
-export interface PulledEventCategories {
-    eventCategories: Array<{
-        identifier: string;
-        name: string;
-        description: string | null;
-        color: string | null;
-        sortOrder: number;
-        updatedAt: string;
-        createdAt: string;
-    }>;
-    meta: {
-        pulledAt: string;
-    };
-}
-export interface PulledEvents {
-    events: SdkPullEventSeries[];
-    meta: {
-        pulledAt: string;
-    };
-}
-/**
- * Site info returned by the siteInfo() method.
- * Contains configuration data from the CMS server.
- */
-export interface PulledSiteInfo {
-    /** Supabase URL for direct storage access */
-    supabaseUrl: string;
-    meta: {
-        fetchedAt: string;
-    };
-}
-/**
- * Content type info returned by the pull.contentTypes() method.
- */
-export interface PulledContentType {
-    key: string;
-    name: string;
-    hasPages: boolean;
-    routePattern: string | null;
-    isSingleton: boolean;
-}
-/**
- * Response from pulling content types.
- */
-export interface PulledContentTypes {
-    contentTypes: PulledContentType[];
-    meta: {
-        pulledAt: string;
-    };
-}
-export interface PulledContent {
-    entries: Record<string, PulledEntries['entries']>;
-    pages: PulledPages['pages'];
-    navigation: PulledNavigationMenu[];
-    settings: ManagementSettings;
-    settingsWarnings?: string[];
-    forms: PulledForms['forms'];
-    venues?: PulledVenues['venues'];
-    eventCategories?: PulledEventCategories['eventCategories'];
-    events?: PulledEvents['events'];
-    meta: {
-        pulledAt: string;
-        settingsUpdatedAt?: string | null;
-        /** Whether the response was truncated due to size limits and what was returned. */
-        truncation: SdkPullTruncationMeta;
-        entries?: Record<string, {
-            createdAt: string;
-            updatedAt: string;
-            publishedAt: string | null;
-        }>;
-    };
-}
-export interface PaginationOptions {
-    page?: number;
-    limit?: number;
-}
-export interface PaginatedResult<T> {
-    items: T[];
-    pagination: {
-        page: number;
-        limit: number;
-        total: number;
-        hasMore: boolean;
-    };
-}
-export interface ApiSuccessResponse<T> {
-    success: true;
-    data: T;
-}
-export interface ApiErrorResponse {
-    success: false;
-    error: {
-        code: string;
-        message: string;
-        details?: unknown;
-        fieldErrors?: Array<{
-            field: string;
-            code: string;
-            message: string;
-        }>;
-        /**
-         * Precise failure tag from the originating server `DomainServiceError`
-         * (e.g. `STALE_BASE`, `INVALID_STYLE_SELECTION`). Optional; the coarse `code`
-         * collapses several tags into one HTTP status.
-         */
-        tag?: string;
-    };
-}
-export type ApiResponse<T> = ApiSuccessResponse<T> | ApiErrorResponse;
-export interface EntryOperations {
-    list(contentType: string, options?: PaginationOptions): Promise<PaginatedResult<ManagementEntry>>;
-    get(contentType: string, identifier: string): Promise<ManagementEntry | null>;
-    /**
-     * Correlated overloads: a publish-intent upsert resolves to the entry plus
-     * the publication outcome (which may report a failed publish); a draft upsert
-     * resolves to the entry alone. Statically-unknown intent gets the honest
-     * union.
-     */
-    upsert(input: EntryUpsertInput & {
-        publication: 'publish';
-    }): Promise<EntryPublishUpsertResult>;
-    upsert(input: EntryUpsertInput & {
-        publication?: 'draft';
-    }): Promise<UpsertedManagementEntry>;
-    upsert(input: EntryUpsertInput): Promise<UpsertedManagementEntry | EntryPublishUpsertResult>;
-    publish(contentType: string, identifier: string): Promise<void>;
-    unpublish(contentType: string, identifier: string): Promise<void>;
-    delete(contentType: string, identifier: string): Promise<void>;
-}
-export interface PageOperations {
-    list(options?: PaginationOptions): Promise<PaginatedResult<ManagementPage>>;
-    get(identifier: string): Promise<ManagementPage | null>;
-    /** Correlated overloads — see {@link EntryOperations.upsert}. */
-    upsert(input: PageUpsertInput & {
-        publication: 'publish';
-    }): Promise<PagePublishUpsertResult>;
-    upsert(input: PageUpsertInput & {
-        publication?: 'draft';
-    }): Promise<ManagementPage>;
-    upsert(input: PageUpsertInput): Promise<ManagementPage | PagePublishUpsertResult>;
-    publish(identifier: string): Promise<void>;
-    unpublish(identifier: string): Promise<void>;
-    delete(identifier: string): Promise<void>;
-}
-export type ManagementPageBlock = SdkGetPageBlockResponse['block'];
-/**
- * Input for `blocks.patch` — derived from the API contract.
- * `baseContentHash` must be the `contentHash` from a prior `blocks.get`;
- * a stale hash rejects with a 409 whose `fieldErrors[0].message` carries the
- * current hash (field `baseContentHash`, code `STALE_CONTENT`).
- */
-export type BlockPatchInput = SdkPatchPageBlockBody;
-export interface BlockOperations {
-    list(pageIdentifier: string): Promise<ManagementBlock[]>;
-    get(pageIdentifier: string, blockIdentifier: string): Promise<ManagementPageBlock | null>;
-    upsert(pageIdentifier: string, input: BlockUpsertInput): Promise<ManagementBlock>;
-    patch(pageIdentifier: string, blockIdentifier: string, input: BlockPatchInput): Promise<ManagementPageBlock>;
-    reorder(pageIdentifier: string, blockIdentifiers: string[]): Promise<void>;
-    delete(pageIdentifier: string, blockIdentifier: string): Promise<void>;
-}
-export interface NavigationOperations {
-    list(): Promise<ManagementNavigationMenu[]>;
-    get(name: string): Promise<ManagementNavigationMenu | null>;
-    upsert(input: NavigationMenuUpsertInput): Promise<ManagementNavigationMenu>;
-    delete(menuId: string): Promise<void>;
-}
-export interface SettingsOperations {
-    get(): Promise<ManagementSettings>;
-    update(input: SettingsUpdateInput): Promise<ManagementSettings>;
-}
-export interface WebhookOperations {
-    setupRevalidation(input: SetupRevalidationWebhookInput): Promise<SetupRevalidationWebhookResult>;
-}
-export interface FormOperations {
-    list(): Promise<ManagementForm[]>;
-    get(slug: string): Promise<ManagementForm | null>;
-    upsert(input: FormUpsertInput): Promise<ManagementForm>;
-    delete(slug: string): Promise<void>;
-}
-export interface ThemeOperations {
-    upsert(input: ThemeUpsertInput): Promise<ThemeUpsertResult>;
-    applySelection(input: ThemeStyleSelectionApplyInput): Promise<ThemeStyleSelectionApplyResult>;
-}
-export interface FooterOperations {
-    /** Get footer content */
-    get(): Promise<ManagementFooterContent | null>;
-    /** Upsert footer content */
-    upsert(input: FooterContentUpsertInput): Promise<ManagementFooterContent | null>;
-}
-export interface VenueOperations {
-    list(): Promise<ManagementVenue[]>;
-    get(slug: string): Promise<ManagementVenue | null>;
-    upsert(input: VenueUpsertInput): Promise<ManagementVenue>;
-    delete(slug: string): Promise<void>;
-}
-export interface EventCategoryOperations {
-    list(): Promise<ManagementEventCategory[]>;
-    get(identifier: string): Promise<ManagementEventCategory | null>;
-    upsert(input: EventCategoryUpsertInput): Promise<ManagementEventCategory>;
-    delete(identifier: string): Promise<void>;
-}
-export interface EventOperations {
-    list(): Promise<ManagementEventSeries[]>;
-    get(identifier: string): Promise<ManagementEventSeries | null>;
-    upsert(input: EventSeriesUpsertInput): Promise<ManagementEventSeries>;
-    delete(identifier: string): Promise<void>;
-    occurrences: EventOccurrenceOperations;
-}
-export interface EventOccurrenceOperations {
-    list(identifier: string, options?: Readonly<{
-        all?: boolean;
-        status?: ManagementEventOccurrence['status'];
-        cursor?: string;
-        limit?: number;
-    }>): Promise<Readonly<{
-        occurrences: ManagementEventOccurrence[];
-        nextCursor: string | null;
-    }>>;
-    add(identifier: string, input: AddEventOccurrenceInput): Promise<ManagementEventOccurrence>;
-    update(identifier: string, occurrenceId: string, input: Readonly<{
-        schedule?: EventOccurrenceScheduleInput;
-        capacity?: EventOccurrenceCapacityIntent;
-    }>): Promise<ManagementEventOccurrence>;
-    cancel(identifier: string, occurrenceId: string): Promise<ManagementEventOccurrence>;
-    delete(identifier: string, occurrenceId: string): Promise<void>;
-}
-export interface PullOperations {
-    entries(contentType?: string, options?: PaginationOptions): Promise<PulledEntries>;
-    pages(): Promise<PulledPages>;
-    /**
-     * Cross-type overview of pages and entries with pending (unpublished) changes.
-     * Server-side filtered and fully enumerated.
-     */
-    drafts(): Promise<PulledDrafts>;
-    navigation(): Promise<PulledNavigation>;
-    settings(): Promise<PulledSettings>;
-    forms(): Promise<PulledForms>;
-    theme(): Promise<PulledTheme>;
-    footer(): Promise<PulledFooter>;
-    venues(): Promise<PulledVenues>;
-    eventCategories(): Promise<PulledEventCategories>;
-    events(): Promise<PulledEvents>;
-    all(): Promise<PulledContent>;
-    /**
-     * Get site configuration info from the CMS server.
-     * Used to get values like Supabase URL for media sync without
-     * requiring additional env vars on SDK sites.
-     */
-    siteInfo(): Promise<PulledSiteInfo>;
-    /**
-     * Get all content types for the site.
-     * Returns key, name, hasPages, routePattern, and isSingleton for each type.
-     */
-    contentTypes(): Promise<PulledContentTypes>;
-}
-export type PulledCatalogTheme = SdkCatalogThemeResponse;
-export type PulledCatalogBlocks = SdkCatalogBlocksResponse;
-export type PulledCatalogContentTypes = SdkCatalogContentTypesResponse;
-export type Capabilities = SdkCapabilitiesResponse;
-/** Demo-seed provenance listing (plan 8.2). */
-export type DemoContent = SdkDemoContentResponse;
-export interface CatalogOperations {
-    /** Theme discovery catalog: styles, personalities, palettes, looks + current selection. */
-    theme(): Promise<PulledCatalogTheme>;
-    /** Block discovery catalog: manifest fields, content-source, theme-aware variant availability. */
-    blocks(): Promise<PulledCatalogBlocks>;
-    /** Content-type discovery catalog: normalized field DSL per content type. */
-    contentTypes(): Promise<PulledCatalogContentTypes>;
-}
-export interface BackfillPageResult {
-    pagesUpdated: number;
-    identifiersAssigned: Record<string, string>;
-}
-export interface BackfillBlockResult {
-    blocksUpdated: number;
-    identifiersAssigned: Record<string, string>;
-}
-export interface BackfillEntryResult {
-    entriesUpdated: number;
-    identifiersAssigned: Record<string, string>;
-}
-export interface BackfillResult {
-    pages: BackfillPageResult;
-    blocks: {
-        total: number;
-        byPage: Record<string, BackfillBlockResult>;
-    };
-    entries: BackfillEntryResult;
-}
-export interface IdentifiersOperations {
-    /**
-     * Backfill identifiers for pages, blocks, and entries that don't have one.
-     * This is useful for migrating content created before the SDK was available.
-     * The operation is idempotent - running it multiple times won't overwrite existing identifiers.
-     */
-    backfill(): Promise<BackfillResult>;
-}
-export interface MediaUploadResult {
-    storagePath: string;
-    status: 'created' | 'exists';
-    assetId?: string;
-    identifier?: string | null;
-}
-export interface MediaOperations {
-    /**
-     * Upload a media file to the target environment.
-     * If the file already exists, returns success without re-uploading.
-     */
-    upload(file: {
-        data: Buffer;
-        filename: string;
-        contentType: string;
-        storagePath?: string;
-        title?: string;
-        identifier?: string;
-    }): Promise<MediaUploadResult>;
-    /**
-     * Check if a media file exists at the given storage path.
-     */
-    exists(storagePath: string): Promise<boolean>;
-    /**
-     * Resolve media assets by identifiers or asset IDs.
-     */
-    resolve(input: {
-        identifiers?: string[];
-        assetIds?: string[];
-    }): Promise<MediaResolveResponse>;
-    /**
-     * Find media assets by checksum for dedupe.
-     */
-    findByChecksum(checksums: string[]): Promise<ManagementMediaAsset[]>;
-    /**
-     * Assign or update a media identifier.
-     */
-    assignIdentifier(input: {
-        assetId: string;
-        identifier: string | null;
-        force?: boolean;
-    }): Promise<ManagementMediaAsset>;
-}
-export interface ManagementClient {
-    entries: EntryOperations;
-    pages: PageOperations;
-    blocks: BlockOperations;
-    navigation: NavigationOperations;
-    settings: SettingsOperations;
-    webhooks: WebhookOperations;
-    forms: FormOperations;
-    theme: ThemeOperations;
-    footer: FooterOperations;
-    venues: VenueOperations;
-    eventCategories: EventCategoryOperations;
-    events: EventOperations;
-    pull: PullOperations;
-    /** Discovery catalogs (theme / blocks / content-types). */
-    catalog: CatalogOperations;
-    identifiers: IdentifiersOperations;
-    media: MediaOperations;
-    /**
-     * Thin capabilities index: API version, catalog links, and per-catalog content
-     * hashes so agents can cache catalogs and detect drift.
-     */
-    capabilities(): Promise<Capabilities>;
-    /**
-     * Demo-seed provenance ledger: created and existing resource observations
-     * from demo recipe runs (plan 8.2). Historical heuristic-era observations are
-     * not cleanup-authoritative, and destructive cleanup remains disabled pending
-     * an explicit trust cutoff or purge.
-     */
-    demoContent(): Promise<DemoContent>;
-}