@adonis-agora/filter 1.0.0-rc.0 → 1.0.0-rc.2

package/CHANGELOG.md

@@ -1,5 +1,17 @@
 # @adonis-agora/filter
 
+## 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
+
+- [#145](https://github.com/DavideCarvalho/adonis-agora-filter/pull/145) [`7548c56`](https://github.com/DavideCarvalho/adonis-agora-filter/commit/7548c56e9ac622723ebcdca9a9253ef3068fdc2b) Thanks [@DavideCarvalho](https://github.com/DavideCarvalho)! - Dev MCP tools on `@adonis-agora/agent`'s `/mcp/agora` endpoint (gated by its `devTools.authorize`): `filter_list_specs`, `filter_get_spec`, `filter_explain_query` (dry run of a query string against a spec, no database). New exports `explainFilterQuery`, `parseQueryString` and `loadFilterManifest`; `make:filter-client` now also reads a default `{ filters }` export or `filters` in the `filter` config.
+
 ## 1.0.0-rc.0
 
 ### Major 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/commands/make_filter_client.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"make_filter_client.d.ts","sourceRoot":"","sources":["../../commands/make_filter_client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,WAAW,EAAS,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAI/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;;IACvD,OAAgB,WAAW,SAAwB;IACnD,OAAgB,WAAW,SAC4C;IACvE,OAAgB,OAAO,EAAE,cAAc,CAAsB;IAOrD,UAAU,EAAE,MAAM,CAAC;IAMnB,MAAM,EAAE,MAAM,CAAC;IAER,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAelC;CAuBF"}
+{"version":3,"file":"make_filter_client.d.ts","sourceRoot":"","sources":["../../commands/make_filter_client.ts"],"names":[],"mappings":"AAEA,OAAO,EAAQ,WAAW,EAAS,MAAM,oBAAoB,CAAC;AAC9D,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAK/D;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,MAAM,CAAC,OAAO,OAAO,gBAAiB,SAAQ,WAAW;;IACvD,OAAgB,WAAW,SAAwB;IACnD,OAAgB,WAAW,SAC4C;IACvE,OAAgB,OAAO,EAAE,cAAc,CAAsB;IAOrD,UAAU,EAAE,MAAM,CAAC;IAMnB,MAAM,EAAE,MAAM,CAAC;IAER,GAAG,IAAI,OAAO,CAAC,IAAI,CAAC,CAelC;CAiBF"}

package/dist/commands/make_filter_client.js

@@ -8,6 +8,7 @@ import { mkdir, writeFile } from 'node:fs/promises';
 import { isAbsolute, join } from 'node:path';
 import { args, BaseCommand, flags } from '@adonisjs/core/ace';
 import { generateFilterClients } from '../src/generate_client.js';
+import { loadFilterManifest } from '../src/manifest.js';
 /**
  * `node ace make:filter-client [entrypoint]` — the idiomatic AdonisJS equivalent
  * of the NestJS `nestjs-filter` codegen bin.
@@ -49,24 +50,19 @@ export default class MakeFilterClient extends BaseCommand {
         }
         this.logger.success(`Generated ${generated.length} filter client(s) into ${this.output}.`);
     }
-    /** Import the entrypoint module and read its `filters` manifest (named or default export). */
+    /** Load the `filters` manifest with the loader the doctor and the dev tools share. */
     async #loadManifest() {
-        const url = this.app.makeURL(this.entrypoint).href;
-        let mod;
-        try {
-            mod = (await import(url));
-        }
-        catch (error) {
-            this.logger.error(`Could not import filter manifest "${this.entrypoint}": ${String(error)}`);
+        const load = await loadFilterManifest(this.app, this.entrypoint);
+        if (load.status === 'loaded')
+            return load.manifest;
+        if (load.status === 'failed' || load.status === 'missing') {
+            const reason = load.status === 'failed' ? load.error : 'the module was not found';
+            this.logger.error(`Could not import filter manifest "${this.entrypoint}": ${reason}`);
             this.exitCode = 1;
             return undefined;
         }
-        const manifest = (mod.filters ?? mod.default);
-        if (!manifest || Object.keys(manifest).length === 0) {
-            this.logger.warning(`No \`filters\` manifest exported from "${this.entrypoint}" — nothing to generate.`);
-            return undefined;
-        }
-        return manifest;
+        this.logger.warning(`No \`filters\` manifest exported from "${this.entrypoint}" — nothing to generate.`);
+        return undefined;
     }
 }
 __decorate([

package/dist/commands/make_filter_client.js.map

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

package/dist/providers/filter_provider.d.ts

@@ -15,12 +15,16 @@ import type { ApplicationService } from '@adonisjs/core/types';
  * const page = await User.query().filterPaginate(userFilter, ctx)
  * ```
  *
+ * 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
  * (`applyFilterFromRequest`, `applyCursorFromRequest`) work without it — this
  * provider only adds the chainable sugar, so `@adonisjs/lucid` is loaded lazily
  * here (not a hard dependency of the package).
  */
 export default class FilterProvider {
+    #private;
     protected app: ApplicationService;
     constructor(app: ApplicationService);
     boot(): Promise<void>;

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;AAG/D;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,CAAC,OAAO,OAAO,cAAc;IACrB,SAAS,CAAC,GAAG,EAAE,kBAAkB;IAA7C,YAAsB,GAAG,EAAE,kBAAkB,EAAI;IAE3C,IAAI,kBAGT;CACF"}
+{"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,8 @@
+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';
 /**
  * Wires `@adonis-agora/filter`'s chainable Lucid macros into the application.
  *
@@ -15,6 +19,9 @@ import { registerFilterMacros } from '../src/lucid_macros.js';
  * const page = await User.query().filterPaginate(userFilter, ctx)
  * ```
  *
+ * 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
  * (`applyFilterFromRequest`, `applyCursorFromRequest`) work without it — this
  * provider only adds the chainable sugar, so `@adonisjs/lucid` is loaded lazily
@@ -26,8 +33,32 @@ 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();
+    }
+    /**
+     * Registers the filter developer tools on `@adonis-agora/agent`'s dev MCP endpoint
+     * (`/mcp/agora`) when it is installed. They read the `filters` manifest of config/filter.ts at
+     * call time.
+     */
+    async #registerDevTools() {
+        const container = this.app.container;
+        if (typeof container.hasBinding !== 'function')
+            return;
+        if (this.app.config.get('filter', {})?.devTools === false) {
+            return;
+        }
+        const outcome = await registerFilterDevTools(this.app.container, {
+            manifest: () => loadFilterManifest(this.app),
+        });
+        if (outcome === 'unsupported' || outcome === 'failed') {
+            const logger = (await this.app.container.make('logger').catch(() => undefined));
+            logger?.debug(outcome === 'unsupported'
+                ? '[@adonis-agora/filter] dev tools not registered: the installed @adonis-agora/agent cannot gate libs without a console (needs devTools.authorize support)'
+                : '[@adonis-agora/filter] dev tools could not be registered');
+        }
     }
 }
 //# sourceMappingURL=filter_provider.js.map

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,oBAAoB,EAAE,MAAM,wBAAwB,CAAC;AAE9D;;;;;;;;;;;;;;;;;;;;GAoBG;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;IAC1C,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/dev_tools/contract.d.ts

@@ -0,0 +1,61 @@
+/**
+ * A local, structural copy of the dev-tools registration contract (version 1) served by
+ * `@adonis-agora/agent`'s MCP provider at `/mcp/agora`. filter never imports the agent: it
+ * registers into the `'agora.devTools'` container binding when it exists.
+ *
+ * filter has no console, so it registers WITHOUT its own `authorize`: the endpoint-level
+ * `devTools.authorize` (config/mcp.ts) gates its tools. That needs a hub that says
+ * `supports('endpoint-authorize')`.
+ */
+/** The container binding the hub lives at. */
+export declare const DEV_TOOLS_BINDING = "agora.devTools";
+export interface DevToolsHub {
+    readonly version: 1;
+    register(lib: DevToolsLib): void;
+    /** Optional capability probe. filter needs `'endpoint-authorize'`. */
+    supports?(capability: string): boolean;
+}
+export interface DevToolsLib {
+    lib: string;
+    title: string;
+    /** Omitted: the endpoint's `devTools.authorize` decides. */
+    authorize?: (ctx: unknown) => Promise<unknown>;
+    tools: DevTool[];
+}
+export interface DevToolInputProperty {
+    type: 'string' | 'number' | 'integer' | 'boolean' | 'array';
+    description?: string;
+    enum?: readonly string[];
+    items?: {
+        type: 'string';
+    };
+    minimum?: number;
+    maximum?: number;
+}
+export interface DevToolInputSchema {
+    type: 'object';
+    properties: Record<string, DevToolInputProperty>;
+    required?: string[];
+}
+export interface DevToolsCaller {
+    id: string;
+    via: 'token' | 'session' | 'open';
+}
+export interface DevToolCall {
+    ctx: unknown;
+    caller: DevToolsCaller;
+    limits: {
+        maxRows: number;
+        maxBytes: number;
+    };
+}
+export interface DevTool {
+    name: string;
+    kind: 'read' | 'action';
+    description: string;
+    input: DevToolInputSchema;
+    destructive?: boolean;
+    available?(): boolean | Promise<boolean>;
+    run(input: Record<string, unknown>, call: DevToolCall): Promise<unknown>;
+}
+//# sourceMappingURL=contract.d.ts.map

package/dist/src/dev_tools/contract.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.d.ts","sourceRoot":"","sources":["../../../src/dev_tools/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8CAA8C;AAC9C,eAAO,MAAM,iBAAiB,mBAAmB,CAAC;AAElD,MAAM,WAAW,WAAW;IAC1B,QAAQ,CAAC,OAAO,EAAE,CAAC,CAAC;IACpB,QAAQ,CAAC,GAAG,EAAE,WAAW,GAAG,IAAI,CAAC;IACjC,sEAAsE;IACtE,QAAQ,CAAC,CAAC,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC;CACxC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,4DAA4D;IAC5D,SAAS,CAAC,EAAE,CAAC,GAAG,EAAE,OAAO,KAAK,OAAO,CAAC,OAAO,CAAC,CAAC;IAC/C,KAAK,EAAE,OAAO,EAAE,CAAC;CAClB;AAED,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,SAAS,GAAG,OAAO,CAAC;IAC5D,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;IACzB,KAAK,CAAC,EAAE;QAAE,IAAI,EAAE,QAAQ,CAAA;KAAE,CAAC;IAC3B,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED,MAAM,WAAW,kBAAkB;IACjC,IAAI,EAAE,QAAQ,CAAC;IACf,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,oBAAoB,CAAC,CAAC;IACjD,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;CACrB;AAED,MAAM,WAAW,cAAc;IAC7B,EAAE,EAAE,MAAM,CAAC;IACX,GAAG,EAAE,OAAO,GAAG,SAAS,GAAG,MAAM,CAAC;CACnC;AAED,MAAM,WAAW,WAAW;IAC1B,GAAG,EAAE,OAAO,CAAC;IACb,MAAM,EAAE,cAAc,CAAC;IACvB,MAAM,EAAE;QAAE,OAAO,EAAE,MAAM,CAAC;QAAC,QAAQ,EAAE,MAAM,CAAA;KAAE,CAAC;CAC/C;AAED,MAAM,WAAW,OAAO;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,QAAQ,CAAC;IACxB,WAAW,EAAE,MAAM,CAAC;IACpB,KAAK,EAAE,kBAAkB,CAAC;IAC1B,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,SAAS,CAAC,IAAI,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IACzC,GAAG,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,EAAE,IAAI,EAAE,WAAW,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;CAC1E"}

package/dist/src/dev_tools/contract.js

@@ -0,0 +1,12 @@
+/**
+ * A local, structural copy of the dev-tools registration contract (version 1) served by
+ * `@adonis-agora/agent`'s MCP provider at `/mcp/agora`. filter never imports the agent: it
+ * registers into the `'agora.devTools'` container binding when it exists.
+ *
+ * filter has no console, so it registers WITHOUT its own `authorize`: the endpoint-level
+ * `devTools.authorize` (config/mcp.ts) gates its tools. That needs a hub that says
+ * `supports('endpoint-authorize')`.
+ */
+/** The container binding the hub lives at. */
+export const DEV_TOOLS_BINDING = 'agora.devTools';
+//# sourceMappingURL=contract.js.map

package/dist/src/dev_tools/contract.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"contract.js","sourceRoot":"","sources":["../../../src/dev_tools/contract.ts"],"names":[],"mappings":"AAAA;;;;;;;;GAQG;AAEH,8CAA8C;AAC9C,MAAM,CAAC,MAAM,iBAAiB,GAAG,gBAAgB,CAAC"}

package/dist/src/dev_tools/explain.d.ts

@@ -0,0 +1,88 @@
+import type { FilterSpec } from '../filter_spec.js';
+import type { QueryBuilderLike } from '../lucid_adapter.js';
+import type { FilterInput } from '../types.js';
+/** One query-builder call a dry run recorded. */
+export interface RecordedCall {
+    method: string;
+    args: unknown[];
+}
+/** What a request part (one filter, one sort…) does under the spec. */
+export interface ExplainIssue {
+    part: 'filter' | 'sort' | 'distinct' | 'search' | 'size';
+    /** The field (or the raw value) the issue is about. */
+    subject: string;
+    message: string;
+    /** `rejected`: the request fails; `dropped`: silently ignored; `clamped`/`ignored`: adjusted. */
+    effect: 'rejected' | 'dropped' | 'clamped' | 'ignored';
+}
+/** The result of {@link explainFilterQuery}. */
+export interface FilterQueryExplanation {
+    /** What the query string decodes to (`ctx.request.qs()`). */
+    decoded: Record<string, unknown>;
+    /** The filters, sorts, search and pagination the server reads from it. */
+    parsed: FilterInput;
+    /** `true` when the request would be refused (a 4xx from `InvalidColumnFilterError`). */
+    rejected: boolean;
+    rejection: string | null;
+    issues: ExplainIssue[];
+    /** The query-builder calls the request filters, search and sort produce (no tenant scope). */
+    calls: RecordedCall[];
+    pagination: {
+        page: number;
+        size: number;
+    } | null;
+    /** What the server adds on its own, outside the client's control. */
+    serverScope: {
+        tenantColumn: string | null;
+        defaultFilters: unknown[];
+    };
+}
+/**
+ * A query builder that records every call instead of running SQL: the dry-run target. Callback
+ * arguments (sub-queries, `whereHas`) are run against a nested recorder and kept as `calls`.
+ */
+export declare function recordingBuilder(calls?: RecordedCall[]): {
+    qb: QueryBuilderLike;
+    calls: RecordedCall[];
+};
+/**
+ * Dry-run a query string against a spec, through the same parse, alias, validation, allow-list
+ * and builder code a request runs, with no database: what is kept, what is dropped or refused, and
+ * the builder calls it would make.
+ */
+export declare function explainFilterQuery(spec: FilterSpec, query: string): FilterQueryExplanation;
+/** The spec as data: allow-lists with field types and operators, relations and defaults. */
+export declare function describeSpec(spec: FilterSpec, name: string): {
+    name: string;
+    filterable: import("../filter_spec.js").RelationColumns;
+    sortable: import("../filter_spec.js").RelationColumns;
+    /** Every filterable path, relation-dotted (`'*'` lists contribute none). */
+    filterablePaths: string[];
+    sortablePaths: string[];
+    operators: import("../operators.js").FilterOperator[];
+    operatorAliases: {
+        [x: string]: import("../operators.js").FilterOperator;
+    };
+    searchable: string[];
+    fullText: {
+        column: string | readonly string[];
+    } | null;
+    fieldTypes: Readonly<Record<string, import("../generate_client.js").FilterFieldTypeInfo>>;
+    relations: Record<string, {
+        filterable: unknown;
+        sortable: unknown;
+        relations: unknown;
+    }>;
+    maxDepth: number;
+    aliases: import("../field_aliases.js").FieldAliases;
+    computed: {
+        [k: string]: string;
+    };
+    tenantColumn: string | null;
+    defaultFilters: unknown[];
+    defaultSort: import("../types.js").SortItem[];
+    defaultSize: number | null;
+    maxSize: number | null;
+    throwOnInvalid: boolean;
+};
+//# sourceMappingURL=explain.d.ts.map

package/dist/src/dev_tools/explain.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"explain.d.ts","sourceRoot":"","sources":["../../../src/dev_tools/explain.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,mBAAmB,CAAC;AAGpD,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,qBAAqB,CAAC;AAI5D,OAAO,KAAK,EAAgB,WAAW,EAAE,MAAM,aAAa,CAAC;AAG7D,iDAAiD;AACjD,MAAM,WAAW,YAAY;IAC3B,MAAM,EAAE,MAAM,CAAC;IACf,IAAI,EAAE,OAAO,EAAE,CAAC;CACjB;AAED,uEAAuE;AACvE,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,QAAQ,GAAG,MAAM,GAAG,UAAU,GAAG,QAAQ,GAAG,MAAM,CAAC;IACzD,uDAAuD;IACvD,OAAO,EAAE,MAAM,CAAC;IAChB,OAAO,EAAE,MAAM,CAAC;IAChB,iGAAiG;IACjG,MAAM,EAAE,UAAU,GAAG,SAAS,GAAG,SAAS,GAAG,SAAS,CAAC;CACxD;AAED,gDAAgD;AAChD,MAAM,WAAW,sBAAsB;IACrC,6DAA6D;IAC7D,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACjC,0EAA0E;IAC1E,MAAM,EAAE,WAAW,CAAC;IACpB,wFAAwF;IACxF,QAAQ,EAAE,OAAO,CAAC;IAClB,SAAS,EAAE,MAAM,GAAG,IAAI,CAAC;IACzB,MAAM,EAAE,YAAY,EAAE,CAAC;IACvB,8FAA8F;IAC9F,KAAK,EAAE,YAAY,EAAE,CAAC;IACtB,UAAU,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,GAAG,IAAI,CAAC;IAClD,qEAAqE;IACrE,WAAW,EAAE;QAAE,YAAY,EAAE,MAAM,GAAG,IAAI,CAAC;QAAC,cAAc,EAAE,OAAO,EAAE,CAAA;KAAE,CAAC;CACzE;AAgBD;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,GAAE,YAAY,EAAO,GAAG;IAC5D,EAAE,EAAE,gBAAgB,CAAC;IACrB,KAAK,EAAE,YAAY,EAAE,CAAC;CACvB,CAiBA;AAWD;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,EAAE,MAAM,GAAG,sBAAsB,CAkE1F;AAED,4FAA4F;AAC5F,wBAAgB,YAAY,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,EAAE,MAAM;;;;IAKvD,4EAA4E;;;;;;;;;;;;;oBA8BhD,OAAO;kBAAY,OAAO;mBAAa,OAAO;;;;;;;;;;;;;EAJ7E"}