@tailor-platform/sdk 2.2.0 → 2.3.0

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

@@ -4,7 +4,7 @@ import { SnapshotFieldConfig, SnapshotGqlPermission, SnapshotIndexConfig, Snapsh
  * Properties shared by all diff change variants
  */
 interface DiffChangeBase {
-  typeName: string;
+  tableName: string;
   reason?: string;
 }
 /**
@@ -29,29 +29,40 @@ interface SnapshotPermissionState {
   recordPermission?: SnapshotRecordPermission;
   gqlPermission?: SnapshotGqlPermission;
 }
-/** A new type was added to the schema. */
-interface TypeAddedChange extends DiffChangeBase {
-  kind: "type_added";
+/** A new table was added to the schema. */
+interface TableAddedChange extends DiffChangeBase {
+  kind: "table_added";
   after: TailorDBSnapshotType;
 }
-/** An existing type was removed from the schema. */
-interface TypeRemovedChange extends DiffChangeBase {
-  kind: "type_removed";
+/** An existing table was removed from the schema. */
+interface TableRemovedChange extends DiffChangeBase {
+  kind: "table_removed";
   before: TailorDBSnapshotType;
 }
 /**
- * Legacy type-level settings change. Kept for backward compatibility with
+ * A table was renamed. Recorded when the user confirms that a removed + added
+ * table pair is a rename (interactively or via `--rename`).
+ * `tableName` is the new name; `previousTableName` is the old name.
+ */
+interface TableRenamedChange extends DiffChangeBase {
+  kind: "table_renamed";
+  previousTableName: string;
+  before: TailorDBSnapshotType;
+  after: TailorDBSnapshotType;
+}
+/**
+ * Legacy table-level settings change. Kept for backward compatibility with
  * diff.json files written by older SDK versions; `before`/`after` may be
  * absent in those files, hence optional.
  */
-interface TypeModifiedChange extends DiffChangeBase {
-  kind: "type_modified";
+interface TableModifiedChange extends DiffChangeBase {
+  kind: "table_modified";
   before?: TypeSettingsPatch;
   after?: TypeSettingsPatch;
 }
-/** Type-level settings or metadata changed. */
-interface TypeSettingsModifiedChange extends DiffChangeBase {
-  kind: "type_settings_modified";
+/** Table-level settings or metadata changed. */
+interface TableSettingsModifiedChange extends DiffChangeBase {
+  kind: "table_settings_modified";
   before: SnapshotTypeSettingsState;
   after: SnapshotTypeSettingsState;
 }
@@ -74,6 +85,18 @@ interface FieldModifiedChange extends DiffChangeBase {
   before: SnapshotFieldConfig;
   after: SnapshotFieldConfig;
 }
+/**
+ * A field was renamed within a type. 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.
+ */
+interface FieldRenamedChange extends DiffChangeBase {
+  kind: "field_renamed";
+  fieldName: string;
+  previousFieldName: string;
+  before: SnapshotFieldConfig;
+  after: SnapshotFieldConfig;
+}
 /** A field type changed and must remain on the previous type until Post-phase. */
 interface FieldTypeModifiedChange extends DiffChangeBase {
   kind: "field_type_modified";
@@ -163,9 +186,9 @@ interface TypeScriptsState {
   };
   typeValidateExpr?: string;
 }
-/** Type-level hook/validate scripts changed. */
-interface TypeScriptsModifiedChange extends DiffChangeBase {
-  kind: "type_scripts_modified";
+/** Table-level hook/validate scripts changed. */
+interface TableScriptsModifiedChange extends DiffChangeBase {
+  kind: "table_scripts_modified";
   before: TypeScriptsState;
   after: TypeScriptsState;
 }
@@ -173,7 +196,7 @@ interface TypeScriptsModifiedChange extends DiffChangeBase {
  * Single change in migration diff, discriminated by `kind` so that
  * `before`/`after` are typed per change kind.
  */
-type DiffChange = TypeAddedChange | TypeRemovedChange | TypeModifiedChange | TypeSettingsModifiedChange | FieldAddedChange | FieldRemovedChange | FieldModifiedChange | FieldTypeModifiedChange | IndexAddedChange | IndexRemovedChange | IndexModifiedChange | FileAddedChange | FileRemovedChange | FileModifiedChange | RelationshipAddedChange | RelationshipRemovedChange | RelationshipModifiedChange | PermissionModifiedChange | TypeScriptsModifiedChange;
+type DiffChange = TableAddedChange | TableRemovedChange | TableRenamedChange | TableModifiedChange | TableSettingsModifiedChange | FieldAddedChange | FieldRemovedChange | FieldModifiedChange | FieldRenamedChange | FieldTypeModifiedChange | IndexAddedChange | IndexRemovedChange | IndexModifiedChange | FileAddedChange | FileRemovedChange | FileModifiedChange | RelationshipAddedChange | RelationshipRemovedChange | RelationshipModifiedChange | PermissionModifiedChange | TableScriptsModifiedChange;
 /**
  * Migration diff - changes between two schema versions
  * Stored as XXXX/diff.json (e.g., 0001/diff.json)
@@ -210,7 +233,7 @@ interface ScriptSkippedInfo {
  * Breaking change information in migration diff
  */
 interface BreakingChangeInfo {
-  typeName: string;
+  tableName: string;
   fieldName?: string;
   reason: string;
   /** If true, this change is not supported and migration generation will fail */
@@ -227,7 +250,7 @@ interface BreakingChangeInfo {
  * preserve or transform data before the change applies.
  */
 interface WarningChangeInfo {
-  typeName: string;
+  tableName: string;
   fieldName?: string;
   reason: string;
 }
@@ -250,4 +273,4 @@ declare function formatMigrationDiff(diff: MigrationDiff): string;
  */
 declare function formatDiffSummary(diff: MigrationDiff): string;
 //#endregion
-export { BreakingChangeInfo, DiffChange, FieldAddedChange, FieldModifiedChange, FieldRemovedChange, FieldTypeModifiedChange, FileAddedChange, FileModifiedChange, FileRemovedChange, IndexAddedChange, IndexModifiedChange, IndexRemovedChange, MigrationDiff, PermissionModifiedChange, RelationshipAddedChange, RelationshipModifiedChange, RelationshipRemovedChange, ScriptSkippedInfo, SnapshotPermissionState, SnapshotTypeSettingsState, TypeAddedChange, TypeModifiedChange, TypeRemovedChange, TypeScriptsModifiedChange, TypeScriptsState, TypeSettingsModifiedChange, TypeSettingsPatch, WarningChangeInfo, formatDiffSummary, formatMigrationDiff, hasChanges };
+export { BreakingChangeInfo, DiffChange, FieldAddedChange, FieldModifiedChange, FieldRemovedChange, FieldRenamedChange, FieldTypeModifiedChange, FileAddedChange, FileModifiedChange, FileRemovedChange, IndexAddedChange, IndexModifiedChange, IndexRemovedChange, MigrationDiff, PermissionModifiedChange, RelationshipAddedChange, RelationshipModifiedChange, RelationshipRemovedChange, ScriptSkippedInfo, SnapshotPermissionState, SnapshotTypeSettingsState, TableAddedChange, TableModifiedChange, TableRemovedChange, TableRenamedChange, TableScriptsModifiedChange, TableSettingsModifiedChange, TypeScriptsState, TypeSettingsPatch, WarningChangeInfo, formatDiffSummary, formatMigrationDiff, hasChanges };

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

@@ -5,6 +5,12 @@ interface GenerateOptions {
   name?: string;
   yes?: boolean;
   init?: boolean;
+  /** `--rename Type.old:new` / `--rename OldType:NewType` values confirming renames non-interactively. */
+  renames?: string[];
+  /** `--drop Type.field` / `--drop Type` values confirming removals non-interactively. */
+  drops?: string[];
+  /** `--expand-contract Type.field` values approving a field type conversion. */
+  expandContracts?: string[];
 }
 /**
  * Generate migration files for TailorDB schema changes

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

@@ -0,0 +1,22 @@
+//#region src/cli/commands/tailordb/migrate/rename-detection.d.ts
+/**
+ * A confirmed field rename to record in the migration diff.
+ */
+interface FieldRenameSpec {
+  tableName: string;
+  /** Field name before the rename. */
+  previousFieldName: string;
+  /** Field name after the rename. */
+  fieldName: string;
+}
+/**
+ * A confirmed type rename to record in the migration diff.
+ */
+interface TypeRenameSpec {
+  /** Type name before the rename. */
+  previousTableName: string;
+  /** Type name after the rename. */
+  tableName: string;
+}
+//#endregion
+export { FieldRenameSpec, TypeRenameSpec };

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

@@ -198,7 +198,7 @@ interface SchemaSnapshot {
   version: number;
   namespace: string;
   createdAt: string;
-  types: Record<string, TailorDBSnapshotType>;
+  tables: Record<string, TailorDBSnapshotType>;
   rebaseline?: RebaselineMarker;
 }
 declare const normalizedSchemaSnapshotBrand: unique symbol;

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

@@ -2,6 +2,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)
@@ -78,17 +79,35 @@ declare function reconstructSnapshotFromMigrations(migrationsDir: string, maxVer
  */
 declare function getLatestMigrationNumber(migrationsDir: string): number;
 /**
- * Compare two snapshots and generate a diff
- * @param {SchemaSnapshot} previous - Previous schema snapshot
- * @param {SchemaSnapshot} current - Current schema snapshot
+ * 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 type 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: SchemaSnapshot, current: SchemaSnapshot): MigrationDiff;
+declare function compareSnapshots(previous: NormalizedSchemaSnapshot, current: NormalizedSchemaSnapshot, options?: CompareSnapshotsOptions): MigrationDiff;
 /**
  * Compare a snapshot against canonical TailorDBSnapshotType-shaped local types.
  * Callers are expected to pre-convert TailorDBService.types to TailorDBSnapshotType via
- * `createSnapshotType`. As a safety net, `compareSnapshots` re-runs idempotent
- * normalization on both sides, so a caller that forgets will still get correct
+ * `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 types
@@ -97,4 +116,4 @@ declare function compareSnapshots(previous: SchemaSnapshot, current: SchemaSnaps
  */
 declare function compareLocalTypesWithSnapshot(snapshot: SchemaSnapshot, localTypes: Record<string, TailorDBSnapshotType>, namespace: string): MigrationDiff;
 //#endregion
-export { 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 };
+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/lib.mjs

@@ -1,5 +1,5 @@
-import { $n as formatDiffSummary, $t as listWorkspaces, A as truncate, At as triggerExecutor, Bn as getMigrationDirPath, D as resumeWorkflow, Dn as INITIAL_SCHEMA_NUMBER, Dr as loadWorkspaceId, Dt as listWebhookExecutors, En as DIFF_FILE_NAME, Et as getFunctionRegistry, F as chunkSeedData, Fn as compareLocalTypesWithSnapshot, Hn as getMigrationFiles, I as bundleSeedScript, In as compareSnapshots, It as listExecutorJobs, J as remove, Jt as deploy, L as generate$1, Ln as createSnapshotFromLocalTypes, Lt as watchExecutorJob, M as loadSeedContext, Mt as listExecutors, Nt as getExecutorJob, On as MIGRATE_FILE_NAME, P as loadTailorDBNamespaces, Pt as getExecutorWaitFailureMessage, Q as organizationTree, S as getAppHealth, St as generate, T as waitWorkflowExecution, Tn as DB_TYPES_FILE_NAME, U as deployStaticWebsite, Un as getNextMigrationNumber, Ut as getWorkflowExecution, Vn as getMigrationFilePath, Vt as getWorkflow, W as show, Wt as listWorkflowExecutions, Yn as MIGRATION_LABEL_KEY, Z as updateOrganization, _ as getWorkspace, _t as getOAuth2Client, at as updateFolder, b as listApps, cn as executeScript, d as listUsers, dn as bundleMigrationScript, dt as deleteFolder, er as formatMigrationDiff, gr as loadConfig, h as restoreWorkspace, hr as assertWritable, ht as listOAuth2Clients, i as query, jn as SCHEMA_FILE_NAME, k as listWorkflows, kn as MIGRATE_TEST_FILE_NAME, l as removeUser, ln as waitForExecution, lt as getFolder, mr as apiCall, n as errorToJson, nn as createWorkspace, nr as getNamespacesWithMigrations, p as inviteUser, pt as createFolder, qn as reconstructSnapshotFromMigrations, qt as getExecutor, r as serializeError, rt as getOrganization, s as updateUser, st as listFolders, t as registerTsHook, tr as hasChanges, tt as listOrganizations, ur as generateUserTypes, vt as getMachineUserToken, wt as listFunctionRegistries, xr as loadAccessToken, xt as listMachineUsers, y as deleteWorkspace, zn as getLatestMigrationNumber, zt as startWorkflow } from "../register-ts-hook-CTth1eqj.mjs";
-import { K as initOperatorClient } from "../application-BpLeawBg.mjs";
+import { $t as listWorkspaces, A as truncate, At as triggerExecutor, Bn as getLatestMigrationNumber, D as resumeWorkflow, Dn as INITIAL_SCHEMA_NUMBER, Dt as listWebhookExecutors, En as DIFF_FILE_NAME, Et as getFunctionRegistry, F as chunkSeedData, Hn as getMigrationFilePath, I as bundleSeedScript, In as compareLocalTypesWithSnapshot, It as listExecutorJobs, J as remove, Jn as reconstructSnapshotFromMigrations, Jt as deploy, L as generate$1, Ln as compareSnapshots, Lt as watchExecutorJob, M as loadSeedContext, Mn as SCHEMA_FILE_NAME, Mt as listExecutors, Nt as getExecutorJob, On as MIGRATE_FILE_NAME, Or as loadWorkspaceId, P as loadTailorDBNamespaces, Pt as getExecutorWaitFailureMessage, Q as organizationTree, Rn as createSnapshotFromLocalTypes, S as getAppHealth, Sr as loadAccessToken, St as generate, T as waitWorkflowExecution, Tn as DB_TYPES_FILE_NAME, U as deployStaticWebsite, Un as getMigrationFiles, Ut as getWorkflowExecution, Vn as getMigrationDirPath, Vt as getWorkflow, W as show, Wn as getNextMigrationNumber, Wt as listWorkflowExecutions, Xn as MIGRATION_LABEL_KEY, Z as updateOrganization, _ as getWorkspace, _r as loadConfig, _t as getOAuth2Client, at as updateFolder, b as listApps, cn as executeScript, d as listUsers, dn as bundleMigrationScript, dr as generateUserTypes, dt as deleteFolder, er as formatDiffSummary, gr as assertWritable, h as restoreWorkspace, hr as apiCall, ht as listOAuth2Clients, i as query, k as listWorkflows, kn as MIGRATE_TEST_FILE_NAME, l as removeUser, ln as waitForExecution, lt as getFolder, n as errorToJson, nn as createWorkspace, nr as hasChanges, p as inviteUser, pt as createFolder, qt as getExecutor, r as serializeError, rr as getNamespacesWithMigrations, rt as getOrganization, s as updateUser, st as listFolders, t as registerTsHook, tr as formatMigrationDiff, tt as listOrganizations, vt as getMachineUserToken, wt as listFunctionRegistries, xt as listMachineUsers, y as deleteWorkspace, zt as startWorkflow } from "../register-ts-hook-ClI226n2.mjs";
+import { J as initOperatorClient } from "../application-F-nl107y.mjs";
 import { t as isPluginGeneratedType } from "../type-source-DH_LH20p.mjs";
 
 //#region src/cli/lib.ts