@adonis-agora/durable 1.0.0-rc.2 → 1.0.0-rc.21

package/dist/src/dashboard/spa.js.map

@@ -1 +1 @@
-{"version":3,"file":"spa.js","sourceRoot":"","sources":["../../../src/dashboard/spa.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH;4GAC4G;AAC5G,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,gCAAgC;IACxC,MAAM,EAAE,yBAAyB;IACjC,MAAM,EAAE,iCAAiC;IACzC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,YAAY;IACtB,OAAO,EAAE,WAAW;CACrB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AAC1D,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AAU5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAAC,IAAY,EAAE,QAAgB,EAAE,WAAmB;IACjF,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;IAChE,MAAM,MAAM,GAAmB,EAAE,IAAI,EAAE,QAAQ,EAAE,GAAG,EAAE,WAAW,EAAE,CAAC;IACpE,4FAA4F;IAC5F,0EAA0E;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,uCAAuC,iBAAiB,KAAK,IAAI,WAAW,CAAC;IAC5F,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;AACnG,CAAC"}
+{"version":3,"file":"spa.js","sourceRoot":"","sources":["../../../src/dashboard/spa.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAIH;4GAC4G;AAC5G,MAAM,CAAC,MAAM,gBAAgB,GAAG,yBAAyB,CAAC;AAE1D,MAAM,CAAC,MAAM,aAAa,GAA2B;IACnD,KAAK,EAAE,gCAAgC;IACvC,MAAM,EAAE,gCAAgC;IACxC,MAAM,EAAE,yBAAyB;IACjC,MAAM,EAAE,iCAAiC;IACzC,OAAO,EAAE,iCAAiC;IAC1C,MAAM,EAAE,eAAe;IACvB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,YAAY;IACpB,OAAO,EAAE,YAAY;IACrB,MAAM,EAAE,WAAW;IACnB,MAAM,EAAE,cAAc;IACtB,QAAQ,EAAE,YAAY;IACtB,OAAO,EAAE,WAAW;CACrB,CAAC;AAEF,4EAA4E;AAC5E,MAAM,UAAU,cAAc,CAAC,IAAY;IACzC,MAAM,GAAG,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9C,OAAO,aAAa,CAAC,GAAG,CAAC,IAAI,0BAA0B,CAAC;AAC1D,CAAC;AAED,sGAAsG;AACtG,MAAM,CAAC,MAAM,iBAAiB,GAAG,0BAA0B,CAAC;AA0B5D;;;;;;;;;;;;;;GAcG;AACH,MAAM,UAAU,eAAe,CAC7B,IAAY,EACZ,QAAgB,EAChB,WAAmB,EACnB,KAAK,GAKD,EAAE;IAEN,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,QAAQ,GAAG,CAAC,CAAC;IAChE,MAAM,MAAM,GAAmB;QAC7B,IAAI,EAAE,QAAQ;QACd,GAAG,EAAE,WAAW;QAChB,GAAG,CAAC,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,KAAK,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACpF,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACjD,GAAG,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,OAAO,EAAE,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACrD,CAAC;IACF,4FAA4F;IAC5F,0EAA0E;IAC1E,MAAM,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,SAAS,CAAC,CAAC;IAC7D,MAAM,MAAM,GAAG,uCAAuC,iBAAiB,KAAK,IAAI,WAAW,CAAC;IAC5F,OAAO,KAAK,CAAC,QAAQ,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,GAAG,MAAM,SAAS,CAAC,CAAC,CAAC,CAAC,MAAM,GAAG,KAAK,CAAC;AACnG,CAAC"}

package/dist/src/dashboard/tenant_scope.d.ts

@@ -0,0 +1,38 @@
+import type { DashboardEngine } from './handlers.js';
+/**
+ * Which tenants (organizations) the console shows a viewer, once tenancy is on:
+ *
+ * - `authorized`: what `authorize` granted — `'*'` (every tenant, and runs with no tenant), a list,
+ *   or the viewer's own active tenant (`{ own }`), or nothing (`'none'`: a viewer with no tenant).
+ * - `selected`: the tenant the viewer picked (`?tenant=`), already intersected with `authorized`.
+ * - `ids`: what the API reads are confined to (`undefined` = no confinement).
+ */
+export interface ConsoleTenantScope {
+    authorized: '*' | string[] | 'none';
+    /** The viewer's own active tenant, when the scope came from it. */
+    own?: {
+        id: string;
+        kind?: string | undefined;
+        slug?: string | undefined;
+    } | undefined;
+    selected: string | undefined;
+    ids: Array<string | null> | undefined;
+    /** The viewer asked for a tenant outside `authorized` (answered with nothing, and audited). */
+    forged: boolean;
+}
+/** Resolve the console scope from the `authorize` grant, the viewer's tenant and their pick. */
+export declare function resolveConsoleTenantScope(input: {
+    granted: '*' | string[] | undefined;
+    own: {
+        id: string;
+        kind?: string | undefined;
+        slug?: string | undefined;
+    } | undefined;
+    selected: string | undefined;
+}): ConsoleTenantScope;
+/**
+ * The console's read/control port confined to `ids`: listings carry `tenantIds`, a run outside the
+ * scope reads as missing, and actions on it answer not-found. Every handler stays unchanged.
+ */
+export declare function scopedDashboardEngine(engine: DashboardEngine, ids: Array<string | null> | undefined, around?: <T>(fn: () => T) => T): DashboardEngine;
+//# sourceMappingURL=tenant_scope.d.ts.map

package/dist/src/dashboard/tenant_scope.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"tenant_scope.d.ts","sourceRoot":"","sources":["../../../src/dashboard/tenant_scope.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,eAAe,CAAC;AAErD;;;;;;;GAOG;AACH,MAAM,WAAW,kBAAkB;IACjC,UAAU,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,MAAM,CAAC;IACpC,mEAAmE;IACnE,GAAG,CAAC,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACvF,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;IAC7B,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,CAAC;IACtC,+FAA+F;IAC/F,MAAM,EAAE,OAAO,CAAC;CACjB;AAED,gGAAgG;AAChG,wBAAgB,yBAAyB,CAAC,KAAK,EAAE;IAC/C,OAAO,EAAE,GAAG,GAAG,MAAM,EAAE,GAAG,SAAS,CAAC;IACpC,GAAG,EAAE;QAAE,EAAE,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,GAAG,SAAS,CAAA;KAAE,GAAG,SAAS,CAAC;IACtF,QAAQ,EAAE,MAAM,GAAG,SAAS,CAAC;CAC9B,GAAG,kBAAkB,CAuBrB;AAMD;;;GAGG;AACH,wBAAgB,qBAAqB,CACnC,MAAM,EAAE,eAAe,EACvB,GAAG,EAAE,KAAK,CAAC,MAAM,GAAG,IAAI,CAAC,GAAG,SAAS,EACrC,MAAM,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,CAAC,KAAK,CAAC,GAC7B,eAAe,CAYjB"}

package/dist/src/dashboard/tenant_scope.js

@@ -0,0 +1,166 @@
+import { intersectTenantIds } from '../tenancy.js';
+/** Resolve the console scope from the `authorize` grant, the viewer's tenant and their pick. */
+export function resolveConsoleTenantScope(input) {
+    const authorized = input.granted !== undefined ? input.granted : input.own ? [input.own.id] : 'none';
+    const selected = input.selected?.trim() || undefined;
+    const pick = selected === '*' ? undefined : selected;
+    const base = {
+        authorized,
+        ...(input.granted === undefined && input.own ? { own: input.own } : {}),
+    };
+    if (authorized === 'none')
+        return { ...base, selected: undefined, ids: [], forged: pick !== undefined };
+    if (pick === undefined) {
+        return {
+            ...base,
+            selected: undefined,
+            ids: authorized === '*' ? undefined : [...authorized],
+            forged: false,
+        };
+    }
+    if (authorized === '*' || authorized.includes(pick)) {
+        return { ...base, selected: pick, ids: [pick], forged: false };
+    }
+    return { ...base, selected: pick, ids: [], forged: true };
+}
+function visible(ids, run) {
+    return run !== null && ids.includes(run.tenantId ?? null);
+}
+/**
+ * The console's read/control port confined to `ids`: listings carry `tenantIds`, a run outside the
+ * scope reads as missing, and actions on it answer not-found. Every handler stays unchanged.
+ */
+export function scopedDashboardEngine(engine, ids, around) {
+    const confined = ids === undefined ? engine : confine(engine, ids);
+    if (around === undefined)
+        return confined;
+    // Every call runs as the console's own read (no app tenant applied on top of the console scope).
+    const wrapped = { ...confined };
+    for (const [key, value] of Object.entries(confined)) {
+        if (typeof value === 'function' && key !== 'subscribe') {
+            wrapped[key] = (...args) => around(() => value.apply(confined, args));
+        }
+    }
+    return wrapped;
+}
+function confine(engine, ids) {
+    const narrow = (query) => ({
+        ...query,
+        tenantIds: intersectTenantIds(query.tenantIds, ids),
+    });
+    const sees = async (runId) => visible(ids, await engine.getRun(runId));
+    const guard = (fn, hidden) => async (runId, ...rest) => (await sees(runId)) ? fn(runId, ...rest) : hidden;
+    const scoped = {
+        ...engine,
+        getRun: async (runId) => {
+            const run = await engine.getRun(runId);
+            return visible(ids, run) ? run : null;
+        },
+        listRuns: (query) => engine.listRuns(narrow(query)),
+        listCheckpoints: guard((id) => engine.listCheckpoints(id), []),
+        getRunChildren: guard((id) => engine.getRunChildren(id), []),
+        requeue: guard((id) => engine.requeue(id), null),
+        redispatchPending: guard((id) => engine.redispatchPending(id), null),
+        cancel: guard((id, opts) => engine.cancel(id, opts), null),
+        retryWithInput: guard((id, input) => engine.retryWithInput(id, input), null),
+        continue: guard((id) => engine.continue(id), null),
+        subscribe: (runId, onEvent) => engine.subscribe(runId, onEvent),
+        workerHealth: (extra) => engine.workerHealth(extra),
+    };
+    if (engine.getRunDetail) {
+        const fn = engine.getRunDetail.bind(engine);
+        scoped.getRunDetail = guard((id, options) => fn(id, options), null);
+    }
+    if (engine.getFanMembers) {
+        const fn = engine.getFanMembers.bind(engine);
+        scoped.getFanMembers = guard((id, group, query) => fn(id, group, query), null);
+    }
+    if (engine.update) {
+        const fn = engine.update.bind(engine);
+        scoped.update = guard((id, name, arg) => fn(id, name, arg), {
+            accepted: false,
+            reason: 'run not found',
+        });
+    }
+    if (engine.completeTask) {
+        const fn = engine.completeTask.bind(engine);
+        scoped.completeTask = guard((id, name, result) => fn(id, name, result), null);
+    }
+    if (engine.failTask) {
+        const fn = engine.failTask.bind(engine);
+        scoped.failTask = guard((id, name, error) => fn(id, name, error), null);
+    }
+    if (engine.getEvent) {
+        const fn = engine.getEvent.bind(engine);
+        scoped.getEvent = guard((id, key) => fn(id, key), undefined);
+    }
+    if (engine.republishLifecycle) {
+        const fn = engine.republishLifecycle.bind(engine);
+        scoped.republishLifecycle = async (target) => {
+            if ('runId' in target && !(await sees(target.runId))) {
+                return { runs: 0, started: 0, failed: [] };
+            }
+            return fn(target);
+        };
+    }
+    if (engine.countRuns) {
+        const fn = engine.countRuns.bind(engine);
+        scoped.countRuns = (query) => fn(narrow(query));
+    }
+    if (engine.runValueFacets) {
+        const fn = engine.runValueFacets.bind(engine);
+        scoped.runValueFacets = (axis, query, opts) => fn(axis, narrow(query), opts);
+    }
+    // Waiters name runs: only the scoped ones are listed, and a signal whose live waiter belongs to a
+    // run outside the scope is not delivered (the console's routes check the run itself first).
+    const waiterVisible = async (waiter) => sees(waiter.runId);
+    if (engine.listSignalWaiters) {
+        const fn = engine.listSignalWaiters.bind(engine);
+        scoped.listSignalWaiters = async (prefix) => {
+            const out = [];
+            for (const w of await fn(prefix))
+                if (await waiterVisible(w))
+                    out.push(w);
+            return out;
+        };
+    }
+    if (engine.listSignalWaitersByRunIds) {
+        const fn = engine.listSignalWaitersByRunIds.bind(engine);
+        scoped.listSignalWaitersByRunIds = async (runIds) => {
+            const mine = [];
+            for (const id of runIds)
+                if (await sees(id))
+                    mine.push(id);
+            return mine.length > 0 ? fn(mine) : [];
+        };
+    }
+    if (engine.waitingFor) {
+        const fn = engine.waitingFor.bind(engine);
+        scoped.waitingFor = async (runIds) => {
+            const mine = [];
+            for (const id of runIds)
+                if (await sees(id))
+                    mine.push(id);
+            return mine.length > 0 ? fn(mine) : {};
+        };
+    }
+    if (engine.signal) {
+        const fn = engine.signal.bind(engine);
+        const listWaiters = engine.listSignalWaiters?.bind(engine);
+        scoped.signal = async (token, payload) => {
+            if (listWaiters) {
+                for (const w of await listWaiters(token)) {
+                    if (w.token === token && !(await waiterVisible(w)))
+                        return null;
+                }
+            }
+            // A webhook token names its run: `wh:<runId>:<seq>`.
+            const webhook = /^wh:(.+):\d+$/.exec(token);
+            if (webhook?.[1] !== undefined && !(await sees(webhook[1])))
+                return null;
+            return fn(token, payload);
+        };
+    }
+    return scoped;
+}
+//# sourceMappingURL=tenant_scope.js.map

package/dist/src/dashboard/tenant_scope.js.map

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

package/dist/src/define_config.d.ts

@@ -9,11 +9,12 @@ import type { QueueConfig } from './queue.js';
 import type { ScheduledWorkflow } from './scheduler.js';
 import type { LucidStoreConfig, StoreContext, StoreFactory } from './stores/factory.js';
 import { stores } from './stores/factory.js';
+import type { DurableTenancyOption } from './tenancy.js';
 import type { DbTransportConfig, EventEmitterTransportConfig, MemoryTransportConfig, QueueTransportConfig, TransportContext, TransportFactory } from './transports/factory.js';
 import { transports } from './transports/factory.js';
 import type { WorkflowRef } from './workflow-ref.js';
 /**
- * The **shared** fields of `config/durable.ts`, common to every {@link DurableConfig} role. Everything
+ * The **shared** fields of `config/durable.ts`, common to every {@link DurableConfig} topology. Everything
  * here is optional — by default the engine uses an in-process
  * state store + transport (single-process, no extra infra). Pick a `transport`/`store` by name from
  * the `transports`/`stores` maps to run cross-process or persist durably; build the entries with the
@@ -57,10 +58,10 @@ export interface BaseDurableConfig {
      * Which topology this engine runs as (spec §3): `'standalone'` (default — control-plane + embedded
      * worker), `'control-plane'` (pure coordinator), or `'tenant'` (store-less thin pod). Selected
      * explicitly, never inferred. Omit it and {@link defineConfig} defaults to `'standalone'`, so a
-     * config written before roles existed behaves identically. The concrete per-role shape is a member
+     * config that omits it behaves identically. The concrete per-topology shape is a member
      * of the {@link DurableConfig} union; this base only declares the discriminant for shared reads.
      */
-    role?: 'standalone' | 'control-plane' | 'tenant';
+    topology?: 'standalone' | 'control-plane' | 'tenant';
     /**
      * Name of the transport (a key of {@link transports}) the engine dispatches over. Omit for the
      * in-process transport (single-process, no extra infra).
@@ -74,7 +75,7 @@ export interface BaseDurableConfig {
      * and a step can pin any of them by name with `ctx.step(step, input, { transport: 'db' })`. Each
      * one gets the same consumer deferral, namespace and shutdown as `transport`. Only the transports
      * named here (and `transport`) are built: the rest of `transports` stays a menu. Store-backed
-     * roles only; a `tenant` pod uses its one `transport`.
+     * topologies only; a `tenant` pod uses its one `transport`.
      */
     transportPool?: string[];
     /**
@@ -93,6 +94,14 @@ export interface BaseDurableConfig {
      * has no schema, so this is a no-op for it.
      */
     autoSchema?: boolean;
+    /**
+     * The database schema every durable table lives in (a database on MySQL): the Lucid store's, the
+     * db transport's and the worker-key table's, each of which can override it with its own `schema`.
+     * Every statement names it, so the app's connection keeps its own default schema; boot creates it
+     * when it creates the tables. Do NOT get the same effect with a connection `searchPath`: behind
+     * PgBouncer in transaction mode a `SET search_path` leaks to other clients. Not supported on SQLite.
+     */
+    schema?: string;
     /**
      * Cross-instance broadcast for lifecycle events + cancellation. Omit for single-instance. Either a
      * ready {@link ControlPlane} instance, or a {@link ControlPlaneFactory} built with the
@@ -158,7 +167,7 @@ export interface BaseDurableConfig {
      * queue names. Set distinct values to safely share ONE state store + broker across
      * non-interchangeable pools (e.g. local dev vs a cluster).
      *
-     * Absent, it depends on the role. A `standalone` engine (the default role) is in `'default'`: it
+     * Absent, it depends on the topology. A `standalone` engine (the default topology) is in `'default'`: it
      * drives only the default pool (runs stamped `'default'`, and legacy rows stored without a
      * namespace, which every shipped store reads back as `'default'`) — byte-identical to a
      * single-pool deployment. A `control-plane` engine with no namespace is the OPERATOR: it drives,
@@ -364,6 +373,14 @@ export interface BaseDurableConfig {
      * workers: each window's run id is deterministic and advancing a schedule is a compare-and-set.
      */
     persistedSchedules?: boolean;
+    /**
+     * Tenancy: scope runs by the customer (organization, clinic, …) they belong to. `'inherit'`
+     * (default) follows `tenancy.enabled` in `config/context.ts`; `false` turns it off here; an object
+     * sets `enabled`, the `kinds` durable honours, `nullRows` (what a tenant sees of runs with no
+     * tenant: `'tenantless'`, default, or `'shared'`) and `namespace` (route a tenant to its own pool).
+     * Not the worker pool: that is `namespace`.
+     */
+    tenancy?: DurableTenancyOption;
     /**
      * Run the worker loop **inside this process** instead of a separate `node ace durable:work` pod.
      * The loop is the same one the command drives (pending, recovery, timers, timeouts, schedules), so
@@ -409,19 +426,17 @@ export interface BaseDurableConfig {
     stepsPath?: string | readonly string[] | false;
 }
 /**
- * Shape of `config/durable.ts` — a **role-discriminated union** (spec §5). TypeScript narrows the
- * accepted config on the `role` literal, so each topology gets exactly the right fields and an
+ * Shape of `config/durable.ts` — a **topology-discriminated union** (spec §5). TypeScript narrows the
+ * accepted config on the `topology` literal, so each topology gets exactly the right fields and an
  * invalid combination is a compile error. The headline invariant: a `tenant` config may not name a
  * store (`store?: never` on {@link TenantConfig}), making store-less isolation a compile-time fact.
- * A config with no `role` lands on {@link StandaloneConfig} — the default — preserving the
- * pre-roles config byte-for-byte.
+ * A config with no `topology` lands on {@link StandaloneConfig} — the default.
  */
 export type DurableConfig = StandaloneConfig | ControlPlaneConfig | TenantConfig;
 /**
  * Identity helper giving `config/durable.ts` full type-checking. Overloaded so the return type
- * **narrows on `role`**: pass a `tenant` config and you get a {@link TenantConfig} back, etc. The
- * `role` is defaulted to `'standalone'` at runtime, so a config that omits it (every config written
- * before roles existed) still boots as the single-process standalone engine.
+ * **narrows on `topology`**: pass a `tenant` config and you get a {@link TenantConfig} back, etc. The
+ * `topology` is defaulted to `'standalone'` at runtime, so a config that omits it still boots as the single-process standalone engine.
  */
 export declare function defineConfig(config: TenantConfig): TenantConfig;
 export declare function defineConfig(config: ControlPlaneConfig): ControlPlaneConfig;

package/dist/src/define_config.d.ts.map

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

package/dist/src/define_config.js

@@ -2,10 +2,15 @@ import { admissions } from './admissions/factory.js';
 import { controlPlanes } from './control-planes/factory.js';
 import { stores } from './stores/factory.js';
 import { transports } from './transports/factory.js';
-export function defineConfig(config = { role: 'standalone' }) {
-    // Default the discriminant so downstream (provider, gateway) can branch on a always-present `role`
-    // without re-deriving it. `...config` wins, so an explicit role is preserved.
-    return { role: 'standalone', ...config };
+export function defineConfig(config = { topology: 'standalone' }) {
+    // `role` was renamed to `topology` in 1.0. Refuse the old key: ignoring it would boot a
+    // control-plane or tenant config as `standalone`, silently.
+    if ('role' in config) {
+        throw new Error("@adonis-agora/durable: `role` was renamed to `topology` in config/durable.ts (same values: 'standalone' | 'control-plane' | 'tenant'). Rename the key.");
+    }
+    // Default the discriminant so downstream (provider, gateway) can branch on a always-present `topology`
+    // without re-deriving it. `...config` wins, so an explicit topology is preserved.
+    return { topology: 'standalone', ...config };
 }
 export { admissions, controlPlanes, stores, transports };
 //# sourceMappingURL=define_config.js.map

package/dist/src/define_config.js.map

@@ -1 +1 @@
-{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAarD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAK5D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAS7C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAoarD,MAAM,UAAU,YAAY,CAAC,MAAM,GAAkB,EAAE,IAAI,EAAE,YAAY,EAAE;IACzE,mGAAmG;IACnG,8EAA8E;IAC9E,OAAO,EAAE,IAAI,EAAE,YAAY,EAAE,GAAG,MAAM,EAAmB,CAAC;AAC5D,CAAC;AAwBD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC"}
+{"version":3,"file":"define_config.js","sourceRoot":"","sources":["../../src/define_config.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAarD,OAAO,EAAE,aAAa,EAAE,MAAM,6BAA6B,CAAC;AAK5D,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAU7C,OAAO,EAAE,UAAU,EAAE,MAAM,yBAAyB,CAAC;AAkbrD,MAAM,UAAU,YAAY,CAAC,MAAM,GAAkB,EAAE,QAAQ,EAAE,YAAY,EAAE;IAC7E,wFAAwF;IACxF,4DAA4D;IAC5D,IAAI,MAAM,IAAK,MAAiB,EAAE,CAAC;QACjC,MAAM,IAAI,KAAK,CACb,wJAAwJ,CACzJ,CAAC;IACJ,CAAC;IACD,uGAAuG;IACvG,kFAAkF;IAClF,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,GAAG,MAAM,EAAmB,CAAC;AAChE,CAAC;AAwBD,OAAO,EAAE,UAAU,EAAE,aAAa,EAAE,MAAM,EAAE,UAAU,EAAE,CAAC"}

package/dist/src/diagnostics/index.d.ts

@@ -0,0 +1,11 @@
+/**
+ * `@adonis-agora/durable/diagnostics`: the module `transports.durable()` of
+ * `@adonis-agora/diagnostics` loads at boot. It runs every diagnostics listener call as a durable
+ * run. Durable only imports types from diagnostics, so this module never loads it.
+ */
+import type { DurableDiagnosticsModule } from '@adonis-agora/diagnostics/delivery';
+export { createDeliveryTransport, DIAGNOSTICS_DEFAULT_RETRY, DIAGNOSTICS_LISTENER_ORIGIN, DIAGNOSTICS_LISTENER_WORKFLOW, DIAGNOSTICS_RUN_PREFIX, type DiagnosticsListenerInput, DurableDeliveryTransport, diagnosticsRunId, diagnosticsRunTags, isConfigured, } from './transport.js';
+/** The module as one object. Typing it checks this module is what `transports.durable()` expects. */
+declare const durableDiagnostics: DurableDiagnosticsModule;
+export default durableDiagnostics;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/diagnostics/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,oCAAoC,CAAC;AAGnF,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EACtB,KAAK,wBAAwB,EAC7B,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,qGAAqG;AACrG,QAAA,MAAM,kBAAkB,EAAE,wBAAoE,CAAC;eAChF,kBAAkB"}

package/dist/src/diagnostics/index.js

@@ -0,0 +1,6 @@
+import { createDeliveryTransport, isConfigured } from './transport.js';
+export { createDeliveryTransport, DIAGNOSTICS_DEFAULT_RETRY, DIAGNOSTICS_LISTENER_ORIGIN, DIAGNOSTICS_LISTENER_WORKFLOW, DIAGNOSTICS_RUN_PREFIX, DurableDeliveryTransport, diagnosticsRunId, diagnosticsRunTags, isConfigured, } from './transport.js';
+/** The module as one object. Typing it checks this module is what `transports.durable()` expects. */
+const durableDiagnostics = { isConfigured, createDeliveryTransport };
+export default durableDiagnostics;
+//# sourceMappingURL=index.js.map

package/dist/src/diagnostics/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/diagnostics/index.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,uBAAuB,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AAEvE,OAAO,EACL,uBAAuB,EACvB,yBAAyB,EACzB,2BAA2B,EAC3B,6BAA6B,EAC7B,sBAAsB,EAEtB,wBAAwB,EACxB,gBAAgB,EAChB,kBAAkB,EAClB,YAAY,GACb,MAAM,gBAAgB,CAAC;AAExB,qGAAqG;AACrG,MAAM,kBAAkB,GAA6B,EAAE,YAAY,EAAE,uBAAuB,EAAE,CAAC;AAC/F,eAAe,kBAAkB,CAAC"}

package/dist/src/diagnostics/transport.d.ts

@@ -0,0 +1,71 @@
+import type { DeliveredEvent, DeliveryTransportContext, DurableTransportConfig, ListenerDelivery, ListenerDeliveryTransport } from '@adonis-agora/diagnostics/delivery';
+import type { ApplicationService } from '@adonisjs/core/types';
+import { WorkflowEngine } from '../engine.js';
+import type { StepOptions } from '../interfaces.js';
+/** The internal workflow every diagnostics listener delivery runs as. */
+export declare const DIAGNOSTICS_LISTENER_WORKFLOW = "durable.diagnostics.listener";
+/** The origin stamped on those runs, so the console groups them under diagnostics. */
+export declare const DIAGNOSTICS_LISTENER_ORIGIN = "@adonis-agora/diagnostics";
+/** The prefix of every delivery run id: `diag:<event id>:<listener id>`. */
+export declare const DIAGNOSTICS_RUN_PREFIX = "diag:";
+/**
+ * The retry policy a listener gets when `transports.durable()` sets none: three attempts, one
+ * second apart and doubling, at most 30 seconds.
+ */
+export declare const DIAGNOSTICS_DEFAULT_RETRY: Readonly<StepOptions>;
+/** The input of a delivery run: which listener, and the event it receives. */
+export interface DiagnosticsListenerInput {
+    listenerId: string;
+    envelope: DeliveredEvent;
+}
+/** The run id of one delivery. The same event and listener always give the same id. */
+export declare function diagnosticsRunId(eventId: string, listenerId: string): string;
+/** The tags a delivery run carries, so the console can filter by lib, event or listener. */
+export declare function diagnosticsRunTags(delivery: ListenerDelivery): string[];
+/**
+ * Whether an engine event belongs to a delivery run. Durable does not forward those runs' own
+ * lifecycle events to the diagnostics bus: a listener on `durable` events would otherwise start a
+ * delivery run for every delivery run it caused, without end.
+ */
+export declare function isDiagnosticsDeliveryEvent(event: {
+    runId?: string | undefined;
+    workflow?: string | undefined;
+}): boolean;
+/** Validate `transports.durable(options)` and merge it over {@link DIAGNOSTICS_DEFAULT_RETRY}. */
+export declare function diagnosticsStepOptions(config?: DurableTransportConfig): StepOptions;
+/**
+ * Stop every diagnostics delivery transport created on `engine`: each one stops taking deliveries
+ * and waits for the runs it is creating. The durable provider calls it on shutdown before it drains
+ * the engine, whichever of the two providers shuts down first.
+ */
+export declare function stopDiagnosticsDeliveries(engine: WorkflowEngine): Promise<void>;
+/**
+ * The {@link ListenerDeliveryTransport} behind `transports.durable()`: each `(listener, event)` is a
+ * run of {@link DIAGNOSTICS_LISTENER_WORKFLOW}, which calls the listener inside the `handle` step.
+ */
+export declare class DurableDeliveryTransport implements ListenerDeliveryTransport {
+    #private;
+    constructor(engine: WorkflowEngine);
+    /**
+     * Start one run per delivery and resolve once every run is stored. A delivery whose run already
+     * exists (the same event handed over twice) counts as delivered. When some starts fail, the others
+     * still go through and the returned promise rejects with the failures.
+     */
+    deliver(deliveries: readonly ListenerDelivery[]): Promise<void>;
+    /** Stop taking deliveries and wait for the runs being created. */
+    stop(): Promise<void>;
+}
+/**
+ * Register {@link DIAGNOSTICS_LISTENER_WORKFLOW} on `engine`. Its run calls the listener through
+ * `invoke` in a `handle` step with the given retry policy. A listener this process does not know is
+ * a {@link FatalError}: retrying cannot make it appear.
+ */
+export declare function registerDiagnosticsListenerWorkflow(engine: WorkflowEngine, invoke: DeliveryTransportContext['invoke'], stepOptions: StepOptions): void;
+/** Whether a durable engine is bound in `app`'s container. */
+export declare function isConfigured(app: ApplicationService): boolean;
+/**
+ * Create the delivery transport for this process: register the listener workflow on the app's
+ * engine, so this process can run deliveries, and return the transport that starts them.
+ */
+export declare function createDeliveryTransport(context: DeliveryTransportContext, config?: DurableTransportConfig): Promise<DurableDeliveryTransport>;
+//# sourceMappingURL=transport.d.ts.map

package/dist/src/diagnostics/transport.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"transport.d.ts","sourceRoot":"","sources":["../../../src/diagnostics/transport.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EACV,cAAc,EACd,wBAAwB,EACxB,sBAAsB,EACtB,gBAAgB,EAChB,yBAAyB,EAC1B,MAAM,oCAAoC,CAAC;AAC5C,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAE9C,OAAO,KAAK,EAAE,WAAW,EAAe,MAAM,kBAAkB,CAAC;AAEjE,yEAAyE;AACzE,eAAO,MAAM,6BAA6B,iCAAiC,CAAC;AAE5E,sFAAsF;AACtF,eAAO,MAAM,2BAA2B,8BAA8B,CAAC;AAEvE,4EAA4E;AAC5E,eAAO,MAAM,sBAAsB,UAAU,CAAC;AAK9C;;;GAGG;AACH,eAAO,MAAM,yBAAyB,EAAE,QAAQ,CAAC,WAAW,CAK1D,CAAC;AAEH,8EAA8E;AAC9E,MAAM,WAAW,wBAAwB;IACvC,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,cAAc,CAAC;CAC1B;AAED,uFAAuF;AACvF,wBAAgB,gBAAgB,CAAC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,MAAM,CAE5E;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,EAAE,CAOvE;AAED;;;;GAIG;AACH,wBAAgB,0BAA0B,CAAC,KAAK,EAAE;IAChD,KAAK,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;IAC3B,QAAQ,CAAC,EAAE,MAAM,GAAG,SAAS,CAAC;CAC/B,GAAG,OAAO,CAGV;AAED,kGAAkG;AAClG,wBAAgB,sBAAsB,CAAC,MAAM,GAAE,sBAA2B,GAAG,WAAW,CA8BvF;AAKD;;;;GAIG;AACH,wBAAsB,yBAAyB,CAAC,MAAM,EAAE,cAAc,GAAG,OAAO,CAAC,IAAI,CAAC,CAIrF;AAED;;;GAGG;AACH,qBAAa,wBAAyB,YAAW,yBAAyB;;IAKxE,YAAY,MAAM,EAAE,cAAc,EAQjC;IAED;;;;OAIG;IACH,OAAO,CAAC,UAAU,EAAE,SAAS,gBAAgB,EAAE,GAAG,OAAO,CAAC,IAAI,CAAC,CAW9D;IAkCD,kEAAkE;IAC5D,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC,CAI1B;CACF;AAED;;;;GAIG;AACH,wBAAgB,mCAAmC,CACjD,MAAM,EAAE,cAAc,EACtB,MAAM,EAAE,wBAAwB,CAAC,QAAQ,CAAC,EAC1C,WAAW,EAAE,WAAW,GACvB,IAAI,CA8BN;AAED,8DAA8D;AAC9D,wBAAgB,YAAY,CAAC,GAAG,EAAE,kBAAkB,GAAG,OAAO,CAG7D;AAED;;;GAGG;AACH,wBAAsB,uBAAuB,CAC3C,OAAO,EAAE,wBAAwB,EACjC,MAAM,GAAE,sBAA2B,GAClC,OAAO,CAAC,wBAAwB,CAAC,CAKnC"}