@adonis-agora/filter 0.0.0-beta-20261110131309

package/dist/src/lucid_adapter.js

@@ -0,0 +1,469 @@
+import { escapeLike } from './escape-like.js';
+import { normalizeOperator } from './validate-column-filter.js';
+/** pgvector distance operator for each {@link VectorDistanceMetric}. */
+const VECTOR_OPERATORS = {
+    cosine: '<=>',
+    l2: '<->',
+    innerProduct: '<#>',
+};
+/** A safe SQL identifier: an unquoted column, optionally `table.column` qualified. */
+const SAFE_IDENTIFIER = /^[A-Za-z_][A-Za-z0-9_]*(\.[A-Za-z_][A-Za-z0-9_]*)*$/;
+/** Quote a (possibly dotted) identifier for Postgres, one segment at a time. */
+function quoteColumn(column) {
+    return column
+        .split('.')
+        .map((seg) => `"${seg}"`)
+        .join('.');
+}
+/**
+ * Serialize a numeric embedding to a pgvector literal (`[1,2,3]`). Returns `null`
+ * for an empty vector (a no-op signal). Throws on a non-finite component so a bad
+ * embedding fails loudly rather than emitting `NaN`/`Infinity` into SQL.
+ */
+function serializeVector(vector) {
+    if (vector.length === 0)
+        return null;
+    for (const n of vector) {
+        if (typeof n !== 'number' || !Number.isFinite(n)) {
+            throw new TypeError('Vector search embedding must contain only finite numbers.');
+        }
+    }
+    return `[${vector.join(',')}]`;
+}
+/**
+ * Apply an **embedding similarity** ordering (pgvector) to a Lucid query builder.
+ *
+ * This is *not* full-text search — it ranks rows by distance between a stored
+ * embedding column and a query *embedding vector*. For matching a text query
+ * string, use {@link applyFullTextSearch} instead.
+ *
+ * pgvector expresses similarity through raw distance operators (`<=>`, `<->`,
+ * `<#>`) that no structured query-builder method covers, so this drives the
+ * adapter's raw seam ({@link QueryBuilderLike.whereRaw}/`orderByRaw`) with the
+ * query embedding passed as a positional binding — the column name is the only
+ * interpolated fragment, and it is validated against a strict identifier charset
+ * so it can never carry injection. The distance expression is
+ * `<column> <op> ?::vector`, cast to `vector` so a text binding compares against
+ * the column.
+ *
+ * A no-op when the embedding is empty. When `order` is not `false`, rows are
+ * ordered nearest-first (ascending distance); `threshold` adds a max-distance
+ * filter; `topK` truncates to the K nearest.
+ */
+export function applyVectorSimilarity(qb, opts) {
+    const literal = serializeVector(opts.vector);
+    if (literal === null)
+        return;
+    if (!SAFE_IDENTIFIER.test(opts.column)) {
+        throw new TypeError(`Invalid vector column name: ${JSON.stringify(opts.column)}`);
+    }
+    const operator = VECTOR_OPERATORS[opts.metric ?? 'cosine'];
+    const distance = `${quoteColumn(opts.column)} ${operator} ?::vector`;
+    if (opts.threshold !== undefined) {
+        qb.whereRaw(`${distance} < ?`, [literal, opts.threshold]);
+    }
+    if (opts.order !== false) {
+        qb.orderByRaw(`${distance} asc`, [literal]);
+    }
+    if (opts.topK !== undefined) {
+        qb.limit(opts.topK);
+    }
+}
+/**
+ * Apply a Postgres **tsvector full-text search** to a Lucid query builder — the
+ * parity port of the NestJS reference's `applyVectorSearch` (tsvector), NOT the
+ * embedding similarity {@link applyVectorSimilarity}.
+ *
+ * Injection-safety: the user `query` string ALWAYS travels as a positional
+ * binding (`websearch_to_tsquery('<lang>', ?)`); it is never interpolated.
+ * `websearch_to_tsquery` (not the raw `to_tsquery`) parses arbitrary user input
+ * — multi-word text, `"quoted phrases"`, `-exclude`, `or` — without throwing a
+ * syntax error. The only spliced fragments are the column name(s) and the
+ * language config, each validated against the strict identifier charset
+ * ({@link SAFE_IDENTIFIER}) before use, so neither can carry injection.
+ *
+ * The match predicate is `<document> @@ websearch_to_tsquery('<lang>', ?)` where
+ * `<document>` is either the tsvector column directly, or
+ * `to_tsvector('<lang>', coalesce(col1,'') || ' ' || coalesce(col2,''))` for
+ * text columns. When `rank` is set, rows are additionally ordered by descending
+ * `ts_rank(<document>, websearch_to_tsquery('<lang>', ?))`. A no-op for a blank
+ * query.
+ */
+export function applyFullTextSearch(qb, opts) {
+    const query = opts.query.trim();
+    if (query.length === 0)
+        return;
+    const columns = Array.isArray(opts.column) ? opts.column : [opts.column];
+    if (columns.length === 0)
+        return;
+    for (const col of columns) {
+        if (!SAFE_IDENTIFIER.test(col)) {
+            throw new TypeError(`Invalid full-text search column name: ${JSON.stringify(col)}`);
+        }
+    }
+    const language = opts.language ?? 'english';
+    if (!SAFE_IDENTIFIER.test(language)) {
+        throw new TypeError(`Invalid full-text search language: ${JSON.stringify(language)}`);
+    }
+    // The user query is a positional binding; only the validated language splices in.
+    const tsquery = `websearch_to_tsquery('${language}', ?)`;
+    // A precomputed tsvector column is matched directly; text columns are tokenized
+    // at query time via to_tsvector, coalescing NULLs so a null column can't null
+    // the whole document.
+    const kind = opts.columnKind ?? (columns.length > 1 ? 'text' : 'tsvector');
+    const document = kind === 'text'
+        ? `to_tsvector('${language}', ${columns
+            .map((c) => `coalesce(${quoteColumn(c)}, '')`)
+            .join(" || ' ' || ")})`
+        : quoteColumn(columns[0]);
+    qb.whereRaw(`${document} @@ ${tsquery}`, [query]);
+    if (opts.rank) {
+        qb.orderByRaw(`ts_rank(${document}, ${tsquery}) desc`, [query]);
+    }
+}
+/** Wrap a value as a LIKE pattern with escaped metacharacters. */
+function like(value, kind) {
+    const v = escapeLike(String(value));
+    if (kind === 'startsWith')
+        return `${v}%`;
+    if (kind === 'endsWith')
+        return `%${v}`;
+    return `%${v}%`;
+}
+/**
+ * Apply a single (leaf) column filter to the builder.
+ *
+ * A dotted `field` is a **relation path** (`posts.title`, `posts.comments.body`):
+ * every segment but the last is a relation hop, translated into a nested Lucid
+ * `whereHas` subquery, and the final segment is the bare column the operator
+ * lands on inside the innermost relation query — so `posts.title = x` becomes
+ * `whereHas('posts', (q) => q.where('title', x))`. Depth is already bounded by
+ * the spec's `maxDepth` allow-list before a filter reaches the adapter, so this
+ * only translates paths that were explicitly whitelisted. A non-dotted `field`
+ * is a plain base column and takes the operator switch directly.
+ */
+function applyLeaf(qb, field, operator, value) {
+    const dot = field.indexOf('.');
+    if (dot !== -1) {
+        const relation = field.slice(0, dot);
+        const rest = field.slice(dot + 1);
+        qb.whereHas(relation, (sub) => applyLeaf(sub, rest, operator, value));
+        return;
+    }
+    switch (operator) {
+        case 'equals':
+            qb.where(field, value);
+            break;
+        case 'notEquals':
+            qb.whereNot(field, value);
+            break;
+        case 'contains':
+        case 'iContains':
+            qb.whereILike(field, like(value, 'contains'));
+            break;
+        case 'startsWith':
+            qb.whereILike(field, like(value, 'startsWith'));
+            break;
+        case 'endsWith':
+            qb.whereILike(field, like(value, 'endsWith'));
+            break;
+        case 'notContains':
+            qb.where((sub) => sub
+                .whereNotNull(field)
+                .whereNot((inner) => inner.whereILike(field, like(value, 'contains'))));
+            break;
+        case 'gt':
+            qb.where(field, '>', value);
+            break;
+        case 'gte':
+            qb.where(field, '>=', value);
+            break;
+        case 'lt':
+            qb.where(field, '<', value);
+            break;
+        case 'lte':
+            qb.where(field, '<=', value);
+            break;
+        case 'between':
+            qb.whereBetween(field, value);
+            break;
+        case 'notBetween':
+            qb.whereNotBetween(field, value);
+            break;
+        case 'in':
+        case 'isAnyOf':
+            qb.whereIn(field, value);
+            break;
+        case 'notIn':
+            qb.whereNotIn(field, value);
+            break;
+        case 'isNull':
+        case 'notExists':
+            qb.whereNull(field);
+            break;
+        case 'isNotNull':
+        case 'exists':
+            qb.whereNotNull(field);
+            break;
+        case 'isEmpty':
+            qb.where(field, '');
+            break;
+        case 'isNotEmpty':
+            qb.whereNot(field, '');
+            break;
+    }
+}
+/**
+ * Apply one {@link ColumnFilter} (possibly an AND/OR group) to a builder. A leaf
+ * is a single condition; `AND`/`OR` recurse into a grouped sub-builder so the
+ * boolean structure maps to Lucid's nested `where`/`orWhere` closures.
+ */
+function applyOne(qb, filter) {
+    const op = normalizeOperator(filter.operator);
+    const hasField = typeof filter.field === 'string' && filter.field.length > 0;
+    qb.where((group) => {
+        if (hasField) {
+            applyLeaf(group, filter.field, op, filter.value);
+        }
+        if (filter.AND) {
+            for (const sub of filter.AND) {
+                group.where((g) => applyOne(g, sub));
+            }
+        }
+        if (filter.OR) {
+            for (const sub of filter.OR) {
+                group.orWhere((g) => applyOne(g, sub));
+            }
+        }
+    });
+}
+/** Apply an array of column filters (combined with AND) to a Lucid query builder. */
+export function applyColumnFilters(qb, filters) {
+    for (const filter of filters) {
+        applyOne(qb, filter);
+    }
+}
+/** Apply sort directives to a Lucid query builder, in order. */
+export function applySort(qb, sorts) {
+    for (const sort of sorts) {
+        qb.orderBy(sort.field, sort.direction);
+    }
+}
+/**
+ * Apply a DISTINCT projection over `columns` to a Lucid query builder — the
+ * executable half of the client's `.distinct(...)` (which until now the server
+ * silently ignored). A no-op for an empty list. The columns are the
+ * already-validated, alias-resolved field names (the runner resolves aliases and
+ * enforces the allow-list before calling this), so nothing client-controlled is
+ * interpolated: Lucid quotes each identifier itself.
+ */
+export function applyDistinct(qb, columns) {
+    if (columns.length === 0)
+        return;
+    qb.distinct(...columns);
+}
+/**
+ * Terminal group-by-count aggregation over one column:
+ * `SELECT <col> AS value, COUNT(*) AS count … GROUP BY <col>`, most groups first —
+ * what populates a filter dropdown. `column` must already be validated (allow-listed): it is
+ * interpolated as an identifier, while every client VALUE rides a positional binding.
+ *
+ * Fixed ordering (count desc, value asc) is load-bearing, not cosmetic: the answer is pageable,
+ * and paging an unordered listing repeats and skips rows.
+ *
+ * Requires a builder carrying the optional aggregation seam (`select`/`count`/`groupBy`/`offset`);
+ * throws a plain `Error` naming the missing method otherwise, so a minimal custom implementation
+ * fails loudly instead of silently returning entity rows.
+ */
+export function applyGroupByCount(qb, column, opts = {}) {
+    if (!qb.select || !qb.count || !qb.groupBy || !qb.offset) {
+        throw new Error('groupByCount needs a builder with select/count/groupBy/offset — the active one does not implement the aggregation seam.');
+    }
+    qb.select(`${column} AS value`);
+    qb.count('* AS count');
+    const needle = opts.search?.trim();
+    if (needle) {
+        qb.whereRaw(`LOWER(??) LIKE ?`, [column, `%${escapeLike(needle.toLowerCase())}%`]);
+    }
+    qb.groupBy(column);
+    qb.orderBy('count', 'desc');
+    qb.orderBy(column, 'asc');
+    if (opts.limit !== undefined)
+        qb.limit(Math.max(0, opts.limit));
+    if (opts.offset !== undefined)
+        qb.offset(Math.max(0, opts.offset));
+}
+/**
+ * Resolve a {@link ComputedSource} to its final SQL expression string. The
+ * string form is verbatim; the function form is invoked with the root table
+ * {@link ComputedContext} so it can splice the outer alias into a correlated
+ * subquery. Either way the result is dev-authored — never client text.
+ */
+export function resolveComputedExpression(source, alias) {
+    return typeof source === 'function' ? source({ alias }) : source;
+}
+/**
+ * Apply a filter on a dev-declared **computed field** to a Lucid query builder.
+ *
+ * The already-resolved `expression` is inlined as the raw left-hand side (it is
+ * dev-authored — a verbatim string or a function's output — never client text);
+ * the client's filter VALUE always rides through as a positional `?` binding,
+ * exactly the injection-safety contract real-column filters have. The whole
+ * expression is parenthesized so a compound source
+ * (`first || ' ' || last`, `(SELECT …)`) composes under the operator without a
+ * precedence surprise.
+ */
+export function applyComputedField(qb, expression, filter) {
+    const op = normalizeOperator(filter.operator);
+    const value = filter.value;
+    const lhs = `(${expression})`;
+    switch (op) {
+        case 'equals':
+            qb.whereRaw(`${lhs} = ?`, [value]);
+            break;
+        case 'notEquals':
+            qb.whereRaw(`${lhs} <> ?`, [value]);
+            break;
+        case 'gt':
+            qb.whereRaw(`${lhs} > ?`, [value]);
+            break;
+        case 'gte':
+            qb.whereRaw(`${lhs} >= ?`, [value]);
+            break;
+        case 'lt':
+            qb.whereRaw(`${lhs} < ?`, [value]);
+            break;
+        case 'lte':
+            qb.whereRaw(`${lhs} <= ?`, [value]);
+            break;
+        case 'in':
+        case 'isAnyOf': {
+            const values = Array.isArray(value) ? value : [];
+            // An empty IN list matches nothing — emit an always-false predicate rather
+            // than invalid `IN ()` SQL.
+            if (values.length === 0)
+                qb.whereRaw('1 = 0');
+            else
+                qb.whereRaw(`${lhs} in (${values.map(() => '?').join(', ')})`, values);
+            break;
+        }
+        case 'notIn': {
+            const values = Array.isArray(value) ? value : [];
+            if (values.length === 0)
+                qb.whereRaw('1 = 1');
+            else
+                qb.whereRaw(`${lhs} not in (${values.map(() => '?').join(', ')})`, values);
+            break;
+        }
+        case 'between': {
+            const [low, high] = value;
+            qb.whereRaw(`${lhs} between ? and ?`, [low, high]);
+            break;
+        }
+        case 'notBetween': {
+            const [low, high] = value;
+            qb.whereRaw(`${lhs} not between ? and ?`, [low, high]);
+            break;
+        }
+        case 'contains':
+        case 'iContains':
+            qb.whereRaw(`${lhs} ilike ?`, [like(value, 'contains')]);
+            break;
+        case 'notContains':
+            qb.whereRaw(`(${lhs} not ilike ? or ${lhs} is null)`, [like(value, 'contains')]);
+            break;
+        case 'startsWith':
+            qb.whereRaw(`${lhs} ilike ?`, [like(value, 'startsWith')]);
+            break;
+        case 'endsWith':
+            qb.whereRaw(`${lhs} ilike ?`, [like(value, 'endsWith')]);
+            break;
+        case 'isNull':
+        case 'notExists':
+            qb.whereRaw(`${lhs} is null`);
+            break;
+        case 'isNotNull':
+        case 'exists':
+            qb.whereRaw(`${lhs} is not null`);
+            break;
+        case 'isEmpty':
+            qb.whereRaw(`${lhs} = ?`, ['']);
+            break;
+        case 'isNotEmpty':
+            qb.whereRaw(`${lhs} <> ?`, ['']);
+            break;
+    }
+}
+/**
+ * Append an ORDER BY on a dev-declared **computed field** to a Lucid query
+ * builder via `orderByRaw`. Uses append semantics (like `orderBy`) so a computed
+ * sort composes with real-column sorts in request order. The expression is
+ * dev-authored and parenthesized; the direction is a validated literal.
+ */
+export function applyComputedSort(qb, expression, direction) {
+    qb.orderByRaw(`(${expression}) ${direction === 'desc' ? 'desc' : 'asc'}`);
+}
+/**
+ * Apply a keyset (cursor) seek predicate to a Lucid query builder for row-value
+ * comparison across the keyset columns.
+ *
+ * Given a keyset (the active sort columns plus a primary-key tiebreaker, each
+ * with a direction) and a boundary row's values, this constrains the query to
+ * rows strictly *after* the boundary in keyset order. The row-value comparison
+ * is expanded into the portable "OR of AND tiers" form that works across all
+ * SQL dialects:
+ *
+ * ```text
+ *   (c0 OP0 v0)
+ *   OR (c0 = v0 AND c1 OP1 v1)
+ *   OR (c0 = v0 AND c1 = v1 AND c2 OP2 v2) ...
+ * ```
+ *
+ * where `OPi` is `>` for an `asc` column and `<` for a `desc` column. The whole
+ * predicate is wrapped in one AND-group so it composes with any existing
+ * `where` conditions. A no-op when the keyset is empty or `values` does not line
+ * up positionally with it.
+ *
+ * With more than one column, the group is preceded by the bound every tier
+ * already implies, `c0 >= v0` (`<=` for `desc`): Postgres cannot derive an index
+ * range from the OR form alone and would scan from the start of the index. The
+ * bound is skipped when `v0` is null, where the OR form matches no `c0 > NULL`
+ * tier and a `>= NULL` bound would wrongly match nothing.
+ */
+export function applyKeyset(qb, keyset, values) {
+    if (keyset.length === 0 || values.length !== keyset.length)
+        return;
+    const lead = keyset[0];
+    if (keyset.length > 1 && values[0] !== null && values[0] !== undefined) {
+        qb.where(lead.field, lead.direction === 'asc' ? '>=' : '<=', values[0]);
+    }
+    qb.where((outer) => {
+        for (let tier = 0; tier < keyset.length; tier++) {
+            const buildTier = (inner) => {
+                // Equality on every column before this tier.
+                for (let i = 0; i < tier; i++) {
+                    inner.where(keyset[i].field, values[i]);
+                }
+                const cmp = keyset[tier].direction === 'asc' ? '>' : '<';
+                inner.where(keyset[tier].field, cmp, values[tier]);
+            };
+            // First tier seeds the group with AND; the rest OR onto it.
+            if (tier === 0)
+                outer.where(buildTier);
+            else
+                outer.orWhere(buildTier);
+        }
+    });
+}
+/** Apply a free-text ILIKE search across `columns` (OR-combined) to a Lucid query builder. */
+export function applySearch(qb, term, columns) {
+    if (columns.length === 0 || term.length === 0)
+        return;
+    const pattern = like(term, 'contains');
+    qb.where((group) => {
+        for (const column of columns) {
+            group.orWhereILike(column, pattern);
+        }
+    });
+}
+//# sourceMappingURL=lucid_adapter.js.map

package/dist/src/lucid_adapter.js.map

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

package/dist/src/lucid_macros.d.ts

@@ -0,0 +1,87 @@
+import { type ApplyFromRequestOptions, type FilterRequestContext } from './apply_from_request.js';
+import { type FilterClass } from './filter_class.js';
+import type { FilterSpec } from './filter_spec.js';
+import type { ResolvedPagination } from './runner.js';
+/**
+ * The static slice of a Lucid query-builder class we register onto: Adonis'
+ * `Macroable.macro(name, fn)` adds `fn` to the builder prototype so every query
+ * instance gains the method. Declared structurally so this module never
+ * hard-imports `@adonisjs/lucid` at runtime (the provider passes the real
+ * `ModelQueryBuilder` in) — matching how the rest of the package stays
+ * framework-free.
+ */
+export interface MacroableQueryBuilder {
+    macro(name: string, fn: (this: unknown, ...args: never[]) => unknown): void;
+}
+/**
+ * Register the chainable filter macros onto a Lucid query-builder class (the
+ * method-call form of {@link applyFilterFromRequest}). Call this from a provider's
+ * `boot()` with `ModelQueryBuilder` (from `@adonisjs/lucid/orm`); the
+ * `@adonis-agora/filter` provider does exactly that.
+ *
+ * Two macros are added:
+ *
+ * - `query.applyFilterFromRequest(spec, ctx, options?)` — applies the spec's
+ *   server scope + allow-listed filter/sort/search and returns the query so it
+ *   chains (`User.query().applyFilterFromRequest(spec, ctx).orderBy(...)`). The
+ *   resolved pagination is dropped; use `filterPaginate` (or the free function)
+ *   when you need it.
+ * - `query.filterPaginate(spec, ctx, options?)` — applies the same and then
+ *   `paginate(page, size)` with the resolved pagination, returning Lucid's
+ *   paginator (`await User.query().filterPaginate(spec, ctx)`).
+ *
+ * Idempotent enough to call once at boot; calling twice re-defines the macros to
+ * the same implementations.
+ */
+export declare function registerFilterMacros(ModelQueryBuilder: MacroableQueryBuilder): void;
+declare module '@adonisjs/lucid/types/model' {
+    interface ModelQueryBuilderContract<Model extends LucidModel, Result = InstanceType<Model>> {
+        /**
+         * Apply a {@link FilterSpec} from the request context (server scope +
+         * allow-listed filter/sort/search) and return the query for chaining — the
+         * method form of the free `applyFilterFromRequest`. Pagination is resolved
+         * but not returned here; use {@link filterPaginate} when you need it.
+         *
+         * `ctx` is optional: when omitted, the active `HttpContext` is read from
+         * AsyncLocalStorage (`HttpContext.getOrFail()`). Pass it explicitly outside a
+         * request scope (e.g. a job/command), where there is no ambient context.
+         */
+        applyFilterFromRequest(spec: FilterSpec, ctx?: FilterRequestContext, options?: ApplyFromRequestOptions): this;
+        /**
+         * The same for a filter **class**: resolved through the IoC container (so `@inject()` works),
+         * `setup()` first, then every request key the class owns a method for.
+         *
+         * Resolution is async, so this returns a promise — of the resolved `{ page, size }`, not of
+         * the builder (a Lucid builder is thenable, so awaiting a promise of one would run the query).
+         * The builder is the one you called it on, still yours to compose on:
+         *
+         * ```ts
+         * const query = User.query().whereNull('deletedAt')
+         * const { page, size } = await query.applyFilterFromRequest(UserFilter)
+         * return query.preload('team').paginate(page, size)
+         * ```
+         */
+        applyFilterFromRequest(filter: FilterClass, ctx?: FilterRequestContext, options?: ApplyFromRequestOptions): Promise<ResolvedPagination>;
+        /**
+         * Apply a {@link FilterSpec} from the request context and paginate with the
+         * resolved `{ page, size }`, returning Lucid's paginator — filter + paginate
+         * in one terminal call. `ctx` is optional (see {@link applyFilterFromRequest}).
+         */
+        filterPaginate(spec: FilterSpec, ctx?: FilterRequestContext, options?: ApplyFromRequestOptions): ReturnType<this['paginate']>;
+        /** The filter-class form of {@link filterPaginate} — async, for the same reason. */
+        filterPaginate(filter: FilterClass, ctx?: FilterRequestContext, options?: ApplyFromRequestOptions): Promise<Awaited<ReturnType<this['paginate']>>>;
+        /**
+         * Page a query that has **already** been filtered (by the model's `filter()` or by the
+         * `applyFilterFromRequest` macro) with the `{ page, size }` that call resolved — so a
+         * controller can keep composing on the builder and still page it the way the request asked.
+         *
+         * ```ts
+         * const query = await User.filter(ctx)
+         * query.whereNotNull('confirmedAt')
+         * return query.filterPaginate()
+         * ```
+         */
+        filterPaginate(): ReturnType<this['paginate']>;
+    }
+}
+//# sourceMappingURL=lucid_macros.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"lucid_macros.d.ts","sourceRoot":"","sources":["../../src/lucid_macros.ts"],"names":[],"mappings":"AAEA,OAAO,EACL,KAAK,uBAAuB,EAE5B,KAAK,oBAAoB,EAC1B,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAE,KAAK,WAAW,EAAiB,MAAM,mBAAmB,CAAC;AACpE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAInD,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,aAAa,CAAC;AAYtD;;;;;;;GAOG;AACH,MAAM,WAAW,qBAAqB;IACpC,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,CAAC,IAAI,EAAE,OAAO,EAAE,GAAG,IAAI,EAAE,KAAK,EAAE,KAAK,OAAO,GAAG,IAAI,CAAC;CAC7E;AAED;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,oBAAoB,CAAC,iBAAiB,EAAE,qBAAqB,GAAG,IAAI,CA+CnF;AAED,OAAO,QAAQ,6BAA6B,CAAC;IAC3C,UAAU,yBAAyB,CAAC,KAAK,SAAS,UAAU,EAAE,MAAM,GAAG,YAAY,CAAC,KAAK,CAAC;QACxF;;;;;;;;;WASG;QACH,sBAAsB,CACpB,IAAI,EAAE,UAAU,EAChB,GAAG,CAAC,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,uBAAuB,GAChC,IAAI,CAAC;QACR;;;;;;;;;;;;;WAaG;QACH,sBAAsB,CACpB,MAAM,EAAE,WAAW,EACnB,GAAG,CAAC,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,kBAAkB,CAAC,CAAC;QAC/B;;;;WAIG;QACH,cAAc,CACZ,IAAI,EAAE,UAAU,EAChB,GAAG,CAAC,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,uBAAuB,GAChC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;QAChC,oFAAoF;QACpF,cAAc,CACZ,MAAM,EAAE,WAAW,EACnB,GAAG,CAAC,EAAE,oBAAoB,EAC1B,OAAO,CAAC,EAAE,uBAAuB,GAChC,OAAO,CAAC,OAAO,CAAC,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,CAAC;QAClD;;;;;;;;;;WAUG;QACH,cAAc,IAAI,UAAU,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC;KAChD;CACF"}

package/dist/src/lucid_macros.js

@@ -0,0 +1,67 @@
+import { HttpContext } from '@adonisjs/core/http';
+import { applyFilterFromRequest, } from './apply_from_request.js';
+import { isFilterClass } from './filter_class.js';
+import { paginate } from './paginate.js';
+import { readPagination, stashPagination } from './pagination_stash.js';
+/**
+ * O ctx da request para o macro: explícito, ou o `HttpContext` ativo lido do AsyncLocalStorage do
+ * Adonis quando omitido. `getOrFail()` lança quando não há request em escopo (ex.: chamada dentro de
+ * um job/command) — nesse caso passe o ctx explicitamente. Fica no macro (camada Adonis); o
+ * `applyFilterFromRequest` livre continua framework-agnostic, exigindo o ctx.
+ */
+function resolveCtx(ctx) {
+    return ctx ?? HttpContext.getOrFail();
+}
+/**
+ * Register the chainable filter macros onto a Lucid query-builder class (the
+ * method-call form of {@link applyFilterFromRequest}). Call this from a provider's
+ * `boot()` with `ModelQueryBuilder` (from `@adonisjs/lucid/orm`); the
+ * `@adonis-agora/filter` provider does exactly that.
+ *
+ * Two macros are added:
+ *
+ * - `query.applyFilterFromRequest(spec, ctx, options?)` — applies the spec's
+ *   server scope + allow-listed filter/sort/search and returns the query so it
+ *   chains (`User.query().applyFilterFromRequest(spec, ctx).orderBy(...)`). The
+ *   resolved pagination is dropped; use `filterPaginate` (or the free function)
+ *   when you need it.
+ * - `query.filterPaginate(spec, ctx, options?)` — applies the same and then
+ *   `paginate(page, size)` with the resolved pagination, returning Lucid's
+ *   paginator (`await User.query().filterPaginate(spec, ctx)`).
+ *
+ * Idempotent enough to call once at boot; calling twice re-defines the macros to
+ * the same implementations.
+ */
+export function registerFilterMacros(ModelQueryBuilder) {
+    ModelQueryBuilder.macro('applyFilterFromRequest', function (filter, ctx, options) {
+        // A class is resolved through the container, so this leg is async — and it resolves to the
+        // pagination rather than to the builder: a Lucid query builder is thenable, so a promise that
+        // resolved to one would execute the query instead of handing it back. You already hold the
+        // builder; `await query.applyFilterFromRequest(UserFilter)` gives you its `{ page, size }`.
+        if (isFilterClass(filter)) {
+            return applyFilterFromRequest(this, filter, resolveCtx(ctx), options).then((pagination) => {
+                stashPagination(this, pagination);
+                return pagination;
+            });
+        }
+        stashPagination(this, applyFilterFromRequest(this, filter, resolveCtx(ctx), options));
+        return this;
+    });
+    ModelQueryBuilder.macro('filterPaginate', function (filter, ctx, options) {
+        // No filter argument: this query has already been through one (the model's `filter()`, or the
+        // `applyFilterFromRequest` macro), so page it with the pagination that call resolved.
+        if (filter === undefined) {
+            const stashed = readPagination(this);
+            if (!stashed) {
+                throw new Error('filterPaginate() was called with no filter on a query that has not been filtered. Pass the filter — filterPaginate(UserFilter) — or apply one first.');
+            }
+            return paginate(this, stashed.page, stashed.size);
+        }
+        if (isFilterClass(filter)) {
+            return applyFilterFromRequest(this, filter, resolveCtx(ctx), options).then(({ page, size }) => paginate(this, page, size));
+        }
+        const { page, size } = applyFilterFromRequest(this, filter, resolveCtx(ctx), options);
+        return paginate(this, page, size);
+    });
+}
+//# sourceMappingURL=lucid_macros.js.map

package/dist/src/lucid_macros.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"lucid_macros.js","sourceRoot":"","sources":["../../src/lucid_macros.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAElD,OAAO,EAEL,sBAAsB,GAEvB,MAAM,yBAAyB,CAAC;AACjC,OAAO,EAAoB,aAAa,EAAE,MAAM,mBAAmB,CAAC;AAGpE,OAAO,EAAE,QAAQ,EAAE,MAAM,eAAe,CAAC;AACzC,OAAO,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAGxE;;;;;GAKG;AACH,SAAS,UAAU,CAAC,GAAqC;IACvD,OAAO,GAAG,IAAI,WAAW,CAAC,SAAS,EAAE,CAAC;AACxC,CAAC;AAcD;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,oBAAoB,CAAC,iBAAwC;IAC3E,iBAAiB,CAAC,KAAK,CAAC,wBAAwB,EAAE,UAEhD,MAAgC,EAChC,GAA0B,EAC1B,OAAiC;QAEjC,2FAA2F;QAC3F,8FAA8F;QAC9F,2FAA2F;QAC3F,4FAA4F;QAC5F,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CAAC,CAAC,UAAU,EAAE,EAAE;gBACxF,eAAe,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;gBAClC,OAAO,UAAU,CAAC;YACpB,CAAC,CAAC,CAAC;QACL,CAAC;QACD,eAAe,CAAC,IAAI,EAAE,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;QACtF,OAAO,IAAI,CAAC;IACd,CAAiD,CAAC,CAAC;IAEnD,iBAAiB,CAAC,KAAK,CAAC,gBAAgB,EAAE,UAExC,MAAiC,EACjC,GAA0B,EAC1B,OAAiC;QAEjC,8FAA8F;QAC9F,sFAAsF;QACtF,IAAI,MAAM,KAAK,SAAS,EAAE,CAAC;YACzB,MAAM,OAAO,GAAG,cAAc,CAAC,IAAI,CAAC,CAAC;YACrC,IAAI,CAAC,OAAO,EAAE,CAAC;gBACb,MAAM,IAAI,KAAK,CACb,sJAAsJ,CACvJ,CAAC;YACJ,CAAC;YACD,OAAO,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,aAAa,CAAC,MAAM,CAAC,EAAE,CAAC;YAC1B,OAAO,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC,IAAI,CACxE,CAAC,EAAE,IAAI,EAAE,IAAI,EAAsB,EAAE,EAAE,CAAC,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CACnE,CAAC;QACJ,CAAC;QACD,MAAM,EAAE,IAAI,EAAE,IAAI,EAAE,GAAG,sBAAsB,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,CAAC,GAAG,CAAC,EAAE,OAAO,CAAC,CAAC;QACtF,OAAO,QAAQ,CAAC,IAAI,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;IACpC,CAAiD,CAAC,CAAC;AACrD,CAAC"}