@temporal-contract/worker 0.0.7 → 0.1.0

package/README.md

@@ -14,43 +14,50 @@ pnpm add @temporal-contract/worker @temporal-contract/contract @temporalio/workf
 
 ```typescript
 // activities.ts
-import { declareActivitiesHandler } from '@temporal-contract/worker/activity';
+import { declareActivitiesHandler, ActivityError } from "@temporal-contract/worker/activity";
+import { Future, Result } from "@swan-io/boxed";
 
 export const activities = declareActivitiesHandler({
   contract: myContract,
   activities: {
-    sendEmail: async ({ to, body }) => ({ sent: true })
-  }
+    sendEmail: ({ to, body }) => {
+      return Future.fromPromise(emailService.send({ to, body }))
+        .mapError(
+          (error) =>
+            new ActivityError(
+              "EMAIL_FAILED",
+              error instanceof Error ? error.message : "Failed to send email",
+              error,
+            ),
+        )
+        .mapOk(() => ({ sent: true }));
+    },
+  },
 });
 
 // workflows.ts
-import { declareWorkflow } from '@temporal-contract/worker/workflow';
+import { declareWorkflow } from "@temporal-contract/worker/workflow";
 
 export const processOrder = declareWorkflow({
-  workflowName: 'processOrder',
+  workflowName: "processOrder",
   contract: myContract,
-  implementation: async (context, input) => {
-    await context.activities.sendEmail({ to: 'user@example.com', body: 'Done!' });
+  implementation: async ({ activities }, input) => {
+    // Activities return plain values (Result is unwrapped internally)
+    await activities.sendEmail({ to: "user@example.com", body: "Done!" });
     return { success: true };
-  }
+  },
 });
 
 // worker.ts
-import { NativeConnection } from '@temporalio/worker';
-import { createWorker } from '@temporal-contract/worker/worker';
-import { activities } from './activities';
-import myContract from './contract';
+import { Worker } from "@temporalio/worker";
+import { activities } from "./activities";
+import myContract from "./contract";
 
 async function run() {
-  const connection = await NativeConnection.connect({
-    address: 'localhost:7233',
-  });
-
-  const worker = await createWorker({
-    contract: myContract,
-    connection,
-    workflowsPath: require.resolve('./workflows'),
+  const worker = await Worker.create({
+    workflowsPath: require.resolve("./workflows"),
     activities,
+    taskQueue: myContract.taskQueue,
   });
 
   await worker.run();
@@ -65,33 +72,37 @@ Execute child workflows with type-safe Future/Result pattern. Supports both same
 
 ```typescript
 // workflows.ts
-import { declareWorkflow } from '@temporal-contract/worker/workflow';
+import { declareWorkflow } from "@temporal-contract/worker/workflow";
 
 export const parentWorkflow = declareWorkflow({
-  workflowName: 'parentWorkflow',
+  workflowName: "parentWorkflow",
   contract: myContract,
-  implementation: async (context, input) => {
+  implementation: async ({ executeChildWorkflow }, input) => {
     // Execute child workflow from same contract and wait for result
-    const childResult = await context.executeChildWorkflow(myContract, 'processPayment', {
+    const childResult = await executeChildWorkflow(myContract, "processPayment", {
       workflowId: `payment-${input.orderId}`,
-      args: { amount: input.totalAmount }
+      args: { amount: input.totalAmount },
     });
 
     childResult.match({
-      Ok: (output) => console.log('Payment processed:', output),
-      Error: (error) => console.error('Payment failed:', error),
+      Ok: (output) => console.log("Payment processed:", output),
+      Error: (error) => console.error("Payment failed:", error),
     });
 
     // Execute child workflow from another contract (another worker)
-    const notificationResult = await context.executeChildWorkflow(notificationContract, 'sendNotification', {
-      workflowId: `notification-${input.orderId}`,
-      args: { message: 'Order received' }
-    });
+    const notificationResult = await executeChildWorkflow(
+      notificationContract,
+      "sendNotification",
+      {
+        workflowId: `notification-${input.orderId}`,
+        args: { message: "Order received" },
+      },
+    );
 
     // Or start child workflow without waiting
-    const handleResult = await context.startChildWorkflow(myContract, 'sendEmail', {
+    const handleResult = await startChildWorkflow(myContract, "sendEmail", {
       workflowId: `email-${input.orderId}`,
-      args: { to: 'user@example.com', body: 'Order received' }
+      args: { to: "user@example.com", body: "Order received" },
     });
 
     handleResult.match({
@@ -100,11 +111,11 @@ export const parentWorkflow = declareWorkflow({
         const result = await handle.result();
         // ...
       },
-      Error: (error) => console.error('Failed to start:', error),
+      Error: (error) => console.error("Failed to start:", error),
     });
 
     return { success: true };
-  }
+  },
 });
 ```
 

package/dist/{activity-Csptpwgf.d.cts → activity-5pVNjW7l.d.cts}

@@ -1,9 +1,8 @@
-import { g as WorkerInferOutput, h as WorkerInferInput } from "./errors-BqYWpdvd.cjs";
+import { g as WorkerInferOutput, h as WorkerInferInput } from "./errors-CXpHOFmk.cjs";
 import { ActivityDefinition, ContractDefinition } from "@temporal-contract/contract";
 import { Future, Result } from "@swan-io/boxed";
 
 //#region src/activity-utils.d.ts
-
 /**
  * Extract activity definitions for a specific workflow from a contract
  *

package/dist/{activity-UOnp_bSX.d.mts → activity-BUEBZ7SL.d.mts}

@@ -1,9 +1,8 @@
-import { g as WorkerInferOutput, h as WorkerInferInput } from "./errors-C1RFkCuD.mjs";
+import { g as WorkerInferOutput, h as WorkerInferInput } from "./errors-Vr-sKdW7.mjs";
 import { ActivityDefinition, ContractDefinition } from "@temporal-contract/contract";
 import { Future, Result } from "@swan-io/boxed";
 
 //#region src/activity-utils.d.ts
-
 /**
  * Extract activity definitions for a specific workflow from a contract
  *

package/dist/activity.d.cts

@@ -1,3 +1,3 @@
-import { n as ActivityInputValidationError, r as ActivityOutputValidationError, t as ActivityDefinitionNotFoundError } from "./errors-BqYWpdvd.cjs";
-import { a as getWorkflowActivityNames, i as getWorkflowActivities, n as ActivityError, o as getWorkflowNames, r as declareActivitiesHandler, s as isWorkflowActivity, t as ActivitiesHandler } from "./activity-Csptpwgf.cjs";
+import { n as ActivityInputValidationError, r as ActivityOutputValidationError, t as ActivityDefinitionNotFoundError } from "./errors-CXpHOFmk.cjs";
+import { a as getWorkflowActivityNames, i as getWorkflowActivities, n as ActivityError, o as getWorkflowNames, r as declareActivitiesHandler, s as isWorkflowActivity, t as ActivitiesHandler } from "./activity-5pVNjW7l.cjs";
 export { ActivitiesHandler, ActivityDefinitionNotFoundError, ActivityError, ActivityInputValidationError, ActivityOutputValidationError, declareActivitiesHandler, getWorkflowActivities, getWorkflowActivityNames, getWorkflowNames, isWorkflowActivity };

package/dist/activity.d.mts

@@ -1,3 +1,3 @@
-import { n as ActivityInputValidationError, r as ActivityOutputValidationError, t as ActivityDefinitionNotFoundError } from "./errors-C1RFkCuD.mjs";
-import { a as getWorkflowActivityNames, i as getWorkflowActivities, n as ActivityError, o as getWorkflowNames, r as declareActivitiesHandler, s as isWorkflowActivity, t as ActivitiesHandler } from "./activity-UOnp_bSX.mjs";
+import { n as ActivityInputValidationError, r as ActivityOutputValidationError, t as ActivityDefinitionNotFoundError } from "./errors-Vr-sKdW7.mjs";
+import { a as getWorkflowActivityNames, i as getWorkflowActivities, n as ActivityError, o as getWorkflowNames, r as declareActivitiesHandler, s as isWorkflowActivity, t as ActivitiesHandler } from "./activity-BUEBZ7SL.mjs";
 export { ActivitiesHandler, ActivityDefinitionNotFoundError, ActivityError, ActivityInputValidationError, ActivityOutputValidationError, declareActivitiesHandler, getWorkflowActivities, getWorkflowActivityNames, getWorkflowNames, isWorkflowActivity };

package/dist/{errors-BqYWpdvd.d.cts → errors-CXpHOFmk.d.cts}

@@ -2,7 +2,6 @@ import { AnySchema } from "@temporal-contract/contract";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/types.d.ts
-
 /**
  * Infer input type from a definition (worker perspective)
  * Worker receives the output type (after input schema parsing/transformation)

package/dist/{errors-C1RFkCuD.d.mts → errors-Vr-sKdW7.d.mts}

@@ -2,7 +2,6 @@ import { AnySchema } from "@temporal-contract/contract";
 import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/types.d.ts
-
 /**
  * Infer input type from a definition (worker perspective)
  * Worker receives the output type (after input schema parsing/transformation)

package/dist/worker.d.cts

@@ -1,9 +1,8 @@
-import { t as ActivitiesHandler } from "./activity-Csptpwgf.cjs";
+import { t as ActivitiesHandler } from "./activity-5pVNjW7l.cjs";
 import { ContractDefinition } from "@temporal-contract/contract";
 import { Worker, WorkerOptions } from "@temporalio/worker";
 
 //#region src/worker.d.ts
-
 /**
  * Options for creating a Temporal worker
  */

package/dist/worker.d.mts

@@ -1,9 +1,8 @@
-import { t as ActivitiesHandler } from "./activity-UOnp_bSX.mjs";
+import { t as ActivitiesHandler } from "./activity-BUEBZ7SL.mjs";
 import { Worker, WorkerOptions } from "@temporalio/worker";
 import { ContractDefinition } from "@temporal-contract/contract";
 
 //#region src/worker.d.ts
-
 /**
  * Options for creating a Temporal worker
  */

package/dist/workflow.d.cts

@@ -1,10 +1,9 @@
-import { a as ChildWorkflowNotFoundError, c as SignalInputValidationError, d as WorkflowInputValidationError, f as WorkflowOutputValidationError, g as WorkerInferOutput, h as WorkerInferInput, i as ChildWorkflowError, l as UpdateInputValidationError, m as ClientInferOutput, n as ActivityInputValidationError, o as QueryInputValidationError, p as ClientInferInput, r as ActivityOutputValidationError, s as QueryOutputValidationError, u as UpdateOutputValidationError } from "./errors-BqYWpdvd.cjs";
+import { a as ChildWorkflowNotFoundError, c as SignalInputValidationError, d as WorkflowInputValidationError, f as WorkflowOutputValidationError, g as WorkerInferOutput, h as WorkerInferInput, i as ChildWorkflowError, l as UpdateInputValidationError, m as ClientInferOutput, n as ActivityInputValidationError, o as QueryInputValidationError, p as ClientInferInput, r as ActivityOutputValidationError, s as QueryOutputValidationError, u as UpdateOutputValidationError } from "./errors-CXpHOFmk.cjs";
 import { ActivityDefinition, ContractDefinition, QueryDefinition, SignalDefinition, UpdateDefinition, WorkflowDefinition } from "@temporal-contract/contract";
 import { Future, Result } from "@temporal-contract/boxed";
 import { ActivityOptions, ChildWorkflowOptions, WorkflowInfo } from "@temporalio/workflow";
 
 //#region src/workflow.d.ts
-
 /**
  * Create a typed workflow implementation with automatic validation
  *
@@ -158,7 +157,7 @@ interface WorkflowContext<TContract extends ContractDefinition, TWorkflowName ex
    * }
    * ```
    */
-  defineSignal: <K$1 extends keyof TContract["workflows"][TWorkflowName]["signals"]>(signalName: K$1, handler: SignalHandlerImplementation<TContract["workflows"][TWorkflowName]["signals"][K$1] extends SignalDefinition ? TContract["workflows"][TWorkflowName]["signals"][K$1] : never>) => void;
+  defineSignal: <K extends keyof TContract["workflows"][TWorkflowName]["signals"]>(signalName: K, handler: SignalHandlerImplementation<TContract["workflows"][TWorkflowName]["signals"][K] extends SignalDefinition ? TContract["workflows"][TWorkflowName]["signals"][K] : never>) => void;
   /**
    * Define a query handler within the workflow implementation
    * Allows the query handler to access workflow state
@@ -176,7 +175,7 @@ interface WorkflowContext<TContract extends ContractDefinition, TWorkflowName ex
    * }
    * ```
    */
-  defineQuery: <K$1 extends keyof TContract["workflows"][TWorkflowName]["queries"]>(queryName: K$1, handler: QueryHandlerImplementation<TContract["workflows"][TWorkflowName]["queries"][K$1] extends QueryDefinition ? TContract["workflows"][TWorkflowName]["queries"][K$1] : never>) => void;
+  defineQuery: <K extends keyof TContract["workflows"][TWorkflowName]["queries"]>(queryName: K, handler: QueryHandlerImplementation<TContract["workflows"][TWorkflowName]["queries"][K] extends QueryDefinition ? TContract["workflows"][TWorkflowName]["queries"][K] : never>) => void;
   /**
    * Define an update handler within the workflow implementation
    * Allows the update handler to access and modify workflow state
@@ -195,7 +194,7 @@ interface WorkflowContext<TContract extends ContractDefinition, TWorkflowName ex
    * }
    * ```
    */
-  defineUpdate: <K$1 extends keyof TContract["workflows"][TWorkflowName]["updates"]>(updateName: K$1, handler: UpdateHandlerImplementation<TContract["workflows"][TWorkflowName]["updates"][K$1] extends UpdateDefinition ? TContract["workflows"][TWorkflowName]["updates"][K$1] : never>) => void;
+  defineUpdate: <K extends keyof TContract["workflows"][TWorkflowName]["updates"]>(updateName: K, handler: UpdateHandlerImplementation<TContract["workflows"][TWorkflowName]["updates"][K] extends UpdateDefinition ? TContract["workflows"][TWorkflowName]["updates"][K] : never>) => void;
   /**
    * Start a child workflow and return a typed handle with Future/Result pattern
    *

package/dist/workflow.d.mts

@@ -1,10 +1,9 @@
-import { a as ChildWorkflowNotFoundError, c as SignalInputValidationError, d as WorkflowInputValidationError, f as WorkflowOutputValidationError, g as WorkerInferOutput, h as WorkerInferInput, i as ChildWorkflowError, l as UpdateInputValidationError, m as ClientInferOutput, n as ActivityInputValidationError, o as QueryInputValidationError, p as ClientInferInput, r as ActivityOutputValidationError, s as QueryOutputValidationError, u as UpdateOutputValidationError } from "./errors-C1RFkCuD.mjs";
+import { a as ChildWorkflowNotFoundError, c as SignalInputValidationError, d as WorkflowInputValidationError, f as WorkflowOutputValidationError, g as WorkerInferOutput, h as WorkerInferInput, i as ChildWorkflowError, l as UpdateInputValidationError, m as ClientInferOutput, n as ActivityInputValidationError, o as QueryInputValidationError, p as ClientInferInput, r as ActivityOutputValidationError, s as QueryOutputValidationError, u as UpdateOutputValidationError } from "./errors-Vr-sKdW7.mjs";
 import { Future, Result } from "@temporal-contract/boxed";
 import { ActivityOptions, ChildWorkflowOptions, WorkflowInfo } from "@temporalio/workflow";
 import { ActivityDefinition, ContractDefinition, QueryDefinition, SignalDefinition, UpdateDefinition, WorkflowDefinition } from "@temporal-contract/contract";
 
 //#region src/workflow.d.ts
-
 /**
  * Create a typed workflow implementation with automatic validation
  *
@@ -158,7 +157,7 @@ interface WorkflowContext<TContract extends ContractDefinition, TWorkflowName ex
    * }
    * ```
    */
-  defineSignal: <K$1 extends keyof TContract["workflows"][TWorkflowName]["signals"]>(signalName: K$1, handler: SignalHandlerImplementation<TContract["workflows"][TWorkflowName]["signals"][K$1] extends SignalDefinition ? TContract["workflows"][TWorkflowName]["signals"][K$1] : never>) => void;
+  defineSignal: <K extends keyof TContract["workflows"][TWorkflowName]["signals"]>(signalName: K, handler: SignalHandlerImplementation<TContract["workflows"][TWorkflowName]["signals"][K] extends SignalDefinition ? TContract["workflows"][TWorkflowName]["signals"][K] : never>) => void;
   /**
    * Define a query handler within the workflow implementation
    * Allows the query handler to access workflow state
@@ -176,7 +175,7 @@ interface WorkflowContext<TContract extends ContractDefinition, TWorkflowName ex
    * }
    * ```
    */
-  defineQuery: <K$1 extends keyof TContract["workflows"][TWorkflowName]["queries"]>(queryName: K$1, handler: QueryHandlerImplementation<TContract["workflows"][TWorkflowName]["queries"][K$1] extends QueryDefinition ? TContract["workflows"][TWorkflowName]["queries"][K$1] : never>) => void;
+  defineQuery: <K extends keyof TContract["workflows"][TWorkflowName]["queries"]>(queryName: K, handler: QueryHandlerImplementation<TContract["workflows"][TWorkflowName]["queries"][K] extends QueryDefinition ? TContract["workflows"][TWorkflowName]["queries"][K] : never>) => void;
   /**
    * Define an update handler within the workflow implementation
    * Allows the update handler to access and modify workflow state
@@ -195,7 +194,7 @@ interface WorkflowContext<TContract extends ContractDefinition, TWorkflowName ex
    * }
    * ```
    */
-  defineUpdate: <K$1 extends keyof TContract["workflows"][TWorkflowName]["updates"]>(updateName: K$1, handler: UpdateHandlerImplementation<TContract["workflows"][TWorkflowName]["updates"][K$1] extends UpdateDefinition ? TContract["workflows"][TWorkflowName]["updates"][K$1] : never>) => void;
+  defineUpdate: <K extends keyof TContract["workflows"][TWorkflowName]["updates"]>(updateName: K, handler: UpdateHandlerImplementation<TContract["workflows"][TWorkflowName]["updates"][K] extends UpdateDefinition ? TContract["workflows"][TWorkflowName]["updates"][K] : never>) => void;
   /**
    * Start a child workflow and return a typed handle with Future/Result pattern
    *

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@temporal-contract/worker",
-  "version": "0.0.7",
+  "version": "0.1.0",
   "description": "Worker utilities with Result/Future pattern for implementing temporal-contract workflows and activities",
   "keywords": [
     "contract",
@@ -64,22 +64,23 @@
   "dependencies": {
     "@standard-schema/spec": "1.1.0",
     "@swan-io/boxed": "3.2.1",
-    "@temporal-contract/boxed": "0.0.7",
-    "@temporal-contract/contract": "0.0.7"
+    "@temporal-contract/boxed": "0.1.0",
+    "@temporal-contract/contract": "0.1.0"
   },
   "devDependencies": {
-    "@temporalio/client": "1.14.0",
-    "@temporalio/worker": "1.14.0",
-    "@temporalio/workflow": "1.14.0",
-    "@types/node": "25.0.3",
-    "@vitest/coverage-v8": "4.0.16",
-    "tsdown": "0.18.1",
+    "@temporalio/client": "1.14.1",
+    "@temporalio/worker": "1.14.1",
+    "@temporalio/workflow": "1.14.1",
+    "@types/node": "25.0.9",
+    "@vitest/coverage-v8": "4.0.17",
+    "tsdown": "0.20.0-beta.4",
     "typescript": "5.9.3",
-    "vitest": "4.0.16",
-    "zod": "4.2.1",
-    "@temporal-contract/client": "0.0.7",
-    "@temporal-contract/testing": "0.0.7",
-    "@temporal-contract/tsconfig": "0.0.7"
+    "vitest": "4.0.17",
+    "zod": "4.3.5",
+    "@temporal-contract/client": "0.1.0",
+    "@temporal-contract/testing": "0.1.0",
+    "@temporal-contract/tsconfig": "0.1.0",
+    "@temporal-contract/typedoc": "0.1.0"
   },
   "peerDependencies": {
     "@temporalio/worker": "^1",
@@ -87,6 +88,7 @@
   },
   "scripts": {
     "build": "tsdown src/activity.ts src/worker.ts src/workflow.ts --format cjs,esm --dts --clean",
+    "build:docs": "typedoc",
     "dev": "tsdown src/activity.ts src/worker.ts src/workflow.ts --format cjs,esm --dts --watch",
     "test": "vitest run --project unit",
     "test:integration": "vitest run --project integration",