@tailor-platform/sdk 2.0.0-next.4 → 2.0.0-next.6

package/dist/{registry-BSbq6SPo.mjs → registry-CC3CbQiF.mjs}

@@ -45,10 +45,10 @@ function dispatchTriggerJob(name, args, options) {
 }
 function dispatchTriggerWorkflow(name, args, options) {
 	const workflow = requirePlatformWorkflow();
-	if (options?.invoker === void 0) return workflow.triggerWorkflow(name, args);
-	return workflow.triggerWorkflow(name, args, { authInvoker: options.invoker });
+	if (arguments.length < 3) return workflow.triggerWorkflow(name, args);
+	return workflow.triggerWorkflow(name, args, options?.invoker === void 0 ? options : { authInvoker: options.invoker });
 }
 
 //#endregion
 export { registerJob as a, getRegisteredJob as i, dispatchTriggerJob as n, dispatchTriggerWorkflow as r, TRIGGER_DEFAULT as t };
-//# sourceMappingURL=registry-BSbq6SPo.mjs.map
+//# sourceMappingURL=registry-CC3CbQiF.mjs.map

package/dist/registry-CC3CbQiF.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-CC3CbQiF.mjs","names":[],"sources":["../src/configure/services/workflow/registry.ts"],"sourcesContent":["import type { TailorEnv, TailorPrincipal } from \"#/runtime/types\";\nimport type { StartJobFunctionOptions, StartWorkflowOptions } from \"#/runtime/workflow\";\n\n/**\n * Body signature shared by workflow jobs at registry-write time.\n * The user's `createWorkflowJob`/`createWorkflow` body uses concrete types,\n * but the registry erases them for storage.\n */\nexport type RegisteredJobBody = (\n  args: unknown,\n  context: { env: TailorEnv; invoker: TailorPrincipal | null },\n) => unknown | Promise<unknown>;\n\nconst JOB_REGISTRY_KEY: unique symbol = Symbol.for(\"tailor-platform/sdk:job-registry\");\n\ntype PlatformWorkflow = {\n  startWorkflow: (name: string, args?: unknown, options?: StartWorkflowOptions) => Promise<string>;\n  triggerWorkflow: (\n    name: string,\n    args?: unknown,\n    options?: StartWorkflowOptions,\n  ) => Promise<string>;\n  startJobFunction: (name: string, args?: unknown, options?: StartJobFunctionOptions) => unknown;\n  triggerJobFunction: (name: string, args?: unknown, options?: StartJobFunctionOptions) => unknown;\n};\n\ntype GlobalWithRegistry = typeof globalThis & {\n  [JOB_REGISTRY_KEY]?: Map<string, RegisteredJobBody>;\n  tailor?: { workflow?: PlatformWorkflow };\n};\n\nfunction jobs(): Map<string, RegisteredJobBody> {\n  const g = globalThis as GlobalWithRegistry;\n  let map = g[JOB_REGISTRY_KEY];\n  if (!map) {\n    map = new Map();\n    g[JOB_REGISTRY_KEY] = map;\n  }\n  return map;\n}\n\n/**\n * Register a job body keyed by job name. Called as a side effect by\n * `createWorkflowJob` so `runWorkflowLocally()` can execute dependent job\n * bodies when `globalThis.tailor.workflow.triggerJobFunction(name, args)` is invoked.\n *\n * In production builds the bundler rewrites `.trigger()` calls so this registry\n * is never read; the gated write is dropped as dead code.\n * @param name - Job name\n * @param body - Job body function\n */\nexport function registerJob(name: string, body: RegisteredJobBody): void {\n  jobs().set(name, body);\n}\n\n/**\n * Look up a registered job body by name.\n * @param name - Job name\n * @returns The registered body, or undefined when no job is registered\n */\nexport function getRegisteredJob(name: string): RegisteredJobBody | undefined {\n  return jobs().get(name);\n}\n\nfunction currentPlatformWorkflow(): PlatformWorkflow | undefined {\n  // globalThis may not have the tailor property at runtime\n  // oxlint-disable-next-line typescript/no-unnecessary-condition\n  return (globalThis as GlobalWithRegistry).tailor?.workflow;\n}\n\nfunction requirePlatformWorkflow(): PlatformWorkflow {\n  const workflow = currentPlatformWorkflow();\n  if (!workflow) {\n    throw new Error(\n      \"tailor.workflow is not available. Run tests in the `tailor-runtime` Vitest environment and use mockWorkflow(), or use runWorkflowLocally() from @tailor-platform/sdk/vitest for local workflow execution.\",\n    );\n  }\n  return workflow;\n}\n\n// A valid placeholder UUID, so callers that validate the execution id behave the\n// same locally as against the platform.\nexport const TRIGGER_DEFAULT = \"00000000-0000-4000-8000-000000000000\";\n\n// `.trigger()` routes through the installed `tailor.workflow` shim. Local body\n// execution is intentionally available only through `runWorkflowLocally()`.\n// Preserve arity: the shim sees a 2-argument call when the caller supplied no\n// options, and a 3-argument call otherwise, mirroring the bundler rewrite so\n// mocks observe the same shape in local execution and in bundled workflows.\nexport function dispatchTriggerJob(\n  name: string,\n  args?: unknown,\n  options?: StartJobFunctionOptions,\n): unknown {\n  const workflow = requirePlatformWorkflow();\n  // oxlint-disable-next-line prefer-rest-params\n  return arguments.length >= 3\n    ? workflow.triggerJobFunction(name, args, options)\n    : workflow.triggerJobFunction(name, args);\n}\n\n// Accepts `unknown` because the SDK-side `.trigger()` accepts a wider options\n// shape than the platform surface (e.g. `authInvoker` may be a machine-user\n// name string that the bundler normalizes at build time). Local execution\n// forwards the value verbatim; only the bundled path enforces the platform\n// contract.\nexport function dispatchTriggerWorkflow(\n  name: string,\n  args?: unknown,\n  options?: { invoker?: unknown },\n): Promise<string> {\n  const workflow = requirePlatformWorkflow();\n  // oxlint-disable-next-line prefer-rest-params\n  if (arguments.length < 3) {\n    return workflow.triggerWorkflow(name, args);\n  }\n  return workflow.triggerWorkflow(\n    name,\n    args,\n    options?.invoker === undefined\n      ? (options as StartWorkflowOptions | undefined)\n      : ({ authInvoker: options.invoker } as StartWorkflowOptions),\n  );\n}\n"],"mappings":";AAaA,MAAM,mBAAkC,OAAO,IAAI,kCAAkC;AAkBrF,SAAS,OAAuC;CAC9C,MAAM,IAAI;CACV,IAAI,MAAM,EAAE;CACZ,IAAI,CAAC,KAAK;EACR,sBAAM,IAAI,IAAI;EACd,EAAE,oBAAoB;CACxB;CACA,OAAO;AACT;;;;;;;;;;;AAYA,SAAgB,YAAY,MAAc,MAA+B;CACvE,KAAK,CAAC,CAAC,IAAI,MAAM,IAAI;AACvB;;;;;;AAOA,SAAgB,iBAAiB,MAA6C;CAC5E,OAAO,KAAK,CAAC,CAAC,IAAI,IAAI;AACxB;AAEA,SAAS,0BAAwD;CAG/D,OAAQ,WAAkC,QAAQ;AACpD;AAEA,SAAS,0BAA4C;CACnD,MAAM,WAAW,wBAAwB;CACzC,IAAI,CAAC,UACH,MAAM,IAAI,MACR,2MACF;CAEF,OAAO;AACT;AAIA,MAAa,kBAAkB;AAO/B,SAAgB,mBACd,MACA,MACA,SACS;CACT,MAAM,WAAW,wBAAwB;CAEzC,OAAO,UAAU,UAAU,IACvB,SAAS,mBAAmB,MAAM,MAAM,OAAO,IAC/C,SAAS,mBAAmB,MAAM,IAAI;AAC5C;AAOA,SAAgB,wBACd,MACA,MACA,SACiB;CACjB,MAAM,WAAW,wBAAwB;CAEzC,IAAI,UAAU,SAAS,GACrB,OAAO,SAAS,gBAAgB,MAAM,IAAI;CAE5C,OAAO,SAAS,gBACd,MACA,MACA,SAAS,YAAY,SAChB,UACA,EAAE,aAAa,QAAQ,QAAQ,CACtC;AACF"}

package/dist/runtime/aigateway.d.mts

@@ -1,5 +1,4 @@
 import { AIGatewayName } from "@tailor-platform/sdk";
-
 //#region src/runtime/aigateway.d.ts
 /** Result of {@link TailorAigatewayAPI.get}. */
 interface GetAIGatewayResult {

package/dist/runtime/authconnection.d.mts

@@ -1,6 +1,5 @@
 import { AuthConnectionTokenResult as AuthConnectionTokenResult$1 } from "../configure/services/auth/types.mjs";
 import { ConnectionName } from "@tailor-platform/sdk";
-
 //#region src/runtime/authconnection.d.ts
 /**
  * Platform API surface for `tailor.authconnection`. Describes the shape the

package/dist/runtime/context.d.mts

@@ -1,5 +1,4 @@
 import { TailorPrincipal } from "./types.mjs";
-
 //#region src/runtime/context.d.ts
 /**
  * Information about the invoker of the current function execution.

package/dist/runtime/field-parse.d.mts

@@ -0,0 +1,10 @@
+import { TailorPrincipal } from "./types.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+//#region src/runtime/field-parse.d.ts
+type FieldParseArgs = {
+  value: unknown;
+  data: unknown;
+  invoker: TailorPrincipal | null;
+};
+//#endregion
+export { FieldParseArgs };

package/dist/runtime/globals.d.mts

@@ -1,10 +1,9 @@
-import { Invoker, PlatformTriggerWorkflowOptions } from "./workflow.mjs";
+import { Invoker, StartWorkflowOptions, TriggerWorkflowOptions } from "./workflow.mjs";
 import { ContextInvoker } from "./context.mjs";
 import { TailorDBFileErrorCode } from "./file.mjs";
 import { IconvInstance } from "./iconv.mjs";
 import { ClientConfig, CreateUserInput, IdpClientInstance, ListUsersOptions, ListUsersResponse, SendPasswordResetEmailInput, UnenrollMfaInput, UpdateUserInput, User, UserQuery } from "./idp.mjs";
 import { TailorRuntime, TailordbClientInstance, TailordbCommandType, TailordbQueryResult, TailordbRuntime } from "./index.mjs";
-
 //#region src/runtime/globals.d.ts
 type TailorIdpClientConfig = ClientConfig;
 type TailorIdpCreateUserInput = CreateUserInput;
@@ -17,7 +16,8 @@ type TailorIdpUpdateUserInput = UpdateUserInput;
 type TailorIdpUser = User;
 type TailorIdpUserQuery = UserQuery;
 type TailorWorkflowInvoker = Invoker;
-type TailorWorkflowTriggerWorkflowOptions = PlatformTriggerWorkflowOptions;
+type TailorWorkflowTriggerWorkflowOptions = TriggerWorkflowOptions;
+type TailorWorkflowStartWorkflowOptions = StartWorkflowOptions;
 declare global {
   namespace tailordb {
     type QueryResult<T> = TailordbQueryResult<T>;
@@ -43,6 +43,8 @@ declare global {
     }
     namespace workflow {
       type Invoker = TailorWorkflowInvoker;
+      type StartWorkflowOptions = TailorWorkflowStartWorkflowOptions;
+      /** @deprecated Use `StartWorkflowOptions` instead. */
       type TriggerWorkflowOptions = TailorWorkflowTriggerWorkflowOptions;
     }
     namespace context {

package/dist/runtime/index.d.mts

@@ -6,7 +6,6 @@ import { TailorDBFileAPI, file } from "./file.mjs";
 import { TailorIconvAPI, iconv } from "./iconv.mjs";
 import { TailorIdpAPI, idp } from "./idp.mjs";
 import { TailorSecretmanagerAPI, secretmanager } from "./secretmanager.mjs";
-
 //#region src/runtime/index.d.ts
 /** SQL command type recorded on a {@link TailordbQueryResult}. */
 type TailordbCommandType = "INSERT" | "DELETE" | "UPDATE" | "SELECT" | "MOVE" | "FETCH" | "COPY" | "CREATE";

package/dist/runtime/index.mjs

@@ -2,7 +2,7 @@ import { t as iconv } from "../iconv-QWaZh0TT.mjs";
 import { t as secretmanager } from "../secretmanager-CYlpffsz.mjs";
 import { t as authconnection } from "../authconnection-CZvi9ANm.mjs";
 import { t as idp } from "../idp-RA_swu-h.mjs";
-import { t as workflow } from "../workflow-GNuSnsTx.mjs";
+import { t as workflow } from "../workflow-9kHGKxF2.mjs";
 import { t as context } from "../context-DYQVYWqZ.mjs";
 import { t as file } from "../file-BUcmVIH2.mjs";
 import { t as aigateway } from "../aigateway-DR4Kwuik.mjs";

package/dist/runtime/types.d.mts

@@ -7,10 +7,15 @@ type InferredAttributes = keyof Attributes extends never ? Record<string, string
 type InferredAttributeList = AttributeList["__tuple"] extends [] ? string[] : AttributeList["__tuple"];
 /** Represents a user or machine user principal in the Tailor Platform. */
 type TailorPrincipal = {
-  /** The ID of the principal. */id: string; /** The type of the principal. */
-  type: "user" | "machine_user"; /** The ID of the workspace the principal belongs to. */
-  workspaceId: string; /** A map of the principal's attributes. */
-  attributes: InferredAttributes; /** A list of the principal's attribute IDs. */
+  /** The ID of the principal. */
+  id: string;
+  /** The type of the principal. */
+  type: "user" | "machine_user";
+  /** The ID of the workspace the principal belongs to. */
+  workspaceId: string;
+  /** A map of the principal's attributes. */
+  attributes: InferredAttributes;
+  /** A list of the principal's attribute IDs. */
   attributeList: InferredAttributeList;
 };
 interface Env {}

package/dist/runtime/workflow.d.mts

@@ -5,10 +5,16 @@
  * Thin typed wrapper around the platform-provided `tailor.workflow` runtime API.
  * At runtime this delegates to `globalThis.tailor.workflow`. Use `mockWorkflow`
  * from `@tailor-platform/sdk/vitest` to mock these calls in unit tests.
+ *
+ * The canonical names (`startWorkflow`, `startJobFunction`,
+ * `resumeWorkflowExecution`) mirror the public `tailor.v1` RPC vocabulary.
+ * The pre-alignment names (`triggerWorkflow`, `triggerJobFunction`,
+ * `resumeWorkflow`) are kept as frozen aliases that reference the same platform
+ * implementations, so existing code continues to work unchanged.
  * @example
  * import { workflow } from "@tailor-platform/sdk/runtime";
  *
- * const executionId = await workflow.triggerWorkflow("myWorkflow", { data: "value" });
+ * const executionId = await workflow.startWorkflow("myWorkflow", { data: "value" });
  */
 /**
  * Specifies the machine user that should be used to execute the workflow.
@@ -20,7 +26,17 @@ interface Invoker {
   /** The name of the machine user to use for workflow execution */
   machineUserName: string;
 }
-/** Options for {@link triggerWorkflow}. */
+/** Options for {@link startWorkflow}. */
+interface StartWorkflowOptions {
+  /** Optional authentication invoker to specify which machine user should execute the workflow */
+  authInvoker?: Invoker;
+}
+/**
+ * Options for the legacy {@link triggerWorkflow} alias, using the SDK-facing
+ * `invoker` key that {@link triggerWorkflow} converts to `authInvoker` before
+ * calling the platform.
+ * @deprecated Use {@link startWorkflow} and {@link StartWorkflowOptions} instead.
+ */
 interface TriggerWorkflowOptions {
   /** Optional invoker to specify which machine user should execute the workflow */
   invoker?: Invoker;
@@ -38,40 +54,72 @@ declare const executionPolicyKeyBrand: unique symbol;
 type ExecutionPolicyKey = string & {
   readonly [executionPolicyKeyBrand]: never;
 };
-/** Options for {@link triggerJobFunction}. */
-interface TriggerJobFunctionOptions {
+/** Options for {@link startJobFunction}. */
+interface StartJobFunctionOptions {
   /**
    * Execution policy key matched by the platform against the policies
    * declared with `defineWorkflowExecutionPolicies` in `tailor.config.ts`.
    */
   executionPolicyKey?: ExecutionPolicyKey;
 }
+/**
+ * Frozen alias for {@link StartJobFunctionOptions}. Kept for backward compatibility.
+ * @deprecated Use {@link StartJobFunctionOptions} instead.
+ */
+type TriggerJobFunctionOptions = StartJobFunctionOptions;
 /**
  * Platform API surface for `tailor.workflow`. Describes the shape the platform
  * runtime injects on `globalThis.tailor.workflow`.
  */
 interface PlatformWorkflowAPI {
   /**
-   * Triggers a workflow and returns its execution ID.
+   * Starts a workflow and returns its execution ID.
+   *
+   * Canonical name that mirrors the `tailor.v1` RPC vocabulary.
+   * {@link triggerWorkflow} is a frozen alias that resolves to the same
+   * platform implementation.
    * @param workflowName - Workflow name as defined in tailor.config
    * @param args - Arguments forwarded to the workflow's main job
-   * @param options - Optional platform trigger options
-   * @returns The execution ID of the triggered workflow
+   * @param options - Optional start options (e.g. `authInvoker`)
+   * @returns The execution ID of the started workflow
+   */
+  startWorkflow(workflowName: string, args?: any, options?: StartWorkflowOptions): Promise<string>;
+  /**
+   * Frozen alias for {@link startWorkflow}. Kept for backward compatibility.
+   * @deprecated Use {@link startWorkflow} instead.
    */
   triggerWorkflow(workflowName: string, args?: any, options?: PlatformTriggerWorkflowOptions): Promise<string>;
   /**
    * Resumes a failed or pending-retry workflow execution and returns its execution ID.
+   *
+   * Canonical name that mirrors the `tailor.v1` RPC vocabulary.
+   * {@link resumeWorkflow} is a frozen alias that resolves to the same
+   * platform implementation.
    * @param executionId - The execution to resume
    * @returns The execution ID of the resumed workflow
    */
+  resumeWorkflowExecution(executionId: string): Promise<string>;
+  /**
+   * Frozen alias for {@link resumeWorkflowExecution}. Kept for backward compatibility.
+   * @deprecated Use {@link resumeWorkflowExecution} instead.
+   */
   resumeWorkflow(executionId: string): Promise<string>;
   /**
-   * Triggers a job function and returns its result.
+   * Starts a job function and returns its result.
+   *
+   * Canonical name that mirrors the `tailor.v1` RPC vocabulary.
+   * {@link triggerJobFunction} is a frozen alias that resolves to the same
+   * platform implementation.
    * @param jobName - Job name as defined in the workflow
    * @param args - Arguments forwarded to the job
-   * @param options - Optional trigger options (e.g. `executionPolicyKey`)
+   * @param options - Optional start options (e.g. `executionPolicyKey`)
    * @returns The job's return value
    */
+  startJobFunction(jobName: string, args?: any, options?: StartJobFunctionOptions): any;
+  /**
+   * Frozen alias for {@link startJobFunction}. Kept for backward compatibility.
+   * @deprecated Use {@link startJobFunction} instead.
+   */
   triggerJobFunction(jobName: string, args?: any, options?: TriggerJobFunctionOptions): any;
   /**
    * Suspends the current workflow execution and waits for an external signal to resume.
@@ -100,14 +148,26 @@ interface TailorWorkflowAPI extends Omit<PlatformWorkflowAPI, "triggerWorkflow">
    */
   triggerWorkflow(workflowName: string, args?: any, options?: TriggerWorkflowOptions): Promise<string>;
 }
+/**
+ * Frozen alias for {@link startWorkflow}. Kept for backward compatibility.
+ * Converts the SDK-facing `invoker` option to the platform's `authInvoker`.
+ * @param workflowName - Workflow name as defined in tailor.config
+ * @param args - Arguments forwarded to the workflow's main job
+ * @param options - Optional SDK trigger options
+ * @returns The execution ID of the triggered workflow
+ * @deprecated Use {@link startWorkflow} instead.
+ */
 declare function triggerWorkflow(workflowName: string, args?: any, options?: TriggerWorkflowOptions): Promise<string>;
 /** Runtime wrapper namespace for `tailor.workflow`. */
 declare const workflow: {
+  readonly startWorkflow: (workflowName: string, args?: any, options?: StartWorkflowOptions) => Promise<string>;
   readonly triggerWorkflow: typeof triggerWorkflow;
+  readonly resumeWorkflowExecution: (executionId: string) => Promise<string>;
   readonly resumeWorkflow: (executionId: string) => Promise<string>;
+  readonly startJobFunction: (jobName: string, args?: any, options?: StartJobFunctionOptions) => any;
   readonly triggerJobFunction: (jobName: string, args?: any, options?: TriggerJobFunctionOptions) => any;
   readonly wait: (key: string, payload?: any) => any;
   readonly resolve: (executionId: string, key: string, callback: (waitPayload: any) => any) => Promise<void>;
 };
 //#endregion
-export { ExecutionPolicyKey, Invoker, PlatformTriggerWorkflowOptions, PlatformWorkflowAPI, TailorWorkflowAPI, TriggerJobFunctionOptions, TriggerWorkflowOptions, workflow };
+export { ExecutionPolicyKey, Invoker, PlatformTriggerWorkflowOptions, PlatformWorkflowAPI, StartJobFunctionOptions, StartWorkflowOptions, TailorWorkflowAPI, TriggerJobFunctionOptions, TriggerWorkflowOptions, workflow };

package/dist/runtime/workflow.mjs

@@ -1,3 +1,3 @@
-import { t as workflow } from "../workflow-GNuSnsTx.mjs";
+import { t as workflow } from "../workflow-9kHGKxF2.mjs";
 
 export { workflow };