@riverbankcms/sdk 0.129.0 → 0.130.0

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

@@ -1,488 +0,0 @@
-/**
- * Content File Reader
- *
- * Reads content from the file system for push operations.
- * Mirrors the structure created by writer.ts.
- */
-export { LegacyEventScheduleShapeError } from './legacyEventScheduleShapeError';
-import { type ContentMetadataTarget } from './metadataStore';
-import type { NavigationAuthoringLinkInput, NavigationLocalItemInput } from '../../../../api/src/navigation';
-import type { SdkEventPricingInput } from '../../../../api/src/sdk-event-pricing';
-import { type LocalEventScheduleIdentity } from './localEventSchedule';
-export type { LocalEventOccurrence, LocalEventScheduleIdentity } from './localEventSchedule';
-export { InvalidLocalEventScheduleIdentityError } from './localEventSchedule';
-import { type ValidatedThemeForPersistence } from '../../../../blocks/src/index';
-import type { RichTextDoc } from '../../../../core/src/index';
-import type { EventPaymentTermsInput } from '../../client/management/types';
-import { type LocalFooterContent } from './footerFile';
-export interface LocalEntry {
-    identifier: string;
-    data: Record<string, unknown>;
-    status?: 'draft' | 'published';
-    hasUnpublishedChanges?: boolean;
-    slug?: string;
-    manualOrder?: number;
-    blocks?: LocalEntrySlotBlocks;
-}
-export type LocalEntrySlotBlocks = Record<string, Array<{
-    identifier?: string | null;
-    kind: string;
-    content: Record<string, unknown>;
-}>>;
-export declare class LegacyEntryTitleError extends Error {
-    readonly filePath: string;
-    constructor(filePath: string);
-}
-export interface LocalEntriesFile {
-    contentType: string;
-    entries: LocalEntry[];
-}
-export interface LocalBlock {
-    identifier: string;
-    kind: string;
-    position?: number;
-    data: Record<string, unknown>;
-}
-export interface LocalPage {
-    identifier: string;
-    title: string;
-    path: string;
-    status?: 'draft' | 'published';
-    hasUnpublishedChanges?: boolean;
-    blocks?: LocalBlock[];
-    seoTitle?: string;
-    seoDescription?: string;
-    updatedAt?: string;
-}
-/**
- * Navigation link types for local navigation files.
- *
- * These types are aligned with the shared navigation authoring boundary.
- * SDK files may use an explicit dropdown sentinel, which is normalized
- * before command/API management validation.
- */
-export type LocalNavigationLinkType = NavigationAuthoringLinkInput;
-export type LocalNavigationItem = NavigationLocalItemInput;
-export interface LocalNavigationMenu {
-    identifier?: string | null;
-    name: string;
-    isPrimary?: boolean;
-    isFooter?: boolean;
-    footerRole?: 'main' | 'legal-policy' | null;
-    items: LocalNavigationItem[];
-}
-export interface LocalNavigation {
-    menus: LocalNavigationMenu[];
-}
-export interface LocalSettings {
-    homepageId?: string | null;
-    seoDefaults?: {
-        title?: string;
-        description?: string;
-        ogImage?: string;
-        allowIndexingInProduction?: boolean;
-    } | null;
-    logoIdentifier?: string | null;
-    faviconIdentifier?: string | null;
-}
-export interface LocalFormField {
-    id: string;
-    label: string;
-    type: string;
-    required?: boolean;
-    placeholder?: string;
-    helpText?: string;
-    options?: Array<{
-        value: string;
-        label: string;
-    }>;
-    multiple?: boolean;
-    minLength?: number;
-    maxLength?: number;
-    pattern?: string;
-    min?: number;
-    max?: number;
-}
-export interface LocalFormSchema {
-    version?: string;
-    fields: LocalFormField[];
-}
-export type LocalFormSettings = Record<string, unknown>;
-export interface LocalForm {
-    slug: string;
-    name: string;
-    schema: LocalFormSchema;
-    settings: LocalFormSettings;
-}
-export interface LocalTheme {
-    /** Filename without .json extension */
-    name: string;
-    /** Full theme object matching themeSchema */
-    theme: ValidatedThemeForPersistence;
-}
-/**
- * Local footer content structure.
- * Stored in content/footer.json.
- *
- * Footer links are managed via navigation (footer menu), not this file.
- */
-export type { LocalFooterContent } from './footerFile';
-export interface LocalVenueAddress {
-    line1?: string | null;
-    line2?: string | null;
-    city?: string | null;
-    region?: string | null;
-    postcode?: string | null;
-    country?: string | null;
-}
-export interface LocalVenueLocation {
-    lat?: number;
-    lng?: number;
-}
-export interface LocalVenue {
-    slug: string;
-    title: string;
-    description?: string | null;
-    timezone?: string | null;
-    capacity?: number | null;
-    address?: LocalVenueAddress;
-    location?: LocalVenueLocation | null;
-    mapEmbed?: string | null;
-}
-export interface LocalEventCategory {
-    identifier: string;
-    name: string;
-    description?: string | null;
-    color?: string | null;
-    sortOrder?: number;
-}
-export type LocalEventPricing = SdkEventPricingInput;
-export interface LocalEventContent {
-    summary?: string | null;
-    body?: string | RichTextDoc | null;
-    image?: (Record<string, unknown> & {
-        identifier: string;
-    }) | null;
-}
-export interface LocalEvent extends LocalEventScheduleIdentity {
-    identifier: string;
-    title: string;
-    slug: string;
-    path?: string | null;
-    status?: 'draft' | 'active' | 'archived' | 'cancelled' | 'completed';
-    visibility?: 'private' | 'public' | 'unlisted';
-    capacity?: number | null;
-    pricing?: LocalEventPricing;
-    paymentTerms?: EventPaymentTermsInput;
-    venueRef?: string | null;
-    categoryRef?: string | null;
-    content?: LocalEventContent;
-    formRef?: string | null;
-    settings?: Record<string, unknown>;
-    presentation?: Record<string, unknown> | null;
-    tags?: string[];
-    blocks?: LocalEntrySlotBlocks;
-}
-export type LocalEventWithFilePath = LocalEvent & Readonly<{
-    filePath: string;
-}>;
-/**
- * Check if old format entry files exist (for migration warning)
- *
- * @param contentDir - Base content directory
- * @returns Array of old format file paths found
- */
-export declare function findLegacyEntryFiles(contentDir: string): Promise<string[]>;
-/**
- * Read entries from content directory
- *
- * Format: content/entries/{contentType}/{identifier}.json (one file per entry)
- *
- * This is the new directory format. Old format (one file per content type)
- * is no longer supported. Run `riverbankcms migrate entries` (recommended) or `riverbankcms pull entries` to migrate.
- *
- * @param contentDir - Base content directory
- * @param contentType - Optional specific content type to read
- * @returns Map of content type to entries
- */
-export declare function readEntries(contentDir: string, contentType?: string, metadataTarget?: ContentMetadataTarget): Promise<Map<string, LocalEntry[]>>;
-/**
- * Read pages from content directory
- *
- * Format: content/pages/{identifier}.json
- *
- * @param contentDir - Base content directory
- * @returns Array of local pages
- */
-export declare function readPages(contentDir: string): Promise<LocalPage[]>;
-/**
- * Read navigation from content directory
- *
- * Format: content/navigation.json
- *
- * @param contentDir - Base content directory
- * @returns Navigation menus or null if not found
- */
-export declare function readNavigation(contentDir: string): Promise<LocalNavigation | null>;
-/**
- * Read settings from content directory
- *
- * Format: content/settings.json
- *
- * @param contentDir - Base content directory
- * @returns Settings or null if not found
- */
-export declare function readSettings(contentDir: string): Promise<LocalSettings | null>;
-/**
- * Read forms from content directory
- *
- * Format: content/forms/{slug}.json
- *
- * @param contentDir - Base content directory
- * @returns Array of local forms
- */
-export declare function readForms(contentDir: string): Promise<LocalForm[]>;
-/**
- * Read venues from content directory
- *
- * Format: content/venues/{slug}.json
- *
- * @param contentDir - Base content directory
- * @returns Array of local venues
- */
-export declare function readVenues(contentDir: string): Promise<LocalVenue[]>;
-/**
- * Read event categories from content directory
- *
- * Format: content/event-categories/{identifier}.json
- *
- * @param contentDir - Base content directory
- * @returns Array of local event categories
- */
-export declare function readEventCategories(contentDir: string): Promise<LocalEventCategory[]>;
-/**
- * Read events from content directory
- *
- * Format: content/events/{identifier}.json
- *
- * @param contentDir - Base content directory
- * @returns Array of local events
- */
-export declare function readEvents(contentDir: string): Promise<LocalEvent[]>;
-export declare function readEventsWithFilePaths(contentDir: string): Promise<LocalEventWithFilePath[]>;
-/**
- * Read a single theme by name from content directory
- *
- * Format: content/themes/{name}.json
- *
- * @param contentDir - Base content directory
- * @param themeName - Theme name (filename without .json)
- * @returns Local theme or null if not found
- */
-export declare function readTheme(contentDir: string, themeName: string): Promise<LocalTheme | null>;
-/**
- * Read all themes from content directory
- *
- * Format: content/themes/*.json
- *
- * @param contentDir - Base content directory
- * @returns Array of local themes
- */
-export declare function readThemes(contentDir: string): Promise<LocalTheme[]>;
-/**
- * Read footer content from content directory
- *
- * Format: content/footer.json
- *
- * @param contentDir - Base content directory
- * @returns Footer content or null if not found
- */
-export declare function readFooter(contentDir: string): Promise<LocalFooterContent | null>;
-/**
- * Read all content from content directory
- */
-export interface LocalContent {
-    entries: Map<string, LocalEntry[]>;
-    pages: LocalPage[];
-    navigation: LocalNavigation | null;
-    settings: LocalSettings | null;
-    forms: LocalForm[];
-    footer: LocalFooterContent | null;
-    venues: LocalVenue[];
-    eventCategories: LocalEventCategory[];
-    events: LocalEvent[];
-}
-export declare function readAllContent(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<LocalContent>;
-/**
- * Check if content directory exists and has content
- */
-export declare function contentDirExists(contentDir: string): Promise<boolean>;
-/**
- * Get summary of content in directory
- */
-export interface ContentSummary {
-    hasEntries: boolean;
-    entryTypes: string[];
-    totalEntries: number;
-    hasPages: boolean;
-    pageCount: number;
-    hasNavigation: boolean;
-    menuCount: number;
-    hasSettings: boolean;
-    hasForms: boolean;
-    formCount: number;
-    hasVenues: boolean;
-    venueCount: number;
-    hasEventCategories: boolean;
-    eventCategoryCount: number;
-    hasEvents: boolean;
-    eventCount: number;
-}
-export declare function getContentSummary(contentDir: string): Promise<ContentSummary>;
-export interface EntryMetadata {
-    pulledAt: string;
-    manualOrder?: string[];
-    entries: Record<string, {
-        id?: string;
-        createdAt?: string;
-        updatedAt?: string;
-        publishedAt?: string;
-        hasUnpublishedChanges?: boolean;
-    }>;
-}
-export interface PagesMetadata {
-    pulledAt: string;
-    pages: Record<string, {
-        createdAt?: string;
-        updatedAt?: string;
-    }>;
-}
-export interface NavigationMetadata {
-    pulledAt: string;
-    menus: Record<string, {
-        createdAt?: string;
-        updatedAt?: string;
-    }>;
-}
-export interface SettingsMetadata {
-    pulledAt: string;
-    updatedAt: string | null;
-}
-/**
- * Read metadata for a content type from .meta/ directory
- *
- * @param contentDir - Base content directory
- * @param contentType - Content type to read metadata for
- * @returns Metadata or null if not found
- */
-export declare function readEntriesMeta(contentDir: string, contentType: string, metadataTarget?: ContentMetadataTarget): Promise<EntryMetadata | null>;
-/**
- * Read all entry metadata files from .meta/ directory
- *
- * @param contentDir - Base content directory
- * @returns Map of content type to metadata
- */
-export declare function readAllMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<Map<string, EntryMetadata>>;
-/**
- * Read settings metadata from .meta/settings.json
- *
- * @param contentDir - Base content directory
- * @returns Settings metadata or null if not found
- */
-export declare function readSettingsMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<SettingsMetadata | null>;
-/**
- * Read pages metadata from .meta/pages.json
- *
- * @param contentDir - Base content directory
- * @returns Pages metadata or null if not found
- */
-export declare function readPagesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<PagesMetadata | null>;
-/**
- * Read navigation metadata from .meta/navigation.json
- *
- * @param contentDir - Base content directory
- * @returns Navigation metadata or null if not found
- */
-export declare function readNavigationMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<NavigationMetadata | null>;
-export interface FormsMetadata {
-    pulledAt: string;
-    forms: Record<string, {
-        createdAt?: string;
-        updatedAt?: string;
-    }>;
-}
-/**
- * Read forms metadata from .meta/forms.json
- *
- * @param contentDir - Base content directory
- * @returns Forms metadata or null if not found
- */
-export declare function readFormsMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<FormsMetadata | null>;
-export interface ThemesMetadata {
-    pulledAt: string;
-    themes: Record<string, {
-        themeId: string;
-        selectionId: string;
-        updatedAt: string;
-    }>;
-}
-/**
- * Read themes metadata from .meta/themes.json
- *
- * @param contentDir - Base content directory
- * @returns Themes metadata or null if not found
- */
-export declare function readThemesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<ThemesMetadata | null>;
-export interface VenuesMetadata {
-    pulledAt: string;
-    venues: Record<string, {
-        createdAt?: string;
-        updatedAt?: string;
-    }>;
-}
-/**
- * Read venues metadata from .meta/venues.json
- *
- * @param contentDir - Base content directory
- * @returns Venues metadata or null if not found
- */
-export declare function readVenuesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<VenuesMetadata | null>;
-export interface EventCategoriesMetadata {
-    pulledAt: string;
-    eventCategories: Record<string, {
-        createdAt?: string;
-        updatedAt?: string;
-    }>;
-}
-/**
- * Read event categories metadata from .meta/event-categories.json
- *
- * @param contentDir - Base content directory
- * @returns Event categories metadata or null if not found
- */
-export declare function readEventCategoriesMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<EventCategoriesMetadata | null>;
-export interface EventsMetadata {
-    pulledAt: string;
-    events: Record<string, {
-        createdAt?: string;
-        updatedAt?: string;
-    }>;
-}
-/**
- * Read events metadata from .meta/events.json
- *
- * @param contentDir - Base content directory
- * @returns Events metadata or null if not found
- */
-export declare function readEventsMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<EventsMetadata | null>;
-export interface FooterMetadata {
-    pulledAt: string;
-    updatedAt?: string;
-}
-/**
- * Read footer metadata from .meta/footer.json
- *
- * @param contentDir - Base content directory
- * @returns Footer metadata or null if not found
- */
-export declare function readFooterMeta(contentDir: string, metadataTarget?: ContentMetadataTarget): Promise<FooterMetadata | null>;

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

@@ -1,142 +0,0 @@
-/**
- * Content File Writer
- *
- * Writes pulled content to the file system in the appropriate JSON format.
- */
-import type { PulledEntries, PulledPages, PulledNavigation, PulledSettings, PulledForms, PulledTheme, PulledFooter } from '../../client/management/types';
-import type { Theme } from '../../contracts';
-import { type EntryForOutput } from '../helpers';
-import type { EntryBaseSnapshotTarget } from '../merge-remote/entrySnapshots';
-import type { PageBaseSnapshotTarget } from '../merge-remote/pageSnapshots';
-import { type ContentMetadataTarget } from './metadataStore';
-export { writeEventCategories, writeEvents, writeForms, writeVenues, } from './collectionWriters';
-export { updateMetadataAfterPush } from './metadataAfterPush';
-export interface WriterOptions {
-    skipMeta?: boolean;
-    cleanupMissing?: boolean;
-    metadataTarget?: ContentMetadataTarget;
-    entryBaseSnapshot?: EntryBaseSnapshotTarget;
-    pageBaseSnapshot?: PageBaseSnapshotTarget;
-}
-type WritablePulledEntries = Omit<PulledEntries, 'entries'> & {
-    entries: EntryForOutput[];
-};
-/**
- * Write entries to content directory
- *
- * Format: content/entries/{contentType}/{identifier}.json (one file per entry)
- * Meta: content/.meta/{contentType}.json
- *
- * This is a breaking change from the old format (one file per content type).
- * Old format files are automatically deleted on pull.
- */
-export declare function writeEntries(contentDir: string, pulledEntries: WritablePulledEntries, options?: WriterOptions): Promise<{
-    dirPath: string;
-    metaPath: string;
-    count: number;
-}>;
-/**
- * Write pages to content directory
- *
- * Format: content/pages/{identifier}.json
- * Meta: content/.meta/pages.json
- */
-export declare function writePages(contentDir: string, pulledPages: PulledPages, options?: WriterOptions): Promise<{
-    filePaths: string[];
-    metaPath: string;
-}>;
-/**
- * Write navigation menus to content directory
- *
- * Format: content/navigation.json
- * Meta: content/.meta/navigation.json
- */
-export declare function writeNavigation(contentDir: string, pulledNavigation: PulledNavigation, options?: WriterOptions): Promise<{
-    filePath: string;
-    metaPath: string;
-}>;
-/**
- * Write settings to content directory
- *
- * Format: content/settings.json
- */
-export declare function writeSettings(contentDir: string, pulledSettings: PulledSettings, options?: WriterOptions): Promise<string>;
-/**
- * Write a theme to content directory
- *
- * Format: content/themes/{name}.json
- * Meta: content/.meta/themes.json (updated with this theme's metadata)
- *
- * @param contentDir - Base content directory
- * @param theme - Theme object to write
- * @param themeName - Name for the theme file (without .json)
- * @returns Path to the written file
- */
-export declare function writeTheme(contentDir: string, theme: Theme, themeName: string): Promise<string>;
-/**
- * Write themes metadata to .meta/themes.json
- *
- * @param contentDir - Base content directory
- * @param meta - Themes metadata
- */
-export declare function writeThemesMeta(contentDir: string, meta: {
-    pulledAt: string;
-    themes: Record<string, {
-        themeId: string;
-        selectionId: string;
-        updatedAt: string;
-    }>;
-}, options?: Pick<WriterOptions, 'metadataTarget'>): Promise<void>;
-/**
- * Write a pulled theme to content directory with metadata
- *
- * @param contentDir - Base content directory
- * @param pulledTheme - Pulled theme data from API
- * @param themeName - Name for the theme file (default: 'current')
- * @returns Path to written file and metadata path
- */
-export declare function writePulledTheme(contentDir: string, pulledTheme: PulledTheme, themeName?: string, options?: WriterOptions): Promise<{
-    filePath: string;
-    metaPath: string;
-}>;
-/**
- * Write footer content to content directory
- *
- * Format: content/footer.json
- * Meta: content/.meta/footer.json
- */
-export declare function writeFooter(contentDir: string, pulledFooter: PulledFooter, options?: WriterOptions): Promise<{
-    filePath: string;
-    metaPath: string;
-}>;
-/**
- * Write all pulled content to content directory
- */
-export interface WriteAllResult {
-    entries: Array<{
-        contentType: string;
-        dirPath: string;
-        metaPath: string;
-        count: number;
-    }>;
-    pages: {
-        filePaths: string[];
-        metaPath: string;
-    };
-    navigation: {
-        filePath: string;
-        metaPath: string;
-    };
-    settings: string;
-    forms: {
-        filePaths: string[];
-        metaPath: string;
-    };
-}
-export declare function writeAllContent(contentDir: string, content: {
-    entries: Record<string, PulledEntries['entries']>;
-    pages: PulledPages;
-    navigation: PulledNavigation;
-    settings: PulledSettings;
-    forms?: PulledForms;
-}): Promise<WriteAllResult>;

package/dist/_dts/sdk/src/cli/env-scope.d.ts

@@ -1,2 +0,0 @@
-import type { EnvTarget } from './helpers';
-export declare function withRiverbankEnv<T>(target: EnvTarget, run: () => Promise<T>): Promise<T>;

package/dist/_dts/sdk/src/cli/env.d.ts

@@ -1,71 +0,0 @@
-/**
- * CLI Environment Variable Loading
- *
- * Loads and validates environment variables for SDK CLI commands.
- */
-import { type SiteId } from '../../../core/src/index';
-/**
- * SDK environment configuration
- */
-export interface SdkEnvironment {
-    /** Site ID to operate on */
-    siteId: SiteId;
-    /** Dashboard URL (e.g., http://localhost:4000) */
-    dashboardUrl: string;
-    /** Management API key (bld_mgmt_sk_...) */
-    managementApiKey: string;
-    /** Content API key (bld_live_sk_...) for fetching content */
-    apiKey?: string;
-    /**
-     * Supabase URL for media storage.
-     * @deprecated No longer required - the SDK now fetches this from the CMS API.
-     * Kept for backward compatibility but ignored by media sync.
-     */
-    supabaseUrl?: string;
-}
-/**
- * Environment variable prefix based on target
- */
-export type EnvironmentTarget = 'local' | 'remote';
-/**
- * Get the environment variable name for a specific key and target.
- *
- * @example
- * ```ts
- * const envVar = getEnvVarName('DASHBOARD_URL', isRemote);
- * // Returns 'RIVERBANK_REMOTE_DASHBOARD_URL' or 'RIVERBANK_LOCAL_DASHBOARD_URL'
- * ```
- */
-export declare function getEnvVarName(key: 'SITE_ID' | 'DASHBOARD_URL' | 'MGMT_API_KEY', remote: boolean): string;
-/**
- * Get the prefix for environment variables based on target
- */
-export declare function getEnvPrefix(target: EnvironmentTarget): string;
-/**
- * Load SDK environment configuration
- *
- * @param remote - If true, load remote/production environment
- * @returns SDK environment configuration
- *
- * @example
- * ```typescript
- * // Load local environment
- * const env = loadEnvironment(false);
- *
- * // Load remote/production environment
- * const env = loadEnvironment(true);
- * ```
- */
-export declare function loadEnvironment(remote: boolean): SdkEnvironment;
-/**
- * Check if the remote environment is configured
- */
-export declare function isRemoteConfigured(): boolean;
-/**
- * Check if the local environment is configured
- */
-export declare function isLocalConfigured(): boolean;
-/**
- * Get environment variables for debugging (masked)
- */
-export declare function getEnvironmentDebugInfo(remote: boolean): Record<string, string>;