@tailor-platform/sdk 2.0.0-next.2 → 2.0.0-next.3

package/dist/runtime/iconv.d.mts

@@ -1,2 +1,121 @@
-import { a as convert, c as encode, i as TailorIconvAPI, l as encodings, n as IconvConstructor, o as convertBuffer, r as IconvInstance, s as decode, t as Iconv } from "../iconv-Co-TOPuH.mjs";
-export { Iconv, IconvConstructor, IconvInstance, TailorIconvAPI, convert, convertBuffer, decode, encode, encodings };
+declare namespace iconv_d_exports {
+  export { Iconv, IconvConstructor, IconvInstance, TailorIconvAPI, convert, convertBuffer, decode, encode, encodings };
+}
+/**
+ * Character encoding conversion utilities.
+ *
+ * Thin typed wrapper around the platform-provided `tailor.iconv` runtime API.
+ * At runtime this delegates to `globalThis.tailor.iconv`, which is provided by
+ * the Tailor Platform Function runtime. Use `mockIconv` from
+ * `@tailor-platform/sdk/vitest` to mock these calls in unit tests.
+ * @example
+ * import { iconv } from "@tailor-platform/sdk/runtime";
+ *
+ * const utf8 = iconv.convert(sjisBuffer, "Shift_JIS", "UTF-8"); // string
+ * const sjis = iconv.convert("こんにちは", "UTF-8", "Shift_JIS"); // Uint8Array
+ *
+ * const conv = new iconv.Iconv("Shift_JIS", "UTF-8");
+ * const out = conv.convert(sjisBuffer);
+ */
+/** Instance methods exposed by `tailor.iconv.Iconv`. */
+interface IconvInstance {
+  convert(input: string | Uint8Array | ArrayBuffer): string | Uint8Array;
+}
+/** Constructor shape for `tailor.iconv.Iconv`. */
+interface IconvConstructor {
+  new (fromEncoding: string, toEncoding: string): IconvInstance;
+}
+/**
+ * Platform API surface for `tailor.iconv`. Describes the shape the platform
+ * runtime injects on `globalThis.tailor.iconv` so the wrapper and ambient
+ * globals stay in sync.
+ *
+ * Each method below is also re-exported as a top-level named export from this
+ * module (e.g. `convert`, `decode`, `encode`) so callers can either
+ * `import * as iconv from "@tailor-platform/sdk/runtime/iconv"` or pick
+ * individual methods.
+ */
+interface TailorIconvAPI {
+  /**
+   * Convert a string or buffer between encodings.
+   * @param str - Input data to convert
+   * @param fromEncoding - Source encoding name
+   * @param toEncoding - Target encoding name
+   * @returns `string` when `toEncoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
+   */
+  convert<T extends string>(str: string | Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: T): T extends "UTF8" | "UTF-8" ? string : Uint8Array;
+  /**
+   * Convert a buffer between encodings.
+   * @param buffer - Input bytes to convert
+   * @param fromEncoding - Source encoding name
+   * @param toEncoding - Target encoding name
+   * @returns `string` when `toEncoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
+   */
+  convertBuffer<T extends string>(buffer: Uint8Array | ArrayBuffer, fromEncoding: string, toEncoding: T): T extends "UTF8" | "UTF-8" ? string : Uint8Array;
+  /**
+   * Decode a buffer to a UTF-8 string using the given source encoding.
+   * @param buffer - Input bytes
+   * @param encoding - Source encoding name
+   * @returns Decoded UTF-8 string
+   */
+  decode(buffer: Uint8Array | ArrayBuffer, encoding: string): string;
+  /**
+   * Encode a UTF-8 string into the given target encoding.
+   * @param str - Input string
+   * @param encoding - Target encoding name
+   * @returns `string` when `encoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
+   */
+  encode<T extends string>(str: string, encoding: T): T extends "UTF8" | "UTF-8" ? string : Uint8Array;
+  /**
+   * Returns the list of supported encoding names.
+   * @returns Array of encoding names supported by the platform iconv runtime
+   */
+  encodings(): string[];
+  /** Constructor for the stateful {@link Iconv} converter. */
+  Iconv: IconvConstructor;
+}
+/**
+ * See {@link TailorIconvAPI.convert}.
+ * @param args - Forwarded to {@link TailorIconvAPI.convert}
+ * @returns `string` when `toEncoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
+ */
+declare const convert: TailorIconvAPI["convert"];
+/**
+ * See {@link TailorIconvAPI.convertBuffer}.
+ * @param args - Forwarded to {@link TailorIconvAPI.convertBuffer}
+ * @returns `string` when `toEncoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
+ */
+declare const convertBuffer: TailorIconvAPI["convertBuffer"];
+/**
+ * See {@link TailorIconvAPI.decode}.
+ * @param args - Forwarded to {@link TailorIconvAPI.decode}
+ * @returns Decoded UTF-8 string
+ */
+declare const decode: TailorIconvAPI["decode"];
+/**
+ * See {@link TailorIconvAPI.encode}.
+ * @param args - Forwarded to {@link TailorIconvAPI.encode}
+ * @returns `string` when `encoding` is `"UTF8"` or `"UTF-8"`, otherwise `Uint8Array`.
+ */
+declare const encode: TailorIconvAPI["encode"];
+/**
+ * See {@link TailorIconvAPI.encodings}.
+ * @returns Array of encoding names supported by the platform iconv runtime
+ */
+declare const encodings: TailorIconvAPI["encodings"];
+/**
+ * Stateful converter for repeated conversions between a fixed encoding pair.
+ * Compatible with the `node-iconv` API surface.
+ */
+declare class Iconv {
+  private impl;
+  constructor(fromEncoding: string, toEncoding: string);
+  /**
+   * Convert input using this converter's fixed encoding pair.
+   * @param input - Bytes or string to convert
+   * @returns Encoded output (string for UTF-8 targets, otherwise `Uint8Array`).
+   */
+  convert(input: string | Uint8Array | ArrayBuffer): string | Uint8Array;
+}
+//#endregion
+export { Iconv, IconvConstructor, IconvInstance, TailorIconvAPI, convert, convertBuffer, decode, encode, encodings, iconv_d_exports };

package/dist/runtime/idp.d.mts

@@ -1,2 +1,186 @@
-import { a as IdpClientInstance, c as SendPasswordResetEmailInput, d as User, f as UserQuery, i as IdpClientConstructor, l as TailorIdpAPI, n as ClientConfig, o as ListUsersOptions, r as CreateUserInput, s as ListUsersResponse, t as Client, u as UpdateUserInput } from "../idp-DrhVrLmV.mjs";
-export { Client, ClientConfig, CreateUserInput, IdpClientConstructor, IdpClientInstance, ListUsersOptions, ListUsersResponse, SendPasswordResetEmailInput, TailorIdpAPI, UpdateUserInput, User, UserQuery };
+declare namespace idp_d_exports {
+  export { Client, ClientConfig, CreateUserInput, IdpClientConstructor, IdpClientInstance, ListUsersOptions, ListUsersResponse, SendPasswordResetEmailInput, TailorIdpAPI, UnenrollMfaInput, UpdateUserInput, User, UserQuery };
+}
+/**
+ * IDP (Identity Provider) utilities.
+ *
+ * Thin typed wrapper around the platform-provided `tailor.idp` runtime API.
+ * At runtime this delegates to `globalThis.tailor.idp`. Use `mockIdp` from
+ * `@tailor-platform/sdk/vitest` to mock these calls in unit tests.
+ * @example
+ * import { idp } from "@tailor-platform/sdk/runtime";
+ *
+ * const client = new idp.Client({ namespace: "my-namespace" });
+ * const { users } = await client.users({ first: 10 });
+ */
+/** Configuration object for {@link Client}. */
+interface ClientConfig {
+  namespace: string;
+}
+/** User record returned by IDP operations. */
+interface User {
+  id: string;
+  name: string;
+  disabled: boolean;
+  createdAt?: string;
+  /**
+   * True when the user has at least one enrolled MFA second factor. False when
+   * the namespace has MFA disabled or the user has not enrolled a factor.
+   */
+  mfaEnrolled: boolean;
+  /**
+   * Enrolled MFA second factor IDs. Pass an entry into
+   * {@link Client.unenrollMfa} to remove that factor.
+   */
+  mfaFactorIds: string[];
+}
+/** Filter options for {@link Client.users}. */
+interface UserQuery {
+  /** Filter by user IDs */
+  ids?: string[];
+  /** Filter by user names */
+  names?: string[];
+}
+/** Pagination/filter options for {@link Client.users}. */
+interface ListUsersOptions {
+  /** Maximum number of users to return */
+  first?: number;
+  /** Page token for pagination */
+  after?: string;
+  /** Query filter for users */
+  query?: UserQuery;
+}
+/** Response shape for {@link Client.users}. */
+interface ListUsersResponse {
+  users: User[];
+  nextPageToken: string | null;
+  totalCount: number;
+}
+/** Input for {@link Client.createUser}. */
+interface CreateUserInput {
+  /** The user's name (typically email) */
+  name: string;
+  /** The user's password. If omitted, the user is created without a password (cannot log in with any password). */
+  password?: string;
+  /** Whether the user is disabled */
+  disabled?: boolean;
+}
+/** Input for {@link Client.updateUser}. */
+interface UpdateUserInput {
+  /** The user's ID */
+  id: string;
+  /** New name for the user */
+  name?: string;
+  /** New password for the user. Cannot be used with clearPassword. */
+  password?: string;
+  /** If true, remove the user's password. Cannot be used with password. */
+  clearPassword?: boolean;
+  /** New disabled status for the user */
+  disabled?: boolean;
+}
+/** Input for {@link Client.sendPasswordResetEmail}. */
+interface SendPasswordResetEmailInput {
+  /** The ID of the user */
+  userId: string;
+  /** The URI to redirect to after password reset */
+  redirectUri: string;
+  /** The sender display name. Defaults to 'Tailor Platform IdP'. */
+  fromName?: string;
+  /** The email subject line. Defaults to the localized default subject. */
+  subject?: string;
+}
+/** Input for {@link Client.unenrollMfa}. */
+interface UnenrollMfaInput {
+  /** The ID of the user whose factor will be unenrolled. */
+  userId: string;
+  /**
+   * The ID of the factor to unenroll. Factor IDs are exposed on the user
+   * record (see {@link User.mfaFactorIds}).
+   */
+  mfaFactorId: string;
+}
+/** Instance methods exposed by `tailor.idp.Client`. */
+interface IdpClientInstance {
+  users(options?: ListUsersOptions): Promise<ListUsersResponse>;
+  user(userId: string): Promise<User>;
+  userByName(name: string): Promise<User>;
+  createUser(input: CreateUserInput): Promise<User>;
+  updateUser(input: UpdateUserInput): Promise<User>;
+  deleteUser(userId: string): Promise<boolean>;
+  sendPasswordResetEmail(input: SendPasswordResetEmailInput): Promise<boolean>;
+  unenrollMfa(input: UnenrollMfaInput): Promise<boolean>;
+}
+/**
+ * Constructor shape for `tailor.idp.Client`.
+ * @internal
+ */
+interface IdpClientConstructor {
+  new (config: ClientConfig): IdpClientInstance;
+}
+/**
+ * Platform API surface for `tailor.idp`. Describes the shape the platform
+ * runtime injects on `globalThis.tailor.idp`.
+ * @internal
+ */
+interface TailorIdpAPI {
+  Client: IdpClientConstructor;
+}
+/**
+ * IDP Client for user management operations.
+ *
+ * Wraps the platform-provided `tailor.idp.Client` and exposes the same surface.
+ */
+declare class Client {
+  #private;
+  constructor(config: ClientConfig);
+  /**
+   * List users in the namespace with optional filtering and pagination.
+   * @param options - Pagination and filter options
+   * @returns Page of users with `nextPageToken` and `totalCount`
+   */
+  users(options?: ListUsersOptions): Promise<ListUsersResponse>;
+  /**
+   * Get a user by ID.
+   * @param userId - IDP user ID
+   * @returns The matching user
+   */
+  user(userId: string): Promise<User>;
+  /**
+   * Get a user by name.
+   * @param name - IDP user name
+   * @returns The matching user
+   */
+  userByName(name: string): Promise<User>;
+  /**
+   * Create a new user.
+   * @param input - User attributes
+   * @returns The newly created user
+   */
+  createUser(input: CreateUserInput): Promise<User>;
+  /**
+   * Update an existing user.
+   * @param input - User ID plus attributes to update
+   * @returns The updated user
+   */
+  updateUser(input: UpdateUserInput): Promise<User>;
+  /**
+   * Delete a user by ID.
+   * @param userId - IDP user ID
+   * @returns `true` when the user was deleted
+   */
+  deleteUser(userId: string): Promise<boolean>;
+  /**
+   * Send a password reset email to a user.
+   * @param input - Target user ID and redirect URI
+   * @returns `true` when the email was queued
+   */
+  sendPasswordResetEmail(input: SendPasswordResetEmailInput): Promise<boolean>;
+  /**
+   * Unenroll an MFA factor from a user.
+   * @param input - Target user ID and factor ID (see {@link User.mfaFactorIds})
+   * @returns `true` when the factor was removed
+   */
+  unenrollMfa(input: UnenrollMfaInput): Promise<boolean>;
+}
+//#endregion
+export { Client, ClientConfig, CreateUserInput, IdpClientConstructor, IdpClientInstance, ListUsersOptions, ListUsersResponse, SendPasswordResetEmailInput, TailorIdpAPI, UnenrollMfaInput, UpdateUserInput, User, UserQuery, idp_d_exports };

package/dist/runtime/idp.mjs

@@ -1,3 +1,3 @@
-import { t as Client } from "../idp-BDbK5gjm.mjs";
+import { t as Client } from "../idp-Bx25ZBdN.mjs";
 
 export { Client };

package/dist/runtime/index.d.mts

@@ -1,9 +1,47 @@
-import { n as authconnection_d_exports } from "../authconnection-DvUQAjQS.mjs";
-import { i as context_d_exports } from "../context-C2lEi9uw.mjs";
-import { _ as file_d_exports } from "../file-Dq3NIt_F.mjs";
-import { u as iconv_d_exports } from "../iconv-Co-TOPuH.mjs";
-import { p as idp_d_exports } from "../idp-DrhVrLmV.mjs";
-import { i as secretmanager_d_exports } from "../secretmanager-B3n4KHfm.mjs";
-import { l as workflow_d_exports } from "../workflow-BVy4XWjS.mjs";
-import { a as TailordbQueryResult, i as TailordbCommandType, n as TailordbClientConstructor, o as TailordbRuntime, r as TailordbClientInstance, t as TailorRuntime } from "../index-Cg8VKAdN.mjs";
-export { TailorRuntime, TailordbClientConstructor, TailordbClientInstance, TailordbCommandType, TailordbQueryResult, TailordbRuntime, authconnection_d_exports as authconnection, context_d_exports as context, file_d_exports as file, iconv_d_exports as iconv, idp_d_exports as idp, secretmanager_d_exports as secretmanager, workflow_d_exports as workflow };
+import { TailorAigatewayAPI, aigateway_d_exports } from "./aigateway.mjs";
+import { TailorAuthconnectionAPI, authconnection_d_exports } from "./authconnection.mjs";
+import { TailorContextAPI, context_d_exports } from "./context.mjs";
+import { TailorDBFileAPI, file_d_exports } from "./file.mjs";
+import { TailorIconvAPI, iconv_d_exports } from "./iconv.mjs";
+import { TailorIdpAPI, idp_d_exports } from "./idp.mjs";
+import { TailorSecretmanagerAPI, secretmanager_d_exports } from "./secretmanager.mjs";
+import { TailorWorkflowAPI, workflow_d_exports } from "./workflow.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";
+/** Result of a single `queryObject` call against the TailorDB driver. */
+interface TailordbQueryResult<T> {
+  rows: T[];
+  command: TailordbCommandType;
+  rowCount: number;
+}
+/** Instance methods exposed by `tailordb.Client`. */
+interface TailordbClientInstance {
+  connect(): Promise<void>;
+  end(): Promise<void>;
+  queryObject<O>(sql: string, args?: readonly unknown[]): Promise<TailordbQueryResult<O>>;
+}
+/** Constructor shape for `tailordb.Client`. */
+interface TailordbClientConstructor {
+  new (config: {
+    namespace: string;
+  }): TailordbClientInstance;
+}
+/** Top-level `tailor` runtime object. */
+interface TailorRuntime {
+  secretmanager: TailorSecretmanagerAPI;
+  authconnection: TailorAuthconnectionAPI;
+  iconv: TailorIconvAPI;
+  idp: TailorIdpAPI;
+  workflow: TailorWorkflowAPI;
+  context: TailorContextAPI;
+  aigateway: TailorAigatewayAPI;
+}
+/** Top-level `tailordb` runtime object. */
+interface TailordbRuntime {
+  Client: TailordbClientConstructor;
+  file: TailorDBFileAPI;
+}
+//#endregion
+export { TailorRuntime, TailordbClientConstructor, TailordbClientInstance, TailordbCommandType, TailordbQueryResult, TailordbRuntime, aigateway_d_exports as aigateway, authconnection_d_exports as authconnection, context_d_exports as context, file_d_exports as file, iconv_d_exports as iconv, idp_d_exports as idp, secretmanager_d_exports as secretmanager, workflow_d_exports as workflow };

package/dist/runtime/index.mjs

@@ -1,9 +1,10 @@
 import { s as iconv_exports } from "../iconv-D2vi8G36.mjs";
 import { r as secretmanager_exports } from "../secretmanager-BVxw3ih_.mjs";
-import { t as authconnection_exports } from "../authconnection-D2MhtTN5.mjs";
-import { n as idp_exports } from "../idp-BDbK5gjm.mjs";
-import { a as workflow_exports } from "../workflow-BOmaZwwG.mjs";
+import { t as authconnection_exports } from "../authconnection-BGQM8FZI.mjs";
+import { n as idp_exports } from "../idp-Bx25ZBdN.mjs";
+import { o as workflow_exports } from "../workflow-Bo59B75H.mjs";
 import { t as context_exports } from "../context-Bd266-ru.mjs";
 import { a as file_exports } from "../file-BbdFGdMV.mjs";
+import { t as aigateway_exports } from "../aigateway-B3oZZE6v.mjs";
 
-export { authconnection_exports as authconnection, context_exports as context, file_exports as file, iconv_exports as iconv, idp_exports as idp, secretmanager_exports as secretmanager, workflow_exports as workflow };
+export { aigateway_exports as aigateway, authconnection_exports as authconnection, context_exports as context, file_exports as file, iconv_exports as iconv, idp_exports as idp, secretmanager_exports as secretmanager, workflow_exports as workflow };

package/dist/runtime/secretmanager.d.mts

@@ -1,2 +1,54 @@
-import { n as getSecret, r as getSecrets, t as TailorSecretmanagerAPI } from "../secretmanager-B3n4KHfm.mjs";
-export { TailorSecretmanagerAPI, getSecret, getSecrets };
+declare namespace secretmanager_d_exports {
+  export { TailorSecretmanagerAPI, getSecret, getSecrets };
+}
+/**
+ * Secret manager utilities.
+ *
+ * Thin typed wrapper around the platform-provided `tailor.secretmanager` runtime API.
+ * At runtime this delegates to `globalThis.tailor.secretmanager`. Use
+ * `mockSecretmanager` from `@tailor-platform/sdk/vitest` to mock these calls
+ * in unit tests.
+ * @example
+ * import { secretmanager } from "@tailor-platform/sdk/runtime";
+ *
+ * const apiKey = await secretmanager.getSecret("my-vault", "API_KEY");
+ * const all = await secretmanager.getSecrets("my-vault", ["A", "B"] as const);
+ */
+/**
+ * Platform API surface for `tailor.secretmanager`. Describes the shape the
+ * platform runtime injects on `globalThis.tailor.secretmanager`.
+ *
+ * Each method below is also re-exported as a top-level named export from this
+ * module so callers can either `import * as secretmanager from
+ * "@tailor-platform/sdk/runtime/secretmanager"` or pick individual methods.
+ */
+interface TailorSecretmanagerAPI {
+  /**
+   * Returns multiple secrets from a vault. Missing names are omitted from the result.
+   * @param vault - Vault name
+   * @param names - Secret names to fetch (use `as const` to narrow the result key)
+   * @returns Partial record keyed by the requested names
+   */
+  getSecrets<const T extends readonly string[]>(vault: string, names: T): Promise<Partial<Record<T[number], string>>>;
+  /**
+   * Returns a single secret from a vault, or `undefined` when missing.
+   * @param vault - Vault name
+   * @param name - Secret name
+   * @returns The secret value, or `undefined` if not present
+   */
+  getSecret(vault: string, name: string): Promise<string | undefined>;
+}
+/**
+ * See {@link TailorSecretmanagerAPI.getSecrets}.
+ * @param args - Forwarded to {@link TailorSecretmanagerAPI.getSecrets}
+ * @returns Partial record keyed by the requested names
+ */
+declare const getSecrets: TailorSecretmanagerAPI["getSecrets"];
+/**
+ * See {@link TailorSecretmanagerAPI.getSecret}.
+ * @param args - Forwarded to {@link TailorSecretmanagerAPI.getSecret}
+ * @returns The secret value, or `undefined` if not present
+ */
+declare const getSecret: TailorSecretmanagerAPI["getSecret"];
+//#endregion
+export { TailorSecretmanagerAPI, getSecret, getSecrets, secretmanager_d_exports };

package/dist/{types-BZ7QKVE8.d.mts → runtime/types.d.mts}

@@ -1,21 +1,20 @@
 //#region src/runtime/types.d.ts
-interface AttributeMap {}
+interface Attributes {}
 interface AttributeList {
   __tuple?: [];
 }
-type InferredAttributeMap = keyof AttributeMap extends never ? Record<string, string | string[] | boolean | boolean[] | undefined> : AttributeMap;
+type InferredAttributes = keyof Attributes extends never ? Record<string, string | string[] | boolean | boolean[] | undefined> : Attributes;
 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: InferredAttributeMap; /** A list of the principal's attribute IDs. */
+  attributes: InferredAttributes; /** A list of the principal's attribute IDs. */
   attributeList: InferredAttributeList;
 };
 interface Env {}
 /** Represents environment variables in the Tailor platform. */
 type TailorEnv = keyof Env extends never ? Record<string, string | number | boolean> : Env;
 //#endregion
-export { TailorEnv as a, InferredAttributeMap as i, AttributeMap as n, TailorPrincipal as o, Env as r, AttributeList as t };
-//# sourceMappingURL=types-BZ7QKVE8.d.mts.map
+export { AttributeList, Attributes, Env, InferredAttributeList, InferredAttributes, TailorEnv, TailorPrincipal };

package/dist/runtime/workflow.d.mts

@@ -1,2 +1,112 @@
-import { a as resolve, c as wait, i as TriggerWorkflowOptions, n as PlatformTriggerWorkflowOptions, o as triggerJobFunction, r as TailorWorkflowAPI, s as triggerWorkflow, t as Invoker } from "../workflow-BVy4XWjS.mjs";
-export { Invoker, PlatformTriggerWorkflowOptions, TailorWorkflowAPI, TriggerWorkflowOptions, resolve, triggerJobFunction, triggerWorkflow, wait };
+declare namespace workflow_d_exports {
+  export { Invoker, PlatformTriggerWorkflowOptions, TailorWorkflowAPI, TriggerWorkflowOptions, resolve, resumeWorkflow, triggerJobFunction, triggerWorkflow, wait };
+}
+/**
+ * Workflow utilities.
+ *
+ * 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.
+ * @example
+ * import { workflow } from "@tailor-platform/sdk/runtime";
+ *
+ * const executionId = await workflow.triggerWorkflow("myWorkflow", { data: "value" });
+ */
+/**
+ * Specifies the machine user that should be used to execute the workflow.
+ * This allows workflows to run with specific authentication context.
+ */
+interface Invoker {
+  /** The namespace where the machine user is defined */
+  namespace: string;
+  /** The name of the machine user to use for workflow execution */
+  machineUserName: string;
+}
+/** Options for {@link triggerWorkflow}. */
+interface TriggerWorkflowOptions {
+  /** Optional invoker to specify which machine user should execute the workflow */
+  invoker?: Invoker;
+}
+interface PlatformTriggerWorkflowOptions {
+  authInvoker?: Invoker;
+}
+/**
+ * Platform API surface for `tailor.workflow`. Describes the shape the platform
+ * runtime injects on `globalThis.tailor.workflow`.
+ *
+ * Each method below is also re-exported as a top-level named export from this
+ * module so callers can either `import * as workflow from
+ * "@tailor-platform/sdk/runtime/workflow"` or pick individual methods.
+ */
+interface TailorWorkflowAPI {
+  /**
+   * Triggers a workflow and returns its execution ID.
+   * @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
+   */
+  triggerWorkflow(workflowName: string, args?: any, options?: PlatformTriggerWorkflowOptions): Promise<string>;
+  /**
+   * Resumes a failed or pending-retry workflow execution and returns its execution ID.
+   * @param executionId - The execution to resume
+   * @returns The execution ID of the resumed workflow
+   */
+  resumeWorkflow(executionId: string): Promise<string>;
+  /**
+   * Triggers a job function and returns its result.
+   * @param jobName - Job name as defined in the workflow
+   * @param args - Arguments forwarded to the job
+   * @returns The job's return value
+   */
+  triggerJobFunction(jobName: string, args?: any): any;
+  /**
+   * Suspends the current workflow execution and waits for an external signal to resume.
+   * @param key - Wait point key
+   * @param payload - Optional payload to record with the wait point
+   * @returns The payload supplied by the corresponding `resolve` call
+   */
+  wait(key: string, payload?: any): any;
+  /**
+   * Resolves a waiting workflow execution, causing it to resume.
+   * @param executionId - The execution to resume
+   * @param key - Wait point key to resolve
+   * @param callback - Callback receiving the wait payload; its return value is forwarded to `wait`
+   * @returns A promise that resolves once the resolve has been recorded
+   */
+  resolve(executionId: string, key: string, callback: (waitPayload: any) => any): Promise<void>;
+}
+/**
+ * See {@link TailorWorkflowAPI.triggerWorkflow}.
+ * @param workflowName - Workflow name as defined in tailor.config
+ * @param args - Arguments forwarded to the workflow's main job
+ * @param options - Optional trigger options
+ * @returns The execution ID of the triggered workflow
+ */
+declare function triggerWorkflow(workflowName: string, args?: any, options?: TriggerWorkflowOptions): Promise<string>;
+/**
+ * See {@link TailorWorkflowAPI.resumeWorkflow}.
+ * @param args - Forwarded to {@link TailorWorkflowAPI.resumeWorkflow}
+ * @returns The execution ID of the resumed workflow
+ */
+declare const resumeWorkflow: TailorWorkflowAPI["resumeWorkflow"];
+/**
+ * See {@link TailorWorkflowAPI.triggerJobFunction}.
+ * @param args - Forwarded to {@link TailorWorkflowAPI.triggerJobFunction}
+ * @returns The job's return value
+ */
+declare const triggerJobFunction: TailorWorkflowAPI["triggerJobFunction"];
+/**
+ * See {@link TailorWorkflowAPI.wait}.
+ * @param args - Forwarded to {@link TailorWorkflowAPI.wait}
+ * @returns The payload supplied by the corresponding `resolve` call
+ */
+declare const wait: TailorWorkflowAPI["wait"];
+/**
+ * See {@link TailorWorkflowAPI.resolve}.
+ * @param args - Forwarded to {@link TailorWorkflowAPI.resolve}
+ * @returns A promise that resolves once the resolve has been recorded
+ */
+declare const resolve: TailorWorkflowAPI["resolve"];
+//#endregion
+export { Invoker, PlatformTriggerWorkflowOptions, TailorWorkflowAPI, TriggerWorkflowOptions, resolve, resumeWorkflow, triggerJobFunction, triggerWorkflow, wait, workflow_d_exports };

package/dist/runtime/workflow.mjs

@@ -1,3 +1,3 @@
-import { i as wait, n as triggerJobFunction, r as triggerWorkflow, t as resolve } from "../workflow-BOmaZwwG.mjs";
+import { a as wait, i as triggerWorkflow, n as resumeWorkflow, r as triggerJobFunction, t as resolve } from "../workflow-Bo59B75H.mjs";
 
-export { resolve, triggerJobFunction, triggerWorkflow, wait };
+export { resolve, resumeWorkflow, triggerJobFunction, triggerWorkflow, wait };