@tailor-platform/sdk 2.0.0-next.10 → 2.0.0-next.11

package/dist/utils/test/index.mjs

@@ -1,175 +1,3 @@
-import { pathToFileURL } from "node:url";
-import * as path from "node:path";
-
-//#region src/utils/test/mock.ts
-const GlobalThis = globalThis;
-/**
-* Sets up a mock for `globalThis.tailordb.Client` used in bundled resolver/executor tests.
-* @deprecated Use `mockTailordb` from `@tailor-platform/sdk/vitest` with the `tailor-runtime` environment instead.
-* @param resolver - Optional function to resolve query results. Defaults to returning empty arrays.
-* @returns Object containing arrays of executed queries and created clients for assertions.
-*/
-function setupTailordbMock(resolver = () => []) {
-	const executedQueries = [];
-	const createdClients = [];
-	class MockTailordbClient {
-		record;
-		constructor({ namespace }) {
-			this.record = {
-				namespace,
-				ended: false
-			};
-			createdClients.push(this.record);
-		}
-		async connect() {}
-		async end() {
-			this.record.ended = true;
-		}
-		async queryObject(query, params = []) {
-			executedQueries.push({
-				query,
-				params
-			});
-			return { rows: resolver(query, params) };
-		}
-	}
-	GlobalThis.tailordb = { Client: MockTailordbClient };
-	return {
-		executedQueries,
-		createdClients
-	};
-}
-/**
-* Sets up a mock for `globalThis.tailor.workflow.execJobFunction` used in bundled workflow tests.
-* `wait`/`resolve` are stubbed to throw a helpful error directing to `mockWorkflow`,
-* so mistakenly calling wait without wait-point mocks produces a clear message instead of a TypeError.
-* @deprecated Use `mockWorkflow` from `@tailor-platform/sdk/vitest` with the `tailor-runtime` environment instead.
-* @param handler - Function that handles started job calls and returns results.
-* @returns Object containing an array of started jobs for assertions.
-*/
-function setupWorkflowMock(handler) {
-	const startedJobs = [];
-	const execJobFunction = (jobName, args) => {
-		startedJobs.push({
-			jobName,
-			args
-		});
-		return handler(jobName, args);
-	};
-	GlobalThis.tailor = {
-		...GlobalThis.tailor,
-		workflow: {
-			wait: () => {
-				throw new Error("tailor.workflow.wait is not mocked. Use mockWorkflow from @tailor-platform/sdk/vitest in tests.");
-			},
-			resolve: async () => {
-				throw new Error("tailor.workflow.resolve is not mocked. Use mockWorkflow from @tailor-platform/sdk/vitest in tests.");
-			},
-			...GlobalThis.tailor?.workflow,
-			execJobFunction,
-			startJobFunction: execJobFunction
-		}
-	};
-	return { startedJobs };
-}
-/**
-* Sets up a mock for `globalThis.tailor.context.getInvoker` used in bundled
-* resolver/executor/workflow tests.
-* @deprecated With the `tailor-runtime` environment from `@tailor-platform/sdk/vitest`, drive the invoker via `vi.spyOn(globalThis.tailor.context, "getInvoker").mockReturnValue(...)` for bundled tests, or pass `invoker` directly to `.body()` when unit-testing resolvers/executors/workflow jobs against the TypeScript source.
-* @param invoker - The `TailorPrincipal` value to return, or `null` for anonymous.
-*/
-function setupInvokerMock(invoker) {
-	const raw = invoker ? {
-		id: invoker.id,
-		type: invoker.type,
-		workspaceId: invoker.workspaceId,
-		attributes: invoker.attributeList,
-		attributeMap: invoker.attributes
-	} : null;
-	GlobalThis.tailor = {
-		...GlobalThis.tailor,
-		context: { getInvoker: () => raw }
-	};
-}
-/**
-* Sets up a mock for `globalThis.TailorErrors` used in bundled resolver tests.
-* Mimics the PF runtime's TailorErrors class that serializes errors with the `TailorErrors: ` prefix.
-* @deprecated Use the `tailor-runtime` environment from `@tailor-platform/sdk/vitest` which auto-injects TailorErrors.
-*/
-function setupTailorErrorsMock() {
-	GlobalThis.TailorErrors = class TailorErrors extends Error {
-		errors;
-		constructor(errors) {
-			super(`TailorErrors: ${JSON.stringify({ errors })}`);
-			this.name = "TailorErrors";
-			this.errors = errors;
-		}
-	};
-}
-/**
-* Sets up mocks for `globalThis.tailor.workflow.wait` and `.resolve` used in bundled workflow tests.
-* `execJobFunction` is stubbed to throw a helpful error directing to `setupWorkflowMock()`,
-* so mistakenly starting a job without job mocks produces a clear message instead of silently returning undefined.
-* @deprecated Use `mockWorkflow` from `@tailor-platform/sdk/vitest` with the `tailor-runtime` environment instead.
-*   `setWaitHandler` / `setResolveHandler` cover wait/resolve, and `waitCalls` / `resolveCalls` give the same assertion shape.
-* @param config - Optional handlers for wait and resolve calls.
-* @param config.onWait - Handler called when wait is invoked.
-* @param config.onResolve - Handler called when resolve is invoked.
-* @returns Object containing arrays of wait and resolve calls for assertions.
-*/
-function setupWaitPointMock(config) {
-	const waitCalls = [];
-	const resolveCalls = [];
-	const throwUnmocked = () => {
-		throw new Error("tailor.workflow.execJobFunction is not mocked. Use setupWorkflowMock() in tests.");
-	};
-	GlobalThis.tailor = {
-		...GlobalThis.tailor,
-		workflow: {
-			execJobFunction: throwUnmocked,
-			startJobFunction: throwUnmocked,
-			...GlobalThis.tailor?.workflow,
-			wait: (key, payload) => {
-				waitCalls.push({
-					key,
-					payload
-				});
-				return config?.onWait?.(key, payload);
-			},
-			resolve: async (executionId, key, callback) => {
-				resolveCalls.push({
-					executionId,
-					key
-				});
-				await config?.onResolve?.(executionId, key, callback);
-			}
-		}
-	};
-	return {
-		waitCalls,
-		resolveCalls
-	};
-}
-/**
-* Creates a function that imports a bundled JS file and returns its `main` export.
-* Used to test bundled output from `apply --buildOnly`.
-* @param baseDir - Base directory where bundled files are located.
-* @returns An async function that takes a relative path and returns the `main` function.
-* @deprecated This is an SDK-internal testing helper. Bundling integrity is the SDK's responsibility,
-* not the application's — verify your code through unit tests against the TypeScript source and
-* E2E tests against a deployed application instead. This export will be removed in a future release.
-*/
-function createImportMain(baseDir) {
-	return async (relativePath) => {
-		const fileUrl = pathToFileURL(path.join(baseDir, relativePath));
-		fileUrl.searchParams.set("v", `${Date.now()}-${Math.random()}`);
-		const main = (await import(fileUrl.href)).main;
-		if (typeof main !== "function") throw new Error(`Expected "main" to be a function in ${relativePath}, got ${typeof main}`);
-		return main;
-	};
-}
-
-//#endregion
 //#region src/utils/test/index.ts
 /**
 * Creates a hook function that processes TailorDB type fields
@@ -254,5 +82,5 @@ function createStandardSchema(schemaType, hook) {
 }
 
 //#endregion
-export { createImportMain, createStandardSchema, createTailorDBHook, setupInvokerMock, setupTailorErrorsMock, setupTailordbMock, setupWaitPointMock, setupWorkflowMock };
+export { createStandardSchema, createTailorDBHook };
 //# sourceMappingURL=index.mjs.map

package/dist/utils/test/index.mjs.map

@@ -1 +1 @@
-{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/test/mock.ts","../../../src/utils/test/index.ts"],"sourcesContent":["import * as path from \"node:path\";\nimport { pathToFileURL } from \"node:url\";\nimport type { ContextInvoker } from \"#/runtime/context\";\nimport type { TailorPrincipal } from \"#/runtime/types\";\nimport type { ExecJobFunctionOptions } from \"#/runtime/workflow\";\n\ntype MainFunction = (args: Record<string, unknown>) => unknown | Promise<unknown>;\ntype QueryResolver = (query: string, params: unknown[]) => unknown[];\ntype JobHandler = (jobName: string, args: unknown) => unknown;\ntype WaitHandler = (key: string, payload: unknown) => unknown;\ntype ResolveHandler = (\n  executionId: string,\n  key: string,\n  callback: (payload: unknown) => unknown,\n) => Promise<void> | void;\n\ninterface TailordbGlobal {\n  tailordb?: {\n    Client: new (config: { namespace?: string }) => {\n      connect(): Promise<void> | void;\n      end(): Promise<void> | void;\n      queryObject(\n        query: string,\n        params?: unknown[],\n      ): Promise<{ rows: unknown[] }> | { rows: unknown[] };\n    };\n  };\n  tailor?: {\n    workflow: {\n      execJobFunction: (\n        jobName: string,\n        args: unknown,\n        options?: ExecJobFunctionOptions,\n      ) => unknown;\n      startJobFunction: (\n        jobName: string,\n        args: unknown,\n        options?: ExecJobFunctionOptions,\n      ) => unknown;\n      wait?: (key: string, payload?: unknown) => unknown;\n      resolve?: (\n        executionId: string,\n        key: string,\n        callback: (payload: unknown) => unknown,\n      ) => Promise<void>;\n    };\n    context: {\n      getInvoker: () => ContextInvoker | null;\n    };\n  };\n}\n\ninterface TailorErrorItem {\n  message: string;\n  path: (string | number)[];\n}\n\ninterface TailorErrorsGlobal {\n  TailorErrors?: new (errors: TailorErrorItem[]) => Error;\n}\n\nconst GlobalThis = globalThis as unknown as TailordbGlobal & TailorErrorsGlobal;\n\n/**\n * Sets up a mock for `globalThis.tailordb.Client` used in bundled resolver/executor tests.\n * @deprecated Use `mockTailordb` from `@tailor-platform/sdk/vitest` with the `tailor-runtime` environment instead.\n * @param resolver - Optional function to resolve query results. Defaults to returning empty arrays.\n * @returns Object containing arrays of executed queries and created clients for assertions.\n */\nexport function setupTailordbMock(resolver: QueryResolver = () => []): {\n  executedQueries: { query: string; params: unknown[] }[];\n  createdClients: { namespace?: string; ended: boolean }[];\n} {\n  const executedQueries: { query: string; params: unknown[] }[] = [];\n  const createdClients: { namespace?: string; ended: boolean }[] = [];\n\n  class MockTailordbClient {\n    private record: { namespace?: string; ended: boolean };\n\n    constructor({ namespace }: { namespace?: string }) {\n      this.record = { namespace, ended: false };\n      createdClients.push(this.record);\n    }\n\n    async connect(): Promise<void> {\n      /* noop */\n    }\n\n    async end(): Promise<void> {\n      this.record.ended = true;\n    }\n\n    async queryObject(query: string, params: unknown[] = []): Promise<{ rows: unknown[] }> {\n      executedQueries.push({ query, params });\n      return { rows: resolver(query, params) };\n    }\n  }\n\n  GlobalThis.tailordb = {\n    Client: MockTailordbClient,\n  } as typeof GlobalThis.tailordb;\n\n  return { executedQueries, createdClients };\n}\n\n/**\n * Sets up a mock for `globalThis.tailor.workflow.execJobFunction` used in bundled workflow tests.\n * `wait`/`resolve` are stubbed to throw a helpful error directing to `mockWorkflow`,\n * so mistakenly calling wait without wait-point mocks produces a clear message instead of a TypeError.\n * @deprecated Use `mockWorkflow` from `@tailor-platform/sdk/vitest` with the `tailor-runtime` environment instead.\n * @param handler - Function that handles started job calls and returns results.\n * @returns Object containing an array of started jobs for assertions.\n */\nexport function setupWorkflowMock(handler: JobHandler): {\n  startedJobs: { jobName: string; args: unknown }[];\n} {\n  const startedJobs: { jobName: string; args: unknown }[] = [];\n\n  const execJobFunction = (jobName: string, args: unknown): unknown => {\n    startedJobs.push({ jobName, args });\n    return handler(jobName, args);\n  };\n\n  GlobalThis.tailor = {\n    ...GlobalThis.tailor,\n    workflow: {\n      wait: () => {\n        throw new Error(\n          \"tailor.workflow.wait is not mocked. Use mockWorkflow from @tailor-platform/sdk/vitest in tests.\",\n        );\n      },\n      resolve: async () => {\n        throw new Error(\n          \"tailor.workflow.resolve is not mocked. Use mockWorkflow from @tailor-platform/sdk/vitest in tests.\",\n        );\n      },\n      ...GlobalThis.tailor?.workflow,\n      execJobFunction,\n      startJobFunction: execJobFunction,\n    },\n  } as typeof GlobalThis.tailor;\n\n  return { startedJobs };\n}\n\n/**\n * Sets up a mock for `globalThis.tailor.context.getInvoker` used in bundled\n * resolver/executor/workflow tests.\n * @deprecated With the `tailor-runtime` environment from `@tailor-platform/sdk/vitest`, drive the invoker via `vi.spyOn(globalThis.tailor.context, \"getInvoker\").mockReturnValue(...)` for bundled tests, or pass `invoker` directly to `.body()` when unit-testing resolvers/executors/workflow jobs against the TypeScript source.\n * @param invoker - The `TailorPrincipal` value to return, or `null` for anonymous.\n */\nexport function setupInvokerMock(invoker: TailorPrincipal | null): void {\n  const raw: ContextInvoker | null = invoker\n    ? {\n        id: invoker.id,\n        type: invoker.type,\n        workspaceId: invoker.workspaceId,\n        attributes: invoker.attributeList as string[],\n        attributeMap: invoker.attributes as Record<string, unknown>,\n      }\n    : null;\n\n  GlobalThis.tailor = {\n    ...GlobalThis.tailor,\n    context: {\n      getInvoker: () => raw,\n    },\n  } as typeof GlobalThis.tailor;\n}\n\n/**\n * Sets up a mock for `globalThis.TailorErrors` used in bundled resolver tests.\n * Mimics the PF runtime's TailorErrors class that serializes errors with the `TailorErrors: ` prefix.\n * @deprecated Use the `tailor-runtime` environment from `@tailor-platform/sdk/vitest` which auto-injects TailorErrors.\n */\nexport function setupTailorErrorsMock(): void {\n  GlobalThis.TailorErrors = class TailorErrors extends Error {\n    errors: TailorErrorItem[];\n\n    constructor(errors: TailorErrorItem[]) {\n      super(`TailorErrors: ${JSON.stringify({ errors })}`);\n      this.name = \"TailorErrors\";\n      this.errors = errors;\n    }\n  };\n}\n\n/**\n * Sets up mocks for `globalThis.tailor.workflow.wait` and `.resolve` used in bundled workflow tests.\n * `execJobFunction` is stubbed to throw a helpful error directing to `setupWorkflowMock()`,\n * so mistakenly starting a job without job mocks produces a clear message instead of silently returning undefined.\n * @deprecated Use `mockWorkflow` from `@tailor-platform/sdk/vitest` with the `tailor-runtime` environment instead.\n *   `setWaitHandler` / `setResolveHandler` cover wait/resolve, and `waitCalls` / `resolveCalls` give the same assertion shape.\n * @param config - Optional handlers for wait and resolve calls.\n * @param config.onWait - Handler called when wait is invoked.\n * @param config.onResolve - Handler called when resolve is invoked.\n * @returns Object containing arrays of wait and resolve calls for assertions.\n */\nexport function setupWaitPointMock(config?: { onWait?: WaitHandler; onResolve?: ResolveHandler }): {\n  waitCalls: { key: string; payload: unknown }[];\n  resolveCalls: { executionId: string; key: string }[];\n} {\n  const waitCalls: { key: string; payload: unknown }[] = [];\n  const resolveCalls: { executionId: string; key: string }[] = [];\n\n  const throwUnmocked = (): never => {\n    throw new Error(\n      \"tailor.workflow.execJobFunction is not mocked. Use setupWorkflowMock() in tests.\",\n    );\n  };\n\n  GlobalThis.tailor = {\n    ...GlobalThis.tailor,\n    workflow: {\n      execJobFunction: throwUnmocked,\n      startJobFunction: throwUnmocked,\n      ...GlobalThis.tailor?.workflow,\n      wait: (key: string, payload?: unknown) => {\n        waitCalls.push({ key, payload });\n        return config?.onWait?.(key, payload);\n      },\n      resolve: async (\n        executionId: string,\n        key: string,\n        callback: (payload: unknown) => unknown,\n      ) => {\n        resolveCalls.push({ executionId, key });\n        await config?.onResolve?.(executionId, key, callback);\n      },\n    },\n  } as typeof GlobalThis.tailor;\n\n  return { waitCalls, resolveCalls };\n}\n\n/**\n * Creates a function that imports a bundled JS file and returns its `main` export.\n * Used to test bundled output from `apply --buildOnly`.\n * @param baseDir - Base directory where bundled files are located.\n * @returns An async function that takes a relative path and returns the `main` function.\n * @deprecated This is an SDK-internal testing helper. Bundling integrity is the SDK's responsibility,\n * not the application's — verify your code through unit tests against the TypeScript source and\n * E2E tests against a deployed application instead. This export will be removed in a future release.\n */\nexport function createImportMain(baseDir: string): (relativePath: string) => Promise<MainFunction> {\n  return async (relativePath: string): Promise<MainFunction> => {\n    const fileUrl = pathToFileURL(path.join(baseDir, relativePath));\n    fileUrl.searchParams.set(\"v\", `${Date.now()}-${Math.random()}`);\n    const module = await import(fileUrl.href);\n    const main = module.main;\n    if (typeof main !== \"function\") {\n      throw new Error(`Expected \"main\" to be a function in ${relativePath}, got ${typeof main}`);\n    }\n    return main;\n  };\n}\n","import type { output } from \"#/configure/index\";\nimport type { TailorDBType } from \"#/configure/services/tailordb/schema\";\nimport type { TailorField } from \"#/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport {\n  setupTailordbMock,\n  setupTailorErrorsMock,\n  setupWorkflowMock,\n  setupInvokerMock,\n  setupWaitPointMock,\n  createImportMain,\n} from \"./mock\";\n\n/**\n * Creates a hook function that processes TailorDB type fields\n * - Uses existing id from data if provided, otherwise generates UUID for id fields\n * - Recursively processes nested types\n * - Executes hooks.create for fields with create hooks\n * @template T - The output type of the hook function\n * @param type - TailorDB type definition\n * @returns A function that transforms input data according to field hooks\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createTailorDBHook<T extends TailorDBType<any, any>>(type: T) {\n  return (data: unknown, now: Date = new Date()) => {\n    const obj = data && typeof data === \"object\" ? (data as Record<string, unknown>) : undefined;\n    const hooked = Object.entries(type.fields).reduce(\n      (hooked, [key, value]) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const field = value as TailorField<any, any, any>;\n        if (key === \"id\") {\n          hooked[key] = obj?.[key] ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          const nestedHook = createTailorDBHook({ fields: field.fields } as any);\n          if (field.metadata.array) {\n            const nestedValue = obj?.[key];\n            hooked[key] = Array.isArray(nestedValue)\n              ? nestedValue.map((item) => nestedHook(item, now))\n              : nestedValue;\n          } else {\n            hooked[key] = nestedHook(obj?.[key], now);\n          }\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            input: obj?.[key],\n            invoker: null,\n            now,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (obj) {\n          hooked[key] = obj[key];\n        }\n        if (hooked[key] == null && field.metadata.default !== undefined) {\n          const isTimeType =\n            field.type === \"datetime\" || field.type === \"date\" || field.type === \"time\";\n          hooked[key] =\n            field.metadata.default === \"now\" && isTimeType\n              ? now.toISOString()\n              : field.metadata.default;\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    );\n\n    // oxlint-disable-next-line typescript/no-unnecessary-condition -- metadata absent in recursive nested calls\n    if (type.metadata?.typeHook?.create) {\n      const { id: _id, ...typeHookInput } = hooked;\n      // oxlint-disable-next-line typescript/no-unsafe-function-type\n      const overrides = (type.metadata.typeHook.create as Function)({\n        input: typeHookInput,\n        invoker: null,\n        now,\n      });\n      if (overrides && typeof overrides === \"object\") {\n        for (const [key, value] of Object.entries(overrides as Record<string, unknown>)) {\n          hooked[key] = value instanceof Date ? value.toISOString() : value;\n        }\n      }\n    }\n\n    // oxlint-disable-next-line typescript/no-unnecessary-condition -- metadata absent in recursive nested calls\n    if (type.metadata?.typeValidate) {\n      const { id: _id, ...newRecord } = hooked;\n      // oxlint-disable-next-line typescript/no-unsafe-function-type\n      (type.metadata.typeValidate as Function)(\n        { newRecord, oldRecord: null, invoker: null },\n        (field: string, message: string) => {\n          throw new Error(`Validation failed on field '${field}': ${message}`);\n        },\n      );\n    }\n\n    return hooked as Partial<output<T>>;\n  };\n}\n\n/**\n * Creates the standard schema definition for lines-db\n * This returns the first argument for defineSchema with the ~standard section\n * @template T - The output type after validation\n * @param schemaType - TailorDB field schema for validation\n * @param hook - Hook function to transform data before validation\n * @returns Schema object with ~standard section for defineSchema\n */\nexport function createStandardSchema<T = Record<string, unknown>>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schemaType: TailorField<any, T>,\n  hook: (data: unknown) => Partial<T>,\n) {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"@tailor-platform/sdk\",\n      validate: (value: unknown) => {\n        const hooked = hook(value);\n        const result = schemaType.parse({\n          value: hooked,\n          data: hooked,\n          invoker: null,\n        });\n        if (result.issues) {\n          return result;\n        }\n        return { value: hooked as T };\n      },\n    },\n  } as const satisfies StandardSchemaV1<T>;\n}\n"],"mappings":"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"}
+{"version":3,"file":"index.mjs","names":[],"sources":["../../../src/utils/test/index.ts"],"sourcesContent":["import type { output } from \"#/configure/index\";\nimport type { TailorDBType } from \"#/configure/services/tailordb/schema\";\nimport type { TailorField } from \"#/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\n/**\n * Creates a hook function that processes TailorDB type fields\n * - Uses existing id from data if provided, otherwise generates UUID for id fields\n * - Recursively processes nested types\n * - Executes hooks.create for fields with create hooks\n * @template T - The output type of the hook function\n * @param type - TailorDB type definition\n * @returns A function that transforms input data according to field hooks\n */\n// eslint-disable-next-line @typescript-eslint/no-explicit-any\nexport function createTailorDBHook<T extends TailorDBType<any, any>>(type: T) {\n  return (data: unknown, now: Date = new Date()) => {\n    const obj = data && typeof data === \"object\" ? (data as Record<string, unknown>) : undefined;\n    const hooked = Object.entries(type.fields).reduce(\n      (hooked, [key, value]) => {\n        // eslint-disable-next-line @typescript-eslint/no-explicit-any\n        const field = value as TailorField<any, any, any>;\n        if (key === \"id\") {\n          hooked[key] = obj?.[key] ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          const nestedHook = createTailorDBHook({ fields: field.fields } as any);\n          if (field.metadata.array) {\n            const nestedValue = obj?.[key];\n            hooked[key] = Array.isArray(nestedValue)\n              ? nestedValue.map((item) => nestedHook(item, now))\n              : nestedValue;\n          } else {\n            hooked[key] = nestedHook(obj?.[key], now);\n          }\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            input: obj?.[key],\n            invoker: null,\n            now,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (obj) {\n          hooked[key] = obj[key];\n        }\n        if (hooked[key] == null && field.metadata.default !== undefined) {\n          const isTimeType =\n            field.type === \"datetime\" || field.type === \"date\" || field.type === \"time\";\n          hooked[key] =\n            field.metadata.default === \"now\" && isTimeType\n              ? now.toISOString()\n              : field.metadata.default;\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    );\n\n    // oxlint-disable-next-line typescript/no-unnecessary-condition -- metadata absent in recursive nested calls\n    if (type.metadata?.typeHook?.create) {\n      const { id: _id, ...typeHookInput } = hooked;\n      // oxlint-disable-next-line typescript/no-unsafe-function-type\n      const overrides = (type.metadata.typeHook.create as Function)({\n        input: typeHookInput,\n        invoker: null,\n        now,\n      });\n      if (overrides && typeof overrides === \"object\") {\n        for (const [key, value] of Object.entries(overrides as Record<string, unknown>)) {\n          hooked[key] = value instanceof Date ? value.toISOString() : value;\n        }\n      }\n    }\n\n    // oxlint-disable-next-line typescript/no-unnecessary-condition -- metadata absent in recursive nested calls\n    if (type.metadata?.typeValidate) {\n      const { id: _id, ...newRecord } = hooked;\n      // oxlint-disable-next-line typescript/no-unsafe-function-type\n      (type.metadata.typeValidate as Function)(\n        { newRecord, oldRecord: null, invoker: null },\n        (field: string, message: string) => {\n          throw new Error(`Validation failed on field '${field}': ${message}`);\n        },\n      );\n    }\n\n    return hooked as Partial<output<T>>;\n  };\n}\n\n/**\n * Creates the standard schema definition for lines-db\n * This returns the first argument for defineSchema with the ~standard section\n * @template T - The output type after validation\n * @param schemaType - TailorDB field schema for validation\n * @param hook - Hook function to transform data before validation\n * @returns Schema object with ~standard section for defineSchema\n */\nexport function createStandardSchema<T = Record<string, unknown>>(\n  // eslint-disable-next-line @typescript-eslint/no-explicit-any\n  schemaType: TailorField<any, T>,\n  hook: (data: unknown) => Partial<T>,\n) {\n  return {\n    \"~standard\": {\n      version: 1,\n      vendor: \"@tailor-platform/sdk\",\n      validate: (value: unknown) => {\n        const hooked = hook(value);\n        const result = schemaType.parse({\n          value: hooked,\n          data: hooked,\n          invoker: null,\n        });\n        if (result.issues) {\n          return result;\n        }\n        return { value: hooked as T };\n      },\n    },\n  } as const satisfies StandardSchemaV1<T>;\n}\n"],"mappings":";;;;;;;;;;AAeA,SAAgB,mBAAqD,MAAS;CAC5E,QAAQ,MAAe,sBAAY,IAAI,KAAK,MAAM;EAChD,MAAM,MAAM,QAAQ,OAAO,SAAS,WAAY,OAAmC;EACnF,MAAM,SAAS,OAAO,QAAQ,KAAK,MAAM,CAAC,CAAC,QACxC,QAAQ,CAAC,KAAK,WAAW;GAExB,MAAM,QAAQ;GACd,IAAI,QAAQ,MACV,OAAO,OAAO,MAAM,QAAQ,OAAO,WAAW;QACzC,IAAI,MAAM,SAAS,UAAU;IAElC,MAAM,aAAa,mBAAmB,EAAE,QAAQ,MAAM,OAAO,CAAQ;IACrE,IAAI,MAAM,SAAS,OAAO;KACxB,MAAM,cAAc,MAAM;KAC1B,OAAO,OAAO,MAAM,QAAQ,WAAW,IACnC,YAAY,KAAK,SAAS,WAAW,MAAM,GAAG,CAAC,IAC/C;IACN,OACE,OAAO,OAAO,WAAW,MAAM,MAAM,GAAG;GAE5C,OAAO,IAAI,MAAM,SAAS,OAAO,QAAQ;IACvC,OAAO,OAAO,MAAM,SAAS,MAAM,OAAO;KACxC,OAAO,MAAM;KACb,SAAS;KACT;IACF,CAAC;IACD,IAAI,OAAO,gBAAgB,MACzB,OAAO,OAAO,OAAO,IAAI,CAAC,YAAY;GAE1C,OAAO,IAAI,KACT,OAAO,OAAO,IAAI;GAEpB,IAAI,OAAO,QAAQ,QAAQ,MAAM,SAAS,YAAY,QAAW;IAC/D,MAAM,aACJ,MAAM,SAAS,cAAc,MAAM,SAAS,UAAU,MAAM,SAAS;IACvE,OAAO,OACL,MAAM,SAAS,YAAY,SAAS,aAChC,IAAI,YAAY,IAChB,MAAM,SAAS;GACvB;GACA,OAAO;EACT,GACA,CAAC,CACH;EAGA,IAAI,KAAK,UAAU,UAAU,QAAQ;GACnC,MAAM,EAAE,IAAI,KAAK,GAAG,kBAAkB;GAEtC,MAAM,YAAa,KAAK,SAAS,SAAS,OAAoB;IAC5D,OAAO;IACP,SAAS;IACT;GACF,CAAC;GACD,IAAI,aAAa,OAAO,cAAc,UACpC,KAAK,MAAM,CAAC,KAAK,UAAU,OAAO,QAAQ,SAAoC,GAC5E,OAAO,OAAO,iBAAiB,OAAO,MAAM,YAAY,IAAI;EAGlE;EAGA,IAAI,KAAK,UAAU,cAAc;GAC/B,MAAM,EAAE,IAAI,KAAK,GAAG,cAAc;GAElC,AAAC,KAAK,SAAS,aACb;IAAE;IAAW,WAAW;IAAM,SAAS;GAAK,IAC3C,OAAe,YAAoB;IAClC,MAAM,IAAI,MAAM,+BAA+B,MAAM,KAAK,SAAS;GACrE,CACF;EACF;EAEA,OAAO;CACT;AACF;;;;;;;;;AAUA,SAAgB,qBAEd,YACA,MACA;CACA,OAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,SAAS,KAAK,KAAK;GACzB,MAAM,SAAS,WAAW,MAAM;IAC9B,OAAO;IACP,MAAM;IACN,SAAS;GACX,CAAC;GACD,IAAI,OAAO,QACT,OAAO;GAET,OAAO,EAAE,OAAO,OAAY;EAC9B;CACF,EACF;AACF"}

package/dist/vitest/environment.mjs

@@ -1,4 +1,4 @@
-import { n as cleanupPlatformGlobals, r as installPlatformGlobals, t as RUNTIME_FLAG_KEY } from "../globals-DQotNuwK.mjs";
+import { n as cleanupPlatformGlobals, r as installPlatformGlobals, t as RUNTIME_FLAG_KEY } from "../globals-TfAVItuK.mjs";
 import * as globals from "globals";
 
 //#region src/vitest/environment.ts

package/dist/vitest/index.d.mts

@@ -44,8 +44,8 @@ import { Plugin } from "vitest/config";
  *
  * - **`process`** and **`require`** are NOT removed or blocked. Vitest's internal
  *   runner depends on them. On the real Tailor Platform runtime, they do not exist.
- * - **Dynamic `import()`** of bundled files (via `createImportMain()`) bypasses
- *   the transform hook since those files are loaded through Node.js native loader.
+ * - **Dynamic `import()`** of bundled files bypasses the transform hook since
+ *   those files are loaded through Node.js native loader.
  * ## Options
  *
  * - **`config`** — Path to `tailor.config.ts`. Loads `defineSecretManager()` values

package/dist/vitest/index.mjs

@@ -1,52 +1,23 @@
 import { i as getRegisteredJob, t as START_DEFAULT } from "../registry-BIGVUrMB.mjs";
 import { a as writeWorkflowTestEnv, n as clearWorkflowTestEnv, r as readWorkflowTestEnv, t as buildJobContext } from "../test-env-key-D7UkZp99.mjs";
 import { t as assertDefined } from "../assert-DBxo8jPo.mjs";
+import { n as isNodeBuiltinImport, t as getNodeBuiltinMessage } from "../node-builtins-CmaL2Cbq.mjs";
 import { t as platformSerialize } from "../platform-serialize-RoRtBS0v.mjs";
 import { i as withDispose, n as tailorRoot, r as tailordbRoot, t as mockSecretmanager } from "../secretmanager-IY4UvinW.mjs";
-import { builtinModules } from "node:module";
 import { isEqual } from "es-toolkit";
 import { fileURLToPath } from "node:url";
-import { dirname, isAbsolute, matchesGlob, relative, resolve } from "node:path";
 import { ColumnNode, InsertQueryNode, Kysely, PostgresAdapter, PostgresIntrospector, PostgresQueryCompiler, PrimitiveValueListNode, ReferenceNode, UpdateQueryNode, ValueListNode, ValueNode, ValuesNode } from "kysely";
+import { dirname, isAbsolute, matchesGlob, relative, resolve } from "node:path";
 import { vi } from "vitest";
 
 //#region src/vitest/blocked-modules.ts
 /**
-* Blocked Node.js built-in modules and their Web Standard API alternatives.
-*
-* The Tailor Platform runtime only provides Web Standard APIs.
-* These Node.js modules are not available and should be replaced with
-* the suggested alternatives.
-*/
-const SUGGESTIONS = {
-	crypto: "Use the Web Crypto API (globalThis.crypto) instead.",
-	buffer: "Use Uint8Array or ArrayBuffer instead.",
-	fs: "File system access is not available in the Tailor Platform runtime.",
-	"fs/promises": "File system access is not available in the Tailor Platform runtime.",
-	path: "Use URL or URLPattern for path manipulation.",
-	http: "Use the Fetch API (globalThis.fetch) for HTTP requests instead.",
-	https: "Use the Fetch API (globalThis.fetch) for HTTPS requests instead.",
-	url: "Use the URL and URLSearchParams Web APIs instead.",
-	util: "Use Web Standard APIs instead.",
-	stream: "Use Web Streams API (ReadableStream, WritableStream, TransformStream) instead.",
-	"stream/web": "Use Web Streams API (ReadableStream, WritableStream, TransformStream) instead.",
-	events: "Use EventTarget instead.",
-	zlib: "Use CompressionStream and DecompressionStream Web APIs instead.",
-	querystring: "Use URLSearchParams instead.",
-	string_decoder: "Use TextDecoder instead."
-};
-const BLOCKED_MODULES = /* @__PURE__ */ new Set();
-for (const mod of builtinModules) {
-	BLOCKED_MODULES.add(mod);
-	BLOCKED_MODULES.add(`node:${mod}`);
-}
-/**
 * Check if a module specifier is a blocked Node.js built-in.
 * @param specifier - Module specifier to check (e.g. "node:crypto", "fs")
 * @returns Whether the specifier is blocked
 */
 function isBlockedModule(specifier) {
-	return BLOCKED_MODULES.has(specifier);
+	return isNodeBuiltinImport(specifier);
 }
 /**
 * Get the error message for a blocked module import.
@@ -54,10 +25,7 @@ function isBlockedModule(specifier) {
 * @returns Error message with optional suggestion for the Web Standard API alternative
 */
 function getBlockedMessage(specifier) {
-	const bare = specifier.startsWith("node:") ? specifier.slice(5) : specifier;
-	const suggestion = SUGGESTIONS[bare];
-	const base = `"${specifier}" is not available in the Tailor Platform runtime.`;
-	return suggestion ? `${base} ${suggestion}` : base;
+	return getNodeBuiltinMessage(specifier);
 }
 
 //#endregion
@@ -1236,10 +1204,7 @@ function replaceStart(definition) {
 /**
 * Acquire a disposable mock for workflow operations (`tailor.workflow`).
 * Restored on dispose.
-*
-* The canonical `execJobFunction` and its `startJobFunction` alias share the
-* same underlying `vi.fn`, so calls through either name are recorded once and
-* handlers configured on either name apply to both.
+
 * @returns Disposable workflow mock control object
 * @example
 * ```typescript
@@ -1282,7 +1247,6 @@ function mockWorkflow() {
 	const resumeShim = (executionId) => resumeWorkflowExecution(executionId);
 	root.workflow = {
 		execJobFunction: jobFunctionShim,
-		startJobFunction: jobFunctionShim,
 		startWorkflow: workflowShim,
 		resumeWorkflowExecution: resumeShim,
 		wait: (key, payload) => wait(key, platformSerialize(payload)),
@@ -1294,11 +1258,6 @@ function mockWorkflow() {
 	return withDispose({
 		/** The `execJobFunction` `vi.fn`. */
 		execJobFunction,
-		/**
-		* Alias of `execJobFunction` (same `vi.fn` reference).
-		* @deprecated Use `execJobFunction` instead.
-		*/
-		startJobFunction: execJobFunction,
 		/** The `startWorkflow` `vi.fn`. */
 		startWorkflow,
 		/** The `resumeWorkflowExecution` `vi.fn`. */
@@ -1511,7 +1470,7 @@ async function runWorkflowLocally(workflow, args, options) {
 	if (options?.env !== void 0) writeWorkflowTestEnv({ ...options.env });
 	root.tailor = {
 		...previousTailor,
-		workflow: createLocalWorkflowRuntime(previousTailor?.workflow, runner.startJobFunction)
+		workflow: createLocalWorkflowRuntime(previousTailor?.workflow, runner.execJobFunction)
 	};
 	try {
 		return await runner.runJob(workflow.mainJob.name, args);
@@ -1524,7 +1483,7 @@ async function runWorkflowLocally(workflow, args, options) {
 }
 function createLocalJobRunner() {
 	let activeExecution;
-	const startJobFunction = (jobName, args) => {
+	const execJobFunction = (jobName, args) => {
 		if (!activeExecution) throw new Error(`Cannot start workflow job "${jobName}" outside runWorkflowLocally() job execution.`);
 		if (activeExecution.pending) throw activeExecution.pending;
 		const serializedArgs = platformSerialize(args);
@@ -1573,7 +1532,7 @@ function createLocalJobRunner() {
 	};
 	return {
 		runJob,
-		startJobFunction
+		execJobFunction
 	};
 }
 async function settlePendingStart(records, pending, runJob) {
@@ -1609,7 +1568,6 @@ function createLocalWorkflowRuntime(previous, execJobFunction) {
 	};
 	return {
 		execJobFunction,
-		startJobFunction: execJobFunction,
 		startWorkflow,
 		resumeWorkflowExecution,
 		wait: (key, payload) => {
@@ -1827,8 +1785,8 @@ function createKyselyMock() {
 *
 * - **`process`** and **`require`** are NOT removed or blocked. Vitest's internal
 *   runner depends on them. On the real Tailor Platform runtime, they do not exist.
-* - **Dynamic `import()`** of bundled files (via `createImportMain()`) bypasses
-*   the transform hook since those files are loaded through Node.js native loader.
+* - **Dynamic `import()`** of bundled files bypasses the transform hook since
+*   those files are loaded through Node.js native loader.
 * ## Options
 *
 * - **`config`** — Path to `tailor.config.ts`. Loads `defineSecretManager()` values