@tailor-platform/sdk 2.4.0 → 2.6.0

package/dist/assert-WeXvmG4j.mjs

@@ -0,0 +1,2 @@
+function assertDefined(e,t){if(e==null)throw Error(t);return e}export{assertDefined as t};
+//# sourceMappingURL=assert-WeXvmG4j.mjs.map

package/dist/{assert-DBxo8jPo.mjs.map → assert-WeXvmG4j.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"assert-DBxo8jPo.mjs","names":[],"sources":["../src/utils/assert.ts"],"sourcesContent":["export function assertDefined<T>(value: T, message: string): NonNullable<T> {\n  if (value == null) {\n    throw new Error(message);\n  }\n  return value;\n}\n"],"mappings":";AAAA,SAAgB,cAAiB,OAAU,SAAiC;CAC1E,IAAI,SAAS,MACX,MAAM,IAAI,MAAM,OAAO;CAEzB,OAAO;AACT"}
+{"version":3,"file":"assert-WeXvmG4j.mjs","names":[],"sources":["../src/utils/assert.ts"],"sourcesContent":["export function assertDefined<T>(value: T, message: string): NonNullable<T> {\n  if (value == null) {\n    throw new Error(message);\n  }\n  return value;\n}\n"],"mappings":"AAAA,SAAgB,cAAiB,EAAU,EAAiC,CAC1E,GAAI,GAAS,KACX,MAAU,MAAM,CAAO,EAEzB,OAAO,CACT"}

package/dist/authconnection-CynFBIv8.mjs

@@ -0,0 +1,2 @@
+const api=()=>globalThis.tailor.authconnection,e={getConnectionToken:(...e)=>api().getConnectionToken(...e)};export{e as t};
+//# sourceMappingURL=authconnection-CynFBIv8.mjs.map

package/dist/{authconnection-CZvi9ANm.mjs.map → authconnection-CynFBIv8.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"authconnection-CZvi9ANm.mjs","names":[],"sources":["../src/runtime/authconnection.ts"],"sourcesContent":["/**\n * Auth connection utilities.\n *\n * Thin typed wrapper around the platform-provided `tailor.authconnection` runtime API.\n * At runtime this delegates to `globalThis.tailor.authconnection`. Use\n * `mockAuthconnection` from `@tailor-platform/sdk/vitest` to mock in unit tests.\n *\n * `connectionName` is narrowed to the connection names defined in `defineAuth()`'s\n * `connections` once `tailor.d.ts` has been generated (via `tailor deploy`/`generate`).\n * @example\n * import { authconnection } from \"@tailor-platform/sdk/runtime\";\n *\n * const token = await authconnection.getConnectionToken(\"my-connection\");\n */\n\nimport type { AuthConnectionTokenResult } from \"#/configure/services/auth/types\";\n// Import from the public entry (not `#/configure/types/connection-name`) so this d.ts\n// references `@tailor-platform/sdk` externally instead of inlining the registry — a single\n// generated `declare module \"@tailor-platform/sdk\"` then narrows this entry too.\nimport type { ConnectionName } from \"@tailor-platform/sdk\";\n\n/**\n * Platform API surface for `tailor.authconnection`. Describes the shape the\n * platform runtime injects on `globalThis.tailor.authconnection`.\n */\nexport interface TailorAuthconnectionAPI {\n  /**\n   * Returns the access token for the given auth connection.\n   * @param connectionName - Auth connection name as defined in tailor.config\n   * @returns Token payload\n   */\n  getConnectionToken(connectionName: ConnectionName): Promise<AuthConnectionTokenResult>;\n}\n\nconst api = (): TailorAuthconnectionAPI =>\n  (globalThis as unknown as { tailor: { authconnection: TailorAuthconnectionAPI } }).tailor\n    .authconnection;\n\nconst getConnectionToken: TailorAuthconnectionAPI[\"getConnectionToken\"] = (...args) =>\n  api().getConnectionToken(...args);\n\n/** Runtime wrapper namespace for `tailor.authconnection`. */\nexport const authconnection = { getConnectionToken } as const satisfies TailorAuthconnectionAPI;\n"],"mappings":";AAkCA,MAAM,YACH,WAAkF,OAChF;AAEL,MAAM,sBAAqE,GAAG,SAC5E,IAAI,CAAC,CAAC,mBAAmB,GAAG,IAAI;;AAGlC,MAAa,iBAAiB,EAAE,mBAAmB"}
+{"version":3,"file":"authconnection-CynFBIv8.mjs","names":[],"sources":["../src/runtime/authconnection.ts"],"sourcesContent":["/**\n * Auth connection utilities.\n *\n * Thin typed wrapper around the platform-provided `tailor.authconnection` runtime API.\n * At runtime this delegates to `globalThis.tailor.authconnection`. Use\n * `mockAuthconnection` from `@tailor-platform/sdk/vitest` to mock in unit tests.\n *\n * `connectionName` is narrowed to the connection names defined in `defineAuth()`'s\n * `connections` once `tailor.d.ts` has been generated (via `tailor deploy`/`generate`).\n * @example\n * import { authconnection } from \"@tailor-platform/sdk/runtime\";\n *\n * const token = await authconnection.getConnectionToken(\"my-connection\");\n */\n\nimport type { AuthConnectionTokenResult } from \"#/configure/services/auth/types\";\n// Import from the public entry (not `#/configure/types/connection-name`) so this d.ts\n// references `@tailor-platform/sdk` externally instead of inlining the registry — a single\n// generated `declare module \"@tailor-platform/sdk\"` then narrows this entry too.\nimport type { ConnectionName } from \"@tailor-platform/sdk\";\n\n/**\n * Platform API surface for `tailor.authconnection`. Describes the shape the\n * platform runtime injects on `globalThis.tailor.authconnection`.\n */\nexport interface TailorAuthconnectionAPI {\n  /**\n   * Returns the access token for the given auth connection.\n   * @param connectionName - Auth connection name as defined in tailor.config\n   * @returns Token payload\n   */\n  getConnectionToken(connectionName: ConnectionName): Promise<AuthConnectionTokenResult>;\n}\n\nconst api = (): TailorAuthconnectionAPI =>\n  (globalThis as unknown as { tailor: { authconnection: TailorAuthconnectionAPI } }).tailor\n    .authconnection;\n\nconst getConnectionToken: TailorAuthconnectionAPI[\"getConnectionToken\"] = (...args) =>\n  api().getConnectionToken(...args);\n\n/** Runtime wrapper namespace for `tailor.authconnection`. */\nexport const authconnection = { getConnectionToken } as const satisfies TailorAuthconnectionAPI;\n"],"mappings":"AAkCA,MAAM,QACH,WAAkF,OAChF,eAMQ,EAAiB,CAAE,oBAJ2C,GAAG,IAC5E,IAAI,CAAC,CAAC,mBAAmB,GAAG,CAAI,CAGiB"}

package/dist/brand-C8nMKhJC.mjs

@@ -0,0 +1,2 @@
+const e=Symbol.for(`tailor-platform/sdk`);function brandValue(t,n){return Object.defineProperty(t,e,{value:n,enumerable:!1,configurable:!1,writable:!1}),t}function isSdkBranded(t,n){if(typeof t!=`object`||!t||!(e in t))return!1;let r=t[e];return n===void 0||r===!0||(Array.isArray(n)?n.includes(r):r===n)}export{isSdkBranded as n,brandValue as t};
+//# sourceMappingURL=brand-C8nMKhJC.mjs.map

package/dist/{brand-Eo4pLXPJ.mjs.map → brand-C8nMKhJC.mjs.map}

@@ -1 +1 @@
-{"version":3,"file":"brand-Eo4pLXPJ.mjs","names":[],"sources":["../src/utils/brand.ts"],"sourcesContent":["// Symbol.for ensures the same symbol is returned across different ESM module instances,\n// avoiding identity mismatches when multiple copies of the SDK are loaded.\nexport const SDK_BRAND: unique symbol = Symbol.for(\"tailor-platform/sdk\");\n\nexport type SdkBrandKind =\n  | \"tailordb-type\"\n  | \"resolver\"\n  | \"executor\"\n  | \"workflow\"\n  | \"workflow-job\"\n  | \"wait-point\"\n  | \"execution-policy\"\n  | \"http-adapter\";\n\n/**\n * Adds a non-enumerable SDK brand symbol to the given object (in-place).\n * The brand stores the kind so service loaders can distinguish between\n * different SDK object types (e.g. a type loader skips executors).\n * @param value - The object to brand\n * @param kind - The kind of SDK object\n * @returns The same object with the brand applied\n */\nexport function brandValue<T extends object>(value: T, kind: SdkBrandKind): T {\n  Object.defineProperty(value, SDK_BRAND, {\n    value: kind,\n    enumerable: false,\n    configurable: false,\n    writable: false,\n  });\n  return value;\n}\n\n/**\n * Checks whether the given value has been branded by the SDK.\n * When kind is specified, only returns true if the brand matches that kind.\n * Accepts a single kind or an array of kinds for multi-kind matching.\n * @param value - The value to check\n * @param kind - Optional kind or kinds to match against\n * @returns True if the value has the SDK brand symbol (and matches kind if specified)\n */\nexport function isSdkBranded(\n  value: unknown,\n  kind?: SdkBrandKind | readonly SdkBrandKind[],\n): boolean {\n  if (value === null || typeof value !== \"object\" || !(SDK_BRAND in value)) return false;\n  const stored = (value as Record<symbol, unknown>)[SDK_BRAND];\n  // No kind filter → any brand matches. Legacy `true` brand → matches any kind.\n  return (\n    kind === undefined ||\n    stored === true ||\n    (Array.isArray(kind) ? kind.includes(stored as SdkBrandKind) : stored === kind)\n  );\n}\n"],"mappings":";AAEA,MAAa,YAA2B,OAAO,IAAI,qBAAqB;;;;;;;;;AAoBxE,SAAgB,WAA6B,OAAU,MAAuB;CAC5E,OAAO,eAAe,OAAO,WAAW;EACtC,OAAO;EACP,YAAY;EACZ,cAAc;EACd,UAAU;CACZ,CAAC;CACD,OAAO;AACT;;;;;;;;;AAUA,SAAgB,aACd,OACA,MACS;CACT,IAAI,UAAU,QAAQ,OAAO,UAAU,YAAY,EAAE,aAAa,QAAQ,OAAO;CACjF,MAAM,SAAU,MAAkC;CAElD,OACE,SAAS,UACT,WAAW,SACV,MAAM,QAAQ,IAAI,IAAI,KAAK,SAAS,MAAsB,IAAI,WAAW;AAE9E"}
+{"version":3,"file":"brand-C8nMKhJC.mjs","names":[],"sources":["../src/utils/brand.ts"],"sourcesContent":["// Symbol.for ensures the same symbol is returned across different ESM module instances,\n// avoiding identity mismatches when multiple copies of the SDK are loaded.\nexport const SDK_BRAND: unique symbol = Symbol.for(\"tailor-platform/sdk\");\n\nexport type SdkBrandKind =\n  | \"tailordb-type\"\n  | \"resolver\"\n  | \"executor\"\n  | \"workflow\"\n  | \"workflow-job\"\n  | \"wait-point\"\n  | \"execution-policy\"\n  | \"http-adapter\";\n\n/**\n * Adds a non-enumerable SDK brand symbol to the given object (in-place).\n * The brand stores the kind so service loaders can distinguish between\n * different SDK object types (e.g. a type loader skips executors).\n * @param value - The object to brand\n * @param kind - The kind of SDK object\n * @returns The same object with the brand applied\n */\nexport function brandValue<T extends object>(value: T, kind: SdkBrandKind): T {\n  Object.defineProperty(value, SDK_BRAND, {\n    value: kind,\n    enumerable: false,\n    configurable: false,\n    writable: false,\n  });\n  return value;\n}\n\n/**\n * Checks whether the given value has been branded by the SDK.\n * When kind is specified, only returns true if the brand matches that kind.\n * Accepts a single kind or an array of kinds for multi-kind matching.\n * @param value - The value to check\n * @param kind - Optional kind or kinds to match against\n * @returns True if the value has the SDK brand symbol (and matches kind if specified)\n */\nexport function isSdkBranded(\n  value: unknown,\n  kind?: SdkBrandKind | readonly SdkBrandKind[],\n): boolean {\n  if (value === null || typeof value !== \"object\" || !(SDK_BRAND in value)) return false;\n  const stored = (value as Record<symbol, unknown>)[SDK_BRAND];\n  // No kind filter → any brand matches. Legacy `true` brand → matches any kind.\n  return (\n    kind === undefined ||\n    stored === true ||\n    (Array.isArray(kind) ? kind.includes(stored) : stored === kind)\n  );\n}\n"],"mappings":"AAEA,MAAa,EAA2B,OAAO,IAAI,qBAAqB,EAoBxE,SAAgB,WAA6B,EAAU,EAAuB,CAO5E,OANA,OAAO,eAAe,EAAO,EAAW,CACtC,MAAO,EACP,WAAY,GACZ,aAAc,GACd,SAAU,EACZ,CAAC,EACM,CACT,CAUA,SAAgB,aACd,EACA,EACS,CACT,GAAsB,OAAO,GAAU,WAAnC,GAA+C,EAAE,KAAa,GAAQ,MAAO,GACjF,IAAM,EAAU,EAAkC,GAElD,OACE,IAAS,IAAA,IACT,IAAW,KACV,MAAM,QAAQ,CAAI,EAAI,EAAK,SAAS,CAAM,EAAI,IAAW,EAE9D"}

package/dist/cli/commands/api/index.d.mts

@@ -1,4 +1,4 @@
 import { ApiCallOptions, ApiCallResult, apiCall } from "./api-call.mjs";
-import { z } from "zod";
 import "@bufbuild/protobuf";
+import { z } from "zod";
 export { type ApiCallOptions, type ApiCallResult, apiCall };

package/dist/cli/commands/deploy/deploy.d.mts

@@ -1,10 +1,10 @@
 import { BundledScripts } from "./function-registry-types.mjs";
-import "../../shared/config-loader.mjs";
 import "../../services/application.mjs";
 import "../../shared/client.mjs";
-import "./label.mjs";
 import "./types.mjs";
 import "./apply-phases.mjs";
+import "./deployment-target.mjs";
+import "./event-subscriptions.mjs";
 //#region src/cli/commands/deploy/deploy.d.ts
 interface DeployOptions {
   workspaceId?: string;

package/dist/cli/commands/deploy/deployment-target.d.mts

@@ -0,0 +1,2 @@
+import "../../shared/config-loader.mjs";
+import "../../services/application.mjs";

package/dist/cli/commands/deploy/event-subscriptions.d.mts

@@ -0,0 +1,3 @@
+import "./label.mjs";
+import "./workflow.mjs";
+import "./deployment-target.mjs";

package/dist/cli/commands/deploy/tailordb/apply.d.mts

@@ -0,0 +1,3 @@
+import "../../../shared/client.mjs";
+import "../types.mjs";
+import "./plan.mjs";

package/dist/cli/commands/deploy/tailordb/index.d.mts

@@ -1,11 +1,4 @@
-import "../../../shared/config-loader.mjs";
-import "../../../services/application.mjs";
-import "../../../../tailor-proto/src/tailor/v1/tailordb_pb.mjs";
-import "../../../shared/client.mjs";
-import "../label.mjs";
-import "../../tailordb/migrate/snapshot.mjs";
-import "../types.mjs";
-import "../../tailordb/migrate/config.mjs";
-import "../../tailordb/migrate/schema-checks.mjs";
 import "../../tailordb/migrate/file-state.mjs";
-import { MessageInitShape } from "@bufbuild/protobuf";
+import "./plan.mjs";
+import "./apply.mjs";
+import "./migration-validation.mjs";

package/dist/cli/commands/deploy/tailordb/migration-validation.d.mts

@@ -0,0 +1,5 @@
+import "../../../shared/config-loader.mjs";
+import "../../../shared/client.mjs";
+import "../../tailordb/migrate/snapshot.mjs";
+import "../../tailordb/migrate/config.mjs";
+import "../../tailordb/migrate/schema-checks.mjs";

package/dist/cli/commands/deploy/tailordb/plan.d.mts

@@ -0,0 +1,8 @@
+import "../../../services/application.mjs";
+import "../../../../tailor-proto/src/tailor/v1/tailordb_pb.mjs";
+import "../label.mjs";
+import "../types.mjs";
+import "../../tailordb/migrate/config.mjs";
+import "../../tailordb/migrate/schema-checks.mjs";
+import "../../../lib.mjs";
+import { MessageInitShape } from "@bufbuild/protobuf";

package/dist/cli/commands/executor/jobs.d.mts

@@ -82,4 +82,4 @@ declare function watchExecutorJob<E extends ExecutorLike>(options: WatchExecutor
  */
 declare function getExecutorWaitFailureMessage(result: WatchExecutorJobResult): string | undefined;
 //#endregion
-export { ExecutorJobDetailInfo, GetExecutorJobTypedOptions, ListExecutorJobsTypedOptions, WatchExecutorJobResult, WatchExecutorJobTypedOptions, WorkflowJobLog, getExecutorJob, getExecutorWaitFailureMessage, listExecutorJobs, watchExecutorJob };
+export { ExecutorJobDetailInfo, GetExecutorJobTypedOptions, ListExecutorJobsTypedOptions, WatchExecutorJobResult, WatchExecutorJobTypedOptions, getExecutorJob, getExecutorWaitFailureMessage, listExecutorJobs, watchExecutorJob };

package/dist/cli/commands/executor/trigger.d.mts

@@ -1,6 +1,6 @@
 import { IncomingWebhookTrigger, ScheduleTriggerInput } from "../../../types/executor.generated.mjs";
-import { z } from "zod";
 import { JsonObject } from "@bufbuild/protobuf";
+import { z } from "zod";
 //#region src/cli/commands/executor/trigger.d.ts
 type ManualTrigger = IncomingWebhookTrigger | ScheduleTriggerInput;
 type ManualTriggerExecutor<T extends ManualTrigger = ManualTrigger> = T extends ManualTrigger ? {

package/dist/cli/commands/generate/seed/bundler.d.mts

@@ -18,10 +18,10 @@ type SeedBundleResult = {
  * 3. Reports progress via console.log
  * 4. Exports as main() for TestExecScript
  * @param namespace - TailorDB namespace
- * @param typeNames - List of type names to include in the seed
+ * @param tableNames - List of table names to include in the seed
  * @param baseDir - Directory whose dependencies and tsconfig the generated entry uses
  * @returns Bundled seed script result
  */
-declare function bundleSeedScript(namespace: string, typeNames: string[], baseDir?: string): Promise<SeedBundleResult>;
+declare function bundleSeedScript(namespace: string, tableNames: string[], baseDir?: string): Promise<SeedBundleResult>;
 //#endregion
 export { SeedBundleResult, bundleSeedScript };

package/dist/cli/commands/show.d.mts

@@ -36,4 +36,4 @@ interface ShowInfo extends ApplicationInfo, WorkspaceInfo {
  */
 declare function show(options?: ShowOptions): Promise<ShowInfo>;
 //#endregion
-export { AIGatewayInfo, ApplicationInfo, ShowInfo, ShowOptions, WorkspaceInfo, show };
+export { AIGatewayInfo, ApplicationInfo, ShowInfo, ShowOptions, show };

package/dist/cli/commands/tailordb/migrate/diff-calculator.d.mts

@@ -66,13 +66,13 @@ interface TableSettingsModifiedChange extends DiffChangeBase {
   before: SnapshotTypeSettingsState;
   after: SnapshotTypeSettingsState;
 }
-/** A field was added to a type. */
+/** A field was added to a table. */
 interface FieldAddedChange extends DiffChangeBase {
   kind: "field_added";
   fieldName: string;
   after: SnapshotFieldConfig;
 }
-/** A field was removed from a type. */
+/** A field was removed from a table. */
 interface FieldRemovedChange extends DiffChangeBase {
   kind: "field_removed";
   fieldName: string;
@@ -86,7 +86,7 @@ interface FieldModifiedChange extends DiffChangeBase {
   after: SnapshotFieldConfig;
 }
 /**
- * A field was renamed within a type. Recorded when the user confirms that a
+ * A field was renamed within a table. Recorded when the user confirms that a
  * removed + added field pair is a rename (interactively or via `--rename`).
  * `fieldName` is the new name; `previousFieldName` is the old name.
  */
@@ -104,13 +104,13 @@ interface FieldTypeModifiedChange extends DiffChangeBase {
   before: SnapshotFieldConfig;
   after: SnapshotFieldConfig;
 }
-/** An index was added to a type. */
+/** An index was added to a table. */
 interface IndexAddedChange extends DiffChangeBase {
   kind: "index_added";
   indexName: string;
   after: SnapshotIndexConfig;
 }
-/** An index was removed from a type. */
+/** An index was removed from a table. */
 interface IndexRemovedChange extends DiffChangeBase {
   kind: "index_removed";
   indexName: string;
@@ -123,13 +123,13 @@ interface IndexModifiedChange extends DiffChangeBase {
   before: SnapshotIndexConfig;
   after: SnapshotIndexConfig;
 }
-/** A file field was added to a type. `before`/`after` hold the description. */
+/** A file field was added to a table. `before`/`after` hold the description. */
 interface FileAddedChange extends DiffChangeBase {
   kind: "file_added";
   fieldName: string;
   after: string;
 }
-/** A file field was removed from a type. */
+/** A file field was removed from a table. */
 interface FileRemovedChange extends DiffChangeBase {
   kind: "file_removed";
   fieldName: string;
@@ -143,7 +143,7 @@ interface FileModifiedChange extends DiffChangeBase {
   after: string;
 }
 /**
- * A relationship was added to a type. `relationshipType` is optional for
+ * A relationship was added to a table. `relationshipType` is optional for
  * backward compatibility: diff.json files written by older SDK versions
  * predate the field.
  */
@@ -153,7 +153,7 @@ interface RelationshipAddedChange extends DiffChangeBase {
   relationshipType?: "forward" | "backward";
   after: SnapshotRelationship;
 }
-/** A relationship was removed from a type. */
+/** A relationship was removed from a table. */
 interface RelationshipRemovedChange extends DiffChangeBase {
   kind: "relationship_removed";
   relationshipName: string;
@@ -212,7 +212,7 @@ interface MigrationDiff {
   hasBreakingChanges: boolean;
   /** List of breaking changes */
   breakingChanges: BreakingChangeInfo[];
-  /** Whether there are non-breaking changes that may cause data loss (e.g. field/type removal) */
+  /** Whether there are non-breaking changes that may cause data loss (e.g. field/table removal) */
   hasWarnings: boolean;
   /** List of non-breaking warnings */
   warnings: WarningChangeInfo[];
@@ -245,7 +245,7 @@ interface BreakingChangeInfo {
  * Warning change information in migration diff.
  *
  * Warnings are non-breaking changes that may still cause data loss
- * (e.g. removing a field or type). Unlike breaking changes, a migration
+ * (e.g. removing a field or table). Unlike breaking changes, a migration
  * script is not required, but writing one is recommended if you need to
  * preserve or transform data before the change applies.
  */

package/dist/cli/commands/tailordb/migrate/generate.d.mts

@@ -5,6 +5,10 @@ interface GenerateOptions {
   name?: string;
   yes?: boolean;
   init?: boolean;
+  /** Create a migration with no schema changes that exists to run a migration script. */
+  dataOnly?: boolean;
+  /** Namespace the `--data-only` migration targets. */
+  namespace?: string;
   /** `--rename Table.oldField:newField` / `--rename OldTable:NewTable` values confirming renames non-interactively. */
   renames?: string[];
   /** `--drop Table.field` / `--drop Table` values confirming removals non-interactively. */

package/dist/cli/commands/tailordb/migrate/rename-detection.d.mts

@@ -10,7 +10,7 @@ interface FieldRenameSpec {
   fieldName: string;
 }
 /**
- * A confirmed type rename to record in the migration diff.
+ * A confirmed table rename to record in the migration diff.
  */
 interface TypeRenameSpec {
   /** Type name before the rename. */

package/dist/cli/commands/tailordb/migrate/snapshot-comparison.d.mts

@@ -0,0 +1,43 @@
+import { NormalizedSchemaSnapshot, SchemaSnapshot, TailorDBSnapshotType } from "./snapshot-types.mjs";
+import { MigrationDiff } from "./diff-calculator.mjs";
+import { FieldRenameSpec, TypeRenameSpec } from "./rename-detection.mjs";
+//#region src/cli/commands/tailordb/migrate/snapshot-comparison.d.ts
+/**
+ * Options for {@link compareSnapshots}.
+ */
+interface CompareSnapshotsOptions {
+  /**
+   * Confirmed field renames. Each spec replaces the corresponding
+   * `field_removed` + `field_added` pair with a single breaking
+   * `field_renamed` change. Specs are validated against both snapshots.
+   */
+  fieldRenames?: readonly FieldRenameSpec[];
+  /**
+   * Confirmed table renames. Each spec replaces the corresponding
+   * `table_removed` + `table_added` pair with a single breaking
+   * `table_renamed` change. Specs are validated against both snapshots.
+   */
+  typeRenames?: readonly TypeRenameSpec[];
+}
+/**
+ * Compare two normalized snapshots and generate a diff
+ * @param {NormalizedSchemaSnapshot} previous - Previous normalized snapshot
+ * @param {NormalizedSchemaSnapshot} current - Current normalized snapshot
+ * @param {CompareSnapshotsOptions} [options] - Comparison options
+ * @returns {MigrationDiff} Migration diff between snapshots
+ */
+declare function compareSnapshots(previous: NormalizedSchemaSnapshot, current: NormalizedSchemaSnapshot, options?: CompareSnapshotsOptions): MigrationDiff;
+/**
+ * Compare a snapshot against canonical TailorDBSnapshotType-shaped local tables.
+ * Callers are expected to pre-convert TailorDBService.types to TailorDBSnapshotType via
+ * `createSnapshotType`. As a safety net, both sides are re-run through idempotent
+ * normalization here, so a caller that forgets will still get correct
+ * comparisons (no silent false drift).
+ * @param {SchemaSnapshot} snapshot - Schema snapshot to compare against
+ * @param {Record<string, TailorDBSnapshotType>} localTypes - Local snapshot-shaped tables
+ * @param {string} namespace - Namespace for comparison
+ * @returns {MigrationDiff} Migration diff
+ */
+declare function compareLocalTypesWithSnapshot(snapshot: SchemaSnapshot, localTypes: Record<string, TailorDBSnapshotType>, namespace: string): MigrationDiff;
+//#endregion
+export { CompareSnapshotsOptions, compareLocalTypesWithSnapshot, compareSnapshots };

package/dist/cli/commands/tailordb/migrate/snapshot-files.d.mts

@@ -0,0 +1,62 @@
+//#region src/cli/commands/tailordb/migrate/snapshot-files.d.ts
+/**
+ * Initial schema migration number (0000)
+ */
+declare const INITIAL_SCHEMA_NUMBER = 0;
+/**
+ * Migration file names (used within migration directories)
+ */
+declare const SCHEMA_FILE_NAME = "schema.json";
+/** File name for migration diff metadata. */
+declare const DIFF_FILE_NAME = "diff.json";
+/** File name for migration script. */
+declare const MIGRATE_FILE_NAME = "migrate.ts";
+/** File name for migration script unit test. */
+declare const MIGRATE_TEST_FILE_NAME = "migrate.test.ts";
+/** File name for generated DB type definitions. */
+declare const DB_TYPES_FILE_NAME = "db.ts";
+/**
+ * Migration file type
+ */
+type MigrationFileType = "schema" | "diff" | "migrate" | "test" | "db";
+/**
+ * Get migration directory path for a given number
+ * @param {string} migrationsDir - Base migrations directory path
+ * @param {number} num - Migration number
+ * @returns {string} Full directory path for the migration
+ */
+declare function getMigrationDirPath(migrationsDir: string, num: number): string;
+/**
+ * Get migration file path for a given number and type
+ * @param {string} migrationsDir - Migrations directory path
+ * @param {number} num - Migration number
+ * @param {MigrationFileType} type - File type
+ * @returns {string} Full file path
+ */
+declare function getMigrationFilePath(migrationsDir: string, num: number, type: MigrationFileType): string;
+/**
+ * Get all migration directories and their files, sorted by number
+ * @param {string} migrationsDir - Migrations directory path
+ * @returns {Array<{number: number, type: "schema" | "diff", path: string}>} Migration files sorted by number
+ */
+declare function getMigrationFiles(migrationsDir: string): {
+  number: number;
+  type: "schema" | "diff";
+  path: string;
+}[];
+/**
+ * Get the next migration number for a directory
+ * Returns INITIAL_SCHEMA_NUMBER (0) if no migrations exist
+ * @param {string} migrationsDir - Migrations directory path
+ * @returns {number} Next migration number
+ */
+declare function getNextMigrationNumber(migrationsDir: string): number;
+/**
+ * Get the latest migration number from a directory
+ * Returns 0 if no migrations exist
+ * @param {string} migrationsDir - Migrations directory path
+ * @returns {number} Latest migration number or 0 if no migrations exist
+ */
+declare function getLatestMigrationNumber(migrationsDir: string): number;
+//#endregion
+export { DB_TYPES_FILE_NAME, DIFF_FILE_NAME, INITIAL_SCHEMA_NUMBER, MIGRATE_FILE_NAME, MIGRATE_TEST_FILE_NAME, MigrationFileType, SCHEMA_FILE_NAME, getLatestMigrationNumber, getMigrationDirPath, getMigrationFilePath, getMigrationFiles, getNextMigrationNumber };

package/dist/cli/commands/tailordb/migrate/snapshot-local.d.mts

@@ -0,0 +1,12 @@
+import { TailorDBType } from "../../../../parser/service/tailordb/types.mjs";
+import { NormalizedSchemaSnapshot } from "./snapshot-types.mjs";
+//#region src/cli/commands/tailordb/migrate/snapshot-local.d.ts
+/**
+ * Create a schema snapshot from local table definitions
+ * @param {Record<string, TailorDBType>} types - Local table definitions
+ * @param {string} namespace - Namespace for the snapshot
+ * @returns {NormalizedSchemaSnapshot} Normalized schema snapshot
+ */
+declare function createSnapshotFromLocalTypes(types: Record<string, TailorDBType>, namespace: string): NormalizedSchemaSnapshot;
+//#endregion
+export { createSnapshotFromLocalTypes };

package/dist/cli/commands/tailordb/migrate/snapshot-migrations.d.mts

@@ -0,0 +1,12 @@
+import { NormalizedSchemaSnapshot } from "./snapshot-types.mjs";
+//#region src/cli/commands/tailordb/migrate/snapshot-migrations.d.ts
+/**
+ * Reconstruct the latest schema snapshot from all migration files
+ * Returns null if no migrations exist
+ * @param {string} migrationsDir - Migrations directory path
+ * @param {number} [maxVersion] - Optional maximum migration version to apply
+ * @returns {NormalizedSchemaSnapshot | null} Reconstructed normalized snapshot or null if no migrations exist
+ */
+declare function reconstructSnapshotFromMigrations(migrationsDir: string, maxVersion?: number): NormalizedSchemaSnapshot | null;
+//#endregion
+export { reconstructSnapshotFromMigrations };

package/dist/cli/commands/tailordb/migrate/snapshot-remote.d.mts

@@ -0,0 +1 @@
+import "../../../../tailor-proto/src/tailor/v1/tailordb_resource_pb.mjs";

package/dist/cli/commands/tailordb/migrate/snapshot-types.d.mts

@@ -60,6 +60,8 @@ interface SnapshotFieldConfig {
   serial?: SnapshotSerial;
   scale?: number;
   default?: unknown;
+  /** Recorded on remote-derived snapshots when the platform fills the value on create. */
+  optionalOnCreate?: boolean;
   /** Nested fields (recursive) */
   fields?: Record<string, SnapshotFieldConfig>;
 }
@@ -212,4 +214,4 @@ type NormalizedSchemaSnapshot = SchemaSnapshot & {
   readonly [normalizedSchemaSnapshotBrand]: true;
 };
 //#endregion
-export { NormalizedSchemaSnapshot, RebaselineMarker, SchemaSnapshot, SnapshotActionPermission, SnapshotEnumValue, SnapshotFieldConfig, SnapshotFieldRefOperand, SnapshotGqlAction, SnapshotGqlPermission, SnapshotGqlPermissionPolicy, SnapshotHook, SnapshotIndexConfig, SnapshotPermissionCondition, SnapshotPermissionOperand, SnapshotPermissionOperator, SnapshotRecordPermission, SnapshotRelationship, SnapshotSerial, SnapshotValidation, SnapshotValueOperand, TailorDBSnapshotType };
+export { NormalizedSchemaSnapshot, RebaselineMarker, SchemaSnapshot, SnapshotActionPermission, SnapshotEnumValue, SnapshotFieldConfig, SnapshotFieldRefOperand, SnapshotGqlAction, SnapshotGqlPermission, SnapshotGqlPermissionPolicy, SnapshotHook, SnapshotIndexConfig, SnapshotPermissionCondition, SnapshotPermissionOperand, SnapshotPermissionOperator, SnapshotRecordPermission, SnapshotRelationship, SnapshotSerial, SnapshotValidation, TailorDBSnapshotType };

package/dist/cli/commands/tailordb/migrate/snapshot.d.mts

@@ -1,119 +1,7 @@
-import { TailorDBType } from "../../../../parser/service/tailordb/types.mjs";
-import "../../../../tailor-proto/src/tailor/v1/tailordb_resource_pb.mjs";
 import { NormalizedSchemaSnapshot, RebaselineMarker, SchemaSnapshot, SnapshotActionPermission, SnapshotEnumValue, SnapshotFieldConfig, SnapshotGqlPermission, SnapshotGqlPermissionPolicy, SnapshotIndexConfig, SnapshotPermissionCondition, SnapshotPermissionOperand, SnapshotRecordPermission, SnapshotRelationship, TailorDBSnapshotType } from "./snapshot-types.mjs";
-import { MigrationDiff } from "./diff-calculator.mjs";
-import { FieldRenameSpec, TypeRenameSpec } from "./rename-detection.mjs";
-//#region src/cli/commands/tailordb/migrate/snapshot.d.ts
-/**
- * Initial schema migration number (0000)
- */
-declare const INITIAL_SCHEMA_NUMBER = 0;
-/**
- * Migration file names (used within migration directories)
- */
-declare const SCHEMA_FILE_NAME = "schema.json";
-/** File name for migration diff metadata. */
-declare const DIFF_FILE_NAME = "diff.json";
-/** File name for migration script. */
-declare const MIGRATE_FILE_NAME = "migrate.ts";
-/** File name for migration script unit test. */
-declare const MIGRATE_TEST_FILE_NAME = "migrate.test.ts";
-/** File name for generated DB type definitions. */
-declare const DB_TYPES_FILE_NAME = "db.ts";
-/**
- * Migration file type
- */
-type MigrationFileType = "schema" | "diff" | "migrate" | "test" | "db";
-/**
- * Get migration directory path for a given number
- * @param {string} migrationsDir - Base migrations directory path
- * @param {number} num - Migration number
- * @returns {string} Full directory path for the migration
- */
-declare function getMigrationDirPath(migrationsDir: string, num: number): string;
-/**
- * Get migration file path for a given number and type
- * @param {string} migrationsDir - Migrations directory path
- * @param {number} num - Migration number
- * @param {MigrationFileType} type - File type
- * @returns {string} Full file path
- */
-declare function getMigrationFilePath(migrationsDir: string, num: number, type: MigrationFileType): string;
-/**
- * Create a schema snapshot from local table definitions
- * @param {Record<string, TailorDBType>} types - Local table definitions
- * @param {string} namespace - Namespace for the snapshot
- * @returns {NormalizedSchemaSnapshot} Normalized schema snapshot
- */
-declare function createSnapshotFromLocalTypes(types: Record<string, TailorDBType>, namespace: string): NormalizedSchemaSnapshot;
-/**
- * Get all migration directories and their files, sorted by number
- * @param {string} migrationsDir - Migrations directory path
- * @returns {Array<{number: number, type: "schema" | "diff", path: string}>} Migration files sorted by number
- */
-declare function getMigrationFiles(migrationsDir: string): {
-  number: number;
-  type: "schema" | "diff";
-  path: string;
-}[];
-/**
- * Get the next migration number for a directory
- * Returns INITIAL_SCHEMA_NUMBER (0) if no migrations exist
- * @param {string} migrationsDir - Migrations directory path
- * @returns {number} Next migration number
- */
-declare function getNextMigrationNumber(migrationsDir: string): number;
-/**
- * Reconstruct the latest schema snapshot from all migration files
- * Returns null if no migrations exist
- * @param {string} migrationsDir - Migrations directory path
- * @param {number} [maxVersion] - Optional maximum migration version to apply
- * @returns {NormalizedSchemaSnapshot | null} Reconstructed normalized snapshot or null if no migrations exist
- */
-declare function reconstructSnapshotFromMigrations(migrationsDir: string, maxVersion?: number): NormalizedSchemaSnapshot | null;
-/**
- * Get the latest migration number from a directory
- * Returns 0 if no migrations exist
- * @param {string} migrationsDir - Migrations directory path
- * @returns {number} Latest migration number or 0 if no migrations exist
- */
-declare function getLatestMigrationNumber(migrationsDir: string): number;
-/**
- * Options for {@link compareSnapshots}.
- */
-interface CompareSnapshotsOptions {
-  /**
-   * Confirmed field renames. Each spec replaces the corresponding
-   * `field_removed` + `field_added` pair with a single breaking
-   * `field_renamed` change. Specs are validated against both snapshots.
-   */
-  fieldRenames?: readonly FieldRenameSpec[];
-  /**
-   * Confirmed table renames. Each spec replaces the corresponding
-   * `table_removed` + `table_added` pair with a single breaking
-   * `table_renamed` change. Specs are validated against both snapshots.
-   */
-  typeRenames?: readonly TypeRenameSpec[];
-}
-/**
- * Compare two normalized snapshots and generate a diff
- * @param {NormalizedSchemaSnapshot} previous - Previous normalized snapshot
- * @param {NormalizedSchemaSnapshot} current - Current normalized snapshot
- * @param {CompareSnapshotsOptions} [options] - Comparison options
- * @returns {MigrationDiff} Migration diff between snapshots
- */
-declare function compareSnapshots(previous: NormalizedSchemaSnapshot, current: NormalizedSchemaSnapshot, options?: CompareSnapshotsOptions): MigrationDiff;
-/**
- * Compare a snapshot against canonical TailorDBSnapshotType-shaped local tables.
- * Callers are expected to pre-convert TailorDBService.types to TailorDBSnapshotType via
- * `createSnapshotType`. As a safety net, both sides are re-run through idempotent
- * normalization here, so a caller that forgets will still get correct
- * comparisons (no silent false drift).
- * @param {SchemaSnapshot} snapshot - Schema snapshot to compare against
- * @param {Record<string, TailorDBSnapshotType>} localTypes - Local snapshot-shaped tables
- * @param {string} namespace - Namespace for comparison
- * @returns {MigrationDiff} Migration diff
- */
-declare function compareLocalTypesWithSnapshot(snapshot: SchemaSnapshot, localTypes: Record<string, TailorDBSnapshotType>, namespace: string): MigrationDiff;
-//#endregion
+import { CompareSnapshotsOptions, compareLocalTypesWithSnapshot, compareSnapshots } from "./snapshot-comparison.mjs";
+import { DB_TYPES_FILE_NAME, DIFF_FILE_NAME, INITIAL_SCHEMA_NUMBER, MIGRATE_FILE_NAME, MIGRATE_TEST_FILE_NAME, MigrationFileType, SCHEMA_FILE_NAME, getLatestMigrationNumber, getMigrationDirPath, getMigrationFilePath, getMigrationFiles, getNextMigrationNumber } from "./snapshot-files.mjs";
+import { reconstructSnapshotFromMigrations } from "./snapshot-migrations.mjs";
+import { createSnapshotFromLocalTypes } from "./snapshot-local.mjs";
+import "./snapshot-remote.mjs";
 export { CompareSnapshotsOptions, DB_TYPES_FILE_NAME, DIFF_FILE_NAME, INITIAL_SCHEMA_NUMBER, MIGRATE_FILE_NAME, MIGRATE_TEST_FILE_NAME, MigrationFileType, type NormalizedSchemaSnapshot, SCHEMA_FILE_NAME, type SchemaSnapshot, type SnapshotFieldConfig, type TailorDBSnapshotType, compareLocalTypesWithSnapshot, compareSnapshots, createSnapshotFromLocalTypes, getLatestMigrationNumber, getMigrationDirPath, getMigrationFilePath, getMigrationFiles, getNextMigrationNumber, reconstructSnapshotFromMigrations };

package/dist/cli/commands/workflow/start.d.mts

@@ -1,8 +1,8 @@
 import "../../shared/args.mjs";
 import { WorkflowWaitUntil } from "./status.mjs";
 import { WorkflowWaitResult } from "./waiter.mjs";
-import { Jsonifiable } from "type-fest";
 import { z } from "zod";
+import { Jsonifiable } from "type-fest";
 import { MachineUserName } from "@tailor-platform/sdk";
 //#region src/cli/commands/workflow/start.d.ts
 type WorkflowLike = {

package/dist/cli/commands/workspace/list.d.mts

@@ -1,5 +1,5 @@
-import { WorkspaceInfo } from "./transform.mjs";
 import { Order } from "../../shared/args.mjs";
+import { WorkspaceInfo } from "./transform.mjs";
 import { z } from "zod";
 //#region src/cli/commands/workspace/list.d.ts
 interface ListWorkspacesOptions {