@astami/temporal-functions 0.1.0

package/dist/index.d.mts

@@ -0,0 +1,133 @@
+import { F as FunctionOptions, a as FunctionDef, W as WorkflowHandler, b as WorkflowOptions, c as WorkflowDef, H as HttpTriggerOptions, C as CronTriggerOptions, R as Registry } from './types-C-cNq1Id.mjs';
+export { g as ClientConfig, f as RetryPolicy, S as StartWorkflowOptions, j as TFNClient, k as TFNWorker, T as TemporalConfig, h as WorkerConfig, d as WorkflowContext, i as WorkflowHandle, e as WorkflowInfo } from './types-C-cNq1Id.mjs';
+
+/**
+ * Temporal Functions - Main Entry Point
+ *
+ * This module provides the core API for defining functions and workflows.
+ * Import from 'temporal-functions' for function/workflow definitions.
+ * Import from 'temporal-functions/client' for triggering workflows.
+ * Import from 'temporal-functions/worker' for running workers.
+ */
+
+/**
+ * Global registry for all defined functions and workflows
+ */
+declare const registry: Registry;
+/**
+ * Define a function (maps to a Temporal Activity)
+ *
+ * @example
+ * ```typescript
+ * export const sendEmail = tfn.fn(
+ *   'sendEmail',
+ *   async (params: EmailParams) => {
+ *     return await emailService.send(params);
+ *   },
+ *   { timeout: '30s', retries: 3 }
+ * );
+ * ```
+ */
+declare function fn<TInput, TOutput>(name: string, handler: (input: TInput) => Promise<TOutput>, options?: FunctionOptions): FunctionDef<TInput, TOutput>;
+/**
+ * Define a workflow
+ *
+ * @example
+ * ```typescript
+ * export const processOrder = tfn.workflow(
+ *   'processOrder',
+ *   async (ctx, order: Order) => {
+ *     const validated = await ctx.run(validateOrder, order);
+ *     const paid = await ctx.run(chargePayment, validated);
+ *     return { orderId: paid.id, status: 'complete' };
+ *   }
+ * );
+ * ```
+ */
+declare function workflow<TInput, TOutput>(name: string, handler: WorkflowHandler<TInput, TOutput>, options?: WorkflowOptions): WorkflowDef<TInput, TOutput>;
+interface HttpTriggerDef {
+    type: 'http';
+    method: string;
+    path: string;
+    workflow: WorkflowDef;
+    options: HttpTriggerOptions;
+}
+interface CronTriggerDef {
+    type: 'cron';
+    schedule: string;
+    workflow: WorkflowDef;
+    options: CronTriggerOptions;
+}
+interface SignalTriggerDef {
+    type: 'signal';
+    signalName: string;
+    handler: (payload: unknown) => void | Promise<void>;
+}
+type TriggerDef = HttpTriggerDef | CronTriggerDef | SignalTriggerDef;
+/**
+ * Registry for trigger definitions
+ */
+declare const triggers: TriggerDef[];
+/**
+ * Define an HTTP trigger for a workflow
+ *
+ * @example
+ * ```typescript
+ * tfn.http('POST', '/api/orders', processOrder);
+ * ```
+ */
+declare function http<TInput, TOutput>(method: string, path: string, workflow: WorkflowDef<TInput, TOutput>, options?: HttpTriggerOptions): void;
+/**
+ * Define a cron/scheduled trigger for a workflow
+ *
+ * @example
+ * ```typescript
+ * tfn.cron('0 9 * * *', dailyReport); // Every day at 9am
+ * ```
+ */
+declare function cron<TInput, TOutput>(schedule: string, workflow: WorkflowDef<TInput, TOutput>, options?: CronTriggerOptions): void;
+/**
+ * Define an interval trigger (convenience wrapper around cron)
+ *
+ * @example
+ * ```typescript
+ * tfn.interval('5m', healthCheck); // Every 5 minutes
+ * ```
+ */
+declare function interval<TInput, TOutput>(duration: string, workflow: WorkflowDef<TInput, TOutput>, options?: CronTriggerOptions): void;
+/**
+ * Define a signal trigger
+ *
+ * @example
+ * ```typescript
+ * tfn.signal('order.cancel', handleCancellation);
+ * ```
+ */
+declare function signal(signalName: string, handler: (payload: unknown) => void | Promise<void>): void;
+/**
+ * Check if a definition is a function
+ */
+declare function isFunction(def: unknown): def is FunctionDef;
+/**
+ * Check if a definition is a workflow
+ */
+declare function isWorkflow(def: unknown): def is WorkflowDef;
+/**
+ * The main Temporal Functions API
+ */
+declare const tfn: {
+    /** Define a function (activity) */
+    fn: typeof fn;
+    /** Define a workflow */
+    workflow: typeof workflow;
+    /** Define an HTTP trigger */
+    http: typeof http;
+    /** Define a cron trigger */
+    cron: typeof cron;
+    /** Define an interval trigger */
+    interval: typeof interval;
+    /** Define a signal trigger */
+    signal: typeof signal;
+};
+
+export { CronTriggerOptions, FunctionDef, FunctionOptions, HttpTriggerOptions, WorkflowDef, WorkflowHandler, WorkflowOptions, tfn as default, isFunction, isWorkflow, registry, tfn, triggers };

package/dist/index.d.ts

@@ -0,0 +1,133 @@
+import { F as FunctionOptions, a as FunctionDef, W as WorkflowHandler, b as WorkflowOptions, c as WorkflowDef, H as HttpTriggerOptions, C as CronTriggerOptions, R as Registry } from './types-C-cNq1Id.js';
+export { g as ClientConfig, f as RetryPolicy, S as StartWorkflowOptions, j as TFNClient, k as TFNWorker, T as TemporalConfig, h as WorkerConfig, d as WorkflowContext, i as WorkflowHandle, e as WorkflowInfo } from './types-C-cNq1Id.js';
+
+/**
+ * Temporal Functions - Main Entry Point
+ *
+ * This module provides the core API for defining functions and workflows.
+ * Import from 'temporal-functions' for function/workflow definitions.
+ * Import from 'temporal-functions/client' for triggering workflows.
+ * Import from 'temporal-functions/worker' for running workers.
+ */
+
+/**
+ * Global registry for all defined functions and workflows
+ */
+declare const registry: Registry;
+/**
+ * Define a function (maps to a Temporal Activity)
+ *
+ * @example
+ * ```typescript
+ * export const sendEmail = tfn.fn(
+ *   'sendEmail',
+ *   async (params: EmailParams) => {
+ *     return await emailService.send(params);
+ *   },
+ *   { timeout: '30s', retries: 3 }
+ * );
+ * ```
+ */
+declare function fn<TInput, TOutput>(name: string, handler: (input: TInput) => Promise<TOutput>, options?: FunctionOptions): FunctionDef<TInput, TOutput>;
+/**
+ * Define a workflow
+ *
+ * @example
+ * ```typescript
+ * export const processOrder = tfn.workflow(
+ *   'processOrder',
+ *   async (ctx, order: Order) => {
+ *     const validated = await ctx.run(validateOrder, order);
+ *     const paid = await ctx.run(chargePayment, validated);
+ *     return { orderId: paid.id, status: 'complete' };
+ *   }
+ * );
+ * ```
+ */
+declare function workflow<TInput, TOutput>(name: string, handler: WorkflowHandler<TInput, TOutput>, options?: WorkflowOptions): WorkflowDef<TInput, TOutput>;
+interface HttpTriggerDef {
+    type: 'http';
+    method: string;
+    path: string;
+    workflow: WorkflowDef;
+    options: HttpTriggerOptions;
+}
+interface CronTriggerDef {
+    type: 'cron';
+    schedule: string;
+    workflow: WorkflowDef;
+    options: CronTriggerOptions;
+}
+interface SignalTriggerDef {
+    type: 'signal';
+    signalName: string;
+    handler: (payload: unknown) => void | Promise<void>;
+}
+type TriggerDef = HttpTriggerDef | CronTriggerDef | SignalTriggerDef;
+/**
+ * Registry for trigger definitions
+ */
+declare const triggers: TriggerDef[];
+/**
+ * Define an HTTP trigger for a workflow
+ *
+ * @example
+ * ```typescript
+ * tfn.http('POST', '/api/orders', processOrder);
+ * ```
+ */
+declare function http<TInput, TOutput>(method: string, path: string, workflow: WorkflowDef<TInput, TOutput>, options?: HttpTriggerOptions): void;
+/**
+ * Define a cron/scheduled trigger for a workflow
+ *
+ * @example
+ * ```typescript
+ * tfn.cron('0 9 * * *', dailyReport); // Every day at 9am
+ * ```
+ */
+declare function cron<TInput, TOutput>(schedule: string, workflow: WorkflowDef<TInput, TOutput>, options?: CronTriggerOptions): void;
+/**
+ * Define an interval trigger (convenience wrapper around cron)
+ *
+ * @example
+ * ```typescript
+ * tfn.interval('5m', healthCheck); // Every 5 minutes
+ * ```
+ */
+declare function interval<TInput, TOutput>(duration: string, workflow: WorkflowDef<TInput, TOutput>, options?: CronTriggerOptions): void;
+/**
+ * Define a signal trigger
+ *
+ * @example
+ * ```typescript
+ * tfn.signal('order.cancel', handleCancellation);
+ * ```
+ */
+declare function signal(signalName: string, handler: (payload: unknown) => void | Promise<void>): void;
+/**
+ * Check if a definition is a function
+ */
+declare function isFunction(def: unknown): def is FunctionDef;
+/**
+ * Check if a definition is a workflow
+ */
+declare function isWorkflow(def: unknown): def is WorkflowDef;
+/**
+ * The main Temporal Functions API
+ */
+declare const tfn: {
+    /** Define a function (activity) */
+    fn: typeof fn;
+    /** Define a workflow */
+    workflow: typeof workflow;
+    /** Define an HTTP trigger */
+    http: typeof http;
+    /** Define a cron trigger */
+    cron: typeof cron;
+    /** Define an interval trigger */
+    interval: typeof interval;
+    /** Define a signal trigger */
+    signal: typeof signal;
+};
+
+export { CronTriggerOptions, FunctionDef, FunctionOptions, HttpTriggerOptions, WorkflowDef, WorkflowHandler, WorkflowOptions, tfn as default, isFunction, isWorkflow, registry, tfn, triggers };

package/dist/index.js

@@ -0,0 +1,120 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// src/index.ts
+var registry = {
+  functions: /* @__PURE__ */ new Map(),
+  workflows: /* @__PURE__ */ new Map()
+};
+function fn(name, handler, options = {}) {
+  const def = {
+    name,
+    handler,
+    options: {
+      startToCloseTimeout: "1m",
+      ...options
+    },
+    __type: "function"
+  };
+  registry.functions.set(name, def);
+  return def;
+}
+function workflow(name, handler, options = {}) {
+  const def = {
+    name,
+    handler,
+    options: {
+      taskQueue: "default",
+      ...options
+    },
+    __type: "workflow"
+  };
+  registry.workflows.set(name, def);
+  return def;
+}
+var triggers = [];
+function http(method, path, workflow2, options = {}) {
+  triggers.push({
+    type: "http",
+    method: method.toUpperCase(),
+    path,
+    workflow: workflow2,
+    options
+  });
+}
+function cron(schedule, workflow2, options = {}) {
+  triggers.push({
+    type: "cron",
+    schedule,
+    workflow: workflow2,
+    options
+  });
+}
+function interval(duration, workflow2, options = {}) {
+  const cronSchedule = durationToCron(duration);
+  cron(cronSchedule, workflow2, options);
+}
+function signal(signalName, handler) {
+  triggers.push({
+    type: "signal",
+    signalName,
+    handler
+  });
+}
+function durationToCron(duration) {
+  const match = duration.match(/^(\d+)(s|m|h|d)$/);
+  if (!match) {
+    throw new Error(`Invalid duration format: ${duration}. Use format like '5m', '1h', '30s'`);
+  }
+  const value = parseInt(match[1], 10);
+  const unit = match[2];
+  switch (unit) {
+    case "s":
+      if (value < 60) {
+        return `*/${value} * * * * *`;
+      }
+      throw new Error("Seconds interval must be less than 60");
+    case "m":
+      return `*/${value} * * * *`;
+    // Every N minutes
+    case "h":
+      return `0 */${value} * * *`;
+    // Every N hours
+    case "d":
+      return `0 0 */${value} * *`;
+    // Every N days
+    default:
+      throw new Error(`Unknown duration unit: ${unit}`);
+  }
+}
+function isFunction(def) {
+  return def?.__type === "function";
+}
+function isWorkflow(def) {
+  return def?.__type === "workflow";
+}
+var tfn = {
+  /** Define a function (activity) */
+  fn,
+  /** Define a workflow */
+  workflow,
+  /** Define an HTTP trigger */
+  http,
+  /** Define a cron trigger */
+  cron,
+  /** Define an interval trigger */
+  interval,
+  /** Define a signal trigger */
+  signal
+};
+var src_default = tfn;
+
+exports.default = src_default;
+exports.isFunction = isFunction;
+exports.isWorkflow = isWorkflow;
+exports.registry = registry;
+exports.tfn = tfn;
+exports.triggers = triggers;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["workflow"],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Temporal Functions - Main Entry Point\n *\n * This module provides the core API for defining functions and workflows.\n * Import from 'temporal-functions' for function/workflow definitions.\n * Import from 'temporal-functions/client' for triggering workflows.\n * Import from 'temporal-functions/worker' for running workers.\n */\n\nimport type {\n  FunctionDef,\n  FunctionOptions,\n  WorkflowDef,\n  WorkflowOptions,\n  WorkflowHandler,\n  WorkflowContext,\n  Registry,\n  HttpTriggerOptions,\n  CronTriggerOptions,\n} from './types.js';\n\n// =============================================================================\n// Global Registry\n// =============================================================================\n\n/**\n * Global registry for all defined functions and workflows\n */\nexport const registry: Registry = {\n  functions: new Map(),\n  workflows: new Map(),\n};\n\n// =============================================================================\n// Function Definition\n// =============================================================================\n\n/**\n * Define a function (maps to a Temporal Activity)\n *\n * @example\n * ```typescript\n * export const sendEmail = tfn.fn(\n *   'sendEmail',\n *   async (params: EmailParams) => {\n *     return await emailService.send(params);\n *   },\n *   { timeout: '30s', retries: 3 }\n * );\n * ```\n */\nfunction fn<TInput, TOutput>(\n  name: string,\n  handler: (input: TInput) => Promise<TOutput>,\n  options: FunctionOptions = {}\n): FunctionDef<TInput, TOutput> {\n  const def: FunctionDef<TInput, TOutput> = {\n    name,\n    handler,\n    options: {\n      startToCloseTimeout: '1m',\n      ...options,\n    },\n    __type: 'function',\n  };\n\n  registry.functions.set(name, def as FunctionDef);\n  return def;\n}\n\n// =============================================================================\n// Workflow Definition\n// =============================================================================\n\n/**\n * Define a workflow\n *\n * @example\n * ```typescript\n * export const processOrder = tfn.workflow(\n *   'processOrder',\n *   async (ctx, order: Order) => {\n *     const validated = await ctx.run(validateOrder, order);\n *     const paid = await ctx.run(chargePayment, validated);\n *     return { orderId: paid.id, status: 'complete' };\n *   }\n * );\n * ```\n */\nfunction workflow<TInput, TOutput>(\n  name: string,\n  handler: WorkflowHandler<TInput, TOutput>,\n  options: WorkflowOptions = {}\n): WorkflowDef<TInput, TOutput> {\n  const def: WorkflowDef<TInput, TOutput> = {\n    name,\n    handler,\n    options: {\n      taskQueue: 'default',\n      ...options,\n    },\n    __type: 'workflow',\n  };\n\n  registry.workflows.set(name, def as WorkflowDef);\n  return def;\n}\n\n// =============================================================================\n// Trigger Definitions (Declarative)\n// =============================================================================\n\ninterface HttpTriggerDef {\n  type: 'http';\n  method: string;\n  path: string;\n  workflow: WorkflowDef;\n  options: HttpTriggerOptions;\n}\n\ninterface CronTriggerDef {\n  type: 'cron';\n  schedule: string;\n  workflow: WorkflowDef;\n  options: CronTriggerOptions;\n}\n\ninterface SignalTriggerDef {\n  type: 'signal';\n  signalName: string;\n  handler: (payload: unknown) => void | Promise<void>;\n}\n\ntype TriggerDef = HttpTriggerDef | CronTriggerDef | SignalTriggerDef;\n\n/**\n * Registry for trigger definitions\n */\nexport const triggers: TriggerDef[] = [];\n\n/**\n * Define an HTTP trigger for a workflow\n *\n * @example\n * ```typescript\n * tfn.http('POST', '/api/orders', processOrder);\n * ```\n */\nfunction http<TInput, TOutput>(\n  method: string,\n  path: string,\n  workflow: WorkflowDef<TInput, TOutput>,\n  options: HttpTriggerOptions = {}\n): void {\n  triggers.push({\n    type: 'http',\n    method: method.toUpperCase(),\n    path,\n    workflow: workflow as WorkflowDef,\n    options,\n  });\n}\n\n/**\n * Define a cron/scheduled trigger for a workflow\n *\n * @example\n * ```typescript\n * tfn.cron('0 9 * * *', dailyReport); // Every day at 9am\n * ```\n */\nfunction cron<TInput, TOutput>(\n  schedule: string,\n  workflow: WorkflowDef<TInput, TOutput>,\n  options: CronTriggerOptions = {}\n): void {\n  triggers.push({\n    type: 'cron',\n    schedule,\n    workflow: workflow as WorkflowDef,\n    options,\n  });\n}\n\n/**\n * Define an interval trigger (convenience wrapper around cron)\n *\n * @example\n * ```typescript\n * tfn.interval('5m', healthCheck); // Every 5 minutes\n * ```\n */\nfunction interval<TInput, TOutput>(\n  duration: string,\n  workflow: WorkflowDef<TInput, TOutput>,\n  options: CronTriggerOptions = {}\n): void {\n  // Convert duration to cron expression\n  const cronSchedule = durationToCron(duration);\n  cron(cronSchedule, workflow, options);\n}\n\n/**\n * Define a signal trigger\n *\n * @example\n * ```typescript\n * tfn.signal('order.cancel', handleCancellation);\n * ```\n */\nfunction signal(\n  signalName: string,\n  handler: (payload: unknown) => void | Promise<void>\n): void {\n  triggers.push({\n    type: 'signal',\n    signalName,\n    handler,\n  });\n}\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\n/**\n * Convert a duration string to a cron expression\n */\nfunction durationToCron(duration: string): string {\n  const match = duration.match(/^(\\d+)(s|m|h|d)$/);\n  if (!match) {\n    throw new Error(`Invalid duration format: ${duration}. Use format like '5m', '1h', '30s'`);\n  }\n\n  const value = parseInt(match[1], 10);\n  const unit = match[2];\n\n  switch (unit) {\n    case 's':\n      if (value < 60) {\n        return `*/${value} * * * * *`; // Every N seconds (non-standard)\n      }\n      throw new Error('Seconds interval must be less than 60');\n    case 'm':\n      return `*/${value} * * * *`; // Every N minutes\n    case 'h':\n      return `0 */${value} * * *`; // Every N hours\n    case 'd':\n      return `0 0 */${value} * *`; // Every N days\n    default:\n      throw new Error(`Unknown duration unit: ${unit}`);\n  }\n}\n\n/**\n * Check if a definition is a function\n */\nexport function isFunction(def: unknown): def is FunctionDef {\n  return (def as FunctionDef)?.__type === 'function';\n}\n\n/**\n * Check if a definition is a workflow\n */\nexport function isWorkflow(def: unknown): def is WorkflowDef {\n  return (def as WorkflowDef)?.__type === 'workflow';\n}\n\n// =============================================================================\n// Main API Export\n// =============================================================================\n\n/**\n * The main Temporal Functions API\n */\nexport const tfn = {\n  /** Define a function (activity) */\n  fn,\n  /** Define a workflow */\n  workflow,\n  /** Define an HTTP trigger */\n  http,\n  /** Define a cron trigger */\n  cron,\n  /** Define an interval trigger */\n  interval,\n  /** Define a signal trigger */\n  signal,\n};\n\n// Re-export types\nexport type {\n  FunctionDef,\n  FunctionOptions,\n  WorkflowDef,\n  WorkflowOptions,\n  WorkflowContext,\n  WorkflowHandler,\n  WorkflowInfo,\n  RetryPolicy,\n  HttpTriggerOptions,\n  CronTriggerOptions,\n  TemporalConfig,\n  ClientConfig,\n  WorkerConfig,\n  StartWorkflowOptions,\n  WorkflowHandle,\n  TFNClient,\n  TFNWorker,\n} from './types.js';\n\nexport default tfn;\n"]}

package/dist/index.mjs

@@ -0,0 +1,111 @@
+// src/index.ts
+var registry = {
+  functions: /* @__PURE__ */ new Map(),
+  workflows: /* @__PURE__ */ new Map()
+};
+function fn(name, handler, options = {}) {
+  const def = {
+    name,
+    handler,
+    options: {
+      startToCloseTimeout: "1m",
+      ...options
+    },
+    __type: "function"
+  };
+  registry.functions.set(name, def);
+  return def;
+}
+function workflow(name, handler, options = {}) {
+  const def = {
+    name,
+    handler,
+    options: {
+      taskQueue: "default",
+      ...options
+    },
+    __type: "workflow"
+  };
+  registry.workflows.set(name, def);
+  return def;
+}
+var triggers = [];
+function http(method, path, workflow2, options = {}) {
+  triggers.push({
+    type: "http",
+    method: method.toUpperCase(),
+    path,
+    workflow: workflow2,
+    options
+  });
+}
+function cron(schedule, workflow2, options = {}) {
+  triggers.push({
+    type: "cron",
+    schedule,
+    workflow: workflow2,
+    options
+  });
+}
+function interval(duration, workflow2, options = {}) {
+  const cronSchedule = durationToCron(duration);
+  cron(cronSchedule, workflow2, options);
+}
+function signal(signalName, handler) {
+  triggers.push({
+    type: "signal",
+    signalName,
+    handler
+  });
+}
+function durationToCron(duration) {
+  const match = duration.match(/^(\d+)(s|m|h|d)$/);
+  if (!match) {
+    throw new Error(`Invalid duration format: ${duration}. Use format like '5m', '1h', '30s'`);
+  }
+  const value = parseInt(match[1], 10);
+  const unit = match[2];
+  switch (unit) {
+    case "s":
+      if (value < 60) {
+        return `*/${value} * * * * *`;
+      }
+      throw new Error("Seconds interval must be less than 60");
+    case "m":
+      return `*/${value} * * * *`;
+    // Every N minutes
+    case "h":
+      return `0 */${value} * * *`;
+    // Every N hours
+    case "d":
+      return `0 0 */${value} * *`;
+    // Every N days
+    default:
+      throw new Error(`Unknown duration unit: ${unit}`);
+  }
+}
+function isFunction(def) {
+  return def?.__type === "function";
+}
+function isWorkflow(def) {
+  return def?.__type === "workflow";
+}
+var tfn = {
+  /** Define a function (activity) */
+  fn,
+  /** Define a workflow */
+  workflow,
+  /** Define an HTTP trigger */
+  http,
+  /** Define a cron trigger */
+  cron,
+  /** Define an interval trigger */
+  interval,
+  /** Define a signal trigger */
+  signal
+};
+var src_default = tfn;
+
+export { src_default as default, isFunction, isWorkflow, registry, tfn, triggers };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/index.ts"],"names":["workflow"],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Temporal Functions - Main Entry Point\n *\n * This module provides the core API for defining functions and workflows.\n * Import from 'temporal-functions' for function/workflow definitions.\n * Import from 'temporal-functions/client' for triggering workflows.\n * Import from 'temporal-functions/worker' for running workers.\n */\n\nimport type {\n  FunctionDef,\n  FunctionOptions,\n  WorkflowDef,\n  WorkflowOptions,\n  WorkflowHandler,\n  WorkflowContext,\n  Registry,\n  HttpTriggerOptions,\n  CronTriggerOptions,\n} from './types.js';\n\n// =============================================================================\n// Global Registry\n// =============================================================================\n\n/**\n * Global registry for all defined functions and workflows\n */\nexport const registry: Registry = {\n  functions: new Map(),\n  workflows: new Map(),\n};\n\n// =============================================================================\n// Function Definition\n// =============================================================================\n\n/**\n * Define a function (maps to a Temporal Activity)\n *\n * @example\n * ```typescript\n * export const sendEmail = tfn.fn(\n *   'sendEmail',\n *   async (params: EmailParams) => {\n *     return await emailService.send(params);\n *   },\n *   { timeout: '30s', retries: 3 }\n * );\n * ```\n */\nfunction fn<TInput, TOutput>(\n  name: string,\n  handler: (input: TInput) => Promise<TOutput>,\n  options: FunctionOptions = {}\n): FunctionDef<TInput, TOutput> {\n  const def: FunctionDef<TInput, TOutput> = {\n    name,\n    handler,\n    options: {\n      startToCloseTimeout: '1m',\n      ...options,\n    },\n    __type: 'function',\n  };\n\n  registry.functions.set(name, def as FunctionDef);\n  return def;\n}\n\n// =============================================================================\n// Workflow Definition\n// =============================================================================\n\n/**\n * Define a workflow\n *\n * @example\n * ```typescript\n * export const processOrder = tfn.workflow(\n *   'processOrder',\n *   async (ctx, order: Order) => {\n *     const validated = await ctx.run(validateOrder, order);\n *     const paid = await ctx.run(chargePayment, validated);\n *     return { orderId: paid.id, status: 'complete' };\n *   }\n * );\n * ```\n */\nfunction workflow<TInput, TOutput>(\n  name: string,\n  handler: WorkflowHandler<TInput, TOutput>,\n  options: WorkflowOptions = {}\n): WorkflowDef<TInput, TOutput> {\n  const def: WorkflowDef<TInput, TOutput> = {\n    name,\n    handler,\n    options: {\n      taskQueue: 'default',\n      ...options,\n    },\n    __type: 'workflow',\n  };\n\n  registry.workflows.set(name, def as WorkflowDef);\n  return def;\n}\n\n// =============================================================================\n// Trigger Definitions (Declarative)\n// =============================================================================\n\ninterface HttpTriggerDef {\n  type: 'http';\n  method: string;\n  path: string;\n  workflow: WorkflowDef;\n  options: HttpTriggerOptions;\n}\n\ninterface CronTriggerDef {\n  type: 'cron';\n  schedule: string;\n  workflow: WorkflowDef;\n  options: CronTriggerOptions;\n}\n\ninterface SignalTriggerDef {\n  type: 'signal';\n  signalName: string;\n  handler: (payload: unknown) => void | Promise<void>;\n}\n\ntype TriggerDef = HttpTriggerDef | CronTriggerDef | SignalTriggerDef;\n\n/**\n * Registry for trigger definitions\n */\nexport const triggers: TriggerDef[] = [];\n\n/**\n * Define an HTTP trigger for a workflow\n *\n * @example\n * ```typescript\n * tfn.http('POST', '/api/orders', processOrder);\n * ```\n */\nfunction http<TInput, TOutput>(\n  method: string,\n  path: string,\n  workflow: WorkflowDef<TInput, TOutput>,\n  options: HttpTriggerOptions = {}\n): void {\n  triggers.push({\n    type: 'http',\n    method: method.toUpperCase(),\n    path,\n    workflow: workflow as WorkflowDef,\n    options,\n  });\n}\n\n/**\n * Define a cron/scheduled trigger for a workflow\n *\n * @example\n * ```typescript\n * tfn.cron('0 9 * * *', dailyReport); // Every day at 9am\n * ```\n */\nfunction cron<TInput, TOutput>(\n  schedule: string,\n  workflow: WorkflowDef<TInput, TOutput>,\n  options: CronTriggerOptions = {}\n): void {\n  triggers.push({\n    type: 'cron',\n    schedule,\n    workflow: workflow as WorkflowDef,\n    options,\n  });\n}\n\n/**\n * Define an interval trigger (convenience wrapper around cron)\n *\n * @example\n * ```typescript\n * tfn.interval('5m', healthCheck); // Every 5 minutes\n * ```\n */\nfunction interval<TInput, TOutput>(\n  duration: string,\n  workflow: WorkflowDef<TInput, TOutput>,\n  options: CronTriggerOptions = {}\n): void {\n  // Convert duration to cron expression\n  const cronSchedule = durationToCron(duration);\n  cron(cronSchedule, workflow, options);\n}\n\n/**\n * Define a signal trigger\n *\n * @example\n * ```typescript\n * tfn.signal('order.cancel', handleCancellation);\n * ```\n */\nfunction signal(\n  signalName: string,\n  handler: (payload: unknown) => void | Promise<void>\n): void {\n  triggers.push({\n    type: 'signal',\n    signalName,\n    handler,\n  });\n}\n\n// =============================================================================\n// Utilities\n// =============================================================================\n\n/**\n * Convert a duration string to a cron expression\n */\nfunction durationToCron(duration: string): string {\n  const match = duration.match(/^(\\d+)(s|m|h|d)$/);\n  if (!match) {\n    throw new Error(`Invalid duration format: ${duration}. Use format like '5m', '1h', '30s'`);\n  }\n\n  const value = parseInt(match[1], 10);\n  const unit = match[2];\n\n  switch (unit) {\n    case 's':\n      if (value < 60) {\n        return `*/${value} * * * * *`; // Every N seconds (non-standard)\n      }\n      throw new Error('Seconds interval must be less than 60');\n    case 'm':\n      return `*/${value} * * * *`; // Every N minutes\n    case 'h':\n      return `0 */${value} * * *`; // Every N hours\n    case 'd':\n      return `0 0 */${value} * *`; // Every N days\n    default:\n      throw new Error(`Unknown duration unit: ${unit}`);\n  }\n}\n\n/**\n * Check if a definition is a function\n */\nexport function isFunction(def: unknown): def is FunctionDef {\n  return (def as FunctionDef)?.__type === 'function';\n}\n\n/**\n * Check if a definition is a workflow\n */\nexport function isWorkflow(def: unknown): def is WorkflowDef {\n  return (def as WorkflowDef)?.__type === 'workflow';\n}\n\n// =============================================================================\n// Main API Export\n// =============================================================================\n\n/**\n * The main Temporal Functions API\n */\nexport const tfn = {\n  /** Define a function (activity) */\n  fn,\n  /** Define a workflow */\n  workflow,\n  /** Define an HTTP trigger */\n  http,\n  /** Define a cron trigger */\n  cron,\n  /** Define an interval trigger */\n  interval,\n  /** Define a signal trigger */\n  signal,\n};\n\n// Re-export types\nexport type {\n  FunctionDef,\n  FunctionOptions,\n  WorkflowDef,\n  WorkflowOptions,\n  WorkflowContext,\n  WorkflowHandler,\n  WorkflowInfo,\n  RetryPolicy,\n  HttpTriggerOptions,\n  CronTriggerOptions,\n  TemporalConfig,\n  ClientConfig,\n  WorkerConfig,\n  StartWorkflowOptions,\n  WorkflowHandle,\n  TFNClient,\n  TFNWorker,\n} from './types.js';\n\nexport default tfn;\n"]}

package/dist/testing/index.d.mts

@@ -0,0 +1,74 @@
+import { a as FunctionDef, c as WorkflowDef, d as WorkflowContext } from '../types-C-cNq1Id.mjs';
+
+/**
+ * Temporal Functions - Testing Utilities
+ *
+ * Utilities for testing functions and workflows.
+ * Import from 'temporal-functions/testing'.
+ */
+
+/**
+ * Create a mock workflow context for testing
+ */
+declare function createMockContext(overrides?: Partial<WorkflowContext>): WorkflowContext;
+/**
+ * Test environment for running workflows in isolation
+ */
+declare class TestEnvironment {
+    private mocks;
+    private currentTime;
+    /**
+     * Mock a function's implementation
+     */
+    mock<TInput, TOutput>(fn: FunctionDef<TInput, TOutput>, implementation: (input: TInput) => Promise<TOutput> | TOutput): this;
+    /**
+     * Set the current time for the test
+     */
+    setTime(time: Date): this;
+    /**
+     * Execute a workflow with the test environment
+     */
+    execute<TInput, TOutput>(workflow: WorkflowDef<TInput, TOutput>, input: TInput): Promise<TOutput>;
+    /**
+     * Start a workflow and return a handle for interaction
+     */
+    start<TInput, TOutput>(workflow: WorkflowDef<TInput, TOutput>, input: TInput): Promise<TestWorkflowHandle<TOutput>>;
+    /**
+     * Create a workflow context with mocks applied
+     */
+    private createContext;
+}
+/**
+ * Handle to a test workflow execution
+ */
+interface TestWorkflowHandle<TOutput> {
+    /** Wait for the workflow result */
+    result(): Promise<TOutput>;
+    /** Send a signal to the workflow */
+    signal<TPayload>(signalName: string, payload: TPayload): Promise<void>;
+    /** Query the workflow */
+    query<TResult>(queryName: string): TResult;
+}
+/**
+ * Create a test environment
+ *
+ * @example
+ * ```typescript
+ * import { tfn } from 'temporal-functions/testing';
+ *
+ * const env = await tfn.testEnv();
+ *
+ * env.mock(sendEmail, async (params) => ({
+ *   messageId: 'test-id',
+ * }));
+ *
+ * const result = await env.execute(myWorkflow, { data: 'test' });
+ * ```
+ */
+declare function createTestEnv(): Promise<TestEnvironment>;
+declare const tfn: {
+    testEnv: typeof createTestEnv;
+    mockContext: typeof createMockContext;
+};
+
+export { TestEnvironment, type TestWorkflowHandle, createMockContext, createTestEnv, tfn as default, tfn };