@tailor-platform/sdk 1.37.0 → 1.39.0

package/dist/service-Bcp6JB3w.mjs

@@ -0,0 +1,132 @@
+
+import { n as logger, r as styles } from "./logger-5_JMzHmw.mjs";
+import { t as createCLIError } from "./errors-D9f2UJpT.mjs";
+import * as path from "pathe";
+import { readPackageJSON } from "pkg-types";
+import { spawnSync } from "node:child_process";
+
+//#region src/cli/commands/upgrade/version-detector.ts
+const SDK_PACKAGE_NAME = "@tailor-platform/sdk";
+/**
+* Detect the installed SDK version from the user's project.
+* Walks up from projectRoot to find the SDK package in node_modules,
+* matching Node's module resolution for workspace setups with hoisted deps.
+* @param projectRoot - The project root directory to search from
+* @returns The installed SDK version string, or null if not found
+*/
+async function detectInstalledVersion(projectRoot) {
+	let dir = path.resolve(projectRoot);
+	while (true) {
+		try {
+			const pkg = await readPackageJSON(path.join(dir, "node_modules", SDK_PACKAGE_NAME));
+			if (pkg.version) return pkg.version;
+		} catch {}
+		const parent = path.dirname(dir);
+		if (parent === dir) break;
+		dir = parent;
+	}
+	return null;
+}
+
+//#endregion
+//#region src/cli/commands/upgrade/service.ts
+/**
+* Print the upgrade summary to the terminal.
+* @param output - The parsed JSON output from sdk-codemod
+* @param dryRun - Whether this was a dry-run
+*/
+function printUpgradeSummary(output, dryRun) {
+	if (dryRun) {
+		logger.info(`${styles.bold("[Dry Run]")} No files were modified.`);
+		logger.log("");
+	}
+	const total = output.codemodsApplied + output.codemodsSkipped + output.errors.length;
+	logger.info(`Upgrade complete: ${styles.success(`${output.codemodsApplied} applied`)}, ${styles.dim(`${output.codemodsSkipped} skipped`)} (${total} total codemods)`);
+	if (output.filesModified.length > 0) {
+		logger.log("");
+		logger.info(`${dryRun ? "Files that would be modified" : "Modified files"} (${output.filesModified.length}):`);
+		for (const file of output.filesModified) logger.log(`  ${styles.path(file)}`);
+	}
+	if (output.warnings.length > 0) {
+		logger.log("");
+		logger.warn(`Manual attention needed (${output.warnings.length}):`);
+		for (const warning of output.warnings) logger.log(`  ${styles.warning("!")} ${warning}`);
+	}
+	if (output.errors.length > 0) {
+		logger.log("");
+		logger.error(`Failed codemods (${output.errors.length}):`);
+		for (const { codemodId, message } of output.errors) logger.log(`  ${styles.error(codemodId)}: ${message}`);
+	}
+}
+/**
+* Run the upgrade pipeline:
+* 1. Detect target SDK version from node_modules
+* 2. Invoke @tailor-platform/sdk-codemod CLI
+* 3. Parse JSON output and display results
+* @param options - Upgrade options
+*/
+async function upgrade(options) {
+	const projectRoot = options.path;
+	const targetVersion = await detectInstalledVersion(projectRoot);
+	if (!targetVersion) throw createCLIError({
+		message: `Could not detect installed @tailor-platform/sdk version in ${projectRoot}`,
+		suggestion: "Ensure @tailor-platform/sdk is installed. Run 'pnpm install' or 'npm install' first.",
+		command: "upgrade"
+	});
+	logger.info(`Upgrading from ${styles.highlight(options.from)} → ${styles.highlight(targetVersion)}`);
+	if (options.dryRun) logger.info(`${styles.bold("[Dry Run]")} Changes will be previewed but not applied.`);
+	logger.log("");
+	const result = spawnSync(process.platform === "win32" ? "npx.cmd" : "npx", [
+		"@tailor-platform/sdk-codemod@latest",
+		"--from",
+		options.from,
+		"--to",
+		targetVersion,
+		"--target",
+		projectRoot,
+		...options.dryRun ? ["--dry-run"] : []
+	], {
+		cwd: projectRoot,
+		stdio: [
+			"ignore",
+			"pipe",
+			"pipe"
+		],
+		encoding: "utf-8",
+		timeout: 3e5
+	});
+	if (result.error) throw createCLIError({
+		message: `Failed to run @tailor-platform/sdk-codemod: ${result.error.message}`,
+		suggestion: "Ensure npx is available and the network is accessible.",
+		command: "upgrade"
+	});
+	if (result.status !== 0 && !result.stdout?.trim()) throw createCLIError({
+		message: `@tailor-platform/sdk-codemod exited with code ${result.status}`,
+		details: result.stderr?.trim() || "(no stderr output)",
+		suggestion: "Review the error above. Common causes: invalid version arguments, network issues, or missing package registry access.",
+		command: "upgrade"
+	});
+	if (result.stderr) process.stderr.write(result.stderr);
+	let output;
+	try {
+		output = JSON.parse(result.stdout);
+	} catch {
+		throw createCLIError({
+			message: "Failed to parse output from @tailor-platform/sdk-codemod",
+			details: result.stdout || "(empty stdout)",
+			suggestion: "This is likely a bug. Please report it.",
+			command: "upgrade"
+		});
+	}
+	logger.out(output);
+	printUpgradeSummary(output, options.dryRun);
+	if (output.errors.length > 0) throw createCLIError({
+		message: `Upgrade completed with ${output.errors.length} error(s)`,
+		suggestion: "Review the errors above and re-run the upgrade after fixing the issues.",
+		command: "upgrade"
+	});
+}
+
+//#endregion
+export { upgrade };
+//# sourceMappingURL=service-Bcp6JB3w.mjs.map

package/dist/service-Bcp6JB3w.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"service-Bcp6JB3w.mjs","names":["CLIError"],"sources":["../src/cli/commands/upgrade/version-detector.ts","../src/cli/commands/upgrade/service.ts"],"sourcesContent":["import * as path from \"pathe\";\nimport { readPackageJSON } from \"pkg-types\";\n\nconst SDK_PACKAGE_NAME = \"@tailor-platform/sdk\";\n\n/**\n * Detect the installed SDK version from the user's project.\n * Walks up from projectRoot to find the SDK package in node_modules,\n * matching Node's module resolution for workspace setups with hoisted deps.\n * @param projectRoot - The project root directory to search from\n * @returns The installed SDK version string, or null if not found\n */\nexport async function detectInstalledVersion(projectRoot: string): Promise<string | null> {\n  let dir = path.resolve(projectRoot);\n  while (true) {\n    try {\n      const sdkPath = path.join(dir, \"node_modules\", SDK_PACKAGE_NAME);\n      const pkg = await readPackageJSON(sdkPath);\n      if (pkg.version) return pkg.version;\n    } catch {\n      // Not found at this level, try parent\n    }\n    const parent = path.dirname(dir);\n    if (parent === dir) break;\n    dir = parent;\n  }\n  return null;\n}\n","import { spawnSync } from \"node:child_process\";\nimport { CLIError } from \"@/cli/shared/errors\";\nimport { logger, styles } from \"@/cli/shared/logger\";\nimport { detectInstalledVersion } from \"./version-detector\";\nimport type { RunOutput } from \"./types\";\n\ninterface UpgradeOptions {\n  from: string;\n  dryRun: boolean;\n  path: string;\n}\n\n/**\n * Print the upgrade summary to the terminal.\n * @param output - The parsed JSON output from sdk-codemod\n * @param dryRun - Whether this was a dry-run\n */\nfunction printUpgradeSummary(output: RunOutput, dryRun: boolean): void {\n  if (dryRun) {\n    logger.info(`${styles.bold(\"[Dry Run]\")} No files were modified.`);\n    logger.log(\"\");\n  }\n\n  const total = output.codemodsApplied + output.codemodsSkipped + output.errors.length;\n  logger.info(\n    `Upgrade complete: ${styles.success(`${output.codemodsApplied} applied`)}, ${styles.dim(`${output.codemodsSkipped} skipped`)} (${total} total codemods)`,\n  );\n\n  if (output.filesModified.length > 0) {\n    logger.log(\"\");\n    logger.info(\n      `${dryRun ? \"Files that would be modified\" : \"Modified files\"} (${output.filesModified.length}):`,\n    );\n    for (const file of output.filesModified) {\n      logger.log(`  ${styles.path(file)}`);\n    }\n  }\n\n  if (output.warnings.length > 0) {\n    logger.log(\"\");\n    logger.warn(`Manual attention needed (${output.warnings.length}):`);\n    for (const warning of output.warnings) {\n      logger.log(`  ${styles.warning(\"!\")} ${warning}`);\n    }\n  }\n\n  if (output.errors.length > 0) {\n    logger.log(\"\");\n    logger.error(`Failed codemods (${output.errors.length}):`);\n    for (const { codemodId, message } of output.errors) {\n      logger.log(`  ${styles.error(codemodId)}: ${message}`);\n    }\n  }\n}\n\n/**\n * Run the upgrade pipeline:\n * 1. Detect target SDK version from node_modules\n * 2. Invoke @tailor-platform/sdk-codemod CLI\n * 3. Parse JSON output and display results\n * @param options - Upgrade options\n */\nexport async function upgrade(options: UpgradeOptions): Promise<void> {\n  const projectRoot = options.path;\n\n  // Step 1: Detect target SDK version (the newly installed version)\n  const targetVersion = await detectInstalledVersion(projectRoot);\n  if (!targetVersion) {\n    throw CLIError({\n      message: `Could not detect installed @tailor-platform/sdk version in ${projectRoot}`,\n      suggestion:\n        \"Ensure @tailor-platform/sdk is installed. Run 'pnpm install' or 'npm install' first.\",\n      command: \"upgrade\",\n    });\n  }\n\n  logger.info(\n    `Upgrading from ${styles.highlight(options.from)} → ${styles.highlight(targetVersion)}`,\n  );\n\n  if (options.dryRun) {\n    logger.info(`${styles.bold(\"[Dry Run]\")} Changes will be previewed but not applied.`);\n  }\n\n  logger.log(\"\");\n\n  // Step 2: Invoke sdk-codemod CLI\n  // Use \"latest\" because sdk-codemod may not be published at the exact same\n  // version as @tailor-platform/sdk.  Version filtering is handled internally\n  // by sdk-codemod's registry via the --from / --to arguments.\n  const npxCommand = process.platform === \"win32\" ? \"npx.cmd\" : \"npx\";\n\n  const result = spawnSync(\n    npxCommand,\n    [\n      \"@tailor-platform/sdk-codemod@latest\",\n      \"--from\",\n      options.from,\n      \"--to\",\n      targetVersion,\n      \"--target\",\n      projectRoot,\n      ...(options.dryRun ? [\"--dry-run\"] : []),\n    ],\n    {\n      cwd: projectRoot,\n      stdio: [\"ignore\", \"pipe\", \"pipe\"],\n      encoding: \"utf-8\",\n      timeout: 300_000,\n    },\n  );\n\n  if (result.error) {\n    throw CLIError({\n      message: `Failed to run @tailor-platform/sdk-codemod: ${result.error.message}`,\n      suggestion: \"Ensure npx is available and the network is accessible.\",\n      command: \"upgrade\",\n    });\n  }\n\n  // Check for non-zero exit without a launch error (e.g. registry/auth/network failures)\n  if (result.status !== 0 && !result.stdout?.trim()) {\n    throw CLIError({\n      message: `@tailor-platform/sdk-codemod exited with code ${result.status}`,\n      details: result.stderr?.trim() || \"(no stderr output)\",\n      suggestion:\n        \"Review the error above. Common causes: invalid version arguments, network issues, or missing package registry access.\",\n      command: \"upgrade\",\n    });\n  }\n\n  // Forward captured stderr so users see dry-run diffs and progress messages\n  // written by sdk-codemod. stderr is piped (not inherited) so that the error\n  // path above can surface it via CLIError, but on success we still need to\n  // replay it verbatim to keep the colorized unified diff output visible.\n  if (result.stderr) {\n    process.stderr.write(result.stderr);\n  }\n\n  // Step 3: Parse JSON output\n  let output: RunOutput;\n  try {\n    output = JSON.parse(result.stdout);\n  } catch {\n    throw CLIError({\n      message: \"Failed to parse output from @tailor-platform/sdk-codemod\",\n      details: result.stdout || \"(empty stdout)\",\n      suggestion: \"This is likely a bug. Please report it.\",\n      command: \"upgrade\",\n    });\n  }\n\n  // Step 4: Display results\n  // Emit structured data on stdout (honors --json via logger.out) and\n  // human-readable summary on stderr (via printUpgradeSummary).\n  logger.out(output);\n  printUpgradeSummary(output, options.dryRun);\n\n  if (output.errors.length > 0) {\n    throw CLIError({\n      message: `Upgrade completed with ${output.errors.length} error(s)`,\n      suggestion: \"Review the errors above and re-run the upgrade after fixing the issues.\",\n      command: \"upgrade\",\n    });\n  }\n}\n"],"mappings":"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"}

package/dist/utils/test/index.d.mts

@@ -1,6 +1,6 @@
 /// <reference types="@tailor-platform/function-types" />
-import { U as TailorDBType, rt as TailorField } from "../../plugin-D6P4g_2L.mjs";
-import { n as output, rt as WORKFLOW_TEST_ENV_KEY } from "../../index-BVJQLjyN.mjs";
+import { U as TailorDBType, rt as TailorField } from "../../plugin-_K3ZfP8B.mjs";
+import { n as output, ot as WORKFLOW_TEST_ENV_KEY } from "../../index-31hm0Fq7.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/utils/test/mock.d.ts

package/dist/utils/test/index.mjs

@@ -113,8 +113,12 @@ function createTailorDBHook(type) {
 		return Object.entries(type.fields).reduce((hooked, [key, value]) => {
 			const field = value;
 			if (key === "id") hooked[key] = (data && typeof data === "object" ? data[key] : void 0) ?? crypto.randomUUID();
-			else if (field.type === "nested") hooked[key] = createTailorDBHook({ fields: field.fields })(data[key]);
-			else if (field.metadata.hooks?.create) {
+			else if (field.type === "nested") {
+				const nestedValue = data && typeof data === "object" ? data[key] : void 0;
+				const nestedHook = createTailorDBHook({ fields: field.fields });
+				if (field.metadata.array) hooked[key] = Array.isArray(nestedValue) ? nestedValue.map((item) => nestedHook(item)) : nestedValue;
+				else hooked[key] = nestedHook(nestedValue);
+			} else if (field.metadata.hooks?.create) {
 				hooked[key] = field.metadata.hooks.create({
 					value: data[key],
 					data,

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\";\n\ntype MainFunction = (args: Record<string, unknown>) => unknown | Promise<unknown>;\ntype QueryResolver = (query: string, params: unknown[]) => unknown[];\ntype JobHandler = (jobName: string, args: unknown) => unknown;\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      triggerJobFunction: (jobName: string, args: unknown) => unknown;\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 TailordbGlobal & TailorErrorsGlobal;\n\n/**\n * Sets up a mock for `globalThis.tailordb.Client` used in bundled resolver/executor tests.\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.triggerJobFunction` used in bundled workflow tests.\n * @param handler - Function that handles triggered job calls and returns results.\n * @returns Object containing an array of triggered jobs for assertions.\n */\nexport function setupWorkflowMock(handler: JobHandler): {\n  triggeredJobs: { jobName: string; args: unknown }[];\n} {\n  const triggeredJobs: { jobName: string; args: unknown }[] = [];\n\n  GlobalThis.tailor = {\n    ...GlobalThis.tailor,\n    workflow: {\n      triggerJobFunction: (jobName: string, args: unknown) => {\n        triggeredJobs.push({ jobName, args });\n        return handler(jobName, args);\n      },\n    },\n  } as typeof GlobalThis.tailor;\n\n  return { triggeredJobs };\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 */\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 * 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 */\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, TailorUser } from \"@/configure\";\nimport type { TailorDBType } from \"@/configure/services/tailordb/schema\";\nimport type { TailorField } from \"@/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport { WORKFLOW_TEST_ENV_KEY } from \"@/configure/services/workflow/job\";\nexport {\n  setupTailordbMock,\n  setupTailorErrorsMock,\n  setupWorkflowMock,\n  createImportMain,\n} from \"./mock\";\n\n/** Represents an unauthenticated user in the Tailor platform. */\nexport const unauthenticatedTailorUser = {\n  id: \"00000000-0000-0000-0000-000000000000\",\n  type: \"\",\n  workspaceId: \"00000000-0000-0000-0000-000000000000\",\n  attributes: null,\n  attributeList: [],\n} as const satisfies TailorUser;\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) => {\n    return 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          // Use existing id from data if provided, otherwise generate new UUID\n          const existingId =\n            data && typeof data === \"object\" ? (data as Record<string, unknown>)[key] : undefined;\n          hooked[key] = existingId ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          // eslint-disable-next-line @typescript-eslint/no-explicit-any\n          hooked[key] = createTailorDBHook({ fields: field.fields } as any)(\n            (data as Record<string, unknown>)[key],\n          );\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            value: (data as Record<string, unknown>)[key],\n            data: data,\n            user: unauthenticatedTailorUser,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (data && typeof data === \"object\") {\n          hooked[key] = (data as Record<string, unknown>)[key];\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    ) 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          user: unauthenticatedTailorUser,\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":";;;;;;AAkCA,MAAM,aAAa;;;;;;AAOnB,SAAgB,kBAAkB,iBAAgC,EAAE,EAGlE;CACA,MAAM,kBAA0D,EAAE;CAClE,MAAM,iBAA2D,EAAE;CAEnE,MAAM,mBAAmB;EACvB,AAAQ;EAER,YAAY,EAAE,aAAqC;AACjD,QAAK,SAAS;IAAE;IAAW,OAAO;IAAO;AACzC,kBAAe,KAAK,KAAK,OAAO;;EAGlC,MAAM,UAAyB;EAI/B,MAAM,MAAqB;AACzB,QAAK,OAAO,QAAQ;;EAGtB,MAAM,YAAY,OAAe,SAAoB,EAAE,EAAgC;AACrF,mBAAgB,KAAK;IAAE;IAAO;IAAQ,CAAC;AACvC,UAAO,EAAE,MAAM,SAAS,OAAO,OAAO,IAAI,EAAE,EAAE;;;AAIlD,YAAW,WAAW,EACpB,QAAQ,oBACT;AAED,QAAO;EAAE;EAAiB;EAAgB;;;;;;;AAQ5C,SAAgB,kBAAkB,SAEhC;CACA,MAAM,gBAAsD,EAAE;AAE9D,YAAW,SAAS;EAClB,GAAG,WAAW;EACd,UAAU,EACR,qBAAqB,SAAiB,SAAkB;AACtD,iBAAc,KAAK;IAAE;IAAS;IAAM,CAAC;AACrC,UAAO,QAAQ,SAAS,KAAK;KAEhC;EACF;AAED,QAAO,EAAE,eAAe;;;;;;AAO1B,SAAgB,wBAA8B;AAC5C,YAAW,eAAe,MAAM,qBAAqB,MAAM;EACzD;EAEA,YAAY,QAA2B;AACrC,SAAM,iBAAiB,KAAK,UAAU,EAAE,QAAQ,CAAC,GAAG;AACpD,QAAK,OAAO;AACZ,QAAK,SAAS;;;;;;;;;;AAWpB,SAAgB,iBAAiB,SAAkE;AACjG,QAAO,OAAO,iBAAgD;EAC5D,MAAM,UAAU,cAAc,KAAK,KAAK,SAAS,aAAa,CAAC;AAC/D,UAAQ,aAAa,IAAI,KAAK,GAAG,KAAK,KAAK,CAAC,GAAG,KAAK,QAAQ,GAAG;EAE/D,MAAM,QADS,MAAM,OAAO,QAAQ,OAChB;AACpB,MAAI,OAAO,SAAS,WAClB,OAAM,IAAI,MAAM,uCAAuC,aAAa,QAAQ,OAAO,OAAO;AAE5F,SAAO;;;;;;;ACrHX,MAAa,4BAA4B;CACvC,IAAI;CACJ,MAAM;CACN,aAAa;CACb,YAAY;CACZ,eAAe,EAAE;CAClB;;;;;;;;;;AAYD,SAAgB,mBAAqD,MAAS;AAC5E,SAAQ,SAAkB;AACxB,SAAO,OAAO,QAAQ,KAAK,OAAO,CAAC,QAChC,QAAQ,CAAC,KAAK,WAAW;GAExB,MAAM,QAAQ;AACd,OAAI,QAAQ,KAIV,QAAO,QADL,QAAQ,OAAO,SAAS,WAAY,KAAiC,OAAO,WAClD,OAAO,YAAY;YACtC,MAAM,SAAS,SAExB,QAAO,OAAO,mBAAmB,EAAE,QAAQ,MAAM,QAAQ,CAAQ,CAC9D,KAAiC,KACnC;YACQ,MAAM,SAAS,OAAO,QAAQ;AACvC,WAAO,OAAO,MAAM,SAAS,MAAM,OAAO;KACxC,OAAQ,KAAiC;KACnC;KACN,MAAM;KACP,CAAC;AACF,QAAI,OAAO,gBAAgB,KACzB,QAAO,OAAO,OAAO,KAAK,aAAa;cAEhC,QAAQ,OAAO,SAAS,SACjC,QAAO,OAAQ,KAAiC;AAElD,UAAO;KAET,EAAE,CACH;;;;;;;;;;;AAYL,SAAgB,qBAEd,YACA,MACA;AACA,QAAO,EACL,aAAa;EACX,SAAS;EACT,QAAQ;EACR,WAAW,UAAmB;GAC5B,MAAM,SAAS,KAAK,MAAM;GAC1B,MAAM,SAAS,WAAW,MAAM;IAC9B,OAAO;IACP,MAAM;IACN,MAAM;IACP,CAAC;AACF,OAAI,OAAO,OACT,QAAO;AAET,UAAO,EAAE,OAAO,QAAa;;EAEhC,EACF"}
+{"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\";\n\ntype MainFunction = (args: Record<string, unknown>) => unknown | Promise<unknown>;\ntype QueryResolver = (query: string, params: unknown[]) => unknown[];\ntype JobHandler = (jobName: string, args: unknown) => unknown;\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      triggerJobFunction: (jobName: string, args: unknown) => unknown;\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 TailordbGlobal & TailorErrorsGlobal;\n\n/**\n * Sets up a mock for `globalThis.tailordb.Client` used in bundled resolver/executor tests.\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.triggerJobFunction` used in bundled workflow tests.\n * @param handler - Function that handles triggered job calls and returns results.\n * @returns Object containing an array of triggered jobs for assertions.\n */\nexport function setupWorkflowMock(handler: JobHandler): {\n  triggeredJobs: { jobName: string; args: unknown }[];\n} {\n  const triggeredJobs: { jobName: string; args: unknown }[] = [];\n\n  GlobalThis.tailor = {\n    ...GlobalThis.tailor,\n    workflow: {\n      triggerJobFunction: (jobName: string, args: unknown) => {\n        triggeredJobs.push({ jobName, args });\n        return handler(jobName, args);\n      },\n    },\n  } as typeof GlobalThis.tailor;\n\n  return { triggeredJobs };\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 */\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 * 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 */\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, TailorUser } from \"@/configure\";\nimport type { TailorDBType } from \"@/configure/services/tailordb/schema\";\nimport type { TailorField } from \"@/configure/types/type\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nexport { WORKFLOW_TEST_ENV_KEY } from \"@/configure/services/workflow/job\";\nexport {\n  setupTailordbMock,\n  setupTailorErrorsMock,\n  setupWorkflowMock,\n  createImportMain,\n} from \"./mock\";\n\n/** Represents an unauthenticated user in the Tailor platform. */\nexport const unauthenticatedTailorUser = {\n  id: \"00000000-0000-0000-0000-000000000000\",\n  type: \"\",\n  workspaceId: \"00000000-0000-0000-0000-000000000000\",\n  attributes: null,\n  attributeList: [],\n} as const satisfies TailorUser;\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) => {\n    return 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          // Use existing id from data if provided, otherwise generate new UUID\n          const existingId =\n            data && typeof data === \"object\" ? (data as Record<string, unknown>)[key] : undefined;\n          hooked[key] = existingId ?? crypto.randomUUID();\n        } else if (field.type === \"nested\") {\n          const nestedValue =\n            data && typeof data === \"object\" ? (data as Record<string, unknown>)[key] : undefined;\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            // For nested array fields, recurse per element and pass through non-array values\n            // (e.g. null/undefined for optional fields) so validation sees the original value.\n            hooked[key] = Array.isArray(nestedValue)\n              ? nestedValue.map((item) => nestedHook(item))\n              : nestedValue;\n          } else {\n            hooked[key] = nestedHook(nestedValue);\n          }\n        } else if (field.metadata.hooks?.create) {\n          hooked[key] = field.metadata.hooks.create({\n            value: (data as Record<string, unknown>)[key],\n            data: data,\n            user: unauthenticatedTailorUser,\n          });\n          if (hooked[key] instanceof Date) {\n            hooked[key] = hooked[key].toISOString();\n          }\n        } else if (data && typeof data === \"object\") {\n          hooked[key] = (data as Record<string, unknown>)[key];\n        }\n        return hooked;\n      },\n      {} as Record<string, unknown>,\n    ) 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          user: unauthenticatedTailorUser,\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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"}

package/dist/{workflow.generated-Bj_DVqGh.d.mts → workflow.generated-BxbnuzAE.d.mts}

@@ -1,5 +1,5 @@
 /// <reference types="@tailor-platform/function-types" />
-import { Nt as BuiltinIdP, S as TailorDBServiceInput, T as AuthConfig } from "./plugin-D6P4g_2L.mjs";
+import { Pt as BuiltinIdP, S as TailorDBServiceInput, T as AuthConfig } from "./plugin-_K3ZfP8B.mjs";
 
 //#region src/types/idp.generated.d.ts
 /**
@@ -411,4 +411,4 @@ type RetryPolicy = {
 };
 //#endregion
 export { IdpDefinitionBrand as _, ResolverExternalConfig as a, IdPGqlOperationsInput as b, WorkflowServiceConfig as c, defineStaticWebSite as d, SecretsConfig as f, IdPUserField as g, IdPExternalConfig as h, ExecutorServiceInput as i, WorkflowServiceInput as l, IdPConfig as m, AppConfig as n, ResolverServiceConfig as o, defineSecretManager as p, ExecutorServiceConfig as r, ResolverServiceInput as s, RetryPolicy as t, StaticWebsiteConfig as u, IdPEmailConfig as v, IdPInput as x, IdPGqlOperations as y };
-//# sourceMappingURL=workflow.generated-Bj_DVqGh.d.mts.map
+//# sourceMappingURL=workflow.generated-BxbnuzAE.d.mts.map

package/docs/cli/function.md

@@ -89,20 +89,46 @@ See [Global Options](../cli-reference.md#global-options) for options available t
 
 <!-- politty:command:function logs:global-options-link:end -->
 
-**Usage Examples:**
+<!-- politty:command:function logs:examples:start -->
+
+**Examples**
+
+**List all function execution logs**
+
+```bash
+$ tailor-sdk function logs
+```
+
+**Get execution details with logs**
+
+```bash
+$ tailor-sdk function logs <execution-id>
+```
+
+**Output as JSON**
 
 ```bash
-# List all function execution logs
-tailor-sdk function logs
+$ tailor-sdk function logs --json
+```
 
-# Get execution details with logs
-tailor-sdk function logs <execution-id>
+**Get execution details as JSON**
 
-# Output as JSON
-tailor-sdk function logs --json
-tailor-sdk function logs <execution-id> --json
+```bash
+$ tailor-sdk function logs <execution-id> --json
 ```
 
+<!-- politty:command:function logs:examples:end -->
+
+<!-- politty:command:function logs:notes:start -->
+
+**Notes**
+
+When viewing a specific execution that failed, the command displays error details with the stack trace mapped back to original source files via the inline sourcemap (clickable file links and code snippets, matching `function test-run` output).
+
+When the deployed script cannot be downloaded or the function has been redeployed since the execution, the command falls back to a plain-text error display to avoid showing misleading source locations.
+
+<!-- politty:command:function logs:notes:end -->
+
 <!-- politty:command:function test-run:heading:start -->
 
 ### function test-run
@@ -135,14 +161,14 @@ tailor-sdk function test-run [options] <file>
 
 **Options**
 
-| Option                          | Alias | Description                                                              | Required | Default              | Env                            |
-| ------------------------------- | ----- | ------------------------------------------------------------------------ | -------- | -------------------- | ------------------------------ |
-| `--workspace-id <WORKSPACE_ID>` | `-w`  | Workspace ID                                                             | No       | -                    | `TAILOR_PLATFORM_WORKSPACE_ID` |
-| `--profile <PROFILE>`           | `-p`  | Workspace profile                                                        | No       | -                    | `TAILOR_PLATFORM_PROFILE`      |
-| `--name <NAME>`                 | `-n`  | Workflow job name to run (matches the `name` field of createWorkflowJob) | No       | -                    | -                              |
-| `--arg <ARG>`                   | `-a`  | JSON argument to pass to the function                                    | No       | -                    | -                              |
-| `--machine-user <MACHINE_USER>` | `-m`  | Machine user name for authentication                                     | No       | -                    | -                              |
-| `--config <CONFIG>`             | `-c`  | Path to SDK config file                                                  | No       | `"tailor.config.ts"` | -                              |
+| Option                          | Alias | Description                                                              | Required | Default              | Env                                 |
+| ------------------------------- | ----- | ------------------------------------------------------------------------ | -------- | -------------------- | ----------------------------------- |
+| `--workspace-id <WORKSPACE_ID>` | `-w`  | Workspace ID                                                             | No       | -                    | `TAILOR_PLATFORM_WORKSPACE_ID`      |
+| `--profile <PROFILE>`           | `-p`  | Workspace profile                                                        | No       | -                    | `TAILOR_PLATFORM_PROFILE`           |
+| `--name <NAME>`                 | `-n`  | Workflow job name to run (matches the `name` field of createWorkflowJob) | No       | -                    | -                                   |
+| `--arg <ARG>`                   | `-a`  | JSON argument to pass to the function                                    | No       | -                    | -                                   |
+| `--machine-user <MACHINE_USER>` | `-m`  | Machine user name for authentication                                     | No       | -                    | `TAILOR_PLATFORM_MACHINE_USER_NAME` |
+| `--config <CONFIG>`             | `-c`  | Path to SDK config file                                                  | No       | `"tailor.config.ts"` | -                                   |
 
 <!-- politty:command:function test-run:options:end -->
 <!-- politty:command:function test-run:examples:start -->

package/docs/cli/upgrade.md

@@ -0,0 +1,51 @@
+<!-- politty:command:upgrade:heading:start -->
+
+## upgrade
+
+<!-- politty:command:upgrade:heading:end -->
+
+<!-- politty:command:upgrade:description:start -->
+
+Run codemods to upgrade your project to a newer SDK version.
+
+<!-- politty:command:upgrade:description:end -->
+
+<!-- politty:command:upgrade:usage:start -->
+
+**Usage**
+
+```
+tailor-sdk upgrade [options]
+```
+
+<!-- politty:command:upgrade:usage:end -->
+
+<!-- politty:command:upgrade:options:start -->
+
+**Options**
+
+| Option          | Alias | Description                                   | Required | Default |
+| --------------- | ----- | --------------------------------------------- | -------- | ------- |
+| `--from <FROM>` | -     | SDK version before the upgrade (e.g., 1.33.0) | Yes      | -       |
+| `--dry-run`     | `-d`  | Preview changes without modifying files       | No       | `false` |
+| `--path <PATH>` | -     | Project directory to upgrade                  | No       | `"."`   |
+
+<!-- politty:command:upgrade:options:end -->
+
+<!-- politty:command:upgrade:global-options-link:start -->
+
+See [Global Options](../cli-reference.md#global-options) for options available to all commands.
+
+<!-- politty:command:upgrade:global-options-link:end -->
+
+### How It Works
+
+The `upgrade` command runs codemods that automatically transform your project code for breaking changes between SDK versions. The target version (`--to`) is auto-detected from the installed `@tailor-platform/sdk` in `node_modules`.
+
+**Typical workflow:**
+
+1. Update your SDK packages to the new version (e.g., `pnpm update @tailor-platform/sdk`)
+2. Run `tailor-sdk upgrade --from <old-version>` to apply codemods
+3. Review changes and commit
+
+Use `--dry-run` to preview what changes will be made before applying them.

package/docs/cli/user.md

@@ -38,7 +38,7 @@ _no options_
 
 | Option                            | Alias | Description                       | Required | Default | Env                                          |
 | --------------------------------- | ----- | --------------------------------- | -------- | ------- | -------------------------------------------- |
-| `--machineuser <MACHINEUSER>`     | -     | Login as a platform machine user. | Yes      | -       | -                                            |
+| `--machine-user <MACHINE_USER>`   | -     | Login as a platform machine user. | Yes      | -       | -                                            |
 | `--client-id <CLIENT_ID>`         | -     | Client ID                         | Yes      | -       | `TAILOR_PLATFORM_MACHINE_USER_CLIENT_ID`     |
 | `--client-secret <CLIENT_SECRET>` | -     | Client secret                     | No       | -       | `TAILOR_PLATFORM_MACHINE_USER_CLIENT_SECRET` |
 

package/docs/cli/workflow.md

@@ -165,16 +165,16 @@ tailor-sdk workflow start [options] <name>
 
 **Options**
 
-| Option                          | Alias | Description                                                    | Required | Default              | Env                               |
-| ------------------------------- | ----- | -------------------------------------------------------------- | -------- | -------------------- | --------------------------------- |
-| `--workspace-id <WORKSPACE_ID>` | `-w`  | Workspace ID                                                   | No       | -                    | `TAILOR_PLATFORM_WORKSPACE_ID`    |
-| `--profile <PROFILE>`           | `-p`  | Workspace profile                                              | No       | -                    | `TAILOR_PLATFORM_PROFILE`         |
-| `--config <CONFIG>`             | `-c`  | Path to SDK config file                                        | No       | `"tailor.config.ts"` | `TAILOR_PLATFORM_SDK_CONFIG_PATH` |
-| `--machineuser <MACHINEUSER>`   | `-m`  | Machine user name                                              | Yes      | -                    | -                                 |
-| `--arg <ARG>`                   | `-a`  | Workflow argument (JSON string)                                | No       | -                    | -                                 |
-| `--wait`                        | `-W`  | Wait for execution to complete                                 | No       | `false`              | -                                 |
-| `--interval <INTERVAL>`         | `-i`  | Polling interval when using --wait (e.g., '3s', '500ms', '1m') | No       | `"3s"`               | -                                 |
-| `--logs`                        | `-l`  | Display job execution logs after completion (requires --wait)  | No       | `false`              | -                                 |
+| Option                          | Alias | Description                                                    | Required | Default              | Env                                 |
+| ------------------------------- | ----- | -------------------------------------------------------------- | -------- | -------------------- | ----------------------------------- |
+| `--workspace-id <WORKSPACE_ID>` | `-w`  | Workspace ID                                                   | No       | -                    | `TAILOR_PLATFORM_WORKSPACE_ID`      |
+| `--profile <PROFILE>`           | `-p`  | Workspace profile                                              | No       | -                    | `TAILOR_PLATFORM_PROFILE`           |
+| `--config <CONFIG>`             | `-c`  | Path to SDK config file                                        | No       | `"tailor.config.ts"` | `TAILOR_PLATFORM_SDK_CONFIG_PATH`   |
+| `--machine-user <MACHINE_USER>` | `-m`  | Machine user name                                              | Yes      | -                    | `TAILOR_PLATFORM_MACHINE_USER_NAME` |
+| `--arg <ARG>`                   | `-a`  | Workflow argument (JSON string)                                | No       | -                    | -                                   |
+| `--wait`                        | `-W`  | Wait for execution to complete                                 | No       | `false`              | -                                   |
+| `--interval <INTERVAL>`         | `-i`  | Polling interval when using --wait (e.g., '3s', '500ms', '1m') | No       | `"3s"`               | -                                   |
+| `--logs`                        | `-l`  | Display job execution logs after completion (requires --wait)  | No       | `false`              | -                                   |
 
 <!-- politty:command:workflow start:options:end -->
 

package/docs/cli-reference.md

@@ -53,20 +53,22 @@ tailor-sdk apply --env-file .env --env-file .env.production
 
 You can use environment variables to configure workspace and authentication:
 
-| Variable                                     | Description                                                                 |
-| -------------------------------------------- | --------------------------------------------------------------------------- |
-| `TAILOR_PLATFORM_WORKSPACE_ID`               | Workspace ID for deployment commands                                        |
-| `TAILOR_PLATFORM_ORGANIZATION_ID`            | Organization ID for organization commands                                   |
-| `TAILOR_PLATFORM_FOLDER_ID`                  | Folder ID for folder commands                                               |
-| `TAILOR_PLATFORM_TOKEN`                      | Authentication token (alternative to `login`)                               |
-| `TAILOR_TOKEN`                               | **Deprecated.** Use `TAILOR_PLATFORM_TOKEN` instead                         |
-| `TAILOR_PLATFORM_PROFILE`                    | Workspace profile name                                                      |
-| `TAILOR_PLATFORM_SDK_CONFIG_PATH`            | Path to SDK config file                                                     |
-| `TAILOR_PLATFORM_MACHINE_USER_CLIENT_ID`     | Client ID for `login --machineuser`                                         |
-| `TAILOR_PLATFORM_MACHINE_USER_CLIENT_SECRET` | Client secret for `login --machineuser`                                     |
-| `VISUAL` / `EDITOR`                          | Preferred editor for commands that open files (e.g., `vim`, `code`, `nano`) |
-| `TAILOR_CRASH_REPORTS_LOCAL`                 | Local crash log writing: `on` (default) or `off`                            |
-| `TAILOR_CRASH_REPORTS_REMOTE`                | Automatic crash report submission: `off` (default) or `on`                  |
+| Variable                                     | Description                                                                  |
+| -------------------------------------------- | ---------------------------------------------------------------------------- |
+| `TAILOR_PLATFORM_WORKSPACE_ID`               | Workspace ID for deployment commands                                         |
+| `TAILOR_PLATFORM_ORGANIZATION_ID`            | Organization ID for organization commands                                    |
+| `TAILOR_PLATFORM_FOLDER_ID`                  | Folder ID for folder commands                                                |
+| `TAILOR_PLATFORM_TOKEN`                      | Authentication token (alternative to `login`)                                |
+| `TAILOR_TOKEN`                               | **Deprecated.** Use `TAILOR_PLATFORM_TOKEN` instead                          |
+| `TAILOR_PLATFORM_PROFILE`                    | Workspace profile name                                                       |
+| `TAILOR_PLATFORM_SDK_CONFIG_PATH`            | Path to SDK config file                                                      |
+| `TAILOR_PLATFORM_SDK_DTS_PATH`               | Output path for generated `tailor.d.ts` type definition file                 |
+| `TAILOR_PLATFORM_MACHINE_USER_CLIENT_ID`     | Client ID for `login --machine-user`                                         |
+| `TAILOR_PLATFORM_MACHINE_USER_CLIENT_SECRET` | Client secret for `login --machine-user`                                     |
+| `TAILOR_PLATFORM_MACHINE_USER_NAME`          | Default machine user name for `query`, `workflow start`, `function test-run` |
+| `VISUAL` / `EDITOR`                          | Preferred editor for commands that open files (e.g., `vim`, `code`, `nano`)  |
+| `TAILOR_CRASH_REPORTS_LOCAL`                 | Local crash log writing: `on` (default) or `off`                             |
+| `TAILOR_CRASH_REPORTS_REMOTE`                | Automatic crash report submission: `off` (default) or `on`                   |
 
 ### Authentication Token Priority
 
@@ -259,6 +261,14 @@ Commands for setting up project infrastructure.
 | ------------------------------------------- | ------------------------------------------------------- |
 | [setup github](./cli/setup.md#setup-github) | Generate GitHub Actions workflow for deployment. (beta) |
 
+### [Upgrade Commands](./cli/upgrade.md)
+
+Commands for upgrading SDK versions with automated code migration.
+
+| Command                             | Description                                                  |
+| ----------------------------------- | ------------------------------------------------------------ |
+| [upgrade](./cli/upgrade.md#upgrade) | Run codemods to upgrade your project to a newer SDK version. |
+
 ### [Completion](./cli/completion.md)
 
 Generate shell completion scripts for bash, zsh, and fish.

package/docs/configuration.md

@@ -218,17 +218,19 @@ export default defineConfig({
 
 **ignores**: Glob patterns to exclude files. Optional.
 
-### Generators
+### Plugins
 
-Configure code generators using `defineGenerators()`. Generators must be exported as a named export.
+Configure plugins using `definePlugins()`. Plugins must be exported as a named export.
 
 ```typescript
-import { defineGenerators } from "@tailor-platform/sdk";
+import { definePlugins } from "@tailor-platform/sdk";
+import { kyselyTypePlugin } from "@tailor-platform/sdk/plugin/kysely-type";
+import { enumConstantsPlugin } from "@tailor-platform/sdk/plugin/enum-constants";
 
-export const generators = defineGenerators(
-  ["@tailor-platform/kysely-type", { distPath: "./generated/tailordb.ts" }],
-  ["@tailor-platform/enum-constants", { distPath: "./generated/enums.ts" }],
+export const plugins = definePlugins(
+  kyselyTypePlugin({ distPath: "./generated/tailordb.ts" }),
+  enumConstantsPlugin({ distPath: "./generated/enums.ts" }),
 );
 ```
 
-See [Generators](./generator/index.md) for full documentation.
+See [Generators](./generator/index.md) for legacy `defineGenerators()` documentation.

package/docs/generator/index.md

@@ -50,6 +50,16 @@ tailor-sdk generate --watch
 
 Watches for file changes and regenerates automatically.
 
+## Environment Variables
+
+### `TAILOR_PLATFORM_SDK_DTS_PATH`
+
+Customize the output path of the generated `tailor.d.ts` type definition file. By default, `tailor.d.ts` is written next to `tailor.config.ts`.
+
+```bash
+TAILOR_PLATFORM_SDK_DTS_PATH=src/types/tailor.d.ts tailor-sdk generate
+```
+
 ## Generator Types
 
 - [Builtin Generators](./builtin.md) - Ready-to-use generators included with the SDK

package/docs/services/executor.md

@@ -88,6 +88,25 @@ type WebhookRequest = {
 incomingWebhookTrigger<WebhookRequest>();
 ```
 
+You can customize the HTTP response returned to the webhook caller:
+
+```typescript
+// Response body only (shorthand)
+incomingWebhookTrigger<WebhookRequest>({
+  response: (args) => ({ challenge: args.body.challenge }),
+});
+
+// Response body with custom status code
+incomingWebhookTrigger<WebhookRequest>({
+  response: {
+    body: (args) => ({ challenge: args.body.challenge }),
+    statusCode: 201,
+  },
+});
+```
+
+If `body` is set without `statusCode`, the platform uses 200. If neither is set, the platform returns 204.
+
 ### Resolver Executed Trigger
 
 Fires when a resolver is executed:
@@ -433,6 +452,26 @@ export default createExecutor({
 });
 ```
 
+**With custom response:**
+
+```typescript
+export default createExecutor({
+  name: "slack-challenge",
+  trigger: incomingWebhookTrigger<{
+    body: { challenge: string; type: string };
+    headers: Record<string, string>;
+  }>({
+    response: (args) => ({ challenge: args.body.challenge }),
+  }),
+  operation: {
+    kind: "function",
+    body: async ({ body }) => {
+      console.log(`Received ${body.type} event`);
+    },
+  },
+});
+```
+
 ### Resolver Executed Payload
 
 Resolver triggers receive the resolver's result or error:

package/docs/services/tailordb.md

@@ -96,11 +96,31 @@ db.enum([
 ### Object Fields
 
 ```typescript
+// Object field
 db.object({
   street: db.string(),
   city: db.string(),
   country: db.string(),
 });
+
+// Object array field
+db.object(
+  {
+    id: db.uuid(),
+    name: db.string(),
+    size: db.int(),
+  },
+  { array: true },
+);
+
+// Optional object array field
+db.object(
+  {
+    kind: db.string(),
+    days: db.int(),
+  },
+  { optional: true, array: true },
+);
 ```
 
 ## Field Modifiers