@astami/temporal-functions 0.1.0

package/dist/testing/index.d.ts

@@ -0,0 +1,74 @@
+import { a as FunctionDef, c as WorkflowDef, d as WorkflowContext } from '../types-C-cNq1Id.js';
+
+/**
+ * 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 };

package/dist/testing/index.js

@@ -0,0 +1,129 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+// src/testing/index.ts
+function createMockContext(overrides = {}) {
+  const signalHandlers = /* @__PURE__ */ new Map();
+  const queryHandlers = /* @__PURE__ */ new Map();
+  const mockInfo = {
+    workflowId: "test-workflow-id",
+    runId: "test-run-id",
+    taskQueue: "test-queue",
+    workflowType: "test-workflow",
+    namespace: "default"
+  };
+  return {
+    run: async (fn, input) => {
+      return fn.handler(input);
+    },
+    sleep: async () => {
+    },
+    now: () => /* @__PURE__ */ new Date(),
+    startChild: async () => {
+      throw new Error("startChild not implemented in mock context");
+    },
+    continueAsNew: async () => {
+      throw new Error("continueAsNew not implemented in mock context");
+    },
+    onSignal: (signalName, handler) => {
+      signalHandlers.set(signalName, handler);
+    },
+    onQuery: (queryName, handler) => {
+      queryHandlers.set(queryName, handler);
+    },
+    info: mockInfo,
+    ...overrides
+  };
+}
+var TestEnvironment = class {
+  mocks = /* @__PURE__ */ new Map();
+  currentTime = /* @__PURE__ */ new Date();
+  /**
+   * Mock a function's implementation
+   */
+  mock(fn, implementation) {
+    this.mocks.set(fn.name, async (input) => {
+      return implementation(input);
+    });
+    return this;
+  }
+  /**
+   * Set the current time for the test
+   */
+  setTime(time) {
+    this.currentTime = time;
+    return this;
+  }
+  /**
+   * Execute a workflow with the test environment
+   */
+  async execute(workflow, input) {
+    const ctx = this.createContext();
+    return workflow.handler(ctx, input);
+  }
+  /**
+   * Start a workflow and return a handle for interaction
+   */
+  async start(workflow, input) {
+    const signalHandlers = /* @__PURE__ */ new Map();
+    const queryHandlers = /* @__PURE__ */ new Map();
+    const ctx = this.createContext({
+      onSignal: (signalName, handler) => {
+        signalHandlers.set(signalName, handler);
+      },
+      onQuery: (queryName, handler) => {
+        queryHandlers.set(queryName, handler);
+      }
+    });
+    const resultPromise = workflow.handler(ctx, input);
+    return {
+      result: () => resultPromise,
+      signal: async (signalName, payload) => {
+        const handler = signalHandlers.get(signalName);
+        if (handler) {
+          handler(payload);
+        }
+      },
+      query: (queryName) => {
+        const handler = queryHandlers.get(queryName);
+        if (handler) {
+          return handler();
+        }
+        throw new Error(`Query handler not found: ${queryName}`);
+      }
+    };
+  }
+  /**
+   * Create a workflow context with mocks applied
+   */
+  createContext(overrides = {}) {
+    return createMockContext({
+      run: async (fn, input) => {
+        const mock = this.mocks.get(fn.name);
+        if (mock) {
+          return mock(input);
+        }
+        return fn.handler(input);
+      },
+      now: () => this.currentTime,
+      ...overrides
+    });
+  }
+};
+async function createTestEnv() {
+  return new TestEnvironment();
+}
+var tfn = {
+  testEnv: createTestEnv,
+  mockContext: createMockContext
+};
+var testing_default = tfn;
+
+exports.TestEnvironment = TestEnvironment;
+exports.createMockContext = createMockContext;
+exports.createTestEnv = createTestEnv;
+exports.default = testing_default;
+exports.tfn = tfn;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/testing/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts"],"names":[],"mappings":"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","file":"index.js","sourcesContent":["/**\n * Temporal Functions - Testing Utilities\n *\n * Utilities for testing functions and workflows.\n * Import from 'temporal-functions/testing'.\n */\n\nimport type {\n  FunctionDef,\n  WorkflowDef,\n  WorkflowContext,\n  WorkflowInfo,\n} from '../types.js';\n\n// =============================================================================\n// Mock Context\n// =============================================================================\n\n/**\n * Create a mock workflow context for testing\n */\nfunction createMockContext(overrides: Partial<WorkflowContext> = {}): WorkflowContext {\n  const signalHandlers = new Map<string, (payload: unknown) => void>();\n  const queryHandlers = new Map<string, () => unknown>();\n\n  const mockInfo: WorkflowInfo = {\n    workflowId: 'test-workflow-id',\n    runId: 'test-run-id',\n    taskQueue: 'test-queue',\n    workflowType: 'test-workflow',\n    namespace: 'default',\n  };\n\n  return {\n    run: async <TInput, TOutput>(\n      fn: FunctionDef<TInput, TOutput>,\n      input: TInput\n    ): Promise<TOutput> => {\n      return fn.handler(input);\n    },\n    sleep: async () => {\n      // No-op in tests by default\n    },\n    now: () => new Date(),\n    startChild: async () => {\n      throw new Error('startChild not implemented in mock context');\n    },\n    continueAsNew: async () => {\n      throw new Error('continueAsNew not implemented in mock context');\n    },\n    onSignal: <TPayload = unknown>(signalName: string, handler: (payload: TPayload) => void) => {\n      signalHandlers.set(signalName, handler as (payload: unknown) => void);\n    },\n    onQuery: (queryName, handler) => {\n      queryHandlers.set(queryName, handler);\n    },\n    info: mockInfo,\n    ...overrides,\n  };\n}\n\n// =============================================================================\n// Test Environment\n// =============================================================================\n\ninterface MockedFunction<TInput, TOutput> {\n  fn: FunctionDef<TInput, TOutput>;\n  mock: (input: TInput) => Promise<TOutput>;\n}\n\n/**\n * Test environment for running workflows in isolation\n */\nclass TestEnvironment {\n  private mocks: Map<string, (input: unknown) => Promise<unknown>> = new Map();\n  private currentTime: Date = new Date();\n\n  /**\n   * Mock a function's implementation\n   */\n  mock<TInput, TOutput>(\n    fn: FunctionDef<TInput, TOutput>,\n    implementation: (input: TInput) => Promise<TOutput> | TOutput\n  ): this {\n    this.mocks.set(fn.name, async (input: unknown) => {\n      return implementation(input as TInput);\n    });\n    return this;\n  }\n\n  /**\n   * Set the current time for the test\n   */\n  setTime(time: Date): this {\n    this.currentTime = time;\n    return this;\n  }\n\n  /**\n   * Execute a workflow with the test environment\n   */\n  async execute<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput\n  ): Promise<TOutput> {\n    const ctx = this.createContext();\n    return workflow.handler(ctx, input);\n  }\n\n  /**\n   * Start a workflow and return a handle for interaction\n   */\n  async start<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput\n  ): Promise<TestWorkflowHandle<TOutput>> {\n    const signalHandlers = new Map<string, (payload: unknown) => void>();\n    const queryHandlers = new Map<string, () => unknown>();\n\n    const ctx = this.createContext({\n      onSignal: <TPayload = unknown>(signalName: string, handler: (payload: TPayload) => void) => {\n        signalHandlers.set(signalName, handler as (payload: unknown) => void);\n      },\n      onQuery: (queryName, handler) => {\n        queryHandlers.set(queryName, handler);\n      },\n    });\n\n    const resultPromise = workflow.handler(ctx, input);\n\n    return {\n      result: () => resultPromise,\n      signal: async <TPayload>(signalName: string, payload: TPayload) => {\n        const handler = signalHandlers.get(signalName);\n        if (handler) {\n          handler(payload);\n        }\n      },\n      query: <TResult>(queryName: string): TResult => {\n        const handler = queryHandlers.get(queryName);\n        if (handler) {\n          return handler() as TResult;\n        }\n        throw new Error(`Query handler not found: ${queryName}`);\n      },\n    };\n  }\n\n  /**\n   * Create a workflow context with mocks applied\n   */\n  private createContext(overrides: Partial<WorkflowContext> = {}): WorkflowContext {\n    return createMockContext({\n      run: async <TInput, TOutput>(\n        fn: FunctionDef<TInput, TOutput>,\n        input: TInput\n      ): Promise<TOutput> => {\n        const mock = this.mocks.get(fn.name);\n        if (mock) {\n          return mock(input) as Promise<TOutput>;\n        }\n        // Fall back to actual implementation\n        return fn.handler(input);\n      },\n      now: () => this.currentTime,\n      ...overrides,\n    });\n  }\n}\n\n/**\n * Handle to a test workflow execution\n */\ninterface TestWorkflowHandle<TOutput> {\n  /** Wait for the workflow result */\n  result(): Promise<TOutput>;\n  /** Send a signal to the workflow */\n  signal<TPayload>(signalName: string, payload: TPayload): Promise<void>;\n  /** Query the workflow */\n  query<TResult>(queryName: string): TResult;\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Create a test environment\n *\n * @example\n * ```typescript\n * import { tfn } from 'temporal-functions/testing';\n *\n * const env = await tfn.testEnv();\n *\n * env.mock(sendEmail, async (params) => ({\n *   messageId: 'test-id',\n * }));\n *\n * const result = await env.execute(myWorkflow, { data: 'test' });\n * ```\n */\nasync function createTestEnv(): Promise<TestEnvironment> {\n  return new TestEnvironment();\n}\n\n// =============================================================================\n// Export\n// =============================================================================\n\nexport const tfn = {\n  testEnv: createTestEnv,\n  mockContext: createMockContext,\n};\n\nexport { createTestEnv, createMockContext, TestEnvironment };\nexport type { TestWorkflowHandle };\nexport default tfn;\n"]}

package/dist/testing/index.mjs

@@ -0,0 +1,121 @@
+// src/testing/index.ts
+function createMockContext(overrides = {}) {
+  const signalHandlers = /* @__PURE__ */ new Map();
+  const queryHandlers = /* @__PURE__ */ new Map();
+  const mockInfo = {
+    workflowId: "test-workflow-id",
+    runId: "test-run-id",
+    taskQueue: "test-queue",
+    workflowType: "test-workflow",
+    namespace: "default"
+  };
+  return {
+    run: async (fn, input) => {
+      return fn.handler(input);
+    },
+    sleep: async () => {
+    },
+    now: () => /* @__PURE__ */ new Date(),
+    startChild: async () => {
+      throw new Error("startChild not implemented in mock context");
+    },
+    continueAsNew: async () => {
+      throw new Error("continueAsNew not implemented in mock context");
+    },
+    onSignal: (signalName, handler) => {
+      signalHandlers.set(signalName, handler);
+    },
+    onQuery: (queryName, handler) => {
+      queryHandlers.set(queryName, handler);
+    },
+    info: mockInfo,
+    ...overrides
+  };
+}
+var TestEnvironment = class {
+  mocks = /* @__PURE__ */ new Map();
+  currentTime = /* @__PURE__ */ new Date();
+  /**
+   * Mock a function's implementation
+   */
+  mock(fn, implementation) {
+    this.mocks.set(fn.name, async (input) => {
+      return implementation(input);
+    });
+    return this;
+  }
+  /**
+   * Set the current time for the test
+   */
+  setTime(time) {
+    this.currentTime = time;
+    return this;
+  }
+  /**
+   * Execute a workflow with the test environment
+   */
+  async execute(workflow, input) {
+    const ctx = this.createContext();
+    return workflow.handler(ctx, input);
+  }
+  /**
+   * Start a workflow and return a handle for interaction
+   */
+  async start(workflow, input) {
+    const signalHandlers = /* @__PURE__ */ new Map();
+    const queryHandlers = /* @__PURE__ */ new Map();
+    const ctx = this.createContext({
+      onSignal: (signalName, handler) => {
+        signalHandlers.set(signalName, handler);
+      },
+      onQuery: (queryName, handler) => {
+        queryHandlers.set(queryName, handler);
+      }
+    });
+    const resultPromise = workflow.handler(ctx, input);
+    return {
+      result: () => resultPromise,
+      signal: async (signalName, payload) => {
+        const handler = signalHandlers.get(signalName);
+        if (handler) {
+          handler(payload);
+        }
+      },
+      query: (queryName) => {
+        const handler = queryHandlers.get(queryName);
+        if (handler) {
+          return handler();
+        }
+        throw new Error(`Query handler not found: ${queryName}`);
+      }
+    };
+  }
+  /**
+   * Create a workflow context with mocks applied
+   */
+  createContext(overrides = {}) {
+    return createMockContext({
+      run: async (fn, input) => {
+        const mock = this.mocks.get(fn.name);
+        if (mock) {
+          return mock(input);
+        }
+        return fn.handler(input);
+      },
+      now: () => this.currentTime,
+      ...overrides
+    });
+  }
+};
+async function createTestEnv() {
+  return new TestEnvironment();
+}
+var tfn = {
+  testEnv: createTestEnv,
+  mockContext: createMockContext
+};
+var testing_default = tfn;
+
+export { TestEnvironment, createMockContext, createTestEnv, testing_default as default, tfn };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/testing/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/testing/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Temporal Functions - Testing Utilities\n *\n * Utilities for testing functions and workflows.\n * Import from 'temporal-functions/testing'.\n */\n\nimport type {\n  FunctionDef,\n  WorkflowDef,\n  WorkflowContext,\n  WorkflowInfo,\n} from '../types.js';\n\n// =============================================================================\n// Mock Context\n// =============================================================================\n\n/**\n * Create a mock workflow context for testing\n */\nfunction createMockContext(overrides: Partial<WorkflowContext> = {}): WorkflowContext {\n  const signalHandlers = new Map<string, (payload: unknown) => void>();\n  const queryHandlers = new Map<string, () => unknown>();\n\n  const mockInfo: WorkflowInfo = {\n    workflowId: 'test-workflow-id',\n    runId: 'test-run-id',\n    taskQueue: 'test-queue',\n    workflowType: 'test-workflow',\n    namespace: 'default',\n  };\n\n  return {\n    run: async <TInput, TOutput>(\n      fn: FunctionDef<TInput, TOutput>,\n      input: TInput\n    ): Promise<TOutput> => {\n      return fn.handler(input);\n    },\n    sleep: async () => {\n      // No-op in tests by default\n    },\n    now: () => new Date(),\n    startChild: async () => {\n      throw new Error('startChild not implemented in mock context');\n    },\n    continueAsNew: async () => {\n      throw new Error('continueAsNew not implemented in mock context');\n    },\n    onSignal: <TPayload = unknown>(signalName: string, handler: (payload: TPayload) => void) => {\n      signalHandlers.set(signalName, handler as (payload: unknown) => void);\n    },\n    onQuery: (queryName, handler) => {\n      queryHandlers.set(queryName, handler);\n    },\n    info: mockInfo,\n    ...overrides,\n  };\n}\n\n// =============================================================================\n// Test Environment\n// =============================================================================\n\ninterface MockedFunction<TInput, TOutput> {\n  fn: FunctionDef<TInput, TOutput>;\n  mock: (input: TInput) => Promise<TOutput>;\n}\n\n/**\n * Test environment for running workflows in isolation\n */\nclass TestEnvironment {\n  private mocks: Map<string, (input: unknown) => Promise<unknown>> = new Map();\n  private currentTime: Date = new Date();\n\n  /**\n   * Mock a function's implementation\n   */\n  mock<TInput, TOutput>(\n    fn: FunctionDef<TInput, TOutput>,\n    implementation: (input: TInput) => Promise<TOutput> | TOutput\n  ): this {\n    this.mocks.set(fn.name, async (input: unknown) => {\n      return implementation(input as TInput);\n    });\n    return this;\n  }\n\n  /**\n   * Set the current time for the test\n   */\n  setTime(time: Date): this {\n    this.currentTime = time;\n    return this;\n  }\n\n  /**\n   * Execute a workflow with the test environment\n   */\n  async execute<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput\n  ): Promise<TOutput> {\n    const ctx = this.createContext();\n    return workflow.handler(ctx, input);\n  }\n\n  /**\n   * Start a workflow and return a handle for interaction\n   */\n  async start<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput\n  ): Promise<TestWorkflowHandle<TOutput>> {\n    const signalHandlers = new Map<string, (payload: unknown) => void>();\n    const queryHandlers = new Map<string, () => unknown>();\n\n    const ctx = this.createContext({\n      onSignal: <TPayload = unknown>(signalName: string, handler: (payload: TPayload) => void) => {\n        signalHandlers.set(signalName, handler as (payload: unknown) => void);\n      },\n      onQuery: (queryName, handler) => {\n        queryHandlers.set(queryName, handler);\n      },\n    });\n\n    const resultPromise = workflow.handler(ctx, input);\n\n    return {\n      result: () => resultPromise,\n      signal: async <TPayload>(signalName: string, payload: TPayload) => {\n        const handler = signalHandlers.get(signalName);\n        if (handler) {\n          handler(payload);\n        }\n      },\n      query: <TResult>(queryName: string): TResult => {\n        const handler = queryHandlers.get(queryName);\n        if (handler) {\n          return handler() as TResult;\n        }\n        throw new Error(`Query handler not found: ${queryName}`);\n      },\n    };\n  }\n\n  /**\n   * Create a workflow context with mocks applied\n   */\n  private createContext(overrides: Partial<WorkflowContext> = {}): WorkflowContext {\n    return createMockContext({\n      run: async <TInput, TOutput>(\n        fn: FunctionDef<TInput, TOutput>,\n        input: TInput\n      ): Promise<TOutput> => {\n        const mock = this.mocks.get(fn.name);\n        if (mock) {\n          return mock(input) as Promise<TOutput>;\n        }\n        // Fall back to actual implementation\n        return fn.handler(input);\n      },\n      now: () => this.currentTime,\n      ...overrides,\n    });\n  }\n}\n\n/**\n * Handle to a test workflow execution\n */\ninterface TestWorkflowHandle<TOutput> {\n  /** Wait for the workflow result */\n  result(): Promise<TOutput>;\n  /** Send a signal to the workflow */\n  signal<TPayload>(signalName: string, payload: TPayload): Promise<void>;\n  /** Query the workflow */\n  query<TResult>(queryName: string): TResult;\n}\n\n// =============================================================================\n// Factory Functions\n// =============================================================================\n\n/**\n * Create a test environment\n *\n * @example\n * ```typescript\n * import { tfn } from 'temporal-functions/testing';\n *\n * const env = await tfn.testEnv();\n *\n * env.mock(sendEmail, async (params) => ({\n *   messageId: 'test-id',\n * }));\n *\n * const result = await env.execute(myWorkflow, { data: 'test' });\n * ```\n */\nasync function createTestEnv(): Promise<TestEnvironment> {\n  return new TestEnvironment();\n}\n\n// =============================================================================\n// Export\n// =============================================================================\n\nexport const tfn = {\n  testEnv: createTestEnv,\n  mockContext: createMockContext,\n};\n\nexport { createTestEnv, createMockContext, TestEnvironment };\nexport type { TestWorkflowHandle };\nexport default tfn;\n"]}

package/dist/types-C-cNq1Id.d.mts

@@ -0,0 +1,292 @@
+/**
+ * Core type definitions for Temporal Functions
+ */
+/**
+ * Options for configuring a function (activity)
+ */
+interface FunctionOptions {
+    /** Start-to-close timeout (e.g., '30s', '5m') */
+    startToCloseTimeout?: string;
+    /** Schedule-to-close timeout */
+    scheduleToCloseTimeout?: string;
+    /** Heartbeat timeout for long-running activities */
+    heartbeatTimeout?: string;
+    /** Retry policy configuration */
+    retry?: RetryPolicy;
+}
+/**
+ * Retry policy for functions
+ */
+interface RetryPolicy {
+    /** Maximum number of retry attempts */
+    maximumAttempts?: number;
+    /** Initial retry interval (e.g., '1s') */
+    initialInterval?: string;
+    /** Maximum retry interval (e.g., '30s') */
+    maximumInterval?: string;
+    /** Backoff coefficient for exponential backoff */
+    backoffCoefficient?: number;
+    /** List of error types that should not be retried */
+    nonRetryableErrorTypes?: string[];
+}
+/**
+ * Definition of a function (maps to Temporal Activity)
+ */
+interface FunctionDef<TInput = unknown, TOutput = unknown> {
+    /** Unique identifier for the function */
+    name: string;
+    /** The function implementation */
+    handler: (input: TInput) => Promise<TOutput>;
+    /** Configuration options */
+    options: FunctionOptions;
+    /** Type marker */
+    __type: 'function';
+}
+/**
+ * Options for configuring a workflow
+ */
+interface WorkflowOptions {
+    /** Task queue for this workflow (defaults to 'default') */
+    taskQueue?: string;
+    /** Workflow execution timeout */
+    workflowExecutionTimeout?: string;
+    /** Workflow run timeout */
+    workflowRunTimeout?: string;
+    /** Workflow task timeout */
+    workflowTaskTimeout?: string;
+    /** Retry policy for the workflow */
+    retry?: RetryPolicy;
+}
+/**
+ * Workflow information available at runtime
+ */
+interface WorkflowInfo {
+    /** Unique workflow ID */
+    workflowId: string;
+    /** Current run ID */
+    runId: string;
+    /** Task queue the workflow is running on */
+    taskQueue: string;
+    /** Workflow type name */
+    workflowType: string;
+    /** Namespace */
+    namespace: string;
+}
+/**
+ * Context object passed to workflow functions
+ */
+interface WorkflowContext {
+    /**
+     * Run a function (activity) within the workflow
+     */
+    run<TInput, TOutput>(fn: FunctionDef<TInput, TOutput>, input: TInput, options?: Partial<FunctionOptions>): Promise<TOutput>;
+    /**
+     * Sleep for a duration
+     * @param duration - Duration string (e.g., '5m', '1h') or milliseconds
+     */
+    sleep(duration: string | number): Promise<void>;
+    /**
+     * Get the current workflow time (deterministic)
+     */
+    now(): Date;
+    /**
+     * Start a child workflow
+     */
+    startChild<TInput, TOutput>(workflow: WorkflowDef<TInput, TOutput>, input: TInput, options?: ChildWorkflowOptions): Promise<TOutput>;
+    /**
+     * Continue as new with fresh history
+     */
+    continueAsNew<TInput>(input: TInput): Promise<never>;
+    /**
+     * Register a signal handler
+     */
+    onSignal<TPayload = unknown>(signalName: string, handler: (payload: TPayload) => void): void;
+    /**
+     * Register a query handler
+     */
+    onQuery<TResult = unknown>(queryName: string, handler: () => TResult): void;
+    /**
+     * Workflow information
+     */
+    readonly info: WorkflowInfo;
+}
+/**
+ * Options for child workflows
+ */
+interface ChildWorkflowOptions {
+    workflowId?: string;
+    taskQueue?: string;
+    workflowExecutionTimeout?: string;
+}
+/**
+ * Workflow handler function type
+ */
+type WorkflowHandler<TInput = unknown, TOutput = unknown> = (ctx: WorkflowContext, input: TInput) => Promise<TOutput>;
+/**
+ * Definition of a workflow
+ */
+interface WorkflowDef<TInput = unknown, TOutput = unknown> {
+    /** Unique identifier for the workflow */
+    name: string;
+    /** The workflow implementation */
+    handler: WorkflowHandler<TInput, TOutput>;
+    /** Configuration options */
+    options: WorkflowOptions;
+    /** Type marker */
+    __type: 'workflow';
+}
+/**
+ * Temporal connection configuration
+ */
+interface TemporalConfig {
+    /** Temporal server address (e.g., 'localhost:7233') */
+    address: string;
+    /** Namespace to use */
+    namespace?: string;
+    /** TLS configuration */
+    tls?: TLSConfig;
+}
+/**
+ * TLS configuration for secure connections
+ */
+interface TLSConfig {
+    /** Path to client certificate */
+    clientCertPath?: string;
+    /** Path to client key */
+    clientKeyPath?: string;
+    /** Path to CA certificate */
+    serverRootCACertPath?: string;
+}
+/**
+ * Client configuration options
+ */
+interface ClientConfig {
+    /** Temporal connection settings */
+    temporal: TemporalConfig;
+    /** Default task queue for workflows */
+    taskQueue?: string;
+}
+/**
+ * Options when starting a workflow
+ */
+interface StartWorkflowOptions {
+    /** Custom workflow ID (for idempotency) */
+    workflowId?: string;
+    /** Override the default task queue */
+    taskQueue?: string;
+    /** Workflow execution timeout */
+    workflowExecutionTimeout?: string;
+    /** Memo fields */
+    memo?: Record<string, unknown>;
+    /** Search attributes */
+    searchAttributes?: Record<string, unknown>;
+}
+/**
+ * Handle to a running workflow
+ */
+interface WorkflowHandle<TOutput = unknown> {
+    /** The workflow ID */
+    workflowId: string;
+    /** The run ID */
+    runId: string;
+    /** Wait for the workflow result */
+    result(): Promise<TOutput>;
+    /** Query the workflow */
+    query<TResult = unknown>(queryName: string): Promise<TResult>;
+    /** Signal the workflow */
+    signal<TPayload = unknown>(signalName: string, payload: TPayload): Promise<void>;
+    /** Cancel the workflow */
+    cancel(): Promise<void>;
+    /** Terminate the workflow */
+    terminate(reason?: string): Promise<void>;
+}
+/**
+ * Temporal Functions client interface
+ */
+interface TFNClient {
+    /**
+     * Start a workflow and wait for the result
+     */
+    invoke<TInput, TOutput>(workflow: WorkflowDef<TInput, TOutput>, input: TInput, options?: StartWorkflowOptions): Promise<TOutput>;
+    /**
+     * Start a workflow without waiting (fire and forget)
+     */
+    start<TInput, TOutput>(workflow: WorkflowDef<TInput, TOutput>, input: TInput, options?: StartWorkflowOptions): Promise<WorkflowHandle<TOutput>>;
+    /**
+     * Get a handle to an existing workflow
+     */
+    getHandle<TOutput = unknown>(workflowId: string): WorkflowHandle<TOutput>;
+    /**
+     * Signal an existing workflow
+     */
+    signal<TPayload = unknown>(workflowId: string, signalName: string, payload: TPayload): Promise<void>;
+    /**
+     * Query an existing workflow
+     */
+    query<TResult = unknown>(workflowId: string, queryName: string): Promise<TResult>;
+}
+/**
+ * Worker configuration options
+ */
+interface WorkerConfig {
+    /** Temporal connection settings */
+    temporal: TemporalConfig;
+    /** Task queue to poll */
+    taskQueue: string;
+    /** Maximum concurrent activity executions */
+    maxConcurrentActivities?: number;
+    /** Maximum concurrent workflow executions */
+    maxConcurrentWorkflows?: number;
+    /** Enable sticky execution (default: true) */
+    enableStickyExecution?: boolean;
+}
+/**
+ * Temporal Functions worker interface
+ */
+interface TFNWorker {
+    /**
+     * Register a function or workflow
+     */
+    register(def: FunctionDef | WorkflowDef): void;
+    /**
+     * Register all exports from a module
+     */
+    registerModule(module: Record<string, unknown>): void;
+    /**
+     * Start the worker (blocks until shutdown)
+     */
+    start(): Promise<void>;
+    /**
+     * Gracefully shutdown the worker
+     */
+    shutdown(): Promise<void>;
+}
+/**
+ * HTTP trigger configuration
+ */
+interface HttpTriggerOptions {
+    /** Custom workflow ID generator */
+    workflowId?: (req: unknown) => string;
+    /** Return immediately without waiting for result */
+    async?: boolean;
+    /** Middleware functions */
+    middleware?: Array<(req: unknown, res: unknown, next: () => void) => void>;
+}
+/**
+ * Cron trigger configuration
+ */
+interface CronTriggerOptions {
+    /** Prevent overlapping executions */
+    overlap?: boolean;
+    /** Timezone for cron schedule */
+    timezone?: string;
+}
+/**
+ * Internal registry for functions and workflows
+ */
+interface Registry {
+    functions: Map<string, FunctionDef>;
+    workflows: Map<string, WorkflowDef>;
+}
+
+export type { CronTriggerOptions as C, FunctionOptions as F, HttpTriggerOptions as H, Registry as R, StartWorkflowOptions as S, TemporalConfig as T, WorkflowHandler as W, FunctionDef as a, WorkflowOptions as b, WorkflowDef as c, WorkflowContext as d, WorkflowInfo as e, RetryPolicy as f, ClientConfig as g, WorkerConfig as h, WorkflowHandle as i, TFNClient as j, TFNWorker as k };