@btravstack/temporal-worker 0.34.0 → 0.36.0

package/README.md

@@ -222,16 +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       |
+| 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

@@ -2,7 +2,7 @@ import { AnyUnitModule, Refuse, Runtime, RuntimePort, UnitGate, UnitNeedsOf, Uni
 import { AnyModule, AnyPort, AnyProvider, Exportable, Module, NeedsGate, PortClassOf, PortInstance, Provider, Scope, ServiceOf } from "@btravstack/di";
 import { ConfigInvalid, EnvReading } from "@btravstack/config";
 import { DeclareActivitiesHandlerOptions, EmptyContext } from "@temporal-contract/worker/activity";
-import { Duration } from "@temporalio/common";
+import { DataConverter, Duration } from "@temporalio/common";
 import { NativeConnection, Worker, WorkflowBundleWithSourceMap } from "@temporalio/worker";
 import { ContractDefinition } from "@temporal-contract/contract";
 //#region src/workflow-activities.d.ts
@@ -179,12 +179,14 @@ type ActivitiesOf<C extends ContractDefinition, TContext extends Record<string,
 type ActivitiesPortOf<C extends ContractDefinition> = PortClassOf<"TemporalActivities", ActivitiesOf<C>>;
 /** The activities port's instance for `C` — the module's one need. */
 type ActivitiesInstanceOf<C extends ContractDefinition> = PortInstance<"TemporalActivities", ActivitiesOf<C>>;
+/** An application-declared port carrying the Temporal `DataConverter` a worker and its clients share. */
+type DataConverterPort = PortClassOf<string, DataConverter>;
 /**
  * What a Temporal deployment tunes, shared verbatim by the starter and
  * `TemporalModule` — spelled once so the two cannot drift, which is what a
  * second copy of an option list always eventually does.
  */
-type TemporalTuning<Unit extends AnyUnitModule | undefined = undefined> = {
+type TemporalTuning<Unit extends AnyUnitModule | undefined = undefined, Converter extends DataConverterPort = never> = {
   /** Pins `TemporalConfig.address` instead of reading `TEMPORAL_ADDRESS`. */
   readonly address?: string;
   /** Pins `TemporalConfig.namespace` instead of reading `TEMPORAL_NAMESPACE`. */
@@ -213,28 +215,43 @@ type TemporalTuning<Unit extends AnyUnitModule | undefined = undefined> = {
   readonly unit?: {
     readonly activity?: Unit;
   };
+  /**
+   * The application's port for the `DataConverter` handed to `Worker.create`
+   * — a payload codec encrypting each payload, for instance. Every client of
+   * the worker's workflows must resolve the same one, or each side reads the
+   * other's payloads as ciphertext. The port joins this module's needs.
+   */
+  readonly dataConverter?: Converter;
 };
-type TemporalOptions<C extends ContractDefinition, Unit extends AnyUnitModule | undefined = undefined> = TemporalTuning<Unit> & {
+/**
+ * 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
    * activities port is typed by it. The starter calls
    * `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. */
-type TemporalStarter<C extends ContractDefinition, Unit extends AnyUnitModule | undefined> = Module<TemporalRuntime | TemporalConfig | TemporalConnection, ConfigInvalid | TemporalUnreachable, EnvReading<never, "TEMPORAL_ADDRESS" | "TEMPORAL_NAMESPACE" | "TEMPORAL_GRACE_PERIOD_MS" | "TEMPORAL_FORCE_AFTER_MS"> | Scope | ActivitiesInstanceOf<C> | UnitNeedsOf$1<Unit>>;
+type TemporalStarter<C extends ContractDefinition, Unit extends AnyUnitModule | undefined, Converter extends DataConverterPort> = Module<TemporalRuntime | TemporalConfig | TemporalConnection, ConfigInvalid | TemporalUnreachable, EnvReading<never, "TEMPORAL_ADDRESS" | "TEMPORAL_NAMESPACE" | "TEMPORAL_GRACE_PERIOD_MS" | "TEMPORAL_FORCE_AFTER_MS"> | Scope | ActivitiesInstanceOf<C> | UnitNeedsOf$1<Unit> | InstanceType<Converter>>;
 /** The application's imports plus the starter — the tuple `Module(name)` is handed. */
-type Imports<I extends readonly AnyModule[], C extends ContractDefinition, Unit extends AnyUnitModule | undefined> = readonly [...I, TemporalStarter<C, Unit>];
+type Imports<I extends readonly AnyModule[], C extends ContractDefinition, Unit extends AnyUnitModule | undefined, Converter extends DataConverterPort> = readonly [...I, TemporalStarter<C, Unit, Converter>];
 /** The activities provider plus the application's own — the tuple `Module(name)` is handed. */
 type Provides<P extends readonly AnyProvider[], C extends ContractDefinition, ActivitiesError, ActivitiesNeeds> = readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P];
-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>, Provides<P, C, ActivitiesError, ActivitiesNeeds>>[], N extends readonly AnyPort[] | undefined> = TemporalTuning<Unit> & {
+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
@@ -253,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>, 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
@@ -271,7 +288,7 @@ type TemporalModuleOptions<C extends ContractDefinition, ActivitiesError, Activi
  * await runMain(OrderTemporalWorker);
  * ```
  */
-export declare const TemporalModule: <const Name extends string>(name: Name) => <C extends ContractDefinition, ActivitiesError, ActivitiesNeeds, Declared = never, Unit extends AnyUnitModule | undefined = undefined, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, C, Unit>, Provides<P, C, ActivitiesError, ActivitiesNeeds>>[] = [], const N extends readonly AnyPort[] | undefined = undefined>(options: TemporalModuleOptions<C, ActivitiesError, ActivitiesNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof TemporalRuntime, ...((import("@btravstack/core").HealthChecks extends ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> extends (infer T_2) ? T_2 extends Extract<(readonly [typeof TemporalRuntime, ...((import("@btravstack/core").HealthChecks extends ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> ? T_2 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [typeof TemporalRuntime, ...((import("@btravstack/core").HealthChecks extends ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[1] | ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_4 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[1], Exclude<((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_5) ? T_5 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[2], ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_5) ? T_5 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]> | Exclude<((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[2], ((readonly [...I, TemporalStarter<C, Unit>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_5) ? T_5 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]>>;
+export declare const TemporalModule: <const Name extends string>(name: Name) => <C extends ContractDefinition, ActivitiesError, ActivitiesNeeds, Declared = never, Unit extends AnyUnitModule | undefined = undefined, const I extends readonly AnyModule[] = [], const P extends readonly AnyProvider[] = [], const X extends readonly Exportable<Imports<I, C, Unit, Converter>, Provides<P, C, ActivitiesError, ActivitiesNeeds>>[] = [], const N extends readonly AnyPort[] | undefined = undefined, Converter extends DataConverterPort = never>(options: TemporalModuleOptions<C, ActivitiesError, ActivitiesNeeds, Declared, Unit, I, P, X, N, Converter>) => Module<(Extract<(readonly [typeof TemporalRuntime, ...((import("@btravstack/core").HealthChecks extends ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> extends (infer T_2) ? T_2 extends Extract<(readonly [typeof TemporalRuntime, ...((import("@btravstack/core").HealthChecks extends ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number], AnyModule> ? T_2 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [typeof TemporalRuntime, ...((import("@btravstack/core").HealthChecks extends ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").HealthChecks : never) | (import("@btravstack/core").Logger extends ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T) ? T extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T extends Module<infer X_1, infer _E, infer _N> ? X_1 : never : never : never) | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 extends Provider<infer X_2, infer _E_1, infer _N_1> ? X_2 : never : never : never) ? typeof import("@btravstack/core").Logger : never))[], ...X])[number] extends (infer E_1) ? E_1 extends AnyPort ? InstanceType<E_1> : E_1 extends AnyProvider ? InstanceType<E_1["port"]> : never : never), ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_3) ? T_3 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_3 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[1] | ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T_4) ? T_4 extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T_4 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[1], Exclude<((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_5) ? T_5 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[2], ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_5) ? T_5 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]> | Exclude<((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[2], ((readonly [...I, TemporalStarter<C, Unit, Converter>])[number] extends (infer T_6) ? T_6 extends (readonly [...I, TemporalStarter<C, Unit, Converter>])[number] ? T_6 extends Module<infer X_3, infer E, infer N_1> ? readonly [X_3, E, N_1] : never : never : never)[0] | ((readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] extends (infer T_5) ? T_5 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_5 extends Provider<infer P_1, infer E_2, infer N_2> ? readonly [P_1, E_2, N_2] : never : never : never)[0]>>;
 /** One piece of the activities record — what `TemporalWorkflowActivities(contract, key)(…)` returns. */
 type PieceOf<C extends ContractDefinition> = { readonly [K in ActivitiesKeyOf<C>]: {
   readonly port: WorkflowActivitiesPortOf<C, K>;

package/dist/index.mjs

@@ -245,13 +245,14 @@ const temporal = (options) => {
 					connection: TemporalConnection,
 					config: TemporalConfig,
 					activities,
-					observers: Observers
+					observers: Observers,
+					...options.dataConverter === void 0 ? {} : { dataConverter: options.dataConverter }
 				},
-				sync: ({ connection, config: bound, activities: impls, observers }) => ({
+				sync: ({ connection, config: bound, activities: impls, observers, dataConverter }) => ({
 					name: "temporal",
 					resolves: [],
 					units: unitsOf(options.unit?.activity, impls),
-					start: (host) => createWorker(host, connection, bound, impls, options, observers)
+					start: (host) => createWorker(host, connection, bound, impls, options, observers, dataConverter)
 				})
 			})
 		],
@@ -267,7 +268,7 @@ const startFailed = (cause) => new RuntimeStartFailed({
 	cause
 });
 const heldByWorker = (cause) => cause instanceof Error && cause.name === "IllegalStateError";
-const createWorker = (host, connection, config, activities, options, observers) => {
+const createWorker = (host, connection, config, activities, options, observers, dataConverter) => {
 	const { taskQueue } = options.contract;
 	const { namespace } = config;
 	return fromThrowable(() => declareActivitiesHandler({
@@ -278,10 +279,11 @@ const createWorker = (host, connection, config, activities, options, observers)
 		connection,
 		namespace,
 		taskQueue,
-		...options.workflows,
+		...options.workflows ?? {},
 		activities: handler,
 		shutdownGraceTime: config.gracePeriodMs,
-		shutdownForceTime: config.forceAfterMs
+		shutdownForceTime: config.forceAfterMs,
+		...dataConverter === void 0 ? {} : { dataConverter }
 	}), startFailed)).map((worker) => poll(worker, taskQueue, namespace, connection));
 };
 /**

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.34.0",
+  "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,43 +52,43 @@
     }
   },
   "devDependencies": {
-    "@btravstack/config": "0.34.0",
-    "@btravstack/core": "0.34.0",
-    "@btravstack/di": "0.34.0",
+    "@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.34.0",
+    "@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",
     "@temporalio/worker": "1.24.0",
     "@temporalio/workflow": "1.24.0",
-    "@types/node": "26.6.4",
+    "@types/node": "26.6.5",
     "@unthrown/vitest": "5.12.1",
     "@vitest/coverage-v8": "5.0.3",
     "testcontainers": "12.2.0",
-    "tsdown": "0.23.0",
+    "tsdown": "0.23.1",
     "typescript": "7.0.2",
     "typescript-consumer": "npm:typescript@5.9.3",
     "unthrown": "5.12.1",
     "vitest": "5.0.3",
-    "zod": "4.6.5"
+    "zod": "4.6.6"
   },
   "peerDependencies": {
-    "@btravstack/config": "^0.34.0",
-    "@btravstack/core": "^0.34.0",
-    "@btravstack/di": "^0.34.0",
-    "@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": {