@tailor-platform/sdk 1.74.0 → 1.75.0

package/dist/configure/services/tailordb/schema.d.mts

@@ -3,6 +3,7 @@ import { InferFieldsOutput, TypeLevelError, output } from "../../../types/helper
 import { FieldOptions, FieldOutput, FieldValidateInput, TailorFieldType, TailorToTs, Validators } from "../../types/field.types.mjs";
 import { DBFieldMetadata, DefinedDBFieldMetadata, ExcludeNestedDBFields, Hook, Hooks, IndexDef, RelationType, SerialConfig, TailorDBField as TailorDBField$1, TailorDBType as TailorDBType$1, TypeFeatures } from "./types.mjs";
 import { AllowedValues, AllowedValuesOutput } from "../../types/field.mjs";
+import { FieldParseArgs, FieldParseInternalArgs } from "../../types/field-runtime.mjs";
 import { PluginConfigs } from "../../../plugin/types.mjs";
 import { TailorTypeGqlPermission, TailorTypePermission } from "./permission.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
@@ -76,7 +77,7 @@ type WithDBFieldSerial<Defined> = Defined & {
     update: false;
   };
 };
-type WithDBFieldCloneOptions<Defined extends DefinedDBFieldMetadata, NewOpt extends FieldOptions> = Omit<Defined, "array"> & {
+type WithDBFieldCloneOptions<Defined extends DefinedDBFieldMetadata, NewOpt extends FieldOptions> = IsAny<Defined> extends true ? Defined : Omit<Defined, "array"> & {
   array: NewOpt extends {
     array: true;
   } ? true : Defined["array"];
@@ -101,12 +102,12 @@ type DBFieldRelationMethod<Defined extends DefinedDBFieldMetadata, Output> = IsA
 } ? TypeLevelError<".relation() has already been set"> : DBFieldRelationFn<Defined, Output>;
 type DBFieldIndexMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldIndexFn<Defined, Output> : Defined extends {
   index: unknown;
-} ? TypeLevelError<".index() has already been set"> : Defined extends {
+} ? TypeLevelError<".index() has already been set"> : boolean extends Defined["array"] ? DBFieldIndexFn<Defined, Output> | TypeLevelError<"index cannot be set on array fields"> : Defined extends {
   array: true;
 } ? TypeLevelError<"index cannot be set on array fields"> : DBFieldIndexFn<Defined, Output>;
 type DBFieldUniqueMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldUniqueFn<Defined, Output> : Defined extends {
   unique: unknown;
-} ? TypeLevelError<".unique() has already been set"> : Defined extends {
+} ? TypeLevelError<".unique() has already been set"> : boolean extends Defined["array"] ? DBFieldUniqueFn<Defined, Output> | TypeLevelError<"unique cannot be set on array fields"> : Defined extends {
   array: true;
 } ? TypeLevelError<"unique cannot be set on array fields"> : DBFieldUniqueFn<Defined, Output>;
 type DBFieldVectorMethod<Defined extends DefinedDBFieldMetadata, Output> = IsAny<Defined> extends true ? DBFieldVectorFn<Defined, Output> : Defined extends {
@@ -213,11 +214,7 @@ interface TailorDBType<Fields extends Record<string, TailorAnyDBField> = any, Us
   gqlPermission<U extends object = User, P extends TailorTypeGqlPermission<U> = TailorTypeGqlPermission<U>>(permission: P): TailorDBType<Fields, U>;
   description(description: string): TailorDBType<Fields, User>;
   pickFields<K extends keyof Fields>(keys: K[]): Pick<Fields, K>;
-  pickFields<K extends keyof Fields, const Opt extends FieldOptions>(keys: K[], options: Opt): { [P in K]: Fields[P] extends TailorDBField<infer D, infer _O> ? TailorDBField<Omit<D, "array"> & {
-    array: Opt extends {
-      array: true;
-    } ? true : D["array"];
-  }, FieldOutput<TailorToTs[D["type"]], Opt>> : never };
+  pickFields<K extends keyof Fields, const Opt extends FieldOptions>(keys: K[], options: Opt): { [P in K]: Fields[P] extends TailorDBField<infer D, infer _O> ? TailorDBField<WithDBFieldCloneOptions<D, Opt>, FieldOutput<TailorToTs[D["type"]], Opt>> : never };
   omitFields<K extends keyof Fields>(keys: K[]): Omit<Fields, K>;
   plugin<P extends keyof PluginConfigs<keyof Fields & string>>(config: { [K in P]: PluginConfigs<keyof Fields & string>[K] }): TailorDBType<Fields, User>;
 }
@@ -240,17 +237,6 @@ type RelationSelfConfig = {
   };
   backward?: string;
 };
-type FieldParseArgs = {
-  value: unknown;
-  data: unknown;
-  user: TailorUser;
-};
-type FieldParseInternalArgs = {
-  value: any;
-  data: unknown;
-  user: TailorUser;
-  pathArray: string[];
-};
 type DBFieldDefined<T extends TailorFieldType, Opt extends FieldOptions> = {
   type: T;
   array: Opt extends {

package/dist/configure/services/workflow/execution-policy.d.mts

@@ -0,0 +1,71 @@
+import { ExecutionPolicyConcurrency, ExecutionPolicyDefInput, ExecutionPolicyExactInstance, ExecutionPolicyGroupOptions, ExecutionPolicyInstance, ExecutionPolicyWildcardInstance, ResolvedExecutionPolicyInstance } from "./execution-policy.types.mjs";
+
+//#region src/configure/services/workflow/execution-policy.d.ts
+type ResolveKey<Def, Fallback extends string> = Def extends {
+  key: infer K extends string;
+} ? K : Fallback;
+type ResolveMatchType<Def> = Def extends {
+  matchType: infer M extends "exact" | "prefix";
+} ? M : "exact";
+/**
+ * Define a single workflow job function execution policy.
+ *
+ * Use this when declaring a policy outside the
+ * {@link defineWorkflowExecutionPolicies} builder — for example, when the
+ * runtime key prefix needs to differ from the corresponding workspace-unique
+ * name.
+ *
+ * When `matchType: "prefix"` is set, the returned instance has `keyFor(suffix)`
+ * instead of a directly-usable `key` (see {@link ExecutionPolicyWildcardInstance}).
+ * @param name - Workspace-unique name. Must match `^[a-z0-9][a-z0-9-]{1,61}[a-z0-9]$`.
+ * @param def - Optional overrides for `key` (defaults to `name`), `matchType`, `separator` (the `keyFor` join character, defaults to `.`), and concurrency
+ * @returns An execution policy instance
+ * @example
+ * export const perTenant = defineWorkflowExecutionPolicy("tenant-api", {
+ *   matchType: "prefix",
+ *   concurrencyPolicy: { maxConcurrentExecutions: 3 },
+ * });
+ *
+ * perTenant.keyFor(tenantId); // "tenant-api.<tenantId>"
+ */
+declare function defineWorkflowExecutionPolicy<const N extends string, const D extends (Omit<ExecutionPolicyDefInput, "name"> & {
+  separator?: string;
+}) | undefined = undefined>(name: N, def?: D): ResolvedExecutionPolicyInstance<ResolveKey<D, N>, ResolveMatchType<D>>;
+/**
+ * Define a group of workflow job function execution policies. Property names
+ * become the workspace-unique `name` and default `key` verbatim, matching the
+ * mental model of {@link defineWaitPoints}. Provide `name` / `key` explicitly
+ * to override the property-name default (for example, when the property name
+ * is not valid for the execution policy grammar or when the runtime key
+ * prefix needs to differ).
+ *
+ * When `matchType: "prefix"` is set, the returned instance has `keyFor(suffix)`
+ * instead of a directly-usable `key` (see {@link ExecutionPolicyWildcardInstance}).
+ * `matchType` can be combined with an explicit `key`, or left to apply to
+ * the property-name-derived prefix.
+ *
+ * The return type mirrors the builder's return type so JSDoc on each property
+ * is preserved in IDE autocompletion.
+ * @param builder - Callback that receives a `define` factory and returns a record of policies
+ * @param options - Group-wide options; `separator` overrides the `.` `keyFor` uses to join the prefix and suffix for every prefix policy in the group
+ * @returns The same object returned by the builder (with `name` / `key` resolved on each instance)
+ * @example
+ * export const executionPolicies = defineWorkflowExecutionPolicies((define) => ({
+ *   premium: define({ concurrencyPolicy: { maxConcurrentExecutions: 5 } }),
+ *   "tenant-api": define({
+ *     matchType: "prefix",
+ *     concurrencyPolicy: { maxConcurrentExecutions: 3 },
+ *   }),
+ * }));
+ *
+ * // In a workflow job function:
+ * await tailor.workflow.triggerJobFunction("worker", args, {
+ *   executionPolicyKey: executionPolicies.premium.key,
+ * });
+ * await tailor.workflow.triggerJobFunction("worker", args, {
+ *   executionPolicyKey: executionPolicies["tenant-api"].keyFor(input.tenantId),
+ * });
+ */
+declare function defineWorkflowExecutionPolicies<T extends Record<string, ExecutionPolicyInstance>>(builder: (define: <const D extends ExecutionPolicyDefInput | undefined = undefined>(def?: D) => ResolvedExecutionPolicyInstance<ResolveKey<D, string>, ResolveMatchType<D>>) => T, options?: ExecutionPolicyGroupOptions): T;
+//#endregion
+export { type ExecutionPolicyConcurrency, type ExecutionPolicyDefInput, type ExecutionPolicyExactInstance, type ExecutionPolicyGroupOptions, type ExecutionPolicyInstance, type ExecutionPolicyWildcardInstance, type ResolvedExecutionPolicyInstance, defineWorkflowExecutionPolicies, defineWorkflowExecutionPolicy };

package/dist/configure/services/workflow/execution-policy.types.d.mts

@@ -0,0 +1,104 @@
+import { ExecutionPolicyKey } from "../../../runtime/workflow.mjs";
+
+//#region src/configure/services/workflow/execution-policy.types.d.ts
+/**
+ * Optional per-key concurrency cap applied to job function dispatches that
+ * resolve to a policy's `executionPolicyKey`.
+ */
+interface ExecutionPolicyConcurrency {
+  /** Maximum number of concurrent executions allowed per resolved key. */
+  maxConcurrentExecutions: number;
+}
+/** Fields shared by both {@link ExecutionPolicyExactInstance} and {@link ExecutionPolicyWildcardInstance}. */
+interface ExecutionPolicyBase {
+  /** Workspace-unique name for this policy. */
+  readonly name: string;
+  /** Optional per-key concurrency cap. */
+  readonly concurrencyPolicy?: ExecutionPolicyConcurrency;
+}
+/**
+ * An execution policy declared with `matchType: "exact"` (the default).
+ * `key` is branded as {@link ExecutionPolicyKey}, so it can be passed
+ * directly as the `executionPolicyKey` option.
+ */
+interface ExecutionPolicyExactInstance<Key extends string = string> extends ExecutionPolicyBase {
+  /** Declared key; the platform registers it verbatim. */
+  readonly key: Key & ExecutionPolicyKey;
+  readonly matchType: "exact";
+}
+/**
+ * An execution policy declared with `matchType: "prefix"`. The platform
+ * registers the declared key prefix with a trailing `*`, and matches every
+ * dispatch whose runtime key begins with that prefix. There is no
+ * directly-usable `key` — use `keyFor` to build a concrete, branded runtime
+ * key at the call site instead of hand-concatenating the prefix and a
+ * suffix.
+ */
+interface ExecutionPolicyWildcardInstance extends ExecutionPolicyBase {
+  readonly matchType: "prefix";
+  /**
+   * Build a concrete runtime key by appending `suffix` after this policy's
+   * declared key prefix, separated by `.` unless a different separator was
+   * configured where this policy was declared.
+   * @param suffix - Value appended after the wildcard prefix
+   * @returns The concrete key to pass as `executionPolicyKey`
+   * @throws If the resulting key does not match the execution policy key
+   * grammar (for example, an empty `suffix`)
+   * @example
+   * // key: "tenant-api", matchType: "prefix"
+   * tenantApi.keyFor(tenantId); // "tenant-api.<tenantId>"
+   */
+  keyFor(suffix: string): ExecutionPolicyKey;
+}
+/**
+ * A declared workflow job function execution policy — either
+ * {@link ExecutionPolicyExactInstance} or {@link ExecutionPolicyWildcardInstance}.
+ */
+type ExecutionPolicyInstance<Key extends string = string> = ExecutionPolicyExactInstance<Key> | ExecutionPolicyWildcardInstance;
+/**
+ * Resolves to {@link ExecutionPolicyWildcardInstance} when `MatchType` is
+ * known at the type level to be `"prefix"`, to {@link ExecutionPolicyExactInstance}
+ * when it's known to be `"exact"`, or to their union when `MatchType` is the
+ * unnarrowed `"exact" | "prefix"` (e.g. a caller passed a non-literal
+ * `matchType`) — narrowing to one branch in that case would claim a `key` or
+ * `keyFor` that may not exist on the actual runtime instance.
+ */
+type ResolvedExecutionPolicyInstance<Key extends string, MatchType extends "exact" | "prefix"> = "exact" | "prefix" extends MatchType ? ExecutionPolicyExactInstance<Key> | ExecutionPolicyWildcardInstance : MatchType extends "prefix" ? ExecutionPolicyWildcardInstance : ExecutionPolicyExactInstance<Key>;
+/**
+ * Body of an execution policy declaration.
+ *
+ * When both `name` and `key` are omitted in the `defineWorkflowExecutionPolicies`
+ * builder, the property name is used verbatim for both (like
+ * `defineWaitPoints`). Provide `name` when the property identifier is not
+ * valid execution policy grammar, and provide `key` when the runtime key
+ * prefix needs to differ from `name` (e.g. it needs `:` or `.`).
+ */
+interface ExecutionPolicyDefInput {
+  /** Overrides the property-name-derived `name`. 3-63 characters from `[a-z0-9-]`; must start and end with `[a-z0-9]`. */
+  name?: string;
+  /** Overrides the property-name-derived `key` prefix. Independent of `matchType` — both may be set together. */
+  key?: string;
+  /**
+   * `"exact"` (the default) matches a dispatch whose runtime key equals
+   * `key` (or the resolved `name`, if `key` is omitted). `"prefix"`
+   * registers `key` as a wildcard prefix — the platform appends a trailing
+   * `*`, and the resulting instance exposes `keyFor(suffix)` to build
+   * concrete dispatch keys instead of a directly-usable `key`.
+   */
+  matchType?: "exact" | "prefix";
+  /** Optional per-key concurrency cap. */
+  concurrencyPolicy?: ExecutionPolicyConcurrency;
+}
+/**
+ * Options for {@link defineWorkflowExecutionPolicies}, applying to every
+ * policy declared by the builder (not settable per policy).
+ */
+interface ExecutionPolicyGroupOptions {
+  /**
+   * Separator `keyFor(suffix)` inserts between a wildcard policy's declared
+   * `key` prefix and `suffix`. Defaults to `.`.
+   */
+  separator?: string;
+}
+//#endregion
+export { ExecutionPolicyConcurrency, ExecutionPolicyDefInput, ExecutionPolicyExactInstance, ExecutionPolicyGroupOptions, ExecutionPolicyInstance, ExecutionPolicyWildcardInstance, ResolvedExecutionPolicyInstance };

package/dist/configure/services/workflow/index.d.mts

@@ -1,7 +1,9 @@
+import { ExecutionPolicyConcurrency, ExecutionPolicyDefInput, ExecutionPolicyExactInstance, ExecutionPolicyGroupOptions, ExecutionPolicyInstance, ExecutionPolicyWildcardInstance, ResolvedExecutionPolicyInstance } from "./execution-policy.types.mjs";
 import { WorkflowServiceConfig, WorkflowServiceInput } from "../../config/types.mjs";
 import { ConcurrencyPolicy, RetryPolicy } from "../../../types/workflow.generated.mjs";
 import { WORKFLOW_TEST_ENV_KEY } from "./test-env-key.mjs";
 import { WorkflowJob, WorkflowJobContext, createWorkflowJob } from "./job.mjs";
 import { Workflow, WorkflowConfig, createWorkflow } from "./workflow.mjs";
+import { defineWorkflowExecutionPolicies, defineWorkflowExecutionPolicy } from "./execution-policy.mjs";
 import { WaitPointInstance, defineWaitPoint, defineWaitPoints } from "./wait-point.mjs";
-export { type ConcurrencyPolicy, type RetryPolicy, WORKFLOW_TEST_ENV_KEY, WaitPointInstance, Workflow, WorkflowConfig, WorkflowJob, WorkflowJobContext, type WorkflowServiceConfig, type WorkflowServiceInput, createWorkflow, createWorkflowJob, defineWaitPoint, defineWaitPoints };
+export { type ConcurrencyPolicy, type ExecutionPolicyConcurrency, type ExecutionPolicyDefInput, type ExecutionPolicyExactInstance, type ExecutionPolicyGroupOptions, type ExecutionPolicyInstance, type ExecutionPolicyWildcardInstance, type ResolvedExecutionPolicyInstance, type RetryPolicy, WORKFLOW_TEST_ENV_KEY, WaitPointInstance, Workflow, WorkflowConfig, WorkflowJob, WorkflowJobContext, type WorkflowServiceConfig, type WorkflowServiceInput, createWorkflow, createWorkflowJob, defineWaitPoint, defineWaitPoints, defineWorkflowExecutionPolicies, defineWorkflowExecutionPolicy };

package/dist/configure/services/workflow/job.d.mts

@@ -1,5 +1,6 @@
 import { TailorEnv, TailorInvoker } from "../../../runtime/types.mjs";
 import { JsonCompatible, TypeLevelError } from "../../../types/helpers.mjs";
+import { TriggerJobFunctionOptions } from "../../../runtime/workflow.mjs";
 import { WORKFLOW_TEST_ENV_KEY } from "./test-env-key.mjs";
 
 //#region src/configure/services/workflow/job.d.ts
@@ -28,15 +29,18 @@ interface WorkflowJob<Name extends string = string, Input = undefined, Output =
   name: Name;
   /**
    * Trigger this job with the given input. Returns a Promise that resolves
-   * to the job's output value.
+   * to the job's output value. Accepts an optional second argument to pass
+   * `executionPolicyKey` for platform-side concurrency enforcement.
    * @example
    * body: async (input) => {
    *   const a = await jobA.trigger({ id: input.id });
-   *   const b = await jobB.trigger({ id: input.id });
+   *   const b = await jobB.trigger({ id: input.id }, {
+   *     executionPolicyKey: `tenant-api.${input.tenantId}`,
+   *   });
    *   return { a, b };
    * }
    */
-  trigger: [Input] extends [undefined] ? () => Promise<Awaited<Output>> : (input: Input) => Promise<Awaited<Output>>;
+  trigger: [Input] extends [undefined] ? (input?: undefined, options?: TriggerJobFunctionOptions) => Promise<Awaited<Output>> : (input: Input, options?: TriggerJobFunctionOptions) => Promise<Awaited<Output>>;
   body: (input: Input, context: WorkflowJobContext) => Output | Promise<Output>;
 }
 interface CreateWorkflowJobConfig<Name extends string, I, O> {

package/dist/configure/types/field-runtime.d.mts

@@ -0,0 +1,17 @@
+import { TailorUser } from "../../runtime/types.mjs";
+import { StandardSchemaV1 } from "@standard-schema/spec";
+
+//#region src/configure/types/field-runtime.d.ts
+type FieldParseArgs = {
+  value: unknown;
+  data: unknown;
+  user: TailorUser;
+};
+type FieldParseInternalArgs = {
+  value: unknown;
+  data: unknown;
+  user: TailorUser;
+  pathArray: string[];
+};
+//#endregion
+export { FieldParseArgs, FieldParseInternalArgs };

package/dist/configure/types/type.d.mts

@@ -1,6 +1,6 @@
-import { TailorUser } from "../../runtime/types.mjs";
 import { TypeLevelError } from "../../types/helpers.mjs";
 import { DefinedFieldMetadata, FieldMetadata, FieldValidateInput, TailorField as TailorField$1, TailorFieldType } from "./field.types.mjs";
+import { FieldParseArgs, FieldParseInternalArgs } from "./field-runtime.mjs";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/configure/types/type.d.ts
@@ -78,22 +78,5 @@ interface TailorField<Defined extends DefinedFieldMetadata = DefinedFieldMetadat
    */
   _parseInternal(args: FieldParseInternalArgs): StandardSchemaV1.Result<Output>;
 }
-type FieldParseArgs = {
-  value: unknown;
-  data: unknown;
-  user: TailorUser;
-};
-type FieldParseInternalArgs = {
-  value: any;
-  data: unknown;
-  user: TailorUser;
-  pathArray: string[];
-};
-/**
- * Create a UUID field for resolver input/output.
- * @param options - Field configuration options
- * @returns A UUID field
- * @example t.uuid()
- */
 //#endregion
 export { TailorAnyField, TailorField };

package/dist/field-runtime-9bfXBAOK.mjs

@@ -0,0 +1,183 @@
+//#region src/configure/types/field.ts
+/**
+* Normalize allowed values into EnumValue objects with descriptions.
+* @param values - Allowed values as strings or EnumValue objects
+* @returns Normalized allowed values
+*/
+function mapAllowedValues(values) {
+	return values.map((value) => {
+		if (typeof value === "string") return {
+			value,
+			description: ""
+		};
+		return {
+			...value,
+			description: value.description ?? ""
+		};
+	});
+}
+
+//#endregion
+//#region src/configure/types/field-runtime.ts
+const regex = {
+	uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+	date: /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})$/,
+	time: /^(?<hour>\d{2}):(?<minute>\d{2})$/,
+	datetime: /^(?<year>\d{4})-(?<month>\d{2})-(?<day>\d{2})T(?<hour>\d{2}):(?<minute>\d{2}):(?<second>\d{2})(.(?<millisec>\d{3}))?Z$/,
+	decimal: /^-?(\d+\.?\d*|\.\d+)([eE][+-]?\d+)?$/
+};
+function validateValue(args) {
+	const { field, value, data, user, pathArray } = args;
+	const issues = [];
+	const path = pathArray.length > 0 ? pathArray : void 0;
+	switch (field.type) {
+		case "string":
+			if (typeof value !== "string") issues.push({
+				message: `Expected a string: received ${String(value)}`,
+				path
+			});
+			break;
+		case "integer":
+			if (typeof value !== "number" || !Number.isInteger(value)) issues.push({
+				message: `Expected an integer: received ${String(value)}`,
+				path
+			});
+			break;
+		case "float":
+			if (typeof value !== "number" || !Number.isFinite(value)) issues.push({
+				message: `Expected a number: received ${String(value)}`,
+				path
+			});
+			break;
+		case "boolean":
+			if (typeof value !== "boolean") issues.push({
+				message: `Expected a boolean: received ${String(value)}`,
+				path
+			});
+			break;
+		case "uuid":
+			if (typeof value !== "string" || !regex.uuid.test(value)) issues.push({
+				message: `Expected a valid UUID: received ${String(value)}`,
+				path
+			});
+			break;
+		case "date":
+			if (typeof value !== "string" || !regex.date.test(value)) issues.push({
+				message: `Expected to match "yyyy-MM-dd" format: received ${String(value)}`,
+				path
+			});
+			break;
+		case "datetime":
+			if (typeof value !== "string" || !regex.datetime.test(value)) issues.push({
+				message: `Expected to match ISO format: received ${String(value)}`,
+				path
+			});
+			break;
+		case "time":
+			if (typeof value !== "string" || !regex.time.test(value)) issues.push({
+				message: `Expected to match "HH:mm" format: received ${String(value)}`,
+				path
+			});
+			break;
+		case "decimal":
+			if (typeof value !== "string" || !regex.decimal.test(value)) issues.push({
+				message: `Expected a decimal string: received ${String(value)}`,
+				path
+			});
+			break;
+		case "enum":
+			if (field._metadata.allowedValues) {
+				const allowedValues = field._metadata.allowedValues.map((v) => v.value);
+				if (typeof value !== "string" || !allowedValues.includes(value)) issues.push({
+					message: `Must be one of [${allowedValues.join(", ")}]: received ${String(value)}`,
+					path
+				});
+			}
+			break;
+		case "nested":
+			if (typeof value !== "object" || value === null || Array.isArray(value) || value instanceof Date) issues.push({
+				message: `Expected an object: received ${String(value)}`,
+				path
+			});
+			else if (Object.keys(field.fields).length > 0) for (const [fieldName, nestedField] of Object.entries(field.fields)) {
+				const fieldValue = value[fieldName];
+				const result = nestedField._parseInternal({
+					value: fieldValue,
+					data,
+					user,
+					pathArray: pathArray.concat(fieldName)
+				});
+				if (result.issues) issues.push(...result.issues);
+			}
+			break;
+	}
+	const validateFns = field._metadata.validate;
+	if (validateFns && validateFns.length > 0) for (const validateInput of validateFns) {
+		const { fn, message } = typeof validateInput === "function" ? {
+			fn: validateInput,
+			message: "Validation failed"
+		} : {
+			fn: validateInput[0],
+			message: validateInput[1]
+		};
+		if (!fn({
+			value,
+			data,
+			user
+		})) issues.push({
+			message,
+			path
+		});
+	}
+	return issues;
+}
+function parseInternal(args) {
+	const { field, value, data, user, pathArray } = args;
+	const issues = [];
+	const path = pathArray.length > 0 ? pathArray : void 0;
+	const isNullOrUndefined = value === null || value === void 0;
+	if (field._metadata.required && isNullOrUndefined) {
+		issues.push({
+			message: "Required field is missing",
+			path
+		});
+		return { issues };
+	}
+	if (!field._metadata.required && isNullOrUndefined) return { value: value ?? null };
+	if (field._metadata.array) {
+		if (!Array.isArray(value)) {
+			issues.push({
+				message: "Expected an array",
+				path
+			});
+			return { issues };
+		}
+		for (let i = 0; i < value.length; i++) {
+			const elementValue = value[i];
+			const elementIssues = validateValue({
+				field,
+				value: elementValue,
+				data,
+				user,
+				pathArray: pathArray.concat(`[${i}]`)
+			});
+			if (elementIssues.length > 0) issues.push(...elementIssues);
+		}
+		if (issues.length > 0) return { issues };
+		return { value };
+	}
+	const valueIssues = validateValue({
+		field,
+		value,
+		data,
+		user,
+		pathArray
+	});
+	issues.push(...valueIssues);
+	if (issues.length > 0) return { issues };
+	return { value };
+}
+
+//#endregion
+export { mapAllowedValues as n, parseInternal as t };
+//# sourceMappingURL=field-runtime-9bfXBAOK.mjs.map

package/dist/field-runtime-9bfXBAOK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"field-runtime-9bfXBAOK.mjs","names":[],"sources":["../src/configure/types/field.ts","../src/configure/types/field-runtime.ts"],"sourcesContent":["import type { EnumValue } from \"#/configure/types/field.types\";\n\nexport type AllowedValues = readonly [string | EnumValue, ...(string | EnumValue)[]];\n\n/**\n * Normalize allowed values into EnumValue objects with descriptions.\n * @param values - Allowed values as strings or EnumValue objects\n * @returns Normalized allowed values\n */\nexport function mapAllowedValues(values: AllowedValues): EnumValue[] {\n  return values.map((value) => {\n    if (typeof value === \"string\") {\n      return { value, description: \"\" };\n    }\n    return { ...value, description: value.description ?? \"\" };\n  });\n}\n\nexport type AllowedValuesOutput<V extends AllowedValues> = V[number] extends infer T\n  ? T extends string\n    ? T\n    : T extends { value: infer K }\n      ? K\n      : never\n  : never;\n","import type { FieldMetadata, TailorFieldType } from \"#/configure/types/field.types\";\nimport type { TailorUser } from \"#/runtime/types\";\nimport type { StandardSchemaV1 } from \"@standard-schema/spec\";\n\nconst regex = {\n  uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,\n  date: /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})$/,\n  time: /^(?<hour>\\d{2}):(?<minute>\\d{2})$/,\n  datetime:\n    /^(?<year>\\d{4})-(?<month>\\d{2})-(?<day>\\d{2})T(?<hour>\\d{2}):(?<minute>\\d{2}):(?<second>\\d{2})(.(?<millisec>\\d{3}))?Z$/,\n  decimal: /^-?(\\d+\\.?\\d*|\\.\\d+)([eE][+-]?\\d+)?$/,\n} as const;\n\nexport type FieldParseArgs = {\n  value: unknown;\n  data: unknown;\n  user: TailorUser;\n};\n\nexport type FieldParseInternalArgs = {\n  value: unknown;\n  data: unknown;\n  user: TailorUser;\n  pathArray: string[];\n};\n\nexport type FieldRuntime<T extends TailorFieldType = TailorFieldType> = {\n  readonly type: T;\n  readonly fields: Record<string, FieldRuntime>;\n  _metadata: FieldMetadata;\n  _parseInternal(args: FieldParseInternalArgs): StandardSchemaV1.Result<unknown>;\n};\n\ntype FieldValidateValueArgs<T extends TailorFieldType> = {\n  field: FieldRuntime<T>;\n  value: unknown;\n  data: unknown;\n  user: TailorUser;\n  pathArray: string[];\n};\n\ntype FieldParseRuntimeArgs<T extends TailorFieldType> = FieldParseInternalArgs & {\n  field: FieldRuntime<T>;\n};\n\nfunction validateValue<T extends TailorFieldType>(\n  args: FieldValidateValueArgs<T>,\n): StandardSchemaV1.Issue[] {\n  const { field, value, data, user, pathArray } = args;\n  const issues: StandardSchemaV1.Issue[] = [];\n  const path = pathArray.length > 0 ? pathArray : undefined;\n\n  switch (field.type) {\n    case \"string\":\n      if (typeof value !== \"string\") {\n        issues.push({\n          message: `Expected a string: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"integer\":\n      if (typeof value !== \"number\" || !Number.isInteger(value)) {\n        issues.push({\n          message: `Expected an integer: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"float\":\n      if (typeof value !== \"number\" || !Number.isFinite(value)) {\n        issues.push({\n          message: `Expected a number: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"boolean\":\n      if (typeof value !== \"boolean\") {\n        issues.push({\n          message: `Expected a boolean: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"uuid\":\n      if (typeof value !== \"string\" || !regex.uuid.test(value)) {\n        issues.push({\n          message: `Expected a valid UUID: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"date\":\n      if (typeof value !== \"string\" || !regex.date.test(value)) {\n        issues.push({\n          message: `Expected to match \"yyyy-MM-dd\" format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"datetime\":\n      if (typeof value !== \"string\" || !regex.datetime.test(value)) {\n        issues.push({\n          message: `Expected to match ISO format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"time\":\n      if (typeof value !== \"string\" || !regex.time.test(value)) {\n        issues.push({\n          message: `Expected to match \"HH:mm\" format: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n    case \"decimal\":\n      if (typeof value !== \"string\" || !regex.decimal.test(value)) {\n        issues.push({\n          message: `Expected a decimal string: received ${String(value)}`,\n          path,\n        });\n      }\n      break;\n\n    case \"enum\":\n      if (field._metadata.allowedValues) {\n        const allowedValues = field._metadata.allowedValues.map((v) => v.value);\n        if (typeof value !== \"string\" || !allowedValues.includes(value)) {\n          issues.push({\n            message: `Must be one of [${allowedValues.join(\", \")}]: received ${String(value)}`,\n            path,\n          });\n        }\n      }\n      break;\n\n    case \"nested\":\n      // Runtime input may not match the declared field type.\n      // oxlint-disable typescript/no-unnecessary-condition\n      if (\n        typeof value !== \"object\" ||\n        value === null ||\n        Array.isArray(value) ||\n        value instanceof Date\n      ) {\n        // oxlint-enable typescript/no-unnecessary-condition\n        issues.push({\n          message: `Expected an object: received ${String(value)}`,\n          path,\n        });\n      } else if (Object.keys(field.fields).length > 0) {\n        for (const [fieldName, nestedField] of Object.entries(field.fields)) {\n          const fieldValue = (value as Record<string, unknown>)[fieldName];\n          const result = nestedField._parseInternal({\n            value: fieldValue,\n            data,\n            user,\n            pathArray: pathArray.concat(fieldName),\n          });\n          if (result.issues) {\n            issues.push(...result.issues);\n          }\n        }\n      }\n      break;\n  }\n\n  const validateFns = field._metadata.validate;\n  if (validateFns && validateFns.length > 0) {\n    for (const validateInput of validateFns) {\n      const { fn, message } =\n        typeof validateInput === \"function\"\n          ? { fn: validateInput, message: \"Validation failed\" }\n          : { fn: validateInput[0], message: validateInput[1] };\n\n      if (!fn({ value, data, user })) {\n        issues.push({\n          message,\n          path,\n        });\n      }\n    }\n  }\n\n  return issues;\n}\n\nexport function parseInternal<T extends TailorFieldType, Output>(\n  args: FieldParseRuntimeArgs<T>,\n): StandardSchemaV1.Result<Output> {\n  const { field, value, data, user, pathArray } = args;\n  const issues: StandardSchemaV1.Issue[] = [];\n  const path = pathArray.length > 0 ? pathArray : undefined;\n\n  const isNullOrUndefined = value === null || value === undefined;\n  if (field._metadata.required && isNullOrUndefined) {\n    issues.push({\n      message: \"Required field is missing\",\n      path,\n    });\n    return { issues };\n  }\n\n  if (!field._metadata.required && isNullOrUndefined) {\n    return { value: (value ?? null) as Output };\n  }\n\n  if (field._metadata.array) {\n    if (!Array.isArray(value)) {\n      issues.push({\n        message: \"Expected an array\",\n        path,\n      });\n      return { issues };\n    }\n\n    for (let i = 0; i < value.length; i++) {\n      const elementValue = value[i];\n      const elementPath = pathArray.concat(`[${i}]`);\n\n      const elementIssues = validateValue({\n        field,\n        value: elementValue,\n        data,\n        user,\n        pathArray: elementPath,\n      });\n      if (elementIssues.length > 0) {\n        issues.push(...elementIssues);\n      }\n    }\n\n    if (issues.length > 0) {\n      return { issues };\n    }\n    return { value: value as Output };\n  }\n\n  const valueIssues = validateValue({ field, value, data, user, pathArray });\n  issues.push(...valueIssues);\n\n  if (issues.length > 0) {\n    return { issues };\n  }\n\n  return { value: value as Output };\n}\n"],"mappings":"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"}

package/dist/{globals-B8XX5TRB.mjs → globals-CcU1ONiK.mjs}

@@ -1,4 +1,4 @@
-import { c as runRegisteredJob, l as runRegisteredWorkflow } from "./registry-BozuxbPp.mjs";
+import { c as runRegisteredJob, l as runRegisteredWorkflow } from "./registry-NfSW0BRo.mjs";
 
 //#region src/vitest/workflow-runtime.ts
 function createDefaultWorkflowRuntime() {
@@ -106,4 +106,4 @@ function cleanupPlatformGlobals(global) {
 
 //#endregion
 export { cleanupPlatformGlobals as n, installPlatformGlobals as r, RUNTIME_FLAG_KEY as t };
-//# sourceMappingURL=globals-B8XX5TRB.mjs.map
+//# sourceMappingURL=globals-CcU1ONiK.mjs.map

package/dist/globals-CcU1ONiK.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"globals-CcU1ONiK.mjs","names":[],"sources":["../src/vitest/workflow-runtime.ts","../src/vitest/globals.ts"],"sourcesContent":["// Default `tailor.workflow` runner installed by the `tailor-runtime` environment.\n// Must stay free of `vitest` (`vi`): it loads via `./globals` in the environment\n// realm where `vi` is unavailable, hence relative imports only (no `@/` alias).\nimport { runRegisteredJob, runRegisteredWorkflow } from \"../configure/services/workflow/registry\";\nimport type { TriggerJobFunctionOptions } from \"../runtime/workflow\";\n\nexport interface DefaultWorkflowRuntime {\n  triggerJobFunction: (\n    name: string,\n    args?: unknown,\n    options?: TriggerJobFunctionOptions,\n  ) => unknown;\n  triggerWorkflow: (name: string, args?: unknown, options?: unknown) => Promise<string>;\n  resumeWorkflow: (executionId: string) => Promise<string>;\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\nexport function createDefaultWorkflowRuntime(): DefaultWorkflowRuntime {\n  return {\n    triggerJobFunction: (name, args) => runRegisteredJob(name, args),\n    triggerWorkflow: (name, args) => runRegisteredWorkflow(name, args),\n    resumeWorkflow: async (executionId: string): Promise<string> => executionId,\n    wait: (key: string): unknown => {\n      throw new Error(\n        `No wait handler for \"${key}\". Acquire mockWorkflow() and call setWaitHandler(...).`,\n      );\n    },\n    resolve: async (): Promise<void> => {\n      throw new Error(\n        \"No resolve handler. Acquire mockWorkflow() and call setResolveHandler(...).\",\n      );\n    },\n  };\n}\n","/**\n * Base platform globals for the tailor-runtime test environment.\n *\n * This module is intentionally free of any `vitest` (`vi`) dependency so it can\n * be imported from the Vitest *environment* module (which runs in a realm where\n * `vi` is not available). It installs only the always-present structural pieces:\n *\n * - `globalThis.tailor` / `globalThis.tailordb` container objects\n * - `globalThis.tailor.context.getInvoker` default stub\n * - the platform error classes (`TailorErrors`, `TailorErrorMessage`,\n *   `TailorDBFileError`)\n * - the `__tailorRuntimeActive` sentinel flag\n *\n * The per-namespace mock behavior (TailorDB client, workflow, secretmanager, …)\n * is installed on demand by the `xMock()` factories in `./mock`, which run in\n * test context where `vi` *is* available.\n */\n\nimport { createDefaultWorkflowRuntime } from \"./workflow-runtime\";\nimport type { ContextInvoker } from \"../runtime/context\";\nimport type { TailorDBFileErrorCode } from \"../runtime/file\";\n\n// Sentinel set when the tailor-runtime environment is active. setup.ts reads it\n// to decide whether to run its blocked-globals lifecycle and config-secret\n// loading.\nexport const RUNTIME_FLAG_KEY = \"__tailorRuntimeActive\";\n\n// ---------------------------------------------------------------------------\n// Error class mocks\n// ---------------------------------------------------------------------------\n\ninterface TailorErrorItem {\n  message: string;\n  path: (string | number)[];\n}\n\nclass TailorErrorsMock extends Error {\n  errors: TailorErrorItem[];\n\n  constructor(errors: TailorErrorItem[]) {\n    if (!Array.isArray(errors)) {\n      throw new TypeError(\"TailorErrors: errors must be an array\");\n    }\n    const validated = errors.map((e, i) => {\n      if (typeof e.message !== \"string\") {\n        throw new TypeError(`TailorErrors: errors[${i}].message must be a string`);\n      }\n      if (!Array.isArray(e.path)) {\n        throw new TypeError(`TailorErrors: errors[${i}].path must be an array`);\n      }\n      return { message: e.message, path: e.path };\n    });\n    // Match the PF runtime's TailorErrors serialization, which prefixes the\n    // JSON payload with \"TailorErrors: \". Other SDK code (e.g. apply\n    // integration fixtures) strips this prefix before JSON.parse.\n    super(`TailorErrors: ${JSON.stringify({ errors: validated })}`);\n    this.name = \"TailorErrors\";\n    this.errors = validated;\n  }\n}\n\nclass TailorErrorMessageMock extends Error {\n  constructor(message: string) {\n    super(message);\n    this.name = \"TailorErrorMessage\";\n  }\n}\n\nclass TailorDBFileErrorMock extends Error {\n  code?: TailorDBFileErrorCode;\n  override cause: unknown;\n\n  constructor(message: string, code?: TailorDBFileErrorCode, cause?: unknown) {\n    super(message);\n    this.name = \"TailorDBFileError\";\n    this.code = code;\n    this.cause = cause;\n  }\n}\n\n// ---------------------------------------------------------------------------\n// Base install / cleanup\n// ---------------------------------------------------------------------------\n\n// Stub-only injection. SDK consumers configure invokers at the body level\n// (resolver/executor/workflow `.body()` `invoker` arg) or, for bundled tests,\n// via `vi.spyOn(globalThis.tailor.context, \"getInvoker\")`.\nfunction defaultGetInvoker(): ContextInvoker | null {\n  return null;\n}\n\n/**\n * Install the always-present base platform globals (containers, context stub,\n * error classes, runtime flag). Per-namespace mocks are layered on top by the\n * `xMock()` factories in `./mock`.\n * @param global - The global object to install into (typically `globalThis`)\n */\nexport function installPlatformGlobals(global: typeof globalThis): void {\n  const g = global as Record<string, unknown>;\n\n  g[RUNTIME_FLAG_KEY] = true;\n\n  // Containers. Namespace mocks (secretmanager, …) are added to these by the\n  // corresponding `xMock()` on acquisition. `workflow` carries a default runner\n  // so `.trigger()` runs the real job chain locally without `mockWorkflow()`;\n  // `mockWorkflow()` overlays and restores it.\n  g.tailor = {\n    context: { getInvoker: defaultGetInvoker },\n    workflow: createDefaultWorkflowRuntime(),\n  };\n  g.tailordb = {};\n\n  g.TailorErrors = TailorErrorsMock;\n  g.TailorErrorMessage = TailorErrorMessageMock;\n  g.TailorDBFileError = TailorDBFileErrorMock;\n}\n\n/**\n * Remove the base platform globals (and anything the namespace mocks layered on\n * top, since they live under the same containers).\n * @param global - The global object to clean up (typically `globalThis`)\n */\nexport function cleanupPlatformGlobals(global: typeof globalThis): void {\n  const g = global as Record<string, unknown>;\n  delete g.tailordb;\n  delete g.tailor;\n  delete g.TailorErrors;\n  delete g.TailorErrorMessage;\n  delete g.TailorDBFileError;\n  delete g[RUNTIME_FLAG_KEY];\n}\n"],"mappings":";;;AAsBA,SAAgB,+BAAuD;CACrE,OAAO;EACL,qBAAqB,MAAM,SAAS,iBAAiB,MAAM,IAAI;EAC/D,kBAAkB,MAAM,SAAS,sBAAsB,MAAM,IAAI;EACjE,gBAAgB,OAAO,gBAAyC;EAChE,OAAO,QAAyB;GAC9B,MAAM,IAAI,MACR,wBAAwB,IAAI,wDAC9B;EACF;EACA,SAAS,YAA2B;GAClC,MAAM,IAAI,MACR,6EACF;EACF;CACF;AACF;;;;;;;;;;;;;;;;;;;;;ACbA,MAAa,mBAAmB;AAWhC,IAAM,mBAAN,cAA+B,MAAM;CACnC;CAEA,YAAY,QAA2B;EACrC,IAAI,CAAC,MAAM,QAAQ,MAAM,GACvB,MAAM,IAAI,UAAU,uCAAuC;EAE7D,MAAM,YAAY,OAAO,KAAK,GAAG,MAAM;GACrC,IAAI,OAAO,EAAE,YAAY,UACvB,MAAM,IAAI,UAAU,wBAAwB,EAAE,2BAA2B;GAE3E,IAAI,CAAC,MAAM,QAAQ,EAAE,IAAI,GACvB,MAAM,IAAI,UAAU,wBAAwB,EAAE,wBAAwB;GAExE,OAAO;IAAE,SAAS,EAAE;IAAS,MAAM,EAAE;GAAK;EAC5C,CAAC;EAID,MAAM,iBAAiB,KAAK,UAAU,EAAE,QAAQ,UAAU,CAAC,GAAG;EAC9D,KAAK,OAAO;EACZ,KAAK,SAAS;CAChB;AACF;AAEA,IAAM,yBAAN,cAAqC,MAAM;CACzC,YAAY,SAAiB;EAC3B,MAAM,OAAO;EACb,KAAK,OAAO;CACd;AACF;AAEA,IAAM,wBAAN,cAAoC,MAAM;CACxC;CACA,AAAS;CAET,YAAY,SAAiB,MAA8B,OAAiB;EAC1E,MAAM,OAAO;EACb,KAAK,OAAO;EACZ,KAAK,OAAO;EACZ,KAAK,QAAQ;CACf;AACF;AASA,SAAS,oBAA2C;CAClD,OAAO;AACT;;;;;;;AAQA,SAAgB,uBAAuB,QAAiC;CACtE,MAAM,IAAI;CAEV,EAAE,oBAAoB;CAMtB,EAAE,SAAS;EACT,SAAS,EAAE,YAAY,kBAAkB;EACzC,UAAU,6BAA6B;CACzC;CACA,EAAE,WAAW,CAAC;CAEd,EAAE,eAAe;CACjB,EAAE,qBAAqB;CACvB,EAAE,oBAAoB;AACxB;;;;;;AAOA,SAAgB,uBAAuB,QAAiC;CACtE,MAAM,IAAI;CACV,OAAO,EAAE;CACT,OAAO,EAAE;CACT,OAAO,EAAE;CACT,OAAO,EAAE;CACT,OAAO,EAAE;CACT,OAAO,EAAE;AACX"}

package/dist/{job-CtU73PGa.mjs → job-D-PbD1P3.mjs}

@@ -1,5 +1,5 @@
 import { t as brandValue } from "./brand-Eo4pLXPJ.mjs";
-import { n as dispatchTriggerJob, o as registerJob } from "./registry-BozuxbPp.mjs";
+import { n as dispatchTriggerJob, o as registerJob } from "./registry-NfSW0BRo.mjs";
 
 //#region src/configure/services/workflow/job.ts
 /**
@@ -40,7 +40,9 @@ function createWorkflowJob(config) {
 	if (!process.env.TAILOR_PLATFORM_BUNDLE) registerJob(config.name, body);
 	const trigger = process.env.TAILOR_PLATFORM_BUNDLE ? async () => {
 		throw new Error("This workflow job's .trigger() is rewritten at build time and is unavailable in the bundle");
-	} : async (args) => await dispatchTriggerJob(config.name, args);
+	} : async function trigger(args, options) {
+		return arguments.length >= 2 ? await dispatchTriggerJob(config.name, args, options) : await dispatchTriggerJob(config.name, args);
+	};
 	return brandValue({
 		name: config.name,
 		trigger,
@@ -50,4 +52,4 @@ function createWorkflowJob(config) {
 
 //#endregion
 export { createWorkflowJob as t };
-//# sourceMappingURL=job-CtU73PGa.mjs.map
+//# sourceMappingURL=job-D-PbD1P3.mjs.map

package/dist/job-D-PbD1P3.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"job-D-PbD1P3.mjs","names":[],"sources":["../src/configure/services/workflow/job.ts"],"sourcesContent":["import { brandValue } from \"#/utils/brand\";\nimport { dispatchTriggerJob, registerJob, type RegisteredJobBody } from \"./registry\";\nimport type { TailorEnv, TailorInvoker } from \"#/runtime/types\";\nimport type { TriggerJobFunctionOptions } from \"#/runtime/workflow\";\nimport type { JsonCompatible, TypeLevelError } from \"#/types/helpers\";\n\n/**\n * Context object passed as the second argument to workflow job body functions.\n */\nexport type WorkflowJobContext = {\n  env: TailorEnv;\n  invoker?: TailorInvoker;\n};\n\n/**\n * The body function type for a workflow job.\n * Resolves to the callable signature when `I` / `O` are JsonValue-compatible,\n * or to a type-level error that surfaces at the `body:` property.\n */\ntype JobBody<I, O> = [null] extends [I]\n  ? TypeLevelError<\"Input cannot be null at the top level\">\n  : [I] extends [undefined]\n    ? [O] extends [JsonCompatible<O> | undefined | void]\n      ? (input: I, context: WorkflowJobContext) => O | Promise<O>\n      : TypeLevelError<\"Output must be JsonValue-compatible (plain objects/arrays; no class instances or functions)\">\n    : [undefined] extends [I]\n      ? TypeLevelError<\"Input cannot include undefined at the top level\">\n      : [I] extends [JsonCompatible<I>]\n        ? [O] extends [JsonCompatible<O> | undefined | void]\n          ? (input: I, context: WorkflowJobContext) => O | Promise<O>\n          : TypeLevelError<\"Output must be JsonValue-compatible (plain objects/arrays; no class instances or functions)\">\n        : TypeLevelError<\"Input must be JsonValue-compatible (plain objects/arrays; no class instances or functions)\">;\n\n/**\n * WorkflowJob represents a job that can be triggered in a workflow.\n *\n * Type constraints:\n * - Input: Must be JsonValue-compatible (plain objects/arrays; no class instances or functions) or undefined.\n * - Output: Must be JsonValue-compatible (plain objects/arrays; no class instances or functions), undefined, or void.\n * - Trigger returns `Awaited<Output>` as-is (no Jsonify transformation).\n */\nexport interface WorkflowJob<Name extends string = string, Input = undefined, Output = undefined> {\n  name: Name;\n  /**\n   * Trigger this job with the given input. Returns a Promise that resolves\n   * to the job's output value. Accepts an optional second argument to pass\n   * `executionPolicyKey` for platform-side concurrency enforcement.\n   * @example\n   * body: async (input) => {\n   *   const a = await jobA.trigger({ id: input.id });\n   *   const b = await jobB.trigger({ id: input.id }, {\n   *     executionPolicyKey: `tenant-api.${input.tenantId}`,\n   *   });\n   *   return { a, b };\n   * }\n   */\n  trigger: [Input] extends [undefined]\n    ? (input?: undefined, options?: TriggerJobFunctionOptions) => Promise<Awaited<Output>>\n    : (input: Input, options?: TriggerJobFunctionOptions) => Promise<Awaited<Output>>;\n  body: (input: Input, context: WorkflowJobContext) => Output | Promise<Output>;\n}\n\nexport { WORKFLOW_TEST_ENV_KEY } from \"./test-env-key\";\n\ninterface CreateWorkflowJobConfig<Name extends string, I, O> {\n  readonly name: Name;\n  readonly body: JobBody<I, O>;\n}\n\n/**\n * Create a workflow job definition.\n *\n * All jobs must be named exports from the workflow file.\n * Job names must be unique across the entire project.\n *\n * Input and output must be JsonValue-compatible (primitives, plain objects, arrays).\n * Functions and objects with a `toJSON` method are rejected at the type level;\n * class instances exposing methods are rejected via the property walk.\n * @param config - Job configuration with name and body function.\n * @param config.name - Unique job name across the project.\n * @param config.body - Async function that processes the job input.\n * @returns A WorkflowJob that can be triggered from other jobs.\n * @example\n * // Simple job with async body:\n * export const fetchData = createWorkflowJob({\n *   name: \"fetch-data\",\n *   body: async (input: { id: string }) => {\n *     const db = getDB(\"tailordb\");\n *     return await db.selectFrom(\"Table\").selectAll().where(\"id\", \"=\", input.id).executeTakeFirst();\n *   },\n * });\n * @example\n * // Orchestrator job that fans out to other jobs.\n * export const orchestrate = createWorkflowJob({\n *   name: \"orchestrate\",\n *   body: async (input: { orderId: string }) => {\n *     const inventory = await checkInventory.trigger({ orderId: input.orderId });\n *     const payment = await processPayment.trigger({ orderId: input.orderId });\n *     return { inventory, payment };\n *   },\n * });\n */\nexport function createWorkflowJob<const Name extends string, I = undefined, O = undefined>(\n  config: CreateWorkflowJobConfig<Name, I, O>,\n): WorkflowJob<Name, I, Awaited<O>> {\n  const body = config.body as (input: I, context: WorkflowJobContext) => O | Promise<O>;\n\n  // Test-only registry/trigger shim; the platform bundle sets the flag so it is DCE'd.\n  if (!process.env.TAILOR_PLATFORM_BUNDLE) {\n    registerJob(config.name, body as RegisteredJobBody);\n  }\n\n  const trigger = process.env.TAILOR_PLATFORM_BUNDLE\n    ? async () => {\n        throw new Error(\n          \"This workflow job's .trigger() is rewritten at build time and is unavailable in the bundle\",\n        );\n      }\n    : // Preserve arity: use `arguments.length` (regular function, not arrow) so\n      // `.trigger(args, undefined)` is treated as \"options passed\" — matching\n      // the bundler rewrite, which forwards the literal `undefined` from the\n      // AST as a third argument. Without this, local execution and bundled\n      // workflows would hand mocks different call shapes.\n      async function trigger(args?: unknown, options?: TriggerJobFunctionOptions) {\n        // oxlint-disable-next-line prefer-rest-params\n        return (\n          arguments.length >= 2\n            ? await dispatchTriggerJob(config.name, args, options)\n            : await dispatchTriggerJob(config.name, args)\n        ) as Awaited<O>;\n      };\n\n  return brandValue(\n    { name: config.name, trigger, body } as WorkflowJob<Name, I, Awaited<O>>,\n    \"workflow-job\",\n  );\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAsGA,SAAgB,kBACd,QACkC;CAClC,MAAM,OAAO,OAAO;CAGpB,IAAI,CAAC,QAAQ,IAAI,wBACf,YAAY,OAAO,MAAM,IAAyB;CAGpD,MAAM,UAAU,QAAQ,IAAI,yBACxB,YAAY;EACV,MAAM,IAAI,MACR,4FACF;CACF,IAMA,eAAe,QAAQ,MAAgB,SAAqC;EAE1E,OACE,UAAU,UAAU,IAChB,MAAM,mBAAmB,OAAO,MAAM,MAAM,OAAO,IACnD,MAAM,mBAAmB,OAAO,MAAM,IAAI;CAElD;CAEJ,OAAO,WACL;EAAE,MAAM,OAAO;EAAM;EAAS;CAAK,GACnC,cACF;AACF"}

package/dist/plugin/builtin/seed/index.mjs

@@ -1,3 +1,3 @@
-import { n as seedPlugin, t as SeedGeneratorID } from "../../../seed-DoMTMLcm.mjs";
+import { n as seedPlugin, t as SeedGeneratorID } from "../../../seed-fm0LeYP2.mjs";
 
 export { SeedGeneratorID, seedPlugin };

package/dist/{registry-BozuxbPp.mjs → registry-NfSW0BRo.mjs}

@@ -163,9 +163,10 @@ async function runRegisteredWorkflow(name, args) {
 	if (workflow) await runRegisteredJob(workflow.mainJobName, args);
 	return TRIGGER_DEFAULT;
 }
-function dispatchTriggerJob(name, args) {
+function dispatchTriggerJob(name, args, options) {
 	const workflow = currentPlatformWorkflow();
-	return workflow ? workflow.triggerJobFunction(name, args) : runRegisteredJob(name, args);
+	if (!workflow) return runRegisteredJob(name, args);
+	return arguments.length >= 3 ? workflow.triggerJobFunction(name, args, options) : workflow.triggerJobFunction(name, args);
 }
 function dispatchTriggerWorkflow(name, args, options) {
 	const workflow = currentPlatformWorkflow();
@@ -174,4 +175,4 @@ function dispatchTriggerWorkflow(name, args, options) {
 
 //#endregion
 export { getRegisteredWorkflow as a, runRegisteredJob as c, buildJobContext as d, clearWorkflowTestEnv as f, getRegisteredJob as i, runRegisteredWorkflow as l, platformSerialize as m, dispatchTriggerJob as n, registerJob as o, writeWorkflowTestEnv as p, dispatchTriggerWorkflow as r, registerWorkflow as s, TRIGGER_DEFAULT as t, WORKFLOW_TEST_ENV_KEY as u };
-//# sourceMappingURL=registry-BozuxbPp.mjs.map
+//# sourceMappingURL=registry-NfSW0BRo.mjs.map