@adonis-agora/filter 0.0.0-beta-20261110131309

package/dist/src/decorators.d.ts

@@ -0,0 +1,73 @@
+import type { FilterFieldKind } from './types.js';
+/**
+ * A decorator that works under both flavours — the legacy `(prototype, key, descriptor)` form
+ * AdonisJS compiles today (`experimentalDecorators`, which Lucid's `@column` requires) and the
+ * TC39 standard `(value, context)` form TypeScript 5 emits when that flag is off. Which one runs
+ * is decided at call time, from the shape of the second argument.
+ */
+export interface DualDecorator {
+    (target: object, propertyKey: string | symbol, descriptor?: PropertyDescriptor): void;
+    (value: unknown, context: StandardDecoratorContext): void;
+}
+/** The slice of a TC39 decorator context this library reads. */
+export interface StandardDecoratorContext {
+    kind: string;
+    name: string | symbol;
+    metadata?: object;
+}
+/**
+ * Bind a filter method to the request key(s) it answers, instead of deriving the key from the
+ * method's name.
+ *
+ * Worth reaching for exactly twice: when the key cannot be a method name (`team.name`), and when
+ * one method should answer several keys. It also pins the public contract — with a binding, the
+ * key survives renaming the method.
+ *
+ * ```ts
+ * export default class UserFilter extends BaseModelFilter {
+ *   @filterFor('team.name')
+ *   byTeamName(value: string) {
+ *     this.$query.whereHas('team', (team) => team.whereILike('name', `%${value}%`))
+ *   }
+ *
+ *   @filterFor('q', 'query')
+ *   freeText(value: string) { … }
+ * }
+ * ```
+ *
+ * A bound method answers **only** its declared keys: `?filter[byTeamName]=…` stops working, which
+ * is the point — the method name becomes an implementation detail.
+ */
+export declare function filterFor(...keys: string[]): DualDecorator;
+/**
+ * Mark a model column as filterable — the allow-list, declared where the column is, stacked under
+ * Lucid's own `@column()`.
+ *
+ * ```ts
+ * export default class User extends compose(BaseModel, Filterable) {
+ *   @column()
+ *   @filterable()
+ *   declare status: string
+ *
+ *   @column()
+ *   @filterable('number')
+ *   declare age: number
+ *
+ *   @column({ serializeAs: null })
+ *   declare passwordHash: string   // undecorated — unreachable, as it should be
+ * }
+ * ```
+ *
+ * A filter class picks these up through its `static model`. Anything the filter declares itself
+ * still wins outright, so a stricter filter over a shared model can narrow the surface:
+ * `static filterable = ['status']` exposes that column and no other.
+ *
+ * The optional kind is the same one the colocated `filterable` map takes: it drives value
+ * coercion and the generated client's types.
+ */
+export declare function filterable(kind?: FilterFieldKind): DualDecorator;
+/** Mark a model column as sortable — `?sort=-createdAt` reaches it, nothing else does. */
+export declare function sortable(): DualDecorator;
+/** Mark a model column as scanned by the free-text `?search=` term. */
+export declare function searchable(): DualDecorator;
+//# sourceMappingURL=decorators.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"decorators.d.ts","sourceRoot":"","sources":["../../src/decorators.ts"],"names":[],"mappings":"AAGA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD;;;;;GAKG;AACH,MAAM,WAAW,aAAa;IAC5B,CAAC,MAAM,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM,EAAE,UAAU,CAAC,EAAE,kBAAkB,GAAG,IAAI,CAAC;IACtF,CAAC,KAAK,EAAE,OAAO,EAAE,OAAO,EAAE,wBAAwB,GAAG,IAAI,CAAC;CAC3D;AAED,gEAAgE;AAChE,MAAM,WAAW,wBAAwB;IACvC,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IACtB,QAAQ,CAAC,EAAE,MAAM,CAAC;CACnB;AAwCD;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,SAAS,CAAC,GAAG,IAAI,EAAE,MAAM,EAAE,GAAG,aAAa,CAmB1D;AAKD;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,IAAI,CAAC,EAAE,eAAe,GAAG,aAAa,CAKhE;AAED,0FAA0F;AAC1F,wBAAgB,QAAQ,IAAI,aAAa,CAKxC;AAED,uEAAuE;AACvE,wBAAgB,UAAU,IAAI,aAAa,CAK1C"}

package/dist/src/decorators.js

@@ -0,0 +1,118 @@
+import { legacyRecord, standardRecord } from './decorator_metadata.js';
+import { isReservedKey } from './filter_class.js';
+import { FilterDefinitionError } from './filter_spec.js';
+/** Standard decorators are handed a context object; legacy ones a property key. */
+function isStandardContext(value) {
+    return typeof value === 'object' && value !== null && 'kind' in value;
+}
+/**
+ * Resolve where a decorator should write, whichever flavour invoked it: the declared member's
+ * name, and the record for the class that declared it.
+ */
+function target(what, expectedKinds, first, second) {
+    if (isStandardContext(second)) {
+        if (!expectedKinds.includes(second.kind)) {
+            throw new FilterDefinitionError(`${what} goes on ${expectedKinds.join(' or ')}, not on a ${second.kind}.`);
+        }
+        if (!second.metadata) {
+            throw new FilterDefinitionError(`${what} needs decorator metadata, which this runtime does not provide. Polyfill \`Symbol.metadata\` (\`Symbol.metadata ??= Symbol('Symbol.metadata')\`), or compile with \`experimentalDecorators\` as AdonisJS does.`);
+        }
+        return { name: String(second.name), record: standardRecord(second.metadata) };
+    }
+    if (typeof first === 'function') {
+        throw new FilterDefinitionError(`${what} goes on an instance member, not a static one.`);
+    }
+    if (typeof first !== 'object' || first === null) {
+        throw new FilterDefinitionError(`${what} was applied to something that is not a class member.`);
+    }
+    return { name: String(second), record: legacyRecord(first) };
+}
+/**
+ * Bind a filter method to the request key(s) it answers, instead of deriving the key from the
+ * method's name.
+ *
+ * Worth reaching for exactly twice: when the key cannot be a method name (`team.name`), and when
+ * one method should answer several keys. It also pins the public contract — with a binding, the
+ * key survives renaming the method.
+ *
+ * ```ts
+ * export default class UserFilter extends BaseModelFilter {
+ *   @filterFor('team.name')
+ *   byTeamName(value: string) {
+ *     this.$query.whereHas('team', (team) => team.whereILike('name', `%${value}%`))
+ *   }
+ *
+ *   @filterFor('q', 'query')
+ *   freeText(value: string) { … }
+ * }
+ * ```
+ *
+ * A bound method answers **only** its declared keys: `?filter[byTeamName]=…` stops working, which
+ * is the point — the method name becomes an implementation detail.
+ */
+export function filterFor(...keys) {
+    if (keys.length === 0) {
+        throw new FilterDefinitionError('@filterFor() needs at least one request key.');
+    }
+    for (const key of keys) {
+        if (typeof key !== 'string' || key.length === 0) {
+            throw new FilterDefinitionError('@filterFor() keys must be non-empty strings.');
+        }
+        if (isReservedKey(key)) {
+            throw new FilterDefinitionError(`@filterFor('${key}') — '${key}' is a key the wire format itself owns (page, sort, search, …), so it never reaches a method. Bind another key.`);
+        }
+    }
+    return ((first, second) => {
+        const { name, record } = target('@filterFor()', ['method'], first, second);
+        record.filterFor = { ...record.filterFor, [name]: [...keys] };
+    });
+}
+/** The member kinds a column decorator may sit on. */
+const COLUMN_KINDS = ['field', 'accessor', 'getter', 'setter'];
+/**
+ * Mark a model column as filterable — the allow-list, declared where the column is, stacked under
+ * Lucid's own `@column()`.
+ *
+ * ```ts
+ * export default class User extends compose(BaseModel, Filterable) {
+ *   @column()
+ *   @filterable()
+ *   declare status: string
+ *
+ *   @column()
+ *   @filterable('number')
+ *   declare age: number
+ *
+ *   @column({ serializeAs: null })
+ *   declare passwordHash: string   // undecorated — unreachable, as it should be
+ * }
+ * ```
+ *
+ * A filter class picks these up through its `static model`. Anything the filter declares itself
+ * still wins outright, so a stricter filter over a shared model can narrow the surface:
+ * `static filterable = ['status']` exposes that column and no other.
+ *
+ * The optional kind is the same one the colocated `filterable` map takes: it drives value
+ * coercion and the generated client's types.
+ */
+export function filterable(kind) {
+    return ((first, second) => {
+        const { name, record } = target('@filterable()', COLUMN_KINDS, first, second);
+        record.filterable = { ...record.filterable, [name]: kind ?? null };
+    });
+}
+/** Mark a model column as sortable — `?sort=-createdAt` reaches it, nothing else does. */
+export function sortable() {
+    return ((first, second) => {
+        const { name, record } = target('@sortable()', COLUMN_KINDS, first, second);
+        record.sortable = [...(record.sortable ?? []), name];
+    });
+}
+/** Mark a model column as scanned by the free-text `?search=` term. */
+export function searchable() {
+    return ((first, second) => {
+        const { name, record } = target('@searchable()', COLUMN_KINDS, first, second);
+        record.searchable = [...(record.searchable ?? []), name];
+    });
+}
+//# sourceMappingURL=decorators.js.map

package/dist/src/decorators.js.map

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

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,OAAO,GAAyB,UAAU;IAClF,IAAI,OAAO,KAAK,OAAO,EAAE,CAAC;QACxB,OAAO,KAAK,CAAC,OAAO,CAAC,QAAQ,EAAE,MAAM,CAAC,CAAC;IACzC,CAAC;IACD,OAAO,KAAK,CAAC,OAAO,CAAC,SAAS,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/field_aliases.d.ts

@@ -0,0 +1,30 @@
+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[];
+/** Resolves every distinct field name through the alias map (returns a new array). */
+export declare function remapDistinctAliases(fields: string[], aliases: FieldAliases): string[];
+//# 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;AAED,sFAAsF;AACtF,wBAAgB,oBAAoB,CAAC,MAAM,EAAE,MAAM,EAAE,EAAE,OAAO,EAAE,YAAY,GAAG,MAAM,EAAE,CAEtF"}

package/dist/src/field_aliases.js

@@ -0,0 +1,65 @@
+/**
+ * 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,
+    }));
+}
+/** Resolves every distinct field name through the alias map (returns a new array). */
+export function remapDistinctAliases(fields, aliases) {
+    return fields.map((field) => resolveFieldAlias(aliases, field));
+}
+//# 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;AAED,sFAAsF;AACtF,MAAM,UAAU,oBAAoB,CAAC,MAAgB,EAAE,OAAqB;IAC1E,OAAO,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,iBAAiB,CAAC,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;AAClE,CAAC"}

package/dist/src/filter_class.d.ts

@@ -0,0 +1,46 @@
+import { BaseModelFilter } from './base_model_filter.js';
+import { type FilterSpec } from './filter_spec.js';
+/**
+ * A filter class as the container hands it back: constructible, extending {@link BaseModelFilter}
+ * — and carrying that base's static declarations (`filterable`, `sortable`, `blacklist`, …).
+ *
+ * Spelled as an intersection with `typeof BaseModelFilter` rather than an index signature: a
+ * concrete `class UserFilter extends BaseModelFilter` has no index signature, so
+ * `Record<string, unknown>` here would make every real filter class *unassignable* to this type —
+ * `static $filter = () => UserFilter` on a model would not compile.
+ */
+export type FilterClass = new (...args: any[]) => BaseModelFilter;
+/**
+ * Is this a filter class (as opposed to a `defineFilter` spec)? Checked structurally — a class
+ * that extends {@link BaseModelFilter} — so the two forms can share one entry point.
+ */
+export declare function isFilterClass(value: unknown): value is FilterClass;
+/**
+ * The request keys a class owns with a method of its own, walking the prototype chain up to (but
+ * not including) {@link BaseModelFilter} — so a shared abstract filter's methods are inherited
+ * like any other. `setup`, the constructor, `$`-prefixed members and anything on the class's
+ * `blacklist` are excluded.
+ *
+ * Memoized per class: the shape of a class does not change between requests.
+ */
+export declare function dispatchKeys(cls: FilterClass): ReadonlySet<string>;
+/**
+ * Compile a filter class's static declarations into the {@link FilterSpec} the runner consumes —
+ * the same object `defineFilter` produces, so a class and a spec take the identical code path
+ * through allow-listing, search, sort and pagination.
+ *
+ * A class that declares no `filterable` is method-only: nothing reaches SQL except through the
+ * methods it wrote, which is the tightest allow-list there is.
+ *
+ * Memoized per class — the declaration is static, so it is compiled once per process.
+ */
+export declare function specFromFilterClass(cls: FilterClass): FilterSpec;
+/**
+ * Find the method a request key maps to, honouring the class's `camelCase` (a `snake_case` key
+ * matches a camelCase method — on by default) and `dropId` (`companyId` matches `company`) knobs.
+ * Returns the method name, or `undefined` when the class does not own the key.
+ */
+export declare function methodForKey(cls: FilterClass, key: string): string | undefined;
+/** Is this key one the wire format owns (so it is never dispatched to a method)? */
+export declare function isReservedKey(key: string): boolean;
+//# sourceMappingURL=filter_class.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"filter_class.d.ts","sourceRoot":"","sources":["../../src/filter_class.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,MAAM,wBAAwB,CAAC;AAEzD,OAAO,EAAgB,KAAK,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAGjE;;;;;;;;GAQG;AAEH,MAAM,MAAM,WAAW,GAAG,KAAK,GAAG,IAAI,EAAE,GAAG,EAAE,KAAK,eAAe,CAAC;AAkDlE;;;GAGG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAQlE;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,GAAG,WAAW,CAAC,MAAM,CAAC,CA0BlE;AAkCD;;;;;;;;;GASG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,WAAW,GAAG,UAAU,CA8BhE;AAoDD;;;;GAIG;AACH,wBAAgB,YAAY,CAAC,GAAG,EAAE,WAAW,EAAE,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAuB9E;AAcD,oFAAoF;AACpF,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAElD"}

package/dist/src/filter_class.js

@@ -0,0 +1,244 @@
+import { BaseFilter } from './base_filter.js';
+import { BaseModelFilter } from './base_model_filter.js';
+import { readDecorators } from './decorator_metadata.js';
+import { defineFilter } from './filter_spec.js';
+/**
+ * A filter class's static side. Read through a cast rather than declared on {@link FilterClass}
+ * itself: an index signature there would make every concrete `class UserFilter extends
+ * BaseModelFilter` *unassignable* to the type — `static $filter = () => UserFilter` on a model
+ * would stop compiling.
+ */
+function statics(cls) {
+    return cls;
+}
+/** Request keys the wire format owns — never dispatched to a method of the same name. */
+const RESERVED_KEYS = new Set([
+    'filter',
+    'filters',
+    'sort',
+    'search',
+    'page',
+    'size',
+    'distinct',
+    'include',
+    'select',
+    'after',
+    'before',
+    'first',
+    'last',
+    'limit',
+    'offset',
+]);
+/** Names on the class that are machinery, not request keys. */
+const RESERVED_METHODS = new Set(['constructor', 'setup', 'input']);
+/**
+ * Is this a filter class (as opposed to a `defineFilter` spec)? Checked structurally — a class
+ * that extends {@link BaseModelFilter} — so the two forms can share one entry point.
+ */
+export function isFilterClass(value) {
+    if (typeof value !== 'function')
+        return false;
+    let proto = Object.getPrototypeOf(value);
+    while (proto !== null && proto !== Function.prototype) {
+        if (proto === BaseModelFilter)
+            return true;
+        proto = Object.getPrototypeOf(proto);
+    }
+    return false;
+}
+/**
+ * The request keys a class owns with a method of its own, walking the prototype chain up to (but
+ * not including) {@link BaseModelFilter} — so a shared abstract filter's methods are inherited
+ * like any other. `setup`, the constructor, `$`-prefixed members and anything on the class's
+ * `blacklist` are excluded.
+ *
+ * Memoized per class: the shape of a class does not change between requests.
+ */
+export function dispatchKeys(cls) {
+    const cached = KEY_CACHE.get(cls);
+    if (cached)
+        return cached;
+    const blacklist = new Set(statics(cls).blacklist ?? []);
+    const bound = explicitBindings(cls).methods;
+    const keys = new Set();
+    let proto = cls.prototype;
+    // Stop at either base: members the bases themselves define (`input`, `setup`) are machinery,
+    // never dispatchable keys — for model and custom filters alike.
+    while (proto !== null &&
+        proto !== BaseModelFilter.prototype &&
+        proto !== BaseFilter.prototype &&
+        proto !== Object.prototype) {
+        for (const name of Object.getOwnPropertyNames(proto)) {
+            if (RESERVED_METHODS.has(name) || blacklist.has(name) || bound.has(name))
+                continue;
+            if (name.startsWith('$') || name.startsWith('_'))
+                continue;
+            const descriptor = Object.getOwnPropertyDescriptor(proto, name);
+            if (typeof descriptor?.value === 'function')
+                keys.add(name);
+        }
+        proto = Object.getPrototypeOf(proto);
+    }
+    KEY_CACHE.set(cls, keys);
+    return keys;
+}
+/**
+ * The `@filterFor` bindings a class declares: request key → method, and the set of methods that
+ * are bound (and so no longer answer to their own name).
+ *
+ * Memoized per class alongside the dispatch keys — decorators run at class-definition time, long
+ * before the first request reaches the class.
+ */
+function explicitBindings(cls) {
+    const cached = BINDING_CACHE.get(cls);
+    if (cached)
+        return cached;
+    const keys = new Map();
+    const methods = new Set();
+    const blacklist = new Set(statics(cls).blacklist ?? []);
+    for (const [method, bound] of Object.entries(readDecorators(cls).filterFor ?? {})) {
+        if (blacklist.has(method))
+            continue;
+        methods.add(method);
+        for (const key of bound)
+            keys.set(key, method);
+    }
+    const bindings = { keys, methods };
+    BINDING_CACHE.set(cls, bindings);
+    return bindings;
+}
+const BINDING_CACHE = new WeakMap();
+const KEY_CACHE = new WeakMap();
+const SPEC_CACHE = new WeakMap();
+/**
+ * Compile a filter class's static declarations into the {@link FilterSpec} the runner consumes —
+ * the same object `defineFilter` produces, so a class and a spec take the identical code path
+ * through allow-listing, search, sort and pagination.
+ *
+ * A class that declares no `filterable` is method-only: nothing reaches SQL except through the
+ * methods it wrote, which is the tightest allow-list there is.
+ *
+ * Memoized per class — the declaration is static, so it is compiled once per process.
+ */
+export function specFromFilterClass(cls) {
+    const cached = SPEC_CACHE.get(cls);
+    if (cached)
+        return cached;
+    const declared = declaredByModel(cls);
+    const spec = defineFilter({
+        ...declared,
+        filterable: statics(cls).filterable ?? declared.filterable ?? [],
+        ...pick(cls, [
+            'model',
+            'sortable',
+            'searchable',
+            'relations',
+            'aliases',
+            'computed',
+            'fieldTypes',
+            'fullText',
+            'vectorSimilarity',
+            'tenant',
+            'defaultFilters',
+            'defaultSort',
+            'defaultSize',
+            'maxSize',
+            'maxDepth',
+            'table',
+            'throwOnInvalid',
+        ]),
+    });
+    SPEC_CACHE.set(cls, spec);
+    return spec;
+}
+/**
+ * What the model itself declares through `@filterable` / `@sortable` / `@searchable` on its
+ * columns, read off the filter's `static model`.
+ *
+ * These are **fallbacks**: a static on the filter class replaces the corresponding list outright,
+ * so a stricter filter over a shared model can narrow what the model opens up. Only `fieldTypes`
+ * merges per field — it is metadata about a column, not a decision about who may reach it.
+ */
+function declaredByModel(cls) {
+    const model = statics(cls).model;
+    if (!model)
+        return {};
+    const declared = readDecorators(model);
+    const out = {};
+    if (declared.filterable) {
+        out.filterable = Object.keys(declared.filterable);
+        const fieldTypes = {};
+        for (const [column, kind] of Object.entries(declared.filterable)) {
+            if (kind !== null)
+                fieldTypes[column] = { kind };
+        }
+        const merged = { ...fieldTypes, ...statics(cls).fieldTypes };
+        if (Object.keys(merged).length > 0)
+            out.fieldTypes = merged;
+    }
+    if (declared.sortable)
+        out.sortable = [...new Set(declared.sortable)];
+    if (declared.searchable)
+        out.searchable = [...new Set(declared.searchable)];
+    return out;
+}
+function pick(cls, names) {
+    const out = {};
+    const statics = cls;
+    for (const name of names) {
+        const value = statics[name];
+        if (value !== undefined)
+            out[name] = value;
+    }
+    return out;
+}
+/**
+ * Find the method a request key maps to, honouring the class's `camelCase` (a `snake_case` key
+ * matches a camelCase method — on by default) and `dropId` (`companyId` matches `company`) knobs.
+ * Returns the method name, or `undefined` when the class does not own the key.
+ */
+export function methodForKey(cls, key) {
+    if (typeof key !== 'string' || key.length === 0 || RESERVED_KEYS.has(key))
+        return undefined;
+    const bound = explicitBindings(cls).keys.get(key);
+    if (bound !== undefined)
+        return bound;
+    const keys = dispatchKeys(cls);
+    if (keys.has(key))
+        return key;
+    const knobs = statics(cls);
+    if (knobs.camelCase !== false) {
+        const camel = toCamelCase(key);
+        if (keys.has(camel))
+            return camel;
+        if (knobs.dropId === true) {
+            const dropped = stripId(camel);
+            if (dropped.length > 0 && keys.has(dropped))
+                return dropped;
+        }
+    }
+    if (knobs.dropId === true) {
+        const dropped = stripId(key);
+        if (dropped.length > 0 && keys.has(dropped))
+            return dropped;
+    }
+    return undefined;
+}
+function toCamelCase(key) {
+    const result = key.replace(/[_-](\w)/g, (_, char) => char.toUpperCase());
+    return result.charAt(0).toLowerCase() + result.slice(1);
+}
+function stripId(key) {
+    if (key === 'id')
+        return '';
+    if (key.endsWith('Id'))
+        return key.slice(0, -2);
+    if (key.endsWith('_id'))
+        return key.slice(0, -3);
+    return key;
+}
+/** Is this key one the wire format owns (so it is never dispatched to a method)? */
+export function isReservedKey(key) {
+    return RESERVED_KEYS.has(key);
+}
+//# sourceMappingURL=filter_class.js.map

package/dist/src/filter_class.js.map

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