@adonis-agora/filter 1.0.0-rc.1 → 1.0.0-rc.3

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @adonis-agora/filter
 
+## 1.0.0-rc.3
+
+### Patch Changes
+
+- [#148](https://github.com/DavideCarvalho/adonis-agora-filter/pull/148) [`7ac919c`](https://github.com/DavideCarvalho/adonis-agora-filter/commit/7ac919ceabf41976ae30e42a50c5a6f179502593) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - `agora:doctor`'s `filter.manifest` check no longer reports prettier-formatted clients as out of date. Generated clients now carry a `// Content hash: sha256:…` banner line (the hash of what the generator emitted), and the check compares that hash with a fresh generation, so any formatter is fine. Clients generated before this get a more tolerant shape comparison (quoted vs unquoted keys, quote escapes and a union's leading `|` are ignored). Run `node ace make:filter-client` once to add the hash.
+
+## 1.0.0-rc.2
+
+### Minor Changes
+
+- [#146](https://github.com/DavideCarvalho/adonis-agora-filter/pull/146) [`efaae21`](https://github.com/DavideCarvalho/adonis-agora-filter/commit/efaae2137a53a8c85a66a9640d5606256ac82852) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - `node ace agora:doctor` (the shared Agora health check) and `node ace filter:doctor`, with the `filter.manifest` check: `config/filter.ts` loads, and the clients in `app/generated/filters` match it (out of date, missing or orphaned → run `make:filter-client`). New `@adonis-agora/filter/doctor` entry for `--no-boot`.
+
 ## 1.0.0-rc.1
 
 ### Minor Changes

package/dist/commands/agora_doctor.d.ts

@@ -0,0 +1,23 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+/**
+ * `node ace agora:doctor`: one health check for every installed `@adonis-agora` lib. Exit code `0`
+ * when nothing is an error (`--strict`: nor a warning), `1` otherwise, `2` when the doctor itself
+ * cannot run.
+ */
+export default class AgoraDoctor extends BaseCommand {
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    /** A `<lib>:doctor` alias sets this to pre-filter its lib. */
+    protected presetLib: string | undefined;
+    json: boolean;
+    lib?: string;
+    deep: boolean;
+    only?: string;
+    strict: boolean;
+    verbose: boolean;
+    boot: boolean;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=agora_doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"agora_doctor.d.ts","sourceRoot":"","sources":["../../commands/agora_doctor.ts"],"names":[],"mappings":"AAMA,OAAO,EAAE,WAAW,EAAS,MAAM,oBAAoB,CAAC;AACxD,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAS/D;;;;GAIG;AACH,MAAM,CAAC,OAAO,OAAO,WAAY,SAAQ,WAAW;IAClD,OAAgB,WAAW,SAAkB;IAC7C,OAAgB,WAAW,SAAkE;IAE7F,OAAgB,OAAO,EAAE,cAAc,CAAuB;IAE9D,8DAA8D;IAC9D,SAAS,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAa;IAG5C,IAAI,EAAE,OAAO,CAAC;IAGd,GAAG,CAAC,EAAE,MAAM,CAAC;IAGb,IAAI,EAAE,OAAO,CAAC;IAGd,IAAI,CAAC,EAAE,MAAM,CAAC;IAGd,MAAM,EAAE,OAAO,CAAC;IAGhB,OAAO,EAAE,OAAO,CAAC;IAOjB,IAAI,EAAE,OAAO,CAAC;IAEP,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAwDlC;CACF"}

package/dist/commands/agora_doctor.js

@@ -0,0 +1,110 @@
+// agora-doctor command v1 — keep identical across libs
+// Revision 1.1 (see the canonical README for the changelog).
+// Every @adonis-agora lib ships this command (commands/agora_doctor.ts); whichever copy Ace loads
+// last wins, and they all behave the same. Each repo's CI checks its sha256 against the pinned
+// canonical one. Never edit a lib's copy: change the canonical copy, then re-copy it into every lib.
+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;
+};
+import { BaseCommand, flags } from '@adonisjs/core/ace';
+import { AgoraDoctorUsageError, discoverDoctorChecks, readDoctorChecks, renderAgoraDoctor, runAgoraDoctor, } from '../src/doctor/agora_doctor.js';
+/**
+ * `node ace agora:doctor`: one health check for every installed `@adonis-agora` lib. Exit code `0`
+ * when nothing is an error (`--strict`: nor a warning), `1` otherwise, `2` when the doctor itself
+ * cannot run.
+ */
+export default class AgoraDoctor extends BaseCommand {
+    static commandName = 'agora:doctor';
+    static description = 'Check the configuration of every installed @adonis-agora lib';
+    // The app is booted by `run()` itself, so `--no-boot` can skip it.
+    static options = { startApp: false };
+    /** A `<lib>:doctor` alias sets this to pre-filter its lib. */
+    presetLib = undefined;
+    async run() {
+        const err = (line) => process.stderr.write(`${line}\n`);
+        try {
+            let checks;
+            if (this.boot === false) {
+                checks = await discoverDoctorChecks(this.app);
+            }
+            else {
+                if (!this.app.isReady) {
+                    try {
+                        await this.app.boot();
+                        await this.app.start(() => { });
+                    }
+                    catch (error) {
+                        const reason = error instanceof Error ? error.message : String(error);
+                        throw new AgoraDoctorUsageError(`the app did not boot (${reason}). Fix the boot error, or run with --no-boot.`);
+                    }
+                }
+                checks = await readDoctorChecks(this.app.container);
+            }
+            const libs = (this.lib ?? this.presetLib)
+                ?.split(',')
+                .map((name) => name.trim())
+                .filter(Boolean);
+            const { report, exitCode } = await runAgoraDoctor(this.app, checks, {
+                ...(libs ? { libs } : {}),
+                ...(this.only ? { only: this.only } : {}),
+                deep: this.deep === true,
+                noBoot: this.boot === false,
+                strict: this.strict === true,
+            });
+            if (this.json) {
+                process.stdout.write(`${JSON.stringify(report)}\n`);
+            }
+            else {
+                const fancy = process.stdout.isTTY === true && !process.env.NO_COLOR;
+                const c = this.colors;
+                process.stdout.write(renderAgoraDoctor(report, {
+                    verbose: this.verbose === true,
+                    fancy,
+                    paint: {
+                        green: (t) => c.green(t),
+                        yellow: (t) => c.yellow(t),
+                        red: (t) => c.red(t),
+                        dim: (t) => c.dim(t),
+                        bold: (t) => c.bold(t),
+                    },
+                }));
+            }
+            this.exitCode = exitCode;
+        }
+        catch (error) {
+            if (!(error instanceof AgoraDoctorUsageError))
+                throw error;
+            err(`agora:doctor: ${error.message}`);
+            this.exitCode = 2;
+        }
+    }
+}
+__decorate([
+    flags.boolean({ description: 'Print one JSON object to stdout' })
+], AgoraDoctor.prototype, "json", void 0);
+__decorate([
+    flags.string({ description: 'Only these libs, comma separated (durable,payments)' })
+], AgoraDoctor.prototype, "lib", void 0);
+__decorate([
+    flags.boolean({ description: 'Also run checks that touch the database, Redis or the network' })
+], AgoraDoctor.prototype, "deep", void 0);
+__decorate([
+    flags.string({ description: 'Run one check by id' })
+], AgoraDoctor.prototype, "only", void 0);
+__decorate([
+    flags.boolean({ description: 'Fail (exit 1) on warnings too' })
+], AgoraDoctor.prototype, "strict", void 0);
+__decorate([
+    flags.boolean({ description: 'Show skipped checks and every message' })
+], AgoraDoctor.prototype, "verbose", void 0);
+__decorate([
+    flags.boolean({
+        description: 'Boot the app first; --no-boot checks the config only (when boot itself fails)',
+        default: true,
+        showNegatedVariantInHelp: true,
+    })
+], AgoraDoctor.prototype, "boot", void 0);
+//# sourceMappingURL=agora_doctor.js.map

package/dist/commands/agora_doctor.js.map

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

package/dist/commands/filter_doctor.d.ts

@@ -0,0 +1,8 @@
+import AgoraDoctor from './agora_doctor.js';
+/** `node ace filter:doctor`: `agora:doctor` for `@adonis-agora/filter` only. */
+export default class FilterDoctor extends AgoraDoctor {
+    static commandName: string;
+    static description: string;
+    protected presetLib: string | undefined;
+}
+//# sourceMappingURL=filter_doctor.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter_doctor.d.ts","sourceRoot":"","sources":["../../commands/filter_doctor.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAE5C,gFAAgF;AAChF,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,OAAgB,WAAW,SAAmB;IAC9C,OAAgB,WAAW,SAAkD;IAC7E,UAAmB,SAAS,EAAE,MAAM,GAAG,SAAS,CAAY;CAC7D"}

package/dist/commands/filter_doctor.js

@@ -0,0 +1,8 @@
+import AgoraDoctor from './agora_doctor.js';
+/** `node ace filter:doctor`: `agora:doctor` for `@adonis-agora/filter` only. */
+export default class FilterDoctor extends AgoraDoctor {
+    static commandName = 'filter:doctor';
+    static description = 'Check the @adonis-agora/filter configuration';
+    presetLib = 'filter';
+}
+//# sourceMappingURL=filter_doctor.js.map

package/dist/commands/filter_doctor.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter_doctor.js","sourceRoot":"","sources":["../../commands/filter_doctor.ts"],"names":[],"mappings":"AAAA,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAE5C,gFAAgF;AAChF,MAAM,CAAC,OAAO,OAAO,YAAa,SAAQ,WAAW;IACnD,MAAM,CAAU,WAAW,GAAG,eAAe,CAAC;IAC9C,MAAM,CAAU,WAAW,GAAG,8CAA8C,CAAC;IAC1D,SAAS,GAAuB,QAAQ,CAAC;CAC7D"}

package/dist/commands/main.d.ts

@@ -1,19 +1,21 @@
 import { ListLoader } from '@adonisjs/core/ace';
+import AgoraDoctor from './agora_doctor.js';
 import MakeFilter from './make_filter.js';
 import MakeFilterClient from './make_filter_client.js';
 /**
  * The commands barrel for `@adonis-agora/filter`. An app registers it in its
  * `adonisrc` via `rcFile.addCommand('@adonis-agora/filter/commands')`. A
  * {@link ListLoader} exposes the `make:filter-client` command's metadata and
- * constructors to the ace kernel: `make:filter` (scaffold a filter class) and
- * `make:filter-client` (emit the typed front-end builders).
+ * constructors to the ace kernel: `make:filter` (scaffold a filter class),
+ * `make:filter-client` (emit the typed front-end builders) and the `agora:doctor` /
+ * `filter:doctor` health check.
  *
  * `@adonisjs/core` is an *optional* peer of this otherwise framework-free core —
  * only this `./commands` subpath imports it, so the main entrypoint stays
  * dependency-free.
  */
-declare const loader: ListLoader<typeof MakeFilter | typeof MakeFilterClient>;
+declare const loader: ListLoader<typeof AgoraDoctor | typeof MakeFilter | typeof MakeFilterClient>;
 export declare const getMetaData: () => Promise<import("@adonisjs/core/types/ace").CommandMetaData[]>;
-export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof MakeFilter | typeof MakeFilterClient | null>;
+export declare const getCommand: (metaData: import("@adonisjs/core/types/ace").CommandMetaData) => Promise<typeof AgoraDoctor | typeof MakeFilter | typeof MakeFilterClient | null>;
 export default loader;
 //# sourceMappingURL=main.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,gBAAgB,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,QAAA,MAAM,MAAM,yDAAiD,CAAC;AAE9D,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,+HAAiC,CAAC;eAE1C,MAAM"}
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAE5C,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,gBAAgB,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,QAAA,MAAM,MAAM,8EAA4E,CAAC;AAEzF,eAAO,MAAM,WAAW,qEAAkC,CAAC;AAC3D,eAAO,MAAM,UAAU,oJAAiC,CAAC;eAE1C,MAAM"}

package/dist/commands/main.js

@@ -1,18 +1,21 @@
 import { ListLoader } from '@adonisjs/core/ace';
+import AgoraDoctor from './agora_doctor.js';
+import FilterDoctor from './filter_doctor.js';
 import MakeFilter from './make_filter.js';
 import MakeFilterClient from './make_filter_client.js';
 /**
  * The commands barrel for `@adonis-agora/filter`. An app registers it in its
  * `adonisrc` via `rcFile.addCommand('@adonis-agora/filter/commands')`. A
  * {@link ListLoader} exposes the `make:filter-client` command's metadata and
- * constructors to the ace kernel: `make:filter` (scaffold a filter class) and
- * `make:filter-client` (emit the typed front-end builders).
+ * constructors to the ace kernel: `make:filter` (scaffold a filter class),
+ * `make:filter-client` (emit the typed front-end builders) and the `agora:doctor` /
+ * `filter:doctor` health check.
  *
  * `@adonisjs/core` is an *optional* peer of this otherwise framework-free core —
  * only this `./commands` subpath imports it, so the main entrypoint stays
  * dependency-free.
  */
-const loader = new ListLoader([MakeFilter, MakeFilterClient]);
+const loader = new ListLoader([MakeFilter, MakeFilterClient, FilterDoctor, AgoraDoctor]);
 export const getMetaData = loader.getMetaData.bind(loader);
 export const getCommand = loader.getCommand.bind(loader);
 export default loader;

package/dist/commands/main.js.map

@@ -1 +1 @@
-{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,gBAAgB,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;GAUG;AACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,UAAU,EAAE,gBAAgB,CAAC,CAAC,CAAC;AAE9D,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}
+{"version":3,"file":"main.js","sourceRoot":"","sources":["../../commands/main.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,oBAAoB,CAAC;AAChD,OAAO,WAAW,MAAM,mBAAmB,CAAC;AAC5C,OAAO,YAAY,MAAM,oBAAoB,CAAC;AAC9C,OAAO,UAAU,MAAM,kBAAkB,CAAC;AAC1C,OAAO,gBAAgB,MAAM,yBAAyB,CAAC;AAEvD;;;;;;;;;;;GAWG;AACH,MAAM,MAAM,GAAG,IAAI,UAAU,CAAC,CAAC,UAAU,EAAE,gBAAgB,EAAE,YAAY,EAAE,WAAW,CAAC,CAAC,CAAC;AAEzF,MAAM,CAAC,MAAM,WAAW,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAC3D,MAAM,CAAC,MAAM,UAAU,GAAG,MAAM,CAAC,UAAU,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;AAEzD,eAAe,MAAM,CAAC"}

package/dist/providers/filter_provider.d.ts

@@ -15,7 +15,7 @@ import type { ApplicationService } from '@adonisjs/core/types';
  * const page = await User.query().filterPaginate(userFilter, ctx)
  * ```
  *
- * It also registers the filter developer tools on `@adonis-agora/agent`'s dev MCP endpoint when
+ * It also registers the `agora:doctor` checks, and the filter developer tools on `@adonis-agora/agent`'s dev MCP endpoint when
  * that is installed.
  *
  * Register it in `adonisrc.ts` (`providers`). The free functions

package/dist/providers/filter_provider.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"filter_provider.d.ts","sourceRoot":"","sources":["../../providers/filter_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAK/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;;IACrB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAA7C,YAAsB,GAAG,EAAE,kBAAkB,EAAI;IAE3C,IAAI,kBAIT;CA2BF"}
+{"version":3,"file":"filter_provider.d.ts","sourceRoot":"","sources":["../../providers/filter_provider.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAO/D;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;;IACrB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAA7C,YAAsB,GAAG,EAAE,kBAAkB,EAAI;IAE3C,IAAI,kBAKT;CA2BF"}

package/dist/providers/filter_provider.js

@@ -1,4 +1,6 @@
 import { registerFilterDevTools } from '../src/dev_tools/tools.js';
+import { registerDoctorChecks } from '../src/doctor/agora_doctor.js';
+import { filterDoctorChecks } from '../src/doctor/checks.js';
 import { registerFilterMacros } from '../src/lucid_macros.js';
 import { loadFilterManifest } from '../src/manifest.js';
 /**
@@ -17,7 +19,7 @@ import { loadFilterManifest } from '../src/manifest.js';
  * const page = await User.query().filterPaginate(userFilter, ctx)
  * ```
  *
- * It also registers the filter developer tools on `@adonis-agora/agent`'s dev MCP endpoint when
+ * It also registers the `agora:doctor` checks, and the filter developer tools on `@adonis-agora/agent`'s dev MCP endpoint when
  * that is installed.
  *
  * Register it in `adonisrc.ts` (`providers`). The free functions
@@ -31,6 +33,7 @@ export default class FilterProvider {
         this.app = app;
     }
     async boot() {
+        await registerDoctorChecks(this.app.container, filterDoctorChecks());
         const { ModelQueryBuilder } = await import('@adonisjs/lucid/orm');
         registerFilterMacros(ModelQueryBuilder);
         await this.#registerDevTools();

package/dist/providers/filter_provider.js.map

@@ -1 +1 @@
-{"version":3,"file":"filter_provider.js","sourceRoot":"","sources":["../../providers/filter_provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACX,GAAG;IAAzB,YAAsB,GAAuB;mBAAvB,GAAG;IAAuB,CAAC;IAEjD,KAAK,CAAC,IAAI;QACR,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAClE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAA0D,CAAC;QACtF,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAqC,QAAQ,EAAE,EAAE,CAAC,EAAE,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9F,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,SAAkB,EAAE;YACxE,QAAQ,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC;SAC7C,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAEjE,CAAC;YACd,MAAM,EAAE,KAAK,CACX,OAAO,KAAK,aAAa;gBACvB,CAAC,CAAC,0JAA0J;gBAC5J,CAAC,CAAC,0DAA0D,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}
+{"version":3,"file":"filter_provider.js","sourceRoot":"","sources":["../../providers/filter_provider.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,sBAAsB,EAAE,MAAM,2BAA2B,CAAC;AACnE,OAAO,EAAE,oBAAoB,EAAE,MAAM,+BAA+B,CAAC;AACrE,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAC;AAC7D,OAAO,EAAE,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAC9D,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AAExD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACX,GAAG;IAAzB,YAAsB,GAAuB;mBAAvB,GAAG;IAAuB,CAAC;IAEjD,KAAK,CAAC,IAAI;QACR,MAAM,oBAAoB,CAAC,IAAI,CAAC,GAAG,CAAC,SAAkB,EAAE,kBAAkB,EAAE,CAAC,CAAC;QAC9E,MAAM,EAAE,iBAAiB,EAAE,GAAG,MAAM,MAAM,CAAC,qBAAqB,CAAC,CAAC;QAClE,oBAAoB,CAAC,iBAAiB,CAAC,CAAC;QACxC,MAAM,IAAI,CAAC,iBAAiB,EAAE,CAAC;IACjC,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,iBAAiB;QACrB,MAAM,SAAS,GAAG,IAAI,CAAC,GAAG,CAAC,SAA0D,CAAC;QACtF,IAAI,OAAO,SAAS,CAAC,UAAU,KAAK,UAAU;YAAE,OAAO;QACvD,IAAI,IAAI,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,CAAqC,QAAQ,EAAE,EAAE,CAAC,EAAE,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC9F,OAAO;QACT,CAAC;QACD,MAAM,OAAO,GAAG,MAAM,sBAAsB,CAAC,IAAI,CAAC,GAAG,CAAC,SAAkB,EAAE;YACxE,QAAQ,EAAE,GAAG,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,GAAG,CAAC;SAC7C,CAAC,CAAC;QACH,IAAI,OAAO,KAAK,aAAa,IAAI,OAAO,KAAK,QAAQ,EAAE,CAAC;YACtD,MAAM,MAAM,GAAG,CAAC,MAAM,IAAI,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC,KAAK,CAAC,GAAG,EAAE,CAAC,SAAS,CAAC,CAEjE,CAAC;YACd,MAAM,EAAE,KAAK,CACX,OAAO,KAAK,aAAa;gBACvB,CAAC,CAAC,0JAA0J;gBAC5J,CAAC,CAAC,0DAA0D,CAC/D,CAAC;QACJ,CAAC;IACH,CAAC;CACF"}

package/dist/src/doctor/agora_doctor.d.ts

@@ -0,0 +1,116 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/** The container binding the registry lives at. */
+export declare const AGORA_DOCTOR_BINDING = "agora.doctor";
+/** Bound as a VALUE under `'agora.doctor'`. Data only. */
+export interface AgoraDoctorRegistry {
+    readonly version: 1;
+    readonly checks: AgoraDoctorCheck[];
+}
+export type AgoraDoctorStatus = 'ok' | 'warn' | 'error' | 'skip';
+export interface AgoraDoctorCheck {
+    /** `'<lib>.<kebab>'`, unique and frozen for 1.x: `'durable.verify-tenant'`. */
+    id: string;
+    /** `'durable'`. The package is `@adonis-agora/<lib>` unless {@link package} says otherwise. */
+    lib: string;
+    /** The npm package, when it is not `@adonis-agora/<lib>`. */
+    package?: string;
+    title: string;
+    /** `'cheap'` (default) reads config, env and files only; `'deep'` touches a DB, Redis or the network. */
+    cost?: 'cheap' | 'deep';
+    run(app: ApplicationService): AgoraDoctorResult | AgoraDoctorResult[] | Promise<AgoraDoctorResult | AgoraDoctorResult[]>;
+}
+export interface AgoraDoctorResult {
+    status: AgoraDoctorStatus;
+    /** One line, no secrets, no stack. */
+    message: string;
+    /** One line: the exact change to make. */
+    fix?: string;
+    /** Absolute URL of the lib docs page. */
+    docs?: string;
+}
+/** One reported result. */
+export interface AgoraDoctorReportEntry extends AgoraDoctorResult {
+    id: string;
+    lib: string;
+    title: string;
+    ms: number;
+}
+/** What `agora:doctor --json` prints. */
+export interface AgoraDoctorReport {
+    version: 1;
+    env: string;
+    summary: Record<AgoraDoctorStatus, number>;
+    libs: Array<{
+        lib: string;
+        package: string;
+        version: string | null;
+    }>;
+    results: AgoraDoctorReportEntry[];
+}
+export interface AgoraDoctorOptions {
+    libs?: string[];
+    only?: string;
+    deep?: boolean;
+    /** The app was not booted (`--no-boot`): deep checks are reported as skipped, never run. */
+    noBoot?: boolean;
+    strict?: boolean;
+    /** Per-check budget in ms (default 5000, deep checks 15000). */
+    timeoutMs?: number;
+    deepTimeoutMs?: number;
+}
+/** A doctor problem that stops the run itself (exit 2). */
+export declare class AgoraDoctorUsageError extends Error {
+}
+interface ContainerLike {
+    hasBinding(binding: string): boolean;
+    bindValue(binding: string, value: unknown): void;
+    make(binding: string): Promise<unknown>;
+}
+/**
+ * Add a lib's checks to the app's doctor registry, creating it when absent. Call it from a provider's
+ * `boot()` (Adonis does not await `register()`, so an async registration there can be lost). A
+ * registry of another version is left alone; a duplicate id is skipped.
+ */
+export declare function registerDoctorChecks(container: ContainerLike, checks: readonly AgoraDoctorCheck[]): Promise<void>;
+/** The registered checks; throws {@link AgoraDoctorUsageError} on a registry of another version. */
+export declare function readDoctorChecks(container: ContainerLike): Promise<AgoraDoctorCheck[]>;
+/**
+ * The checks of every installed `@adonis-agora/*` package that publishes a `./doctor` entry
+ * (`export const agoraDoctorChecks`), imported from the app root without booting providers. A
+ * package whose entry fails to load is reported as an error (`<lib>.doctor-entry`), never skipped.
+ */
+export declare function discoverDoctorChecks(app: ApplicationService): Promise<AgoraDoctorCheck[]>;
+/** The directory of `name` as Node would find it from `from` (walking up `node_modules`), real path. */
+export declare function packageDir(name: string, from: string): Promise<string | null>;
+/** The installed version of `name` resolved from `from`, or `null` when it is not installed. */
+export declare function installedVersion(name: string, from: string): Promise<string | null>;
+/**
+ * Whether `version` satisfies `range`, with node-semver's grammar and prereleases included (like
+ * `semver.satisfies(version, range, { includePrerelease: true })`). An unparsable range is `false`.
+ */
+export declare function satisfies(version: string, range: string): boolean;
+/**
+ * The environment shown in the report, from the app itself: `production` when `app.inProduction`,
+ * `test` when `app.inTest`, else the app's node environment, and `development` when that is unset.
+ */
+export declare function environmentOf(app: Pick<ApplicationService, 'inProduction' | 'inTest' | 'nodeEnvironment'>): string;
+/** Run the checks and build the report. Throws {@link AgoraDoctorUsageError} for an unknown `--only`. */
+export declare function runAgoraDoctor(app: ApplicationService, registered: readonly AgoraDoctorCheck[], options?: AgoraDoctorOptions): Promise<{
+    report: AgoraDoctorReport;
+    exitCode: 0 | 1;
+}>;
+export interface Paint {
+    green(text: string): string;
+    yellow(text: string): string;
+    red(text: string): string;
+    dim(text: string): string;
+    bold(text: string): string;
+}
+/** The human report. `fancy` = colors and symbols (a TTY without `NO_COLOR`). */
+export declare function renderAgoraDoctor(report: AgoraDoctorReport, options?: {
+    verbose?: boolean;
+    fancy?: boolean;
+    paint?: Paint;
+}): string;
+export {};
+//# sourceMappingURL=agora_doctor.d.ts.map

package/dist/src/doctor/agora_doctor.d.ts.map

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