@adonis-agora/filter 0.0.0-beta-20261110131309

package/dist/commands/make_filter_client.d.ts

@@ -0,0 +1,35 @@
+import { BaseCommand } from '@adonisjs/core/ace';
+import type { CommandOptions } from '@adonisjs/core/types/ace';
+/**
+ * `node ace make:filter-client [entrypoint]` — the idiomatic AdonisJS equivalent
+ * of the NestJS `nestjs-filter` codegen bin.
+ *
+ * Where NestJS ships a standalone `reflect-metadata` bin that reads decorator
+ * metadata off entity classes, the Adonis filter declaration is already a plain
+ * runtime {@link FilterClientManifest} (`defineFilter(...)` specs), so this is a
+ * thin IO wrapper: it loads the app's declared `filters` manifest, hands it to
+ * the pure {@link generateFilterClients} core, and writes each emitted typed
+ * client to disk. All generation logic lives in `../src/generate_client.ts` and
+ * is unit-tested there — this command only does the file IO.
+ *
+ * The entrypoint module (default `config/filter.js`) must export a `filters`
+ * manifest (named export, or default):
+ *
+ * ```ts
+ * // config/filter.ts
+ * import { defineFilter } from '@adonis-agora/filter'
+ * export const filters = {
+ *   people: { spec: defineFilter({ filterable: ['name', 'age'] }), fieldTypes: { age: { kind: 'number' } } },
+ * }
+ * ```
+ */
+export default class MakeFilterClient extends BaseCommand {
+    #private;
+    static commandName: string;
+    static description: string;
+    static options: CommandOptions;
+    entrypoint: string;
+    output: string;
+    run(): Promise<void>;
+}
+//# sourceMappingURL=make_filter_client.d.ts.map

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

@@ -0,0 +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"}

package/dist/commands/make_filter_client.js

@@ -0,0 +1,85 @@
+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 { 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';
+/**
+ * `node ace make:filter-client [entrypoint]` — the idiomatic AdonisJS equivalent
+ * of the NestJS `nestjs-filter` codegen bin.
+ *
+ * Where NestJS ships a standalone `reflect-metadata` bin that reads decorator
+ * metadata off entity classes, the Adonis filter declaration is already a plain
+ * runtime {@link FilterClientManifest} (`defineFilter(...)` specs), so this is a
+ * thin IO wrapper: it loads the app's declared `filters` manifest, hands it to
+ * the pure {@link generateFilterClients} core, and writes each emitted typed
+ * client to disk. All generation logic lives in `../src/generate_client.ts` and
+ * is unit-tested there — this command only does the file IO.
+ *
+ * The entrypoint module (default `config/filter.js`) must export a `filters`
+ * manifest (named export, or default):
+ *
+ * ```ts
+ * // config/filter.ts
+ * import { defineFilter } from '@adonis-agora/filter'
+ * export const filters = {
+ *   people: { spec: defineFilter({ filterable: ['name', 'age'] }), fieldTypes: { age: { kind: 'number' } } },
+ * }
+ * ```
+ */
+export default class MakeFilterClient extends BaseCommand {
+    static commandName = 'make:filter-client';
+    static description = "Generate typed filter clients from the app's declared filter specs";
+    static options = { startApp: true };
+    async run() {
+        const manifest = await this.#loadManifest();
+        if (!manifest)
+            return;
+        const outDir = isAbsolute(this.output) ? this.output : this.app.makePath(this.output);
+        await mkdir(outDir, { recursive: true });
+        const generated = generateFilterClients(manifest);
+        for (const client of generated) {
+            const path = join(outDir, client.filename);
+            await writeFile(path, client.code, 'utf-8');
+            this.logger.action(`create ${path}`).succeeded();
+        }
+        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). */
+    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)}`);
+            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;
+    }
+}
+__decorate([
+    args.string({
+        description: 'Module exporting a `filters` manifest',
+        required: false,
+        default: 'config/filter.js',
+    })
+], MakeFilterClient.prototype, "entrypoint", void 0);
+__decorate([
+    flags.string({
+        description: 'Output directory for the generated clients',
+        default: 'app/generated/filters',
+    })
+], MakeFilterClient.prototype, "output", void 0);
+//# sourceMappingURL=make_filter_client.js.map

package/dist/commands/make_filter_client.js.map

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

package/dist/configure.d.ts

@@ -0,0 +1,15 @@
+import type Configure from '@adonisjs/core/commands/configure';
+/**
+ * `node ace add @adonis-agora/filter` (or `node ace configure @adonis-agora/filter`)
+ * — auto-wires the package into an AdonisJS app:
+ *
+ * 1. registers the service provider in `adonisrc.ts`, which installs the
+ *    chainable `applyFilterFromRequest` / `filterPaginate` Lucid macros;
+ * 2. registers the ace commands barrel, which is what makes `make:filter-client`
+ *    show up in `node ace list`.
+ *
+ * There is no config file to publish: a filter policy is a per-model
+ * `defineFilterSpec` call in your own code, not global configuration.
+ */
+export declare function configure(command: Configure): Promise<void>;
+//# sourceMappingURL=configure.d.ts.map

package/dist/configure.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.d.ts","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,SAAS,MAAM,mCAAmC,CAAC;AAE/D;;;;;;;;;;;GAWG;AACH,wBAAsB,SAAS,CAAC,OAAO,EAAE,SAAS,iBAOjD"}

package/dist/configure.js

@@ -0,0 +1,20 @@
+/**
+ * `node ace add @adonis-agora/filter` (or `node ace configure @adonis-agora/filter`)
+ * — auto-wires the package into an AdonisJS app:
+ *
+ * 1. registers the service provider in `adonisrc.ts`, which installs the
+ *    chainable `applyFilterFromRequest` / `filterPaginate` Lucid macros;
+ * 2. registers the ace commands barrel, which is what makes `make:filter-client`
+ *    show up in `node ace list`.
+ *
+ * There is no config file to publish: a filter policy is a per-model
+ * `defineFilterSpec` call in your own code, not global configuration.
+ */
+export async function configure(command) {
+    const codemods = await command.createCodemods();
+    await codemods.updateRcFile((rcFile) => {
+        rcFile.addProvider('@adonis-agora/filter/filter_provider');
+        rcFile.addCommand('@adonis-agora/filter/commands');
+    });
+}
+//# sourceMappingURL=configure.js.map

package/dist/configure.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"configure.js","sourceRoot":"","sources":["../configure.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,OAAkB;IAChD,MAAM,QAAQ,GAAG,MAAM,OAAO,CAAC,cAAc,EAAE,CAAC;IAEhD,MAAM,QAAQ,CAAC,YAAY,CAAC,CAAC,MAAM,EAAE,EAAE;QACrC,MAAM,CAAC,WAAW,CAAC,sCAAsC,CAAC,CAAC;QAC3D,MAAM,CAAC,UAAU,CAAC,+BAA+B,CAAC,CAAC;IACrD,CAAC,CAAC,CAAC;AACL,CAAC"}

package/dist/providers/filter_provider.d.ts

@@ -0,0 +1,28 @@
+import type { ApplicationService } from '@adonisjs/core/types';
+/**
+ * Wires `@adonis-agora/filter`'s chainable Lucid macros into the application.
+ *
+ * On boot it registers the `applyFilterFromRequest` and `filterPaginate` macros
+ * onto Lucid's `ModelQueryBuilder`, so any model query gains the method-call form
+ * of the free `applyFilterFromRequest` helper:
+ *
+ * ```ts
+ * const rows = await User.query()
+ *   .where('tenantId', tenant.id)
+ *   .applyFilterFromRequest(userFilter, ctx)
+ *   .orderBy('createdAt', 'desc')
+ *
+ * const page = await User.query().filterPaginate(userFilter, ctx)
+ * ```
+ *
+ * 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 {
+    protected app: ApplicationService;
+    constructor(app: ApplicationService);
+    boot(): Promise<void>;
+}
+//# sourceMappingURL=filter_provider.d.ts.map

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

@@ -0,0 +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"}

package/dist/providers/filter_provider.js

@@ -0,0 +1,33 @@
+import { registerFilterMacros } from '../src/lucid_macros.js';
+/**
+ * Wires `@adonis-agora/filter`'s chainable Lucid macros into the application.
+ *
+ * On boot it registers the `applyFilterFromRequest` and `filterPaginate` macros
+ * onto Lucid's `ModelQueryBuilder`, so any model query gains the method-call form
+ * of the free `applyFilterFromRequest` helper:
+ *
+ * ```ts
+ * const rows = await User.query()
+ *   .where('tenantId', tenant.id)
+ *   .applyFilterFromRequest(userFilter, ctx)
+ *   .orderBy('createdAt', 'desc')
+ *
+ * const page = await User.query().filterPaginate(userFilter, ctx)
+ * ```
+ *
+ * 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 {
+    app;
+    constructor(app) {
+        this.app = app;
+    }
+    async boot() {
+        const { ModelQueryBuilder } = await import('@adonisjs/lucid/orm');
+        registerFilterMacros(ModelQueryBuilder);
+    }
+}
+//# sourceMappingURL=filter_provider.js.map

package/dist/providers/filter_provider.js.map

@@ -0,0 +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"}

package/dist/src/aggregate.d.ts

@@ -0,0 +1,70 @@
+import type { RelationSpec } from './filter_spec.js';
+import type { ColumnFilter } from './operators.js';
+import type { ComputedFields, ComputedSource } from './types.js';
+/**
+ * The structural slice of a booted Lucid relation the aggregate-subquery
+ * compiler reads. A real `@adonisjs/lucid` `HasMany` / `ManyToMany` relation
+ * satisfies it — declared locally so this module never hard-imports Lucid. The
+ * key-column fields are optional because they differ by relation kind
+ * (one-to-many exposes `foreignKeyColumnName`; many-to-many exposes the pivot
+ * fields), and only the relevant ones are read per kind.
+ */
+export interface LucidRelationLike {
+    /** Relation kind — `'hasMany'` / `'manyToMany'` are the to-many kinds we correlate. */
+    type: string;
+    /** Compute the relation's key columns from the naming strategy (idempotent). */
+    boot(): void;
+    /** The related (child) model — its `table` is the child table name. */
+    relatedModel(): {
+        table?: string;
+    };
+    foreignKeyColumnName?: string;
+    localKeyColumnName?: string;
+    relatedKeyColumnName?: string;
+    pivotTable?: string;
+    pivotForeignKey?: string;
+    pivotRelatedForeignKey?: string;
+}
+/**
+ * The structural slice of a Lucid model the aggregate discovery reads: its table
+ * name and a relation accessor. `$getRelation` is typed with `any` for the same
+ * reason `QueryBuilderLike.whereHas` is — Lucid types it with a generic
+ * literal-union `Name`, and `string` is not assignable to that union, so a
+ * narrower signature would make every real model fail to satisfy this interface.
+ */
+export interface LucidModelLike {
+    table?: string;
+    $getRelation(name: any): LucidRelationLike | undefined;
+}
+/**
+ * The `EXISTS` / `NOT EXISTS` predicate equivalent to a filter on a discovered
+ * `$count` field, when the filter only asks whether the collection is empty:
+ * `gt 0`, `gte 1` and `notEquals 0` mean non-empty; `equals 0`, `lte 0` and
+ * `lt 1` mean empty. `EXISTS` stops at the first related row where the counting
+ * subquery visits all of them. `undefined` for any other filter or source.
+ */
+export declare function countExistencePredicate(source: ComputedSource, alias: string, filter: ColumnFilter): string | undefined;
+/**
+ * Discover to-many aggregate {@link ComputedSource}s from a Lucid model's
+ * relation metadata, for the relations the spec whitelisted. For each declared
+ * to-many relation (hasMany / manyToMany) this synthesises:
+ *
+ * - `<rel>.$count` — always;
+ * - `<rel>.$sum|$avg|$min|$max.<col>` — one per column the relation's
+ *   {@link RelationSpec.aggregates} declares (Lucid does not reflect SQL column
+ *   types, so the dev asserts numeric-ness by listing the column there).
+ *
+ * To-one relations (belongsTo / hasOne) are excluded. The whole thing degrades
+ * gracefully: a relation that is not on the model, is to-one, or cannot be
+ * booted (e.g. no DB adapter yet) is simply skipped, and a model without the
+ * introspection capability yields an empty map — so aggregates activate only
+ * when the metadata is actually available.
+ *
+ * The result is merged into the spec's `computed` map, so aggregate fields ARE
+ * computed fields with auto-generated correlated-subquery sources — they reuse
+ * the exact same runner routing, allow-list bypass (their discovery IS their
+ * allow-list, gated by the relation whitelist), injection-safe value binding,
+ * and codegen surfacing.
+ */
+export declare function discoverAggregateSources(model: LucidModelLike | undefined, relations: Readonly<Record<string, RelationSpec>>): ComputedFields;
+//# sourceMappingURL=aggregate.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate.d.ts","sourceRoot":"","sources":["../../src/aggregate.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACrD,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAmB,cAAc,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAGlF;;;;;;;GAOG;AACH,MAAM,WAAW,iBAAiB;IAChC,uFAAuF;IACvF,IAAI,EAAE,MAAM,CAAC;IACb,gFAAgF;IAChF,IAAI,IAAI,IAAI,CAAC;IACb,uEAAuE;IACvE,YAAY,IAAI;QAAE,KAAK,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAEnC,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,kBAAkB,CAAC,EAAE,MAAM,CAAC;IAE5B,oBAAoB,CAAC,EAAE,MAAM,CAAC;IAC9B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,eAAe,CAAC,EAAE,MAAM,CAAC;IACzB,sBAAsB,CAAC,EAAE,MAAM,CAAC;CACjC;AAED;;;;;;GAMG;AACH,MAAM,WAAW,cAAc;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IAEf,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,iBAAiB,GAAG,SAAS,CAAC;CACxD;AAsBD;;;;;;GAMG;AACH,wBAAgB,uBAAuB,CACrC,MAAM,EAAE,cAAc,EACtB,KAAK,EAAE,MAAM,EACb,MAAM,EAAE,YAAY,GACnB,MAAM,GAAG,SAAS,CA6BpB;AAqFD;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,wBAAwB,CACtC,KAAK,EAAE,cAAc,GAAG,SAAS,EACjC,SAAS,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC,GAChD,cAAc,CA8DhB"}

package/dist/src/aggregate.js

@@ -0,0 +1,195 @@
+import { normalizeOperator } from './validate-column-filter.js';
+/** Column functions (need a numeric child column); `count` needs none. */
+const COLUMN_FNS = ['sum', 'avg', 'min', 'max'];
+/** Double-quote one identifier segment for Postgres, escaping embedded quotes. */
+function q(ident) {
+    return `"${ident.replace(/"/g, '""')}"`;
+}
+/**
+ * The correlated `FROM … WHERE <correlation>` clause behind each discovered
+ * `$count` source. Keyed by the source function, so a hand-written computed
+ * field never has one.
+ */
+const countRowSets = new WeakMap();
+/** Is `value` the integer `n`, as a number or as the string a query parameter carries? */
+function isInteger(value, n) {
+    return value === n || value === String(n);
+}
+/**
+ * The `EXISTS` / `NOT EXISTS` predicate equivalent to a filter on a discovered
+ * `$count` field, when the filter only asks whether the collection is empty:
+ * `gt 0`, `gte 1` and `notEquals 0` mean non-empty; `equals 0`, `lte 0` and
+ * `lt 1` mean empty. `EXISTS` stops at the first related row where the counting
+ * subquery visits all of them. `undefined` for any other filter or source.
+ */
+export function countExistencePredicate(source, alias, filter) {
+    if (typeof source !== 'function')
+        return undefined;
+    const rowSet = countRowSets.get(source);
+    if (!rowSet)
+        return undefined;
+    const value = filter.value;
+    let exists;
+    switch (normalizeOperator(filter.operator)) {
+        case 'gt':
+        case 'notEquals':
+            if (!isInteger(value, 0))
+                return undefined;
+            exists = true;
+            break;
+        case 'gte':
+            if (!isInteger(value, 1))
+                return undefined;
+            exists = true;
+            break;
+        case 'equals':
+        case 'lte':
+            if (!isInteger(value, 0))
+                return undefined;
+            exists = false;
+            break;
+        case 'lt':
+            if (!isInteger(value, 1))
+                return undefined;
+            exists = false;
+            break;
+        default:
+            return undefined;
+    }
+    return `${exists ? 'EXISTS' : 'NOT EXISTS'} (SELECT 1 ${rowSet({ alias })})`;
+}
+/** A `$count` source over the rows `rowSet` (`FROM … WHERE …`) selects. */
+function countSource(rowSet) {
+    const source = (ctx) => `(SELECT COUNT(*) ${rowSet(ctx)})`;
+    countRowSets.set(source, rowSet);
+    return source;
+}
+/**
+ * The scalar aggregate expression over an (already-quoted) child column. Empty
+ * collection semantics: `sum` coalesces to 0; `avg`/`min`/`max` stay NULL (their
+ * natural result over zero rows); `count` is naturally 0.
+ */
+function aggregateExpr(fn, quotedColumn) {
+    switch (fn) {
+        case 'count':
+            return 'COUNT(*)';
+        case 'sum':
+            return `COALESCE(SUM(${quotedColumn}),0)`;
+        case 'avg':
+            return `AVG(${quotedColumn})`;
+        case 'min':
+            return `MIN(${quotedColumn})`;
+        case 'max':
+            return `MAX(${quotedColumn})`;
+    }
+}
+/**
+ * ONE_TO_MANY correlation: a direct FK on the child row points back at the
+ * root's PK. `column` omitted → `$count`.
+ *
+ *   (SELECT <agg> FROM "child" WHERE "child"."fk" = "<alias>"."pk")
+ */
+function oneToManySource(fn, childTable, fk, pk, column) {
+    if (fn === 'count') {
+        return countSource(({ alias }) => `FROM ${q(childTable)} WHERE ${q(childTable)}.${q(fk)} = ${q(alias)}.${q(pk)}`);
+    }
+    const agg = aggregateExpr(fn, column ? `${q(childTable)}.${q(column)}` : '');
+    return ({ alias }) => `(SELECT ${agg} FROM ${q(childTable)} WHERE ${q(childTable)}.${q(fk)} = ${q(alias)}.${q(pk)})`;
+}
+/**
+ * MANY_TO_MANY correlation, mediated by a pivot table. `$count` counts pivot
+ * rows directly; the column functions JOIN pivot → child INSIDE the scalar
+ * subquery to reach the child column.
+ *
+ *   $count: (SELECT COUNT(*) FROM "pivot" WHERE "pivot"."ownerFk" = "<alias>"."ownerPk")
+ *   $agg:   (SELECT <agg> FROM "child"
+ *             JOIN "pivot" ON "child"."childPk" = "pivot"."inverseFk"
+ *             WHERE "pivot"."ownerFk" = "<alias>"."ownerPk")
+ */
+function manyToManySource(fn, meta, column) {
+    if (fn === 'count') {
+        return countSource(({ alias }) => `FROM ${q(meta.pivot)} WHERE ${q(meta.pivot)}.${q(meta.ownerFk)} = ${q(alias)}.${q(meta.ownerPk)}`);
+    }
+    const agg = aggregateExpr(fn, column ? `${q(meta.childTable)}.${q(column)}` : '');
+    return ({ alias }) => `(SELECT ${agg} FROM ${q(meta.childTable)} JOIN ${q(meta.pivot)} ON ${q(meta.childTable)}.${q(meta.childPk)} = ${q(meta.pivot)}.${q(meta.inverseFk)} WHERE ${q(meta.pivot)}.${q(meta.ownerFk)} = ${q(alias)}.${q(meta.ownerPk)})`;
+}
+/**
+ * Discover to-many aggregate {@link ComputedSource}s from a Lucid model's
+ * relation metadata, for the relations the spec whitelisted. For each declared
+ * to-many relation (hasMany / manyToMany) this synthesises:
+ *
+ * - `<rel>.$count` — always;
+ * - `<rel>.$sum|$avg|$min|$max.<col>` — one per column the relation's
+ *   {@link RelationSpec.aggregates} declares (Lucid does not reflect SQL column
+ *   types, so the dev asserts numeric-ness by listing the column there).
+ *
+ * To-one relations (belongsTo / hasOne) are excluded. The whole thing degrades
+ * gracefully: a relation that is not on the model, is to-one, or cannot be
+ * booted (e.g. no DB adapter yet) is simply skipped, and a model without the
+ * introspection capability yields an empty map — so aggregates activate only
+ * when the metadata is actually available.
+ *
+ * The result is merged into the spec's `computed` map, so aggregate fields ARE
+ * computed fields with auto-generated correlated-subquery sources — they reuse
+ * the exact same runner routing, allow-list bypass (their discovery IS their
+ * allow-list, gated by the relation whitelist), injection-safe value binding,
+ * and codegen surfacing.
+ */
+export function discoverAggregateSources(model, relations) {
+    if (!model || typeof model.$getRelation !== 'function')
+        return {};
+    const out = {};
+    for (const [relName, relSpec] of Object.entries(relations)) {
+        let rel;
+        try {
+            rel = model.$getRelation(relName);
+            if (!rel)
+                continue;
+            rel.boot();
+        }
+        catch {
+            continue; // Un-bootable relation (no adapter yet, etc.) → skip its aggregates.
+        }
+        const columns = relSpec.aggregates ?? [];
+        const childTable = rel.relatedModel?.().table;
+        if (rel.type === 'hasMany') {
+            const fk = rel.foreignKeyColumnName;
+            const pk = rel.localKeyColumnName;
+            if (!childTable || !fk || !pk)
+                continue;
+            out[`${relName}.$count`] = oneToManySource('count', childTable, fk, pk, undefined);
+            for (const col of columns) {
+                for (const fn of COLUMN_FNS) {
+                    out[`${relName}.$${fn}.${col}`] = oneToManySource(fn, childTable, fk, pk, col);
+                }
+            }
+        }
+        else if (rel.type === 'manyToMany') {
+            const pivot = rel.pivotTable;
+            const ownerFk = rel.pivotForeignKey;
+            const inverseFk = rel.pivotRelatedForeignKey;
+            const ownerPk = rel.localKeyColumnName;
+            const childPk = rel.relatedKeyColumnName;
+            if (!pivot || !ownerFk || !ownerPk)
+                continue;
+            out[`${relName}.$count`] = manyToManySource('count', {
+                childTable: childTable ?? '',
+                childPk: childPk ?? '',
+                pivot,
+                ownerFk,
+                inverseFk: inverseFk ?? '',
+                ownerPk,
+            }, undefined);
+            if (childTable && inverseFk && childPk) {
+                for (const col of columns) {
+                    for (const fn of COLUMN_FNS) {
+                        out[`${relName}.$${fn}.${col}`] = manyToManySource(fn, { childTable, childPk, pivot, ownerFk, inverseFk, ownerPk }, col);
+                    }
+                }
+            }
+        }
+        // to-one (belongsTo / hasOne) and any other kind → no aggregate keys.
+    }
+    return out;
+}
+//# sourceMappingURL=aggregate.js.map

package/dist/src/aggregate.js.map

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

package/dist/src/aggregate_path.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Pure, ORM-agnostic parser for to-many aggregate field paths — a verbatim port
+ * of the NestJS `nestjs-filter` `aggregate/aggregate-path.ts` (commit 3f21e1f).
+ * It only parses the client-facing field *string* into a structured
+ * {@link AggregatePath}; turning that into SQL (a correlated subquery) is the
+ * Lucid-specific compiler's job (see `filter_spec.ts` aggregate discovery).
+ */
+export type AggregateFn = 'count' | 'sum' | 'avg' | 'min' | 'max';
+export interface AggregatePath {
+    relation: string;
+    fn: AggregateFn;
+    column?: string;
+}
+/**
+ * Parses a to-many aggregate field path.
+ *
+ * Grammar (single relation hop only):
+ * - `<relation>.$count`              → { relation, fn: 'count' }
+ * - `<relation>.$<fn>.<childColumn>` → { relation, fn, column } for fn in sum|avg|min|max
+ *
+ * Returns `null` for anything else so callers can fall through to
+ * non-aggregate field handling instead of throwing.
+ */
+export declare function parseAggregatePath(path: string): AggregatePath | null;
+//# sourceMappingURL=aggregate_path.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate_path.d.ts","sourceRoot":"","sources":["../../src/aggregate_path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,MAAM,MAAM,WAAW,GAAG,OAAO,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,GAAG,KAAK,CAAC;AAClE,MAAM,WAAW,aAAa;IAC5B,QAAQ,EAAE,MAAM,CAAC;IACjB,EAAE,EAAE,WAAW,CAAC;IAChB,MAAM,CAAC,EAAE,MAAM,CAAC;CACjB;AAID;;;;;;;;;GASG;AACH,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,MAAM,GAAG,aAAa,GAAG,IAAI,CAWrE"}

package/dist/src/aggregate_path.js

@@ -0,0 +1,35 @@
+/**
+ * Pure, ORM-agnostic parser for to-many aggregate field paths — a verbatim port
+ * of the NestJS `nestjs-filter` `aggregate/aggregate-path.ts` (commit 3f21e1f).
+ * It only parses the client-facing field *string* into a structured
+ * {@link AggregatePath}; turning that into SQL (a correlated subquery) is the
+ * Lucid-specific compiler's job (see `filter_spec.ts` aggregate discovery).
+ */
+const COLUMN_FNS = new Set(['sum', 'avg', 'min', 'max']);
+/**
+ * Parses a to-many aggregate field path.
+ *
+ * Grammar (single relation hop only):
+ * - `<relation>.$count`              → { relation, fn: 'count' }
+ * - `<relation>.$<fn>.<childColumn>` → { relation, fn, column } for fn in sum|avg|min|max
+ *
+ * Returns `null` for anything else so callers can fall through to
+ * non-aggregate field handling instead of throwing.
+ */
+export function parseAggregatePath(path) {
+    const parts = path.split('.');
+    // <rel>.$<fn>            → 2 parts, $count
+    // <rel>.$<fn>.<col>      → 3 parts, column fns
+    if (parts.length < 2 || parts.length > 3)
+        return null;
+    const [relation, token, column] = parts;
+    if (!relation || !token?.startsWith('$'))
+        return null;
+    const fn = token.slice(1);
+    if (fn === 'count')
+        return parts.length === 2 ? { relation, fn } : null;
+    if (COLUMN_FNS.has(fn))
+        return parts.length === 3 && column ? { relation, fn, column } : null;
+    return null;
+}
+//# sourceMappingURL=aggregate_path.js.map

package/dist/src/aggregate_path.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"aggregate_path.js","sourceRoot":"","sources":["../../src/aggregate_path.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AASH,MAAM,UAAU,GAAG,IAAI,GAAG,CAAc,CAAC,KAAK,EAAE,KAAK,EAAE,KAAK,EAAE,KAAK,CAAC,CAAC,CAAC;AAEtE;;;;;;;;;GASG;AACH,MAAM,UAAU,kBAAkB,CAAC,IAAY;IAC7C,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAC9B,2CAA2C;IAC3C,+CAA+C;IAC/C,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,CAAC,QAAQ,EAAE,KAAK,EAAE,MAAM,CAAC,GAAG,KAAK,CAAC;IACxC,IAAI,CAAC,QAAQ,IAAI,CAAC,KAAK,EAAE,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,IAAI,CAAC;IACtD,MAAM,EAAE,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,CAAgB,CAAC;IACzC,IAAI,EAAE,KAAK,OAAO;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IACxE,IAAI,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;QAAE,OAAO,KAAK,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,QAAQ,EAAE,EAAE,EAAE,MAAM,EAAE,CAAC,CAAC,CAAC,IAAI,CAAC;IAC9F,OAAO,IAAI,CAAC;AACd,CAAC"}