@tailor-platform/sdk 1.72.0 → 1.73.0

package/dist/runtime/idp.d.mts

@@ -1,2 +1,186 @@
-import { a as IdpClientInstance, c as SendPasswordResetEmailInput, d as UpdateUserInput, f as User, i as IdpClientConstructor, l as TailorIdpAPI, n as ClientConfig, o as ListUsersOptions, p as UserQuery, r as CreateUserInput, s as ListUsersResponse, t as Client, u as UnenrollMfaInput } from "../idp-BmYwCXnJ.mjs";
-export { Client, ClientConfig, CreateUserInput, IdpClientConstructor, IdpClientInstance, ListUsersOptions, ListUsersResponse, SendPasswordResetEmailInput, TailorIdpAPI, UnenrollMfaInput, 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,4 +1,3 @@
-
-import { t as Client } from "../idp-ynUfzwpz.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-CqfaJfrC.mjs";
-import { i as context_d_exports } from "../context-CUBwSBq4.mjs";
-import { b as file_d_exports } from "../file-BzK8z3X-.mjs";
-import { u as iconv_d_exports } from "../iconv-kwrmd1U_.mjs";
-import { m as idp_d_exports } from "../idp-BmYwCXnJ.mjs";
-import { i as secretmanager_d_exports } from "../secretmanager-CKLB3wAQ.mjs";
-import { c as workflow_d_exports } from "../workflow-CMamswkK.mjs";
-import { a as TailordbQueryResult, i as TailordbCommandType, n as TailordbClientConstructor, o as TailordbRuntime, r as TailordbClientInstance, t as TailorRuntime } from "../index-BSlv_YrG.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,10 +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-BGQM8FZI.mjs";
+import { n as idp_exports } from "../idp-Bx25ZBdN.mjs";
+import { o as workflow_exports } from "../workflow-DSwnYPPP.mjs";
+import { t as context_exports } from "../context-Bd266-ru.mjs";
+import { a as file_exports } from "../file-_oUZo76X.mjs";
+import { t as aigateway_exports } from "../aigateway-B3oZZE6v.mjs";
 
-import { s as iconv_exports } from "../iconv-D1zmPjvi.mjs";
-import { r as secretmanager_exports } from "../secretmanager-h3tBJV8f.mjs";
-import { t as authconnection_exports } from "../authconnection-D7lsvsKY.mjs";
-import { n as idp_exports } from "../idp-ynUfzwpz.mjs";
-import { a as workflow_exports } from "../workflow-C8I7shjM.mjs";
-import { t as context_exports } from "../context-CDQqIv4u.mjs";
-import { a as file_exports } from "../file-BkxupbYP.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-CKLB3wAQ.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/runtime/secretmanager.mjs

@@ -1,4 +1,3 @@
-
-import { n as getSecrets, t as getSecret } from "../secretmanager-h3tBJV8f.mjs";
+import { n as getSecrets, t as getSecret } from "../secretmanager-BVxw3ih_.mjs";
 
 export { getSecret, getSecrets };

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

@@ -70,5 +70,4 @@ interface Env {}
 /** Represents environment variables in the Tailor platform. */
 type TailorEnv = keyof Env extends never ? Record<string, string | number | boolean> : Env;
 //#endregion
-export { TailorActor as a, TailorUser as c, InferredAttributeMap as i, AttributeMap as n, TailorEnv as o, Env as r, TailorInvoker as s, AttributeList as t };
-//# sourceMappingURL=types-DTcZ2Yax.d.mts.map
+export { AttributeList, AttributeMap, Env, InferredAttributeList, InferredAttributeMap, TailorActor, TailorActorType, TailorEnv, TailorInvoker, TailorUser };

package/dist/runtime/workflow.d.mts

@@ -1,2 +1,107 @@
-import { a as triggerJobFunction, i as resolve, n as TailorWorkflowAPI, o as triggerWorkflow, r as TriggerWorkflowOptions, s as wait, t as AuthInvoker } from "../workflow-CMamswkK.mjs";
-export { AuthInvoker, TailorWorkflowAPI, TriggerWorkflowOptions, resolve, triggerJobFunction, triggerWorkflow, wait };
+declare namespace workflow_d_exports {
+  export { AuthInvoker, 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 AuthInvoker {
+  /** 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 authentication invoker to specify which machine user should execute the workflow */
+  authInvoker?: AuthInvoker;
+}
+/**
+ * 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 trigger options (e.g. `authInvoker`)
+   * @returns The execution ID of the triggered workflow
+   */
+  triggerWorkflow(workflowName: string, args?: any, options?: TriggerWorkflowOptions): 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 args - Forwarded to {@link TailorWorkflowAPI.triggerWorkflow}
+ * @returns The execution ID of the triggered workflow
+ */
+declare const triggerWorkflow: TailorWorkflowAPI["triggerWorkflow"];
+/**
+ * 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 { AuthInvoker, TailorWorkflowAPI, TriggerWorkflowOptions, resolve, resumeWorkflow, triggerJobFunction, triggerWorkflow, wait, workflow_d_exports };

package/dist/runtime/workflow.mjs

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