@adonis-agora/filter 0.1.0

package/dist/src/escape-like.d.ts

@@ -0,0 +1,10 @@
+/**
+ * Escapes special characters in a LIKE pattern value.
+ *
+ * @param value - The raw string to escape.
+ * @param dialect - The SQL dialect to target.
+ *   - `'standard'` (default): escapes `%`, `_`, and `\` with a backslash.
+ *   - `'mssql'`: escapes `%`, `_`, and `[` using bracket notation (`[$&]`).
+ */
+export declare function escapeLike(value: string, dialect?: 'standard' | 'mssql'): string;
+//# sourceMappingURL=escape-like.d.ts.map

package/dist/src/escape-like.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-like.d.ts","sourceRoot":"","sources":["../../src/escape-like.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,GAAE,UAAU,GAAG,OAAoB,GAAG,MAAM,CAK5F"}

package/dist/src/escape-like.js

@@ -0,0 +1,15 @@
+/**
+ * Escapes special characters in a LIKE pattern value.
+ *
+ * @param value - The raw string to escape.
+ * @param dialect - The SQL dialect to target.
+ *   - `'standard'` (default): escapes `%`, `_`, and `\` with a backslash.
+ *   - `'mssql'`: escapes `%`, `_`, and `[` using bracket notation (`[$&]`).
+ */
+export function escapeLike(value, dialect = 'standard') {
+    if (dialect === 'mssql') {
+        return value.replace(/[%_\[]/g, '[$&]');
+    }
+    return value.replace(/[%_\\]/g, '\\$&');
+}
+//# sourceMappingURL=escape-like.js.map

package/dist/src/escape-like.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"escape-like.js","sourceRoot":"","sources":["../../src/escape-like.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AACH,MAAM,UAAU,UAAU,CAAC,KAAa,EAAE,UAAgC,UAAU;IAClF,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;IAC1C,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/field_aliases.d.ts

@@ -0,0 +1,28 @@
+import type { ColumnFilter } from './operators.js';
+import type { SortItem } from './types.js';
+/** A declarative field-name remapping: client-facing alias → resolved target column. */
+export type FieldAliases = Record<string, string>;
+/**
+ * Resolves a client-supplied field name to its declared `aliases` target, or
+ * returns `field` unchanged when no alias applies.
+ *
+ * This is the single choke point for alias resolution — call it wherever a
+ * client-supplied field name is about to be resolved against the entity (column
+ * filters and sort). It must run FIRST, before any validation (allow-listing,
+ * field-charset checks) — those all evaluate the resolved target, never the
+ * alias key.
+ *
+ * Aliases do not cascade: the returned target is never re-run through the alias
+ * map, even when it happens to also be a declared alias key itself — this is
+ * what makes alias cycles structurally impossible.
+ */
+export declare function resolveFieldAlias(aliases: FieldAliases | undefined, field: string): string;
+/**
+ * Returns a copy of a {@link ColumnFilter} with its own field and every nested
+ * AND/OR child field resolved through the alias map. Pure — the input tree is
+ * left untouched.
+ */
+export declare function remapFilterAliases(filter: ColumnFilter, aliases: FieldAliases): ColumnFilter;
+/** Resolves every sort directive's field through the alias map (returns a new array). */
+export declare function remapSortAliases(sorts: SortItem[], aliases: FieldAliases): SortItem[];
+//# sourceMappingURL=field_aliases.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"field_aliases.d.ts","sourceRoot":"","sources":["../../src/field_aliases.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAkB3C,wFAAwF;AACxF,MAAM,MAAM,YAAY,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;AAElD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,iBAAiB,CAAC,OAAO,EAAE,YAAY,GAAG,SAAS,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,CAK1F;AAED;;;;GAIG;AACH,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,YAAY,EAAE,OAAO,EAAE,YAAY,GAAG,YAAY,CAS5F;AAED,yFAAyF;AACzF,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,QAAQ,EAAE,CAKrF"}

package/dist/src/field_aliases.js

@@ -0,0 +1,61 @@
+/**
+ * Field names that would resolve to inherited `Object.prototype` members
+ * (`__proto__`, `constructor`, `prototype`, `toString`, `valueOf`) if looked up
+ * on a plain-object `aliases` map without an own-property check. A
+ * client-supplied field name is never trusted as an alias-map lookup key without
+ * this guard, even though the `Object.hasOwn` check below already excludes
+ * inherited properties; kept as explicit defense-in-depth.
+ */
+const BLOCKED_ALIAS_KEYS = new Set([
+    '__proto__',
+    'constructor',
+    'prototype',
+    'toString',
+    'valueOf',
+]);
+/**
+ * Resolves a client-supplied field name to its declared `aliases` target, or
+ * returns `field` unchanged when no alias applies.
+ *
+ * This is the single choke point for alias resolution — call it wherever a
+ * client-supplied field name is about to be resolved against the entity (column
+ * filters and sort). It must run FIRST, before any validation (allow-listing,
+ * field-charset checks) — those all evaluate the resolved target, never the
+ * alias key.
+ *
+ * Aliases do not cascade: the returned target is never re-run through the alias
+ * map, even when it happens to also be a declared alias key itself — this is
+ * what makes alias cycles structurally impossible.
+ */
+export function resolveFieldAlias(aliases, field) {
+    if (!aliases || BLOCKED_ALIAS_KEYS.has(field) || !Object.hasOwn(aliases, field)) {
+        return field;
+    }
+    return aliases[field] ?? field;
+}
+/**
+ * Returns a copy of a {@link ColumnFilter} with its own field and every nested
+ * AND/OR child field resolved through the alias map. Pure — the input tree is
+ * left untouched.
+ */
+export function remapFilterAliases(filter, aliases) {
+    const next = {
+        field: resolveFieldAlias(aliases, filter.field),
+        operator: filter.operator,
+    };
+    if (filter.value !== undefined)
+        next.value = filter.value;
+    if (filter.AND)
+        next.AND = filter.AND.map((f) => remapFilterAliases(f, aliases));
+    if (filter.OR)
+        next.OR = filter.OR.map((f) => remapFilterAliases(f, aliases));
+    return next;
+}
+/** Resolves every sort directive's field through the alias map (returns a new array). */
+export function remapSortAliases(sorts, aliases) {
+    return sorts.map((sort) => ({
+        field: resolveFieldAlias(aliases, sort.field),
+        direction: sort.direction,
+    }));
+}
+//# sourceMappingURL=field_aliases.js.map

package/dist/src/field_aliases.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field_aliases.js","sourceRoot":"","sources":["../../src/field_aliases.ts"],"names":[],"mappings":"AAGA;;;;;;;GAOG;AACH,MAAM,kBAAkB,GAAG,IAAI,GAAG,CAAC;IACjC,WAAW;IACX,aAAa;IACb,WAAW;IACX,UAAU;IACV,SAAS;CACV,CAAC,CAAC;AAKH;;;;;;;;;;;;;GAaG;AACH,MAAM,UAAU,iBAAiB,CAAC,OAAiC,EAAE,KAAa;IAChF,IAAI,CAAC,OAAO,IAAI,kBAAkB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,OAAO,EAAE,KAAK,CAAC,EAAE,CAAC;QAChF,OAAO,KAAK,CAAC;IACf,CAAC;IACD,OAAO,OAAO,CAAC,KAAK,CAAC,IAAI,KAAK,CAAC;AACjC,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,kBAAkB,CAAC,MAAoB,EAAE,OAAqB;IAC5E,MAAM,IAAI,GAAiB;QACzB,KAAK,EAAE,iBAAiB,CAAC,OAAO,EAAE,MAAM,CAAC,KAAK,CAAC;QAC/C,QAAQ,EAAE,MAAM,CAAC,QAAQ;KAC1B,CAAC;IACF,IAAI,MAAM,CAAC,KAAK,KAAK,SAAS;QAAE,IAAI,CAAC,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;IAC1D,IAAI,MAAM,CAAC,GAAG;QAAE,IAAI,CAAC,GAAG,GAAG,MAAM,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACjF,IAAI,MAAM,CAAC,EAAE;QAAE,IAAI,CAAC,EAAE,GAAG,MAAM,CAAC,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,kBAAkB,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IAC9E,OAAO,IAAI,CAAC;AACd,CAAC;AAED,yFAAyF;AACzF,MAAM,UAAU,gBAAgB,CAAC,KAAiB,EAAE,OAAqB;IACvE,OAAO,KAAK,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;QAC1B,KAAK,EAAE,iBAAiB,CAAC,OAAO,EAAE,IAAI,CAAC,KAAK,CAAC;QAC7C,SAAS,EAAE,IAAI,CAAC,SAAS;KAC1B,CAAC,CAAC,CAAC;AACN,CAAC"}

package/dist/src/filter_spec.d.ts

@@ -0,0 +1,146 @@
+import type { FieldAliases } from './field_aliases.js';
+import type { ColumnFilter } from './operators.js';
+import type { FilterConfig, FullTextSearchConfig, SortItem, VectorSimilarityConfig } from './types.js';
+/**
+ * Thrown when a {@link defineFilter} declaration is itself invalid (a developer
+ * error surfaced at wiring time, not a bad client request). Request-time
+ * violations (a disallowed field under `throwOnInvalid`) still surface as
+ * `InvalidColumnFilterError` from the runner — this is the one new typed error,
+ * for the declaration boundary the NestJS `@Filterable` decorator guarded.
+ */
+export declare class FilterDefinitionError extends Error {
+    constructor(message: string);
+}
+/** Column-level allow-list for a relation: `'*'` (any column) or a bare-name list. */
+export type RelationColumns = string[] | '*';
+/**
+ * The filterable/sortable declaration for one whitelisted relation, keyed by the
+ * relation name on the owning model. Column names are **bare** (unprefixed) — the
+ * request field is the dotted path `relation.column`. Nesting `relations` again
+ * whitelists deeper paths (`relation.child.column`), bounded by `maxDepth`.
+ */
+export interface RelationSpec {
+    /** Columns of the related model clients may filter on. Defaults to `'*'`. */
+    filterable?: RelationColumns;
+    /** Columns of the related model clients may sort on. Defaults to `filterable`. */
+    sortable?: RelationColumns;
+    /** Further whitelisted relations reachable from this one (one hop deeper). */
+    relations?: Record<string, RelationSpec>;
+}
+/**
+ * Reads the current tenant id from the request context (the AdonisJS
+ * `HttpContext`, or any object the caller passes). A `null`/`undefined` result
+ * means "no tenant in context" — tenant scoping is then skipped (opt-in, exactly
+ * like the NestJS `@TenantScoped` no-op when no tenant resolves).
+ */
+export type TenantResolver = (ctx: unknown) => string | number | null | undefined;
+/** Tenant auto-scope: constrain `column` to the tenant id resolved from ctx. */
+export interface TenantScopeSpec {
+    /** The model column constrained to the current tenant id (e.g. `'tenantId'`). */
+    column: string;
+    /** Resolves the tenant id from the request ctx. Nullish → scope is skipped. */
+    resolve: TenantResolver;
+}
+/**
+ * The declarative filter definition — the idiomatic AdonisJS reimplementation of
+ * everything the NestJS `@Filterable`/`@Relations`/`@TenantScoped` decorators
+ * encoded, as a plain options object (no decorators, no metadata reflection).
+ */
+export interface DefineFilterOptions {
+    /** Columns clients may filter on. `'*'` allows any base column. */
+    filterable: RelationColumns;
+    /** Columns clients may sort on. Defaults to {@link DefineFilterOptions.filterable}. */
+    sortable?: RelationColumns;
+    /**
+     * Columns the free-text `search` term scans with a portable ILIKE — the
+     * default search path when {@link DefineFilterOptions.fullText} is not set.
+     */
+    searchable?: string[];
+    /**
+     * Opt-in Postgres tsvector full-text search. When set, the request `search`
+     * string routes through `websearch_to_tsquery`/`@@` (and optional `ts_rank`)
+     * instead of the ILIKE `searchable` scan. Column(s) + language + rank.
+     */
+    fullText?: FullTextSearchConfig;
+    /** Whitelisted relations and their nested filterable/sortable columns. */
+    relations?: Record<string, RelationSpec>;
+    /**
+     * Maximum relation-path depth (number of relation hops; a base column is
+     * depth 0, `posts.title` is depth 1, `posts.comments.body` is depth 2).
+     * Defaults to the deepest declared relation nesting. An explicit smaller value
+     * caps paths even when a deeper relation is declared.
+     */
+    maxDepth?: number;
+    /** Client-alias → resolved-target field remapping (see {@link resolveFieldAlias}). */
+    aliases?: FieldAliases;
+    /**
+     * Opt-in pgvector embedding-similarity ordering (distinct from text `search`):
+     * declares the vector column (and metric / threshold / top-K) rows are ranked
+     * by when a request carries a query embedding. Additive — a spec without this
+     * is unchanged.
+     */
+    vectorSimilarity?: VectorSimilarityConfig;
+    /** Opt-in tenant auto-scope read from ctx. */
+    tenant?: TenantScopeSpec;
+    /**
+     * Server-declared filters always applied (in real column terms, AND-combined
+     * with the request filters). Not subject to the allow-list — they are trusted
+     * server policy, never client input.
+     */
+    defaultFilters?: ColumnFilter[];
+    /** Sort applied when the request supplies none (stable default ordering). */
+    defaultSort?: SortItem[];
+    /** Default page size when the request gives none. Default 25 (in the runner). */
+    defaultSize?: number;
+    /** Hard cap on page size. Default 100 (in the runner). */
+    maxSize?: number;
+    /** Throw `InvalidColumnFilterError` on a disallowed field instead of dropping it. */
+    throwOnInvalid?: boolean;
+}
+/**
+ * A resolved, reusable, frozen filter definition produced by {@link defineFilter}.
+ * Build it once (module scope) and hand it to {@link applyFilterFromRequest} on
+ * every request. The `isFilterable`/`isSortable` predicates are the allow-list
+ * boundary — relation-path and depth aware — that the runner enforces.
+ */
+export interface FilterSpec {
+    readonly filterable: RelationColumns;
+    readonly sortable: RelationColumns;
+    readonly searchable: readonly string[];
+    readonly fullText: FullTextSearchConfig | undefined;
+    readonly relations: Readonly<Record<string, RelationSpec>>;
+    readonly maxDepth: number;
+    readonly aliases: FieldAliases | undefined;
+    readonly vectorSimilarity: VectorSimilarityConfig | undefined;
+    readonly tenant: TenantScopeSpec | undefined;
+    readonly defaultFilters: readonly ColumnFilter[];
+    readonly defaultSort: readonly SortItem[];
+    readonly defaultSize: number | undefined;
+    readonly maxSize: number | undefined;
+    readonly throwOnInvalid: boolean;
+    /** Is this (possibly relation-dotted, alias-resolved) field filterable? */
+    isFilterable(field: string): boolean;
+    /** Is this (possibly relation-dotted, alias-resolved) field sortable? */
+    isSortable(field: string): boolean;
+}
+/**
+ * Build a reusable {@link FilterSpec} from a declarative {@link DefineFilterOptions}.
+ *
+ * This is the AdonisJS-idiomatic replacement for the NestJS decorator stack:
+ * instead of `@Filterable`/`@Relations`/`@TenantScoped` metadata read by an
+ * interceptor, the definition is an explicit, framework-free config object built
+ * once and passed explicitly to {@link applyFilterFromRequest}. It captures the
+ * same feature set the decorators encoded — filterable/sortable allow-listing,
+ * a relation whitelist with a depth cap, field aliases, tenant scoping, and
+ * default filters/sort.
+ */
+export declare function defineFilter(options: DefineFilterOptions): FilterSpec;
+/**
+ * Project a {@link FilterSpec} onto the per-call {@link FilterConfig} the runner's
+ * {@link applyFilter}/{@link applyCursor} consume. The allow-lists become
+ * predicates (so relation-path + depth rules survive), and `defaultSort` fields
+ * are unioned into the sortable predicate so a server-declared default ordering
+ * is never dropped by the client-facing sort allow-list.
+ */
+export declare function specToFilterConfig(spec: FilterSpec): FilterConfig;
+//# sourceMappingURL=filter_spec.d.ts.map

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

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

package/dist/src/filter_spec.js

@@ -0,0 +1,140 @@
+/**
+ * Thrown when a {@link defineFilter} declaration is itself invalid (a developer
+ * error surfaced at wiring time, not a bad client request). Request-time
+ * violations (a disallowed field under `throwOnInvalid`) still surface as
+ * `InvalidColumnFilterError` from the runner — this is the one new typed error,
+ * for the declaration boundary the NestJS `@Filterable` decorator guarded.
+ */
+export class FilterDefinitionError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'FilterDefinitionError';
+    }
+}
+/** Blocked path segments that could otherwise index inherited prototype members. */
+const BLOCKED_SEGMENTS = new Set(['__proto__', 'constructor', 'prototype', 'toString', 'valueOf']);
+/** Deepest relation nesting declared under `relations` (0 when none). */
+function declaredDepth(relations) {
+    if (!relations)
+        return 0;
+    let max = 0;
+    for (const rel of Object.values(relations)) {
+        max = Math.max(max, 1 + declaredDepth(rel.relations));
+    }
+    return max;
+}
+/** Does an allow-list admit a bare column name? `undefined` → treated as `'*'`. */
+function columnAllowed(list, column) {
+    if (list === undefined || list === '*')
+        return true;
+    return list.includes(column);
+}
+/**
+ * Resolve a (possibly dotted) field path against the base allow-lists and the
+ * relation whitelist, enforcing `maxDepth`. Pure — the client-supplied `field`
+ * is only ever read, and each segment is guarded against prototype-pollution
+ * lookups before it indexes the relations map.
+ */
+function pathAllowed(field, kind, baseFilterable, baseSortable, relations, maxDepth) {
+    const segments = field.split('.');
+    // Base column (no relation hop).
+    if (segments.length === 1) {
+        const seg = segments[0];
+        if (seg.length === 0 || BLOCKED_SEGMENTS.has(seg))
+            return false;
+        return columnAllowed(kind === 'filterable' ? baseFilterable : baseSortable, seg);
+    }
+    // Relation path — bounded by maxDepth (hops = segments - 1).
+    if (segments.length - 1 > maxDepth)
+        return false;
+    let node = relations;
+    for (let i = 0; i < segments.length - 1; i++) {
+        const seg = segments[i];
+        if (seg.length === 0 || BLOCKED_SEGMENTS.has(seg))
+            return false;
+        if (!node || !Object.hasOwn(node, seg))
+            return false;
+        const rel = node[seg];
+        // Last hop: the final segment is the leaf column on this relation.
+        if (i === segments.length - 2) {
+            const leaf = segments[segments.length - 1];
+            if (leaf.length === 0 || BLOCKED_SEGMENTS.has(leaf))
+                return false;
+            const list = kind === 'filterable' ? rel.filterable : (rel.sortable ?? rel.filterable);
+            return columnAllowed(list, leaf);
+        }
+        node = rel.relations;
+    }
+    return false;
+}
+/**
+ * Build a reusable {@link FilterSpec} from a declarative {@link DefineFilterOptions}.
+ *
+ * This is the AdonisJS-idiomatic replacement for the NestJS decorator stack:
+ * instead of `@Filterable`/`@Relations`/`@TenantScoped` metadata read by an
+ * interceptor, the definition is an explicit, framework-free config object built
+ * once and passed explicitly to {@link applyFilterFromRequest}. It captures the
+ * same feature set the decorators encoded — filterable/sortable allow-listing,
+ * a relation whitelist with a depth cap, field aliases, tenant scoping, and
+ * default filters/sort.
+ */
+export function defineFilter(options) {
+    if (!options || options.filterable === undefined) {
+        throw new FilterDefinitionError('defineFilter requires a `filterable` allow-list.');
+    }
+    if (options.maxDepth !== undefined &&
+        (!Number.isInteger(options.maxDepth) || options.maxDepth < 0)) {
+        throw new FilterDefinitionError('`maxDepth` must be a non-negative integer.');
+    }
+    const relations = options.relations ?? {};
+    const filterable = options.filterable;
+    const sortable = options.sortable ?? options.filterable;
+    const maxDepth = options.maxDepth ?? declaredDepth(relations);
+    const spec = {
+        filterable,
+        sortable,
+        searchable: options.searchable ?? [],
+        fullText: options.fullText,
+        relations,
+        maxDepth,
+        aliases: options.aliases,
+        vectorSimilarity: options.vectorSimilarity,
+        tenant: options.tenant,
+        defaultFilters: options.defaultFilters ?? [],
+        defaultSort: options.defaultSort ?? [],
+        defaultSize: options.defaultSize,
+        maxSize: options.maxSize,
+        throwOnInvalid: options.throwOnInvalid ?? false,
+        isFilterable(field) {
+            return pathAllowed(field, 'filterable', filterable, sortable, relations, maxDepth);
+        },
+        isSortable(field) {
+            return pathAllowed(field, 'sortable', filterable, sortable, relations, maxDepth);
+        },
+    };
+    return Object.freeze(spec);
+}
+/**
+ * Project a {@link FilterSpec} onto the per-call {@link FilterConfig} the runner's
+ * {@link applyFilter}/{@link applyCursor} consume. The allow-lists become
+ * predicates (so relation-path + depth rules survive), and `defaultSort` fields
+ * are unioned into the sortable predicate so a server-declared default ordering
+ * is never dropped by the client-facing sort allow-list.
+ */
+export function specToFilterConfig(spec) {
+    const defaultSortFields = new Set(spec.defaultSort.map((s) => s.field));
+    const allowed = (field) => spec.isFilterable(field);
+    const sortable = (field) => spec.isSortable(field) || defaultSortFields.has(field);
+    return {
+        allowed,
+        sortable,
+        ...(spec.searchable.length > 0 && { searchable: [...spec.searchable] }),
+        ...(spec.fullText && { fullText: spec.fullText }),
+        ...(spec.aliases && { aliases: spec.aliases }),
+        ...(spec.vectorSimilarity && { vectorSimilarity: spec.vectorSimilarity }),
+        ...(spec.defaultSize !== undefined && { defaultSize: spec.defaultSize }),
+        ...(spec.maxSize !== undefined && { maxSize: spec.maxSize }),
+        throwOnInvalid: spec.throwOnInvalid,
+    };
+}
+//# sourceMappingURL=filter_spec.js.map

package/dist/src/filter_spec.js.map

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

package/dist/src/generate_client.d.ts

@@ -0,0 +1,107 @@
+import type { FilterSpec } from './filter_spec.js';
+/**
+ * Codegen for the typed client — the AdonisJS-idiomatic port of the NestJS
+ * `nestjs-filter` codegen. Where the NestJS package ships a standalone
+ * `reflect-metadata` bin that reads decorator metadata off entity classes and
+ * emits `filterQuery: () => filterQueryTyped<Fields, TypeMap>()` members into a
+ * generated `api.ts`, the Adonis port has no decorators: the filter declaration
+ * is already a plain runtime {@link FilterSpec} produced by `defineFilter(...)`.
+ *
+ * So generation is a **pure function of the spec** — string in, string out, no
+ * AST walk, no metadata reflection, no framework. The ace command
+ * (`make:filter-client`) is the thin IO wrapper that loads the app's declared
+ * specs and writes the emitted module to disk. Keeping the generator pure keeps
+ * it trivially testable (snapshot/string assertions) and framework-free, exactly
+ * like the rest of this core.
+ *
+ * The emitted module targets `@adonis-agora/filter-client`'s `filterQueryTyped<Fields,
+ * FieldTypes>()` factory — the same client the NestJS codegen emitted against —
+ * so the two ecosystems share one browser runtime.
+ */
+/** A field's classified value kind — mirrors `@adonis-agora/filter-client`'s `FieldTypeKind`. */
+export type FilterFieldKind = 'string' | 'number' | 'boolean' | 'date' | 'json' | 'unknown';
+/**
+ * Optional per-field type information. A {@link FilterSpec} carries the
+ * allow-list but not column value types (Lucid models aren't reflected here), so
+ * the caller supplies types to unlock the client's type-aware operator narrowing.
+ * Without it the emitted client is still field-name-safe, just operator-permissive.
+ */
+export interface FilterFieldTypeInfo {
+    /** Classified value kind. Ignored when {@link typeRef} or {@link enumValues} is set. */
+    kind?: FilterFieldKind;
+    /** Enum literal members — emitted as a union (`"A" | "B"` or `1 | 2`). Wins over {@link kind}. */
+    enumValues?: readonly (string | number)[];
+    /** A named TS type (e.g. `'Role'`) — emitted verbatim. Wins over everything. */
+    typeRef?: string;
+    /** Nullable column — appends `| null` to the emitted type. */
+    nullable?: boolean;
+}
+/** Options for {@link generateFilterClient}. */
+export interface GenerateFilterClientOptions {
+    /**
+     * Base name for the emitted identifiers — e.g. `'people'` yields
+     * `PeopleFilterFields`, `PeopleFilterFieldTypes`, `peopleFilterMeta` and
+     * `peopleFilterQuery()`. Non-identifier characters are stripped.
+     */
+    name: string;
+    /** Per-field value types keyed by (dotted) field path. Unlocks operator narrowing. */
+    fieldTypes?: Record<string, FilterFieldTypeInfo>;
+    /** Import specifier for `filterQueryTyped`. Default `'@adonis-agora/filter-client'`. */
+    clientModule?: string;
+    /** Cap relation-path depth of the emitted field union. Default {@link FilterSpec.maxDepth}. */
+    maxDepth?: number;
+    /** Emit the "generated — do not edit" banner. Default `true`. */
+    banner?: boolean;
+}
+/** Enumerate the filterable field paths a spec admits, capped at `maxDepth` relation hops. */
+export declare function filterableFieldPaths(spec: FilterSpec, maxDepth?: number): string[];
+/** Enumerate the sortable field paths a spec admits, capped at `maxDepth` relation hops. */
+export declare function sortableFieldPaths(spec: FilterSpec, maxDepth?: number): string[];
+/**
+ * Generate a typed filter client module for one {@link FilterSpec} — a pure
+ * string transform. The emitted module exports, for a spec named `people`:
+ *
+ * - `type PeopleFilterFields` — the union of filterable field paths (the security
+ *   boundary, as concrete string literals);
+ * - `interface PeopleFilterFieldTypes` — the per-field value-type map (only when
+ *   `fieldTypes` is supplied), which drives the client's operator/value narrowing;
+ * - `const peopleFilterMeta` — runtime metadata (filterable/sortable/searchable
+ *   fields, whitelisted relations, per-field kinds, and the default sort / page
+ *   size / max size + cursor keyset the runner paginates by);
+ * - `function peopleFilterQuery()` — a `filterQueryTyped<Fields, FieldTypes>()`
+ *   factory returning a type-safe builder scoped to this spec.
+ */
+export declare function generateFilterClient(spec: FilterSpec, options: GenerateFilterClientOptions): string;
+/**
+ * One entry in a {@link FilterClientManifest}: a declared spec plus the optional
+ * type info / codegen overrides the emitter needs. This is what an app exports
+ * from `config/filter.ts` (as `filters`) for the `make:filter-client` command to
+ * consume — the specs are already `defineFilter(...)` results, so no reflection.
+ */
+export interface FilterClientEntry {
+    /** The `defineFilter(...)` result to generate a client for. */
+    spec: FilterSpec;
+    /** Per-field value types (see {@link GenerateFilterClientOptions.fieldTypes}). */
+    fieldTypes?: Record<string, FilterFieldTypeInfo>;
+    /** Override the client import specifier for this entry. */
+    clientModule?: string;
+    /** Override the relation-path depth cap for this entry. */
+    maxDepth?: number;
+}
+/** A map of client name → declared spec, keyed by the emitted client's base name. */
+export type FilterClientManifest = Record<string, FilterClientEntry>;
+/** A single generated client: its name, its AdonisJS-conventional file name, and its code. */
+export interface GeneratedFilterClient {
+    name: string;
+    /** `snake_case`d file name, e.g. `blog_post_filter_client.ts`. */
+    filename: string;
+    code: string;
+}
+/**
+ * Expand a whole {@link FilterClientManifest} into per-spec generated modules —
+ * the pure core the `make:filter-client` ace command writes to disk. Kept pure
+ * (manifest in, modules out) so the command stays a thin IO wrapper and the
+ * expansion is itself testable without a running app.
+ */
+export declare function generateFilterClients(manifest: FilterClientManifest): GeneratedFilterClient[];
+//# sourceMappingURL=generate_client.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"generate_client.d.ts","sourceRoot":"","sources":["../../src/generate_client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,UAAU,EAAgB,MAAM,kBAAkB,CAAC;AAEjE;;;;;;;;;;;;;;;;;;GAkBG;AAEH,iGAAiG;AACjG,MAAM,MAAM,eAAe,GAAG,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAE5F;;;;;GAKG;AACH,MAAM,WAAW,mBAAmB;IAClC,wFAAwF;IACxF,IAAI,CAAC,EAAE,eAAe,CAAC;IACvB,kGAAkG;IAClG,UAAU,CAAC,EAAE,SAAS,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;IAC1C,gFAAgF;IAChF,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,8DAA8D;IAC9D,QAAQ,CAAC,EAAE,OAAO,CAAC;CACpB;AAED,gDAAgD;AAChD,MAAM,WAAW,2BAA2B;IAC1C;;;;OAIG;IACH,IAAI,EAAE,MAAM,CAAC;IACb,sFAAsF;IACtF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,wFAAwF;IACxF,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,+FAA+F;IAC/F,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,iEAAiE;IACjE,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,SAAgB,GAAG,MAAM,EAAE,CAEzF;AAED,4FAA4F;AAC5F,wBAAgB,kBAAkB,CAAC,IAAI,EAAE,UAAU,EAAE,QAAQ,SAAgB,GAAG,MAAM,EAAE,CAEvF;AAqFD;;;;;;;;;;;;;GAaG;AACH,wBAAgB,oBAAoB,CAClC,IAAI,EAAE,UAAU,EAChB,OAAO,EAAE,2BAA2B,GACnC,MAAM,CAiFR;AAED;;;;;GAKG;AACH,MAAM,WAAW,iBAAiB;IAChC,+DAA+D;IAC/D,IAAI,EAAE,UAAU,CAAC;IACjB,kFAAkF;IAClF,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACjD,2DAA2D;IAC3D,YAAY,CAAC,EAAE,MAAM,CAAC;IACtB,2DAA2D;IAC3D,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAED,qFAAqF;AACrF,MAAM,MAAM,oBAAoB,GAAG,MAAM,CAAC,MAAM,EAAE,iBAAiB,CAAC,CAAC;AAErE,8FAA8F;AAC9F,MAAM,WAAW,qBAAqB;IACpC,IAAI,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;CACd;AAED;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,oBAAoB,GAAG,qBAAqB,EAAE,CAW7F"}