@btravstack/temporal-worker 0.13.0 → 0.15.0

package/dist/index.cjs

@@ -165,9 +165,9 @@ const metaFor = () => {
 //#region src/temporal-runtime.ts
 /**
 * Where the Temporal service is, as a service: `temporal()` binds it from the
-* environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`) and
-* `TEMPORAL_NAMESPACE` (default `default`) — unless pinned, and anything else
-* in the graph may read it.
+* environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`),
+* `TEMPORAL_NAMESPACE` (default `default`) and the shutdown budgets below —
+* unless pinned, and anything else in the graph may read it.
 */
 var TemporalConfig = class extends (0, _btravstack_di.Port)("TemporalConfig") {};
 /**
@@ -206,14 +206,14 @@ const DEFAULT_FORCE_MS = 15e3;
 const durationMs = (duration) => duration === void 0 ? void 0 : (0, _temporalio_common.msToNumber)(duration);
 /**
 * The Temporal starter: a module providing the runtime, its configuration
-* (bound from `TEMPORAL_ADDRESS` / `TEMPORAL_NAMESPACE` unless pinned) and the
-* connection (a resource opened with the scope and closed with it; a service
-* that will not answer is a modeled `TemporalUnreachable`). Import it next to
-* the application, export `TemporalRuntime`, provide the activities — the
+* (bound from the `TEMPORAL_*` variables unless pinned) and the connection (a
+* resource opened with the scope and closed with it; a service that will not
+* answer is a modeled `TemporalUnreachable`). Import it next to the
+* application, export `TemporalRuntime`, provide the activities — the
 * activities port is a need of this module.
 *
-* With both configuration fields pinned the module reads nothing from the
-* environment; pin only one and the other still comes from it.
+* Each configuration field is pinned on its own: a pinned field reads nothing
+* from the environment, and a field left unpinned still does.
 */
 const temporal = (options) => {
 	const { address, namespace } = options;
@@ -289,26 +289,39 @@ const createWorker = (host, connection, config, activities, options, observers)
 		shutdownForceTime: config.forceAfterMs
 	}), startFailed)).map((worker) => poll(worker, taskQueue, namespace));
 };
+/**
+* The `Serving` over a started worker.
+*
+* @internal Exported for `temporal-runtime.spec.ts` alone: the `stopped`
+* channel is about a worker's `run()` REJECTING mid-flight, and there is no way
+* to make a real one do that without taking the shared Temporal server down for
+* every other spec. A stub worker is what reaches that arm.
+*/
 const poll = (worker, taskQueue, namespace) => {
 	const running = (0, unthrown.fromSafePromise)(worker.run());
 	const stopPolling = () => {
 		if (worker.getState() === "RUNNING") worker.shutdown();
 	};
 	let deadline;
-	const stopped = () => deadline === void 0 ? running : (0, _btravstack_core.releasedBy)(deadline, running);
+	const awaitRun = () => deadline === void 0 ? running : (0, _btravstack_core.releasedBy)(deadline, running);
+	let asked = false;
+	const withdrawn = () => (0, unthrown.fromSafePromise)(new Promise(() => {}));
 	return {
 		info: {
 			taskQueue,
 			namespace
 		},
+		stopped: () => running.recoverDefect(() => (0, unthrown.Ok)(void 0)).flatMap(() => asked ? withdrawn() : (0, unthrown.OkAsync)()),
 		drain: (signal) => {
+			asked = true;
 			deadline = signal;
 			stopPolling();
-			return stopped();
+			return awaitRun();
 		},
 		stop: () => {
+			asked = true;
 			stopPolling();
-			return stopped();
+			return awaitRun();
 		}
 	};
 };

package/dist/index.d.cts

@@ -64,7 +64,7 @@ type ActivityInputInstance = PortInstance<"ActivityInput", unknown>;
  * at the type level, the move `TemporalActivitiesPort` makes, so a module built
  * for one contract cannot read another's input.
  */
-declare const ActivityInput: <C extends ContractDefinition>(contract: C) => ActivityInputPortOf<C>;
+export declare const ActivityInput: <C extends ContractDefinition>(contract: C) => ActivityInputPortOf<C>;
 /** The prefix a piece's port id carries; the composing form strips it to recover the key. */
 declare const WORKFLOW_ACTIVITIES_PREFIX = "TemporalWorkflowActivities:";
 /**
@@ -107,7 +107,7 @@ type ScopedActivitiesOf<C extends ContractDefinition, K extends ActivitiesKeyOf<
  * out of the fork the attempt opened; the root's `unit.activity` module must
  * export every one of them.
  */
-declare const TemporalWorkflowActivities: <C extends ContractDefinition, const K extends ActivitiesKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
+export declare const TemporalWorkflowActivities: <C extends ContractDefinition, const K extends ActivitiesKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
   readonly inject: D;
   /** The unit-scoped ports these activities read off `context.unit`. */
   readonly unit?: U;
@@ -134,11 +134,11 @@ type WorkflowSource = {
 declare const TemporalConfig_base: import("@btravstack/di").PortClass<"TemporalConfig">;
 /**
  * Where the Temporal service is, as a service: `temporal()` binds it from the
- * environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`) and
- * `TEMPORAL_NAMESPACE` (default `default`) — unless pinned, and anything else
- * in the graph may read it.
+ * environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`),
+ * `TEMPORAL_NAMESPACE` (default `default`) and the shutdown budgets below —
+ * unless pinned, and anything else in the graph may read it.
  */
-declare class TemporalConfig extends TemporalConfig_base<{
+export declare class TemporalConfig extends TemporalConfig_base<{
   readonly address: string;
   readonly namespace: string;
   /** Temporal's `shutdownGraceTime`, in milliseconds. */
@@ -151,7 +151,7 @@ declare const TemporalConnection_base: import("@btravstack/di").PortClass<"Tempo
  * The connection, as a resource of the graph: di opens it with the scope and
  * closes it on every exit path, startup failure included.
  */
-declare class TemporalConnection extends TemporalConnection_base<NativeConnection> {}
+export declare class TemporalConnection extends TemporalConnection_base<NativeConnection> {}
 declare const TemporalUnreachable_base: import("unthrown").TaggedErrorConstructor<"TemporalUnreachable">;
 /**
  * The service at `TemporalConfig.address` did not answer. Modeled rather than
@@ -159,14 +159,14 @@ declare const TemporalUnreachable_base: import("unthrown").TaggedErrorConstructo
  * the service is down, and neither is a bug in this code — so `runMain` exits
  * `1`, a startup `Err`, not the `70` a defect earns.
  */
-declare class TemporalUnreachable extends TemporalUnreachable_base<{
+export declare class TemporalUnreachable extends TemporalUnreachable_base<{
   readonly address: string;
   readonly cause: unknown;
 }> {
   message: string;
 }
 /** The runtime's port: what `temporal()` provides, and what the module `start` boots must export. */
-declare class TemporalRuntime extends RuntimePort<Runtime<never, TemporalInfo>> {}
+export declare class TemporalRuntime extends RuntimePort<Runtime<never, TemporalInfo>> {}
 /**
  * A module `unit.activity` may bind, as the upper bound `temporal()`
  * constrains its own `Unit` type parameter to. `Module`'s `_exports` channel
@@ -220,9 +220,10 @@ type TemporalTuning<Unit extends AnyUnitModule | undefined = undefined> = {
   readonly gracePeriod?: Duration;
   /**
    * The unit module the worker forks around every activity attempt it
-   * dispatches, with no seed. Built after the activity is invoked, torn down
-   * when the unit closes — the point where a later phase seeds it with the
-   * workflow's tenant.
+   * dispatches, seeded with the validated input on `ActivityInput(contract)`.
+   * Built after the activity is invoked, before it runs; torn down when the
+   * unit closes. What it exports is what a piece may declare on its own
+   * `unit:` record.
    */
   readonly unit?: {
     readonly activity?: Unit;
@@ -240,16 +241,16 @@ type TemporalOptions<C extends ContractDefinition, Unit extends AnyUnitModule |
 type Provided = TemporalRuntime | TemporalConfig | TemporalConnection;
 /**
  * The Temporal starter: a module providing the runtime, its configuration
- * (bound from `TEMPORAL_ADDRESS` / `TEMPORAL_NAMESPACE` unless pinned) and the
- * connection (a resource opened with the scope and closed with it; a service
- * that will not answer is a modeled `TemporalUnreachable`). Import it next to
- * the application, export `TemporalRuntime`, provide the activities — the
+ * (bound from the `TEMPORAL_*` variables unless pinned) and the connection (a
+ * resource opened with the scope and closed with it; a service that will not
+ * answer is a modeled `TemporalUnreachable`). Import it next to the
+ * application, export `TemporalRuntime`, provide the activities — the
  * activities port is a need of this module.
  *
- * With both configuration fields pinned the module reads nothing from the
- * environment; pin only one and the other still comes from it.
+ * Each configuration field is pinned on its own: a pinned field reads nothing
+ * from the environment, and a field left unpinned still does.
  */
-declare const temporal: <C extends ContractDefinition, Unit extends AnyUnitModule | undefined = undefined>(options: TemporalOptions<C, Unit>) => Module<Provided, ConfigInvalid | TemporalUnreachable, Env | Scope | ActivitiesInstanceOf<C> | UnitNeedsOf<Unit>>;
+export declare const temporal: <C extends ContractDefinition, Unit extends AnyUnitModule | undefined = undefined>(options: TemporalOptions<C, Unit>) => Module<Provided, ConfigInvalid | TemporalUnreachable, Env | Scope | ActivitiesInstanceOf<C> | UnitNeedsOf<Unit>>;
 //#endregion
 //#region src/temporal-module.d.ts
 /** The starter's own module, as the sugar adds it to the application's imports. */
@@ -298,7 +299,7 @@ type TemporalModuleOptions<C extends ContractDefinition, ActivitiesError, Activi
  * await runMain(OrderTemporalWorker);
  * ```
  */
-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[] = []>(options: TemporalModuleOptions<C, ActivitiesError, ActivitiesNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof TemporalRuntime, ...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_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 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_2) ? T_2 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((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)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[0]> | Exclude<((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[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>, Provides<P, C, ActivitiesError, ActivitiesNeeds>>[] = [], const N extends readonly AnyPort[] = []>(options: TemporalModuleOptions<C, ActivitiesError, ActivitiesNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof TemporalRuntime, ...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_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 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_2) ? T_2 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((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)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[0]> | Exclude<((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[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>;
@@ -382,6 +383,6 @@ type Compose<C extends ContractDefinition> = <const T extends readonly PieceOf<C
  * so the services record IS the activities record. Every key must be covered,
  * and two slices claiming one key are di's duplicate-provider defect at build.
  */
-declare const TemporalActivities: <C extends ContractDefinition>(contract: C) => Whole<C> & Compose<C>;
+export declare const TemporalActivities: <C extends ContractDefinition>(contract: C) => Whole<C> & Compose<C>;
 //#endregion
-export { type ActivitiesInstanceOf, type ActivitiesPortOf, ActivityInput, type ActivityInputOf, type ActivityInputPortOf, TemporalActivities, TemporalConfig, TemporalConnection, type TemporalInfo, TemporalModule, type TemporalModuleOptions, type TemporalOptions, TemporalRuntime, TemporalUnreachable, TemporalWorkflowActivities, type WorkflowActivitiesPortOf, type WorkflowSource, temporal };
+export type { ActivitiesInstanceOf, ActivitiesPortOf, ActivityInputOf, ActivityInputPortOf, TemporalInfo, TemporalModuleOptions, TemporalOptions, WorkflowActivitiesPortOf, WorkflowSource };

package/dist/index.d.mts

@@ -3,7 +3,7 @@ import { ConfigInvalid, Env } from "@btravstack/config";
 import { Runtime, RuntimePort } from "@btravstack/core";
 import { DeclareActivitiesHandlerOptions, EmptyContext } from "@temporal-contract/worker/activity";
 import { Duration } from "@temporalio/common";
-import { NativeConnection, WorkflowBundleWithSourceMap } from "@temporalio/worker";
+import { NativeConnection, Worker, WorkflowBundleWithSourceMap } from "@temporalio/worker";
 import { ContractDefinition } from "@temporal-contract/contract";
 //#region src/unit.d.ts
 /** What a bound unit module exports — the port instances an activity of that kind may read. */
@@ -64,7 +64,7 @@ type ActivityInputInstance = PortInstance<"ActivityInput", unknown>;
  * at the type level, the move `TemporalActivitiesPort` makes, so a module built
  * for one contract cannot read another's input.
  */
-declare const ActivityInput: <C extends ContractDefinition>(contract: C) => ActivityInputPortOf<C>;
+export declare const ActivityInput: <C extends ContractDefinition>(contract: C) => ActivityInputPortOf<C>;
 /** The prefix a piece's port id carries; the composing form strips it to recover the key. */
 declare const WORKFLOW_ACTIVITIES_PREFIX = "TemporalWorkflowActivities:";
 /**
@@ -107,7 +107,7 @@ type ScopedActivitiesOf<C extends ContractDefinition, K extends ActivitiesKeyOf<
  * out of the fork the attempt opened; the root's `unit.activity` module must
  * export every one of them.
  */
-declare const TemporalWorkflowActivities: <C extends ContractDefinition, const K extends ActivitiesKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
+export declare const TemporalWorkflowActivities: <C extends ContractDefinition, const K extends ActivitiesKeyOf<C>>(contract: C, key: K) => <const D extends Readonly<Record<string, AnyPort>>, const U extends Readonly<Record<string, AnyPort>> = Record<never, never>>(options: {
   readonly inject: D;
   /** The unit-scoped ports these activities read off `context.unit`. */
   readonly unit?: U;
@@ -134,11 +134,11 @@ type WorkflowSource = {
 declare const TemporalConfig_base: import("@btravstack/di").PortClass<"TemporalConfig">;
 /**
  * Where the Temporal service is, as a service: `temporal()` binds it from the
- * environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`) and
- * `TEMPORAL_NAMESPACE` (default `default`) — unless pinned, and anything else
- * in the graph may read it.
+ * environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`),
+ * `TEMPORAL_NAMESPACE` (default `default`) and the shutdown budgets below —
+ * unless pinned, and anything else in the graph may read it.
  */
-declare class TemporalConfig extends TemporalConfig_base<{
+export declare class TemporalConfig extends TemporalConfig_base<{
   readonly address: string;
   readonly namespace: string;
   /** Temporal's `shutdownGraceTime`, in milliseconds. */
@@ -151,7 +151,7 @@ declare const TemporalConnection_base: import("@btravstack/di").PortClass<"Tempo
  * The connection, as a resource of the graph: di opens it with the scope and
  * closes it on every exit path, startup failure included.
  */
-declare class TemporalConnection extends TemporalConnection_base<NativeConnection> {}
+export declare class TemporalConnection extends TemporalConnection_base<NativeConnection> {}
 declare const TemporalUnreachable_base: import("unthrown").TaggedErrorConstructor<"TemporalUnreachable">;
 /**
  * The service at `TemporalConfig.address` did not answer. Modeled rather than
@@ -159,14 +159,14 @@ declare const TemporalUnreachable_base: import("unthrown").TaggedErrorConstructo
  * the service is down, and neither is a bug in this code — so `runMain` exits
  * `1`, a startup `Err`, not the `70` a defect earns.
  */
-declare class TemporalUnreachable extends TemporalUnreachable_base<{
+export declare class TemporalUnreachable extends TemporalUnreachable_base<{
   readonly address: string;
   readonly cause: unknown;
 }> {
   message: string;
 }
 /** The runtime's port: what `temporal()` provides, and what the module `start` boots must export. */
-declare class TemporalRuntime extends RuntimePort<Runtime<never, TemporalInfo>> {}
+export declare class TemporalRuntime extends RuntimePort<Runtime<never, TemporalInfo>> {}
 /**
  * A module `unit.activity` may bind, as the upper bound `temporal()`
  * constrains its own `Unit` type parameter to. `Module`'s `_exports` channel
@@ -220,9 +220,10 @@ type TemporalTuning<Unit extends AnyUnitModule | undefined = undefined> = {
   readonly gracePeriod?: Duration;
   /**
    * The unit module the worker forks around every activity attempt it
-   * dispatches, with no seed. Built after the activity is invoked, torn down
-   * when the unit closes — the point where a later phase seeds it with the
-   * workflow's tenant.
+   * dispatches, seeded with the validated input on `ActivityInput(contract)`.
+   * Built after the activity is invoked, before it runs; torn down when the
+   * unit closes. What it exports is what a piece may declare on its own
+   * `unit:` record.
    */
   readonly unit?: {
     readonly activity?: Unit;
@@ -240,16 +241,16 @@ type TemporalOptions<C extends ContractDefinition, Unit extends AnyUnitModule |
 type Provided = TemporalRuntime | TemporalConfig | TemporalConnection;
 /**
  * The Temporal starter: a module providing the runtime, its configuration
- * (bound from `TEMPORAL_ADDRESS` / `TEMPORAL_NAMESPACE` unless pinned) and the
- * connection (a resource opened with the scope and closed with it; a service
- * that will not answer is a modeled `TemporalUnreachable`). Import it next to
- * the application, export `TemporalRuntime`, provide the activities — the
+ * (bound from the `TEMPORAL_*` variables unless pinned) and the connection (a
+ * resource opened with the scope and closed with it; a service that will not
+ * answer is a modeled `TemporalUnreachable`). Import it next to the
+ * application, export `TemporalRuntime`, provide the activities — the
  * activities port is a need of this module.
  *
- * With both configuration fields pinned the module reads nothing from the
- * environment; pin only one and the other still comes from it.
+ * Each configuration field is pinned on its own: a pinned field reads nothing
+ * from the environment, and a field left unpinned still does.
  */
-declare const temporal: <C extends ContractDefinition, Unit extends AnyUnitModule | undefined = undefined>(options: TemporalOptions<C, Unit>) => Module<Provided, ConfigInvalid | TemporalUnreachable, Env | Scope | ActivitiesInstanceOf<C> | UnitNeedsOf<Unit>>;
+export declare const temporal: <C extends ContractDefinition, Unit extends AnyUnitModule | undefined = undefined>(options: TemporalOptions<C, Unit>) => Module<Provided, ConfigInvalid | TemporalUnreachable, Env | Scope | ActivitiesInstanceOf<C> | UnitNeedsOf<Unit>>;
 //#endregion
 //#region src/temporal-module.d.ts
 /** The starter's own module, as the sugar adds it to the application's imports. */
@@ -298,7 +299,7 @@ type TemporalModuleOptions<C extends ContractDefinition, ActivitiesError, Activi
  * await runMain(OrderTemporalWorker);
  * ```
  */
-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[] = []>(options: TemporalModuleOptions<C, ActivitiesError, ActivitiesNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof TemporalRuntime, ...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_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 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_2) ? T_2 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((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)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[0]> | Exclude<((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[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>, Provides<P, C, ActivitiesError, ActivitiesNeeds>>[] = [], const N extends readonly AnyPort[] = []>(options: TemporalModuleOptions<C, ActivitiesError, ActivitiesNeeds, Declared, Unit, I, P, X, N>) => Module<(Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> extends (infer T) ? T extends Extract<(readonly [typeof TemporalRuntime, ...X])[number], AnyModule> ? T extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((readonly [typeof TemporalRuntime, ...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_1) ? T_1 extends (readonly [Provider<ActivitiesInstanceOf<C>, ActivitiesError, ActivitiesNeeds>, ...P])[number] ? T_1 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_2) ? T_2 extends (readonly [...I, TemporalStarter<C, Unit>])[number] ? T_2 extends Module<infer X_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[1], Exclude<((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)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[0]> | Exclude<((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[2], ((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_1, infer E, infer N_1> ? readonly [X_1, E, N_1] : never : never : never)[0] | ((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)[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>;
@@ -382,6 +383,6 @@ type Compose<C extends ContractDefinition> = <const T extends readonly PieceOf<C
  * so the services record IS the activities record. Every key must be covered,
  * and two slices claiming one key are di's duplicate-provider defect at build.
  */
-declare const TemporalActivities: <C extends ContractDefinition>(contract: C) => Whole<C> & Compose<C>;
+export declare const TemporalActivities: <C extends ContractDefinition>(contract: C) => Whole<C> & Compose<C>;
 //#endregion
-export { type ActivitiesInstanceOf, type ActivitiesPortOf, ActivityInput, type ActivityInputOf, type ActivityInputPortOf, TemporalActivities, TemporalConfig, TemporalConnection, type TemporalInfo, TemporalModule, type TemporalModuleOptions, type TemporalOptions, TemporalRuntime, TemporalUnreachable, TemporalWorkflowActivities, type WorkflowActivitiesPortOf, type WorkflowSource, temporal };
+export type { ActivitiesInstanceOf, ActivitiesPortOf, ActivityInputOf, ActivityInputPortOf, TemporalInfo, TemporalModuleOptions, TemporalOptions, WorkflowActivitiesPortOf, WorkflowSource };

package/dist/index.mjs

@@ -4,7 +4,7 @@ import { Observers, RuntimePort, RuntimeStartFailed, noObserver, observe, releas
 import { declareActivitiesHandler } from "@temporal-contract/worker/activity";
 import { msToNumber } from "@temporalio/common";
 import { NativeConnection, Worker } from "@temporalio/worker";
-import { TaggedError, fromPromise, fromSafePromise, fromThrowable } from "unthrown";
+import { Ok, OkAsync, TaggedError, fromPromise, fromSafePromise, fromThrowable } from "unthrown";
 import { activityInfo } from "@temporalio/activity";
 //#region src/unit.ts
 /**
@@ -164,9 +164,9 @@ const metaFor = () => {
 //#region src/temporal-runtime.ts
 /**
 * Where the Temporal service is, as a service: `temporal()` binds it from the
-* environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`) and
-* `TEMPORAL_NAMESPACE` (default `default`) — unless pinned, and anything else
-* in the graph may read it.
+* environment — `TEMPORAL_ADDRESS` (default `127.0.0.1:7233`),
+* `TEMPORAL_NAMESPACE` (default `default`) and the shutdown budgets below —
+* unless pinned, and anything else in the graph may read it.
 */
 var TemporalConfig = class extends Port("TemporalConfig") {};
 /**
@@ -205,14 +205,14 @@ const DEFAULT_FORCE_MS = 15e3;
 const durationMs = (duration) => duration === void 0 ? void 0 : msToNumber(duration);
 /**
 * The Temporal starter: a module providing the runtime, its configuration
-* (bound from `TEMPORAL_ADDRESS` / `TEMPORAL_NAMESPACE` unless pinned) and the
-* connection (a resource opened with the scope and closed with it; a service
-* that will not answer is a modeled `TemporalUnreachable`). Import it next to
-* the application, export `TemporalRuntime`, provide the activities — the
+* (bound from the `TEMPORAL_*` variables unless pinned) and the connection (a
+* resource opened with the scope and closed with it; a service that will not
+* answer is a modeled `TemporalUnreachable`). Import it next to the
+* application, export `TemporalRuntime`, provide the activities — the
 * activities port is a need of this module.
 *
-* With both configuration fields pinned the module reads nothing from the
-* environment; pin only one and the other still comes from it.
+* Each configuration field is pinned on its own: a pinned field reads nothing
+* from the environment, and a field left unpinned still does.
 */
 const temporal = (options) => {
 	const { address, namespace } = options;
@@ -288,26 +288,39 @@ const createWorker = (host, connection, config, activities, options, observers)
 		shutdownForceTime: config.forceAfterMs
 	}), startFailed)).map((worker) => poll(worker, taskQueue, namespace));
 };
+/**
+* The `Serving` over a started worker.
+*
+* @internal Exported for `temporal-runtime.spec.ts` alone: the `stopped`
+* channel is about a worker's `run()` REJECTING mid-flight, and there is no way
+* to make a real one do that without taking the shared Temporal server down for
+* every other spec. A stub worker is what reaches that arm.
+*/
 const poll = (worker, taskQueue, namespace) => {
 	const running = fromSafePromise(worker.run());
 	const stopPolling = () => {
 		if (worker.getState() === "RUNNING") worker.shutdown();
 	};
 	let deadline;
-	const stopped = () => deadline === void 0 ? running : releasedBy(deadline, running);
+	const awaitRun = () => deadline === void 0 ? running : releasedBy(deadline, running);
+	let asked = false;
+	const withdrawn = () => fromSafePromise(new Promise(() => {}));
 	return {
 		info: {
 			taskQueue,
 			namespace
 		},
+		stopped: () => running.recoverDefect(() => Ok(void 0)).flatMap(() => asked ? withdrawn() : OkAsync()),
 		drain: (signal) => {
+			asked = true;
 			deadline = signal;
 			stopPolling();
-			return stopped();
+			return awaitRun();
 		},
 		stop: () => {
+			asked = true;
 			stopPolling();
-			return stopped();
+			return awaitRun();
 		}
 	};
 };

package/dist/schedule.d.cts

@@ -3,7 +3,7 @@ import { ScheduleNotFoundError, TypedScheduleClient, TypedScheduleCreateOptions,
 import { AsyncResult } from "unthrown";
 //#region src/schedule.d.ts
 /** Whether the schedule had to be created, or was already there and had its spec reconciled. */
-type ScheduleOutcome = "created" | "updated";
+export type ScheduleOutcome = "created" | "updated";
 /**
  * Register a schedule, idempotently.
  *
@@ -45,6 +45,5 @@ type ScheduleOutcome = "created" | "updated";
  * });
  * ```
  */
-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>;
-//#endregion
-export { ScheduleOutcome, ensureSchedule };
+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>;
+//#endregion

package/dist/schedule.d.mts

@@ -3,7 +3,7 @@ import { ScheduleNotFoundError, TypedScheduleClient, TypedScheduleCreateOptions,
 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. */
-type ScheduleOutcome = "created" | "updated";
+export type ScheduleOutcome = "created" | "updated";
 /**
  * Register a schedule, idempotently.
  *
@@ -45,6 +45,5 @@ type ScheduleOutcome = "created" | "updated";
  * });
  * ```
  */
-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>;
-//#endregion
-export { ScheduleOutcome, ensureSchedule };
+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>;
+//#endregion

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@btravstack/temporal-worker",
-  "version": "0.13.0",
+  "version": "0.15.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",
@@ -54,6 +54,11 @@
     }
   },
   "devDependencies": {
+    "@btravstack/config": "0.15.0",
+    "@btravstack/core": "0.15.0",
+    "@btravstack/di": "0.15.0",
+    "@btravstack/internal-test-infra": "0.0.0",
+    "@btravstack/testing": "0.15.0",
     "@btravstack/tsconfig": "0.4.0",
     "@temporal-contract/client": "8.0.0-beta.9",
     "@temporal-contract/contract": "8.0.0-beta.9",
@@ -63,31 +68,26 @@
     "@temporalio/common": "1.23.0",
     "@temporalio/worker": "1.23.0",
     "@temporalio/workflow": "1.23.0",
-    "@types/node": "26.4.0",
-    "@unthrown/vitest": "5.7.0",
+    "@types/node": "26.4.1",
+    "@unthrown/vitest": "5.8.0",
     "@vitest/coverage-v8": "4.1.11",
-    "tsdown": "0.22.14",
+    "tsdown": "0.23.0",
     "typescript": "7.0.2",
-    "unthrown": "5.7.0",
+    "unthrown": "5.8.0",
     "vitest": "4.1.11",
-    "zod": "4.5.3",
-    "@btravstack/config": "0.13.0",
-    "@btravstack/core": "0.13.0",
-    "@btravstack/di": "0.13.0",
-    "@btravstack/internal-test-infra": "0.0.0",
-    "@btravstack/testing": "0.13.0"
+    "zod": "4.5.4"
   },
   "peerDependencies": {
+    "@btravstack/config": "^0.15.0",
+    "@btravstack/core": "^0.15.0",
+    "@btravstack/di": "^0.15.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",
-    "unthrown": "^5.0.0",
-    "@btravstack/config": "^0.13.0",
-    "@btravstack/core": "^0.13.0",
-    "@btravstack/di": "^0.13.0"
+    "unthrown": "^5.0.0"
   },
   "peerDependenciesMeta": {
     "@temporal-contract/client": {
@@ -101,7 +101,6 @@
     "build": "tsdown src/index.ts src/schedule.ts --format cjs,esm --dts --clean",
     "dev": "tsdown src/index.ts src/schedule.ts --format cjs,esm --dts --watch",
     "test": "vitest run --coverage",
-    "test:types": "tsc --noEmit -p tsconfig.test-d.json",
     "typecheck": "tsc --noEmit && tsc --noEmit -p tsconfig.test-d.json"
   }
 }