@btravstack/temporal-worker 0.35.1 → 0.36.0

package/README.md

@@ -222,17 +222,17 @@ optional peers. See
 and the module lists (`imports`, `provides`, `exports`, `needs`). It is the
 only way to compose the starter, which is not exported:
 
-| Option          | What it is                                                                                                              |
-| --------------- | ----------------------------------------------------------------------------------------------------------------------- |
-| `contract`      | the `temporal-contract` contract; the task queue this worker polls is read off it                                       |
-| `activities`    | the activities provider — what `TemporalActivities(contract)(...)` returns for this contract                            |
-| `workflows`     | where the sandbox's code comes from: `{ workflowsPath }` or `{ workflowBundle }`                                        |
-| `address`       | pins the service instead of reading `TEMPORAL_ADDRESS`                                                                  |
-| `namespace`     | pins the namespace instead of reading `TEMPORAL_NAMESPACE`                                                              |
-| `gracePeriod`   | pins `TEMPORAL_GRACE_PERIOD_MS` — Temporal's `shutdownGraceTime`, a `Duration` (default `10_000` ms)                    |
-| `forceAfter`    | pins `TEMPORAL_FORCE_AFTER_MS` — Temporal's `shutdownForceTime` (default `15_000` ms); keep it under `DRAIN_TIMEOUT_MS` |
-| `unit`          | `{ activity }` — the module the worker forks around every activity it dispatches, seeded with the validated input       |
-| `dataConverter` | the application's port for the `DataConverter` (payload codecs) the worker and its clients share                        |
+| Option          | What it is                                                                                                                           |
+| --------------- | ------------------------------------------------------------------------------------------------------------------------------------ |
+| `contract`      | the `temporal-contract` contract; the task queue this worker polls is read off it                                                    |
+| `activities`    | the activities provider — what `TemporalActivities(contract)(...)` returns for this contract                                         |
+| `workflows`     | where the sandbox's code comes from: `{ workflowsPath }` or `{ workflowBundle }`; required unless the contract declares no workflows |
+| `address`       | pins the service instead of reading `TEMPORAL_ADDRESS`                                                                               |
+| `namespace`     | pins the namespace instead of reading `TEMPORAL_NAMESPACE`                                                                           |
+| `gracePeriod`   | pins `TEMPORAL_GRACE_PERIOD_MS` — Temporal's `shutdownGraceTime`, a `Duration` (default `10_000` ms)                                 |
+| `forceAfter`    | pins `TEMPORAL_FORCE_AFTER_MS` — Temporal's `shutdownForceTime` (default `15_000` ms); keep it under `DRAIN_TIMEOUT_MS`              |
+| `unit`          | `{ activity }` — the module the worker forks around every activity it dispatches, seeded with the validated input                    |
+| `dataConverter` | the application's port for the `DataConverter` (payload codecs) the worker and its clients share                                     |
 
 The full table — required/optional, defaults, and the reasoning — lives on
 [the reference page](https://btravstack.github.io/btravstack/reference/temporal-worker),

package/dist/index.d.mts

@@ -223,6 +223,16 @@ type TemporalTuning<Unit extends AnyUnitModule | undefined = undefined, Converte
    */
   readonly dataConverter?: Converter;
 };
+/**
+ * The workflow source a worker needs: required when the contract declares a
+ * workflow, which the worker would otherwise boot and never run, and optional
+ * only for a contract that declares none (an activity-only worker).
+ */
+type WorkflowsOption<C extends ContractDefinition> = [keyof C["workflows"]] extends [never] ? {
+  readonly workflows?: WorkflowSource;
+} : {
+  readonly workflows: WorkflowSource;
+};
 type TemporalOptions<C extends ContractDefinition, Unit extends AnyUnitModule | undefined = undefined, Converter extends DataConverterPort = never> = TemporalTuning<Unit, Converter> & {
   /**
    * The contract; the task queue this worker polls is read off it, and the
@@ -230,8 +240,7 @@ type TemporalOptions<C extends ContractDefinition, Unit extends AnyUnitModule |
    * `declareActivitiesHandler` itself, with its unit middleware in place.
    */
   readonly contract: C;
-  readonly workflows: WorkflowSource;
-};
+} & WorkflowsOption<C>;
 //#endregion
 //#region src/temporal-module.d.ts
 /** The starter's own module, as the sugar adds it to the application's imports. */
@@ -243,7 +252,6 @@ type Provides<P extends readonly AnyProvider[], C extends ContractDefinition, Ac
 type TemporalModuleOptions<C extends ContractDefinition, ActivitiesError, ActivitiesNeeds, Declared, Unit extends AnyUnitModule | undefined, I extends readonly AnyModule[], P extends readonly AnyProvider[], X extends readonly Exportable<Imports<I, C, Unit, Converter>, Provides<P, C, ActivitiesError, ActivitiesNeeds>>[], N extends readonly AnyPort[] | undefined, Converter extends DataConverterPort = never> = TemporalTuning<Unit, Converter> & {
   /** The `temporal-contract` contract; the task queue this worker polls is read off it. */
   readonly contract: C;
-  readonly workflows: WorkflowSource;
   /**
    * The application's activity implementations — what
    * `TemporalActivities(contract)(…)` returns. Its `_declaredUnit` phantom
@@ -262,7 +270,7 @@ type TemporalModuleOptions<C extends ContractDefinition, ActivitiesError, Activi
    * over the augmented tuples below, so forgetting one is an error at THIS call.
    */
   readonly needs?: N;
-} & NeedsGate<Imports<I, C, Unit, Converter>, Provides<P, C, ActivitiesError, ActivitiesNeeds>, N> & UnitGate<Unit, Declared>;
+} & WorkflowsOption<C> & NeedsGate<Imports<I, C, Unit, Converter>, Provides<P, C, ActivitiesError, ActivitiesNeeds>, N> & UnitGate<Unit, Declared>;
 /**
  * `Module(name)({...})` for a Temporal worker deployment: everything a di module
  * takes, plus the contract, the activities provider and the workflow source. The

package/dist/index.mjs

@@ -279,7 +279,7 @@ const createWorker = (host, connection, config, activities, options, observers,
 		connection,
 		namespace,
 		taskQueue,
-		...options.workflows,
+		...options.workflows ?? {},
 		activities: handler,
 		shutdownGraceTime: config.gracePeriodMs,
 		shutdownForceTime: config.forceAfterMs,

package/dist/schedule.d.mts

@@ -1,5 +1,5 @@
 import { AsyncResult } from "unthrown";
-import { ScheduleNotFoundError, TypedScheduleClient, TypedScheduleCreateOptions, WorkflowNotInContractError, WorkflowValidationError } from "@temporal-contract/client";
+import { ScheduleNotFoundError, TypedScheduleClient, TypedScheduleCreateOptions, WorkflowValidationError } from "@temporal-contract/client";
 import { ContractDefinition } from "@temporal-contract/contract";
 //#region src/schedule.d.ts
 /** Whether the schedule had to be created, or was already there and had its spec reconciled. */
@@ -50,5 +50,5 @@ export type ScheduleOutcome = "created" | "updated";
  * });
  * ```
  */
-export declare const ensureSchedule: <C extends ContractDefinition, W extends keyof C["workflows"] & string>(schedules: TypedScheduleClient<C>, workflow: W, options: TypedScheduleCreateOptions<C, W>) => AsyncResult<ScheduleOutcome, WorkflowNotInContractError | WorkflowValidationError | ScheduleNotFoundError>;
+export declare const ensureSchedule: <C extends ContractDefinition, W extends keyof C["workflows"] & string>(schedules: TypedScheduleClient<C>, workflow: W, options: TypedScheduleCreateOptions<C, W>) => AsyncResult<ScheduleOutcome, WorkflowValidationError | ScheduleNotFoundError>;
 //#endregion

package/dist/schedule.mjs

@@ -56,6 +56,6 @@ const ensureSchedule = (schedules, workflow, options) => schedules.create(workfl
 		args: [options.args]
 	},
 	...options.policies === void 0 ? {} : { policies: options.policies }
-})).map(() => "updated")).with(P.tag("@temporal-contract/WorkflowNotInContractError"), (error) => ErrAsync(error)).with(P.tag("@temporal-contract/WorkflowValidationError"), (error) => ErrAsync(error)));
+})).map(() => "updated")).with(P.tag("@temporal-contract/WorkflowValidationError"), (error) => ErrAsync(error)));
 //#endregion
 export { ensureSchedule };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/temporal-worker",
-  "version": "0.35.1",
+  "version": "0.36.0",
   "description": "The Temporal worker runtime for @btravstack/core: one unit per activity attempt, and a drain that honours the kernel's deadline",
   "keywords": [
     "graceful-shutdown",
@@ -52,15 +52,15 @@
     }
   },
   "devDependencies": {
-    "@btravstack/config": "0.35.1",
-    "@btravstack/core": "0.35.1",
-    "@btravstack/di": "0.35.1",
+    "@btravstack/config": "0.36.0",
+    "@btravstack/core": "0.36.0",
+    "@btravstack/di": "0.36.0",
     "@btravstack/internal-test-infra": "0.0.0",
-    "@btravstack/testing": "0.35.1",
+    "@btravstack/testing": "0.36.0",
     "@btravstack/tsconfig": "0.4.0",
-    "@temporal-contract/client": "8.0.0-beta.11",
-    "@temporal-contract/contract": "8.0.0-beta.11",
-    "@temporal-contract/worker": "8.0.0-beta.11",
+    "@temporal-contract/client": "8.0.0-beta.14",
+    "@temporal-contract/contract": "8.0.0-beta.14",
+    "@temporal-contract/worker": "8.0.0-beta.14",
     "@temporalio/activity": "1.24.0",
     "@temporalio/client": "1.24.0",
     "@temporalio/common": "1.24.0",
@@ -78,17 +78,17 @@
     "zod": "4.6.6"
   },
   "peerDependencies": {
-    "@btravstack/config": "^0.35.1",
-    "@btravstack/core": "^0.35.1",
-    "@btravstack/di": "^0.35.1",
-    "@temporal-contract/client": "^8.0.0-beta.9",
-    "@temporal-contract/contract": "^8.0.0-beta.9",
-    "@temporal-contract/worker": "^8.0.0-beta.9",
-    "@temporalio/activity": "^1.22.0",
-    "@temporalio/common": "^1.22.0",
-    "@temporalio/worker": "^1.22.0",
+    "@btravstack/config": "^0.36.0",
+    "@btravstack/core": "^0.36.0",
+    "@btravstack/di": "^0.36.0",
+    "@temporal-contract/client": "^8.0.0-beta.14",
+    "@temporal-contract/contract": "^8.0.0-beta.14",
+    "@temporal-contract/worker": "^8.0.0-beta.14",
+    "@temporalio/activity": "^1.24.0",
+    "@temporalio/common": "^1.24.0",
+    "@temporalio/worker": "^1.24.0",
     "testcontainers": "^12.0.0",
-    "unthrown": "^5.7.0",
+    "unthrown": "^5.11.0",
     "vitest": ">=3.2.0"
   },
   "peerDependenciesMeta": {