@adonis-agora/filter 0.0.0-beta-20261110131309

package/dist/src/apply_from_request.d.ts

@@ -0,0 +1,85 @@
+import type { ResolvedCursor } from './cursor.js';
+import { type FilterClass } from './filter_class.js';
+import { type FilterSpec } from './filter_spec.js';
+import { type QueryBuilderLike } from './lucid_adapter.js';
+import { type ResolvedPagination } from './runner.js';
+import type { FilterInput } from './types.js';
+/**
+ * The structural slice of an AdonisJS `HttpContext` these helpers read. Only
+ * `request.qs()` (the decoded query string) is used to source the raw input;
+ * the whole ctx is also handed to a spec's tenant resolver. Declared
+ * structurally so the package never hard-imports `@adonisjs/core` — a real
+ * `HttpContext` satisfies it, and tests can pass a plain object.
+ */
+export interface FilterRequestContext {
+    request?: {
+        qs?: () => Record<string, unknown>;
+    };
+    [key: string]: any;
+}
+/** Options shared by the request-driven helpers. */
+export interface ApplyFromRequestOptions {
+    /**
+     * Pre-parsed input to use instead of reading `ctx.request.qs()`. Useful for
+     * non-HTTP callers and tests; when omitted the query string is parsed via
+     * {@link parseFilterRequest}.
+     */
+    input?: FilterInput;
+    /**
+     * Query embedding for pgvector embedding-similarity ranking (distinct from the
+     * text `search`). The idiomatic path: the controller computes it from an
+     * embedding service and passes it here (rather than shipping a large float
+     * array through the query string). Ignored unless the spec declares a
+     * `vectorSimilarity` column; merged over any `input.vectorSimilarity`.
+     */
+    vectorSimilarity?: readonly number[];
+}
+/** Options for {@link applyCursorFromRequest}. */
+export interface ApplyCursorFromRequestOptions extends ApplyFromRequestOptions {
+    /** Primary-key column appended to the keyset as a stable tiebreaker. Default `'id'`. */
+    primaryKey?: string;
+}
+/**
+ * Apply the server-side, non-client-tamperable scope to the query BEFORE the
+ * allow-listed request filters: the tenant constraint (when the spec declares
+ * one and a tenant id resolves from ctx) and any `defaultFilters`. These bypass
+ * the allow-list on purpose — they are trusted server policy, mirroring how the
+ * NestJS runner applied `@TenantScoped` via the adapter's auto-field path.
+ */
+export declare function applyServerScope(query: QueryBuilderLike, spec: FilterSpec, ctx: FilterRequestContext | undefined): void;
+/**
+ * Apply a {@link FilterSpec} to a Lucid query from a request context, returning
+ * the resolved offset pagination — the single explicit call an AdonisJS
+ * controller makes (the idiomatic replacement for the NestJS
+ * `ApplyFilterInterceptor` + `@ApplyFilter` param decorator).
+ *
+ * It resolves the request input from `ctx.request.qs()`, injects the server
+ * scope (tenant + default filters) that is never exposed to the allow-list, and
+ * delegates the allow-listed filter/sort/search + pagination resolution to
+ * {@link applyFilter}.
+ *
+ * ```ts
+ * const spec = defineFilter({ filterable: ['name', 'age'], tenant: { column: 'tenantId', resolve: (ctx) => ctx.auth.user.tenantId } })
+ *
+ * // in a controller:
+ * const query = User.query()
+ * const { page, size } = applyFilterFromRequest(query, spec, ctx)
+ * return query.paginate(page, size)
+ * ```
+ */
+export declare function applyFilterFromRequest(query: QueryBuilderLike, spec: FilterSpec, ctx: FilterRequestContext | undefined, options?: ApplyFromRequestOptions): ResolvedPagination;
+/**
+ * The class form: the filter is resolved through the IoC container (so an `@inject()`ed
+ * constructor works), its `setup()` runs before anything the request asked for, and every request
+ * key the class owns a method for is dispatched to that method instead of the declarative path.
+ * Resolution is async, so this overload returns a promise.
+ */
+export declare function applyFilterFromRequest(query: QueryBuilderLike, filter: FilterClass, ctx: FilterRequestContext | undefined, options?: ApplyFromRequestOptions): Promise<ResolvedPagination>;
+/**
+ * The keyset (cursor) counterpart of {@link applyFilterFromRequest}. Sources the
+ * request filters and the `after`/`before`/`first`/`last` cursor params from ctx,
+ * injects the same server scope, and delegates to {@link applyCursor}. Feed the
+ * fetched rows and the returned {@link ResolvedCursor} to `buildCursorPage`.
+ */
+export declare function applyCursorFromRequest(query: QueryBuilderLike, spec: FilterSpec, ctx: FilterRequestContext | undefined, options?: ApplyCursorFromRequestOptions): ResolvedCursor;
+//# sourceMappingURL=apply_from_request.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"apply_from_request.d.ts","sourceRoot":"","sources":["../../src/apply_from_request.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAgB,cAAc,EAAE,MAAM,aAAa,CAAC;AAChE,OAAO,EACL,KAAK,WAAW,EAIjB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAE,KAAK,UAAU,EAAsB,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAsB,KAAK,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAG/E,OAAO,EAA+C,KAAK,kBAAkB,EAAE,MAAM,aAAa,CAAC;AACnG,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;GAMG;AACH,MAAM,WAAW,oBAAoB;IACnC,OAAO,CAAC,EAAE;QAAE,EAAE,CAAC,EAAE,MAAM,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,CAAC;IAEjD,CAAC,GAAG,EAAE,MAAM,GAAG,GAAG,CAAC;CACpB;AAED,oDAAoD;AACpD,MAAM,WAAW,uBAAuB;IACtC;;;;OAIG;IACH,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB;;;;;;OAMG;IACH,gBAAgB,CAAC,EAAE,SAAS,MAAM,EAAE,CAAC;CACtC;AAED,kDAAkD;AAClD,MAAM,WAAW,6BAA8B,SAAQ,uBAAuB;IAC5E,wFAAwF;IACxF,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AASD;;;;;;GAMG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,oBAAoB,GAAG,SAAS,GACpC,IAAI,CAeN;AAUD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,oBAAoB,GAAG,SAAS,EACrC,OAAO,CAAC,EAAE,uBAAuB,GAChC,kBAAkB,CAAC;AACtB;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,MAAM,EAAE,WAAW,EACnB,GAAG,EAAE,oBAAoB,GAAG,SAAS,EACrC,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAAC;AAyI/B;;;;;GAKG;AACH,wBAAgB,sBAAsB,CACpC,KAAK,EAAE,gBAAgB,EACvB,IAAI,EAAE,UAAU,EAChB,GAAG,EAAE,oBAAoB,GAAG,SAAS,EACrC,OAAO,GAAE,6BAAkC,GAC1C,cAAc,CAahB"}

package/dist/src/apply_from_request.js

@@ -0,0 +1,164 @@
+import { isFilterClass, methodForKey, specFromFilterClass, } from './filter_class.js';
+import { specToFilterConfig } from './filter_spec.js';
+import { applyColumnFilters } from './lucid_adapter.js';
+import { parseFilterRequest } from './parse_request.js';
+import { applyCursor, applyFilter } from './runner.js';
+/** Read the decoded query string off the ctx (empty object when absent). */
+function rawQs(ctx) {
+    const qs = ctx?.request?.qs;
+    if (typeof qs === 'function')
+        return qs.call(ctx?.request) ?? {};
+    return {};
+}
+/**
+ * Apply the server-side, non-client-tamperable scope to the query BEFORE the
+ * allow-listed request filters: the tenant constraint (when the spec declares
+ * one and a tenant id resolves from ctx) and any `defaultFilters`. These bypass
+ * the allow-list on purpose — they are trusted server policy, mirroring how the
+ * NestJS runner applied `@TenantScoped` via the adapter's auto-field path.
+ */
+export function applyServerScope(query, spec, ctx) {
+    const serverFilters = [];
+    if (spec.tenant) {
+        const tenantId = spec.tenant.resolve(ctx);
+        if (tenantId !== undefined && tenantId !== null) {
+            serverFilters.push({ field: spec.tenant.column, operator: 'equals', value: tenantId });
+        }
+    }
+    if (spec.defaultFilters.length > 0) {
+        serverFilters.push(...spec.defaultFilters);
+    }
+    if (serverFilters.length > 0) {
+        applyColumnFilters(query, serverFilters);
+    }
+}
+/** Fall back to the spec's `defaultSort` when the request supplied no sort. */
+function withDefaultSort(input, spec) {
+    if ((!input.sort || input.sort.length === 0) && spec.defaultSort.length > 0) {
+        return { ...input, sort: [...spec.defaultSort] };
+    }
+    return input;
+}
+export function applyFilterFromRequest(query, specOrClass, ctx, options = {}) {
+    if (isFilterClass(specOrClass)) {
+        return applyFilterClass(query, specOrClass, ctx, options);
+    }
+    return applySpec(query, specOrClass, ctx, options);
+}
+function applySpec(query, spec, ctx, options) {
+    const parsed = options.input ?? parseFilterRequest(rawQs(ctx));
+    const withVector = options.vectorSimilarity !== undefined
+        ? { ...parsed, vectorSimilarity: options.vectorSimilarity }
+        : parsed;
+    applyServerScope(query, spec, ctx);
+    return applyFilter(query, withDefaultSort(withVector, spec), specToFilterConfig(spec));
+}
+/**
+ * Resolve a filter class through the request's IoC container when there is one — the same
+ * resolver a controller is constructed with, so `@inject()` on the filter behaves identically —
+ * and fall back to plain construction outside an AdonisJS request (a test, a script).
+ */
+async function resolveFilter(cls, ctx) {
+    const resolver = ctx?.containerResolver;
+    if (resolver && typeof resolver.make === 'function') {
+        return (await resolver.make(cls));
+    }
+    return new cls();
+}
+/**
+ * Run a filter class against the query: bind the per-request state onto the instance, run
+ * `setup()`, apply everything the class declared statically through the ordinary spec path, then
+ * hand each key the class owns to its own method.
+ *
+ * The split matters: a key with a method is removed from the declarative input **before** the
+ * runner sees it, so `fullName` never becomes `where "fullName" = ?` on a column that may not
+ * exist — the method is the only thing that touches it.
+ */
+async function applyFilterClass(query, cls, ctx, options) {
+    const raw = rawQs(ctx);
+    const parsed = options.input ?? parseFilterRequest(raw);
+    const instance = await resolveFilter(cls, ctx);
+    const owned = [];
+    const rest = [];
+    for (const condition of parsed.filters ?? []) {
+        const method = methodForKey(cls, condition.field);
+        if (method === undefined) {
+            rest.push(condition);
+            continue;
+        }
+        owned.push({ method, value: condition.value, operator: condition.operator });
+    }
+    // A bare top-level key (`?minAge=21`) reaches a method of the same name too — the shape
+    // `adonis-lucid-filter` dispatches on — as long as the wire format does not own the key.
+    for (const [key, value] of Object.entries(raw)) {
+        const method = methodForKey(cls, key);
+        if (method !== undefined && !owned.some((entry) => entry.method === method)) {
+            owned.push({ method, value, operator: 'equals' });
+        }
+    }
+    Object.assign(instance, {
+        $query: query,
+        $input: raw,
+        $parsed: parsed,
+        $ctx: ctx,
+    });
+    await instance.setup?.();
+    const pagination = applySpec(query, specFromFilterClass(cls), ctx, {
+        ...options,
+        input: { ...parsed, filters: rest },
+    });
+    for (const { method, value, operator } of owned) {
+        const fn = instance[method];
+        if (typeof fn === 'function') {
+            await fn.call(instance, value, operator);
+        }
+    }
+    return pagination;
+}
+/** Parse cursor (keyset) params from a decoded query string (Spatie `page[...]` shapes). */
+function parseCursorParams(qs) {
+    const out = {};
+    const page = qs.page != null && typeof qs.page === 'object' && !Array.isArray(qs.page)
+        ? qs.page
+        : undefined;
+    const after = qs.after ?? page?.after;
+    const before = qs.before ?? page?.before;
+    if (typeof after === 'string' && after.length > 0)
+        out.after = after;
+    else if (typeof before === 'string' && before.length > 0)
+        out.before = before;
+    const first = qs.first ?? page?.first;
+    const last = qs.last ?? page?.last;
+    const toInt = (v) => {
+        const n = typeof v === 'number' ? v : typeof v === 'string' && v.trim() !== '' ? Number(v) : Number.NaN;
+        return Number.isFinite(n) ? n : undefined;
+    };
+    const f = toInt(first);
+    const l = toInt(last);
+    if (f !== undefined)
+        out.first = f;
+    if (l !== undefined)
+        out.last = l;
+    return out;
+}
+/**
+ * The keyset (cursor) counterpart of {@link applyFilterFromRequest}. Sources the
+ * request filters and the `after`/`before`/`first`/`last` cursor params from ctx,
+ * injects the same server scope, and delegates to {@link applyCursor}. Feed the
+ * fetched rows and the returned {@link ResolvedCursor} to `buildCursorPage`.
+ */
+export function applyCursorFromRequest(query, spec, ctx, options = {}) {
+    const qs = rawQs(ctx);
+    const parsed = options.input ?? parseFilterRequest(qs);
+    const full = {
+        ...withDefaultSort(parsed, spec),
+        ...parseCursorParams(qs),
+    };
+    applyServerScope(query, spec, ctx);
+    const config = {
+        ...specToFilterConfig(spec),
+        ...(options.primaryKey !== undefined && { primaryKey: options.primaryKey }),
+    };
+    return applyCursor(query, full, config);
+}
+//# sourceMappingURL=apply_from_request.js.map

package/dist/src/apply_from_request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"apply_from_request.js","sourceRoot":"","sources":["../../src/apply_from_request.ts"],"names":[],"mappings":"AAEA,OAAO,EAEL,aAAa,EACb,YAAY,EACZ,mBAAmB,GACpB,MAAM,mBAAmB,CAAC;AAC3B,OAAO,EAAmB,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACvE,OAAO,EAAE,kBAAkB,EAAyB,MAAM,oBAAoB,CAAC;AAE/E,OAAO,EAAE,kBAAkB,EAAE,MAAM,oBAAoB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,WAAW,EAA8C,MAAM,aAAa,CAAC;AAwCnG,4EAA4E;AAC5E,SAAS,KAAK,CAAC,GAAqC;IAClD,MAAM,EAAE,GAAG,GAAG,EAAE,OAAO,EAAE,EAAE,CAAC;IAC5B,IAAI,OAAO,EAAE,KAAK,UAAU;QAAE,OAAO,EAAE,CAAC,IAAI,CAAC,GAAG,EAAE,OAAO,CAAC,IAAI,EAAE,CAAC;IACjE,OAAO,EAAE,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,gBAAgB,CAC9B,KAAuB,EACvB,IAAgB,EAChB,GAAqC;IAErC,MAAM,aAAa,GAAmB,EAAE,CAAC;IAEzC,IAAI,IAAI,CAAC,MAAM,EAAE,CAAC;QAChB,MAAM,QAAQ,GAAG,IAAI,CAAC,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;QAC1C,IAAI,QAAQ,KAAK,SAAS,IAAI,QAAQ,KAAK,IAAI,EAAE,CAAC;YAChD,aAAa,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,IAAI,CAAC,MAAM,CAAC,MAAM,EAAE,QAAQ,EAAE,QAAQ,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC;QACzF,CAAC;IACH,CAAC;IACD,IAAI,IAAI,CAAC,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACnC,aAAa,CAAC,IAAI,CAAC,GAAI,IAAI,CAAC,cAAiC,CAAC,CAAC;IACjE,CAAC;IACD,IAAI,aAAa,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC7B,kBAAkB,CAAC,KAAK,EAAE,aAAa,CAAC,CAAC;IAC3C,CAAC;AACH,CAAC;AAED,+EAA+E;AAC/E,SAAS,eAAe,CAAC,KAAkB,EAAE,IAAgB;IAC3D,IAAI,CAAC,CAAC,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,IAAI,CAAC,MAAM,KAAK,CAAC,CAAC,IAAI,IAAI,CAAC,WAAW,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC5E,OAAO,EAAE,GAAG,KAAK,EAAE,IAAI,EAAE,CAAC,GAAG,IAAI,CAAC,WAAW,CAAC,EAAE,CAAC;IACnD,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAwCD,MAAM,UAAU,sBAAsB,CACpC,KAAuB,EACvB,WAAqC,EACrC,GAAqC,EACrC,OAAO,GAA4B,EAAE;IAErC,IAAI,aAAa,CAAC,WAAW,CAAC,EAAE,CAAC;QAC/B,OAAO,gBAAgB,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;IAC5D,CAAC;IACD,OAAO,SAAS,CAAC,KAAK,EAAE,WAAW,EAAE,GAAG,EAAE,OAAO,CAAC,CAAC;AACrD,CAAC;AAED,SAAS,SAAS,CAChB,KAAuB,EACvB,IAAgB,EAChB,GAAqC,EACrC,OAAgC;IAEhC,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IAC/D,MAAM,UAAU,GACd,OAAO,CAAC,gBAAgB,KAAK,SAAS;QACpC,CAAC,CAAC,EAAE,GAAG,MAAM,EAAE,gBAAgB,EAAE,OAAO,CAAC,gBAAgB,EAAE;QAC3D,CAAC,CAAC,MAAM,CAAC;IACb,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,OAAO,WAAW,CAAC,KAAK,EAAE,eAAe,CAAC,UAAU,EAAE,IAAI,CAAC,EAAE,kBAAkB,CAAC,IAAI,CAAC,CAAC,CAAC;AACzF,CAAC;AAED;;;;GAIG;AACH,KAAK,UAAU,aAAa,CAC1B,GAAgB,EAChB,GAAqC;IAErC,MAAM,QAAQ,GAAG,GAAG,EAAE,iBAET,CAAC;IACd,IAAI,QAAQ,IAAI,OAAO,QAAQ,CAAC,IAAI,KAAK,UAAU,EAAE,CAAC;QACpD,OAAO,CAAC,MAAM,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,CAAoB,CAAC;IACvD,CAAC;IACD,OAAO,IAAI,GAAG,EAAE,CAAC;AACnB,CAAC;AAED;;;;;;;;GAQG;AACH,KAAK,UAAU,gBAAgB,CAC7B,KAAuB,EACvB,GAAgB,EAChB,GAAqC,EACrC,OAAgC;IAEhC,MAAM,GAAG,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACvB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAAC,GAAG,CAAC,CAAC;IACxD,MAAM,QAAQ,GAAG,MAAM,aAAa,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;IAE/C,MAAM,KAAK,GAA2D,EAAE,CAAC;IACzE,MAAM,IAAI,GAAmB,EAAE,CAAC;IAChC,KAAK,MAAM,SAAS,IAAI,MAAM,CAAC,OAAO,IAAI,EAAE,EAAE,CAAC;QAC7C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,SAAS,CAAC,KAAK,CAAC,CAAC;QAClD,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,IAAI,CAAC,IAAI,CAAC,SAAS,CAAC,CAAC;YACrB,SAAS;QACX,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,CAAC,KAAK,EAAE,QAAQ,EAAE,SAAS,CAAC,QAAQ,EAAE,CAAC,CAAC;IAC/E,CAAC;IAED,wFAAwF;IACxF,yFAAyF;IACzF,KAAK,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC;QACtC,IAAI,MAAM,KAAK,SAAS,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC;YAC5E,KAAK,CAAC,IAAI,CAAC,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,QAAQ,EAAE,CAAC,CAAC;QACpD,CAAC;IACH,CAAC;IAED,MAAM,CAAC,MAAM,CAAC,QAAQ,EAAE;QACtB,MAAM,EAAE,KAAK;QACb,MAAM,EAAE,GAAG;QACX,OAAO,EAAE,MAAM;QACf,IAAI,EAAE,GAAG;KACV,CAAC,CAAC;IAEH,MAAM,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC;IAEzB,MAAM,UAAU,GAAG,SAAS,CAAC,KAAK,EAAE,mBAAmB,CAAC,GAAG,CAAC,EAAE,GAAG,EAAE;QACjE,GAAG,OAAO;QACV,KAAK,EAAE,EAAE,GAAG,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;KACpC,CAAC,CAAC;IAEH,KAAK,MAAM,EAAE,MAAM,EAAE,KAAK,EAAE,QAAQ,EAAE,IAAI,KAAK,EAAE,CAAC;QAChD,MAAM,EAAE,GAAI,QAA+C,CAAC,MAAM,CAAC,CAAC;QACpE,IAAI,OAAO,EAAE,KAAK,UAAU,EAAE,CAAC;YAC7B,MAAO,EAA0C,CAAC,IAAI,CAAC,QAAQ,EAAE,KAAK,EAAE,QAAQ,CAAC,CAAC;QACpF,CAAC;IACH,CAAC;IAED,OAAO,UAAU,CAAC;AACpB,CAAC;AAED,4FAA4F;AAC5F,SAAS,iBAAiB,CAAC,EAA2B;IACpD,MAAM,GAAG,GAAiB,EAAE,CAAC;IAC7B,MAAM,IAAI,GACR,EAAE,CAAC,IAAI,IAAI,IAAI,IAAI,OAAO,EAAE,CAAC,IAAI,KAAK,QAAQ,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,EAAE,CAAC,IAAI,CAAC;QACvE,CAAC,CAAE,EAAE,CAAC,IAAgC;QACtC,CAAC,CAAC,SAAS,CAAC;IAEhB,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,IAAI,IAAI,EAAE,KAAK,CAAC;IACtC,MAAM,MAAM,GAAG,EAAE,CAAC,MAAM,IAAI,IAAI,EAAE,MAAM,CAAC;IACzC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,KAAK,GAAG,KAAK,CAAC;SAChE,IAAI,OAAO,MAAM,KAAK,QAAQ,IAAI,MAAM,CAAC,MAAM,GAAG,CAAC;QAAE,GAAG,CAAC,MAAM,GAAG,MAAM,CAAC;IAE9E,MAAM,KAAK,GAAG,EAAE,CAAC,KAAK,IAAI,IAAI,EAAE,KAAK,CAAC;IACtC,MAAM,IAAI,GAAG,EAAE,CAAC,IAAI,IAAI,IAAI,EAAE,IAAI,CAAC;IACnC,MAAM,KAAK,GAAG,CAAC,CAAU,EAAsB,EAAE;QAC/C,MAAM,CAAC,GACL,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,IAAI,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC;QAChG,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC;IAC5C,CAAC,CAAC;IACF,MAAM,CAAC,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC;IACvB,MAAM,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,CAAC;IACtB,IAAI,CAAC,KAAK,SAAS;QAAE,GAAG,CAAC,KAAK,GAAG,CAAC,CAAC;IACnC,IAAI,CAAC,KAAK,SAAS;QAAE,GAAG,CAAC,IAAI,GAAG,CAAC,CAAC;IAElC,OAAO,GAAG,CAAC;AACb,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,sBAAsB,CACpC,KAAuB,EACvB,IAAgB,EAChB,GAAqC,EACrC,OAAO,GAAkC,EAAE;IAE3C,MAAM,EAAE,GAAG,KAAK,CAAC,GAAG,CAAC,CAAC;IACtB,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,IAAI,kBAAkB,CAAC,EAAE,CAAC,CAAC;IACvD,MAAM,IAAI,GAA+B;QACvC,GAAG,eAAe,CAAC,MAAM,EAAE,IAAI,CAAC;QAChC,GAAG,iBAAiB,CAAC,EAAE,CAAC;KACzB,CAAC;IACF,gBAAgB,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,CAAC,CAAC;IACnC,MAAM,MAAM,GAAiB;QAC3B,GAAG,kBAAkB,CAAC,IAAI,CAAC;QAC3B,GAAG,CAAC,OAAO,CAAC,UAAU,KAAK,SAAS,IAAI,EAAE,UAAU,EAAE,OAAO,CAAC,UAAU,EAAE,CAAC;KAC5E,CAAC;IACF,OAAO,WAAW,CAAC,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;AAC1C,CAAC"}

package/dist/src/base_filter.d.ts

@@ -0,0 +1,49 @@
+import type { FilterInput } from './types.js';
+/**
+ * The class-authoring form of a filter over ANY backend — the generic base behind
+ * {@link import('./base_model_filter.js').BaseModelFilter} (Lucid) and custom backends
+ * (in-memory stores, engine clients, predicate bags) alike: **one style that does everything**.
+ *
+ * A method's name IS the key it owns, `setup()` runs on every call before anything the request
+ * asked for, and the class is resolved through the IoC container so an `@inject()`ed constructor
+ * works — exactly the shape AdonisJS developers know from `adonis-lucid-filter`. What differs per
+ * backend is only what `$query` IS: a Lucid builder for models, a draft the methods narrow for
+ * anything else.
+ *
+ * ```ts
+ * export class RunFilter extends BaseFilter<RunQueryDraft> {
+ *   declare $query: RunQueryDraft;
+ *
+ *   status(value: unknown, operator: string) {
+ *     const values = (Array.isArray(value) ? value : [value]).map(String);
+ *     this.$query.narrow(values.length === 1 ? { status: values[0] } : { statuses: values });
+ *   }
+ * }
+ *
+ * const draft = new RunQueryDraft();
+ * await applyCustomFilter(draft, RunFilter, ctx);
+ * ```
+ */
+export declare abstract class BaseFilter<TQuery> {
+    /**
+     * The query being filtered — the one the caller created. Methods mutate it directly; nothing
+     * here constructs or executes a query.
+     */
+    $query: TQuery;
+    /** The raw decoded request input the dispatch reads (query string, or the body on a POST). */
+    $input: Readonly<Record<string, unknown>>;
+    /** The parsed input — filters, sort, search, pagination — after the wire format is read. */
+    $parsed: FilterInput;
+    /** The request context handed to the call (a real `HttpContext` in an AdonisJS app). */
+    $ctx: unknown;
+    /**
+     * Runs on every filter call, before anything the request asked for — the place for defaults
+     * and for constraints the client must not be able to relax.
+     */
+    setup?(): void | Promise<void>;
+    /** The whole raw input, one key of it, or a fallback when the key is absent. */
+    input(): Readonly<Record<string, unknown>>;
+    input(key: string): unknown;
+    input(key: string, fallback: unknown): unknown;
+}
+//# sourceMappingURL=base_filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base_filter.d.ts","sourceRoot":"","sources":["../../src/base_filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,YAAY,CAAC;AAE9C;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,8BAAsB,UAAU,CAAC,MAAM;IACrC;;;OAGG;IACK,MAAM,EAAE,MAAM,CAAC;IAEvB,8FAA8F;IACtF,MAAM,EAAE,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAElD,4FAA4F;IACpF,OAAO,EAAE,WAAW,CAAC;IAE7B,wFAAwF;IAChF,IAAI,EAAE,OAAO,CAAC;IAEtB;;;OAGG;IACH,KAAK,CAAC,IAAI,IAAI,GAAG,OAAO,CAAC,IAAI,CAAC,CAAC;IAE/B,gFAAgF;IAChF,KAAK,IAAI,QAAQ,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC;IAC3C,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;IAC5B,KAAK,CAAC,GAAG,EAAE,MAAM,EAAE,QAAQ,EAAE,OAAO,GAAG,OAAO,CAAC;CAKhD"}

package/dist/src/base_filter.js

@@ -0,0 +1,33 @@
+/**
+ * The class-authoring form of a filter over ANY backend — the generic base behind
+ * {@link import('./base_model_filter.js').BaseModelFilter} (Lucid) and custom backends
+ * (in-memory stores, engine clients, predicate bags) alike: **one style that does everything**.
+ *
+ * A method's name IS the key it owns, `setup()` runs on every call before anything the request
+ * asked for, and the class is resolved through the IoC container so an `@inject()`ed constructor
+ * works — exactly the shape AdonisJS developers know from `adonis-lucid-filter`. What differs per
+ * backend is only what `$query` IS: a Lucid builder for models, a draft the methods narrow for
+ * anything else.
+ *
+ * ```ts
+ * export class RunFilter extends BaseFilter<RunQueryDraft> {
+ *   declare $query: RunQueryDraft;
+ *
+ *   status(value: unknown, operator: string) {
+ *     const values = (Array.isArray(value) ? value : [value]).map(String);
+ *     this.$query.narrow(values.length === 1 ? { status: values[0] } : { statuses: values });
+ *   }
+ * }
+ *
+ * const draft = new RunQueryDraft();
+ * await applyCustomFilter(draft, RunFilter, ctx);
+ * ```
+ */
+export class BaseFilter {
+    input(key, fallback) {
+        if (key === undefined)
+            return this.$input;
+        return Object.hasOwn(this.$input, key) ? this.$input[key] : fallback;
+    }
+}
+//# sourceMappingURL=base_filter.js.map

package/dist/src/base_filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_filter.js","sourceRoot":"","sources":["../../src/base_filter.ts"],"names":[],"mappings":"AAEA;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,MAAM,OAAgB,UAAU;IA0B9B,KAAK,CAAC,GAAY,EAAE,QAAkB;QACpC,IAAI,GAAG,KAAK,SAAS;YAAE,OAAO,IAAI,CAAC,MAAM,CAAC;QAC1C,OAAO,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;IACvE,CAAC;CACF"}

package/dist/src/base_model_filter.d.ts

@@ -0,0 +1,90 @@
+import type { LucidModelLike } from './aggregate.js';
+import { BaseFilter } from './base_filter.js';
+import type { FieldAliases } from './field_aliases.js';
+import type { FilterableInput, RelationColumns, RelationSpec, TenantScopeSpec } from './filter_spec.js';
+import type { FilterFieldTypeInfo } from './generate_client.js';
+import type { QueryBuilderLike } from './lucid_adapter.js';
+import type { ColumnFilter } from './operators.js';
+import type { ComputedFields, FullTextSearchConfig, SortItem, VectorSimilarityConfig } from './types.js';
+/**
+ * The class-authoring form of a filter — the counterpart of `defineFilter`, in the shape
+ * AdonisJS developers already know from `adonis-lucid-filter`: **a method per request key**,
+ * with the query builder on `this.$query`.
+ *
+ * A method's name IS the key it owns. `?filter[fullName]=silva` calls `fullName('silva')`, and
+ * because you wrote the method, the key needs no allow-list entry — writing the code is the
+ * decision to expose it. Plain columns that need no custom SQL stay declarative: list them in
+ * `static filterable` and the runner applies the operators, search, sort and pagination for you.
+ *
+ * The class is resolved through the IoC container, so an `@inject()`ed constructor works: a
+ * filter can depend on a service exactly like a controller does.
+ *
+ * ```ts
+ * @inject()
+ * export default class UserFilter extends BaseModelFilter {
+ *   declare $query: ModelQueryBuilderContract<typeof User>
+ *
+ *   constructor(private tenants: TenantsService) { super() }
+ *
+ *   static model = User
+ *   static filterable = ['name', 'email', 'status']
+ *   static sortable = ['name', 'createdAt']
+ *   static searchable = ['name', 'email']
+ *
+ *   // always applied, before anything the request asked for
+ *   setup() {
+ *     this.$query.where('tenantId', this.tenants.current(this.$ctx))
+ *   }
+ *
+ *   // the one key this class owns itself
+ *   fullName(value: string) {
+ *     this.$query.whereILike('full_name', `%${value}%`)
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class BaseModelFilter<Q extends QueryBuilderLike = QueryBuilderLike> extends BaseFilter<Q> {
+    /** The owning Lucid model. Unlocks to-many aggregates and supplies the root table name. */
+    static model?: LucidModelLike;
+    /** Columns clients may filter on with the standard operators. `'*'` allows any base column. */
+    static filterable?: FilterableInput;
+    /** Columns clients may sort on. Defaults to `filterable`. */
+    static sortable?: RelationColumns;
+    /** Columns the free-text `search` term scans with a portable ILIKE. */
+    static searchable?: string[];
+    /** Whitelisted relations and the columns reachable through them. */
+    static relations?: Record<string, RelationSpec>;
+    /** Client-alias → target-field remapping. */
+    static aliases?: FieldAliases;
+    /** Virtual fields — alias → SQL expression. */
+    static computed?: ComputedFields;
+    /** Per-field value kinds, driving coercion and typed client codegen. */
+    static fieldTypes?: Record<string, FilterFieldTypeInfo>;
+    /** Opt-in Postgres tsvector search for the `search` term. */
+    static fullText?: FullTextSearchConfig;
+    /** Opt-in pgvector embedding-similarity ordering. */
+    static vectorSimilarity?: VectorSimilarityConfig;
+    /** Auto-scope a column to the tenant resolved from ctx (the declarative form of `setup`). */
+    static tenant?: TenantScopeSpec;
+    /** Server-declared filters always AND-combined with the request. */
+    static defaultFilters?: ColumnFilter[];
+    /** Sort applied when the request carries none. */
+    static defaultSort?: SortItem[];
+    /** Page size when the request asks for none. Default 25. */
+    static defaultSize?: number;
+    /** Hard cap on page size. Default 100. */
+    static maxSize?: number;
+    /** Max relation-path hops. Defaults to the deepest declared relation nesting. */
+    static maxDepth?: number;
+    /** Root table name — defaults to `model.table`. */
+    static table?: string;
+    /** Throw `InvalidColumnFilterError` on a disallowed field instead of dropping it. */
+    static throwOnInvalid?: boolean;
+    /** Method names that must never be dispatched from request input, whatever the key says. */
+    static blacklist?: string[];
+    /** Strip a trailing `Id` from an input key before looking for a method (`companyId` → `company`). */
+    static dropId?: boolean;
+    /** Match `snake_case` input keys against camelCase methods (`first_name` → `firstName`). Default true. */
+    static camelCase?: boolean;
+}
+//# sourceMappingURL=base_model_filter.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"base_model_filter.d.ts","sourceRoot":"","sources":["../../src/base_model_filter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC;AACrD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,oBAAoB,CAAC;AACvD,OAAO,KAAK,EACV,eAAe,EACf,eAAe,EACf,YAAY,EACZ,eAAe,EAChB,MAAM,kBAAkB,CAAC;AAC1B,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,sBAAsB,CAAC;AAChE,OAAO,KAAK,EAAE,gBAAgB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,KAAK,EACV,cAAc,EACd,oBAAoB,EACpB,QAAQ,EACR,sBAAsB,EACvB,MAAM,YAAY,CAAC;AAEpB;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,8BAAsB,eAAe,CACnC,CAAC,SAAS,gBAAgB,GAAG,gBAAgB,CAC7C,SAAQ,UAAU,CAAC,CAAC,CAAC;IAGrB,2FAA2F;IAC3F,MAAM,CAAC,KAAK,CAAC,EAAE,cAAc,CAAC;IAC9B,+FAA+F;IAC/F,MAAM,CAAC,UAAU,CAAC,EAAE,eAAe,CAAC;IACpC,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,EAAE,eAAe,CAAC;IAClC,uEAAuE;IACvE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,oEAAoE;IACpE,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;IAChD,6CAA6C;IAC7C,MAAM,CAAC,OAAO,CAAC,EAAE,YAAY,CAAC;IAC9B,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAC,EAAE,cAAc,CAAC;IACjC,wEAAwE;IACxE,MAAM,CAAC,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,mBAAmB,CAAC,CAAC;IACxD,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAC,EAAE,oBAAoB,CAAC;IACvC,qDAAqD;IACrD,MAAM,CAAC,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IACjD,6FAA6F;IAC7F,MAAM,CAAC,MAAM,CAAC,EAAE,eAAe,CAAC;IAChC,oEAAoE;IACpE,MAAM,CAAC,cAAc,CAAC,EAAE,YAAY,EAAE,CAAC;IACvC,kDAAkD;IAClD,MAAM,CAAC,WAAW,CAAC,EAAE,QAAQ,EAAE,CAAC;IAChC,4DAA4D;IAC5D,MAAM,CAAC,WAAW,CAAC,EAAE,MAAM,CAAC;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,OAAO,CAAC,EAAE,MAAM,CAAC;IACxB,iFAAiF;IACjF,MAAM,CAAC,QAAQ,CAAC,EAAE,MAAM,CAAC;IACzB,mDAAmD;IACnD,MAAM,CAAC,KAAK,CAAC,EAAE,MAAM,CAAC;IACtB,qFAAqF;IACrF,MAAM,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;IAIhC,4FAA4F;IAC5F,MAAM,CAAC,SAAS,CAAC,EAAE,MAAM,EAAE,CAAC;IAC5B,qGAAqG;IACrG,MAAM,CAAC,MAAM,CAAC,EAAE,OAAO,CAAC;IACxB,0GAA0G;IAC1G,MAAM,CAAC,SAAS,CAAC,EAAE,OAAO,CAAC;CAC5B"}

package/dist/src/base_model_filter.js

@@ -0,0 +1,85 @@
+import { BaseFilter } from './base_filter.js';
+/**
+ * The class-authoring form of a filter — the counterpart of `defineFilter`, in the shape
+ * AdonisJS developers already know from `adonis-lucid-filter`: **a method per request key**,
+ * with the query builder on `this.$query`.
+ *
+ * A method's name IS the key it owns. `?filter[fullName]=silva` calls `fullName('silva')`, and
+ * because you wrote the method, the key needs no allow-list entry — writing the code is the
+ * decision to expose it. Plain columns that need no custom SQL stay declarative: list them in
+ * `static filterable` and the runner applies the operators, search, sort and pagination for you.
+ *
+ * The class is resolved through the IoC container, so an `@inject()`ed constructor works: a
+ * filter can depend on a service exactly like a controller does.
+ *
+ * ```ts
+ * @inject()
+ * export default class UserFilter extends BaseModelFilter {
+ *   declare $query: ModelQueryBuilderContract<typeof User>
+ *
+ *   constructor(private tenants: TenantsService) { super() }
+ *
+ *   static model = User
+ *   static filterable = ['name', 'email', 'status']
+ *   static sortable = ['name', 'createdAt']
+ *   static searchable = ['name', 'email']
+ *
+ *   // always applied, before anything the request asked for
+ *   setup() {
+ *     this.$query.where('tenantId', this.tenants.current(this.$ctx))
+ *   }
+ *
+ *   // the one key this class owns itself
+ *   fullName(value: string) {
+ *     this.$query.whereILike('full_name', `%${value}%`)
+ *   }
+ * }
+ * ```
+ */
+export class BaseModelFilter extends BaseFilter {
+    // ── the declarative half: everything a plain column needs, without writing a method ──────────
+    /** The owning Lucid model. Unlocks to-many aggregates and supplies the root table name. */
+    static model;
+    /** Columns clients may filter on with the standard operators. `'*'` allows any base column. */
+    static filterable;
+    /** Columns clients may sort on. Defaults to `filterable`. */
+    static sortable;
+    /** Columns the free-text `search` term scans with a portable ILIKE. */
+    static searchable;
+    /** Whitelisted relations and the columns reachable through them. */
+    static relations;
+    /** Client-alias → target-field remapping. */
+    static aliases;
+    /** Virtual fields — alias → SQL expression. */
+    static computed;
+    /** Per-field value kinds, driving coercion and typed client codegen. */
+    static fieldTypes;
+    /** Opt-in Postgres tsvector search for the `search` term. */
+    static fullText;
+    /** Opt-in pgvector embedding-similarity ordering. */
+    static vectorSimilarity;
+    /** Auto-scope a column to the tenant resolved from ctx (the declarative form of `setup`). */
+    static tenant;
+    /** Server-declared filters always AND-combined with the request. */
+    static defaultFilters;
+    /** Sort applied when the request carries none. */
+    static defaultSort;
+    /** Page size when the request asks for none. Default 25. */
+    static defaultSize;
+    /** Hard cap on page size. Default 100. */
+    static maxSize;
+    /** Max relation-path hops. Defaults to the deepest declared relation nesting. */
+    static maxDepth;
+    /** Root table name — defaults to `model.table`. */
+    static table;
+    /** Throw `InvalidColumnFilterError` on a disallowed field instead of dropping it. */
+    static throwOnInvalid;
+    // ── dispatch controls (the `adonis-lucid-filter` knobs) ──────────────────────────────────────
+    /** Method names that must never be dispatched from request input, whatever the key says. */
+    static blacklist;
+    /** Strip a trailing `Id` from an input key before looking for a method (`companyId` → `company`). */
+    static dropId;
+    /** Match `snake_case` input keys against camelCase methods (`first_name` → `firstName`). Default true. */
+    static camelCase;
+}
+//# sourceMappingURL=base_model_filter.js.map

package/dist/src/base_model_filter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"base_model_filter.js","sourceRoot":"","sources":["../../src/base_model_filter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAkB9C;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAoCG;AACH,MAAM,OAAgB,eAEpB,SAAQ,UAAa;IACrB,gGAAgG;IAEhG,2FAA2F;IAC3F,MAAM,CAAC,KAAK,CAAkB;IAC9B,+FAA+F;IAC/F,MAAM,CAAC,UAAU,CAAmB;IACpC,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAmB;IAClC,uEAAuE;IACvE,MAAM,CAAC,UAAU,CAAY;IAC7B,oEAAoE;IACpE,MAAM,CAAC,SAAS,CAAgC;IAChD,6CAA6C;IAC7C,MAAM,CAAC,OAAO,CAAgB;IAC9B,+CAA+C;IAC/C,MAAM,CAAC,QAAQ,CAAkB;IACjC,wEAAwE;IACxE,MAAM,CAAC,UAAU,CAAuC;IACxD,6DAA6D;IAC7D,MAAM,CAAC,QAAQ,CAAwB;IACvC,qDAAqD;IACrD,MAAM,CAAC,gBAAgB,CAA0B;IACjD,6FAA6F;IAC7F,MAAM,CAAC,MAAM,CAAmB;IAChC,oEAAoE;IACpE,MAAM,CAAC,cAAc,CAAkB;IACvC,kDAAkD;IAClD,MAAM,CAAC,WAAW,CAAc;IAChC,4DAA4D;IAC5D,MAAM,CAAC,WAAW,CAAU;IAC5B,0CAA0C;IAC1C,MAAM,CAAC,OAAO,CAAU;IACxB,iFAAiF;IACjF,MAAM,CAAC,QAAQ,CAAU;IACzB,mDAAmD;IACnD,MAAM,CAAC,KAAK,CAAU;IACtB,qFAAqF;IACrF,MAAM,CAAC,cAAc,CAAW;IAEhC,gGAAgG;IAEhG,4FAA4F;IAC5F,MAAM,CAAC,SAAS,CAAY;IAC5B,qGAAqG;IACrG,MAAM,CAAC,MAAM,CAAW;IACxB,0GAA0G;IAC1G,MAAM,CAAC,SAAS,CAAW;CAC5B"}

package/dist/src/coerce_value.d.ts

@@ -0,0 +1,26 @@
+import type { FilterFieldKind } from './types.js';
+/** Outcome of coercing one filter value against its declared {@link FilterFieldKind}. */
+export type CoerceResult = {
+    ok: true;
+    value: unknown;
+} | {
+    ok: false;
+    reason: string;
+};
+/**
+ * Coerce a raw filter value to its declared column kind, or reject it.
+ *
+ * Why this exists: a filter value arriving over a query string is ALWAYS a string
+ * (`?filter[dayOfWeek][equals]=3` yields `'3'`). Postgres papers over the benign cases with an
+ * implicit cast — `day_of_week = '3'` and `is_recurring = 'false'` both work — so the gap is
+ * invisible until a client sends something that ISN'T castable: `is_recurring = 'xyz'` raises
+ * `invalid input syntax for type boolean` at the database, which surfaces as a 500 on a public
+ * endpoint from pure user input. The allow-list guards which FIELD may be filtered; this guards
+ * what VALUE may reach the column.
+ *
+ * Rejection is not an exception here: the caller maps it onto the spec's existing `throwOnInvalid`
+ * semantics, so a bad value behaves exactly like a disallowed field — dropped by default, or a
+ * loud `InvalidColumnFilterError` (→ 400) when the spec asks for it.
+ */
+export declare function coerceFilterValue(value: unknown, kind: FilterFieldKind): CoerceResult;
+//# sourceMappingURL=coerce_value.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"coerce_value.d.ts","sourceRoot":"","sources":["../../src/coerce_value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,YAAY,CAAC;AAElD,yFAAyF;AACzF,MAAM,MAAM,YAAY,GAAG;IAAE,EAAE,EAAE,IAAI,CAAC;IAAC,KAAK,EAAE,OAAO,CAAA;CAAE,GAAG;IAAE,EAAE,EAAE,KAAK,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,CAAC;AAExF;;;;;;;;;;;;;;GAcG;AACH,wBAAgB,iBAAiB,CAAC,KAAK,EAAE,OAAO,EAAE,IAAI,EAAE,eAAe,GAAG,YAAY,CAgErF"}