@nodii/telemetry 0.13.0 → 0.14.1

package/dist/worker/index.d.ts

@@ -0,0 +1,23 @@
+export { encodeLeaseValue, FenceCheckUnavailableError, FenceLostError, fenceKey, leaseKey, parseLeaseValue, SingleActiveLease, } from "./single-active-lease.js";
+export type { LeaseRedisLike, LeaseTelemetry, SingleActiveLeaseOpts, } from "./single-active-lease.js";
+export { postgresJsExecutor } from "./tx.js";
+export type { SqlExecutor, SqlResult, SqlRow } from "./tx.js";
+export { CheckpointStore, checkpointTableDDL, DEFAULT_CHECKPOINT_TABLE, } from "./checkpoint-store.js";
+export type { Checkpoint, CheckpointAdvance } from "./checkpoint-store.js";
+export { consumedEventsTableDDL, DedupeStore, DEFAULT_CONSUMED_EVENTS_TABLE, DEFAULT_RETENTION_DAYS, } from "./dedupe-store.js";
+export { ensurePiiRedaction, LoudNoopDeadLetterSink, TableDeadLetterSink, withPiiRedaction, } from "./dead-letter.js";
+export type { DeadLetterItem, DeadLetterLogger, DeadLetterSink, } from "./dead-letter.js";
+export { hwmGaugeValue, ObservabilityHooks, WORKER_METRIC_NAMES, WORKER_SUBSTRATE_VOCABULARY, } from "./observability-hooks.js";
+export type { ObservabilityHooksOpts, RecordMetricFn, WorkerMetricAttributes, } from "./observability-hooks.js";
+export { SignalDrain } from "./signal-drain.js";
+export type { DrainResult, SignalDrainOpts, StopHandler, } from "./signal-drain.js";
+export type { WorkerHandle, WorkerHwm, WorkerStopOptions, WorkerStopResult, } from "./worker-handle.js";
+export { SweeperWorker } from "./sweeper-worker.js";
+export type { SweeperJobContext, SweeperJobDefinition, SweeperJobResult, SweeperWorkerOpts, } from "./sweeper-worker.js";
+export { parseAutoClaimEntries, parseAutoClaimEntriesPartitioned, parseStreamEntries, parseStreamEntriesPartitioned, PoisonApplyError, StreamsWorker, streamsConsumerGroup, } from "./streams-worker.js";
+export type { MalformedStreamEntry, StreamApplyContext, StreamApplyHandler, StreamEvent, StreamsRedisLike, StreamsWorkerOpts, } from "./streams-worker.js";
+export { OutboxDispatcher } from "./outbox-dispatcher.js";
+export type { OutboxDispatcherOpts, OutboxPublisher, OutboxRow, } from "./outbox-dispatcher.js";
+export { ReplicationWorker, replicationConsumerGroup, } from "./replication-worker.js";
+export type { ReplicationApplyContext, ReplicationApplyHandler, ReplicationAuditHook, ReplicationEvent, ReplicationWorkerOpts, SnapshotBootstrap, } from "./replication-worker.js";
+//# sourceMappingURL=index.d.ts.map

package/dist/worker/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAuBA,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,cAAc,EACd,cAAc,EACd,qBAAqB,GACtB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAC7C,YAAY,EAAE,WAAW,EAAE,SAAS,EAAE,MAAM,EAAE,MAAM,SAAS,CAAC;AAG9D,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAC/B,YAAY,EAAE,UAAU,EAAE,iBAAiB,EAAE,MAAM,uBAAuB,CAAC;AAG3E,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAC1B,YAAY,EACV,cAAc,EACd,gBAAgB,EAChB,cAAc,GACf,MAAM,kBAAkB,CAAC;AAG1B,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAClC,YAAY,EACV,sBAAsB,EACtB,cAAc,EACd,sBAAsB,GACvB,MAAM,0BAA0B,CAAC;AAGlC,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAChD,YAAY,EACV,WAAW,EACX,eAAe,EACf,WAAW,GACZ,MAAM,mBAAmB,CAAC;AAG3B,YAAY,EACV,YAAY,EACZ,SAAS,EACT,iBAAiB,EACjB,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAM5B,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AACpD,YAAY,EACV,iBAAiB,EACjB,oBAAoB,EACpB,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,kBAAkB,EAClB,6BAA6B,EAC7B,gBAAgB,EAChB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAC7B,YAAY,EACV,oBAAoB,EACpB,kBAAkB,EAClB,kBAAkB,EAClB,WAAW,EACX,gBAAgB,EAChB,iBAAiB,GAClB,MAAM,qBAAqB,CAAC;AAG7B,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAC1D,YAAY,EACV,oBAAoB,EACpB,eAAe,EACf,SAAS,GACV,MAAM,wBAAwB,CAAC;AAGhC,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC;AACjC,YAAY,EACV,uBAAuB,EACvB,uBAAuB,EACvB,oBAAoB,EACpB,gBAAgB,EAChB,qBAAqB,EACrB,iBAAiB,GAClB,MAAM,yBAAyB,CAAC"}

package/dist/worker/index.js

@@ -0,0 +1,46 @@
+// @nodii/telemetry/worker — the canonical background-worker substrate (D402).
+//
+// Every background worker on every Nodii service — stream consumer, sweeper,
+// single-active leased loop, outbox drainer — is built from these canonical
+// primitives. No service hand-rolls a lease, a checkpoint cursor, a dedupe
+// store, or a worker lifecycle.
+//
+// D402 (LOCKED) primitives shipped here:
+//   - SingleActiveLease   — Redis SET-NX-EX + Lua CAS-renew@ttl/2 + fencing token
+//   - CheckpointStore     — durable HWM cursor, advanced atomically in the apply tx
+//   - DedupeStore         — consumed_events (event_id, topic) composite-PK + sweep
+//   - DeadLetter          — injected sink + fail-closed PII redaction (D401)
+//   - ObservabilityHooks  — canonical worker metrics via the real recordMetric
+//   - SignalDrain         — SIGTERM/SIGINT bounded graceful drain
+//   - WorkerHandle        — the uniform handle the 4 worker types implement
+//
+// Resolve as a downstream consumer would:
+//   import {
+//     SingleActiveLease, CheckpointStore, DedupeStore,
+//     ObservabilityHooks, SignalDrain, type WorkerHandle,
+//   } from "@nodii/telemetry/worker";
+// ── SingleActiveLease (already shipped) ──────────────────────────────────────
+export { encodeLeaseValue, FenceCheckUnavailableError, FenceLostError, fenceKey, leaseKey, parseLeaseValue, SingleActiveLease, } from "./single-active-lease.js";
+// ── Shared SQL-executor seam (the atomic-in-apply-tx handle) ─────────────────
+export { postgresJsExecutor } from "./tx.js";
+// ── CheckpointStore (HWM cursor) ─────────────────────────────────────────────
+export { CheckpointStore, checkpointTableDDL, DEFAULT_CHECKPOINT_TABLE, } from "./checkpoint-store.js";
+// ── DedupeStore ──────────────────────────────────────────────────────────────
+export { consumedEventsTableDDL, DedupeStore, DEFAULT_CONSUMED_EVENTS_TABLE, DEFAULT_RETENTION_DAYS, } from "./dedupe-store.js";
+// ── DeadLetter (injected sink + fail-closed PII redaction) ───────────────────
+export { ensurePiiRedaction, LoudNoopDeadLetterSink, TableDeadLetterSink, withPiiRedaction, } from "./dead-letter.js";
+// ── ObservabilityHooks ───────────────────────────────────────────────────────
+export { hwmGaugeValue, ObservabilityHooks, WORKER_METRIC_NAMES, WORKER_SUBSTRATE_VOCABULARY, } from "./observability-hooks.js";
+// ── SignalDrain ──────────────────────────────────────────────────────────────
+export { SignalDrain } from "./signal-drain.js";
+// ── Worker types (compose the primitives) ────────────────────────────────────
+// The 4 D402 worker types, each implementing WorkerHandle.
+// SweeperWorker — single-active, checkpoint-resumable interval job.
+export { SweeperWorker } from "./sweeper-worker.js";
+// StreamsWorker — generic (non-replication) Pattern-2 stream consumer.
+export { parseAutoClaimEntries, parseAutoClaimEntriesPartitioned, parseStreamEntries, parseStreamEntriesPartitioned, PoisonApplyError, StreamsWorker, streamsConsumerGroup, } from "./streams-worker.js";
+// OutboxDispatcher — Pattern-3 producer drain.
+export { OutboxDispatcher } from "./outbox-dispatcher.js";
+// ReplicationWorker — Pattern-3 subscriber consume (snapshot + LWW + audit).
+export { ReplicationWorker, replicationConsumerGroup, } from "./replication-worker.js";
+//# sourceMappingURL=index.js.map

package/dist/worker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/worker/index.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,EAAE;AACF,6EAA6E;AAC7E,4EAA4E;AAC5E,2EAA2E;AAC3E,gCAAgC;AAChC,EAAE;AACF,yCAAyC;AACzC,kFAAkF;AAClF,oFAAoF;AACpF,mFAAmF;AACnF,6EAA6E;AAC7E,+EAA+E;AAC/E,kEAAkE;AAClE,4EAA4E;AAC5E,EAAE;AACF,0CAA0C;AAC1C,aAAa;AACb,uDAAuD;AACvD,0DAA0D;AAC1D,sCAAsC;AAEtC,gFAAgF;AAChF,OAAO,EACL,gBAAgB,EAChB,0BAA0B,EAC1B,cAAc,EACd,QAAQ,EACR,QAAQ,EACR,eAAe,EACf,iBAAiB,GAClB,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,OAAO,EAAE,kBAAkB,EAAE,MAAM,SAAS,CAAC;AAG7C,gFAAgF;AAChF,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,wBAAwB,GACzB,MAAM,uBAAuB,CAAC;AAG/B,gFAAgF;AAChF,OAAO,EACL,sBAAsB,EACtB,WAAW,EACX,6BAA6B,EAC7B,sBAAsB,GACvB,MAAM,mBAAmB,CAAC;AAE3B,gFAAgF;AAChF,OAAO,EACL,kBAAkB,EAClB,sBAAsB,EACtB,mBAAmB,EACnB,gBAAgB,GACjB,MAAM,kBAAkB,CAAC;AAO1B,gFAAgF;AAChF,OAAO,EACL,aAAa,EACb,kBAAkB,EAClB,mBAAmB,EACnB,2BAA2B,GAC5B,MAAM,0BAA0B,CAAC;AAOlC,gFAAgF;AAChF,OAAO,EAAE,WAAW,EAAE,MAAM,mBAAmB,CAAC;AAehD,gFAAgF;AAChF,2DAA2D;AAE3D,oEAAoE;AACpE,OAAO,EAAE,aAAa,EAAE,MAAM,qBAAqB,CAAC;AAQpD,uEAAuE;AACvE,OAAO,EACL,qBAAqB,EACrB,gCAAgC,EAChC,kBAAkB,EAClB,6BAA6B,EAC7B,gBAAgB,EAChB,aAAa,EACb,oBAAoB,GACrB,MAAM,qBAAqB,CAAC;AAU7B,+CAA+C;AAC/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,wBAAwB,CAAC;AAO1D,6EAA6E;AAC7E,OAAO,EACL,iBAAiB,EACjB,wBAAwB,GACzB,MAAM,yBAAyB,CAAC"}

package/dist/worker/observability-hooks.d.ts

@@ -0,0 +1,99 @@
+import { type RecordMetricArgs } from "../metrics.js";
+import type { MetricVocabularyRegistry } from "../types.js";
+/** Canonical worker-substrate metric names, pinned by D402 + the task. */
+export declare const WORKER_METRIC_NAMES: {
+    readonly leaseAcquired: "nodii.worker.lease.acquired_total";
+    readonly leaseRenewed: "nodii.worker.lease.renewed_total";
+    readonly leaseLost: "nodii.worker.lease.lost_total";
+    readonly lag: "nodii.worker.lag";
+    readonly currentHwm: "nodii.worker.current_hwm";
+    readonly depth: "nodii.worker.depth";
+    readonly drainDurationMs: "nodii.worker.drain.duration_ms";
+    readonly swept: "nodii.worker.swept_total";
+};
+/**
+ * The locked worker-substrate metric vocabulary — merge into
+ * `initTelemetry({ vocabularyRegistry: { ...svc, ...WORKER_SUBSTRATE_VOCABULARY } })`
+ * so the canonical names register under family `async_worker` instead of
+ * tripping `MetricVocabularyError`. Mirrors how `REPLICA_CONSUMER_VOCABULARY`
+ * is consumed.
+ */
+export declare const WORKER_SUBSTRATE_VOCABULARY: MetricVocabularyRegistry;
+/**
+ * Base attributes every worker-substrate metric carries so a service can slice
+ * the canonical series by worker. `service` + `scope` mirror the lease's
+ * `(service, scope)` key shape; `worker` is the worker-type label
+ * (`replication` | `sweeper` | `streams` | `outbox`).
+ */
+export interface WorkerMetricAttributes {
+    service: string;
+    scope: string;
+    worker?: string;
+    [key: string]: string | number | undefined;
+}
+/**
+ * The metric-recording seam. Defaults to telemetry's real `recordMetric`. A
+ * test may inject a capturing fn, but production ALWAYS gets the real path —
+ * there is no no-op default. (To assert emitted points in a test, prefer
+ * `_setMetricsBackend(...)` underneath the real `recordMetric`, exactly as
+ * `metrics.test.ts` does; the `record` seam here exists only for the rare case
+ * a caller wants to swap the whole function.)
+ */
+export type RecordMetricFn = (args: RecordMetricArgs) => void;
+export interface ObservabilityHooksOpts {
+    /** Stable base attributes (service, scope, worker) for every emitted point. */
+    attributes: WorkerMetricAttributes;
+    /**
+     * The metric-recording fn. Defaults to the REAL telemetry `recordMetric`.
+     * Never a no-op. Injectable for direct-capture tests only.
+     */
+    record?: RecordMetricFn;
+}
+/**
+ * ObservabilityHooks emits the canonical worker-substrate metrics through the
+ * real telemetry metric API. One instance per worker; the worker types call
+ * the typed methods at the corresponding lifecycle points (lease acquire/renew/
+ * lose, per-tick lag/hwm/depth refresh, drain on stop, sweep count).
+ *
+ * Usage:
+ *   const hooks = new ObservabilityHooks({
+ *     attributes: { service: "billing", scope: "outbox", worker: "outbox" },
+ *   });
+ *   hooks.leaseAcquired();
+ *   hooks.recordLag(12.5);
+ *   hooks.recordDrainDuration(842);
+ */
+export declare class ObservabilityHooks {
+    private readonly attrs;
+    private readonly record;
+    constructor(opts: ObservabilityHooksOpts);
+    private emit;
+    /** The worker acquired its single-active lease. */
+    leaseAcquired(extra?: Record<string, string | number>): void;
+    /** The worker renewed its lease (CAS held) at ttl/2. */
+    leaseRenewed(extra?: Record<string, string | number>): void;
+    /** The worker lost its lease (renew CAS failed / taken over / errored). */
+    leaseLost(extra?: Record<string, string | number>): void;
+    /** Snapshot the current consumer lag in seconds. */
+    recordLag(seconds: number, extra?: Record<string, string | number>): void;
+    /**
+     * Snapshot the current durable HWM as a numeric position. A Redis-Streams id
+     * (`<ms>-<seq>`) is reduced to its leading ms component so the gauge is a
+     * monotonic-ish stall indicator (the same reduction outbox-dispatcher uses
+     * for `outbox.hwm`); callers with a numeric cursor pass it directly.
+     */
+    recordHwm(position: number, extra?: Record<string, string | number>): void;
+    /** Snapshot the current backlog / stream depth (pending entries). */
+    recordDepth(depth: number, extra?: Record<string, string | number>): void;
+    /** Record the wall-clock ms a graceful drain (stop) took. */
+    recordDrainDuration(ms: number, extra?: Record<string, string | number>): void;
+    /** Count rows removed by a sweeper retention sweep. */
+    recordSwept(count: number, extra?: Record<string, string | number>): void;
+}
+/**
+ * Reduce a Redis-Streams id (`<ms>-<seq>`) to a numeric gauge position (its
+ * leading ms component). Mirrors outbox-dispatcher's `hwmGaugeValue`. A
+ * non-streams numeric string returns its Number; an unparseable value returns 0.
+ */
+export declare function hwmGaugeValue(streamId: string | null): number;
+//# sourceMappingURL=observability-hooks.d.ts.map

package/dist/worker/observability-hooks.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-hooks.d.ts","sourceRoot":"","sources":["../../src/worker/observability-hooks.ts"],"names":[],"mappings":"AA4BA,OAAO,EAAE,KAAK,gBAAgB,EAAgB,MAAM,eAAe,CAAC;AACpE,OAAO,KAAK,EAAc,wBAAwB,EAAE,MAAM,aAAa,CAAC;AAExE,0EAA0E;AAC1E,eAAO,MAAM,mBAAmB;;;;;;;;;CAStB,CAAC;AAEX;;;;;;GAMG;AACH,eAAO,MAAM,2BAA2B,EAAE,wBAyDzC,CAAC;AAEF;;;;;GAKG;AACH,MAAM,WAAW,sBAAsB;IACrC,OAAO,EAAE,MAAM,CAAC;IAChB,KAAK,EAAE,MAAM,CAAC;IACd,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CAC5C;AAED;;;;;;;GAOG;AACH,MAAM,MAAM,cAAc,GAAG,CAAC,IAAI,EAAE,gBAAgB,KAAK,IAAI,CAAC;AAE9D,MAAM,WAAW,sBAAsB;IACrC,+EAA+E;IAC/E,UAAU,EAAE,sBAAsB,CAAC;IACnC;;;OAGG;IACH,MAAM,CAAC,EAAE,cAAc,CAAC;CACzB;AAcD;;;;;;;;;;;;;GAaG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAyB;IAC/C,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAiB;gBAE5B,IAAI,EAAE,sBAAsB;IAMxC,OAAO,CAAC,IAAI;IAcZ,mDAAmD;IACnD,aAAa,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAI5D,wDAAwD;IACxD,YAAY,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAI3D,2EAA2E;IAC3E,SAAS,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAIxD,oDAAoD;IACpD,SAAS,CAAC,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAIzE;;;;;OAKG;IACH,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAI1E,qEAAqE;IACrE,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;IAIzE,6DAA6D;IAC7D,mBAAmB,CACjB,EAAE,EAAE,MAAM,EACV,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GACtC,IAAI;IAIP,uDAAuD;IACvD,WAAW,CAAC,KAAK,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAAC,GAAG,IAAI;CAG1E;AAED;;;;GAIG;AACH,wBAAgB,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,IAAI,GAAG,MAAM,CAM7D"}

package/dist/worker/observability-hooks.js

@@ -0,0 +1,189 @@
+// D402 — ObservabilityHooks: the canonical worker-metric vocabulary, routed
+// through telemetry's REAL `recordMetric` API (NOT a NOOP sink by default).
+//
+// D402 (LOCKED) — "ObservabilityHooks — lag / HWM / depth metrics with canonical
+// names." The orchestrator's task pins the exact canonical names:
+//   - nodii.worker.lease.acquired_total   (counter)
+//   - nodii.worker.lease.renewed_total    (counter)
+//   - nodii.worker.lease.lost_total       (counter)
+//   - nodii.worker.lag                     (gauge,  seconds)
+//   - nodii.worker.current_hwm             (gauge)
+//   - nodii.worker.depth                   (gauge — backlog/stream depth)
+//   - nodii.worker.drain.duration_ms       (histogram, ms)
+//   - nodii.worker.swept_total             (counter — sweepers only)
+//
+// These names live under the existing D18/D197 `async_worker` metric family
+// (background workers are the async_worker family). A consuming service merges
+// `WORKER_SUBSTRATE_VOCABULARY` (below) into `initTelemetry({ vocabularyRegistry
+// })` exactly as it merges `REPLICA_CONSUMER_VOCABULARY` — otherwise the
+// canonical names trip `MetricVocabularyError` (vocabulary is HARD per D24).
+//
+// ── Why this routes through `recordMetric`, never a default no-op ────────────
+// R1 (never-defer) forbids a Noop sink wired as the default. The hooks bind to
+// telemetry's own `recordMetric({ kind, name, value, attributes })`. That fn
+// is the real metric path: it validates the name against the loaded vocabulary
+// + the family + the kind, then records onto the live OTLP-backed metrics
+// backend. The ONLY injection seam is for tests, which `_setMetricsBackend(...)`
+// a capturing backend underneath — the hook itself always calls the real API.
+import { recordMetric } from "../metrics.js";
+/** Canonical worker-substrate metric names, pinned by D402 + the task. */
+export const WORKER_METRIC_NAMES = {
+    leaseAcquired: "nodii.worker.lease.acquired_total",
+    leaseRenewed: "nodii.worker.lease.renewed_total",
+    leaseLost: "nodii.worker.lease.lost_total",
+    lag: "nodii.worker.lag",
+    currentHwm: "nodii.worker.current_hwm",
+    depth: "nodii.worker.depth",
+    drainDurationMs: "nodii.worker.drain.duration_ms",
+    swept: "nodii.worker.swept_total",
+};
+/**
+ * The locked worker-substrate metric vocabulary — merge into
+ * `initTelemetry({ vocabularyRegistry: { ...svc, ...WORKER_SUBSTRATE_VOCABULARY } })`
+ * so the canonical names register under family `async_worker` instead of
+ * tripping `MetricVocabularyError`. Mirrors how `REPLICA_CONSUMER_VOCABULARY`
+ * is consumed.
+ */
+export const WORKER_SUBSTRATE_VOCABULARY = {
+    [WORKER_METRIC_NAMES.leaseAcquired]: {
+        family: "async_worker",
+        kind: "counter",
+        description: "Single-active lease acquisitions (a worker took the lease for its scope).",
+        decision: "D402",
+    },
+    [WORKER_METRIC_NAMES.leaseRenewed]: {
+        family: "async_worker",
+        kind: "counter",
+        description: "Single-active lease renewals at ttl/2 (CAS held).",
+        decision: "D402",
+    },
+    [WORKER_METRIC_NAMES.leaseLost]: {
+        family: "async_worker",
+        kind: "counter",
+        description: "Single-active lease losses (renew CAS failed / lease taken over / errored).",
+        decision: "D402",
+    },
+    [WORKER_METRIC_NAMES.lag]: {
+        family: "async_worker",
+        kind: "gauge",
+        unit: "seconds",
+        description: "Wall-clock lag between source emission and consumer apply for the worker.",
+        decision: "D402",
+    },
+    [WORKER_METRIC_NAMES.currentHwm]: {
+        family: "async_worker",
+        kind: "gauge",
+        description: "Current durable high-water-mark (checkpoint cursor position) the worker has advanced to.",
+        decision: "D402",
+    },
+    [WORKER_METRIC_NAMES.depth]: {
+        family: "async_worker",
+        kind: "gauge",
+        description: "Backlog / stream depth pending for the worker (unprocessed entries).",
+        decision: "D402",
+    },
+    [WORKER_METRIC_NAMES.drainDurationMs]: {
+        family: "async_worker",
+        kind: "histogram",
+        unit: "ms",
+        description: "Graceful-drain wall-clock duration on stop() (flush in-flight + release leases).",
+        decision: "D402",
+    },
+    [WORKER_METRIC_NAMES.swept]: {
+        family: "async_worker",
+        kind: "counter",
+        description: "Rows removed by a SweeperWorker retention sweep.",
+        decision: "D402",
+    },
+};
+/** Strip `undefined`-valued attributes so the recordMetric label map is clean. */
+function cleanAttributes(attrs, extra) {
+    const out = {};
+    for (const [k, v] of Object.entries({ ...attrs, ...extra })) {
+        if (v !== undefined)
+            out[k] = v;
+    }
+    return out;
+}
+/**
+ * ObservabilityHooks emits the canonical worker-substrate metrics through the
+ * real telemetry metric API. One instance per worker; the worker types call
+ * the typed methods at the corresponding lifecycle points (lease acquire/renew/
+ * lose, per-tick lag/hwm/depth refresh, drain on stop, sweep count).
+ *
+ * Usage:
+ *   const hooks = new ObservabilityHooks({
+ *     attributes: { service: "billing", scope: "outbox", worker: "outbox" },
+ *   });
+ *   hooks.leaseAcquired();
+ *   hooks.recordLag(12.5);
+ *   hooks.recordDrainDuration(842);
+ */
+export class ObservabilityHooks {
+    attrs;
+    record;
+    constructor(opts) {
+        this.attrs = opts.attributes;
+        // Default = the REAL recordMetric. R1: never a no-op default.
+        this.record = opts.record ?? recordMetric;
+    }
+    emit(kind, name, value, extra) {
+        this.record({
+            kind,
+            name,
+            value,
+            attributes: cleanAttributes(this.attrs, extra),
+        });
+    }
+    /** The worker acquired its single-active lease. */
+    leaseAcquired(extra) {
+        this.emit("counter", WORKER_METRIC_NAMES.leaseAcquired, 1, extra);
+    }
+    /** The worker renewed its lease (CAS held) at ttl/2. */
+    leaseRenewed(extra) {
+        this.emit("counter", WORKER_METRIC_NAMES.leaseRenewed, 1, extra);
+    }
+    /** The worker lost its lease (renew CAS failed / taken over / errored). */
+    leaseLost(extra) {
+        this.emit("counter", WORKER_METRIC_NAMES.leaseLost, 1, extra);
+    }
+    /** Snapshot the current consumer lag in seconds. */
+    recordLag(seconds, extra) {
+        this.emit("gauge", WORKER_METRIC_NAMES.lag, seconds, extra);
+    }
+    /**
+     * Snapshot the current durable HWM as a numeric position. A Redis-Streams id
+     * (`<ms>-<seq>`) is reduced to its leading ms component so the gauge is a
+     * monotonic-ish stall indicator (the same reduction outbox-dispatcher uses
+     * for `outbox.hwm`); callers with a numeric cursor pass it directly.
+     */
+    recordHwm(position, extra) {
+        this.emit("gauge", WORKER_METRIC_NAMES.currentHwm, position, extra);
+    }
+    /** Snapshot the current backlog / stream depth (pending entries). */
+    recordDepth(depth, extra) {
+        this.emit("gauge", WORKER_METRIC_NAMES.depth, depth, extra);
+    }
+    /** Record the wall-clock ms a graceful drain (stop) took. */
+    recordDrainDuration(ms, extra) {
+        this.emit("histogram", WORKER_METRIC_NAMES.drainDurationMs, ms, extra);
+    }
+    /** Count rows removed by a sweeper retention sweep. */
+    recordSwept(count, extra) {
+        this.emit("counter", WORKER_METRIC_NAMES.swept, count, extra);
+    }
+}
+/**
+ * Reduce a Redis-Streams id (`<ms>-<seq>`) to a numeric gauge position (its
+ * leading ms component). Mirrors outbox-dispatcher's `hwmGaugeValue`. A
+ * non-streams numeric string returns its Number; an unparseable value returns 0.
+ */
+export function hwmGaugeValue(streamId) {
+    if (!streamId)
+        return 0;
+    const dash = streamId.indexOf("-");
+    const head = dash < 0 ? streamId : streamId.slice(0, dash);
+    const n = Number(head);
+    return Number.isFinite(n) ? n : 0;
+}
+//# sourceMappingURL=observability-hooks.js.map

package/dist/worker/observability-hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"observability-hooks.js","sourceRoot":"","sources":["../../src/worker/observability-hooks.ts"],"names":[],"mappings":"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"}

package/dist/worker/outbox-dispatcher.d.ts

@@ -0,0 +1,106 @@
+import type { CheckpointStore } from "./checkpoint-store.js";
+import type { DeadLetterSink } from "./dead-letter.js";
+import { ObservabilityHooks } from "./observability-hooks.js";
+import { type SingleActiveLeaseOpts } from "./single-active-lease.js";
+import type { SqlExecutor } from "./tx.js";
+import type { WorkerHandle, WorkerHwm, WorkerStopOptions, WorkerStopResult } from "./worker-handle.js";
+/** A pending outbox row claimed for dispatch. The generic shape the drain needs. */
+export interface OutboxRow {
+    /** Primary key (used to mark dispatched). */
+    id: string | number;
+    /** The dedupe id the consumer dedupes on. */
+    event_id: string;
+    /** The outbox topic. */
+    topic: string;
+    /** Source emission time (ms epoch or ISO) for lag + FIFO order. */
+    occurred_at: string | number;
+    /** The rest of the row (the publisher serializes whatever it needs). */
+    [key: string]: unknown;
+}
+/** The injected publisher — XADDs (or otherwise emits) a row + returns the id. */
+export type OutboxPublisher = (row: OutboxRow) => Promise<string | null>;
+export interface OutboxDispatcherOpts {
+    /** The injected publisher (e.g. an XADD to the topic's stream). */
+    publish: OutboxPublisher;
+    /**
+     * Opens a claim transaction. The drain claims rows + marks dispatched +
+     * advances the cursor on THIS tx so the mark + cursor commit together-or-none.
+     */
+    begin: <T>(fn: (tx: SqlExecutor) => Promise<T>) => Promise<T>;
+    /** Claims a batch of pending rows ON the claim tx (FOR UPDATE SKIP LOCKED). */
+    claimBatch: (tx: SqlExecutor, batchSize: number) => Promise<OutboxRow[]>;
+    /** Marks a row dispatched ON the claim tx (sets dispatched_at + stream_id). */
+    markDispatched: (tx: SqlExecutor, id: string | number, streamId: string | null) => Promise<void>;
+    /** Records a publish failure ON the claim tx (D401: bump attempts; keep row). */
+    recordFailure?: (tx: SqlExecutor, id: string | number, errorMessage: string) => Promise<void>;
+    checkpoint: CheckpointStore;
+    /** Lease config (service + scope=outbox + ttlMs). */
+    lease: Omit<SingleActiveLeaseOpts, "onLeaseLost">;
+    /** Checkpoint subscription key. Default `outbox:<service>`. */
+    subscription?: string;
+    /**
+     * OPTIONAL and currently NOT invoked on any drain path. Per D401 the producer
+     * drain has NO source-side dead-letter: a terminal / unpublishable row is
+     * surfaced via `recordFailure` (keep-row, publish_attempts bumped) + the
+     * 24h-unpublished sweep, NOT a sink. The sink is accepted for API symmetry with
+     * the consumer workers (StreamsWorker/ReplicationWorker, which DO dead-letter
+     * poison events) and a future opt-in; if provided it is PII-redacted, but no
+     * path calls it today.
+     */
+    deadLetter?: DeadLetterSink;
+    /** Rows claimed per drain pass. Default 100. */
+    batchSize?: number;
+    /** Poll interval (ms) when the loop runs autonomously. Default 1_000. */
+    pollMs?: number;
+    hooks?: ObservabilityHooks;
+    workerLabel?: string;
+    /** Launch the background drain loop on `start()`. Default true; tests pass
+     *  false to drive `drainOnce()`/`runOnce()` deterministically. */
+    autoStart?: boolean;
+}
+/**
+ * OutboxDispatcher — the Pattern-3 producer drain. Composes lease + checkpoint +
+ * hooks + drain. Single-active; the mark-dispatched + cursor advance are atomic
+ * in the claim tx; publish is at-least-once (the consumer dedupes).
+ */
+export declare class OutboxDispatcher implements WorkerHandle {
+    private readonly publish;
+    private readonly begin;
+    private readonly claimBatch;
+    private readonly markDispatched;
+    private readonly recordFailure?;
+    private readonly checkpoint;
+    private readonly lease;
+    private readonly subscription;
+    private readonly deadLetter?;
+    private readonly batchSize;
+    private readonly pollMs;
+    private readonly hooks;
+    private readonly autoStart;
+    private _running;
+    private _stopped;
+    private _inFlight;
+    private _hwm;
+    private _lastAppliedAtMs;
+    private loop;
+    constructor(opts: OutboxDispatcherOpts);
+    get running(): boolean;
+    get leaseAcquired(): boolean;
+    get lag(): number | null;
+    get currentHwm(): WorkerHwm;
+    start(): Promise<void>;
+    private hydrateCursor;
+    private runLoop;
+    /**
+     * One drain pass: claim a batch in ONE tx, publish each, mark dispatched +
+     * advance the HWM cursor (fence-guarded) in the SAME tx. Returns the count
+     * dispatched. The publish runs INSIDE the claim tx so the row-lock is held
+     * across it (a second dispatcher can't double-claim); at-least-once safe (a
+     * crash after publish but before commit re-publishes; the consumer dedupes).
+     */
+    drainOnce(): Promise<number>;
+    /** Run exactly one drain pass (test seam / cron tick). */
+    runOnce(): Promise<number>;
+    stop(opts?: WorkerStopOptions): Promise<WorkerStopResult>;
+}
+//# sourceMappingURL=outbox-dispatcher.d.ts.map

package/dist/worker/outbox-dispatcher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"outbox-dispatcher.d.ts","sourceRoot":"","sources":["../../src/worker/outbox-dispatcher.ts"],"names":[],"mappings":"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"}