@adonis-agora/durable 0.49.0 → 0.50.0

package/dist/src/transports/bullmq/deps.d.ts

@@ -39,7 +39,16 @@ export interface RedisLike {
     get(key: string): Promise<string | null>;
     /** Batched read — optional: a client without it falls back to per-key `get`. */
     mget?(...keys: string[]): Promise<(string | null)[]>;
-    disconnect(): void;
+    /**
+     * Liveness probe the subscriber watchdog sends (legal in subscriber mode). Optional: a client
+     * without it is simply never probed.
+     */
+    ping?(): Promise<unknown>;
+    /** ioredis connection state (`'ready'`, `'connecting'`, `'reconnecting'`, ...). The watchdog only
+     *  probes a `'ready'` connection; absent reads as ready. */
+    readonly status?: string | undefined;
+    /** `disconnect(true)` drops the socket and lets ioredis reconnect (and `autoResubscribe`). */
+    disconnect(reconnect?: boolean): void;
 }
 /**
  * The broker factory the transport is constructed with. Each `make*` mints a fresh broker object
@@ -75,5 +84,12 @@ export declare function workerConcurrency(value: number | undefined, fallback?:
  * an ioredis client with NO host/port, landing on ioredis's own default (`127.0.0.1:6379`) instead of
  * the caller's Redis.
  */
-export declare function createBullMQDeps(connection: unknown, concurrency?: number): Promise<BullMQDeps>;
+/**
+ * A `redis://` / `rediss://` URL as ioredis `ConnectionOptions`. BullMQ's `Queue`/`Worker` and this
+ * module's own `{ keepAlive, ...connection }` spread only understand an options object or a `Redis`
+ * instance: a bare string was spread character by character and silently fell back to ioredis's
+ * default 127.0.0.1:6379. `rediss:` turns on TLS; the path's first segment selects the db.
+ */
+export declare function redisUrlToOptions(url: string): Record<string, unknown>;
+export declare function createBullMQDeps(rawConnection: unknown, concurrency?: number): Promise<BullMQDeps>;
 //# sourceMappingURL=deps.d.ts.map

package/dist/src/transports/bullmq/deps.d.ts.map

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

package/dist/src/transports/bullmq/deps.js

@@ -26,7 +26,50 @@ export function workerConcurrency(value, fallback = 1) {
  * an ioredis client with NO host/port, landing on ioredis's own default (`127.0.0.1:6379`) instead of
  * the caller's Redis.
  */
-export async function createBullMQDeps(connection, concurrency = 1) {
+/**
+ * A `redis://` / `rediss://` URL as ioredis `ConnectionOptions`. BullMQ's `Queue`/`Worker` and this
+ * module's own `{ keepAlive, ...connection }` spread only understand an options object or a `Redis`
+ * instance: a bare string was spread character by character and silently fell back to ioredis's
+ * default 127.0.0.1:6379. `rediss:` turns on TLS; the path's first segment selects the db.
+ */
+export function redisUrlToOptions(url) {
+    let parsed;
+    try {
+        parsed = new URL(url);
+    }
+    catch {
+        throw new Error(`@agora/durable: transports.bullmq() got an invalid Redis URL: ${url}`);
+    }
+    if (parsed.protocol !== 'redis:' && parsed.protocol !== 'rediss:') {
+        throw new Error(`@agora/durable: transports.bullmq() expects a redis:// or rediss:// URL, got ${parsed.protocol}`);
+    }
+    const options = {
+        host: parsed.hostname || '127.0.0.1',
+        port: parsed.port ? Number(parsed.port) : 6379,
+    };
+    if (parsed.username)
+        options.username = decodeURIComponent(parsed.username);
+    if (parsed.password)
+        options.password = decodeURIComponent(parsed.password);
+    const db = parsed.pathname.replace(/^\//, '').split('/')[0];
+    if (db) {
+        const n = Number(db);
+        if (!Number.isInteger(n) || n < 0) {
+            throw new Error(`@agora/durable: transports.bullmq() got an invalid Redis db "${db}" in ${url}`);
+        }
+        options.db = n;
+    }
+    // Query parameters (ioredis-style knobs, TLS CA paths…) are not mapped: refuse them rather than drop
+    // them silently — pass `ConnectionOptions` for anything beyond host, port, credentials, db and TLS.
+    if (parsed.search) {
+        throw new Error(`@agora/durable: transports.bullmq() does not read query parameters from a Redis URL (${parsed.search}); pass ConnectionOptions instead.`);
+    }
+    if (parsed.protocol === 'rediss:')
+        options.tls = {};
+    return options;
+}
+export async function createBullMQDeps(rawConnection, concurrency = 1) {
+    const connection = typeof rawConnection === 'string' ? redisUrlToOptions(rawConnection) : rawConnection;
     const defaultConcurrency = workerConcurrency(concurrency);
     // Non-literal specifiers: keep `tsc` from resolving 'bullmq'/'ioredis' at build time (they are a
     // runtime-only dependency of the selected transport), so the wider package builds without them.
@@ -42,7 +85,6 @@ export async function createBullMQDeps(connection, concurrency = 1) {
     // instead, the same way `resolveQueueAdapter` does for a missing `transports.queue()` connection: an
     // existing `Redis` instance, a connection string, or a non-empty options object is required.
     const hasUsableConnection = isRedisInstance(connection) ||
-        typeof connection === 'string' ||
         (typeof connection === 'object' && connection !== null && Object.keys(connection).length > 0);
     if (!hasUsableConnection) {
         const got = connection === undefined ? 'undefined' : JSON.stringify(connection);

package/dist/src/transports/bullmq/deps.js.map

@@ -1 +1 @@
-{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../../../src/transports/bullmq/deps.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAuDH;;;GAGG;AACH,MAAM,UAAU,iBAAiB,CAAC,KAAyB,EAAE,QAAQ,GAAG,CAAC;IACvE,OAAO,KAAK,KAAK,SAAS,IAAI,MAAM,CAAC,QAAQ,CAAC,KAAK,CAAC,IAAI,KAAK,IAAI,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AACpG,CAAC;AAED;;;;;;;;;;;;;GAaG;AACH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,UAAmB,EAAE,WAAW,GAAG,CAAC;IACzE,MAAM,kBAAkB,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC;IAC1D,iGAAiG;IACjG,gGAAgG;IAChG,MAAM,eAAe,GAAG,QAAQ,CAAC;IACjC,MAAM,gBAAgB,GAAG,SAAS,CAAC;IACnC,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,eAAe,CAAC,CAGvD,CAAC;IACF,MAAM,EAAE,KAAK,EAAE,GAAG,CAAC,MAAM,MAAM,CAAC,gBAAgB,CAAC,CAEhD,CAAC;IAEF,MAAM,eAAe,GAAG,CAAC,KAAc,EAAmD,EAAE,CAC1F,KAAK,YAAa,KAA8D,CAAC;IAEnF,0GAA0G;IAC1G,sGAAsG;IACtG,yGAAyG;IACzG,wGAAwG;IACxG,qGAAqG;IACrG,6FAA6F;IAC7F,MAAM,mBAAmB,GACvB,eAAe,CAAC,UAAU,CAAC;QAC3B,OAAO,UAAU,KAAK,QAAQ;QAC9B,CAAC,OAAO,UAAU,KAAK,QAAQ,IAAI,UAAU,KAAK,IAAI,IAAI,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAChG,IAAI,CAAC,mBAAmB,EAAE,CAAC;QACzB,MAAM,GAAG,GAAG,UAAU,KAAK,SAAS,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,UAAU,CAAC,CAAC;QAChF,MAAM,IAAI,KAAK,CACb,2KAA2K,GAAG,mHAAmH,CAClS,CAAC;IACJ,CAAC;IAED,2FAA2F;IAC3F,MAAM,gBAAgB,GAAG,GAAY,EAAE,CACrC,UAAU,IAAI,OAAO,UAAU,KAAK,QAAQ,IAAI,CAAC,CAAC,SAAS,IAAI,UAAU,CAAC;QACxE,CAAC,CAAC,EAAE,GAAI,UAAqB,EAAE,oBAAoB,EAAE,IAAI,EAAE;QAC3D,CAAC,CAAC,UAAU,CAAC;IAEjB,MAAM,SAAS,GAAG,GAAc,EAAE;QAChC,IAAI,eAAe,CAAC,UAAU,CAAC;YAAE,OAAO,UAAU,CAAC,SAAS,EAAE,CAAC;QAC/D,OAAO,IAAI,KAAK,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,GAAI,UAAqB,EAAE,CAAC,CAAC;IACrE,CAAC,CAAC;IAEF,OAAO;QACL,SAAS,EAAE,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,KAAK,CAAC,IAAI,EAAE,EAAE,UAAU,EAAE,CAAC;QACpD,UAAU,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,IAAI,EAAE,EAAE,CAClC,IAAI,MAAM,CAAC,IAAI,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE;YACtC,UAAU,EAAE,gBAAgB,EAAE;YAC9B,WAAW,EAAE,iBAAiB,CAAC,IAAI,EAAE,WAAW,EAAE,kBAAkB,CAAC;SACtE,CAAC;QACJ,SAAS;KACV,CAAC;AACJ,CAAC"}
+{"version":3,"file":"deps.js","sourceRoot":"","sources":["../../../../src/transports/bullmq/deps.ts"],"names":[],"mappings":"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"}

package/dist/src/transports/db-helpers.d.ts

@@ -7,4 +7,43 @@ import { Database } from '@adonisjs/lucid/database';
 export declare function makeMemoryDb(): Database;
 /** A fresh in-memory db with the transport tables already created. */
 export declare function makeTransportDb(): Promise<Database>;
+/**
+ * Prefix of the throwaway schemas {@link makeIsolatedPostgresDb} creates. The test suite's global
+ * teardown drops every schema carrying it, so a run that crashed mid-file leaves nothing behind.
+ */
+export declare const POSTGRES_TEST_SCHEMA_PREFIX = "durable_t_";
+/**
+ * The prefix of THIS test run's throwaway schemas: {@link POSTGRES_TEST_SCHEMA_PREFIX} plus the run id
+ * the suite's global setup puts in `DURABLE_PG_TEST_RUN` (inherited by every test worker). The global
+ * teardown drops only this run's schemas, so two runs sharing one server (a developer's parallel runs,
+ * two packages, a retried job on a shared runner) never drop each other's tables mid-test.
+ */
+export declare function postgresTestSchemaPrefix(): string;
+/**
+ * Connections per Postgres test pool. Small on purpose: test files run in parallel (and the
+ * multi-process scenarios fork workers, each with its own pool), and a slow machine makes every pool
+ * grow to its max, so a pool of 10 per database exhausted the server's `max_connections` in CI.
+ */
+export declare const POSTGRES_TEST_POOL_MAX = 3;
+/**
+ * A standalone Lucid `Database` over Postgres (`pg`), every query scoped to `schema` through the
+ * connection's `search_path` — the Postgres twin of {@link makeMemoryDb}. The schema must exist (see
+ * {@link makeIsolatedPostgresDb}); this only connects. Used by tests and by the child processes the
+ * multi-process transport tests spawn against a schema their parent created.
+ */
+export declare function makePostgresDb(url: string, schema: string, poolMax?: number): Database;
+/**
+ * A fresh, EMPTY Postgres database for one test: a new schema (unique per call, so test files running
+ * in parallel never see each other's tables) and a `Database` scoped to it. `db.manager.closeAll()`
+ * drops the schema before closing — the same "gone when closed" lifetime a `:memory:` SQLite db has.
+ * `keepSchema` leaves it (the caller drops it), and `schema` reports its name, for tests that hand it
+ * to child processes.
+ */
+export declare function makeIsolatedPostgresDb(url: string, opts?: {
+    keepSchema?: boolean;
+}): Promise<Database & {
+    schemaName: string;
+}>;
+/** A fresh isolated Postgres schema with the transport tables already created. */
+export declare function makePostgresTransportDb(url: string): Promise<Database>;
 //# sourceMappingURL=db-helpers.d.ts.map

package/dist/src/transports/db-helpers.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-helpers.d.ts","sourceRoot":"","sources":["../../../src/transports/db-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAoBvC;AAED,sEAAsE;AACtE,wBAAsB,eAAe,IAAI,OAAO,CAAC,QAAQ,CAAC,CAIzD"}
+{"version":3,"file":"db-helpers.d.ts","sourceRoot":"","sources":["../../../src/transports/db-helpers.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAGpD;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,QAAQ,CAoBvC;AAED,sEAAsE;AACtE,wBAAsB,eAAe,IAAI,OAAO,CAAC,QAAQ,CAAC,CAIzD;AAED;;;GAGG;AACH,eAAO,MAAM,2BAA2B,eAAe,CAAC;AAExD;;;;;GAKG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,CAGjD;AAED;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,IAAI,CAAC;AAExC;;;;;GAKG;AACH,wBAAgB,cAAc,CAC5B,GAAG,EAAE,MAAM,EACX,MAAM,EAAE,MAAM,EACd,OAAO,GAAE,MAA+B,GACvC,QAAQ,CAkBV;AAED;;;;;;GAMG;AACH,wBAAsB,sBAAsB,CAC1C,GAAG,EAAE,MAAM,EACX,IAAI,GAAE;IAAE,UAAU,CAAC,EAAE,OAAO,CAAA;CAAO,GAClC,OAAO,CAAC,QAAQ,GAAG;IAAE,UAAU,EAAE,MAAM,CAAA;CAAE,CAAC,CAiB5C;AAED,kFAAkF;AAClF,wBAAsB,uBAAuB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,QAAQ,CAAC,CAI5E"}

package/dist/src/transports/db-helpers.js

@@ -30,4 +30,77 @@ export async function makeTransportDb() {
     await createDurableTransportTables(db);
     return db;
 }
+/**
+ * Prefix of the throwaway schemas {@link makeIsolatedPostgresDb} creates. The test suite's global
+ * teardown drops every schema carrying it, so a run that crashed mid-file leaves nothing behind.
+ */
+export const POSTGRES_TEST_SCHEMA_PREFIX = 'durable_t_';
+/**
+ * The prefix of THIS test run's throwaway schemas: {@link POSTGRES_TEST_SCHEMA_PREFIX} plus the run id
+ * the suite's global setup puts in `DURABLE_PG_TEST_RUN` (inherited by every test worker). The global
+ * teardown drops only this run's schemas, so two runs sharing one server (a developer's parallel runs,
+ * two packages, a retried job on a shared runner) never drop each other's tables mid-test.
+ */
+export function postgresTestSchemaPrefix() {
+    const run = process.env.DURABLE_PG_TEST_RUN;
+    return run ? `${POSTGRES_TEST_SCHEMA_PREFIX}${run}_` : POSTGRES_TEST_SCHEMA_PREFIX;
+}
+/**
+ * Connections per Postgres test pool. Small on purpose: test files run in parallel (and the
+ * multi-process scenarios fork workers, each with its own pool), and a slow machine makes every pool
+ * grow to its max, so a pool of 10 per database exhausted the server's `max_connections` in CI.
+ */
+export const POSTGRES_TEST_POOL_MAX = 3;
+/**
+ * A standalone Lucid `Database` over Postgres (`pg`), every query scoped to `schema` through the
+ * connection's `search_path` — the Postgres twin of {@link makeMemoryDb}. The schema must exist (see
+ * {@link makeIsolatedPostgresDb}); this only connects. Used by tests and by the child processes the
+ * multi-process transport tests spawn against a schema their parent created.
+ */
+export function makePostgresDb(url, schema, poolMax = POSTGRES_TEST_POOL_MAX) {
+    const logger = new Logger({ enabled: false });
+    const emitter = new Emitter(undefined);
+    return new Database({
+        connection: 'pg',
+        connections: {
+            pg: {
+                client: 'pg',
+                connection: { connectionString: url },
+                searchPath: [schema],
+                pool: { min: 0, max: poolMax },
+            },
+        },
+    }, logger, emitter);
+}
+/**
+ * A fresh, EMPTY Postgres database for one test: a new schema (unique per call, so test files running
+ * in parallel never see each other's tables) and a `Database` scoped to it. `db.manager.closeAll()`
+ * drops the schema before closing — the same "gone when closed" lifetime a `:memory:` SQLite db has.
+ * `keepSchema` leaves it (the caller drops it), and `schema` reports its name, for tests that hand it
+ * to child processes.
+ */
+export async function makeIsolatedPostgresDb(url, opts = {}) {
+    const schema = `${postgresTestSchemaPrefix()}${process.pid}_${Math.random().toString(36).slice(2, 10)}`;
+    const db = makePostgresDb(url, schema);
+    db.schemaName = schema;
+    await db.rawQuery(`create schema "${schema}"`);
+    if (!opts.keepSchema) {
+        const closeAll = db.manager.closeAll.bind(db.manager);
+        let dropped = false;
+        db.manager.closeAll = async (...args) => {
+            if (!dropped) {
+                dropped = true;
+                await db.rawQuery(`drop schema if exists "${schema}" cascade`).catch(() => { });
+            }
+            return closeAll(...args);
+        };
+    }
+    return db;
+}
+/** A fresh isolated Postgres schema with the transport tables already created. */
+export async function makePostgresTransportDb(url) {
+    const db = await makeIsolatedPostgresDb(url);
+    await createDurableTransportTables(db);
+    return db;
+}
 //# sourceMappingURL=db-helpers.js.map

package/dist/src/transports/db-helpers.js.map

@@ -1 +1 @@
-{"version":3,"file":"db-helpers.js","sourceRoot":"","sources":["../../../src/transports/db-helpers.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAC;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAC;AAC/C,OAAO,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AACpD,OAAO,EAAE,4BAA4B,EAAE,MAAM,gBAAgB,CAAC;AAE9D;;;;GAIG;AACH,MAAM,UAAU,YAAY;IAC1B,MAAM,MAAM,GAAG,IAAI,MAAM,CAAC,EAAE,OAAO,EAAE,KAAK,EAAE,CAAC,CAAC;IAC9C,MAAM,OAAO,GAAG,IAAI,OAAO,CAAC,SAAkB,CAAC,CAAC;IAChD,OAAO,IAAI,QAAQ,CACjB;QACE,UAAU,EAAE,QAAQ;QACpB,WAAW,EAAE;YACX,MAAM,EAAE;gBACN,MAAM,EAAE,gBAAgB;gBACxB,UAAU,EAAE,EAAE,QAAQ,EAAE,UAAU,EAAE;gBACpC,gBAAgB,EAAE,IAAI;gBACtB,0FAA0F;gBAC1F,qDAAqD;gBACrD,IAAI,EAAE,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE;aACzB;SACF;KACF,EACD,MAAM,EACN,OAAO,CACR,CAAC;AACJ,CAAC;AAED,sEAAsE;AACtE,MAAM,CAAC,KAAK,UAAU,eAAe;IACnC,MAAM,EAAE,GAAG,YAAY,EAAE,CAAC;IAC1B,MAAM,4BAA4B,CAAC,EAAE,CAAC,CAAC;IACvC,OAAO,EAAE,CAAC;AACZ,CAAC"}
+{"version":3,"file":"db-helpers.js","sourceRoot":"","sources":["../../../src/transports/db-helpers.ts"],"names":[],"mappings":"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"}

package/dist/src/transports/db-remote.d.ts

@@ -0,0 +1,53 @@
+import { type WorkerKeyStore } from './worker-keys.js';
+/**
+ * The live-subscriber registry of the db transport's store-less protocol. Run replies, tenant events
+ * and remote-workflow decisions are rows of the messages table addressed to ONE instance (its
+ * `recipient`); this tracks who is there to address them to, in the worker-key table every db instance
+ * already reads and writes:
+ *
+ * - `${P}-inbox:<instance>` — "this instance is alive and consuming its addressed rows". Written by
+ *   every instance that consumes an inbox (a requester waiting for replies, a tenant-event subscriber,
+ *   an engine waiting for decisions).
+ * - `${P}-tenant-subscriber:<tenant>:<instance>` — "this instance wants `tenant`'s events". A publisher
+ *   writes one row per live subscriber of the event's tenant.
+ *
+ * Both live for {@link DbInboxRegistryOptions.ttlMs} and are re-written every third of it. Unlike the
+ * queue transport, a subscriber writes its keys itself — a pod on the db transport reaches the same
+ * database as the control plane by definition, so there is no announcement to relay. Key names are the
+ * queue transport's (`queue-remote.ts`): URI-encoded tenant and instance segments, so a tenant name
+ * containing `:` can never match another tenant's keys.
+ */
+/** Default TTL (ms) of the subscriber and inbox keys; re-written every third of it. */
+export declare const DEFAULT_DB_INBOX_TTL_MS = 30000;
+/** Default reuse window (ms) of a publisher's read of the live tenant subscribers. */
+export declare const DEFAULT_DB_TENANT_SUBSCRIBERS_CACHE_MS = 1000;
+/** Default cadence (ms) of the janitor that deletes rows addressed to instances that are gone. */
+export declare const DEFAULT_DB_INBOX_SWEEP_INTERVAL_MS = 30000;
+export interface DbInboxRegistryOptions {
+    store: () => WorkerKeyStore;
+    /** The effective key prefix, read on every use (the namespace can be adopted after construction). */
+    prefix: () => string;
+    instanceId: string;
+    ttlMs: number;
+    subscribersCacheMs: number;
+    onError: (err: unknown) => void;
+    now?: () => number;
+}
+export declare class DbInboxRegistry {
+    #private;
+    constructor(options: DbInboxRegistryOptions);
+    /** Mark this instance as consuming its addressed rows: its inbox key is written now and kept fresh.
+     *  Resolves once the first write landed (or failed). */
+    activateInbox(): Promise<void>;
+    /** Subscribe to `tenant`'s events (idempotent). Resolves once the keys are written. */
+    subscribe(tenant: string): Promise<void>;
+    /** End the subscription to `tenant` (its last handler went away): its key is removed. */
+    unsubscribe(tenant: string): void;
+    /** The instance ids with a live subscription to `tenant` (deduplicated; malformed values skipped). */
+    subscribersOf(tenant: string): Promise<string[]>;
+    /** The instance ids with a live inbox key — read fresh, never cached (the janitor decides on it). */
+    liveInboxOwners(): Promise<Set<string>>;
+    /** Stop refreshing and remove every key this instance wrote (a clean shutdown). */
+    close(): Promise<void>;
+}
+//# sourceMappingURL=db-remote.d.ts.map

package/dist/src/transports/db-remote.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"db-remote.d.ts","sourceRoot":"","sources":["../../../src/transports/db-remote.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,KAAK,cAAc,EAAE,MAAM,kBAAkB,CAAC;AAEvE;;;;;;;;;;;;;;;;;GAiBG;AAEH,uFAAuF;AACvF,eAAO,MAAM,uBAAuB,QAAS,CAAC;AAC9C,sFAAsF;AACtF,eAAO,MAAM,sCAAsC,OAAQ,CAAC;AAC5D,kGAAkG;AAClG,eAAO,MAAM,kCAAkC,QAAS,CAAC;AAEzD,MAAM,WAAW,sBAAsB;IACrC,KAAK,EAAE,MAAM,cAAc,CAAC;IAC5B,qGAAqG;IACrG,MAAM,EAAE,MAAM,MAAM,CAAC;IACrB,UAAU,EAAE,MAAM,CAAC;IACnB,KAAK,EAAE,MAAM,CAAC;IACd,kBAAkB,EAAE,MAAM,CAAC;IAC3B,OAAO,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,IAAI,CAAC;IAChC,GAAG,CAAC,EAAE,MAAM,MAAM,CAAC;CACpB;AAWD,qBAAa,eAAe;;IAU1B,YAAY,OAAO,EAAE,sBAAsB,EAG1C;IAmCD;4DACwD;IACxD,aAAa,IAAI,OAAO,CAAC,IAAI,CAAC,CAK7B;IAED,uFAAuF;IACvF,SAAS,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAMvC;IAED,yFAAyF;IACzF,WAAW,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAMhC;IAED,sGAAsG;IAChG,aAAa,CAAC,MAAM,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC,CAcrD;IAED,qGAAqG;IAC/F,eAAe,IAAI,OAAO,CAAC,GAAG,CAAC,MAAM,CAAC,CAAC,CAS5C;IAED,mFAAmF;IAC7E,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAW3B;CACF"}

package/dist/src/transports/db-remote.js

@@ -0,0 +1,147 @@
+import { inboxKey, tenantSubscriberKey, tenantSubscriberKeyPrefix } from './queue-remote.js';
+import { cachedLiveKeys } from './worker-keys.js';
+/**
+ * The live-subscriber registry of the db transport's store-less protocol. Run replies, tenant events
+ * and remote-workflow decisions are rows of the messages table addressed to ONE instance (its
+ * `recipient`); this tracks who is there to address them to, in the worker-key table every db instance
+ * already reads and writes:
+ *
+ * - `${P}-inbox:<instance>` — "this instance is alive and consuming its addressed rows". Written by
+ *   every instance that consumes an inbox (a requester waiting for replies, a tenant-event subscriber,
+ *   an engine waiting for decisions).
+ * - `${P}-tenant-subscriber:<tenant>:<instance>` — "this instance wants `tenant`'s events". A publisher
+ *   writes one row per live subscriber of the event's tenant.
+ *
+ * Both live for {@link DbInboxRegistryOptions.ttlMs} and are re-written every third of it. Unlike the
+ * queue transport, a subscriber writes its keys itself — a pod on the db transport reaches the same
+ * database as the control plane by definition, so there is no announcement to relay. Key names are the
+ * queue transport's (`queue-remote.ts`): URI-encoded tenant and instance segments, so a tenant name
+ * containing `:` can never match another tenant's keys.
+ */
+/** Default TTL (ms) of the subscriber and inbox keys; re-written every third of it. */
+export const DEFAULT_DB_INBOX_TTL_MS = 30_000;
+/** Default reuse window (ms) of a publisher's read of the live tenant subscribers. */
+export const DEFAULT_DB_TENANT_SUBSCRIBERS_CACHE_MS = 1_000;
+/** Default cadence (ms) of the janitor that deletes rows addressed to instances that are gone. */
+export const DEFAULT_DB_INBOX_SWEEP_INTERVAL_MS = 30_000;
+const ownerOf = (value) => {
+    try {
+        const parsed = JSON.parse(value);
+        return typeof parsed.instanceId === 'string' ? parsed.instanceId : undefined;
+    }
+    catch {
+        return undefined;
+    }
+};
+export class DbInboxRegistry {
+    #options;
+    #now;
+    #tenants = new Set();
+    #inboxActive = false;
+    #refreshTimer;
+    /** Key writes in flight — `close()` lets them land before removing the keys. */
+    #writes = new Set();
+    #subscribers;
+    constructor(options) {
+        this.#options = options;
+        this.#now = options.now ?? Date.now;
+    }
+    get #value() {
+        return JSON.stringify({ instanceId: this.#options.instanceId });
+    }
+    /** Write `keys`, live for a TTL from now. Best-effort: a failure is reported, never thrown. */
+    #put(keys) {
+        const expiresAt = this.#now() + this.#options.ttlMs;
+        const write = (async () => {
+            for (const key of keys)
+                await this.#options.store().put(key, this.#value, expiresAt);
+        })().catch((err) => this.#options.onError(err));
+        this.#writes.add(write);
+        void write.finally(() => this.#writes.delete(write));
+        return write;
+    }
+    #keys() {
+        const prefix = this.#options.prefix();
+        const id = this.#options.instanceId;
+        return [
+            ...(this.#inboxActive ? [inboxKey(prefix, id)] : []),
+            ...[...this.#tenants].map((t) => tenantSubscriberKey(prefix, t, id)),
+        ];
+    }
+    #ensureRefresh() {
+        if (this.#refreshTimer)
+            return;
+        this.#refreshTimer = setInterval(() => void this.#put(this.#keys()), Math.max(Math.floor(this.#options.ttlMs / 3), 1));
+        this.#refreshTimer.unref?.();
+    }
+    /** Mark this instance as consuming its addressed rows: its inbox key is written now and kept fresh.
+     *  Resolves once the first write landed (or failed). */
+    activateInbox() {
+        if (this.#inboxActive)
+            return Promise.resolve();
+        this.#inboxActive = true;
+        this.#ensureRefresh();
+        return this.#put([inboxKey(this.#options.prefix(), this.#options.instanceId)]);
+    }
+    /** Subscribe to `tenant`'s events (idempotent). Resolves once the keys are written. */
+    subscribe(tenant) {
+        if (this.#tenants.has(tenant))
+            return Promise.resolve();
+        this.#tenants.add(tenant);
+        this.#inboxActive = true;
+        this.#ensureRefresh();
+        return this.#put(this.#keys());
+    }
+    /** End the subscription to `tenant` (its last handler went away): its key is removed. */
+    unsubscribe(tenant) {
+        if (!this.#tenants.delete(tenant))
+            return;
+        const key = tenantSubscriberKey(this.#options.prefix(), tenant, this.#options.instanceId);
+        void Promise.allSettled([...this.#writes])
+            .then(() => this.#options.store().remove([key]))
+            .catch((err) => this.#options.onError(err));
+    }
+    /** The instance ids with a live subscription to `tenant` (deduplicated; malformed values skipped). */
+    async subscribersOf(tenant) {
+        this.#subscribers ??= cachedLiveKeys(this.#options.store(), this.#options.subscribersCacheMs, this.#now);
+        const marker = tenantSubscriberKeyPrefix(this.#options.prefix(), tenant);
+        const owners = new Set();
+        for (const { key, value } of await this.#subscribers()) {
+            if (!key.startsWith(marker))
+                continue;
+            const owner = ownerOf(value);
+            if (owner !== undefined)
+                owners.add(owner);
+        }
+        return [...owners];
+    }
+    /** The instance ids with a live inbox key — read fresh, never cached (the janitor decides on it). */
+    async liveInboxOwners() {
+        const marker = inboxKey(this.#options.prefix(), '');
+        const alive = new Set();
+        for (const { key, value } of await this.#options.store().live(this.#now())) {
+            if (!key.startsWith(marker))
+                continue;
+            const owner = ownerOf(value);
+            if (owner !== undefined)
+                alive.add(owner);
+        }
+        return alive;
+    }
+    /** Stop refreshing and remove every key this instance wrote (a clean shutdown). */
+    async close() {
+        if (this.#refreshTimer)
+            clearInterval(this.#refreshTimer);
+        this.#refreshTimer = undefined;
+        const keys = this.#keys();
+        this.#tenants.clear();
+        this.#inboxActive = false;
+        if (keys.length === 0)
+            return;
+        await Promise.allSettled([...this.#writes]);
+        await Promise.resolve()
+            .then(() => this.#options.store().remove(keys))
+            .catch((err) => this.#options.onError(err));
+    }
+}
+//# sourceMappingURL=db-remote.js.map

package/dist/src/transports/db-remote.js.map

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

package/dist/src/transports/db-schema.d.ts

@@ -1,4 +1,5 @@
 import type { Database } from '@adonisjs/lucid/database';
+type CreateTableBuilder = Parameters<Parameters<ReturnType<Database['connection']>['schema']['createTable']>[1]>[0];
 /**
  * The DB transport's table names. Distinct from the durable *store* tables (`durable_workflow_runs`
  * etc.) — these carry the point-to-point work channels (tasks / results / heartbeats / control), so
@@ -9,7 +10,23 @@ export declare const TRANSPORT_TABLES: {
     readonly results: 'durable_transport_results';
     readonly heartbeats: 'durable_transport_heartbeats';
     readonly control: 'durable_transport_control';
+    /** Remote-workflow decisions and step events, and the store-less (tenant pod) protocol's start-run,
+     *  run-request, run-reply and tenant-event rows — one table told apart by `kind`. */
+    readonly messages: 'durable_transport_messages';
 };
+/**
+ * The `kind`s of a {@link TRANSPORT_TABLES.messages} row. `recipient` is `''` for a row any consumer
+ * of the kind may claim, or the instance id of the one consumer it is addressed to.
+ */
+export declare const MESSAGE_KINDS: {
+    readonly decision: 'decision';
+    readonly stepEvent: 'stepEvent';
+    readonly startRun: 'startRun';
+    readonly runRequest: 'runRequest';
+    readonly runReply: 'runReply';
+    readonly tenantEvent: 'tenantEvent';
+};
+export type MessageKind = (typeof MESSAGE_KINDS)[keyof typeof MESSAGE_KINDS];
 /**
  * The worker advertisement keys (design §7.2) — the descriptor and heartbeat keys a worker runtime
  * writes, each with an expiry. Kept out of {@link TRANSPORT_TABLES}: it is a key/value board, not a
@@ -23,7 +40,18 @@ export declare const WORKER_KEYS_TABLE = "durable_transport_worker_keys";
  */
 export declare function createWorkerKeysTable(db: Database): Promise<void>;
 /**
- * Idempotent DDL for the four transport tables, via Lucid's schema builder (Knex). Portable across
+ * The columns that hold free-form JSON payloads (a step's input/output/error/events, the control and
+ * message payloads, a worker key's value). They are `longtext` on MySQL, where `text` stops at 64KB
+ * and a bigger step input or output fails to write (strict mode) or is cut off; an existing `text`
+ * one is widened in place on boot. Postgres and SQLite `text` has no limit and is unchanged.
+ * `notNull` lists the `NOT NULL` ones, which a MySQL `MODIFY` must restate.
+ */
+export declare const TRANSPORT_JSON_COLUMNS: Record<string, {
+    columns: string[];
+    notNull?: string[];
+}>;
+/**
+ * Idempotent DDL for the transport tables, via Lucid's schema builder (Knex). Portable across
  * SQLite / Postgres / MySQL: JSON payloads (`input`/`output`/`error`/`payload`) are stored as TEXT
  * and (de)serialized by the transport, and every timestamp is an epoch-ms `bigInteger`, so there's
  * no dependency on a dialect's native JSON/date type.
@@ -35,6 +63,21 @@ export declare function createWorkerKeysTable(db: Database): Promise<void>;
  * (`node ace configure @adonis-agora/durable`); this helper is for standalone use and tests.
  */
 export declare function createDurableTransportTables(db: Database): Promise<void>;
+/**
+ * Idempotent DDL for the messages table: one-shot rows like the other channels (claimed by one
+ * consumer, deleted once handled), told apart by `kind` and addressed by `recipient` — `''` for any
+ * consumer of the kind, else the instance id of the one it is for (a run reply, a tenant event, a
+ * decision for the engine that dispatched the turn). `reply_to` carries a request's requester.
+ */
+export declare function createMessagesTable(db: Database): Promise<void>;
+type TableBuild = (table: CreateTableBuilder) => void;
+/**
+ * The CREATE TABLE body of every transport table (Knex schema builder), shared by
+ * {@link createDurableTransportTables} and the dialect tests. Payload columns are `longtext`, which
+ * Knex emits on MySQL only (Postgres and SQLite get `text`). See {@link TRANSPORT_JSON_COLUMNS}.
+ */
+export declare const TRANSPORT_TABLE_DEFS: Record<string, TableBuild>;
 /** Drop every transport table. Used by tests and the migration `down`. */
 export declare function dropDurableTransportTables(db: Database): Promise<void>;
+export {};
 //# sourceMappingURL=db-schema.d.ts.map

package/dist/src/transports/db-schema.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"db-schema.d.ts","sourceRoot":"","sources":["../../../src/transports/db-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAEzD;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;aAC3B,KAAK,EAAE,yBAAyB;aAChC,OAAO,EAAE,2BAA2B;aACpC,UAAU,EAAE,8BAA8B;aAC1C,OAAO,EAAE,2BAA2B;CAC5B,CAAC;AAEX;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kCAAkC,CAAC;AAEjE;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CASvE;AAED;;;;;;;;;;;GAWG;AACH,wBAAsB,4BAA4B,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAoF9E;AAcD,0EAA0E;AAC1E,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAO5E"}
+{"version":3,"file":"db-schema.d.ts","sourceRoot":"","sources":["../../../src/transports/db-schema.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,0BAA0B,CAAC;AAMzD,KAAK,kBAAkB,GAAG,UAAU,CAClC,UAAU,CAAC,UAAU,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC,CAC3E,CAAC,CAAC,CAAC,CAAC;AAqBL;;;;GAIG;AACH,eAAO,MAAM,gBAAgB;aAC3B,KAAK,EAAE,yBAAyB;aAChC,OAAO,EAAE,2BAA2B;aACpC,UAAU,EAAE,8BAA8B;aAC1C,OAAO,EAAE,2BAA2B;IACpC;yFACqF;aACrF,QAAQ,EAAE,4BAA4B;CAC9B,CAAC;AAEX;;;GAGG;AACH,eAAO,MAAM,aAAa;aACxB,QAAQ,EAAE,UAAU;aACpB,SAAS,EAAE,WAAW;aACtB,QAAQ,EAAE,UAAU;aACpB,UAAU,EAAE,YAAY;aACxB,QAAQ,EAAE,UAAU;aACpB,WAAW,EAAE,aAAa;CAClB,CAAC;AACX,MAAM,MAAM,WAAW,GAAG,CAAC,OAAO,aAAa,CAAC,CAAC,MAAM,OAAO,aAAa,CAAC,CAAC;AAE7E;;;;GAIG;AACH,eAAO,MAAM,iBAAiB,kCAAkC,CAAC;AAEjE;;;;GAIG;AACH,wBAAsB,qBAAqB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAGvE;AAED;;;;;;GAMG;AACH,eAAO,MAAM,sBAAsB,EAAE,MAAM,CAAC,MAAM,EAAE;IAAE,OAAO,EAAE,MAAM,EAAE,CAAC;IAAC,OAAO,CAAC,EAAE,MAAM,EAAE,CAAA;CAAE,CAM5F,CAAC;AAmBF;;;;;;;;;;;GAWG;AACH,wBAAsB,4BAA4B,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAuB9E;AAED;;;;;GAKG;AACH,wBAAsB,mBAAmB,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAErE;AAyED,KAAK,UAAU,GAAG,CAAC,KAAK,EAAE,kBAAkB,KAAK,IAAI,CAAC;AAEtD;;;;GAIG;AACH,eAAO,MAAM,oBAAoB,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAwE3D,CAAC;AAEF,0EAA0E;AAC1E,wBAAsB,0BAA0B,CAAC,EAAE,EAAE,QAAQ,GAAG,OAAO,CAAC,IAAI,CAAC,CAQ5E"}