@btravstack/temporal-worker 0.48.1 → 0.49.0

package/README.md

@@ -221,6 +221,8 @@ optional peers. See
 
 ## Options
 
+- `taskQueue`: pins `TEMPORAL_TASK_QUEUE`, defaulting to the contract queue; see the [reference](https://btravstack.github.io/btravstack/reference/temporal-worker).
+
 `TemporalModule(name)({...})` takes the starter's options plus `activities`
 and the module lists (`imports`, `provides`, `exports`, `needs`). It is the
 only way to compose the starter, which is not exported:

package/dist/index.d.mts

@@ -141,6 +141,7 @@ declare const TemporalConfig_base: import("@btravstack/di").PortClass<"TemporalC
 export declare class TemporalConfig extends TemporalConfig_base<{
   readonly address: string;
   readonly namespace: string;
+  readonly taskQueue: string;
   /** Temporal's `shutdownGraceTime`, in milliseconds. */
   readonly gracePeriodMs: number;
   /** Temporal's `shutdownForceTime`, in milliseconds. */
@@ -192,6 +193,8 @@ type TemporalTuning<Unit extends AnyUnitModule | undefined = undefined, Converte
   readonly address?: string;
   /** Pins `TemporalConfig.namespace` instead of reading `TEMPORAL_NAMESPACE`. */
   readonly namespace?: string;
+  /** Physical polling queue, independent of the logical contract and DI identities. Pins TEMPORAL_TASK_QUEUE. */
+  readonly taskQueue?: string;
   /**
    * Pins `TemporalConfig.forceAfterMs` instead of reading
    * `TEMPORAL_FORCE_AFTER_MS` (default `15_000`) — Temporal's
@@ -245,7 +248,7 @@ type TemporalOptions<C extends ContractDefinition, Unit extends AnyUnitModule |
 //#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, 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>>;
+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_TASK_QUEUE" | "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, Converter extends DataConverterPort> = readonly [...I, TemporalStarter<C, Unit, Converter>];
 /** The activities provider plus the application's own — the tuple `Module(name)` is handed. */

package/dist/index.mjs

@@ -1,11 +1,12 @@
 import { Observers, RuntimePort, RuntimeStartFailed, composeByPrefix, dispatchUnit, infrastructureExports, mintPiece, noObserverMember, releasedBy, withUnitRecord } from "@btravstack/core";
 import { Module, Port, Provider } from "@btravstack/di";
-import { Config, Env } from "@btravstack/config";
+import { Config, ConfigFieldInvalid, Env } from "@btravstack/config";
 import { declareActivitiesHandler } from "@temporal-contract/worker/activity";
 import { msToNumber } from "@temporalio/common";
 import { NativeConnection, Worker } from "@temporalio/worker";
 import { Ok, OkAsync, TaggedError, fromPromise, fromSafePromise, fromThrowable } from "unthrown";
 import { activityInfo } from "@temporalio/activity";
+import { defineContractBinding } from "@temporal-contract/contract";
 //#region src/unit.ts
 /**
 * One entry of the activities record — a contract-global activity's own
@@ -154,6 +155,17 @@ const metaFor = () => {
 	};
 };
 //#endregion
+//#region src/task-queue.ts
+const taskQueueField = (contract) => {
+	const field = Config.string("TEMPORAL_TASK_QUEUE", { default: contract.taskQueue });
+	const check = (taskQueue) => fromThrowable(() => defineContractBinding(contract, { taskQueue }).taskQueue, (cause) => new ConfigFieldInvalid({ reason: String(cause) }))();
+	return {
+		variable: field.variable,
+		parse: (raw) => field.parse(raw).flatMap(check),
+		check
+	};
+};
+//#endregion
 //#region src/temporal-runtime.ts
 /**
 * Where the Temporal service is, as a service: the starter binds it from the
@@ -214,6 +226,7 @@ const temporal = (options) => {
 	const config = Config.provider(TemporalConfig)(Config.object({
 		address: Config.pinned(address, Config.string("TEMPORAL_ADDRESS", { default: "127.0.0.1:7233" })),
 		namespace: Config.pinned(namespace, Config.string("TEMPORAL_NAMESPACE", { default: "default" })),
+		taskQueue: Config.pinned(options.taskQueue, taskQueueField(options.contract)),
 		gracePeriodMs: Config.pinned(durationMs(options.gracePeriod), Config.integer("TEMPORAL_GRACE_PERIOD_MS", {
 			default: DEFAULT_GRACE_MS,
 			min: 0
@@ -269,8 +282,7 @@ const startFailed = (cause) => new RuntimeStartFailed({
 });
 const heldByWorker = (cause) => cause instanceof Error && cause.name === "IllegalStateError";
 const createWorker = (host, connection, config, activities, options, observers, dataConverter) => {
-	const { taskQueue } = options.contract;
-	const { namespace } = config;
+	const { namespace, taskQueue } = config;
 	return fromThrowable(() => declareActivitiesHandler({
 		contract: options.contract,
 		middleware: activityUnits(host, observers, (key) => forkOf(activities[key]) ?? options.unit?.activity),

package/dist/schedule.d.mts

@@ -1,6 +1,6 @@
 import { AsyncResult } from "unthrown";
-import { ScheduleNotFoundError, TypedScheduleClient, TypedScheduleCreateOptions, WorkflowValidationError } from "@temporal-contract/client";
 import { ContractDefinition } from "@temporal-contract/contract";
+import { ScheduleNotFoundError, TypedScheduleClient, TypedScheduleCreateOptions, WorkflowValidationError } from "@temporal-contract/client";
 //#region src/schedule.d.ts
 /** Whether the schedule had to be created, or was already there and had its spec reconciled. */
 export type ScheduleOutcome = "created" | "updated";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/temporal-worker",
-  "version": "0.48.1",
+  "version": "0.49.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.48.1",
-    "@btravstack/core": "0.48.1",
-    "@btravstack/di": "0.48.1",
+    "@btravstack/config": "0.49.0",
+    "@btravstack/core": "0.49.0",
+    "@btravstack/di": "0.49.0",
     "@btravstack/internal-test-infra": "0.0.0",
-    "@btravstack/testing": "0.48.1",
+    "@btravstack/testing": "0.49.0",
     "@btravstack/tsconfig": "0.4.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",
+    "@temporal-contract/client": "8.0.0-beta.15",
+    "@temporal-contract/contract": "8.0.0-beta.15",
+    "@temporal-contract/worker": "8.0.0-beta.15",
     "@temporalio/activity": "1.24.0",
     "@temporalio/client": "1.24.0",
     "@temporalio/common": "1.24.0",
@@ -78,12 +78,12 @@
     "zod": "4.6.7"
   },
   "peerDependencies": {
-    "@btravstack/config": "^0.48.1",
-    "@btravstack/core": "^0.48.1",
-    "@btravstack/di": "^0.48.1",
-    "@temporal-contract/client": "^8.0.0-beta.14",
-    "@temporal-contract/contract": "^8.0.0-beta.14",
-    "@temporal-contract/worker": "^8.0.0-beta.14",
+    "@btravstack/config": "^0.49.0",
+    "@btravstack/core": "^0.49.0",
+    "@btravstack/di": "^0.49.0",
+    "@temporal-contract/client": "^8.0.0-beta.15",
+    "@temporal-contract/contract": "^8.0.0-beta.15",
+    "@temporal-contract/worker": "^8.0.0-beta.15",
     "@temporalio/activity": "^1.24.0",
     "@temporalio/common": "^1.24.0",
     "@temporalio/worker": "^1.24.0",