@tailor-platform/sdk 2.25.0 → 2.27.0

package/dist/vitest/migration-steps.d.mts

@@ -0,0 +1,45 @@
+//#region src/vitest/migration-steps.d.ts
+/**
+ * Run a multi-step migration script's `steps` in tests the way `tailor deploy`
+ * does: in dependency order, each step in its own transaction.
+ */
+/** A step as declared in a migration script's `steps`. */
+export interface RunnableMigrationStep<Trx, Context> {
+  /** Steps that must complete before this one starts. */
+  readonly dependsOn?: readonly string[];
+  /** The step body; it receives its own transaction. */
+  run: (trx: Trx, context: Context) => Promise<unknown>;
+}
+export interface RunMigrationStepsOptions<Trx, Context extends {
+  env: unknown;
+}> {
+  /**
+   * Run one step inside a transaction, e.g.
+   * `(run) => db.transaction().execute(run)` for a PGlite-backed Kysely, or
+   * `(run) => mock.withTx(run)` for `createKyselyMock`.
+   */
+  transaction: (run: (trx: Trx) => Promise<unknown>) => Promise<unknown>;
+  /** Values passed as `env` to every step; defaults to `{}`. */
+  env?: Context["env"];
+}
+/** Thrown by {@link runMigrationSteps} when a step fails. */
+export declare class MigrationStepError extends Error {
+  /** The step that failed. */
+  readonly step: string;
+  /** Steps that committed before the failure, in execution order. */
+  readonly completedSteps: string[];
+  constructor(step: string, completedSteps: string[], cause: unknown);
+}
+/**
+ * Run a migration script's `steps` in the order `tailor deploy` runs them,
+ * committing each step separately, so a test can observe what a failure in a
+ * later step leaves behind.
+ * @param steps - The script's exported `steps`
+ * @param options - Transaction runner and env
+ * @returns Names of the steps that ran, in execution order
+ * @throws {MigrationStepError} When a step fails; earlier steps stay committed
+ */
+export declare function runMigrationSteps<Trx, Context extends {
+  env: unknown;
+}>(steps: Readonly<Record<string, RunnableMigrationStep<Trx, Context>>>, options: RunMigrationStepsOptions<Trx, Context>): Promise<string[]>;
+//#endregion

package/dist/vitest/mocks/file.d.mts

@@ -46,9 +46,9 @@ export declare function mockFile(options?: MockFileOptions): {
   calls: FileCall[];
   clear(): void;
   reset(): void;
-  delete: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string) => Promise<void>>;
   download: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string) => Promise<FileDownloadResponse>>;
   downloadAsBase64: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string) => Promise<FileDownloadAsBase64Response>>;
+  delete: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string) => Promise<void>>;
   getMetadata: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string) => Promise<FileMetadata>>;
   downloadStream: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string) => Promise<FileDownloadStreamResponse>>;
   uploadStream: Mock<(namespace: string, tableName: string, fieldName: string, recordId: string, readableStream: ReadableStream<Uint8Array | ArrayBuffer>, options?: FileUploadStreamOptions) => Promise<FileUploadResponse>>;

package/dist/vitest/mocks/idp.d.mts

@@ -30,6 +30,7 @@ type IdpNamespaceMocks = { [Method in IdpMethod]: Mock<IdpClientInstance[Method]
  *     disabled: false,
  *     mfaEnrolled: false,
  *     mfaFactorIds: [],
+ *     passwordUpdatedAt: null,
  *   });
  *   // …
  * });

package/dist/vitest/mocks/tailordb-pglite.d.mts

@@ -62,6 +62,7 @@ export declare function mockTailordbWithPGlite(options: MockTailordbPGliteOption
   /** The mock `tailordb.Client` constructor (`vi.fn`). */
   Client: import("vitest").Mock<(this: any, config?: {
     namespace?: string;
+    temporal?: boolean;
   }) => void>;
   /**
    * All queries executed on the PGlite instances, in order, with the

package/dist/vitest/pglite-kysely.d.mts

@@ -1,3 +1,4 @@
+import { PGliteField } from "./pglite-temporal.mjs";
 import { ColumnType, Kysely } from "kysely";
 //#region src/vitest/pglite-kysely.d.ts
 /** Result of a {@link PGliteClient.query} call. */
@@ -10,6 +11,8 @@ export interface PGliteQueryResult {
   command?: string;
   /** Row count reported alongside the command tag. */
   rowCount?: number;
+  /** Name and Postgres type OID of each returned column. */
+  fields?: PGliteField[];
 }
 /**
  * The subset of a `@electric-sql/pglite` `PGlite` instance used by
@@ -43,6 +46,15 @@ type UnmigratedColumn<C> = C extends ColumnType<infer S, infer I, infer U> ? Col
  * ```
  */
 export type Unmigrated<DB> = { [T in keyof DB]: { [C in keyof DB[T]]: UnmigratedColumn<DB[T][C]>; }; };
+/** Options for {@link createKyselyPGlite}. */
+export interface CreateKyselyPGliteOptions {
+  /**
+   * Read date/datetime/time columns back as `Temporal.PlainDate`/`Temporal.Instant`/
+   * `Temporal.PlainTime`, as a migration whose `db.ts` uses Temporal column types sees
+   * them on the platform. Defaults to `false`.
+   */
+  temporal?: boolean;
+}
 /**
  * Create a Kysely instance backed by a PGlite in-memory Postgres, for
  * executing a migration script's queries against real data in tests.
@@ -54,6 +66,7 @@ export type Unmigrated<DB> = { [T in keyof DB]: { [C in keyof DB[T]]: Unmigrated
  * statement passing here can still be rejected by the platform; keep a
  * statement-level test (see `createKyselyMock`) alongside.
  * @param client - A `PGlite` instance from `@electric-sql/pglite`
+ * @param options - Adapter options
  * @returns A Kysely instance that executes queries on the client and closes it on `destroy()`
  * @example
  * ```typescript
@@ -68,5 +81,5 @@ export type Unmigrated<DB> = { [T in keyof DB]: { [C in keyof DB[T]]: Unmigrated
  * await db.transaction().execute((trx) => main(trx));
  * ```
  */
-export declare function createKyselyPGlite<DB = Record<string, never>>(client: PGliteClient): Kysely<DB>;
+export declare function createKyselyPGlite<DB = Record<string, never>>(client: PGliteClient, options?: CreateKyselyPGliteOptions): Kysely<DB>;
 //#endregion

package/dist/vitest/pglite-temporal.d.mts

@@ -0,0 +1,9 @@
+//#region src/vitest/pglite-temporal.d.ts
+/** Name and Postgres type OID of a column PGlite returned. */
+export interface PGliteField {
+  /** Column name */
+  name: string;
+  /** Postgres type OID */
+  dataTypeID: number;
+}
+//#endregion

package/dist/vitest/setup.d.mts

@@ -1,3 +1,4 @@
+import { applyDateDefault } from "./date-representation.mjs";
 //#region src/vitest/setup.d.ts
 /**
  * Extract a vault store from a secrets-shaped value.
@@ -21,4 +22,5 @@ export declare function extractVaultStore(secrets: unknown): Record<string, Reco
  * @returns Vault store keyed by vault name, or null if unavailable
  */
 export declare function loadSecretsFromConfig(configPath: string): Promise<Record<string, Record<string, string>> | null>;
-//#endregion
+//#endregion
+export { applyDateDefault };

package/dist/vitest/setup.mjs

@@ -1,2 +1,2 @@
-import{t as e}from"../globals-BCmGX05J.mjs";import{t}from"../secretmanager-5olfnI1b.mjs";import{pathToFileURL as n}from"node:url";import{beforeAll as r}from"vitest";function isTailorRuntime(){return e in globalThis}function extractVaultStore(e){if(!e||typeof e!=`object`)return null;let t=`vaults`in e&&typeof e.vaults==`object`&&e.vaults!==null?e.vaults:e,n={};for(let[e,r]of Object.entries(t))typeof r==`object`&&r&&(n[e]={...r});return Object.keys(n).length>0?n:null}async function loadSecretsFromConfig(e){try{let t=await import(n(e).href);return extractVaultStore(t.default?.secrets??t.secrets)}catch{return null}}r(async()=>{if(!isTailorRuntime())return;let e=process.env.__TAILOR_RUNTIME_CONFIG;if(!e)return;let n=await loadSecretsFromConfig(e);n&&t().setSecrets(n)});export{extractVaultStore,loadSecretsFromConfig};
+import{t as e}from"../globals-BCmGX05J.mjs";import{r as t,t as n}from"../date-representation-Cr7W7Pn2.mjs";import{pathToFileURL as r}from"node:url";import{afterAll as i,beforeAll as a}from"vitest";function isTailorRuntime(){return e in globalThis}function extractVaultStore(e){if(!e||typeof e!=`object`)return null;let t=`vaults`in e&&typeof e.vaults==`object`&&e.vaults!==null?e.vaults:e,n={};for(let[e,r]of Object.entries(t))typeof r==`object`&&r&&(n[e]={...r});return Object.keys(n).length>0?n:null}async function loadSecretsFromConfig(e){try{let t=await import(r(e).href);return extractVaultStore(t.default?.secrets??t.secrets)}catch{return null}}const o=isTailorRuntime()?process.env.__TAILOR_RUNTIME_DATE_DEFAULT:void 0,s=o===`temporal`||o===`date`||o===`legacy`?n(o):void 0;i(()=>s?.()),a(async()=>{if(!isTailorRuntime())return;let e=process.env.__TAILOR_RUNTIME_CONFIG;if(!e)return;let n=await loadSecretsFromConfig(e);n&&t().setSecrets(n)});export{n as applyDateDefault,extractVaultStore,loadSecretsFromConfig};
 //# sourceMappingURL=setup.mjs.map

package/dist/vitest/setup.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"setup.mjs","names":["RUNTIME_FLAG_KEY","secrets","source","store","vaultName","vaultData","config","pathToFileURL","configPath","beforeAll","mockSecretmanager"],"sources":["../../src/vitest/setup.ts"],"sourcesContent":["/**\n * Vitest setup file that seeds the SecretManager mock from `tailor.config.ts`.\n *\n * This file is auto-injected by tailorRuntime() but only activates when\n * the tailor-runtime environment is active (detected via __tailorRuntimeActive,\n * a flag set by injectMocks() during environment setup).\n */\nimport { pathToFileURL } from \"node:url\";\nimport { beforeAll } from \"vitest\";\nimport { RUNTIME_FLAG_KEY, mockSecretmanager } from \"./mock\";\n\nfunction isTailorRuntime(): boolean {\n  return RUNTIME_FLAG_KEY in globalThis;\n}\n\n/**\n * Extract a vault store from a secrets-shaped value.\n *\n * `defineSecretManager()` returns `{ vaults, options, get, getAll }` (get/getAll\n * are non-enumerable). When that shape is present, the actual vaults live\n * under `.vaults`. Otherwise fall back to treating the object itself as the\n * vault map (for plain object configs).\n * @param secrets - Value from `appConfig.secrets` or `config.secrets`\n * @returns Vault store, or null if the value is unusable\n */\nexport function extractVaultStore(secrets: unknown): Record<string, Record<string, string>> | null {\n  if (!secrets || typeof secrets !== \"object\") return null;\n\n  const source =\n    \"vaults\" in secrets &&\n    typeof (secrets as { vaults?: unknown }).vaults === \"object\" &&\n    (secrets as { vaults?: unknown }).vaults !== null\n      ? (secrets as { vaults: Record<string, unknown> }).vaults\n      : (secrets as Record<string, unknown>);\n\n  const store: Record<string, Record<string, string>> = {};\n  for (const [vaultName, vaultData] of Object.entries(source)) {\n    if (typeof vaultData === \"object\" && vaultData !== null) {\n      store[vaultName] = { ...(vaultData as Record<string, string>) };\n    }\n  }\n  return Object.keys(store).length > 0 ? store : null;\n}\n\n/**\n * Load and parse secrets from a tailor.config.ts file.\n *\n * Returns a vault store on success, or `null` on any failure (missing config,\n * import failure, missing/invalid secrets shape). Errors are swallowed so a\n * misconfigured project still boots — the user can set secrets manually via\n * `mockSecretmanager().setSecrets()`.\n * @param configPath - Absolute path to tailor.config.ts\n * @returns Vault store keyed by vault name, or null if unavailable\n */\nexport async function loadSecretsFromConfig(\n  configPath: string,\n): Promise<Record<string, Record<string, string>> | null> {\n  try {\n    // Convert to file URL so absolute Windows paths (e.g. \"C:\\...\") parse as\n    // valid ESM specifiers.\n    const config = await import(pathToFileURL(configPath).href);\n    const appConfig = config.default;\n    const secrets = appConfig?.secrets ?? config.secrets;\n    return extractVaultStore(secrets);\n  } catch {\n    return null;\n  }\n}\n\n// Load secrets from tailor.config.ts if config path is provided via env var\nbeforeAll(async () => {\n  if (!isTailorRuntime()) return;\n  const configPath = process.env.__TAILOR_RUNTIME_CONFIG;\n  if (!configPath) return;\n\n  const store = await loadSecretsFromConfig(configPath);\n  if (store) {\n    // Acquire without `using`: this is a one-time global seed that must persist\n    // across tests, so we deliberately do not dispose (which would reset it).\n    mockSecretmanager().setSecrets(store);\n  }\n});\n"],"mappings":"qKAWA,SAAS,iBAA2B,CAClC,OAAOA,KAAoB,UAC7B,CAYA,SAAgB,kBAAkB,EAAiE,CACjG,GAAI,CAACC,GAAW,OAAOA,GAAY,SAAU,OAAO,KAEpD,IAAMC,EACJ,WAAYD,GACZ,OAAQA,EAAiC,QAAW,UACnDA,EAAiC,SAAW,KACxCA,EAAgD,OAChDA,EAEDE,EAAgD,CAAC,EACvD,IAAK,GAAM,CAACC,EAAWC,KAAc,OAAO,QAAQH,CAAM,EACpD,OAAOG,GAAc,UAAYA,IACnC,EAAMD,GAAa,CAAE,GAAIC,CAAqC,GAGlE,OAAO,OAAO,KAAKF,CAAK,CAAC,CAAC,OAAS,EAAIA,EAAQ,IACjD,CAYA,eAAsB,sBACpB,EACwD,CACxD,GAAI,CAGF,IAAMG,EAAS,MAAM,OAAOC,EAAcC,CAAU,CAAC,CAAC,MAGtD,OAAO,kBAFWF,EAAO,SACE,SAAWA,EAAO,OACb,CAClC,MAAQ,CACN,OAAO,IACT,CACF,CAGAG,EAAU,SAAY,CACpB,GAAI,CAAC,gBAAgB,EAAG,OACxB,IAAMD,EAAa,QAAQ,IAAI,wBAC/B,GAAI,CAACA,EAAY,OAEjB,IAAML,EAAQ,MAAM,sBAAsBK,CAAU,EAChDL,GAGFO,EAAkB,CAAC,CAAC,WAAWP,CAAK,CAExC,CAAC"}
+{"version":3,"file":"setup.mjs","names":["RUNTIME_FLAG_KEY","mockSecretmanager","applyDateDefault","secrets","source","store","vaultName","vaultData","config","pathToFileURL","configPath","configuredDateDefault","restoreDateDefault","afterAll","beforeAll"],"sources":["../../src/vitest/setup.ts"],"sourcesContent":["/**\n * Vitest setup file that seeds the SecretManager mock from `tailor.config.ts`\n * and applies the date default the plugin read from it.\n *\n * This file is auto-injected by tailorRuntime() but only activates when\n * the tailor-runtime environment is active (detected via __tailorRuntimeActive,\n * a flag set by injectMocks() during environment setup).\n */\nimport { pathToFileURL } from \"node:url\";\nimport { afterAll, beforeAll } from \"vitest\";\nimport { applyDateDefault } from \"./date-representation\";\nimport { RUNTIME_FLAG_KEY, mockSecretmanager } from \"./mock\";\n\nexport { applyDateDefault };\n\nfunction isTailorRuntime(): boolean {\n  return RUNTIME_FLAG_KEY in globalThis;\n}\n\n/**\n * Extract a vault store from a secrets-shaped value.\n *\n * `defineSecretManager()` returns `{ vaults, options, get, getAll }` (get/getAll\n * are non-enumerable). When that shape is present, the actual vaults live\n * under `.vaults`. Otherwise fall back to treating the object itself as the\n * vault map (for plain object configs).\n * @param secrets - Value from `appConfig.secrets` or `config.secrets`\n * @returns Vault store, or null if the value is unusable\n */\nexport function extractVaultStore(secrets: unknown): Record<string, Record<string, string>> | null {\n  if (!secrets || typeof secrets !== \"object\") return null;\n\n  const source =\n    \"vaults\" in secrets &&\n    typeof (secrets as { vaults?: unknown }).vaults === \"object\" &&\n    (secrets as { vaults?: unknown }).vaults !== null\n      ? (secrets as { vaults: Record<string, unknown> }).vaults\n      : (secrets as Record<string, unknown>);\n\n  const store: Record<string, Record<string, string>> = {};\n  for (const [vaultName, vaultData] of Object.entries(source)) {\n    if (typeof vaultData === \"object\" && vaultData !== null) {\n      store[vaultName] = { ...(vaultData as Record<string, string>) };\n    }\n  }\n  return Object.keys(store).length > 0 ? store : null;\n}\n\n/**\n * Load and parse secrets from a tailor.config.ts file.\n *\n * Returns a vault store on success, or `null` on any failure (missing config,\n * import failure, missing/invalid secrets shape). Errors are swallowed so a\n * misconfigured project still boots — the user can set secrets manually via\n * `mockSecretmanager().setSecrets()`.\n * @param configPath - Absolute path to tailor.config.ts\n * @returns Vault store keyed by vault name, or null if unavailable\n */\nexport async function loadSecretsFromConfig(\n  configPath: string,\n): Promise<Record<string, Record<string, string>> | null> {\n  try {\n    // Convert to file URL so absolute Windows paths (e.g. \"C:\\...\") parse as\n    // valid ESM specifiers.\n    const config = await import(pathToFileURL(configPath).href);\n    const appConfig = config.default;\n    const secrets = appConfig?.secrets ?? config.secrets;\n    return extractVaultStore(secrets);\n  } catch {\n    return null;\n  }\n}\n\n// The plugin reads the config in the Vitest host and passes the result here.\n// Applied at the top level, before the test file and its imports evaluate, so a\n// field parsed at import time already follows the configured default.\nconst configuredDateDefault = isTailorRuntime()\n  ? process.env.__TAILOR_RUNTIME_DATE_DEFAULT\n  : undefined;\nconst restoreDateDefault =\n  configuredDateDefault === \"temporal\" ||\n  configuredDateDefault === \"date\" ||\n  configuredDateDefault === \"legacy\"\n    ? applyDateDefault(configuredDateDefault)\n    : undefined;\nafterAll(() => restoreDateDefault?.());\n\n// Load secrets from tailor.config.ts if config path is provided via env var\nbeforeAll(async () => {\n  if (!isTailorRuntime()) return;\n  const configPath = process.env.__TAILOR_RUNTIME_CONFIG;\n  if (!configPath) return;\n\n  const store = await loadSecretsFromConfig(configPath);\n  if (store) {\n    // Acquire without `using`: this is a one-time global seed that must persist\n    // across tests, so we deliberately do not dispose (which would reset it).\n    mockSecretmanager().setSecrets(store);\n  }\n});\n"],"mappings":"qMAeA,SAAS,iBAA2B,CAClC,OAAOA,KAAoB,UAC7B,CAYA,SAAgB,kBAAkB,EAAiE,CACjG,GAAI,CAACG,GAAW,OAAOA,GAAY,SAAU,OAAO,KAEpD,IAAMC,EACJ,WAAYD,GACZ,OAAQA,EAAiC,QAAW,UACnDA,EAAiC,SAAW,KACxCA,EAAgD,OAChDA,EAEDE,EAAgD,CAAC,EACvD,IAAK,GAAM,CAACC,EAAWC,KAAc,OAAO,QAAQH,CAAM,EACpD,OAAOG,GAAc,UAAYA,IACnC,EAAMD,GAAa,CAAE,GAAIC,CAAqC,GAGlE,OAAO,OAAO,KAAKF,CAAK,CAAC,CAAC,OAAS,EAAIA,EAAQ,IACjD,CAYA,eAAsB,sBACpB,EACwD,CACxD,GAAI,CAGF,IAAMG,EAAS,MAAM,OAAOC,EAAcC,CAAU,CAAC,CAAC,MAGtD,OAAO,kBAFWF,EAAO,SACE,SAAWA,EAAO,OACb,CAClC,MAAQ,CACN,OAAO,IACT,CACF,CAKA,MAAMG,EAAwB,gBAAgB,EAC1C,QAAQ,IAAI,8BACZ,IAAA,GACEC,EACJD,IAA0B,YAC1BA,IAA0B,QAC1BA,IAA0B,SACtBT,EAAiBS,CAAqB,EACtC,IAAA,GACNE,MAAeD,IAAqB,CAAC,EAGrCE,EAAU,SAAY,CACpB,GAAI,CAAC,gBAAgB,EAAG,OACxB,IAAMJ,EAAa,QAAQ,IAAI,wBAC/B,GAAI,CAACA,EAAY,OAEjB,IAAML,EAAQ,MAAM,sBAAsBK,CAAU,EAChDL,GAGFJ,EAAkB,CAAC,CAAC,WAAWI,CAAK,CAExC,CAAC"}