@riverbankcms/sdk 0.62.2 → 0.64.0

package/dist/_dts/site-commands/src/domain.d.ts

@@ -0,0 +1,104 @@
+import type { Brand } from '@riverbankcms/core';
+import type { SiteCommandCapabilityGapCode } from './capabilityGaps';
+import type { SiteCommandType } from './commands';
+import type { SiteCommandRef } from './refs';
+export declare const commandScopes: readonly ["site", "style", "media", "page", "block", "navigation", "content", "staff", "venue", "event", "ticket", "course", "pass", "membership", "customer", "customer_pass", "customer_membership", "appointment", "course_enrollment", "event_registration", "pass_redemption", "booking_settings", "appointment_service", "appointment_resource", "appointment_availability", "publish"];
+export type CommandScope = (typeof commandScopes)[number];
+export declare const commandRisks: readonly ["low", "medium", "high", "restricted"];
+export type CommandRisk = (typeof commandRisks)[number];
+export declare const writeSemantics: readonly ["upsert", "append", "replace", "status_transition"];
+export type WriteSemantics = (typeof writeSemantics)[number];
+export declare const lifecycleIntents: readonly ["mutation", "publish", "seed"];
+export type LifecycleIntent = (typeof lifecycleIntents)[number];
+export declare const idempotencyStrategies: readonly ["natural_key", "recipe_ref", "existing_id", "none"];
+export type IdempotencyStrategy = (typeof idempotencyStrategies)[number];
+export declare const conflictPolicies: readonly ["update_existing", "fail_if_exists", "append_once", "allow_duplicates"];
+export type ConflictPolicy = (typeof conflictPolicies)[number];
+export declare const commandPreviewabilities: readonly ["static_preview", "dry_run_only", "effect_required"];
+export type CommandPreviewability = (typeof commandPreviewabilities)[number];
+export declare const allowedRuntimes: readonly ["development", "staging", "demo", "production", "internal_only"];
+export type AllowedRuntime = (typeof allowedRuntimes)[number];
+export declare const intendedExposures: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+export type IntendedExposure = (typeof intendedExposures)[number];
+export declare const capabilityGapVerdicts: readonly ["supported", "needs_extension", "needs_new_surface", "v1_informational_fallback", "unknown"];
+export type CapabilityGapVerdict = (typeof capabilityGapVerdicts)[number];
+export type SiteCommandIdempotencyKey = Brand<string, 'SiteCommandIdempotencyKey'>;
+export type SiteCommandResourceId = Brand<string, 'SiteCommandResourceId'>;
+export type SiteCommandResourceIds = Readonly<Record<string, SiteCommandResourceId>>;
+export declare const unsafeAsSiteCommandIdempotencyKey: (value: string) => SiteCommandIdempotencyKey;
+export declare const unsafeAsSiteCommandResourceId: (value: string) => SiteCommandResourceId;
+export type SiteCommandSemanticMetadata = Readonly<{
+    scope: CommandScope;
+    risk: CommandRisk;
+    writeSemantics: WriteSemantics;
+    lifecycleIntent: LifecycleIntent;
+    idempotencyStrategy: IdempotencyStrategy;
+    conflictPolicy: ConflictPolicy;
+    previewability: CommandPreviewability;
+}>;
+export type SiteCommandConsumerPolicy = Readonly<{
+    allowedRuntimes: readonly AllowedRuntime[];
+    intendedExposure: readonly IntendedExposure[];
+    capability: string;
+    support: CapabilityGapVerdict;
+}>;
+export type SiteCommandMetadata = SiteCommandSemanticMetadata & SiteCommandConsumerPolicy;
+export type SiteCommandCapabilityGap = Readonly<{
+    commandRef: SiteCommandRef;
+    commandType: SiteCommandType;
+    coverage: CapabilityGapVerdict;
+    code: SiteCommandCapabilityGapCode;
+    message: string;
+}>;
+export type SiteCommandValidationError = Readonly<{
+    code: 'unknown_command_type';
+    commandIndex: number;
+    commandType: string;
+    message: string;
+}> | Readonly<{
+    code: 'invalid_command_payload';
+    commandIndex: number;
+    commandType: string | null;
+    field: string;
+    message: string;
+}> | Readonly<{
+    code: 'duplicate_command_ref';
+    commandRef: string;
+    message: string;
+}> | Readonly<{
+    code: 'duplicate_resource_ref';
+    resourceRef: string;
+    message: string;
+}> | Readonly<{
+    code: 'missing_ref';
+    commandRef: string;
+    field: string;
+    missingRef: string;
+    message: string;
+}> | Readonly<{
+    code: 'command_invariant_violation';
+    commandRef: SiteCommandRef | string;
+    field: string;
+    message: string;
+}> | Readonly<{
+    code: 'unsupported_command_type_for_plan';
+    commandRef: SiteCommandRef | string;
+    commandType: SiteCommandType;
+    message: string;
+}> | Readonly<{
+    code: 'invalid_ref_format';
+    commandRef: string | null;
+    field: string;
+    ref: string;
+    message: string;
+}> | Readonly<{
+    code: 'unknown_resource_kind';
+    commandRef: string | null;
+    field: string;
+    ref: string;
+    message: string;
+}> | Readonly<{
+    code: 'cyclic_dependency';
+    commandRefs: readonly string[];
+    message: string;
+}>;

package/dist/_dts/site-commands/src/guards.d.ts

@@ -0,0 +1 @@
+export declare function isRecord(value: unknown): value is Record<string, unknown>;

package/dist/_dts/site-commands/src/index.d.ts

@@ -0,0 +1,9 @@
+export * from './adapter';
+export * from './capabilityGaps';
+export * from './commands';
+export * from './domain';
+export * from './metadata';
+export * from './planner';
+export * from './refContributions';
+export * from './refs';
+export * from './staticExecutionGaps';

package/dist/_dts/site-commands/src/metadata.d.ts

@@ -0,0 +1,412 @@
+import type { SiteCommandConsumerPolicy, SiteCommandMetadata, SiteCommandSemanticMetadata } from './domain';
+import type { LifecycleIntent } from './domain';
+import type { SiteCommand, SiteCommandType } from './commands';
+export declare const siteCommandMetadata: {
+    readonly configureSiteIdentity: {
+        readonly scope: "site";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "internal_apply"];
+        readonly capability: "site.settings.write";
+        readonly support: "supported";
+    };
+    readonly configureBookingSettings: {
+        readonly scope: "booking_settings";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.settings.write";
+        readonly support: "supported";
+    };
+    readonly applySiteStyle: {
+        readonly scope: "style";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "natural_key";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "theme.write";
+        readonly support: "supported";
+    };
+    readonly upsertMediaAsset: {
+        readonly scope: "media";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "natural_key";
+        readonly conflictPolicy: "fail_if_exists";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "internal_apply"];
+        readonly capability: "media.write";
+        readonly support: "supported";
+    };
+    readonly upsertPage: {
+        readonly scope: "page";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "pages.write";
+        readonly support: "supported";
+    };
+    readonly upsertBlockTree: {
+        readonly scope: "block";
+        readonly risk: "low";
+        readonly writeSemantics: "replace";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "pages.blocks.write";
+        readonly support: "supported";
+    };
+    readonly upsertNavigationMenu: {
+        readonly scope: "navigation";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "natural_key";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "navigation.write";
+        readonly support: "supported";
+    };
+    readonly upsertContentEntry: {
+        readonly scope: "content";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "content.write";
+        readonly support: "supported";
+    };
+    readonly publishPage: {
+        readonly scope: "publish";
+        readonly risk: "medium";
+        readonly writeSemantics: "status_transition";
+        readonly lifecycleIntent: "publish";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "effect_required";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "pages.publish";
+        readonly support: "supported";
+    };
+    readonly publishContentEntry: {
+        readonly scope: "publish";
+        readonly risk: "medium";
+        readonly writeSemantics: "status_transition";
+        readonly lifecycleIntent: "publish";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "effect_required";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "sdk_cli", "onboarding_planner", "ai_proposal", "internal_apply"];
+        readonly capability: "content.publish";
+        readonly support: "supported";
+    };
+    readonly unpublishContentEntry: {
+        readonly scope: "publish";
+        readonly risk: "medium";
+        readonly writeSemantics: "status_transition";
+        readonly lifecycleIntent: "publish";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "effect_required";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["sdk_cli", "internal_apply"];
+        readonly capability: "content.unpublish";
+        readonly support: "supported";
+    };
+    readonly deleteContentEntry: {
+        readonly scope: "content";
+        readonly risk: "high";
+        readonly writeSemantics: "replace";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "effect_required";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["sdk_cli", "internal_apply"];
+        readonly capability: "content.delete";
+        readonly support: "supported";
+    };
+    readonly upsertStaffMember: {
+        readonly scope: "staff";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.staff.write";
+        readonly support: "supported";
+    };
+    readonly ensureTeamMemberProfile: {
+        readonly scope: "content";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "team_members.profile.write";
+        readonly support: "supported";
+    };
+    readonly upsertVenue: {
+        readonly scope: "venue";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.venues.write";
+        readonly support: "supported";
+    };
+    readonly upsertEventSeries: {
+        readonly scope: "event";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.events.write";
+        readonly support: "supported";
+    };
+    readonly upsertEventTicketType: {
+        readonly scope: "ticket";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.event_tickets.write";
+        readonly support: "supported";
+    };
+    readonly upsertCourse: {
+        readonly scope: "course";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.courses.write";
+        readonly support: "supported";
+    };
+    readonly upsertBookingPassProduct: {
+        readonly scope: "pass";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.passes.write";
+        readonly support: "supported";
+    };
+    readonly upsertBookingMembershipProduct: {
+        readonly scope: "membership";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.memberships.write";
+        readonly support: "supported";
+    };
+    readonly seedBookingCustomer: {
+        readonly scope: "customer";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "natural_key";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.customers.write";
+        readonly support: "supported";
+    };
+    readonly grantCustomerPass: {
+        readonly scope: "customer_pass";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.customer_passes.write";
+        readonly support: "supported";
+    };
+    readonly grantCustomerMembership: {
+        readonly scope: "customer_membership";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.customer_memberships.write";
+        readonly support: "supported";
+    };
+    readonly seedAppointmentBooking: {
+        readonly scope: "appointment";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.appointments.write";
+        readonly support: "supported";
+    };
+    readonly seedCourseEnrollment: {
+        readonly scope: "course_enrollment";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.course_enrollments.write";
+        readonly support: "supported";
+    };
+    readonly seedEventRegistration: {
+        readonly scope: "event_registration";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.event_registrations.write";
+        readonly support: "supported";
+    };
+    readonly seedPassRedemption: {
+        readonly scope: "pass_redemption";
+        readonly risk: "medium";
+        readonly writeSemantics: "append";
+        readonly lifecycleIntent: "seed";
+        readonly idempotencyStrategy: "natural_key";
+        readonly conflictPolicy: "append_once";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.pass_redemptions.write";
+        readonly support: "supported";
+    };
+    readonly upsertAppointmentService: {
+        readonly scope: "appointment_service";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.appointment_services.write";
+        readonly support: "supported";
+    };
+    readonly upsertBookableResource: {
+        readonly scope: "appointment_resource";
+        readonly risk: "medium";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.appointment_resources.write";
+        readonly support: "supported";
+    };
+    readonly assignAppointmentServiceResources: {
+        readonly scope: "appointment_service";
+        readonly risk: "medium";
+        readonly writeSemantics: "replace";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.appointment_services.resources.write";
+        readonly support: "supported";
+    };
+    readonly configureAppointmentAvailability: {
+        readonly scope: "appointment_availability";
+        readonly risk: "high";
+        readonly writeSemantics: "replace";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "recipe_ref";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "dry_run_only";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["recipe", "onboarding_planner", "internal_apply"];
+        readonly capability: "bookings.appointment_availability.write";
+        readonly support: "supported";
+    };
+};
+export declare function getSiteCommandMetadata(type: SiteCommandType): SiteCommandMetadata;
+export declare function getSiteCommandSemanticMetadata(type: SiteCommandType): SiteCommandSemanticMetadata;
+export declare function getSiteCommandConsumerPolicy(type: SiteCommandType): SiteCommandConsumerPolicy;
+export declare function getSiteCommandLifecycleIntent(command: SiteCommand): LifecycleIntent;

package/dist/_dts/site-commands/src/planner.d.ts

@@ -0,0 +1,51 @@
+import { type Result } from '@riverbankcms/core';
+import { type SiteCommand, type SiteCommandBatch, type SiteCommandOf, type SiteCommandType } from './commands';
+import { type CommandRisk, type LifecycleIntent, type SiteCommandCapabilityGap, type SiteCommandIdempotencyKey, type SiteCommandMetadata, type SiteCommandValidationError } from './domain';
+import { type ResourceRef } from './refs';
+export type PlannedSiteCommandFor<TType extends SiteCommandType> = Readonly<{
+    command: SiteCommandOf<TType>;
+    metadata: SiteCommandMetadata;
+    lifecycleIntent: LifecycleIntent;
+    provides: readonly ResourceRef[];
+    requires: readonly ResourceRef[];
+    idempotencyKey: SiteCommandIdempotencyKey;
+}>;
+export type PlannedSiteCommand = {
+    [TType in SiteCommandType]: PlannedSiteCommandFor<TType>;
+}[SiteCommandType];
+export type SiteCommandPlan = Readonly<{
+    batch: SiteCommandBatch;
+    commands: readonly PlannedSiteCommand[];
+    capabilityGaps: readonly SiteCommandCapabilityGap[];
+}>;
+export type PlannedSiteCommandOf<TType extends SiteCommandType> = {
+    [TCommandType in TType]: PlannedSiteCommandFor<TCommandType>;
+}[TType];
+export type SiteCommandPlanFor<TType extends SiteCommandType> = Omit<SiteCommandPlan, 'commands'> & Readonly<{
+    commands: readonly PlannedSiteCommandOf<TType>[];
+}>;
+export declare function parseCommandBatch(input: unknown): Result<SiteCommandBatch, readonly SiteCommandValidationError[]>;
+export declare function planCommandBatch(batch: SiteCommandBatch): Result<SiteCommandPlan, readonly SiteCommandValidationError[]>;
+export declare function parseAndPlanCommandBatch(input: unknown): Result<SiteCommandPlan, readonly SiteCommandValidationError[]>;
+export declare function parseAndPlanCommandBatchForTypes<TType extends SiteCommandType>(input: unknown, allowedTypes: readonly TType[]): Result<SiteCommandPlanFor<TType>, readonly SiteCommandValidationError[]>;
+export declare function narrowSiteCommandPlan<TType extends SiteCommandType>(plan: SiteCommandPlan, allowedTypes: readonly TType[]): Result<SiteCommandPlanFor<TType>, readonly SiteCommandValidationError[]>;
+export declare function deriveIdempotencyKey(input: Readonly<{
+    batch: Pick<SiteCommandBatch, 'batchRef' | 'target'>;
+    command: Pick<SiteCommand, 'type' | 'ref'>;
+    metadata: Pick<SiteCommandMetadata, 'idempotencyStrategy'>;
+}>): SiteCommandIdempotencyKey;
+export type DryRunReport = Readonly<{
+    status: 'dry_run_passed' | 'dry_run_passed_with_gaps';
+    commandCount: number;
+    mutationCount: number;
+    publishCount: number;
+    seedCount: number;
+    riskSummary: Readonly<Record<CommandRisk, number>>;
+    executionOrder: readonly Readonly<{
+        ref: string;
+        type: SiteCommandType;
+    }>[];
+    resolvedRefs: readonly ResourceRef[];
+    capabilityGaps: readonly SiteCommandCapabilityGap[];
+}>;
+export declare function createDryRunReport(plan: SiteCommandPlan): DryRunReport;

package/dist/_dts/site-commands/src/refContributions.d.ts

@@ -0,0 +1,10 @@
+import type { SiteCommand } from './commands';
+export type RefContribution = Readonly<{
+    ref: string;
+    field: string;
+}>;
+export type CommandRefContributions = Readonly<{
+    provides: readonly RefContribution[];
+    requires: readonly RefContribution[];
+}>;
+export declare function commandRefContributions(command: SiteCommand): CommandRefContributions;