@tailor-platform/sdk 2.0.0-next.8 → 2.0.0

package/dist/{registry-i7EdJ-D5.mjs → registry-BIGVUrMB.mjs}

@@ -12,7 +12,7 @@ function jobs() {
 /**
 * Register a job body keyed by job name. Called as a side effect by
 * `createWorkflowJob` so `runWorkflowLocally()` can execute dependent job
-* bodies when `globalThis.tailor.workflow.startJobFunction(name, args)` is invoked.
+* bodies when `globalThis.tailor.workflow.execJobFunction(name, args)` is invoked.
 *
 * In production builds the bundler rewrites `.start()` calls so this registry
 * is never read; the gated write is dropped as dead code.
@@ -41,7 +41,7 @@ function requirePlatformWorkflow() {
 const START_DEFAULT = "00000000-0000-4000-8000-000000000000";
 function dispatchStartJob(name, args, options) {
 	const workflow = requirePlatformWorkflow();
-	return arguments.length >= 3 ? workflow.startJobFunction(name, args, options) : workflow.startJobFunction(name, args);
+	return arguments.length >= 3 ? workflow.execJobFunction(name, args, options) : workflow.execJobFunction(name, args);
 }
 function dispatchStartWorkflow(name, args, options) {
 	const workflow = requirePlatformWorkflow();
@@ -51,4 +51,4 @@ function dispatchStartWorkflow(name, args, options) {
 
 //#endregion
 export { registerJob as a, getRegisteredJob as i, dispatchStartJob as n, dispatchStartWorkflow as r, START_DEFAULT as t };
-//# sourceMappingURL=registry-i7EdJ-D5.mjs.map
+//# sourceMappingURL=registry-BIGVUrMB.mjs.map

package/dist/registry-BIGVUrMB.mjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"registry-BIGVUrMB.mjs","names":[],"sources":["../src/configure/services/workflow/registry.ts"],"sourcesContent":["import type { TailorEnv, TailorPrincipal } from \"#/runtime/types\";\nimport type { ExecJobFunctionOptions, 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  execJobFunction: (name: string, args?: unknown, options?: ExecJobFunctionOptions) => 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.execJobFunction(name, args)` is invoked.\n *\n * In production builds the bundler rewrites `.start()` 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 START_DEFAULT = \"00000000-0000-4000-8000-000000000000\";\n\n// `.start()` 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 dispatchStartJob(\n  name: string,\n  args?: unknown,\n  options?: ExecJobFunctionOptions,\n): unknown {\n  const workflow = requirePlatformWorkflow();\n  // oxlint-disable-next-line prefer-rest-params\n  return arguments.length >= 3\n    ? workflow.execJobFunction(name, args, options)\n    : workflow.execJobFunction(name, args);\n}\n\n// Accepts `unknown` because the SDK-side `.start()` 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 dispatchStartWorkflow(\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.startWorkflow(name, args);\n  }\n  return workflow.startWorkflow(\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;AAYrF,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,gBAAgB;AAO7B,SAAgB,iBACd,MACA,MACA,SACS;CACT,MAAM,WAAW,wBAAwB;CAEzC,OAAO,UAAU,UAAU,IACvB,SAAS,gBAAgB,MAAM,MAAM,OAAO,IAC5C,SAAS,gBAAgB,MAAM,IAAI;AACzC;AAOA,SAAgB,sBACd,MACA,MACA,SACiB;CACjB,MAAM,WAAW,wBAAwB;CAEzC,IAAI,UAAU,SAAS,GACrB,OAAO,SAAS,cAAc,MAAM,IAAI;CAE1C,OAAO,SAAS,cACd,MACA,MACA,SAAS,YAAY,SAChB,UACA,EAAE,aAAa,QAAQ,QAAQ,CACtC;AACF"}

package/dist/runtime/globals.d.mts

@@ -3,6 +3,7 @@ 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 { LogAttributeValue, LogAttributes } from "./logger.mjs";
 import { TailorRuntime, TailordbClientInstance, TailordbCommandType, TailordbQueryResult, TailordbRuntime } from "./index.mjs";
 //#region src/runtime/globals.d.ts
 type TailorIdpClientConfig = ClientConfig;
@@ -17,6 +18,8 @@ type TailorIdpUser = User;
 type TailorIdpUserQuery = UserQuery;
 type TailorWorkflowInvoker = Invoker;
 type TailorWorkflowStartWorkflowOptions = StartWorkflowOptions;
+type TailorLoggerLogAttributeValue = LogAttributeValue;
+type TailorLoggerLogAttributes = LogAttributes;
 declare global {
   namespace tailordb {
     type QueryResult<T> = TailordbQueryResult<T>;
@@ -47,6 +50,10 @@ declare global {
     namespace context {
       type Invoker = ContextInvoker;
     }
+    namespace logger {
+      type LogAttributeValue = TailorLoggerLogAttributeValue;
+      type LogAttributes = TailorLoggerLogAttributes;
+    }
   }
   var tailor: TailorRuntime;
   /** Custom error class for TailorDB File operations. */

package/dist/runtime/index.d.mts

@@ -5,6 +5,7 @@ import { PlatformContextAPI, context } from "./context.mjs";
 import { TailorDBFileAPI, file } from "./file.mjs";
 import { TailorIconvAPI, iconv } from "./iconv.mjs";
 import { TailorIdpAPI, idp } from "./idp.mjs";
+import { TailorLoggerAPI, logger } from "./logger.mjs";
 import { TailorSecretmanagerAPI, secretmanager } from "./secretmanager.mjs";
 //#region src/runtime/index.d.ts
 /** SQL command type recorded on a {@link TailordbQueryResult}. */
@@ -36,6 +37,7 @@ interface TailorRuntime {
   workflow: PlatformWorkflowAPI;
   context: PlatformContextAPI;
   aigateway: TailorAigatewayAPI;
+  logger: TailorLoggerAPI;
 }
 /** Top-level `tailordb` runtime object. */
 interface TailordbRuntime {
@@ -43,4 +45,4 @@ interface TailordbRuntime {
   file: TailorDBFileAPI;
 }
 //#endregion
-export { TailorRuntime, TailordbClientConstructor, TailordbClientInstance, TailordbCommandType, TailordbQueryResult, TailordbRuntime, aigateway, authconnection, context, file, iconv, idp, secretmanager, workflow };
+export { TailorRuntime, TailordbClientConstructor, TailordbClientInstance, TailordbCommandType, TailordbQueryResult, TailordbRuntime, aigateway, authconnection, context, file, iconv, idp, logger, secretmanager, workflow };

package/dist/runtime/index.mjs

@@ -2,9 +2,10 @@ 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-CsBvRE3g.mjs";
+import { t as workflow } from "../workflow-Bamae_Yc.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";
+import { i as logger } from "../logger-BtX0suGY.mjs";
 
-export { aigateway, authconnection, context, file, iconv, idp, secretmanager, workflow };
+export { aigateway, authconnection, context, file, iconv, idp, logger, secretmanager, workflow };

package/dist/runtime/logger.d.mts

@@ -0,0 +1,98 @@
+//#region src/runtime/logger.d.ts
+/**
+ * Structured logging utilities.
+ *
+ * Thin typed wrapper around the platform-provided `tailor.logger` runtime API.
+ * At runtime this delegates to `globalThis.tailor.logger`. Use `mockLogger`
+ * from `@tailor-platform/sdk/vitest` to mock these calls in unit tests.
+ *
+ * Unlike `console.*`, each call carries a severity and structured attributes.
+ * The message is written to standard output, and the full entry with its
+ * attributes is exported over OpenTelemetry, where the attributes are queryable.
+ * @example
+ * import { logger } from "@tailor-platform/sdk/runtime";
+ *
+ * logger.setAttributes({ requestId: "r-123" });
+ * logger.info("order processed", { orderId: "o-1", total: 99.5 });
+ */
+/**
+ * A single log attribute value. Values outside this union (`null`, nested
+ * objects, mixed-type arrays) are silently dropped by the platform.
+ */
+type LogAttributeValue = string | number | boolean | readonly string[] | readonly number[] | readonly boolean[];
+/**
+ * Structured attributes attached to a log entry. The platform keeps at most 32
+ * entries, drops any entry whose key exceeds 128 bytes, and truncates string
+ * values over 4096 bytes and arrays over 64 elements.
+ */
+type LogAttributes = Record<string, LogAttributeValue>;
+/**
+ * Platform API surface for `tailor.logger`. Describes the shape the platform
+ * runtime injects on `globalThis.tailor.logger`.
+ *
+ * Each method below is also re-exported as a top-level named export from this
+ * module so callers can either `import * as logger from
+ * "@tailor-platform/sdk/runtime/logger"` or pick individual methods.
+ */
+interface TailorLoggerAPI {
+  /**
+   * Emits a `debug`-severity log entry.
+   * @param message - The log message
+   * @param attributes - Structured attributes to attach to this entry
+   */
+  debug(message: string, attributes?: LogAttributes): void;
+  /**
+   * Emits an `info`-severity log entry.
+   * @param message - The log message
+   * @param attributes - Structured attributes to attach to this entry
+   */
+  info(message: string, attributes?: LogAttributes): void;
+  /**
+   * Emits a `warn`-severity log entry.
+   * @param message - The log message
+   * @param attributes - Structured attributes to attach to this entry
+   */
+  warn(message: string, attributes?: LogAttributes): void;
+  /**
+   * Emits an `error`-severity log entry.
+   * @param message - The log message
+   * @param attributes - Structured attributes to attach to this entry
+   */
+  error(message: string, attributes?: LogAttributes): void;
+  /**
+   * Merges attributes into every subsequent log entry from the current
+   * execution. Later keys overwrite earlier ones; per-call attributes passed to
+   * `debug`/`info`/`warn`/`error` take precedence.
+   * @param attributes - Attributes to attach to subsequent entries
+   */
+  setAttributes(attributes: LogAttributes): void;
+}
+/**
+ * See {@link TailorLoggerAPI.debug}.
+ * @param args - Forwarded to {@link TailorLoggerAPI.debug}
+ */
+declare const debug: TailorLoggerAPI["debug"];
+/**
+ * See {@link TailorLoggerAPI.info}.
+ * @param args - Forwarded to {@link TailorLoggerAPI.info}
+ */
+declare const info: TailorLoggerAPI["info"];
+/**
+ * See {@link TailorLoggerAPI.warn}.
+ * @param args - Forwarded to {@link TailorLoggerAPI.warn}
+ */
+declare const warn: TailorLoggerAPI["warn"];
+/**
+ * See {@link TailorLoggerAPI.error}.
+ * @param args - Forwarded to {@link TailorLoggerAPI.error}
+ */
+declare const error: TailorLoggerAPI["error"];
+/**
+ * See {@link TailorLoggerAPI.setAttributes}.
+ * @param args - Forwarded to {@link TailorLoggerAPI.setAttributes}
+ */
+declare const setAttributes: TailorLoggerAPI["setAttributes"];
+/** `tailor.logger` API object. See {@link TailorLoggerAPI} for method docs. */
+declare const logger: TailorLoggerAPI;
+//#endregion
+export { LogAttributeValue, LogAttributes, TailorLoggerAPI, debug, error, info, logger, setAttributes, warn };

package/dist/runtime/logger.mjs

@@ -0,0 +1,3 @@
+import { a as setAttributes, i as logger, n as error, o as warn, r as info, t as debug } from "../logger-BtX0suGY.mjs";
+
+export { debug, error, info, logger, setAttributes, warn };

package/dist/runtime/workflow.d.mts

@@ -5,6 +5,11 @@
  * 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`, `execJobFunction`,
+ * `resumeWorkflowExecution`) mirror the public `tailor.v1` RPC vocabulary:
+ * `Exec*` is a blocking call that returns the job's result, while `Start*`
+ * returns only an execution ID.
  * @example
  * import { workflow } from "@tailor-platform/sdk/runtime";
  *
@@ -35,8 +40,8 @@ declare const executionPolicyKeyBrand: unique symbol;
 type ExecutionPolicyKey = string & {
   readonly [executionPolicyKeyBrand]: never;
 };
-/** Options for {@link startJobFunction}. */
-interface StartJobFunctionOptions {
+/** Options for {@link execJobFunction}. */
+interface ExecJobFunctionOptions {
   /**
    * Execution policy key matched by the platform against the policies
    * declared with `defineWorkflowExecutionPolicies` in `tailor.config.ts`.
@@ -63,13 +68,16 @@ interface PlatformWorkflowAPI {
    */
   resumeWorkflowExecution(executionId: string): Promise<string>;
   /**
-   * Starts a job function and returns its result.
+   * Executes a job function and returns its result via durable suspend/replay.
+   *
+   * Canonical name under the platform verb convention: `Exec*` blocks and
+   * returns the job's result, while `Start*` returns only an execution ID.
    * @param jobName - Job name as defined in the workflow
    * @param args - Arguments forwarded to the job
-   * @param options - Optional start options (e.g. `executionPolicyKey`)
+   * @param options - Optional execution options (e.g. `executionPolicyKey`)
    * @returns The job's return value
    */
-  startJobFunction(jobName: string, args?: any, options?: StartJobFunctionOptions): any;
+  execJobFunction(jobName: string, args?: any, options?: ExecJobFunctionOptions): any;
   /**
    * Suspends the current workflow execution and waits for an external signal to resume.
    * @param key - Wait point key
@@ -90,9 +98,9 @@ interface PlatformWorkflowAPI {
 declare const workflow: {
   readonly startWorkflow: (workflowName: string, args?: any, options?: StartWorkflowOptions) => Promise<string>;
   readonly resumeWorkflowExecution: (executionId: string) => Promise<string>;
-  readonly startJobFunction: (jobName: string, args?: any, options?: StartJobFunctionOptions) => any;
+  readonly execJobFunction: (jobName: string, args?: any, options?: ExecJobFunctionOptions) => any;
   readonly wait: (key: string, payload?: any) => any;
   readonly resolve: (executionId: string, key: string, callback: (waitPayload: any) => any) => Promise<void>;
 };
 //#endregion
-export { ExecutionPolicyKey, Invoker, PlatformWorkflowAPI, StartJobFunctionOptions, StartWorkflowOptions, workflow };
+export { ExecJobFunctionOptions, ExecutionPolicyKey, Invoker, PlatformWorkflowAPI, StartWorkflowOptions, workflow };

package/dist/runtime/workflow.mjs

@@ -1,3 +1,3 @@
-import { t as workflow } from "../workflow-CsBvRE3g.mjs";
+import { t as workflow } from "../workflow-Bamae_Yc.mjs";
 
 export { workflow };