@tailor-platform/sdk 2.26.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/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"}