@astami/temporal-functions 0.1.0

package/README.md

@@ -0,0 +1,215 @@
+# Temporal Functions
+
+A lightweight TypeScript framework that provides a **lambda-like developer experience** on top of **Temporal's durable execution engine**.
+
+Write only function bodies and trigger bindings — the framework handles all Temporal boilerplate (workers, activities, workflows, serialization).
+
+## Why Temporal Functions?
+
+| Aspect | Lambda/Serverless | Raw Temporal | Temporal Functions |
+|--------|-------------------|--------------|-------------------|
+| Function definition | Simple | Verbose | Simple |
+| Durable execution | No | Yes | Yes |
+| Retries/timeouts | Limited | Powerful | Powerful |
+| Worker management | Managed | Manual | Abstracted |
+| Type safety | Varies | Yes | Yes |
+
+## Quick Example
+
+```typescript
+import { tfn } from 'temporal-functions';
+
+// Define functions (activities)
+export const validateOrder = tfn.fn('validateOrder', async (order: Order) => {
+  // validation logic
+});
+
+export const chargePayment = tfn.fn('chargePayment', async (order: ValidatedOrder) => {
+  // payment logic
+});
+
+// Define workflow
+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' };
+});
+```
+
+**That's it.** No worker setup, no activity proxies, no boilerplate.
+
+## Key Principles
+
+1. **Lambda-like DX** — Write functions, not infrastructure
+2. **Temporal underneath** — Get durability, retries, exactly-once semantics for free
+3. **TypeScript native** — Full type safety, great IDE support
+4. **Client-Worker separation** — Scale triggers and executors independently
+5. **Minimal abstraction** — Thin layer, not a new platform
+
+## Installation
+
+```bash
+npm install temporal-functions
+```
+
+## Usage
+
+### Define Functions
+
+```typescript
+import { tfn } from 'temporal-functions';
+
+export const sendEmail = tfn.fn(
+  'sendEmail',
+  async (params: EmailParams): Promise<EmailResult> => {
+    return await emailService.send(params);
+  },
+  {
+    timeout: '30s',
+    retries: 3,
+  }
+);
+```
+
+### Define Workflows
+
+```typescript
+export const processOrder = tfn.workflow(
+  'processOrder',
+  async (ctx, order: Order) => {
+    const validated = await ctx.run(validateOrder, order);
+
+    // Parallel execution
+    const [inventory, pricing] = await Promise.all([
+      ctx.run(checkInventory, validated.items),
+      ctx.run(calculatePricing, validated.items),
+    ]);
+
+    // Durable sleep
+    await ctx.sleep('5 minutes');
+
+    const payment = await ctx.run(processPayment, {
+      amount: pricing.total,
+      orderId: order.id,
+    });
+
+    return { orderId: order.id, status: 'complete' };
+  }
+);
+```
+
+### Client (Trigger Workflows)
+
+```typescript
+import { tfn } from 'temporal-functions/client';
+import { processOrder } from '@myproject/functions';
+
+const client = tfn.client({
+  temporal: {
+    address: 'localhost:7233',
+    namespace: 'default',
+  },
+  taskQueue: 'orders',
+});
+
+// Fire and wait
+const result = await client.invoke(processOrder, order);
+
+// Fire and forget
+const handle = await client.start(processOrder, order, {
+  workflowId: `order-${order.id}`,
+});
+```
+
+### Worker (Execute Functions)
+
+```typescript
+import { tfn } from 'temporal-functions/worker';
+import { validateOrder, chargePayment, processOrder } from '@myproject/functions';
+
+const worker = tfn.worker({
+  temporal: {
+    address: 'localhost:7233',
+    namespace: 'default',
+  },
+  taskQueue: 'orders',
+});
+
+worker.register(validateOrder);
+worker.register(chargePayment);
+worker.register(processOrder);
+
+await worker.start();
+```
+
+## Triggers
+
+```typescript
+// HTTP
+tfn.http('POST', '/api/orders', processOrder);
+
+// Cron
+tfn.cron('0 9 * * *', dailyReport);
+
+// Signal
+tfn.signal('order.cancel', handleCancellation);
+```
+
+## Project Structure
+
+```
+my-project/
+├── packages/
+│   ├── functions/          # Shared function definitions
+│   │   └── src/
+│   │       ├── orders/
+│   │       └── notifications/
+│   ├── worker/             # Worker service
+│   │   └── src/index.ts
+│   └── api/                # API/Client service
+│       └── src/index.ts
+└── package.json
+```
+
+## Architecture
+
+```
+┌─────────────────────────────────────────────────────────────┐
+│                    TEMPORAL FUNCTIONS                        │
+├─────────────────────────────────────────────────────────────┤
+│                                                              │
+│   SHARED: Function Definitions                               │
+│   tfn.fn()    tfn.workflow()    Types & Interfaces          │
+│                                                              │
+│        │                              │                      │
+│        ▼                              ▼                      │
+│   ┌──────────────┐            ┌──────────────┐              │
+│   │    CLIENT    │            │    WORKER    │              │
+│   │  Lightweight │            │   Full SDK   │              │
+│   │    ~20KB     │            │    ~2MB      │              │
+│   │              │            │              │              │
+│   │  • start()   │            │  • register()│              │
+│   │  • invoke()  │            │  • start()   │              │
+│   │  • signal()  │            │              │              │
+│   └──────┬───────┘            └──────┬───────┘              │
+│          │                           │                       │
+│          └───────────┬───────────────┘                       │
+│                      ▼                                       │
+│            ┌─────────────────┐                               │
+│            │ TEMPORAL CLUSTER │                               │
+│            └─────────────────┘                               │
+│                                                              │
+└─────────────────────────────────────────────────────────────┘
+```
+
+## Documentation
+
+See [docs/ARCHITECTURE.md](docs/ARCHITECTURE.md) for the full architecture document.
+
+## Status
+
+**Design Phase** — This project is currently in the design and early implementation phase.
+
+## License
+
+MIT

package/dist/client/index.d.mts

@@ -0,0 +1,34 @@
+import { g as ClientConfig, j as TFNClient } from '../types-C-cNq1Id.mjs';
+export { S as StartWorkflowOptions, i as WorkflowHandle } from '../types-C-cNq1Id.mjs';
+
+/**
+ * Temporal Functions - Client Package
+ *
+ * Lightweight client for triggering workflows.
+ * Import from 'temporal-functions/client'.
+ */
+
+/**
+ * Create a Temporal Functions client
+ *
+ * @example
+ * ```typescript
+ * import { tfn } from 'temporal-functions/client';
+ *
+ * const client = tfn.client({
+ *   temporal: {
+ *     address: 'localhost:7233',
+ *     namespace: 'default',
+ *   },
+ *   taskQueue: 'my-queue',
+ * });
+ *
+ * const result = await client.invoke(myWorkflow, { data: 'hello' });
+ * ```
+ */
+declare function createClient(config: ClientConfig): TFNClient;
+declare const tfn: {
+    client: typeof createClient;
+};
+
+export { ClientConfig, TFNClient, createClient, tfn as default, tfn };

package/dist/client/index.d.ts

@@ -0,0 +1,34 @@
+import { g as ClientConfig, j as TFNClient } from '../types-C-cNq1Id.js';
+export { S as StartWorkflowOptions, i as WorkflowHandle } from '../types-C-cNq1Id.js';
+
+/**
+ * Temporal Functions - Client Package
+ *
+ * Lightweight client for triggering workflows.
+ * Import from 'temporal-functions/client'.
+ */
+
+/**
+ * Create a Temporal Functions client
+ *
+ * @example
+ * ```typescript
+ * import { tfn } from 'temporal-functions/client';
+ *
+ * const client = tfn.client({
+ *   temporal: {
+ *     address: 'localhost:7233',
+ *     namespace: 'default',
+ *   },
+ *   taskQueue: 'my-queue',
+ * });
+ *
+ * const result = await client.invoke(myWorkflow, { data: 'hello' });
+ * ```
+ */
+declare function createClient(config: ClientConfig): TFNClient;
+declare const tfn: {
+    client: typeof createClient;
+};
+
+export { ClientConfig, TFNClient, createClient, tfn as default, tfn };

package/dist/client/index.js

@@ -0,0 +1,168 @@
+'use strict';
+
+Object.defineProperty(exports, '__esModule', { value: true });
+
+var client = require('@temporalio/client');
+
+// src/client/index.ts
+var TemporalFunctionsClient = class {
+  client = null;
+  config;
+  connectionPromise = null;
+  constructor(config) {
+    this.config = {
+      ...config,
+      temporal: {
+        namespace: "default",
+        ...config.temporal
+      },
+      taskQueue: config.taskQueue || "default"
+    };
+  }
+  /**
+   * Lazily connect to Temporal
+   */
+  async getClient() {
+    if (this.client) {
+      return this.client;
+    }
+    if (this.connectionPromise) {
+      return this.connectionPromise;
+    }
+    this.connectionPromise = (async () => {
+      const connection = await client.Connection.connect({
+        address: this.config.temporal.address,
+        tls: this.config.temporal.tls ? {
+          clientCertPair: this.config.temporal.tls.clientCertPath ? {
+            crt: await import('fs').then(
+              (fs) => fs.promises.readFile(this.config.temporal.tls.clientCertPath)
+            ),
+            key: await import('fs').then(
+              (fs) => fs.promises.readFile(this.config.temporal.tls.clientKeyPath)
+            )
+          } : void 0
+        } : void 0
+      });
+      this.client = new client.Client({
+        connection,
+        namespace: this.config.temporal.namespace
+      });
+      return this.client;
+    })();
+    return this.connectionPromise;
+  }
+  /**
+   * Generate a workflow ID if not provided
+   */
+  generateWorkflowId(workflowName) {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${workflowName}-${timestamp}-${random}`;
+  }
+  /**
+   * Start a workflow and wait for the result
+   */
+  async invoke(workflow, input, options = {}) {
+    const handle = await this.start(workflow, input, options);
+    return handle.result();
+  }
+  /**
+   * Start a workflow without waiting (fire and forget)
+   */
+  async start(workflow, input, options = {}) {
+    const client = await this.getClient();
+    const workflowId = options.workflowId || this.generateWorkflowId(workflow.name);
+    const taskQueue = options.taskQueue || workflow.options.taskQueue || this.config.taskQueue || "default";
+    const handle = await client.workflow.start(workflow.name, {
+      workflowId,
+      taskQueue,
+      args: [input],
+      workflowExecutionTimeout: options.workflowExecutionTimeout,
+      memo: options.memo
+      // searchAttributes requires specific types, omit for now if not properly typed
+    });
+    return this.wrapHandle(handle);
+  }
+  /**
+   * Get a handle to an existing workflow
+   */
+  getHandle(workflowId) {
+    return {
+      workflowId,
+      runId: "",
+      // Will be populated when we fetch
+      result: async () => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        return handle.result();
+      },
+      query: async (queryName) => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        return handle.query(queryName);
+      },
+      signal: async (signalName, payload) => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        await handle.signal(signalName, payload);
+      },
+      cancel: async () => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        await handle.cancel();
+      },
+      terminate: async (reason) => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        await handle.terminate(reason);
+      }
+    };
+  }
+  /**
+   * Signal an existing workflow
+   */
+  async signal(workflowId, signalName, payload) {
+    const client = await this.getClient();
+    const handle = client.workflow.getHandle(workflowId);
+    await handle.signal(signalName, payload);
+  }
+  /**
+   * Query an existing workflow
+   */
+  async query(workflowId, queryName) {
+    const client = await this.getClient();
+    const handle = client.workflow.getHandle(workflowId);
+    return handle.query(queryName);
+  }
+  /**
+   * Wrap a Temporal workflow handle in our interface
+   */
+  wrapHandle(handle) {
+    return {
+      workflowId: handle.workflowId,
+      runId: handle.firstExecutionRunId,
+      result: () => handle.result(),
+      query: (queryName) => handle.query(queryName),
+      signal: (signalName, payload) => handle.signal(signalName, payload),
+      cancel: async () => {
+        await handle.cancel();
+      },
+      terminate: async (reason) => {
+        await handle.terminate(reason);
+      }
+    };
+  }
+};
+function createClient(config) {
+  return new TemporalFunctionsClient(config);
+}
+var tfn = {
+  client: createClient
+};
+var client_default = tfn;
+
+exports.createClient = createClient;
+exports.default = client_default;
+exports.tfn = tfn;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/index.ts"],"names":["Connection","Client"],"mappings":";;;;;;;AAoBA,IAAM,0BAAN,MAAmD;AAAA,EACzC,MAAA,GAAwB,IAAA;AAAA,EACxB,MAAA;AAAA,EACA,iBAAA,GAA4C,IAAA;AAAA,EAEpD,YAAY,MAAA,EAAsB;AAChC,IAAA,IAAA,CAAK,MAAA,GAAS;AAAA,MACZ,GAAG,MAAA;AAAA,MACH,QAAA,EAAU;AAAA,QACR,SAAA,EAAW,SAAA;AAAA,QACX,GAAG,MAAA,CAAO;AAAA,OACZ;AAAA,MACA,SAAA,EAAW,OAAO,SAAA,IAAa;AAAA,KACjC;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAc,SAAA,GAA6B;AACzC,IAAA,IAAI,KAAK,MAAA,EAAQ;AACf,MAAA,OAAO,IAAA,CAAK,MAAA;AAAA,IACd;AAEA,IAAA,IAAI,KAAK,iBAAA,EAAmB;AAC1B,MAAA,OAAO,IAAA,CAAK,iBAAA;AAAA,IACd;AAEA,IAAA,IAAA,CAAK,qBAAqB,YAAY;AACpC,MAAA,MAAM,UAAA,GAAa,MAAMA,iBAAA,CAAW,OAAA,CAAQ;AAAA,QAC1C,OAAA,EAAS,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,OAAA;AAAA,QAC9B,GAAA,EAAK,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,GAAA,GACtB;AAAA,UACE,cAAA,EAAgB,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,IAAI,cAAA,GACrC;AAAA,YACE,GAAA,EAAK,MAAM,OAAO,IAAI,CAAA,CAAE,IAAA;AAAA,cAAK,CAAC,OAC5B,EAAA,CAAG,QAAA,CAAS,SAAS,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,GAAA,CAAK,cAAe;AAAA,aAChE;AAAA,YACA,GAAA,EAAK,MAAM,OAAO,IAAI,CAAA,CAAE,IAAA;AAAA,cAAK,CAAC,OAC5B,EAAA,CAAG,QAAA,CAAS,SAAS,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS,GAAA,CAAK,aAAc;AAAA;AAC/D,WACF,GACA;AAAA,SACN,GACA;AAAA,OACL,CAAA;AAED,MAAA,IAAA,CAAK,MAAA,GAAS,IAAIC,aAAA,CAAO;AAAA,QACvB,UAAA;AAAA,QACA,SAAA,EAAW,IAAA,CAAK,MAAA,CAAO,QAAA,CAAS;AAAA,OACjC,CAAA;AAED,MAAA,OAAO,IAAA,CAAK,MAAA;AAAA,IACd,CAAA,GAAG;AAEH,IAAA,OAAO,IAAA,CAAK,iBAAA;AAAA,EACd;AAAA;AAAA;AAAA;AAAA,EAKQ,mBAAmB,YAAA,EAA8B;AACvD,IAAA,MAAM,SAAA,GAAY,KAAK,GAAA,EAAI;AAC3B,IAAA,MAAM,MAAA,GAAS,KAAK,MAAA,EAAO,CAAE,SAAS,EAAE,CAAA,CAAE,SAAA,CAAU,CAAA,EAAG,CAAC,CAAA;AACxD,IAAA,OAAO,CAAA,EAAG,YAAY,CAAA,CAAA,EAAI,SAAS,IAAI,MAAM,CAAA,CAAA;AAAA,EAC/C;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MAAA,CACJ,QAAA,EACA,KAAA,EACA,OAAA,GAAgC,EAAC,EACf;AAClB,IAAA,MAAM,SAAS,MAAM,IAAA,CAAK,KAAA,CAAM,QAAA,EAAU,OAAO,OAAO,CAAA;AACxD,IAAA,OAAO,OAAO,MAAA,EAAO;AAAA,EACvB;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,KAAA,CACJ,QAAA,EACA,KAAA,EACA,OAAA,GAAgC,EAAC,EACC;AAClC,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AAEpC,IAAA,MAAM,aAAa,OAAA,CAAQ,UAAA,IAAc,IAAA,CAAK,kBAAA,CAAmB,SAAS,IAAI,CAAA;AAC9E,IAAA,MAAM,SAAA,GAAY,QAAQ,SAAA,IAAa,QAAA,CAAS,QAAQ,SAAA,IAAa,IAAA,CAAK,OAAO,SAAA,IAAa,SAAA;AAE9F,IAAA,MAAM,SAAS,MAAM,MAAA,CAAO,QAAA,CAAS,KAAA,CAAM,SAAS,IAAA,EAAM;AAAA,MACxD,UAAA;AAAA,MACA,SAAA;AAAA,MACA,IAAA,EAAM,CAAC,KAAK,CAAA;AAAA,MACZ,0BAA0B,OAAA,CAAQ,wBAAA;AAAA,MAClC,MAAM,OAAA,CAAQ;AAAA;AAAA,KAEf,CAAA;AAED,IAAA,OAAO,IAAA,CAAK,WAAoB,MAAM,CAAA;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKA,UAA6B,UAAA,EAA6C;AAExE,IAAA,OAAO;AAAA,MACL,UAAA;AAAA,MACA,KAAA,EAAO,EAAA;AAAA;AAAA,MACP,QAAQ,YAAY;AAClB,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,UAAU,CAAA;AACnD,QAAA,OAAO,OAAO,MAAA,EAAO;AAAA,MACvB,CAAA;AAAA,MACA,KAAA,EAAO,OAA0B,SAAA,KAAsB;AACrD,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,UAAU,CAAA;AACnD,QAAA,OAAO,MAAA,CAAO,MAAe,SAAS,CAAA;AAAA,MACxC,CAAA;AAAA,MACA,MAAA,EAAQ,OAA2B,UAAA,EAAoB,OAAA,KAAsB;AAC3E,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,UAAU,CAAA;AACnD,QAAA,MAAM,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAO,CAAA;AAAA,MACzC,CAAA;AAAA,MACA,QAAQ,YAAY;AAClB,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,UAAU,CAAA;AACnD,QAAA,MAAM,OAAO,MAAA,EAAO;AAAA,MACtB,CAAA;AAAA,MACA,SAAA,EAAW,OAAO,MAAA,KAAoB;AACpC,QAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,QAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,UAAU,CAAA;AACnD,QAAA,MAAM,MAAA,CAAO,UAAU,MAAM,CAAA;AAAA,MAC/B;AAAA,KACF;AAAA,EACF;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,MAAA,CACJ,UAAA,EACA,UAAA,EACA,OAAA,EACe;AACf,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,UAAU,CAAA;AACnD,IAAA,MAAM,MAAA,CAAO,MAAA,CAAO,UAAA,EAAY,OAAO,CAAA;AAAA,EACzC;AAAA;AAAA;AAAA;AAAA,EAKA,MAAM,KAAA,CACJ,UAAA,EACA,SAAA,EACkB;AAClB,IAAA,MAAM,MAAA,GAAS,MAAM,IAAA,CAAK,SAAA,EAAU;AACpC,IAAA,MAAM,MAAA,GAAS,MAAA,CAAO,QAAA,CAAS,SAAA,CAAU,UAAU,CAAA;AACnD,IAAA,OAAO,MAAA,CAAO,MAAe,SAAS,CAAA;AAAA,EACxC;AAAA;AAAA;AAAA;AAAA,EAKQ,WACN,MAAA,EACyB;AACzB,IAAA,OAAO;AAAA,MACL,YAAY,MAAA,CAAO,UAAA;AAAA,MACnB,OAAO,MAAA,CAAO,mBAAA;AAAA,MACd,MAAA,EAAQ,MAAM,MAAA,CAAO,MAAA,EAAO;AAAA,MAC5B,KAAA,EAAO,CAAoB,SAAA,KACzB,MAAA,CAAO,MAAe,SAAS,CAAA;AAAA,MACjC,QAAQ,CAAqB,UAAA,EAAoB,YAC/C,MAAA,CAAO,MAAA,CAAO,YAAY,OAAO,CAAA;AAAA,MACnC,QAAQ,YAAY;AAClB,QAAA,MAAM,OAAO,MAAA,EAAO;AAAA,MACtB,CAAA;AAAA,MACA,SAAA,EAAW,OAAO,MAAA,KAAoB;AACpC,QAAA,MAAM,MAAA,CAAO,UAAU,MAAM,CAAA;AAAA,MAC/B;AAAA,KACF;AAAA,EACF;AACF,CAAA;AAwBA,SAAS,aAAa,MAAA,EAAiC;AACrD,EAAA,OAAO,IAAI,wBAAwB,MAAM,CAAA;AAC3C;AAMO,IAAM,GAAA,GAAM;AAAA,EACjB,MAAA,EAAQ;AACV;AAIA,IAAO,cAAA,GAAQ","file":"index.js","sourcesContent":["/**\n * Temporal Functions - Client Package\n *\n * Lightweight client for triggering workflows.\n * Import from 'temporal-functions/client'.\n */\n\nimport { Client, Connection } from '@temporalio/client';\nimport type {\n  ClientConfig,\n  WorkflowDef,\n  StartWorkflowOptions,\n  WorkflowHandle,\n  TFNClient,\n} from '../types.js';\n\n// =============================================================================\n// Client Implementation\n// =============================================================================\n\nclass TemporalFunctionsClient implements TFNClient {\n  private client: Client | null = null;\n  private config: ClientConfig;\n  private connectionPromise: Promise<Client> | null = null;\n\n  constructor(config: ClientConfig) {\n    this.config = {\n      ...config,\n      temporal: {\n        namespace: 'default',\n        ...config.temporal,\n      },\n      taskQueue: config.taskQueue || 'default',\n    };\n  }\n\n  /**\n   * Lazily connect to Temporal\n   */\n  private async getClient(): Promise<Client> {\n    if (this.client) {\n      return this.client;\n    }\n\n    if (this.connectionPromise) {\n      return this.connectionPromise;\n    }\n\n    this.connectionPromise = (async () => {\n      const connection = await Connection.connect({\n        address: this.config.temporal.address,\n        tls: this.config.temporal.tls\n          ? {\n              clientCertPair: this.config.temporal.tls.clientCertPath\n                ? {\n                    crt: await import('fs').then((fs) =>\n                      fs.promises.readFile(this.config.temporal.tls!.clientCertPath!)\n                    ),\n                    key: await import('fs').then((fs) =>\n                      fs.promises.readFile(this.config.temporal.tls!.clientKeyPath!)\n                    ),\n                  }\n                : undefined,\n            }\n          : undefined,\n      });\n\n      this.client = new Client({\n        connection,\n        namespace: this.config.temporal.namespace,\n      });\n\n      return this.client;\n    })();\n\n    return this.connectionPromise;\n  }\n\n  /**\n   * Generate a workflow ID if not provided\n   */\n  private generateWorkflowId(workflowName: string): string {\n    const timestamp = Date.now();\n    const random = Math.random().toString(36).substring(2, 8);\n    return `${workflowName}-${timestamp}-${random}`;\n  }\n\n  /**\n   * Start a workflow and wait for the result\n   */\n  async invoke<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput,\n    options: StartWorkflowOptions = {}\n  ): Promise<TOutput> {\n    const handle = await this.start(workflow, input, options);\n    return handle.result();\n  }\n\n  /**\n   * Start a workflow without waiting (fire and forget)\n   */\n  async start<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput,\n    options: StartWorkflowOptions = {}\n  ): Promise<WorkflowHandle<TOutput>> {\n    const client = await this.getClient();\n\n    const workflowId = options.workflowId || this.generateWorkflowId(workflow.name);\n    const taskQueue = options.taskQueue || workflow.options.taskQueue || this.config.taskQueue || 'default';\n\n    const handle = await client.workflow.start(workflow.name, {\n      workflowId,\n      taskQueue,\n      args: [input],\n      workflowExecutionTimeout: options.workflowExecutionTimeout,\n      memo: options.memo,\n      // searchAttributes requires specific types, omit for now if not properly typed\n    });\n\n    return this.wrapHandle<TOutput>(handle);\n  }\n\n  /**\n   * Get a handle to an existing workflow\n   */\n  getHandle<TOutput = unknown>(workflowId: string): WorkflowHandle<TOutput> {\n    // Create a lazy handle that connects when needed\n    return {\n      workflowId,\n      runId: '', // Will be populated when we fetch\n      result: async () => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        return handle.result() as Promise<TOutput>;\n      },\n      query: async <TResult = unknown>(queryName: string) => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        return handle.query<TResult>(queryName);\n      },\n      signal: async <TPayload = unknown>(signalName: string, payload: TPayload) => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        await handle.signal(signalName, payload);\n      },\n      cancel: async () => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        await handle.cancel();\n      },\n      terminate: async (reason?: string) => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        await handle.terminate(reason);\n      },\n    };\n  }\n\n  /**\n   * Signal an existing workflow\n   */\n  async signal<TPayload = unknown>(\n    workflowId: string,\n    signalName: string,\n    payload: TPayload\n  ): Promise<void> {\n    const client = await this.getClient();\n    const handle = client.workflow.getHandle(workflowId);\n    await handle.signal(signalName, payload);\n  }\n\n  /**\n   * Query an existing workflow\n   */\n  async query<TResult = unknown>(\n    workflowId: string,\n    queryName: string\n  ): Promise<TResult> {\n    const client = await this.getClient();\n    const handle = client.workflow.getHandle(workflowId);\n    return handle.query<TResult>(queryName);\n  }\n\n  /**\n   * Wrap a Temporal workflow handle in our interface\n   */\n  private wrapHandle<TOutput>(\n    handle: Awaited<ReturnType<Client['workflow']['start']>>\n  ): WorkflowHandle<TOutput> {\n    return {\n      workflowId: handle.workflowId,\n      runId: handle.firstExecutionRunId,\n      result: () => handle.result() as Promise<TOutput>,\n      query: <TResult = unknown>(queryName: string) =>\n        handle.query<TResult>(queryName),\n      signal: <TPayload = unknown>(signalName: string, payload: TPayload) =>\n        handle.signal(signalName, payload),\n      cancel: async () => {\n        await handle.cancel();\n      },\n      terminate: async (reason?: string) => {\n        await handle.terminate(reason);\n      },\n    };\n  }\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Create a Temporal Functions client\n *\n * @example\n * ```typescript\n * import { tfn } from 'temporal-functions/client';\n *\n * const client = tfn.client({\n *   temporal: {\n *     address: 'localhost:7233',\n *     namespace: 'default',\n *   },\n *   taskQueue: 'my-queue',\n * });\n *\n * const result = await client.invoke(myWorkflow, { data: 'hello' });\n * ```\n */\nfunction createClient(config: ClientConfig): TFNClient {\n  return new TemporalFunctionsClient(config);\n}\n\n// =============================================================================\n// Export\n// =============================================================================\n\nexport const tfn = {\n  client: createClient,\n};\n\nexport { createClient };\nexport type { ClientConfig, TFNClient, WorkflowHandle, StartWorkflowOptions };\nexport default tfn;\n"]}

package/dist/client/index.mjs

@@ -0,0 +1,162 @@
+import { Connection, Client } from '@temporalio/client';
+
+// src/client/index.ts
+var TemporalFunctionsClient = class {
+  client = null;
+  config;
+  connectionPromise = null;
+  constructor(config) {
+    this.config = {
+      ...config,
+      temporal: {
+        namespace: "default",
+        ...config.temporal
+      },
+      taskQueue: config.taskQueue || "default"
+    };
+  }
+  /**
+   * Lazily connect to Temporal
+   */
+  async getClient() {
+    if (this.client) {
+      return this.client;
+    }
+    if (this.connectionPromise) {
+      return this.connectionPromise;
+    }
+    this.connectionPromise = (async () => {
+      const connection = await Connection.connect({
+        address: this.config.temporal.address,
+        tls: this.config.temporal.tls ? {
+          clientCertPair: this.config.temporal.tls.clientCertPath ? {
+            crt: await import('fs').then(
+              (fs) => fs.promises.readFile(this.config.temporal.tls.clientCertPath)
+            ),
+            key: await import('fs').then(
+              (fs) => fs.promises.readFile(this.config.temporal.tls.clientKeyPath)
+            )
+          } : void 0
+        } : void 0
+      });
+      this.client = new Client({
+        connection,
+        namespace: this.config.temporal.namespace
+      });
+      return this.client;
+    })();
+    return this.connectionPromise;
+  }
+  /**
+   * Generate a workflow ID if not provided
+   */
+  generateWorkflowId(workflowName) {
+    const timestamp = Date.now();
+    const random = Math.random().toString(36).substring(2, 8);
+    return `${workflowName}-${timestamp}-${random}`;
+  }
+  /**
+   * Start a workflow and wait for the result
+   */
+  async invoke(workflow, input, options = {}) {
+    const handle = await this.start(workflow, input, options);
+    return handle.result();
+  }
+  /**
+   * Start a workflow without waiting (fire and forget)
+   */
+  async start(workflow, input, options = {}) {
+    const client = await this.getClient();
+    const workflowId = options.workflowId || this.generateWorkflowId(workflow.name);
+    const taskQueue = options.taskQueue || workflow.options.taskQueue || this.config.taskQueue || "default";
+    const handle = await client.workflow.start(workflow.name, {
+      workflowId,
+      taskQueue,
+      args: [input],
+      workflowExecutionTimeout: options.workflowExecutionTimeout,
+      memo: options.memo
+      // searchAttributes requires specific types, omit for now if not properly typed
+    });
+    return this.wrapHandle(handle);
+  }
+  /**
+   * Get a handle to an existing workflow
+   */
+  getHandle(workflowId) {
+    return {
+      workflowId,
+      runId: "",
+      // Will be populated when we fetch
+      result: async () => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        return handle.result();
+      },
+      query: async (queryName) => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        return handle.query(queryName);
+      },
+      signal: async (signalName, payload) => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        await handle.signal(signalName, payload);
+      },
+      cancel: async () => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        await handle.cancel();
+      },
+      terminate: async (reason) => {
+        const client = await this.getClient();
+        const handle = client.workflow.getHandle(workflowId);
+        await handle.terminate(reason);
+      }
+    };
+  }
+  /**
+   * Signal an existing workflow
+   */
+  async signal(workflowId, signalName, payload) {
+    const client = await this.getClient();
+    const handle = client.workflow.getHandle(workflowId);
+    await handle.signal(signalName, payload);
+  }
+  /**
+   * Query an existing workflow
+   */
+  async query(workflowId, queryName) {
+    const client = await this.getClient();
+    const handle = client.workflow.getHandle(workflowId);
+    return handle.query(queryName);
+  }
+  /**
+   * Wrap a Temporal workflow handle in our interface
+   */
+  wrapHandle(handle) {
+    return {
+      workflowId: handle.workflowId,
+      runId: handle.firstExecutionRunId,
+      result: () => handle.result(),
+      query: (queryName) => handle.query(queryName),
+      signal: (signalName, payload) => handle.signal(signalName, payload),
+      cancel: async () => {
+        await handle.cancel();
+      },
+      terminate: async (reason) => {
+        await handle.terminate(reason);
+      }
+    };
+  }
+};
+function createClient(config) {
+  return new TemporalFunctionsClient(config);
+}
+var tfn = {
+  client: createClient
+};
+var client_default = tfn;
+
+export { createClient, client_default as default, tfn };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/client/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/client/index.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["/**\n * Temporal Functions - Client Package\n *\n * Lightweight client for triggering workflows.\n * Import from 'temporal-functions/client'.\n */\n\nimport { Client, Connection } from '@temporalio/client';\nimport type {\n  ClientConfig,\n  WorkflowDef,\n  StartWorkflowOptions,\n  WorkflowHandle,\n  TFNClient,\n} from '../types.js';\n\n// =============================================================================\n// Client Implementation\n// =============================================================================\n\nclass TemporalFunctionsClient implements TFNClient {\n  private client: Client | null = null;\n  private config: ClientConfig;\n  private connectionPromise: Promise<Client> | null = null;\n\n  constructor(config: ClientConfig) {\n    this.config = {\n      ...config,\n      temporal: {\n        namespace: 'default',\n        ...config.temporal,\n      },\n      taskQueue: config.taskQueue || 'default',\n    };\n  }\n\n  /**\n   * Lazily connect to Temporal\n   */\n  private async getClient(): Promise<Client> {\n    if (this.client) {\n      return this.client;\n    }\n\n    if (this.connectionPromise) {\n      return this.connectionPromise;\n    }\n\n    this.connectionPromise = (async () => {\n      const connection = await Connection.connect({\n        address: this.config.temporal.address,\n        tls: this.config.temporal.tls\n          ? {\n              clientCertPair: this.config.temporal.tls.clientCertPath\n                ? {\n                    crt: await import('fs').then((fs) =>\n                      fs.promises.readFile(this.config.temporal.tls!.clientCertPath!)\n                    ),\n                    key: await import('fs').then((fs) =>\n                      fs.promises.readFile(this.config.temporal.tls!.clientKeyPath!)\n                    ),\n                  }\n                : undefined,\n            }\n          : undefined,\n      });\n\n      this.client = new Client({\n        connection,\n        namespace: this.config.temporal.namespace,\n      });\n\n      return this.client;\n    })();\n\n    return this.connectionPromise;\n  }\n\n  /**\n   * Generate a workflow ID if not provided\n   */\n  private generateWorkflowId(workflowName: string): string {\n    const timestamp = Date.now();\n    const random = Math.random().toString(36).substring(2, 8);\n    return `${workflowName}-${timestamp}-${random}`;\n  }\n\n  /**\n   * Start a workflow and wait for the result\n   */\n  async invoke<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput,\n    options: StartWorkflowOptions = {}\n  ): Promise<TOutput> {\n    const handle = await this.start(workflow, input, options);\n    return handle.result();\n  }\n\n  /**\n   * Start a workflow without waiting (fire and forget)\n   */\n  async start<TInput, TOutput>(\n    workflow: WorkflowDef<TInput, TOutput>,\n    input: TInput,\n    options: StartWorkflowOptions = {}\n  ): Promise<WorkflowHandle<TOutput>> {\n    const client = await this.getClient();\n\n    const workflowId = options.workflowId || this.generateWorkflowId(workflow.name);\n    const taskQueue = options.taskQueue || workflow.options.taskQueue || this.config.taskQueue || 'default';\n\n    const handle = await client.workflow.start(workflow.name, {\n      workflowId,\n      taskQueue,\n      args: [input],\n      workflowExecutionTimeout: options.workflowExecutionTimeout,\n      memo: options.memo,\n      // searchAttributes requires specific types, omit for now if not properly typed\n    });\n\n    return this.wrapHandle<TOutput>(handle);\n  }\n\n  /**\n   * Get a handle to an existing workflow\n   */\n  getHandle<TOutput = unknown>(workflowId: string): WorkflowHandle<TOutput> {\n    // Create a lazy handle that connects when needed\n    return {\n      workflowId,\n      runId: '', // Will be populated when we fetch\n      result: async () => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        return handle.result() as Promise<TOutput>;\n      },\n      query: async <TResult = unknown>(queryName: string) => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        return handle.query<TResult>(queryName);\n      },\n      signal: async <TPayload = unknown>(signalName: string, payload: TPayload) => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        await handle.signal(signalName, payload);\n      },\n      cancel: async () => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        await handle.cancel();\n      },\n      terminate: async (reason?: string) => {\n        const client = await this.getClient();\n        const handle = client.workflow.getHandle(workflowId);\n        await handle.terminate(reason);\n      },\n    };\n  }\n\n  /**\n   * Signal an existing workflow\n   */\n  async signal<TPayload = unknown>(\n    workflowId: string,\n    signalName: string,\n    payload: TPayload\n  ): Promise<void> {\n    const client = await this.getClient();\n    const handle = client.workflow.getHandle(workflowId);\n    await handle.signal(signalName, payload);\n  }\n\n  /**\n   * Query an existing workflow\n   */\n  async query<TResult = unknown>(\n    workflowId: string,\n    queryName: string\n  ): Promise<TResult> {\n    const client = await this.getClient();\n    const handle = client.workflow.getHandle(workflowId);\n    return handle.query<TResult>(queryName);\n  }\n\n  /**\n   * Wrap a Temporal workflow handle in our interface\n   */\n  private wrapHandle<TOutput>(\n    handle: Awaited<ReturnType<Client['workflow']['start']>>\n  ): WorkflowHandle<TOutput> {\n    return {\n      workflowId: handle.workflowId,\n      runId: handle.firstExecutionRunId,\n      result: () => handle.result() as Promise<TOutput>,\n      query: <TResult = unknown>(queryName: string) =>\n        handle.query<TResult>(queryName),\n      signal: <TPayload = unknown>(signalName: string, payload: TPayload) =>\n        handle.signal(signalName, payload),\n      cancel: async () => {\n        await handle.cancel();\n      },\n      terminate: async (reason?: string) => {\n        await handle.terminate(reason);\n      },\n    };\n  }\n}\n\n// =============================================================================\n// Factory Function\n// =============================================================================\n\n/**\n * Create a Temporal Functions client\n *\n * @example\n * ```typescript\n * import { tfn } from 'temporal-functions/client';\n *\n * const client = tfn.client({\n *   temporal: {\n *     address: 'localhost:7233',\n *     namespace: 'default',\n *   },\n *   taskQueue: 'my-queue',\n * });\n *\n * const result = await client.invoke(myWorkflow, { data: 'hello' });\n * ```\n */\nfunction createClient(config: ClientConfig): TFNClient {\n  return new TemporalFunctionsClient(config);\n}\n\n// =============================================================================\n// Export\n// =============================================================================\n\nexport const tfn = {\n  client: createClient,\n};\n\nexport { createClient };\nexport type { ClientConfig, TFNClient, WorkflowHandle, StartWorkflowOptions };\nexport default tfn;\n"]}