@classytic/arc 2.41.1 → 2.44.0

package/dist/index-CFfLKMH4.d.mts

@@ -1,290 +0,0 @@
-
-import { _ as HealthCheck, a as ModuleContribution, f as ScheduleDefinition, n as ArcModuleInput, r as ArcModuleRegistry, s as ModuleSetupContext, t as ArcModule } from "./types-DfVDvkdP.mjs";
-import { FastifyInstance } from "fastify";
-//#region src/factory/module/contributions.d.ts
-/**
- * Collect every module's `healthChecks` in the caller's order. Fails at boot
- * on a duplicate check `name` across modules, naming BOTH owning modules.
- * The host's app-level checks are appended AFTER this (modules-first,
- * host-last) by the caller.
- */
-declare function collectModuleHealthChecks(modules: readonly ArcModule[]): HealthCheck[];
-/**
- * Collect every module's `workflows`. Resolves factory contributions (so a
- * factory can close over a container the caller has already decorated on
- * `fastify`) and flattens to a single opaque array. Arc core deliberately
- * does NOT validate or interpret the values — the streamline integration
- * owns name/shape checks and registration. Called by the integration at init
- * time, not by arc's boot pipeline (workflows depend on the integration's
- * container).
- */
-declare function collectModuleWorkflows(fastify: FastifyInstance, modules: readonly ArcModule[]): Promise<unknown[]>;
-/**
- * Collect every module's `scheduledJobs`. Resolves factory contributions
- * (after bootstraps) and fails at boot on a duplicate job `name` across
- * modules. The caller passes the returned definitions to the canonical
- * schedules plugin; factories must therefore be resolved only once.
- */
-declare function collectModuleScheduledJobs(fastify: FastifyInstance, modules: readonly ArcModule[],
-/**
- * Optional sink for per-module counts, filled as each arm resolves.
- *
- * Exists so `arc.moduleDescriptors` can report real numbers without
- * resolving the factories a SECOND time — a contribution factory closes over
- * booted engines and may register or allocate, so running it twice is not a
- * free read. One resolution feeds both activation and introspection.
- */
-countsByModule?: Map<string, number>): Promise<ScheduleDefinition[]>;
-//#endregion
-//#region src/factory/module/extend.d.ts
-/**
- * What a caller may add. Every mergeable arm of `ArcModule`, plus `bootstrap`
- * in wrapper form only.
- *
- * `name` is absent on purpose: renaming a module mid-composition breaks the
- * `dependsOn` graph and the registry key its consumers read, and it is the one
- * "extension" that is never additive.
- */
-interface ModuleExtension<TExports = unknown> {
-  dependsOn?: readonly string[];
-  owns?: readonly string[] | "provided";
-  resources?: ArcModule<TExports>["resources"];
-  eventHandlers?: ArcModule<TExports>["eventHandlers"];
-  scheduledJobs?: ArcModule<TExports>["scheduledJobs"];
-  workflows?: ArcModule<TExports>["workflows"];
-  healthChecks?: ArcModule<TExports>["healthChecks"];
-  errorMappers?: ArcModule<TExports>["errorMappers"];
-  plugins?: ArcModule<TExports>["plugins"];
-  afterResources?: ArcModule<TExports>["afterResources"];
-  onClose?: ArcModule<TExports>["onClose"];
-  /**
-   * WRAP the module's bootstrap — it is never replaced.
-   *
-   * Bootstrap returns the module's exports, so two of them cannot be
-   * concatenated: one value has to win, and a host silently winning is the gym
-   * failure (`{ ...mod, bootstrap }` overwrote the factory's own, so the engine
-   * the module published was never created). The wrapper form makes the
-   * relationship explicit — call `inner` and decorate its result, or
-   * deliberately do not.
-   *
-   * `inner` is `undefined` when the module has no bootstrap of its own.
-   */
-  bootstrap?: (inner: ((f: FastifyInstance, c: ModuleSetupContext) => TExports | Promise<TExports>) | undefined) => (f: FastifyInstance, c: ModuleSetupContext) => TExports | Promise<TExports>;
-}
-/**
- * Merge a host's additions onto a module. Nothing the module declared is lost.
- *
- * ```ts
- * return extendModule(createOrderModule({ … }), {
- *   eventHandlers: () => hostHandlers(),      // appended after the module's
- *   dependsOn: ["outbox"],                    // unioned
- *   bootstrap: (inner) => async (f, c) => {   // wraps, never replaces
- *     const exports = await inner?.(f, c);
- *     return decorate(exports);
- *   },
- * });
- * ```
- */
-declare function extendModule<TExports = unknown>(mod: ArcModule<TExports>, extension: ModuleExtension<TExports>): ArcModule<TExports>;
-//#endregion
-//#region src/factory/module/lifecycle.d.ts
-/**
- * Subscribe every module's `eventHandlers` in dependency order (pass the
- * `orderModules`-sorted list). Returns the ordered list of unsubscribe
- * functions so the caller can tear them down at shutdown BEFORE module
- * `onClose` (while module deps are still alive). Fails at boot on:
- *   - a duplicate NAMED handler across modules (attributing both owners);
- *   - a module declaring handlers while the event subsystem is unavailable.
- * Resolves factory contributions (after bootstraps) so a handler can close over
- * booted engines rather than a global getter.
- */
-declare function subscribeModuleEventHandlers(fastify: FastifyInstance, modules: readonly ArcModule[],
-/**
- * Optional sink for per-module handler counts, filled as each arm resolves.
- * Lets `arc.moduleDescriptors` report real numbers without resolving the
- * factories a SECOND time — see the note on `collectModuleScheduledJobs`.
- */
-countsByModule?: Map<string, number>): Promise<Array<() => void | Promise<void>>>;
-//#endregion
-//#region src/factory/module/order.d.ts
-/**
- * Order modules for composition by their `dependsOn` edges — a STABLE
- * topological sort. Called once at the start of the bootstrap phase; every
- * subsequent phase (bootstrap, resources, afterResources, and reverse-order
- * onClose) iterates the returned list, so a module's declared dependencies are
- * always composed before it.
- *
- * "Stable" = modules with no edge between them keep their original list order,
- * so declaring `dependsOn` on one module never silently reorders an unrelated
- * one. Backward compatible: a `modules` array with NO `dependsOn` anywhere is
- * returned unchanged.
- *
- * Fail-fast — throws (never reorders past a broken contract) on:
- *   - duplicate module names (the name is the graph key)
- *   - a `dependsOn` name not present in the composed set
- *   - a self-reference (`dependsOn` includes the module's own name)
- *   - a dependency cycle (reports the concrete `a → b → … → a` path)
- */
-declare function orderModules(modules: readonly ArcModule[]): ArcModule[];
-//#endregion
-//#region src/factory/module/resolve.d.ts
-/**
- * Resolve any module-input form to a concrete `ArcModule`. A thunk is invoked
- * (this is where a dynamic `import()` fires); a promise (or plain module) is
- * awaited. Called once per module at the start of the bootstrap phase.
- */
-declare function resolveModule(input: ArcModuleInput): Promise<ArcModule>;
-/** Resolve a `ModuleContribution` to a concrete array (array passthrough or factory call). */
-declare function resolveContribution<T>(contribution: ModuleContribution<T> | undefined, fastify: FastifyInstance): Promise<readonly T[]>;
-//#endregion
-//#region src/factory/module/state.d.ts
-type ModuleState = "resolved" | "bootstrapping" | "ready" | "closing" | "closed" | "failed";
-/**
- * Is `name` in the composed module graph? TRUE for resource-only modules and
- * modules that exported nothing — the question `hasModuleExports()` cannot
- * answer. FALSE before registerResources runs (no graph yet) and for
- * uncomposed names.
- */
-declare function hasModule(fastify: FastifyInstance, name: string): boolean;
-/**
- * The module's current lifecycle state, or `undefined` when the module is not
- * composed (or no graph has been composed on this instance). See the state
- * machine in the file header.
- */
-declare function getModuleState(fastify: FastifyInstance, name: string): ModuleState | undefined;
-//#endregion
-//#region src/factory/module/index.d.ts
-/**
- * Identity helper for authoring a typed module — mirrors `defineResource`.
- * Gives inference + a single obvious construction site; does no work.
- *
- * `TExports` is inferred from the `bootstrap` return value, so a module
- * author gets a typed public export for free:
- *
- * ```ts
- * export const accountingModule = (deps: Deps) =>
- *   defineModule({
- *     name: "accounting",
- *     bootstrap: async () => createAccountingEngine(deps), // TExports inferred
- *   });
- * ```
- */
-declare function defineModule<TExports = unknown>(module: ArcModule<TExports>): ArcModule<TExports>;
-/**
- * Typed accessor for a module's public export (its `bootstrap` return value),
- * recorded at `fastify.arc.modules[name]`.
- *
- * Throwing, in line with the fail-fast contract (and `requireOrgId`-style
- * accessors): a missing entry means the module either isn't composed, is
- * composed AFTER the caller (list order = init order), or returned nothing —
- * all wiring bugs that must surface at boot, not as `undefined` downstream.
- *
- * The type parameter is an assertion, not a proof. Two ways to type it:
- *   - augment `ArcModuleRegistry` once — then the name alone infers the type:
- *     `getModuleExports(f, "accounting")` → `AccountingEngine`.
- *   - or pass it inline: `getModuleExports<AccountingEngine>(f, "accounting")`.
- *
- * Siblings, for the two shapes this one is wrong for:
- *   - `getOptionalModuleExports` — the module is genuinely OPTIONAL.
- *   - `lazyModuleExports` / `lazyRequiredModuleExports` — the read happens at
- *     composition time, where boot order decides the answer.
- */
-declare function getModuleExports<K extends keyof ArcModuleRegistry>(fastify: FastifyInstance, name: K): ArcModuleRegistry[K];
-declare function getModuleExports<TExports = unknown>(fastify: FastifyInstance, name: string): TExports;
-/**
- * Non-throwing sibling of `getModuleExports`: `undefined` when the module is
- * not composed (or has not bootstrapped yet).
- *
- * Exists because OPTIONAL sibling modules are a first-class composition shape —
- * a deployment that turns `inventory` off still sells services, so its POS
- * module must ask "is inventory here?" rather than fail-fast. Hosts were
- * spelling that question as
- *
- * ```ts
- * (fastify as { arc?: { modules?: Record<string, unknown> } })
- *   .arc?.modules?.inventory;
- * ```
- *
- * — a double cast that (a) defeats `ArcModuleRegistry` inference, (b) silently
- * survives a typo in the module name, and (c) is impossible to grep for. Use
- * `getModuleExports` when the dependency is REQUIRED (boot must fail), this
- * when it is genuinely optional.
- *
- * Prefer `lazyModuleExports` whenever the read happens at COMPOSITION time —
- * see its doc for why a value read once can latch `undefined` forever.
- */
-declare function getOptionalModuleExports<K extends keyof ArcModuleRegistry>(fastify: FastifyInstance, name: K): ArcModuleRegistry[K] | undefined;
-declare function getOptionalModuleExports<TExports = unknown>(fastify: FastifyInstance, name: string): TExports | undefined;
-/**
- * Is a module's public export recorded yet? The predicate form of
- * `getOptionalModuleExports`, for readiness gates (`ready: () => ...`) that
- * should not have to reason about falsy-but-present exports.
- */
-declare function hasModuleExports(fastify: FastifyInstance, name: string): boolean;
-/**
- * A DEFERRED reader of a sibling module's export: returns a getter that reads
- * the registry at CALL time, not now.
- *
- * ── Why this exists (the bug it removes) ─────────────────────────────────────
- *
- * Module composition runs bootstraps in dependency/list order, but a lot of
- * wiring is *registered* earlier than it *runs*: an `eventHandlers` factory, a
- * bridge accessor handed to another module, a hook added during bootstrap and
- * fired per request. Such a factory can execute BEFORE the sibling it needs has
- * bootstrapped — so a sibling engine captured into a local at that moment is
- * `undefined`, and stays `undefined` for the life of the process even though the
- * sibling came up milliseconds later.
- *
- * That failure is SILENT by construction: the consumer sees a null bridge and
- * treats it as "this deployment has no inventory / no revenue engine", which is
- * a legitimate configuration. Real cost in this codebase: orders were created
- * and never payment-confirmed (no entitlement, no card, no door) and nothing
- * errored anywhere.
- *
- * The getter therefore:
- *   - re-reads while the module is ABSENT, so boot order cannot matter;
- *   - memoizes the FIRST resolved value, so the steady-state read is a closure
- *     variable rather than a registry lookup per request;
- *   - never memoizes absence — that is precisely the latch this replaces.
- *
- * ```ts
- * const inventory = lazyModuleExports<FlowEngine>(fastify, "inventory");
- * return {
- *   flowBridge: () => (inventory() ? createFlowEngineBridge({ getFlowEngine: () => inventory()! }) : null),
- *   ready: () => inventory() !== undefined,
- * };
- * ```
- */
-declare function lazyModuleExports<K extends keyof ArcModuleRegistry>(fastify: FastifyInstance, name: K): () => ArcModuleRegistry[K] | undefined;
-declare function lazyModuleExports<TExports = unknown>(fastify: FastifyInstance, name: string): () => TExports | undefined;
-/**
- * Required counterpart of `lazyModuleExports`: defers the read, then throws
- * `getModuleExports`' error if the module is still absent at first use.
- *
- * The pair matters because "required" and "readable now" are different
- * questions. A hook registered at bootstrap that needs the `order` engine at
- * REQUEST time is a hard dependency, but reading it eagerly turns a correct
- * composition into a boot crash purely because of list order. Deferring keeps
- * the fail-fast guarantee and moves it to the first moment the answer is
- * actually needed.
- *
- * Deferred does NOT mean unvalidated: a lazily-required module is still a
- * HARD dependency, so PRESENCE is checked eagerly. When the composed module
- * graph is known (any `createApp`/`registerResources` boot — the normal
- * case), a name that is not in the graph throws HERE, at composition time,
- * instead of surviving startup and failing on the first request or event.
- * Only the EXPORT read (does bootstrap's return value exist yet?) is
- * deferred to first call.
- *
- * Convention for hard sibling access: also declare the target in the
- * consumer's `dependsOn`. That orders composition (the sibling's bootstrap
- * runs first), while this accessor merely defers the read — the two are
- * complementary, not alternatives:
- *   - hard dependency, read during bootstrap → `dependsOn` + `getModuleExports`
- *   - hard dependency, read at request/event time → `dependsOn` + this
- *   - optional integration → `lazyModuleExports` (no `dependsOn` needed)
- */
-declare function lazyRequiredModuleExports<K extends keyof ArcModuleRegistry>(fastify: FastifyInstance, name: K): () => ArcModuleRegistry[K];
-declare function lazyRequiredModuleExports<TExports = unknown>(fastify: FastifyInstance, name: string): () => TExports;
-//#endregion
-export { collectModuleScheduledJobs as _, lazyModuleExports as a, getModuleState as c, resolveModule as d, orderModules as f, collectModuleHealthChecks as g, extendModule as h, hasModuleExports as i, hasModule as l, ModuleExtension as m, getModuleExports as n, lazyRequiredModuleExports as o, subscribeModuleEventHandlers as p, getOptionalModuleExports as r, ModuleState as s, defineModule as t, resolveContribution as u, collectModuleWorkflows as v };

package/dist/interface-YzIbF7Ii.mjs

@@ -1,17 +0,0 @@
-/*! @classytic/arc v2.41.1 | MIT | https://classytic.com */
-//#region src/idempotency/stores/interface.ts
-/**
-* Helper to create a result object
-*/
-function createIdempotencyResult(statusCode, body, headers, ttlMs) {
-	const now = /* @__PURE__ */ new Date();
-	return {
-		statusCode,
-		headers,
-		body,
-		createdAt: now,
-		expiresAt: new Date(now.getTime() + ttlMs)
-	};
-}
-//#endregion
-export { createIdempotencyResult as t };

package/dist/redis-stream-BPKscsTB.d.mts

@@ -1,260 +0,0 @@
-
-import { a as EventTransport, i as EventLogger, n as DomainEvent, r as EventHandler } from "./EventTransport-CbUKDzZZ.mjs";
-//#region src/events/transports/redis-stream.d.ts
-interface RedisStreamLike {
-  xadd(key: string, id: string, ...fieldValues: string[]): Promise<string | null>;
-  xreadgroup(command: "GROUP", group: string, consumer: string, ...args: unknown[]): Promise<Array<[string, Array<[string, string[] | null]>]> | null>;
-  xack(key: string, group: string, ...ids: unknown[]): Promise<number>;
-  xgroup(command: string, key: string, group: string, ...args: unknown[]): Promise<unknown>;
-  xpending(key: string, group: string, ...args: unknown[]): Promise<unknown[]>;
-  xclaim(key: string, group: string, consumer: string, minIdleTime: number, ...ids: unknown[]): Promise<unknown[]>;
-  xlen(key: string): Promise<number>;
-  /**
-   * Read a range of entries by id. When present, the DLQ writer uses this
-   * to fetch the original message payload so dead-lettered events are
-   * **fully replayable** (a re-publish of `envelope.event` is sufficient).
-   *
-   * Optional to preserve back-compat with custom Redis wrappers that
-   * satisfied the pre-2.11.3 shape. When missing, the DLQ envelope still
-   * carries the **error reason + attempt accounting** (operator-grade
-   * triage info survives), but `envelope.event.payload` is `null` and
-   * `envelope.event.type` is `<unknown>` — replay is NOT possible without
-   * upgrading the client. A one-shot warning fires per process so this
-   * isn't silent.
-   */
-  xrange?(key: string, start: string, end: string): Promise<Array<[string, string[]]>>;
-  /** Graceful close — flushes queued commands then closes. ioredis-style. */
-  quit(): Promise<unknown>;
-  /**
-   * Force-disconnect — closes the socket immediately, abandoning any
-   * pending command (including a live `XREADGROUP BLOCK`). Optional because
-   * non-ioredis clients may not expose a force path; `close()` falls back
-   * to `quit()` when this is missing, accepting a longer shutdown wait.
-   */
-  disconnect?(): void;
-}
-interface RedisStreamTransportOptions {
-  /**
-   * Redis stream key name.
-   * @default 'arc:events'
-   */
-  stream?: string;
-  /**
-   * Consumer group name. Each group receives every event independently.
-   * Multiple instances of the same service should share a group name.
-   * @default 'default'
-   */
-  group?: string;
-  /**
-   * Consumer name within the group. Must be unique per instance.
-   * @default 'consumer-<random>'
-   */
-  consumer?: string;
-  /**
-   * Block time in ms when waiting for new events.
-   * @default 5000
-   */
-  blockTimeMs?: number;
-  /**
-   * Max events to read per batch.
-   * @default 10
-   */
-  batchSize?: number;
-  /**
-   * Bounded concurrency for processing a batch's ENTRIES (default: 1 —
-   * strict stream order, the safe default). With one slow handler,
-   * throughput per consumer is ~`1 / total handler latency`; raising this
-   * processes up to N entries of a batch concurrently.
-   *
-   * Trade-off: entries within a batch may complete OUT OF ORDER — only
-   * raise it when handlers are order-independent (idempotent, keyed
-   * upserts). Handlers on this transport should be short and I/O-bound
-   * regardless; heavy work belongs in jobs. Matching handlers for a single
-   * event always run sequentially.
-   * @default 1
-   */
-  processingConcurrency?: number;
-  /**
-   * Max delivery attempts before moving to dead letter stream.
-   * @default 5
-   */
-  maxRetries?: number;
-  /**
-   * Idle time in ms before pending entries are claimed by this consumer.
-   * Handles crash recovery — if a consumer dies mid-processing, another
-   * consumer will claim its pending entries after this timeout.
-   * @default 30000
-   */
-  claimTimeoutMs?: number;
-  /**
-   * Dead letter stream name. Failed events are moved here after maxRetries.
-   * Set to `false` to disable DLQ (failed events are acked and dropped).
-   * @default 'arc:events:dlq'
-   */
-  deadLetterStream?: string | false;
-  /**
-   * Max stream length (approximate). Uses XADD MAXLEN ~ to trim old entries.
-   * Set to 0 to disable trimming.
-   * @default 10000
-   */
-  maxLen?: number;
-  /**
-   * Max event payload size in bytes. Publish rejects events exceeding this limit
-   * to prevent Redis memory exhaustion from oversized payloads.
-   * @default 1_000_000 (1 MB)
-   */
-  maxPayloadBytes?: number;
-  /**
-   * If `true`, `close()` does NOT call `redis.quit()` — useful when the host
-   * manages the Redis connection lifecycle externally (shared client across
-   * multiple transports / cache stores). Without this, every transport
-   * `close()` would tear down a shared client and break siblings.
-   *
-   * Mirror of `RedisEventTransportOptions.externalLifecycle`.
-   * @default false
-   */
-  externalLifecycle?: boolean;
-  /**
-   * Hard cap on how long `close()` waits for the in-flight `XREADGROUP BLOCK`
-   * iteration to drain. Tests and serverless shutdowns would otherwise hang
-   * up to `blockTimeMs` (default 5s) per close.
-   *
-   * Behaviour after timeout:
-   *   - `externalLifecycle: false` (default) — `redis.disconnect()` (or
-   *     `quit()` if the client lacks `disconnect`) breaks the BLOCK
-   *     immediately. Strict bounded close.
-   *   - `externalLifecycle: true` — arc CANNOT touch the host's connection,
-   *     so the poll loop is left to drain in the background when its
-   *     XREADGROUP returns. `close()` returns within `closeTimeoutMs` but
-   *     the loop's eventual completion is silently absorbed (no log spam,
-   *     no unhandled rejection). The contract here is "bounded return,
-   *     background drain" — set `blockTimeMs` low (e.g. 500ms) under
-   *     externalLifecycle to keep the drain window short.
-   *
-   * @default 1000
-   */
-  closeTimeoutMs?: number;
-  /**
-   * Logger for error messages (default: console).
-   * Pass `fastify.log` to integrate with your application logger.
-   */
-  logger?: EventLogger;
-}
-declare class RedisStreamTransport implements EventTransport {
-  readonly name = "redis-stream";
-  private redis;
-  private stream;
-  private group;
-  private consumer;
-  private blockTimeMs;
-  private batchSize;
-  private processingConcurrency;
-  private maxRetries;
-  private claimTimeoutMs;
-  private deadLetterStream;
-  private maxLen;
-  private maxPayloadBytes;
-  private logger;
-  /** Tracks the lifecycle policy — set in constructor, read in close(). */
-  private externalLifecycle;
-  private closeTimeoutMs;
-  private handlers;
-  private running;
-  private pollPromise;
-  /**
-   * Monotonic counter bumped every time the poll loop should stop —
-   * `unsubscribe` (last handler removed) and `close()` increment it. Each
-   * `pollLoop` instance captures its generation at start and exits when
-   * `this.generation` no longer matches. Prevents the
-   * subscribe → unsubscribe → fast-resubscribe race where the old loop
-   * would still be in `XREADGROUP BLOCK` while a new loop started, leading
-   * to two concurrent poll loops on the same consumer name.
-   */
-  private generation;
-  private groupCreated;
-  /**
-   * Last-seen failure context per message id, populated when an in-process
-   * handler throws in {@link processEntry}. Consumed (and cleared) by
-   * {@link moveToDlq} so the dead-letter envelope carries the actual error
-   * message instead of opaque "reclaimed without context". Entries are
-   * deleted on ack and on DLQ write; messages resolved by ANOTHER consumer
-   * never drain locally, so the map is additionally hard-capped at
-   * {@link MAX_FAILURE_CONTEXT_ENTRIES} with oldest-first eviction.
-   */
-  private failureContext;
-  /** One-shot guard so the "client lacks xrange" warning fires once per process. */
-  private xrangeWarningEmitted;
-  constructor(redis: RedisStreamLike, options?: RedisStreamTransportOptions);
-  publish(event: DomainEvent): Promise<void>;
-  subscribe(pattern: string, handler: EventHandler): Promise<() => void>;
-  /**
-   * Stop polling and release transport state.
-   *
-   * **Two close contracts** — pick the one that matches your deployment:
-   *
-   * 1. **Default (`externalLifecycle: false`) — strict bounded close.**
-   *    `close()` waits up to `closeTimeoutMs` for the in-flight
-   *    `XREADGROUP BLOCK` to drain. On timeout it calls `redis.disconnect()`
-   *    (or `quit()` if the client lacks `disconnect`) to break the BLOCK
-   *    immediately, then awaits the loop's exit. After `close()` returns
-   *    the transport is fully closed and the connection is released.
-   *
-   * 2. **`externalLifecycle: true` — bounded RETURN, background drain.**
-   *    Arc must NOT touch a connection it doesn't own. `close()` returns
-   *    within `closeTimeoutMs`, but the poll loop is left to drain on its
-   *    own when its outstanding `XREADGROUP BLOCK` returns (up to
-   *    `blockTimeMs`). Arc silently absorbs the loop's eventual completion
-   *    so the host doesn't see unhandled rejections / log spam against a
-   *    transport it considers closed. The host's own `redis.quit()` /
-   *    process exit is what ultimately tears the connection down.
-   *
-   *    Practical implication: under `externalLifecycle: true`, set
-   *    `blockTimeMs` low (e.g. 500ms) so the background drain window is
-   *    short. The transport is "closed enough" to stop dispatching to
-   *    handlers (handlers map is cleared and generation is bumped) but is
-   *    not "fully closed" in the connection-lifecycle sense until the host
-   *    closes the underlying client.
-   *
-   * In both modes the generation counter is bumped, so a follow-up
-   * `subscribe()` spawns a fresh poll loop with a new generation — the
-   * stale loop exits on its next iteration and never overlaps the new one.
-   */
-  close(): Promise<void>;
-  private ensureGroup;
-  private pollLoop;
-  private readNewMessages;
-  /**
-   * Process a batch's entries with bounded concurrency
-   * (`processingConcurrency`, default 1 = strict order). Worker-pool over a
-   * shared index — at most N entries in flight, each entry's own handlers
-   * still sequential inside `processEntry`.
-   */
-  private processEntries;
-  private claimPending;
-  private processEntry;
-  /**
-   * The canonical matcher from primitives — the SAME glob rules the memory
-   * transport speaks. A private matcher here once accepted `prefix.*` but not
-   * `prefix:*`, so an `order:*` subscription that worked in-process received
-   * nothing after a move to the stream, with no error.
-   */
-  private getMatchingHandlers;
-  private moveToDlq;
-  /**
-   * Reconstruct a `DeadLetteredEvent` for a message id. Reads the original
-   * entry via `xrange` (when the client supports it) and merges in any
-   * in-process failure context. Returns `null` only when BOTH sources are
-   * missing — callers ack-and-drop rather than re-queuing a ghost.
-   *
-   * Graceful degradation paths:
-   *   - Client lacks `xrange` (older custom wrappers) → log once, build the
-   *     envelope from `failureContext` alone. Payload is absent but the
-   *     error reason + attempt accounting still survive.
-   *   - `xrange` throws (network blip, ACL) → same fallback.
-   *   - Source entry trimmed before DLQ write → same fallback.
-   */
-  private buildDlqEnvelope;
-  private sleep;
-}
-//#endregion
-export { RedisStreamTransport as n, RedisStreamTransportOptions as r, RedisStreamLike as t };