@riverbankcms/sdk 0.128.0 → 0.129.1

package/dist/_dts/sdk/src/cli/commands/setup.d.ts

@@ -1,3 +0,0 @@
-import { Command } from 'commander';
-export declare function createSetupCommand(): Command;
-export declare const setupCommand: Command;

package/dist/_dts/sdk/src/cli/commands/style.d.ts

@@ -1,60 +0,0 @@
-/**
- * Style Command
- *
- * Apply bounded site-style selections via the command-backed theme API.
- */
-import { Command } from 'commander';
-import { type CuratedSiteStyle } from '../../../../theme-core/src/site-styles/index';
-import type { ManagementClient, ThemeStyleSelectionApplyInput } from '../../client/management';
-import { type SiteStyleSelectionApplyCommand } from '../../client/management';
-import type { OutputContext } from '../output';
-type StyleSelectionOptions = Readonly<{
-    siteStyleId: string;
-    buttonStyleId?: string;
-    buttonStyleParameters?: string;
-    palette?: string;
-    typography?: string;
-    headerLookId?: string;
-    headerLayoutId?: string;
-    headerStyleId?: string;
-    footerLookId?: string;
-}>;
-export type StyleApplyOptions = StyleSelectionOptions & Readonly<{
-    baseSelectionVersion: string;
-    selectionId?: string;
-}>;
-export type StyleInitOptions = StyleSelectionOptions;
-export type StyleInitCommandDeps = Readonly<{
-    upsertTheme: ManagementClient['theme']['upsert'];
-    info: OutputContext['info'];
-    success: OutputContext['success'];
-}>;
-export type StyleCatalogListOptions = Readonly<{
-    siteStyleId?: string;
-}>;
-export type StyleCatalogChoice = Readonly<{
-    id: string;
-    label: string;
-}>;
-export type StyleCatalogListRow = Readonly<{
-    siteStyleId: string;
-    name: string;
-    palettes: readonly StyleCatalogChoice[];
-    buttonStyles: readonly StyleCatalogChoice[];
-    typography: Readonly<{
-        body: string;
-        heading: string;
-    }>;
-    headerLayouts: readonly StyleCatalogChoice[];
-    headerStyles: readonly StyleCatalogChoice[];
-    headerLooks: readonly StyleCatalogChoice[];
-    footerLooks: readonly StyleCatalogChoice[];
-}>;
-export declare function buildStyleSelectionApplyInputFromOptions(options: StyleApplyOptions): ThemeStyleSelectionApplyInput;
-/** Builds the complete first-theme command without reading current selection state. */
-export declare function buildStyleSelectionInitializeCommandFromOptions(options: StyleInitOptions): SiteStyleSelectionApplyCommand;
-export declare function buildStyleCatalogListRows(styles?: readonly CuratedSiteStyle[], options?: StyleCatalogListOptions): readonly StyleCatalogListRow[];
-export declare function formatStyleCatalogListRow(row: StyleCatalogListRow): string[];
-export declare function executeStyleInitWithDeps(deps: StyleInitCommandDeps, options: StyleInitOptions): Promise<void>;
-export declare const styleCommand: Command;
-export {};

package/dist/_dts/sdk/src/cli/commands/verify.d.ts

@@ -1,11 +0,0 @@
-/**
- * Verify Command
- *
- * Compare local SDK config content types against target site.
- *
- * Usage:
- *   riverbankcms verify [--env=remote] [--config <path>]
- */
-import { Command } from 'commander';
-export declare const createVerifyCommand: () => Command;
-export declare const verifyCommand: Command;

package/dist/_dts/sdk/src/cli/commands/webhooks.d.ts

@@ -1,44 +0,0 @@
-import { Command } from 'commander';
-import type { SetupRevalidationWebhookResult } from '../../client/management';
-export declare const RIVERBANK_WEBHOOK_SECRET_ENV = "RIVERBANK_WEBHOOK_SECRET";
-export type EnvPatchPlan = Readonly<{
-    tag: 'create-file';
-    nextContent: string;
-}> | Readonly<{
-    tag: 'append-key';
-    nextContent: string;
-}> | Readonly<{
-    tag: 'replace-key';
-    nextContent: string;
-}> | Readonly<{
-    tag: 'unchanged';
-    nextContent: string;
-}>;
-export interface WebhookSetupOptions {
-    url: string;
-    name?: string;
-    rotateSecret?: boolean;
-    dryRun?: boolean;
-    writeEnv?: boolean;
-    vercel?: boolean;
-    yes?: boolean;
-}
-export declare function planEnvSecretPatch(existingContent: string | null, secret: string): EnvPatchPlan;
-export declare function writeEnvSecret(filePath: string, secret: string): Promise<Readonly<{
-    path: string;
-    plan: EnvPatchPlan;
-    written: boolean;
-}>>;
-export declare function planHumanResultOutput(input: Readonly<{
-    result: SetupRevalidationWebhookResult;
-    envWrite: Readonly<{
-        path: string;
-        plan: EnvPatchPlan;
-        written: boolean;
-    }> | null;
-    writeEnv: boolean;
-}>): Readonly<{
-    summary: string;
-    details: string[];
-}>;
-export declare const webhooksCommand: Command;

package/dist/_dts/sdk/src/cli/config-loader.d.ts

@@ -1,47 +0,0 @@
-/**
- * CLI Config Loader
- *
- * Loads riverbank.config.ts and extracts CLI-relevant configuration
- * (contentDir and sync settings) with appropriate defaults.
- */
-import type { EnvTarget } from './helpers';
-import type { SyncConfig, BlockFieldExtensionsMap, SdkCustomBlock } from '../config/types';
-/**
- * Loaded CLI configuration with defaults applied.
- */
-export interface LoadedCliConfig {
-    /** Content directory path (resolved to absolute path) */
-    contentDir: string;
-    /** Sync behavior settings with defaults */
-    sync: Required<SyncConfig>;
-    /** Custom block field extensions from config (for validation) */
-    blockFieldExtensions?: BlockFieldExtensionsMap;
-    /** SDK custom block definitions from config (for validation) */
-    customBlocks?: SdkCustomBlock[];
-    /** Active theme name for local loading and default push */
-    activeTheme: string;
-}
-/**
- * Load CLI configuration from riverbank.config.ts.
- *
- * Extracts contentDir and sync settings, applying defaults where not specified.
- *
- * @param configPath - Optional path to config file or directory
- * @returns Loaded CLI config with defaults applied
- *
- * @example
- * ```typescript
- * const config = await loadCliConfig();
- * console.log(config.contentDir); // './content' or custom path
- * console.log(config.sync.existingEntries); // 'skip' or 'update'
- * ```
- */
-export declare function loadCliConfig(configPath?: string): Promise<LoadedCliConfig>;
-export declare function loadCliConfigForEnv(target: EnvTarget, configPath?: string): Promise<LoadedCliConfig>;
-/**
- * Check if a CLI config file exists.
- *
- * @param configPath - Optional path to check
- * @returns True if config file exists
- */
-export declare function hasCliConfig(configPath?: string): Promise<boolean>;

package/dist/_dts/sdk/src/cli/content/collectionWriters.d.ts

@@ -1,23 +0,0 @@
-import type { PulledEventCategories, PulledEvents, PulledForms, PulledVenues } from '../../client/management/types';
-import { type ContentMetadataTarget } from './metadataStore';
-type CollectionWriterOptions = Readonly<{
-    skipMeta?: boolean;
-    metadataTarget?: ContentMetadataTarget;
-}>;
-export declare function writeForms(contentDir: string, pulledForms: PulledForms, options?: CollectionWriterOptions): Promise<{
-    filePaths: string[];
-    metaPath: string;
-}>;
-export declare function writeVenues(contentDir: string, pulledVenues: PulledVenues, options?: CollectionWriterOptions): Promise<{
-    filePaths: string[];
-    metaPath: string;
-}>;
-export declare function writeEventCategories(contentDir: string, pulledCategories: PulledEventCategories, options?: CollectionWriterOptions): Promise<{
-    filePaths: string[];
-    metaPath: string;
-}>;
-export declare function writeEvents(contentDir: string, pulledEvents: PulledEvents, options?: CollectionWriterOptions): Promise<{
-    filePaths: string[];
-    metaPath: string;
-}>;
-export {};

package/dist/_dts/sdk/src/cli/content/edit/format.d.ts

@@ -1,2 +0,0 @@
-import type { ContentEditPlan } from './planner';
-export declare function formatContentEditPlan(plan: ContentEditPlan): readonly string[];

package/dist/_dts/sdk/src/cli/content/edit/path.d.ts

@@ -1,14 +0,0 @@
-import { type FieldPathSegment } from '../../sync/field-diff';
-export type ContentFieldPathSegment = Extract<FieldPathSegment, Readonly<{
-    type: 'property' | 'index';
-}>>;
-export type ContentFieldPath = readonly ContentFieldPathSegment[];
-export type ParseContentFieldPathResult = Readonly<{
-    ok: true;
-    path: ContentFieldPath;
-}> | Readonly<{
-    ok: false;
-    error: string;
-}>;
-export declare function parseContentFieldPath(value: string): ParseContentFieldPathResult;
-export declare function formatContentFieldPath(path: ContentFieldPath): string;

package/dist/_dts/sdk/src/cli/content/edit/planner.d.ts

@@ -1,46 +0,0 @@
-import type { LocalPage } from '../reader';
-import { type FieldChange } from '../../sync/field-diff';
-import { type ContentFieldPath } from './path';
-export type PageBlockMoveTarget = Readonly<{
-    tag: 'to_start';
-}> | Readonly<{
-    tag: 'to_end';
-}> | Readonly<{
-    tag: 'before';
-    blockIdentifier: string;
-}> | Readonly<{
-    tag: 'after';
-    blockIdentifier: string;
-}>;
-export type ContentEditOperation = Readonly<{
-    tag: 'remove_page_block';
-    pageIdentifier: string;
-    blockIdentifier: string;
-}> | Readonly<{
-    tag: 'move_page_block';
-    pageIdentifier: string;
-    blockIdentifier: string;
-    target: PageBlockMoveTarget;
-}> | Readonly<{
-    tag: 'update_page_field';
-    pageIdentifier: string;
-    path: ContentFieldPath;
-    value: unknown;
-}>;
-export type ContentEditErrorCode = 'wrong_page' | 'missing_blocks' | 'missing_block' | 'duplicate_block_identifier' | 'missing_move_target' | 'move_target_is_source' | 'invalid_field_path' | 'noop';
-export type ContentEditError = Readonly<{
-    code: ContentEditErrorCode;
-    message: string;
-}>;
-export type ContentEditPlan = Readonly<{
-    tag: 'will_change';
-    operation: ContentEditOperation;
-    before: LocalPage;
-    after: LocalPage;
-    changes: readonly FieldChange[];
-}> | Readonly<{
-    tag: 'invalid';
-    operation: ContentEditOperation;
-    error: ContentEditError;
-}>;
-export declare function planPageContentEdit(page: LocalPage, operation: ContentEditOperation): ContentEditPlan;

package/dist/_dts/sdk/src/cli/content/entryPaths.d.ts

@@ -1,6 +0,0 @@
-export declare function entryTypeDirPath(contentDir: string, contentType: string): string;
-export declare function entryFilePath(input: Readonly<{
-    contentDir: string;
-    contentType: string;
-    identifier: string;
-}>): string;

package/dist/_dts/sdk/src/cli/content/footerFile.d.ts

@@ -1,10 +0,0 @@
-import { z } from 'zod';
-export type LocalFooterContent = import('../../../../api/src/sdkContracts').SdkFooterContent;
-export declare const localFooterContentSchema: z.ZodObject<{
-    composition: z.ZodPipe<z.ZodUnknown, z.ZodTransform<Readonly<{
-        schemaVersion: 1;
-        sections: readonly import("../../../../core/src/index").FooterSection[];
-    }>, unknown>>;
-    revision: z.ZodNumber;
-}, z.core.$strict>;
-export declare function writeFooterContentAfterPush(contentDir: string, footer: LocalFooterContent): Promise<string>;

package/dist/_dts/sdk/src/cli/content/fs-utils.d.ts

@@ -1,39 +0,0 @@
-/**
- * File System Utilities for Content Reader/Writer
- *
- * Shared helpers for file operations in the content directory.
- */
-/**
- * Check if a file exists
- */
-export declare function fileExists(filePath: string): Promise<boolean>;
-/**
- * Check if a path is a directory
- */
-export declare function isDirectory(dirPath: string): Promise<boolean>;
-/**
- * List files in a directory with a specific extension.
- * Returns empty array if directory doesn't exist (expected case).
- * Logs warning for other errors (permission denied, disk issues, etc).
- *
- * @param dirPath - Directory to list files from
- * @param extension - File extension to filter by (e.g., '.json')
- * @returns Array of full file paths
- */
-export declare function listFiles(dirPath: string, extension: string): Promise<string[]>;
-/**
- * Read and parse a JSON file
- */
-export declare function readJsonFile<T>(filePath: string): Promise<T>;
-/**
- * Write JSON file with pretty formatting
- */
-export declare function writeJsonFile(filePath: string, data: unknown): Promise<void>;
-/**
- * Write JSON file via a same-directory temp file and atomic rename.
- */
-export declare function writeJsonFileAtomic(filePath: string, data: unknown): Promise<void>;
-/**
- * Ensure directory exists, creating it if necessary
- */
-export declare function ensureDir(dirPath: string): Promise<void>;

package/dist/_dts/sdk/src/cli/content/legacyEventScheduleShapeError.d.ts

@@ -1,5 +0,0 @@
-export declare class LegacyEventScheduleShapeError extends Error {
-    readonly filePath: string;
-    readonly code = "legacy_event_schedule_shape";
-    constructor(filePath: string);
-}

package/dist/_dts/sdk/src/cli/content/localEventSchedule.d.ts

@@ -1,17 +0,0 @@
-import type { EventPreset } from '../../../../api/src/index';
-export interface LocalEventOccurrence {
-    startsAt: string;
-    endsAt: string;
-    timeZone: string;
-}
-export interface LocalEventScheduleIdentity {
-    preset: EventPreset;
-    bookingScope: 'single_occurrence' | 'whole_series';
-    occurrences: readonly LocalEventOccurrence[];
-}
-export declare class InvalidLocalEventScheduleIdentityError extends Error {
-    readonly filePath: string;
-    readonly code = "invalid_local_event_schedule_identity";
-    constructor(filePath: string, details: string);
-}
-export declare function parseLocalEventScheduleIdentity(value: unknown, filePath: string): LocalEventScheduleIdentity;

package/dist/_dts/sdk/src/cli/content/media-manifest.d.ts

@@ -1,13 +0,0 @@
-export type LocalMediaManifestEntry = {
-    checksum?: string;
-    filename: string;
-    mimeType?: string;
-};
-export type LocalMediaManifest = {
-    version: 2;
-    updatedAt: string;
-    assets: Record<string, LocalMediaManifestEntry>;
-};
-export declare const createEmptyMediaManifest: () => LocalMediaManifest;
-export declare function readMediaManifest(contentDir: string): Promise<LocalMediaManifest>;
-export declare function writeMediaManifest(contentDir: string, manifest: LocalMediaManifest): Promise<string>;

package/dist/_dts/sdk/src/cli/content/metadataAfterPush.d.ts

@@ -1,25 +0,0 @@
-import { type ContentMetadataTarget } from './metadataStore';
-type TimestampedRecord = Readonly<{
-    createdAt?: string;
-    updatedAt?: string;
-}>;
-type RemoteContentAfterPush = Readonly<{
-    entries: Readonly<Record<string, readonly (TimestampedRecord & {
-        identifier: string;
-    })[]>>;
-    pages: readonly (TimestampedRecord & {
-        identifier: string;
-    })[];
-    navigation: readonly (TimestampedRecord & {
-        name: string;
-    })[];
-    settingsUpdatedAt?: string | null;
-    forms?: readonly (TimestampedRecord & {
-        slug: string;
-    })[];
-}>;
-type MetadataAfterPushOptions = Readonly<{
-    metadataTarget?: ContentMetadataTarget;
-}>;
-export declare function updateMetadataAfterPush(contentDir: string, remoteContent: RemoteContentAfterPush, options?: MetadataAfterPushOptions): Promise<void>;
-export {};

package/dist/_dts/sdk/src/cli/content/metadataStore.d.ts

@@ -1,29 +0,0 @@
-import type { SdkEnvironment } from '../env';
-export type ContentMetadataEnv = 'local' | 'remote';
-export type ContentMetadataTarget = Readonly<{
-    env: ContentMetadataEnv;
-    siteId: string;
-    dashboardUrl: string;
-}>;
-export type ContentMetadataReadPath = Readonly<{
-    path: string;
-    source: 'scoped' | 'legacy';
-}>;
-export declare function metadataTargetFromEnvironment(env: ContentMetadataEnv, environment: Pick<SdkEnvironment, 'siteId' | 'dashboardUrl'>): ContentMetadataTarget;
-export declare function legacyMetadataDir(contentDir: string): string;
-export declare function scopedMetadataDir(contentDir: string, target: ContentMetadataTarget): string;
-export declare function metadataFilePath(contentDir: string, fileName: string, target?: ContentMetadataTarget): string;
-export declare function legacyMetadataFilePath(contentDir: string, fileName: string): string;
-export declare function ensureMetadataDir(contentDir: string, target?: ContentMetadataTarget): Promise<string>;
-export declare function writeMetadataFile(contentDir: string, fileName: string, value: unknown, target?: ContentMetadataTarget): Promise<string>;
-export declare function readMetadataFile<T>(contentDir: string, fileName: string, target?: ContentMetadataTarget): Promise<T | null>;
-export declare function listMetadataFiles(contentDir: string, target?: ContentMetadataTarget): Promise<string[]>;
-export declare function writeMetadataRecordMap<TRecord>(contentDir: string, fileName: string, recordKey: string, next: Readonly<{
-    pulledAt: string;
-    records: Readonly<Record<string, TRecord>>;
-    extra?: Readonly<Record<string, unknown>>;
-}>, options?: Readonly<{
-    mode?: 'replace' | 'merge';
-    target?: ContentMetadataTarget;
-}>): Promise<string>;
-export declare function resolveMetadataReadPath(contentDir: string, fileName: string, target?: ContentMetadataTarget): Promise<ContentMetadataReadPath | null>;