@riverbankcms/sdk 0.62.4 → 0.67.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", "form", "footer", "content", "staff", "venue", "event", "ticket", "course", "pass", "membership", "customer", "customer_pass", "customer_membership", "appointment", "course_enrollment", "event_registration", "pass_redemption", "order", "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", "delete", "order_transition", "status_transition"];
+export type WriteSemantics = (typeof writeSemantics)[number];
+export declare const lifecycleIntents: readonly ["mutation", "publish", "unpublish", "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/exposure.d.ts

@@ -0,0 +1,41 @@
+import type { SiteCommandBatch, SiteCommandType } from './commands';
+import type { AllowedRuntime, CommandRisk, IntendedExposure, SiteCommandCapabilityGap, SiteCommandMetadata } from './domain';
+import type { SiteCommandRef } from './refs';
+export type SiteCommandExposureTarget = Readonly<{
+    type: SiteCommandType;
+    ref?: SiteCommandRef | string;
+}>;
+export type SiteCommandExposurePolicy = Readonly<{
+    exposure: IntendedExposure;
+    runtime: AllowedRuntime;
+    allowedRisks: readonly CommandRisk[];
+    capabilityGaps?: readonly SiteCommandCapabilityGap[];
+}>;
+export type SiteCommandExposureAllowed = Readonly<{
+    kind: 'allowed';
+    commandType: SiteCommandType;
+    commandRef: SiteCommandRef | string | null;
+    metadata: SiteCommandMetadata;
+}>;
+export type SiteCommandExposureRejection = Readonly<{
+    kind: 'rejected';
+    code: 'unsupported_command' | 'exposure_not_allowed' | 'runtime_not_allowed' | 'risk_not_allowed' | 'capability_gap';
+    commandType: SiteCommandType;
+    commandRef: SiteCommandRef | string | null;
+    message: string;
+}>;
+export type SiteCommandExposureDecision = SiteCommandExposureAllowed | SiteCommandExposureRejection;
+export type SiteCommandBatchExposureAllowed = Readonly<{
+    kind: 'allowed';
+    commands: readonly SiteCommandExposureAllowed[];
+}>;
+export type SiteCommandBatchExposureRejection = Readonly<{
+    kind: 'rejected_batch';
+    code: 'empty_batch';
+    commandType: null;
+    commandRef: null;
+    message: string;
+}>;
+export type SiteCommandBatchExposureDecision = SiteCommandBatchExposureAllowed | SiteCommandExposureRejection | SiteCommandBatchExposureRejection;
+export declare function evaluateSiteCommandExposure(command: SiteCommandExposureTarget, policy: SiteCommandExposurePolicy): SiteCommandExposureDecision;
+export declare function evaluateSiteCommandBatchExposure(batch: SiteCommandBatch, policy: SiteCommandExposurePolicy): SiteCommandBatchExposureDecision;

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,10 @@
+export * from './adapter';
+export * from './capabilityGaps';
+export * from './commands';
+export * from './domain';
+export * from './exposure';
+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,503 @@
+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: "high";
+        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 upsertPageBlock: {
+        readonly scope: "block";
+        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.blocks.write";
+        readonly support: "supported";
+    };
+    readonly deletePageBlock: {
+        readonly scope: "block";
+        readonly risk: "medium";
+        readonly writeSemantics: "delete";
+        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: "pages.blocks.delete";
+        readonly support: "supported";
+    };
+    readonly reorderPageBlocks: {
+        readonly scope: "block";
+        readonly risk: "medium";
+        readonly writeSemantics: "order_transition";
+        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.reorder";
+        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 upsertForm: {
+        readonly scope: "form";
+        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 ["sdk_cli", "internal_apply"];
+        readonly capability: "forms.write";
+        readonly support: "supported";
+    };
+    readonly upsertFooterContent: {
+        readonly scope: "footer";
+        readonly risk: "low";
+        readonly writeSemantics: "upsert";
+        readonly lifecycleIntent: "mutation";
+        readonly idempotencyStrategy: "existing_id";
+        readonly conflictPolicy: "update_existing";
+        readonly previewability: "static_preview";
+        readonly allowedRuntimes: readonly ["development", "staging", "demo", "production"];
+        readonly intendedExposure: readonly ["sdk_cli", "internal_apply"];
+        readonly capability: "footer.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 unpublishPage: {
+        readonly scope: "publish";
+        readonly risk: "medium";
+        readonly writeSemantics: "status_transition";
+        readonly lifecycleIntent: "unpublish";
+        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: "pages.unpublish";
+        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: "unpublish";
+        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 seedPortalOrder: {
+        readonly scope: "order";
+        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: "commerce.orders.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;