@temporal-contract/worker 0.0.1 → 0.0.3

package/README.md

@@ -2,126 +2,47 @@
 
 > Type-safe worker implementation for Temporal
 
+[![npm version](https://img.shields.io/npm/v/@temporal-contract/worker.svg?logo=npm)](https://www.npmjs.com/package/@temporal-contract/worker)
+
 ## Installation
 
 ```bash
 pnpm add @temporal-contract/worker @temporal-contract/contract @temporalio/workflow zod
 ```
 
-## Important: Separate Entry Points
-
-Use **separate imports** for better tree-shaking:
-
-- **`@temporal-contract/worker/activity`** — For activity files
-- **`@temporal-contract/worker/workflow`** — For workflow files
-
-## Quick Start
-
-### 1. Implement Activities
+## Quick Example
 
 ```typescript
 // activities.ts
 import { declareActivitiesHandler } from '@temporal-contract/worker/activity';
-import { myContract } from './contract';
 
 export const activities = declareActivitiesHandler({
   contract: myContract,
   activities: {
-    sendEmail: async ({ to, subject, body }) => {
-      await emailService.send({ to, subject, body });
-      return { sent: true };
-    },
-    processPayment: async ({ customerId, amount }) => {
-      const txId = await paymentGateway.charge(customerId, amount);
-      return { transactionId: txId, success: true };
-    },
-  },
+    sendEmail: async ({ to, body }) => ({ sent: true })
+  }
 });
-```
 
-### 2. Implement Workflows
-
-```typescript
 // workflows.ts
 import { declareWorkflow } from '@temporal-contract/worker/workflow';
-import { myContract } from './contract';
 
 export const processOrder = declareWorkflow({
   workflowName: 'processOrder',
   contract: myContract,
-  implementation: async (context, { orderId, customerId }) => {
-    const payment = await context.activities.processPayment({ customerId, amount: 100 });
-    await context.activities.sendEmail({ to: customerId, subject: 'Confirmed', body: 'Done!' });
-
-    return {
-      status: payment.success ? 'success' : 'failed',
-      transactionId: payment.transactionId,
-    };
-  },
-});
-```
-
-### 3. Start Worker
-
-```typescript
-// worker.ts
-import { Worker } from '@temporalio/worker';
-import { activities } from './activities';
-
-const worker = await Worker.create({
-  workflowsPath: require.resolve('./workflows'),
-  activities: activities.activities,
-  taskQueue: activities.contract.taskQueue,
+  implementation: async (context, input) => {
+    await context.activities.sendEmail({ to: 'user@example.com', body: 'Done!' });
+    return { success: true };
+  }
 });
-
-await worker.run();
-```
-
-## Features
-
-✅ **Automatic validation** — Input/output validated with Zod at network boundaries  
-✅ **Type inference** — Full TypeScript inference from contract  
-✅ **Typed context** — Activities and workflow info fully typed  
-✅ **Signals, queries, updates** — Type-safe handlers with validation
-
-## Utility Types
-
-For cleaner activity signatures:
-
-```typescript
-import type { ActivityHandler, WorkflowActivityHandler } from '@temporal-contract/contract';
-
-const sendEmail: ActivityHandler<typeof myContract, 'sendEmail'> =
-  async ({ to, subject, body }) => {
-    // Fully typed without explicit annotations
-    return { sent: true };
-  };
-```
-
-See [Activity Handlers documentation](../../docs/ACTIVITY_HANDLERS.md) for details.
-
-## Error Handling
-
-Custom error classes with contextual info:
-
-```typescript
-import { ActivityDefinitionNotFoundError } from '@temporal-contract/worker';
-
-// Errors include helpful context
-if (error instanceof ActivityDefinitionNotFoundError) {
-  console.error('Not found:', error.activityName);
-  console.error('Available:', error.availableActivities);
-}
 ```
 
----
+## Documentation
 
-## Learn More
+📖 **[Read the full documentation →](https://btravers.github.io/temporal-contract)**
 
-- [Main README](../../README.md) — Quick start guide
-- [Worker Implementation](../../docs/CONTRACT_HANDLER.md) — Complete guide
-- [Entry Points](../../docs/ENTRY_POINTS.md) — Why separate entry points
-- [Activity Handlers](../../docs/ACTIVITY_HANDLERS.md) — Type utilities
+- [API Reference](https://btravers.github.io/temporal-contract/api/worker)
+- [Worker Implementation Guide](https://btravers.github.io/temporal-contract/guide/worker-implementation)
+- [Examples](https://btravers.github.io/temporal-contract/examples/)
 
 ## License
 

package/dist/activity.cjs

@@ -1,4 +1,4 @@
-const require_handler = require('./handler-B3KY0uDx.cjs');
+const require_handler = require('./handler-Cc951VQp.cjs');
 
 exports.ActivityDefinitionNotFoundError = require_handler.ActivityDefinitionNotFoundError;
 exports.ActivityImplementationNotFoundError = require_handler.ActivityImplementationNotFoundError;

package/dist/activity.d.cts

@@ -1,2 +1,2 @@
-import { C as declareActivitiesHandler, h as DeclareActivitiesHandlerOptions, i as ActivityOutputValidationError, m as ActivityImplementations, n as ActivityImplementationNotFoundError, p as ActivitiesHandler, r as ActivityInputValidationError, t as ActivityDefinitionNotFoundError, u as WorkerError, v as RawActivityImplementation } from "./errors-CqX81ysy.cjs";
+import { C as declareActivitiesHandler, h as DeclareActivitiesHandlerOptions, i as ActivityOutputValidationError, m as ActivityImplementations, n as ActivityImplementationNotFoundError, p as ActivitiesHandler, r as ActivityInputValidationError, t as ActivityDefinitionNotFoundError, u as WorkerError, v as RawActivityImplementation } from "./errors-B50uht6a.cjs";
 export { type ActivitiesHandler, ActivityDefinitionNotFoundError, ActivityImplementationNotFoundError, type ActivityImplementations, ActivityInputValidationError, ActivityOutputValidationError, type DeclareActivitiesHandlerOptions, type RawActivityImplementation, WorkerError, declareActivitiesHandler };

package/dist/activity.d.mts

@@ -1,2 +1,2 @@
-import { C as declareActivitiesHandler, h as DeclareActivitiesHandlerOptions, i as ActivityOutputValidationError, m as ActivityImplementations, n as ActivityImplementationNotFoundError, p as ActivitiesHandler, r as ActivityInputValidationError, t as ActivityDefinitionNotFoundError, u as WorkerError, v as RawActivityImplementation } from "./errors-oc-Iiwmu.mjs";
+import { C as declareActivitiesHandler, h as DeclareActivitiesHandlerOptions, i as ActivityOutputValidationError, m as ActivityImplementations, n as ActivityImplementationNotFoundError, p as ActivitiesHandler, r as ActivityInputValidationError, t as ActivityDefinitionNotFoundError, u as WorkerError, v as RawActivityImplementation } from "./errors-DgUMRes-.mjs";
 export { type ActivitiesHandler, ActivityDefinitionNotFoundError, ActivityImplementationNotFoundError, type ActivityImplementations, ActivityInputValidationError, ActivityOutputValidationError, type DeclareActivitiesHandlerOptions, type RawActivityImplementation, WorkerError, declareActivitiesHandler };

package/dist/activity.mjs

@@ -1,3 +1,3 @@
-import { a as ActivityInputValidationError, f as WorkerError, i as ActivityImplementationNotFoundError, o as ActivityOutputValidationError, r as ActivityDefinitionNotFoundError, t as declareActivitiesHandler } from "./handler-aA2RFdV7.mjs";
+import { a as ActivityInputValidationError, f as WorkerError, i as ActivityImplementationNotFoundError, o as ActivityOutputValidationError, r as ActivityDefinitionNotFoundError, t as declareActivitiesHandler } from "./handler-BP9xAycT.mjs";
 
 export { ActivityDefinitionNotFoundError, ActivityImplementationNotFoundError, ActivityInputValidationError, ActivityOutputValidationError, WorkerError, declareActivitiesHandler };

package/dist/{errors-CqX81ysy.d.cts → errors-B50uht6a.d.cts}

@@ -1,6 +1,6 @@
 import { ActivityOptions, WorkflowInfo } from "@temporalio/workflow";
 import { ActivityDefinition, ContractDefinition, QueryDefinition, SignalDefinition, UpdateDefinition, WorkerInferInput, WorkerInferOutput, WorkerInferWorkflowContextActivities } from "@temporal-contract/contract";
-import { z } from "zod";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/handler.d.ts
 
@@ -231,72 +231,72 @@ declare class ActivityDefinitionNotFoundError extends WorkerError {
  */
 declare class ActivityInputValidationError extends WorkerError {
   readonly activityName: string;
-  readonly zodError: z.ZodError;
-  constructor(activityName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(activityName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when activity output validation fails
  */
 declare class ActivityOutputValidationError extends WorkerError {
   readonly activityName: string;
-  readonly zodError: z.ZodError;
-  constructor(activityName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(activityName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when workflow input validation fails
  */
 declare class WorkflowInputValidationError extends WorkerError {
   readonly workflowName: string;
-  readonly zodError: z.ZodError;
-  constructor(workflowName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(workflowName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when workflow output validation fails
  */
 declare class WorkflowOutputValidationError extends WorkerError {
   readonly workflowName: string;
-  readonly zodError: z.ZodError;
-  constructor(workflowName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(workflowName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when signal input validation fails
  */
 declare class SignalInputValidationError extends WorkerError {
   readonly signalName: string;
-  readonly zodError: z.ZodError;
-  constructor(signalName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(signalName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when query input validation fails
  */
 declare class QueryInputValidationError extends WorkerError {
   readonly queryName: string;
-  readonly zodError: z.ZodError;
-  constructor(queryName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(queryName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when query output validation fails
  */
 declare class QueryOutputValidationError extends WorkerError {
   readonly queryName: string;
-  readonly zodError: z.ZodError;
-  constructor(queryName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(queryName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when update input validation fails
  */
 declare class UpdateInputValidationError extends WorkerError {
   readonly updateName: string;
-  readonly zodError: z.ZodError;
-  constructor(updateName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(updateName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when update output validation fails
  */
 declare class UpdateOutputValidationError extends WorkerError {
   readonly updateName: string;
-  readonly zodError: z.ZodError;
-  constructor(updateName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(updateName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 //#endregion
 export { declareActivitiesHandler as C, WorkflowImplementation as S, QueryHandlerImplementation as _, QueryInputValidationError as a, UpdateHandlerImplementation as b, UpdateInputValidationError as c, WorkflowInputValidationError as d, WorkflowOutputValidationError as f, DeclareWorkflowOptions as g, DeclareActivitiesHandlerOptions as h, ActivityOutputValidationError as i, UpdateOutputValidationError as l, ActivityImplementations as m, ActivityImplementationNotFoundError as n, QueryOutputValidationError as o, ActivitiesHandler as p, ActivityInputValidationError as r, SignalInputValidationError as s, ActivityDefinitionNotFoundError as t, WorkerError as u, RawActivityImplementation as v, declareWorkflow as w, WorkflowContext as x, SignalHandlerImplementation as y };

package/dist/{errors-oc-Iiwmu.d.mts → errors-DgUMRes-.d.mts}

@@ -1,6 +1,6 @@
 import { ActivityOptions, WorkflowInfo } from "@temporalio/workflow";
-import { z } from "zod";
 import { ActivityDefinition, ContractDefinition, QueryDefinition, SignalDefinition, UpdateDefinition, WorkerInferInput, WorkerInferOutput, WorkerInferWorkflowContextActivities } from "@temporal-contract/contract";
+import { StandardSchemaV1 } from "@standard-schema/spec";
 
 //#region src/handler.d.ts
 
@@ -231,72 +231,72 @@ declare class ActivityDefinitionNotFoundError extends WorkerError {
  */
 declare class ActivityInputValidationError extends WorkerError {
   readonly activityName: string;
-  readonly zodError: z.ZodError;
-  constructor(activityName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(activityName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when activity output validation fails
  */
 declare class ActivityOutputValidationError extends WorkerError {
   readonly activityName: string;
-  readonly zodError: z.ZodError;
-  constructor(activityName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(activityName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when workflow input validation fails
  */
 declare class WorkflowInputValidationError extends WorkerError {
   readonly workflowName: string;
-  readonly zodError: z.ZodError;
-  constructor(workflowName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(workflowName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when workflow output validation fails
  */
 declare class WorkflowOutputValidationError extends WorkerError {
   readonly workflowName: string;
-  readonly zodError: z.ZodError;
-  constructor(workflowName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(workflowName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when signal input validation fails
  */
 declare class SignalInputValidationError extends WorkerError {
   readonly signalName: string;
-  readonly zodError: z.ZodError;
-  constructor(signalName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(signalName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when query input validation fails
  */
 declare class QueryInputValidationError extends WorkerError {
   readonly queryName: string;
-  readonly zodError: z.ZodError;
-  constructor(queryName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(queryName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when query output validation fails
  */
 declare class QueryOutputValidationError extends WorkerError {
   readonly queryName: string;
-  readonly zodError: z.ZodError;
-  constructor(queryName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(queryName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when update input validation fails
  */
 declare class UpdateInputValidationError extends WorkerError {
   readonly updateName: string;
-  readonly zodError: z.ZodError;
-  constructor(updateName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(updateName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 /**
  * Error thrown when update output validation fails
  */
 declare class UpdateOutputValidationError extends WorkerError {
   readonly updateName: string;
-  readonly zodError: z.ZodError;
-  constructor(updateName: string, zodError: z.ZodError);
+  readonly issues: ReadonlyArray<StandardSchemaV1.Issue>;
+  constructor(updateName: string, issues: ReadonlyArray<StandardSchemaV1.Issue>);
 }
 //#endregion
 export { declareActivitiesHandler as C, WorkflowImplementation as S, QueryHandlerImplementation as _, QueryInputValidationError as a, UpdateHandlerImplementation as b, UpdateInputValidationError as c, WorkflowInputValidationError as d, WorkflowOutputValidationError as f, DeclareWorkflowOptions as g, DeclareActivitiesHandlerOptions as h, ActivityOutputValidationError as i, UpdateOutputValidationError as l, ActivityImplementations as m, ActivityImplementationNotFoundError as n, QueryOutputValidationError as o, ActivitiesHandler as p, ActivityInputValidationError as r, SignalInputValidationError as s, ActivityDefinitionNotFoundError as t, WorkerError as u, RawActivityImplementation as v, declareWorkflow as w, WorkflowContext as x, SignalHandlerImplementation as y };