@riverbankcms/sdk 0.98.0 → 0.99.0

package/dist/_dts/db/src/generated/supabase/database.types.d.ts

@@ -1791,6 +1791,7 @@ export type Database = {
                     status: string;
                     stripe_customer_id: string;
                     stripe_subscription_id: string;
+                    subscription_origin: string | null;
                     trial_ends_at: string | null;
                     updated_at: string;
                     user_id: string;
@@ -1806,6 +1807,7 @@ export type Database = {
                     status: string;
                     stripe_customer_id: string;
                     stripe_subscription_id: string;
+                    subscription_origin?: string | null;
                     trial_ends_at?: string | null;
                     updated_at?: string;
                     user_id: string;
@@ -1821,6 +1823,7 @@ export type Database = {
                     status?: string;
                     stripe_customer_id?: string;
                     stripe_subscription_id?: string;
+                    subscription_origin?: string | null;
                     trial_ends_at?: string | null;
                     updated_at?: string;
                     user_id?: string;
@@ -4928,8 +4931,8 @@ export type Database = {
                     entry_slot_id: string | null;
                     id: string;
                     owner_kind: Database["public"]["Enums"]["content_owner_kind"];
-                    page_surface_id: string | null;
                     page_id: string | null;
+                    page_surface_id: string | null;
                     site_id: string;
                     stage: Database["public"]["Enums"]["content_stage"];
                     surface_slot_id: string | null;
@@ -4948,8 +4951,8 @@ export type Database = {
                     entry_slot_id?: string | null;
                     id?: string;
                     owner_kind?: Database["public"]["Enums"]["content_owner_kind"];
-                    page_surface_id?: string | null;
                     page_id?: string | null;
+                    page_surface_id?: string | null;
                     site_id: string;
                     stage?: Database["public"]["Enums"]["content_stage"];
                     surface_slot_id?: string | null;
@@ -4968,8 +4971,8 @@ export type Database = {
                     entry_slot_id?: string | null;
                     id?: string;
                     owner_kind?: Database["public"]["Enums"]["content_owner_kind"];
-                    page_surface_id?: string | null;
                     page_id?: string | null;
+                    page_surface_id?: string | null;
                     site_id?: string;
                     stage?: Database["public"]["Enums"]["content_stage"];
                     surface_slot_id?: string | null;
@@ -5007,17 +5010,17 @@ export type Database = {
                         referencedColumns: ["id"];
                     },
                     {
-                        foreignKeyName: "content_versions_page_surface_id_fkey";
-                        columns: ["page_surface_id"];
+                        foreignKeyName: "content_versions_page_id_fkey";
+                        columns: ["page_id"];
                         isOneToOne: false;
-                        referencedRelation: "page_surfaces";
+                        referencedRelation: "pages";
                         referencedColumns: ["id"];
                     },
                     {
-                        foreignKeyName: "content_versions_page_id_fkey";
-                        columns: ["page_id"];
+                        foreignKeyName: "content_versions_page_surface_id_fkey";
+                        columns: ["page_surface_id"];
                         isOneToOne: false;
-                        referencedRelation: "pages";
+                        referencedRelation: "page_surfaces";
                         referencedColumns: ["id"];
                     },
                     {
@@ -7444,8 +7447,6 @@ export type Database = {
                     reminder_sent_at: string | null;
                     site_id: string;
                     status: string;
-                    ticket_type_id: string | null;
-                    tickets_count: number;
                     updated_at: string;
                     waitlist_position: number | null;
                 };
@@ -7470,8 +7471,6 @@ export type Database = {
                     reminder_sent_at?: string | null;
                     site_id: string;
                     status?: string;
-                    ticket_type_id?: string | null;
-                    tickets_count?: number;
                     updated_at?: string;
                     waitlist_position?: number | null;
                 };
@@ -7496,8 +7495,6 @@ export type Database = {
                     reminder_sent_at?: string | null;
                     site_id?: string;
                     status?: string;
-                    ticket_type_id?: string | null;
-                    tickets_count?: number;
                     updated_at?: string;
                     waitlist_position?: number | null;
                 };
@@ -7564,13 +7561,6 @@ export type Database = {
                         isOneToOne: false;
                         referencedRelation: "sites";
                         referencedColumns: ["id"];
-                    },
-                    {
-                        foreignKeyName: "event_attendees_ticket_type_id_fkey";
-                        columns: ["ticket_type_id"];
-                        isOneToOne: false;
-                        referencedRelation: "event_ticket_types";
-                        referencedColumns: ["id"];
                     }
                 ];
             };
@@ -13408,6 +13398,207 @@ export type Database = {
                     }
                 ];
             };
+            site_billing_arrangement_changes: {
+                Row: {
+                    changed_by: string;
+                    created_at: string;
+                    id: string;
+                    new_arrangement: string;
+                    new_cost_cents: number;
+                    new_manual_note: string | null;
+                    new_manual_reason: string | null;
+                    previous_arrangement: string;
+                    previous_cost_cents: number;
+                    previous_manual_note: string | null;
+                    previous_manual_reason: string | null;
+                    reason: string | null;
+                    site_id: string;
+                    subscription_action: string;
+                    subscription_action_result: Json;
+                };
+                Insert: {
+                    changed_by: string;
+                    created_at?: string;
+                    id?: string;
+                    new_arrangement: string;
+                    new_cost_cents: number;
+                    new_manual_note?: string | null;
+                    new_manual_reason?: string | null;
+                    previous_arrangement: string;
+                    previous_cost_cents: number;
+                    previous_manual_note?: string | null;
+                    previous_manual_reason?: string | null;
+                    reason?: string | null;
+                    site_id: string;
+                    subscription_action: string;
+                    subscription_action_result?: Json;
+                };
+                Update: {
+                    changed_by?: string;
+                    created_at?: string;
+                    id?: string;
+                    new_arrangement?: string;
+                    new_cost_cents?: number;
+                    new_manual_note?: string | null;
+                    new_manual_reason?: string | null;
+                    previous_arrangement?: string;
+                    previous_cost_cents?: number;
+                    previous_manual_note?: string | null;
+                    previous_manual_reason?: string | null;
+                    reason?: string | null;
+                    site_id?: string;
+                    subscription_action?: string;
+                    subscription_action_result?: Json;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "site_billing_arrangement_changes_site_id_fkey";
+                        columns: ["site_id"];
+                        isOneToOne: false;
+                        referencedRelation: "sites";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            site_billing_manual_reviews: {
+                Row: {
+                    billing_user_id: string | null;
+                    created_at: string;
+                    created_by: string | null;
+                    details: Json;
+                    id: string;
+                    reason: string;
+                    resolution_action: string | null;
+                    resolution_note: string | null;
+                    resolved_at: string | null;
+                    resolved_by: string | null;
+                    site_id: string;
+                    status: string;
+                    stripe_subscription_id: string | null;
+                };
+                Insert: {
+                    billing_user_id?: string | null;
+                    created_at?: string;
+                    created_by?: string | null;
+                    details?: Json;
+                    id?: string;
+                    reason: string;
+                    resolution_action?: string | null;
+                    resolution_note?: string | null;
+                    resolved_at?: string | null;
+                    resolved_by?: string | null;
+                    site_id: string;
+                    status?: string;
+                    stripe_subscription_id?: string | null;
+                };
+                Update: {
+                    billing_user_id?: string | null;
+                    created_at?: string;
+                    created_by?: string | null;
+                    details?: Json;
+                    id?: string;
+                    reason?: string;
+                    resolution_action?: string | null;
+                    resolution_note?: string | null;
+                    resolved_at?: string | null;
+                    resolved_by?: string | null;
+                    site_id?: string;
+                    status?: string;
+                    stripe_subscription_id?: string | null;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "site_billing_manual_reviews_site_id_fkey";
+                        columns: ["site_id"];
+                        isOneToOne: false;
+                        referencedRelation: "sites";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
+            site_billing_transition_attempts: {
+                Row: {
+                    billing_user_id: string | null;
+                    created_at: string;
+                    created_by: string | null;
+                    error_message: string | null;
+                    external_action_result: Json;
+                    finalized_at: string | null;
+                    id: string;
+                    previous_arrangement: string;
+                    previous_billing_starts_at: string | null;
+                    previous_cost_cents: number;
+                    previous_manual_note: string | null;
+                    previous_manual_reason: string | null;
+                    site_id: string;
+                    status: string;
+                    stripe_subscription_id: string | null;
+                    subscription_action: string;
+                    target_arrangement: string;
+                    target_billing_starts_at: string | null;
+                    target_cost_cents: number;
+                    target_manual_note: string | null;
+                    target_manual_reason: string | null;
+                    updated_at: string;
+                };
+                Insert: {
+                    billing_user_id?: string | null;
+                    created_at?: string;
+                    created_by?: string | null;
+                    error_message?: string | null;
+                    external_action_result?: Json;
+                    finalized_at?: string | null;
+                    id?: string;
+                    previous_arrangement: string;
+                    previous_billing_starts_at?: string | null;
+                    previous_cost_cents: number;
+                    previous_manual_note?: string | null;
+                    previous_manual_reason?: string | null;
+                    site_id: string;
+                    status?: string;
+                    stripe_subscription_id?: string | null;
+                    subscription_action: string;
+                    target_arrangement: string;
+                    target_billing_starts_at?: string | null;
+                    target_cost_cents: number;
+                    target_manual_note?: string | null;
+                    target_manual_reason?: string | null;
+                    updated_at?: string;
+                };
+                Update: {
+                    billing_user_id?: string | null;
+                    created_at?: string;
+                    created_by?: string | null;
+                    error_message?: string | null;
+                    external_action_result?: Json;
+                    finalized_at?: string | null;
+                    id?: string;
+                    previous_arrangement?: string;
+                    previous_billing_starts_at?: string | null;
+                    previous_cost_cents?: number;
+                    previous_manual_note?: string | null;
+                    previous_manual_reason?: string | null;
+                    site_id?: string;
+                    status?: string;
+                    stripe_subscription_id?: string | null;
+                    subscription_action?: string;
+                    target_arrangement?: string;
+                    target_billing_starts_at?: string | null;
+                    target_cost_cents?: number;
+                    target_manual_note?: string | null;
+                    target_manual_reason?: string | null;
+                    updated_at?: string;
+                };
+                Relationships: [
+                    {
+                        foreignKeyName: "site_billing_transition_attempts_site_id_fkey";
+                        columns: ["site_id"];
+                        isOneToOne: false;
+                        referencedRelation: "sites";
+                        referencedColumns: ["id"];
+                    }
+                ];
+            };
             site_briefs: {
                 Row: {
                     ai_summary: string | null;
@@ -14816,7 +15007,6 @@ export type Database = {
                     billing_user_id: string | null;
                     created_at: string | null;
                     deployment_mode: Database["public"]["Enums"]["site_deployment_mode"];
-                    domain: string | null;
                     id: string;
                     is_sdk_site: boolean | null;
                     launched_at: string | null;
@@ -14825,6 +15015,9 @@ export type Database = {
                     monthly_cost_cents: number;
                     sdk_config: Json | null;
                     sdk_config_updated_at: string | null;
+                    site_billing_arrangement: string | null;
+                    site_billing_manual_note: string | null;
+                    site_billing_manual_reason: string | null;
                     slug: string;
                     surface_id: string;
                     timezone: string;
@@ -14837,7 +15030,6 @@ export type Database = {
                     billing_user_id?: string | null;
                     created_at?: string | null;
                     deployment_mode?: Database["public"]["Enums"]["site_deployment_mode"];
-                    domain?: string | null;
                     id?: string;
                     is_sdk_site?: boolean | null;
                     launched_at?: string | null;
@@ -14846,6 +15038,9 @@ export type Database = {
                     monthly_cost_cents?: number;
                     sdk_config?: Json | null;
                     sdk_config_updated_at?: string | null;
+                    site_billing_arrangement?: string | null;
+                    site_billing_manual_note?: string | null;
+                    site_billing_manual_reason?: string | null;
                     slug: string;
                     surface_id?: string;
                     timezone?: string;
@@ -14858,7 +15053,6 @@ export type Database = {
                     billing_user_id?: string | null;
                     created_at?: string | null;
                     deployment_mode?: Database["public"]["Enums"]["site_deployment_mode"];
-                    domain?: string | null;
                     id?: string;
                     is_sdk_site?: boolean | null;
                     launched_at?: string | null;
@@ -14867,6 +15061,9 @@ export type Database = {
                     monthly_cost_cents?: number;
                     sdk_config?: Json | null;
                     sdk_config_updated_at?: string | null;
+                    site_billing_arrangement?: string | null;
+                    site_billing_manual_note?: string | null;
+                    site_billing_manual_reason?: string | null;
                     slug?: string;
                     surface_id?: string;
                     timezone?: string;
@@ -16606,6 +16803,26 @@ export type Database = {
                     participant_participation_id: string;
                 }[];
             };
+            begin_site_billing_transition_attempt_atomic: {
+                Args: {
+                    p_billing_user_id?: string;
+                    p_created_by?: string;
+                    p_previous_arrangement?: string;
+                    p_previous_billing_starts_at?: string;
+                    p_previous_cost_cents?: number;
+                    p_previous_manual_note?: string;
+                    p_previous_manual_reason?: string;
+                    p_site_id: string;
+                    p_stripe_subscription_id?: string;
+                    p_subscription_action?: string;
+                    p_target_arrangement?: string;
+                    p_target_billing_starts_at?: string;
+                    p_target_cost_cents?: number;
+                    p_target_manual_note?: string;
+                    p_target_manual_reason?: string;
+                };
+                Returns: string;
+            };
             booking_record_entry_key_version_counts: {
                 Args: never;
                 Returns: {
@@ -16922,8 +17139,8 @@ export type Database = {
                     entry_slot_id: string;
                     id: string;
                     owner_kind: Database["public"]["Enums"]["content_owner_kind"];
-                    page_surface_id: string;
                     page_id: string;
+                    page_surface_id: string;
                     stage: Database["public"]["Enums"]["content_stage"];
                     surface_slot_id: string;
                     updated_at: string;
@@ -17093,8 +17310,6 @@ export type Database = {
                     p_payment_status: string;
                     p_site_id: string;
                     p_ticket_lines: Json;
-                    p_ticket_type_id: string;
-                    p_tickets_count: number;
                 };
                 Returns: {
                     attendee_id: string;
@@ -17244,6 +17459,15 @@ export type Database = {
                     count: number;
                 }[];
             };
+            finalize_site_billing_transition_attempt_atomic: {
+                Args: {
+                    p_attempt_id: string;
+                    p_changed_by: string;
+                    p_reason?: string;
+                    p_subscription_action_result?: Json;
+                };
+                Returns: undefined;
+            };
             finalize_site_invitation_resend: {
                 Args: {
                     p_actor_user_id: string;
@@ -17945,6 +18169,26 @@ export type Database = {
                 };
                 Returns: undefined;
             };
+            update_site_billing_arrangement_atomic: {
+                Args: {
+                    p_changed_by: string;
+                    p_next_arrangement: string;
+                    p_next_billing_starts_at?: string;
+                    p_next_cost_cents: number;
+                    p_next_manual_note?: string;
+                    p_next_manual_reason?: string;
+                    p_previous_arrangement?: string;
+                    p_previous_billing_starts_at?: string;
+                    p_previous_cost_cents?: number;
+                    p_previous_manual_note?: string;
+                    p_previous_manual_reason?: string;
+                    p_reason?: string;
+                    p_site_id: string;
+                    p_subscription_action?: string;
+                    p_subscription_action_result?: Json;
+                };
+                Returns: undefined;
+            };
             use_admin_invite: {
                 Args: {
                     p_token: string;
@@ -18109,7 +18353,7 @@ export type Database = {
             billing_interval: "monthly" | "annual";
             cancellation_context_category: "customer_requested" | "schedule_conflict" | "duplicate_or_admin_error" | "non_payment" | "policy_or_eligibility" | "other" | "legacy_client_unspecified";
             content_entry_status: "draft" | "scheduled" | "published" | "archived";
-            content_owner_kind: "block" | "entry" | "page" | "entry_slot" | "page_surface" | "surface_slot";
+            content_owner_kind: "block" | "entry" | "page" | "entry_slot" | "surface_slot" | "page_surface";
             content_stage: "draft" | "published";
             gsc_property_type: "domain" | "url_prefix";
             impersonation_scope: "read" | "write";
@@ -18851,7 +19095,7 @@ export declare const Constants: {
             readonly billing_interval: readonly ["monthly", "annual"];
             readonly cancellation_context_category: readonly ["customer_requested", "schedule_conflict", "duplicate_or_admin_error", "non_payment", "policy_or_eligibility", "other", "legacy_client_unspecified"];
             readonly content_entry_status: readonly ["draft", "scheduled", "published", "archived"];
-            readonly content_owner_kind: readonly ["block", "entry", "page", "entry_slot", "page_surface", "surface_slot"];
+            readonly content_owner_kind: readonly ["block", "entry", "page", "entry_slot", "surface_slot", "page_surface"];
             readonly content_stage: readonly ["draft", "published"];
             readonly gsc_property_type: readonly ["domain", "url_prefix"];
             readonly impersonation_scope: readonly ["read", "write"];

package/dist/_dts/sdk/src/__mocks__/next-cache.d.ts

@@ -1,7 +1,7 @@
 /**
  * Mock implementation of next/cache for testing
  */
-import { vi } from 'vitest';
+import { vi } from 'bun:test';
 export declare const revalidateTag: ReturnType<typeof vi.fn<(tag: string, profile?: string) => void>>;
 export declare const revalidatePath: ReturnType<typeof vi.fn<(path: string) => void>>;
 export declare const unstable_cache: <T extends (...args: never[]) => unknown>(fn: T) => T;

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

@@ -19,9 +19,22 @@
  *   riverbankcms push --dry-run          # Show what would be pushed
  */
 import { Command } from 'commander';
+import { allEnvSucceeded, getOutputContext, runForEnvironments } from '../helpers';
+import { executePushForEnv } from './push-execute';
+import { emitPushVerificationResult, isPushVerificationClean, verifyPushNoopForEnv } from './push/verification';
 export { contentSummaryHasPushableContent, noContentFoundWarningDetails } from './push-execute';
 export { VALID_PUSH_SCOPES, isValidPushScope, type PushScope } from './push/consts';
 export { calculateMetadataUpdates, type MetadataUpdateFlags } from './push/metadata';
 export { filterLocalContent, type FilterResult } from './push/filter';
 export { checkForStaleContent, type StaleItem } from './push/stale';
+export type PushCommandDeps = Readonly<{
+    getOutputContext: typeof getOutputContext;
+    runForEnvironments: typeof runForEnvironments;
+    allEnvSucceeded: typeof allEnvSucceeded;
+    executePushForEnv: typeof executePushForEnv;
+    verifyPushNoopForEnv: typeof verifyPushNoopForEnv;
+    emitPushVerificationResult: typeof emitPushVerificationResult;
+    isPushVerificationClean: typeof isPushVerificationClean;
+}>;
+export declare function createPushCommand(deps?: PushCommandDeps): Command;
 export declare const pushCommand: Command;

package/dist/_dts/sdk/src/cli/merge-remote/entryMergeReport.d.ts

@@ -1,26 +1,13 @@
 import type { OutputContext } from '../output';
-import type { EntryMergeConflict, EntryMergeDecision } from './entryMerge';
+import type { EntryMergeDecision } from './entryMerge';
 import type { RemoteEntryMergePlan } from './entryMergePlan';
-export type RemoteEntryMergeJsonReport = Readonly<{
-    kind: 'push';
-    scope: 'entries';
-    mergeRemote: true;
-    dryRun: boolean;
-    summary: RemoteEntryMergePlan['summary'];
-    decisions: readonly RemoteEntryMergeDecisionReport[];
-}>;
-export type RemoteEntryMergeDecisionReport = Readonly<{
-    kind: EntryMergeDecision['kind'];
+import { type RemoteMergeDecisionReport, type RemoteMergeJsonReport } from './sharedMergeReport';
+type RemoteEntryMergeSubjectJson = Readonly<{
     contentType: string;
     identifier: string;
-    localFieldPaths?: readonly string[];
-    remoteFieldPaths?: readonly string[];
-    conflict?: Readonly<{
-        code: EntryMergeConflict['code'];
-        fieldPath?: string;
-        message: string;
-    }>;
 }>;
+export type RemoteEntryMergeDecisionReport = RemoteMergeDecisionReport<EntryMergeDecision, RemoteEntryMergeSubjectJson>;
+export type RemoteEntryMergeJsonReport = RemoteMergeJsonReport<'entries', RemoteEntryMergePlan['summary'], EntryMergeDecision, RemoteEntryMergeSubjectJson>;
 export declare function remoteEntryMergeJsonReport(input: Readonly<{
     plan: RemoteEntryMergePlan;
     dryRun: boolean;
@@ -28,3 +15,4 @@ export declare function remoteEntryMergeJsonReport(input: Readonly<{
 export declare function writeRemoteEntryMergeHumanReport(output: Pick<OutputContext, 'info'>, plan: RemoteEntryMergePlan, options: Readonly<{
     dryRun: boolean;
 }>): void;
+export {};

package/dist/_dts/sdk/src/cli/merge-remote/entrySnapshots.d.ts

@@ -1,10 +1,8 @@
 import type { PulledEntries } from '../../client/management/types';
 import type { EntryForOutput, EnvTarget } from '../helpers';
 import type { LocalEntry } from '../content/reader';
-export type EntryBaseSnapshotTarget = Readonly<{
-    env: EnvTarget;
-    siteId: string;
-}>;
+import { type BaseSnapshotTarget } from './sharedBaseSnapshots';
+export type EntryBaseSnapshotTarget = BaseSnapshotTarget;
 export type EntryBaseSnapshotSubject = Readonly<{
     contentType: string;
     identifier: string;

package/dist/_dts/sdk/src/cli/merge-remote/pageMergeReport.d.ts

@@ -1,25 +1,12 @@
 import type { OutputContext } from '../output';
-import type { PageMergeConflict, PageMergeDecision } from './pageMerge';
+import type { PageMergeDecision } from './pageMerge';
 import type { RemotePageMergePlan } from './pageMergePlan';
-export type RemotePageMergeJsonReport = Readonly<{
-    kind: 'push';
-    scope: 'pages';
-    mergeRemote: true;
-    dryRun: boolean;
-    summary: RemotePageMergePlan['summary'];
-    decisions: readonly RemotePageMergeDecisionReport[];
-}>;
-export type RemotePageMergeDecisionReport = Readonly<{
-    kind: PageMergeDecision['kind'];
+import { type RemoteMergeDecisionReport, type RemoteMergeJsonReport } from './sharedMergeReport';
+type RemotePageMergeSubjectJson = Readonly<{
     identifier: string;
-    localFieldPaths?: readonly string[];
-    remoteFieldPaths?: readonly string[];
-    conflict?: Readonly<{
-        code: PageMergeConflict['code'];
-        fieldPath?: string;
-        message: string;
-    }>;
 }>;
+export type RemotePageMergeDecisionReport = RemoteMergeDecisionReport<PageMergeDecision, RemotePageMergeSubjectJson>;
+export type RemotePageMergeJsonReport = RemoteMergeJsonReport<'pages', RemotePageMergePlan['summary'], PageMergeDecision, RemotePageMergeSubjectJson>;
 export declare function remotePageMergeJsonReport(input: Readonly<{
     plan: RemotePageMergePlan;
     dryRun: boolean;
@@ -27,3 +14,4 @@ export declare function remotePageMergeJsonReport(input: Readonly<{
 export declare function writeRemotePageMergeHumanReport(output: Pick<OutputContext, 'info'>, plan: RemotePageMergePlan, options: Readonly<{
     dryRun: boolean;
 }>): void;
+export {};

package/dist/_dts/sdk/src/cli/merge-remote/pageSnapshots.d.ts

@@ -1,10 +1,8 @@
 import type { PulledPages } from '../../client/management/types';
 import type { EnvTarget } from '../helpers';
 import type { LocalPage } from '../content/reader';
-export type PageBaseSnapshotTarget = Readonly<{
-    env: EnvTarget;
-    siteId: string;
-}>;
+import { type BaseSnapshotTarget } from './sharedBaseSnapshots';
+export type PageBaseSnapshotTarget = BaseSnapshotTarget;
 export type PageBaseSnapshotSubject = Readonly<{
     identifier: string;
 }>;

package/dist/_dts/sdk/src/cli/merge-remote/sharedBaseSnapshots.d.ts

@@ -0,0 +1,32 @@
+import type { EnvTarget } from '../helpers';
+export type BaseSnapshotTarget = Readonly<{
+    env: EnvTarget;
+    siteId: string;
+}>;
+export type BaseSnapshotStoredTarget = Readonly<{
+    env: EnvTarget;
+    siteIdHash: string;
+}>;
+export type WriteBaseSnapshotsInput<TItem, TSnapshot> = Readonly<{
+    contentDir: string;
+    rootDir: string;
+    snapshotDir: string;
+    items: readonly TItem[];
+    toSnapshot(item: TItem): TSnapshot;
+    fileNameForSnapshot(snapshot: TSnapshot): string;
+    cleanupMissing?: boolean;
+}>;
+export type WriteBaseSnapshotsResult = Readonly<{
+    rootDir: string;
+    count: number;
+}>;
+export declare function baseSnapshotRoot(contentDir: string, baseKind: string): string;
+export declare function baseSnapshotStoredTarget(target: BaseSnapshotTarget): BaseSnapshotStoredTarget;
+export declare function siteScopedSnapshotDir(input: Readonly<{
+    rootDir: string;
+    target: BaseSnapshotTarget;
+    leafDir: string;
+}>): string;
+export declare function writeBaseSnapshots<TItem, TSnapshot>(input: WriteBaseSnapshotsInput<TItem, TSnapshot>): Promise<WriteBaseSnapshotsResult>;
+export declare function readBaseSnapshot<TSnapshot>(snapshotPath: string): Promise<TSnapshot | null>;
+export declare function encodeSnapshotPathPart(value: string): string;