@c9up/ream 0.2.7 → 0.2.9

package/dist/commands/ScheduleList.js

@@ -0,0 +1,55 @@
+/**
+ * `schedule:list` — every registered task, when it next fires, and how its past
+ * runs went.
+ *
+ * The columns are the operator's questions in order: is my task registered at
+ * all, on what schedule, when does it fire next, when did it last fire, and is
+ * it failing. Stats come from the scheduler's own tracker, so a task that has
+ * never run reads as `—` rather than a zero that looks like a result.
+ */
+import { BaseCommand } from '../console/BaseCommand.js';
+import { resolveScheduler } from './scheduler_resolver.js';
+/** Over-long names and cron expressions are truncated so the table stays a table. */
+function truncate(value, width) {
+    return value.length > width ? `${value.slice(0, width - 1)}…` : value;
+}
+function asDate(ms) {
+    return ms === null ? '—' : new Date(ms).toISOString();
+}
+export default class ScheduleList extends BaseCommand {
+    static commandName = 'schedule:list';
+    static description = 'List every registered scheduled task, its next run and its stats';
+    static options = { startApp: true };
+    async run() {
+        const scheduler = await resolveScheduler(this);
+        if (!scheduler)
+            return;
+        const tasks = scheduler.listTasks();
+        if (tasks.length === 0) {
+            this.logger.info('No scheduled tasks registered.');
+            return;
+        }
+        this.logger.log([
+            'NAME'.padEnd(32),
+            'CRON'.padEnd(18),
+            'NEXT RUN'.padEnd(22),
+            'LAST RUN'.padEnd(22),
+            'RUNS'.padStart(6),
+            'ERR'.padStart(5),
+            'AVG(ms)'.padStart(9),
+        ].join(' '));
+        for (const task of tasks) {
+            const stats = scheduler.getStats(task.name);
+            this.logger.log([
+                truncate(task.name, 32).padEnd(32),
+                truncate(task.cronExpr, 18).padEnd(18),
+                asDate(task.nextRun).padEnd(22),
+                asDate(stats.lastRunMs).padEnd(22),
+                String(stats.runCount).padStart(6),
+                String(stats.errorCount).padStart(5),
+                String(Math.round(stats.avgDurationMs)).padStart(9),
+            ].join(' '));
+        }
+    }
+}
+//# sourceMappingURL=ScheduleList.js.map

package/dist/commands/ScheduleList.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleList.js","sourceRoot":"","sources":["../../src/commands/ScheduleList.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,qFAAqF;AACrF,SAAS,QAAQ,CAAC,KAAa,EAAE,KAAa;IAC5C,OAAO,KAAK,CAAC,MAAM,GAAG,KAAK,CAAC,CAAC,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,GAAG,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,KAAK,CAAA;AACvE,CAAC;AAED,SAAS,MAAM,CAAC,EAAiB;IAC/B,OAAO,EAAE,KAAK,IAAI,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,IAAI,IAAI,CAAC,EAAE,CAAC,CAAC,WAAW,EAAE,CAAA;AACvD,CAAC;AAED,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAU,WAAW,GAAG,eAAe,CAAA;IAC7C,MAAM,CAAU,WAAW,GAAG,kEAAkE,CAAA;IAChG,MAAM,CAAU,OAAO,GAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAE5D,KAAK,CAAC,GAAG;QACP,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,MAAM,KAAK,GAAG,SAAS,CAAC,SAAS,EAAE,CAAA;QACnC,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACvB,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,gCAAgC,CAAC,CAAA;YAClD,OAAM;QACR,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,GAAG,CACb;YACE,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACjB,MAAM,CAAC,MAAM,CAAC,EAAE,CAAC;YACjB,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,UAAU,CAAC,MAAM,CAAC,EAAE,CAAC;YACrB,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC;YAClB,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC;YACjB,SAAS,CAAC,QAAQ,CAAC,CAAC,CAAC;SACtB,CAAC,IAAI,CAAC,GAAG,CAAC,CACZ,CAAA;QAED,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;YACzB,MAAM,KAAK,GAAG,SAAS,CAAC,QAAQ,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;YAC3C,IAAI,CAAC,MAAM,CAAC,GAAG,CACb;gBACE,QAAQ,CAAC,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,QAAQ,CAAC,IAAI,CAAC,QAAQ,EAAE,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBACtC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBAC/B,MAAM,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,MAAM,CAAC,EAAE,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;gBAClC,MAAM,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;gBACpC,MAAM,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,QAAQ,CAAC,CAAC,CAAC;aACpD,CAAC,IAAI,CAAC,GAAG,CAAC,CACZ,CAAA;QACH,CAAC;IACH,CAAC"}

package/dist/commands/ScheduleRun.d.ts

@@ -0,0 +1,19 @@
+/**
+ * `schedule:run <name>` — run one registered task immediately.
+ *
+ * An admin override: it calls the task body directly, so it bypasses both the
+ * cron schedule and the distributed lock. That is the point — you reach for it
+ * when a task must run now, or to see it fail with your own eyes — and it is
+ * also why the exit codes are distinct: `1` the task failed, `2` no such task,
+ * `3` an invocation of it is already in flight.
+ */
+import { BaseCommand } from '../console/BaseCommand.js';
+import type { CommandOptions } from '../console/types.js';
+export default class ScheduleRun extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    name: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=ScheduleRun.d.ts.map

package/dist/commands/ScheduleRun.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleRun.d.ts","sourceRoot":"","sources":["../../src/commands/ScheduleRun.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAEvD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAGzD,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,WAAW,SAAiB;IAC5C,OAAgB,WAAW,SAAkE;IAC7F,OAAgB,OAAO,EAAE,cAAc,CAAqB;IAGpD,IAAI,EAAE,MAAM,CAAA;IAEd,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC;CAyC3B"}

package/dist/commands/ScheduleRun.js

@@ -0,0 +1,61 @@
+/**
+ * `schedule:run <name>` — run one registered task immediately.
+ *
+ * An admin override: it calls the task body directly, so it bypasses both the
+ * cron schedule and the distributed lock. That is the point — you reach for it
+ * when a task must run now, or to see it fail with your own eyes — and it is
+ * also why the exit codes are distinct: `1` the task failed, `2` no such task,
+ * `3` an invocation of it is already in flight.
+ */
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+import { BaseCommand } from '../console/BaseCommand.js';
+import { args } from '../console/decorators.js';
+import { resolveScheduler } from './scheduler_resolver.js';
+export default class ScheduleRun extends BaseCommand {
+    static commandName = 'schedule:run';
+    static description = 'Run a registered scheduled task once, now (bypasses the lock)';
+    static options = { startApp: true };
+    async run() {
+        // Rejected here rather than in the scheduler so the message arrives without
+        // the operator first paying for a boot.
+        if (this.name.trim() === '') {
+            this.logger.error('Task name cannot be empty. Usage: schedule:run <name>');
+            this.exitCode = 1;
+            return;
+        }
+        const scheduler = await resolveScheduler(this);
+        if (!scheduler)
+            return;
+        const result = await scheduler.runTaskNow(this.name);
+        const duration = Math.round(result.durationMs);
+        if (result.outcome === 'unknown') {
+            this.logger.error(`Unknown task: ${this.name}. Run "schedule:list" to see the registered tasks.`);
+            this.exitCode = 2;
+            return;
+        }
+        if (result.outcome === 'already-running') {
+            this.logger.error(`Task ${this.name} is already running in this process — skipped. Try again once it completes.`);
+            this.exitCode = 3;
+            return;
+        }
+        if (result.outcome === 'completed') {
+            this.logger.success(`${this.name} completed in ${duration} ms`);
+            return;
+        }
+        this.logger.error(`${this.name} failed after ${duration} ms: ${result.error?.message || 'unknown error'}`);
+        this.exitCode = 1;
+    }
+}
+__decorate([
+    args.string({ description: 'Task name, as `schedule:list` prints it' }),
+    __metadata("design:type", String)
+], ScheduleRun.prototype, "name", void 0);
+//# sourceMappingURL=ScheduleRun.js.map

package/dist/commands/ScheduleRun.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"ScheduleRun.js","sourceRoot":"","sources":["../../src/commands/ScheduleRun.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;;;;;;;;;;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AACvD,OAAO,EAAE,IAAI,EAAE,MAAM,0BAA0B,CAAA;AAE/C,OAAO,EAAE,gBAAgB,EAAE,MAAM,yBAAyB,CAAA;AAE1D,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,MAAM,CAAU,WAAW,GAAG,cAAc,CAAA;IAC5C,MAAM,CAAU,WAAW,GAAG,+DAA+D,CAAA;IAC7F,MAAM,CAAU,OAAO,GAAmB,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAA;IAK5D,KAAK,CAAC,GAAG;QACP,4EAA4E;QAC5E,wCAAwC;QACxC,IAAI,IAAI,CAAC,IAAI,CAAC,IAAI,EAAE,KAAK,EAAE,EAAE,CAAC;YAC5B,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,uDAAuD,CAAC,CAAA;YAC1E,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,MAAM,SAAS,GAAG,MAAM,gBAAgB,CAAC,IAAI,CAAC,CAAA;QAC9C,IAAI,CAAC,SAAS;YAAE,OAAM;QAEtB,MAAM,MAAM,GAAG,MAAM,SAAS,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,CAAA;QACpD,MAAM,QAAQ,GAAG,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,UAAU,CAAC,CAAA;QAE9C,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,EAAE,CAAC;YACjC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,iBAAiB,IAAI,CAAC,IAAI,oDAAoD,CAC/E,CAAA;YACD,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,iBAAiB,EAAE,CAAC;YACzC,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,QAAQ,IAAI,CAAC,IAAI,6EAA6E,CAC/F,CAAA;YACD,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;YACjB,OAAM;QACR,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,KAAK,WAAW,EAAE,CAAC;YACnC,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,IAAI,CAAC,IAAI,iBAAiB,QAAQ,KAAK,CAAC,CAAA;YAC/D,OAAM;QACR,CAAC;QAED,IAAI,CAAC,MAAM,CAAC,KAAK,CACf,GAAG,IAAI,CAAC,IAAI,iBAAiB,QAAQ,QAAQ,MAAM,CAAC,KAAK,EAAE,OAAO,IAAI,eAAe,EAAE,CACxF,CAAA;QACD,IAAI,CAAC,QAAQ,GAAG,CAAC,CAAA;IACnB,CAAC;;AA1CO;IADP,IAAI,CAAC,MAAM,CAAC,EAAE,WAAW,EAAE,yCAAyC,EAAE,CAAC;;yCACpD"}

package/dist/commands/index.d.ts

@@ -0,0 +1,15 @@
+/**
+ * `@c9up/ream/commands` — the commands the framework itself ships.
+ *
+ * The shape AdonisJS uses for `@adonisjs/core/commands`: a module answering
+ * `getMetaData()` then `getCommand()`, so listing a command does not import it.
+ *
+ * The kernel registers this loader on its own rather than waiting for an entry
+ * in `reamrc.commands` — the deviation from AdonisJS, where the starter kit
+ * lists it. These commands were part of the `ream` binary before they were
+ * classes, and an application that upgrades must not silently lose them.
+ */
+import type { CommandClass, SerializedCommand } from '../console/types.js';
+export declare function getMetaData(): Promise<SerializedCommand[]>;
+export declare function getCommand(metadata: SerializedCommand): Promise<CommandClass | null>;
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAA;AA4C1E,wBAAsB,WAAW,IAAI,OAAO,CAAC,iBAAiB,EAAE,CAAC,CAUhE;AAED,wBAAsB,UAAU,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,YAAY,GAAG,IAAI,CAAC,CAI1F"}

package/dist/commands/index.js

@@ -0,0 +1,63 @@
+/**
+ * `@c9up/ream/commands` — the commands the framework itself ships.
+ *
+ * The shape AdonisJS uses for `@adonisjs/core/commands`: a module answering
+ * `getMetaData()` then `getCommand()`, so listing a command does not import it.
+ *
+ * The kernel registers this loader on its own rather than waiting for an entry
+ * in `reamrc.commands` — the deviation from AdonisJS, where the starter kit
+ * lists it. These commands were part of the `ream` binary before they were
+ * classes, and an application that upgrades must not silently lose them.
+ */
+const COMMANDS = [
+    // The registry commands first: a data package registers its runner, and
+    // these drive whatever registered — they name no store.
+    {
+        commandName: 'migrate',
+        description: 'Run pending migrations for every registered migration source',
+        load: () => import('./Migrate.js'),
+    },
+    {
+        commandName: 'migrate:rollback',
+        description: 'Roll back the last batch for every registered migration source',
+        load: () => import('./MigrateRollback.js'),
+    },
+    {
+        commandName: 'migrate:status',
+        description: 'Show applied and pending migrations for every source',
+        load: () => import('./MigrateStatus.js'),
+    },
+    {
+        commandName: 'schedule:list',
+        description: 'List every registered scheduled task, its next run and its stats',
+        load: () => import('./ScheduleList.js'),
+    },
+    {
+        commandName: 'schedule:run',
+        description: 'Run a registered scheduled task once, now (bypasses the lock)',
+        load: () => import('./ScheduleRun.js'),
+    },
+];
+/** `migrate:status` → `migrate`; a name without a colon has no namespace. */
+function namespaceOf(commandName) {
+    const colon = commandName.indexOf(':');
+    return colon === -1 ? null : commandName.slice(0, colon);
+}
+export async function getMetaData() {
+    return COMMANDS.map((entry) => ({
+        commandName: entry.commandName,
+        namespace: namespaceOf(entry.commandName),
+        description: entry.description,
+        aliases: [],
+        options: { startApp: true },
+        args: [],
+        flags: [],
+    }));
+}
+export async function getCommand(metadata) {
+    const entry = COMMANDS.find((command) => command.commandName === metadata.commandName);
+    if (!entry)
+        return null;
+    return (await entry.load()).default;
+}
+//# sourceMappingURL=index.js.map

package/dist/commands/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/commands/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;GAUG;AAUH,MAAM,QAAQ,GAAqB;IACjC,wEAAwE;IACxE,wDAAwD;IACxD;QACE,WAAW,EAAE,SAAS;QACtB,WAAW,EAAE,8DAA8D;QAC3E,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,cAAc,CAAC;KACnC;IACD;QACE,WAAW,EAAE,kBAAkB;QAC/B,WAAW,EAAE,gEAAgE;QAC7E,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,sBAAsB,CAAC;KAC3C;IACD;QACE,WAAW,EAAE,gBAAgB;QAC7B,WAAW,EAAE,sDAAsD;QACnE,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,oBAAoB,CAAC;KACzC;IACD;QACE,WAAW,EAAE,eAAe;QAC5B,WAAW,EAAE,kEAAkE;QAC/E,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,mBAAmB,CAAC;KACxC;IACD;QACE,WAAW,EAAE,cAAc;QAC3B,WAAW,EAAE,+DAA+D;QAC5E,IAAI,EAAE,GAAG,EAAE,CAAC,MAAM,CAAC,kBAAkB,CAAC;KACvC;CACF,CAAA;AAED,6EAA6E;AAC7E,SAAS,WAAW,CAAC,WAAmB;IACtC,MAAM,KAAK,GAAG,WAAW,CAAC,OAAO,CAAC,GAAG,CAAC,CAAA;IACtC,OAAO,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,CAAC,CAAC,EAAE,KAAK,CAAC,CAAA;AAC1D,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,WAAW;IAC/B,OAAO,QAAQ,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QAC9B,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,SAAS,EAAE,WAAW,CAAC,KAAK,CAAC,WAAW,CAAC;QACzC,WAAW,EAAE,KAAK,CAAC,WAAW;QAC9B,OAAO,EAAE,EAAE;QACX,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE;QAC3B,IAAI,EAAE,EAAE;QACR,KAAK,EAAE,EAAE;KACV,CAAC,CAAC,CAAA;AACL,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,UAAU,CAAC,QAA2B;IAC1D,MAAM,KAAK,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,WAAW,KAAK,QAAQ,CAAC,WAAW,CAAC,CAAA;IACtF,IAAI,CAAC,KAAK;QAAE,OAAO,IAAI,CAAA;IACvB,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC,OAAO,CAAA;AACrC,CAAC"}

package/dist/commands/scheduler_resolver.d.ts

@@ -0,0 +1,12 @@
+/**
+ * Resolve the scheduler for the `schedule:*` commands.
+ *
+ * Shared because the failure is the same one on both, and it is a
+ * configuration mistake rather than a crash: the provider is simply not in the
+ * list, and the message has to say so — a container error mentioning an
+ * unbound `scheduler` binding tells an operator nothing.
+ */
+import type { BaseCommand } from '../console/BaseCommand.js';
+import type { Scheduler } from '../scheduler/Scheduler.js';
+export declare function resolveScheduler(command: BaseCommand): Promise<Scheduler | undefined>;
+//# sourceMappingURL=scheduler_resolver.d.ts.map

package/dist/commands/scheduler_resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler_resolver.d.ts","sourceRoot":"","sources":["../../src/commands/scheduler_resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,2BAA2B,CAAA;AAC5D,OAAO,KAAK,EAAE,SAAS,EAAE,MAAM,2BAA2B,CAAA;AAE1D,wBAAsB,gBAAgB,CAAC,OAAO,EAAE,WAAW,GAAG,OAAO,CAAC,SAAS,GAAG,SAAS,CAAC,CAU3F"}

package/dist/commands/scheduler_resolver.js

@@ -0,0 +1,19 @@
+/**
+ * Resolve the scheduler for the `schedule:*` commands.
+ *
+ * Shared because the failure is the same one on both, and it is a
+ * configuration mistake rather than a crash: the provider is simply not in the
+ * list, and the message has to say so — a container error mentioning an
+ * unbound `scheduler` binding tells an operator nothing.
+ */
+export async function resolveScheduler(command) {
+    try {
+        return await command.app.container.resolve('scheduler');
+    }
+    catch {
+        command.logger.error('No ScheduleProvider is registered. Add ScheduleProvider to the providers list in reamrc.ts.');
+        command.exitCode = 2;
+        return undefined;
+    }
+}
+//# sourceMappingURL=scheduler_resolver.js.map

package/dist/commands/scheduler_resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scheduler_resolver.js","sourceRoot":"","sources":["../../src/commands/scheduler_resolver.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,MAAM,CAAC,KAAK,UAAU,gBAAgB,CAAC,OAAoB;IACzD,IAAI,CAAC;QACH,OAAO,MAAM,OAAO,CAAC,GAAG,CAAC,SAAS,CAAC,OAAO,CAAY,WAAW,CAAC,CAAA;IACpE,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,KAAK,CAClB,6FAA6F,CAC9F,CAAA;QACD,OAAO,CAAC,QAAQ,GAAG,CAAC,CAAA;QACpB,OAAO,SAAS,CAAA;IAClB,CAAC;AACH,CAAC"}

package/dist/debug.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Debug channels, off unless `NODE_DEBUG` names them — the shape AdonisJS
+ * uses (`NODE_DEBUG=adonisjs:http`).
+ *
+ *   NODE_DEBUG=ream:http ream serve
+ *   NODE_DEBUG=ream:* ream serve
+ *
+ * These are for the framework's own tracing: which route a request matched,
+ * which middleware ran, what status came back. They are NOT request logging —
+ * a production request log belongs to the app's logger (`ctx.logger`), which
+ * is correlation-scoped and structured. Neither framework prints one by
+ * default, and this is the switch for when you need to see the plumbing.
+ *
+ * `debuglog` returns a no-op when the channel is off, so an inactive probe
+ * costs a call. Guard with `.enabled` anywhere the ARGUMENTS would cost
+ * something to build — the per-request probes below all do.
+ */
+/** Routing, middleware and response tracing. AdonisJS `adonisjs:http`. */
+export declare const debugHttp: import("util").DebugLogger;
+/** Boot: providers, preloads, container bindings. AdonisJS `adonisjs:core`. */
+export declare const debugCore: import("util").DebugLogger;
+//# sourceMappingURL=debug.d.ts.map

package/dist/debug.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.d.ts","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAIH,0EAA0E;AAC1E,eAAO,MAAM,SAAS,4BAAwB,CAAA;AAE9C,+EAA+E;AAC/E,eAAO,MAAM,SAAS,4BAAwB,CAAA"}

package/dist/debug.js

@@ -0,0 +1,23 @@
+/**
+ * Debug channels, off unless `NODE_DEBUG` names them — the shape AdonisJS
+ * uses (`NODE_DEBUG=adonisjs:http`).
+ *
+ *   NODE_DEBUG=ream:http ream serve
+ *   NODE_DEBUG=ream:* ream serve
+ *
+ * These are for the framework's own tracing: which route a request matched,
+ * which middleware ran, what status came back. They are NOT request logging —
+ * a production request log belongs to the app's logger (`ctx.logger`), which
+ * is correlation-scoped and structured. Neither framework prints one by
+ * default, and this is the switch for when you need to see the plumbing.
+ *
+ * `debuglog` returns a no-op when the channel is off, so an inactive probe
+ * costs a call. Guard with `.enabled` anywhere the ARGUMENTS would cost
+ * something to build — the per-request probes below all do.
+ */
+import { debuglog } from 'node:util';
+/** Routing, middleware and response tracing. AdonisJS `adonisjs:http`. */
+export const debugHttp = debuglog('ream:http');
+/** Boot: providers, preloads, container bindings. AdonisJS `adonisjs:core`. */
+export const debugCore = debuglog('ream:core');
+//# sourceMappingURL=debug.js.map

package/dist/debug.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"debug.js","sourceRoot":"","sources":["../src/debug.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,OAAO,EAAE,QAAQ,EAAE,MAAM,WAAW,CAAA;AAEpC,0EAA0E;AAC1E,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAA;AAE9C,+EAA+E;AAC/E,MAAM,CAAC,MAAM,SAAS,GAAG,QAAQ,CAAC,WAAW,CAAC,CAAA"}

package/dist/dumper/Dumper.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Value dumping — AdonisJS's `Dumper`, in shape and in method names.
+ *
+ *   import { dd } from '@c9up/ream/services/dumper'
+ *   dd(user)                     // prints and stops the process
+ *
+ *   import dumper from '@c9up/ream/services/dumper'
+ *   response.send(dumper.dumpToHtml(user, { cspNonce: response.nonce }))
+ *
+ * The rendering is `node:util`'s `inspect`, not a dependency. It already knows
+ * about depth limits, circular references, getters, Maps, Sets and typed
+ * arrays, and it colours for a terminal — which is the whole of the ANSI side.
+ * The HTML side escapes that same output rather than building a second
+ * formatter, so the two can never describe a value differently.
+ */
+/** Where a dump was written, so the output can say so. */
+export interface DumpSource {
+    location: string;
+    line: number;
+}
+/** Knobs for the terminal rendering — AdonisJS `ConsoleDumpConfig`. */
+export interface ConsoleDumpConfig {
+    /** How deep to walk before printing `[Object]`. Default 4. */
+    depth?: number;
+    /** Colour the output. Default: whether stdout is a TTY. */
+    colors?: boolean;
+    /** Show non-enumerable properties. Default false. */
+    showHidden?: boolean;
+}
+/** Knobs for the HTML rendering — AdonisJS `HTMLDumpConfig`. */
+export interface HTMLDumpConfig {
+    /** How deep to walk. Default 4. */
+    depth?: number;
+    /** Show non-enumerable properties. Default false. */
+    showHidden?: boolean;
+    /** Style overrides for the emitted `<pre>`, as CSS declarations. */
+    styles?: Record<string, string>;
+}
+export declare class Dumper {
+    #private;
+    /** Configure the HTML rendering. Chainable, as in AdonisJS. */
+    configureHtmlOutput(config: HTMLDumpConfig): this;
+    /** Configure the terminal rendering. Chainable, as in AdonisJS. */
+    configureAnsiOutput(config: ConsoleDumpConfig): this;
+    /**
+     * The `<style>` a page needs before its first HTML dump.
+     *
+     * Takes a CSP nonce because a page that sets a nonce-based policy rejects an
+     * unattributed inline `<style>` — and a dump landing in a page that silently
+     * drops its styling is worse than no dump. `response.nonce` is what to pass.
+     */
+    getHeadElements(cspNonce?: string): string;
+    /** Render `value` for a terminal. */
+    dumpToAnsi(value: unknown, options?: {
+        title?: string;
+        source?: DumpSource;
+    }): string;
+    /**
+     * Render `value` as HTML.
+     *
+     * The inspected output is escaped before it reaches the page: a dumped value
+     * is by definition data someone else may control, and a dump is something
+     * you reach for while debugging — exactly when a script tag in a field name
+     * would be least expected.
+     */
+    dumpToHtml(value: unknown, options?: {
+        cspNonce?: string;
+        title?: string;
+        source?: DumpSource;
+    }): string;
+    /**
+     * Dump and die — print to stderr and stop the process.
+     *
+     * `traceSourceIndex` selects which stack frame to report as the dump site:
+     * 1 is the caller of `dd`, which is right when `dd` is called directly, and
+     * a wrapper passes 2.
+     */
+    dd(value: unknown, traceSourceIndex?: number): void;
+}
+//# sourceMappingURL=Dumper.d.ts.map

package/dist/dumper/Dumper.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Dumper.d.ts","sourceRoot":"","sources":["../../src/dumper/Dumper.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;GAcG;AAKH,0DAA0D;AAC1D,MAAM,WAAW,UAAU;IACzB,QAAQ,EAAE,MAAM,CAAA;IAChB,IAAI,EAAE,MAAM,CAAA;CACb;AAED,uEAAuE;AACvE,MAAM,WAAW,iBAAiB;IAChC,8DAA8D;IAC9D,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,2DAA2D;IAC3D,MAAM,CAAC,EAAE,OAAO,CAAA;IAChB,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAA;CACrB;AAED,gEAAgE;AAChE,MAAM,WAAW,cAAc;IAC7B,mCAAmC;IACnC,KAAK,CAAC,EAAE,MAAM,CAAA;IACd,qDAAqD;IACrD,UAAU,CAAC,EAAE,OAAO,CAAA;IACpB,oEAAoE;IACpE,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;CAChC;AAaD,qBAAa,MAAM;;IAIjB,+DAA+D;IAC/D,mBAAmB,CAAC,MAAM,EAAE,cAAc,GAAG,IAAI;IAKjD,mEAAmE;IACnE,mBAAmB,CAAC,MAAM,EAAE,iBAAiB,GAAG,IAAI;IAKpD;;;;;;OAMG;IACH,eAAe,CAAC,QAAQ,CAAC,EAAE,MAAM,GAAG,MAAM;IAS1C,qCAAqC;IACrC,UAAU,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,CAAA;KAAE,GAAG,MAAM;IAarF;;;;;;;OAOG;IACH,UAAU,CACR,KAAK,EAAE,OAAO,EACd,OAAO,CAAC,EAAE;QAAE,QAAQ,CAAC,EAAE,MAAM,CAAC;QAAC,KAAK,CAAC,EAAE,MAAM,CAAC;QAAC,MAAM,CAAC,EAAE,UAAU,CAAA;KAAE,GACnE,MAAM;IAaT;;;;;;OAMG;IACH,EAAE,CAAC,KAAK,EAAE,OAAO,EAAE,gBAAgB,SAAI,GAAG,IAAI;CAI/C"}

package/dist/dumper/Dumper.js

@@ -0,0 +1,129 @@
+/**
+ * Value dumping — AdonisJS's `Dumper`, in shape and in method names.
+ *
+ *   import { dd } from '@c9up/ream/services/dumper'
+ *   dd(user)                     // prints and stops the process
+ *
+ *   import dumper from '@c9up/ream/services/dumper'
+ *   response.send(dumper.dumpToHtml(user, { cspNonce: response.nonce }))
+ *
+ * The rendering is `node:util`'s `inspect`, not a dependency. It already knows
+ * about depth limits, circular references, getters, Maps, Sets and typed
+ * arrays, and it colours for a terminal — which is the whole of the ANSI side.
+ * The HTML side escapes that same output rather than building a second
+ * formatter, so the two can never describe a value differently.
+ */
+import { inspect } from 'node:util';
+import { escapeHTML } from '../helpers/string.js';
+const DEFAULT_STYLES = {
+    'background-color': '#0b0b0d',
+    color: '#e6e6e6',
+    padding: '1rem',
+    'border-radius': '6px',
+    'font-family': 'ui-monospace, SFMono-Regular, Menlo, monospace',
+    'font-size': '13px',
+    'line-height': '1.5',
+    'overflow-x': 'auto',
+};
+export class Dumper {
+    #html = {};
+    #ansi = {};
+    /** Configure the HTML rendering. Chainable, as in AdonisJS. */
+    configureHtmlOutput(config) {
+        this.#html = { ...this.#html, ...config };
+        return this;
+    }
+    /** Configure the terminal rendering. Chainable, as in AdonisJS. */
+    configureAnsiOutput(config) {
+        this.#ansi = { ...this.#ansi, ...config };
+        return this;
+    }
+    /**
+     * The `<style>` a page needs before its first HTML dump.
+     *
+     * Takes a CSP nonce because a page that sets a nonce-based policy rejects an
+     * unattributed inline `<style>` — and a dump landing in a page that silently
+     * drops its styling is worse than no dump. `response.nonce` is what to pass.
+     */
+    getHeadElements(cspNonce) {
+        const nonce = cspNonce ? ` nonce="${escapeHTML(cspNonce)}"` : '';
+        const styles = { ...DEFAULT_STYLES, ...this.#html.styles };
+        const declarations = Object.entries(styles)
+            .map(([property, value]) => `  ${property}: ${value};`)
+            .join('\n');
+        return `<style${nonce}>\n.ream-dump {\n${declarations}\n}\n</style>`;
+    }
+    /** Render `value` for a terminal. */
+    dumpToAnsi(value, options) {
+        const body = inspect(value, {
+            depth: this.#ansi.depth ?? 4,
+            colors: this.#ansi.colors ?? process.stdout.isTTY === true,
+            showHidden: this.#ansi.showHidden ?? false,
+            // Long strings and arrays are the reason someone is dumping; truncating
+            // them defeats the call.
+            maxStringLength: null,
+            maxArrayLength: null,
+        });
+        return [header(options), body].filter(Boolean).join('\n');
+    }
+    /**
+     * Render `value` as HTML.
+     *
+     * The inspected output is escaped before it reaches the page: a dumped value
+     * is by definition data someone else may control, and a dump is something
+     * you reach for while debugging — exactly when a script tag in a field name
+     * would be least expected.
+     */
+    dumpToHtml(value, options) {
+        const body = inspect(value, {
+            depth: this.#html.depth ?? 4,
+            colors: false,
+            showHidden: this.#html.showHidden ?? false,
+            maxStringLength: null,
+            maxArrayLength: null,
+        });
+        const heading = header(options);
+        const label = heading ? `<div class="ream-dump-header">${escapeHTML(heading)}</div>` : '';
+        return `${this.getHeadElements(options?.cspNonce)}\n${label}<pre class="ream-dump">${escapeHTML(body)}</pre>`;
+    }
+    /**
+     * Dump and die — print to stderr and stop the process.
+     *
+     * `traceSourceIndex` selects which stack frame to report as the dump site:
+     * 1 is the caller of `dd`, which is right when `dd` is called directly, and
+     * a wrapper passes 2.
+     */
+    dd(value, traceSourceIndex = 1) {
+        process.stderr.write(`${this.dumpToAnsi(value, { source: callSite(traceSourceIndex) })}\n`);
+        process.exit(1);
+    }
+}
+/** `title` and `source` as one line, or nothing when neither is given. */
+function header(options) {
+    const parts = [];
+    if (options?.title)
+        parts.push(options.title);
+    if (options?.source)
+        parts.push(`${options.source.location}:${options.source.line}`);
+    return parts.join(' — ');
+}
+/**
+ * Where `dd` was called, read from a thrown stack.
+ *
+ * Best-effort: a bundled or minified frame may not parse, and a dump that
+ * cannot name its own line is still a useful dump — so a miss returns nothing
+ * rather than throwing on the debugging path.
+ */
+function callSite(index) {
+    const frames = new Error().stack?.split('\n').slice(1);
+    const frame = frames?.[index];
+    if (!frame)
+        return undefined;
+    const match = /\(?(.+):(\d+):\d+\)?$/.exec(frame.trim());
+    const location = match?.[1];
+    const line = match?.[2];
+    if (!location || !line)
+        return undefined;
+    return { location, line: Number(line) };
+}
+//# sourceMappingURL=Dumper.js.map

package/dist/dumper/Dumper.js.map

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

package/dist/index.d.ts

@@ -119,5 +119,5 @@ export { BaseEvent, Emitter, type EmitterResolver, type ListenerClass, } from '.
 export { type BufferedEvent, type BufferedEventName, type EventFinder, EventsBuffer, } from './events/EventsBuffer.js';
 export type { ErrorReporter, LockBackend, RunTaskOutcome, ScheduleEvent, ScheduleEventSink, ScheduleInvocation, ScheduleMetadata, ScheduleProviderOptions, SchedulerOptions, ScheduleTaskCompletedEvent, ScheduleTaskFailedEvent, ScheduleTaskSkippedEvent, ScheduleTaskStartedEvent, TaskInfo, TaskStats, } from './scheduler/index.js';
 export { getScheduleMetadata, MemoryLockBackend, SCHEDULE_METADATA_KEY, Schedule, ScheduleProvider, Scheduler, StatsTracker, } from './scheduler/index.js';
-export declare const VERSION = "0.2.7";
+export declare const VERSION = "0.2.9";
 //# sourceMappingURL=index.d.ts.map

package/dist/index.js

@@ -91,5 +91,5 @@ export { defineConfig as defineEventsConfig } from './events/config.js';
 export { BaseEvent, Emitter, } from './events/Emitter.js';
 export { EventsBuffer, } from './events/EventsBuffer.js';
 export { getScheduleMetadata, MemoryLockBackend, SCHEDULE_METADATA_KEY, Schedule, ScheduleProvider, Scheduler, StatsTracker, } from './scheduler/index.js';
-export const VERSION = '0.2.7';
+export const VERSION = '0.2.9';
 //# sourceMappingURL=index.js.map

package/dist/middleware/Pipeline.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/Pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAIH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE,cAAc,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,CAAA;IACvD,mBAAmB,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACtE;AAiBD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,uBAAuB,CAAC,CA0BlC;AAED,iCAAiC;AACjC,qBAAa,kBAAkB;;IAI7B,4DAA4D;IAC5D,GAAG,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAIzC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAI5D,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,iCAAiC;IACjC,SAAS,IAAI,kBAAkB,EAAE;IAIjC,+CAA+C;IAC/C,UAAU,CACR,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,EAAE,kBAAkB,EAAE,EACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;QACtB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAA;KAChC,GACA,kBAAkB;CAoCtB;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CAoB/E;AA8DD,OAAO,EAAE,iBAAiB,EAAE,CAAA"}
+{"version":3,"file":"Pipeline.d.ts","sourceRoot":"","sources":["../../src/middleware/Pipeline.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAKH,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,wBAAwB,CAAA;AAEzD,MAAM,MAAM,kBAAkB,GAAG,CAC/B,GAAG,EAAE,WAAW,EAChB,IAAI,EAAE,MAAM,OAAO,CAAC,IAAI,CAAC,KACtB,OAAO,CAAC,IAAI,CAAC,GAAG,IAAI,CAAA;AAEzB,0EAA0E;AAC1E,MAAM,WAAW,uBAAuB;IACtC,KAAK,EAAE,OAAO,CAAA;IACd,MAAM,EAAE,OAAO,EAAE,CAAA;IACjB,IAAI,CAAC,EAAE,OAAO,CAAA;CACf;AAED;;;;;;;;;;;GAWG;AACH,MAAM,WAAW,gBAAgB;IAC/B,QAAQ,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;IACpE,cAAc,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,uBAAuB,CAAA;IACvD,mBAAmB,CAAC,CAAC,IAAI,EAAE,OAAO,GAAG,OAAO,CAAC,uBAAuB,CAAC,CAAA;CACtE;AAiBD;;;;;;;;GAQG;AACH,wBAAsB,YAAY,CAChC,SAAS,EAAE,gBAAgB,EAC3B,IAAI,EAAE,OAAO,GACZ,OAAO,CAAC,uBAAuB,CAAC,CA0BlC;AAED,iCAAiC;AACjC,qBAAa,kBAAkB;;IAI7B,4DAA4D;IAC5D,GAAG,CAAC,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAIzC,mCAAmC;IACnC,QAAQ,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,kBAAkB,GAAG,IAAI;IAI5D,8BAA8B;IAC9B,GAAG,CAAC,IAAI,EAAE,MAAM,GAAG,kBAAkB,GAAG,SAAS;IAIjD,iCAAiC;IACjC,SAAS,IAAI,kBAAkB,EAAE;IAIjC,+CAA+C;IAC/C,UAAU,CACR,eAAe,EAAE,MAAM,EAAE,EACzB,gBAAgB,EAAE,kBAAkB,EAAE,EACtC,OAAO,EAAE,kBAAkB,EAC3B,OAAO,CAAC,EAAE;QACR,MAAM,CAAC,EAAE,MAAM,EAAE,CAAA;QACjB,KAAK,CAAC,EAAE,MAAM,EAAE,CAAA;QAChB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAA;QACtB,UAAU,CAAC,EAAE,gBAAgB,EAAE,CAAA;KAChC,GACA,kBAAkB;CAoCtB;AAED;;;;;;GAMG;AACH,iBAAS,iBAAiB,CAAC,UAAU,EAAE,kBAAkB,EAAE,GAAG,kBAAkB,CA0B/E;AA8DD,OAAO,EAAE,iBAAiB,EAAE,CAAA"}

package/dist/middleware/Pipeline.js

@@ -10,6 +10,7 @@
  * 4. Guard (auth + roles + permissions)
  * 5. Handler
  */
+import { debugHttp } from '../debug.js';
 import { ReamError } from '../errors/ReamError.js';
 import { E_FORBIDDEN, E_UNAUTHORIZED, E_VALIDATION_ERROR } from '../http/Exception.js';
 function isThrownValidationFailure(value) {
@@ -125,6 +126,12 @@ function composeMiddleware(middleware) {
             const fn = i < middleware.length ? middleware[i] : finalNext;
             if (!fn)
                 return;
+            if (debugHttp.enabled && i < middleware.length) {
+                // `fn.name` is what a named middleware function or a bound class
+                // method carries; an inline arrow has none, and its position is the
+                // only thing that identifies it.
+                debugHttp('middleware %d/%d %s', i + 1, middleware.length, fn.name || '(anonymous)');
+            }
             await fn(ctx, () => dispatch(i + 1));
         }
         await dispatch(0);