@adonis-agora/filter-client 0.1.0

package/dist/tanstack.js

@@ -0,0 +1,58 @@
+import { FilterQueryBuilder } from './filter-query-builder.js';
+const defaultResolveOperator = (_columnId, value) => {
+    if (Array.isArray(value))
+        return 'in';
+    if (typeof value === 'string')
+        return 'iContains';
+    return 'equals';
+};
+/**
+ * Applies vanilla TanStack Table state (column filters, sorting, pagination)
+ * onto an existing `FilterQueryBuilder`, then returns the same builder so you
+ * can chain `include`/`search`/extra `where` calls before `build()`.
+ *
+ * Framework-agnostic — works with any TanStack Table adapter (React, Vue,
+ * Svelte, Solid). `@tanstack/table-core` is a types-only peer.
+ *
+ * @example
+ * import { filterQuery } from '@adonis-agora/filter-client';
+ * import { applyTanstackTableState } from '@adonis-agora/filter-client/tanstack';
+ *
+ * const body = applyTanstackTableState(filterQuery(), {
+ *   columnFilters: table.getState().columnFilters,
+ *   sorting: table.getState().sorting,
+ *   pagination: table.getState().pagination,
+ *   resolveOperator: (id) => (id === 'createdAt' ? 'gte' : 'iContains'),
+ * })
+ *   .include('author')
+ *   .build();
+ */
+export function applyTanstackTableState(builder, options = {}) {
+    const { columnFilters = [], sorting = [], pagination, resolveOperator = defaultResolveOperator, fields, } = options;
+    const allowed = fields ? new Set(fields) : null;
+    for (const { id, value } of columnFilters) {
+        if (value === null || value === undefined || value === '')
+            continue;
+        if (allowed && !allowed.has(id))
+            continue;
+        builder.where(id, resolveOperator(id, value), value);
+    }
+    for (const { id, desc } of sorting) {
+        if (allowed && !allowed.has(id))
+            continue;
+        builder.sort(id, desc ? 'desc' : 'asc');
+    }
+    if (pagination) {
+        builder.page(pagination.pageIndex, pagination.pageSize);
+    }
+    return builder;
+}
+/**
+ * One-shot convenience: builds a `FilterQueryResult` straight from vanilla
+ * TanStack Table state. Equivalent to
+ * `applyTanstackTableState(filterQuery(), options).build()`.
+ */
+export function tanstackTableToFilterQuery(options = {}) {
+    return applyTanstackTableState(new FilterQueryBuilder(), options).build();
+}
+//# sourceMappingURL=tanstack.js.map

package/dist/tanstack.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tanstack.js","sourceRoot":"","sources":["../src/tanstack.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AA+B/D,MAAM,sBAAsB,GAAoB,CAAC,SAAS,EAAE,KAAK,EAAE,EAAE;IACnE,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;QAAE,OAAO,IAAI,CAAC;IACtC,IAAI,OAAO,KAAK,KAAK,QAAQ;QAAE,OAAO,WAAW,CAAC;IAClD,OAAO,QAAQ,CAAC;AAClB,CAAC,CAAC;AAEF;;;;;;;;;;;;;;;;;;;;GAoBG;AACH,MAAM,UAAU,uBAAuB,CACrC,OAA2B,EAC3B,UAAqC,EAAE;IAEvC,MAAM,EACJ,aAAa,GAAG,EAAE,EAClB,OAAO,GAAG,EAAE,EACZ,UAAU,EACV,eAAe,GAAG,sBAAsB,EACxC,MAAM,GACP,GAAG,OAAO,CAAC;IACZ,MAAM,OAAO,GAAG,MAAM,CAAC,CAAC,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC;IAEhD,KAAK,MAAM,EAAE,EAAE,EAAE,KAAK,EAAE,IAAI,aAAa,EAAE,CAAC;QAC1C,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,IAAI,KAAK,KAAK,EAAE;YAAE,SAAS;QACpE,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC1C,OAAO,CAAC,KAAK,CAAC,EAAE,EAAE,eAAe,CAAC,EAAE,EAAE,KAAK,CAAC,EAAE,KAAK,CAAC,CAAC;IACvD,CAAC;IAED,KAAK,MAAM,EAAE,EAAE,EAAE,IAAI,EAAE,IAAI,OAAO,EAAE,CAAC;QACnC,IAAI,OAAO,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YAAE,SAAS;QAC1C,OAAO,CAAC,IAAI,CAAC,EAAE,EAAE,IAAI,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC;IAC1C,CAAC;IAED,IAAI,UAAU,EAAE,CAAC;QACf,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,SAAS,EAAE,UAAU,CAAC,QAAQ,CAAC,CAAC;IAC1D,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC;AAED;;;;GAIG;AACH,MAAM,UAAU,0BAA0B,CACxC,UAAqC,EAAE;IAEvC,OAAO,uBAAuB,CAAC,IAAI,kBAAkB,EAAE,EAAE,OAAO,CAAC,CAAC,KAAK,EAAE,CAAC;AAC5E,CAAC"}

package/dist/to-query-string.d.ts

@@ -0,0 +1,17 @@
+import type { ColumnFilter } from './types.js';
+/**
+ * Converts a flat object to a query string.
+ *
+ * Handles:
+ * - Simple value: `field=value`
+ * - Array: `field[]=a&field[]=b`
+ * - Operator object: `field[operator]=value`
+ * - Multiple operators: `field[gte]=a&field[lte]=b`
+ */
+export declare function flatObjectToQueryString(obj: Record<string, unknown>): string;
+/**
+ * Converts a ColumnFilter[] array to a query string using
+ * the `where[i][field]=...&where[i][operator]=...&where[i][value]=...` notation.
+ */
+export declare function columnFiltersToQueryString(filters: ColumnFilter[]): string;
+//# sourceMappingURL=to-query-string.d.ts.map

package/dist/to-query-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"to-query-string.d.ts","sourceRoot":"","sources":["../src/to-query-string.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAS/C;;;;;;;;GAQG;AACH,wBAAgB,uBAAuB,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAsB5E;AAED;;;GAGG;AACH,wBAAgB,0BAA0B,CAAC,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,CAI1E"}

package/dist/to-query-string.js

@@ -0,0 +1,72 @@
+/**
+ * Encodes a value for use in a URL query string.
+ */
+function encode(value) {
+    return encodeURIComponent(String(value));
+}
+/**
+ * Converts a flat object to a query string.
+ *
+ * Handles:
+ * - Simple value: `field=value`
+ * - Array: `field[]=a&field[]=b`
+ * - Operator object: `field[operator]=value`
+ * - Multiple operators: `field[gte]=a&field[lte]=b`
+ */
+export function flatObjectToQueryString(obj) {
+    const parts = [];
+    for (const [key, value] of Object.entries(obj)) {
+        if (value === undefined || value === null)
+            continue;
+        if (Array.isArray(value)) {
+            for (const item of value) {
+                parts.push(`${encode(key)}[]=${encode(item)}`);
+            }
+        }
+        else if (typeof value === 'object') {
+            for (const [op, opVal] of Object.entries(value)) {
+                if (opVal !== undefined && opVal !== null) {
+                    parts.push(`${encode(key)}[${encode(op)}]=${encode(opVal)}`);
+                }
+            }
+        }
+        else {
+            parts.push(`${encode(key)}=${encode(value)}`);
+        }
+    }
+    return parts.join('&');
+}
+/**
+ * Converts a ColumnFilter[] array to a query string using
+ * the `where[i][field]=...&where[i][operator]=...&where[i][value]=...` notation.
+ */
+export function columnFiltersToQueryString(filters) {
+    const parts = [];
+    serializeFilters(filters, 'where', parts);
+    return parts.join('&');
+}
+function serializeFilters(filters, prefix, parts) {
+    for (let i = 0; i < filters.length; i++) {
+        const filter = filters[i];
+        const base = `${prefix}[${i}]`;
+        parts.push(`${base}[field]=${encode(filter.field)}`);
+        parts.push(`${base}[operator]=${encode(filter.operator)}`);
+        if (filter.value !== undefined) {
+            if (Array.isArray(filter.value)) {
+                for (let j = 0; j < filter.value.length; j++) {
+                    parts.push(`${base}[value][${j}]=${encode(filter.value[j])}`);
+                }
+            }
+            else {
+                parts.push(`${base}[value]=${encode(filter.value)}`);
+            }
+        }
+        if (filter.AND && filter.AND.length > 0) {
+            serializeFilters(filter.AND, `${base}[AND]`, parts);
+        }
+        if (filter.OR && filter.OR.length > 0) {
+            serializeFilters(filter.OR, `${base}[OR]`, parts);
+        }
+    }
+}
+//# sourceMappingURL=to-query-string.js.map

package/dist/to-query-string.js.map

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

package/dist/typed-filter-query-builder.d.ts

@@ -0,0 +1,78 @@
+import type { Base, EqValue, FieldsWithOp, FilterFieldTypes, OperatorsFor, OrderableFieldsOf, OrderingOps, StringFieldsOf, UnaryOf, ValueAt, ValueForOp } from './field-types.js';
+import type { FilterQueryResult } from './filter-query-builder.js';
+/**
+ * A type-safe wrapper interface over `FilterQueryBuilder` that restricts
+ * field name arguments to the `Fields` union type.
+ *
+ * At runtime this is identical to `FilterQueryBuilder` — the typing is the
+ * only difference. Zero runtime overhead.
+ *
+ * **Important:** This interface must mirror every public method of
+ * `FilterQueryBuilder` so the cast in `filterQueryTyped()` is safe.
+ */
+export interface TypedFilterQueryBuilder<Fields extends string, M extends FilterFieldTypes<Fields> = Record<Fields, unknown>> {
+    where<K extends Fields>(field: K, operator: UnaryOf<ValueAt<M, K>>): this;
+    where<K extends Fields, Op extends OperatorsFor<ValueAt<M, K>>>(field: K, operator: Op, value: ValueForOp<ValueAt<M, K>, Op>): this;
+    where<K extends Fields>(field: K, value: EqValue<ValueAt<M, K>>): this;
+    add<K extends Fields, Op extends Extract<OperatorsFor<ValueAt<M, K>>, OrderingOps>>(field: K, operator: Op, value: ValueForOp<ValueAt<M, K>, Op>): this;
+    remove(field: Fields): this;
+    equals<K extends Fields>(field: K, value: EqValue<ValueAt<M, K>>): this;
+    notEquals<K extends Fields>(field: K, value: EqValue<ValueAt<M, K>>): this;
+    contains<K extends StringFieldsOf<M> & Fields>(field: K, value: string): this;
+    in<K extends Fields>(field: K, values: Base<ValueAt<M, K>>[]): this;
+    notIn<K extends Fields>(field: K, values: Base<ValueAt<M, K>>[]): this;
+    between<K extends OrderableFieldsOf<M> & Fields>(field: K, low: Base<ValueAt<M, K>>, high: Base<ValueAt<M, K>>): this;
+    gt<K extends OrderableFieldsOf<M> & Fields>(field: K, value: ValueForOp<ValueAt<M, K>, 'gt'>): this;
+    gte<K extends OrderableFieldsOf<M> & Fields>(field: K, value: ValueForOp<ValueAt<M, K>, 'gte'>): this;
+    lt<K extends OrderableFieldsOf<M> & Fields>(field: K, value: ValueForOp<ValueAt<M, K>, 'lt'>): this;
+    lte<K extends OrderableFieldsOf<M> & Fields>(field: K, value: ValueForOp<ValueAt<M, K>, 'lte'>): this;
+    isNull(field: Fields): this;
+    isNotNull(field: Fields): this;
+    isEmpty(field: FieldsWithOp<M, 'isEmpty'> & Fields): this;
+    isNotEmpty(field: FieldsWithOp<M, 'isNotEmpty'> & Fields): this;
+    startsWith<K extends StringFieldsOf<M> & Fields>(field: K, value: string): this;
+    endsWith<K extends StringFieldsOf<M> & Fields>(field: K, value: string): this;
+    addGte<K extends OrderableFieldsOf<M> & Fields>(field: K, value: Base<ValueAt<M, K>>): this;
+    addLte<K extends OrderableFieldsOf<M> & Fields>(field: K, value: Base<ValueAt<M, K>>): this;
+    addGt<K extends OrderableFieldsOf<M> & Fields>(field: K, value: Base<ValueAt<M, K>>): this;
+    addLt<K extends OrderableFieldsOf<M> & Fields>(field: K, value: Base<ValueAt<M, K>>): this;
+    sort(field: Fields, direction?: 'asc' | 'desc'): this;
+    sortAsc(field: Fields): this;
+    sortDesc(field: Fields): this;
+    distinct(...fields: Fields[]): this;
+    include(...relations: string[]): this;
+    search(term: string): this;
+    page(page: number, size?: number): this;
+    or(callback: (builder: TypedFilterQueryBuilder<Fields, M>) => void): this;
+    and(callback: (builder: TypedFilterQueryBuilder<Fields, M>) => void): this;
+    set(key: string, value: unknown): this;
+    clear(): this;
+    subscribe(listener: () => void): () => void;
+    getSnapshot(): FilterQueryResult;
+    getVersion(): number;
+    build(): FilterQueryResult;
+    toQueryString(): string;
+    toFlatObject(): Record<string, unknown>;
+}
+/**
+ * Creates a new type-safe `FilterQueryBuilder` that restricts field name
+ * arguments to the `Fields` union type.
+ *
+ * At runtime this returns the exact same `FilterQueryBuilder` instance —
+ * typing is the only difference. Zero runtime overhead.
+ *
+ * @example
+ * type UserFields = 'name' | 'age' | 'status';
+ *
+ * const q = filterQueryTyped<UserFields>()
+ *   .contains('name', 'Al')
+ *   .gte('age', 18)
+ *   .sortDesc('name')
+ *   .page(0, 25)
+ *   .build();
+ *
+ * // TypeScript error — 'invalid' is not assignable to UserFields:
+ * // filterQueryTyped<UserFields>().where('invalid', 'foo');
+ */
+export declare function filterQueryTyped<Fields extends string, M extends FilterFieldTypes<Fields> = Record<Fields, unknown>>(): TypedFilterQueryBuilder<Fields, M>;
+//# sourceMappingURL=typed-filter-query-builder.d.ts.map

package/dist/typed-filter-query-builder.d.ts.map

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

package/dist/typed-filter-query-builder.js

@@ -0,0 +1,25 @@
+import { FilterQueryBuilder } from './filter-query-builder.js';
+/**
+ * Creates a new type-safe `FilterQueryBuilder` that restricts field name
+ * arguments to the `Fields` union type.
+ *
+ * At runtime this returns the exact same `FilterQueryBuilder` instance —
+ * typing is the only difference. Zero runtime overhead.
+ *
+ * @example
+ * type UserFields = 'name' | 'age' | 'status';
+ *
+ * const q = filterQueryTyped<UserFields>()
+ *   .contains('name', 'Al')
+ *   .gte('age', 18)
+ *   .sortDesc('name')
+ *   .page(0, 25)
+ *   .build();
+ *
+ * // TypeScript error — 'invalid' is not assignable to UserFields:
+ * // filterQueryTyped<UserFields>().where('invalid', 'foo');
+ */
+export function filterQueryTyped() {
+    return new FilterQueryBuilder();
+}
+//# sourceMappingURL=typed-filter-query-builder.js.map

package/dist/typed-filter-query-builder.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-filter-query-builder.js","sourceRoot":"","sources":["../src/typed-filter-query-builder.ts"],"names":[],"mappings":"AAaA,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAoI/D;;;;;;;;;;;;;;;;;;;GAmBG;AACH,MAAM,UAAU,gBAAgB;IAI9B,OAAO,IAAI,kBAAkB,EAAmD,CAAC;AACnF,CAAC"}

package/dist/typed-filter-query.d.ts

@@ -0,0 +1,20 @@
+import type { FilterFieldTypes, OperatorsFor, ValueAt, ValueForOp } from './field-types.js';
+export type TypedFilterQuery<Fields extends string, M extends FilterFieldTypes<Fields> = Record<Fields, unknown>> = {
+    filter?: {
+        [K in Fields]?: ValueAt<M, K> | {
+            [Op in OperatorsFor<ValueAt<M, K>>]?: ValueForOp<ValueAt<M, K>, Op>;
+        };
+    };
+    include?: string[];
+    search?: string;
+    sort?: Array<{
+        field: Fields;
+        direction: 'asc' | 'desc';
+    }>;
+    distinct?: Fields[];
+    paginate?: {
+        page: number;
+        size: number;
+    };
+};
+//# sourceMappingURL=typed-filter-query.d.ts.map

package/dist/typed-filter-query.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-filter-query.d.ts","sourceRoot":"","sources":["../src/typed-filter-query.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAE5F,MAAM,MAAM,gBAAgB,CAC1B,MAAM,SAAS,MAAM,EACrB,CAAC,SAAS,gBAAgB,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,IAC1D;IACF,MAAM,CAAC,EAAE;SACN,CAAC,IAAI,MAAM,CAAC,CAAC,EACV,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,GACb;aAAG,EAAE,IAAI,YAAY,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,CAAC,EAAE,UAAU,CAAC,OAAO,CAAC,CAAC,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC;SAAE;KAC5E,CAAC;IACF,OAAO,CAAC,EAAE,MAAM,EAAE,CAAC;IACnB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,SAAS,EAAE,KAAK,GAAG,MAAM,CAAA;KAAE,CAAC,CAAC;IAC3D,QAAQ,CAAC,EAAE,MAAM,EAAE,CAAC;IACpB,QAAQ,CAAC,EAAE;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAA;KAAE,CAAC;CAC3C,CAAC"}

package/dist/typed-filter-query.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=typed-filter-query.js.map

package/dist/typed-filter-query.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typed-filter-query.js","sourceRoot":"","sources":["../src/typed-filter-query.ts"],"names":[],"mappings":""}

package/dist/types.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Supported filter operators — mirrors the core package's FilterOperator
+ * but re-declared here to keep this package zero-dependency.
+ */
+export type FilterOperator = 'equals' | 'notEquals' | 'contains' | 'notContains' | 'iContains' | 'startsWith' | 'endsWith' | 'gt' | 'gte' | 'lt' | 'lte' | 'between' | 'notBetween' | 'in' | 'notIn' | 'isAnyOf' | 'isEmpty' | 'isNotEmpty' | 'isNull' | 'isNotNull' | 'exists' | 'notExists';
+/**
+ * All valid operator strings, used for runtime validation.
+ */
+export declare const FILTER_OPERATORS: readonly FilterOperator[];
+/**
+ * A single column filter condition with optional AND/OR composition.
+ */
+export interface ColumnFilter {
+    field: string;
+    operator: FilterOperator;
+    value?: unknown;
+    AND?: ColumnFilter[];
+    OR?: ColumnFilter[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,MAAM,cAAc,GACtB,QAAQ,GACR,WAAW,GACX,UAAU,GACV,aAAa,GACb,WAAW,GACX,YAAY,GACZ,UAAU,GACV,IAAI,GACJ,KAAK,GACL,IAAI,GACJ,KAAK,GACL,SAAS,GACT,YAAY,GACZ,IAAI,GACJ,OAAO,GACP,SAAS,GACT,SAAS,GACT,YAAY,GACZ,QAAQ,GACR,WAAW,GACX,QAAQ,GACR,WAAW,CAAC;AAEhB;;GAEG;AACH,eAAO,MAAM,gBAAgB,EAAE,SAAS,cAAc,EAuB5C,CAAC;AAEX;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,QAAQ,EAAE,cAAc,CAAC;IACzB,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,GAAG,CAAC,EAAE,YAAY,EAAE,CAAC;IACrB,EAAE,CAAC,EAAE,YAAY,EAAE,CAAC;CACrB"}

package/dist/types.js

@@ -0,0 +1,28 @@
+/**
+ * All valid operator strings, used for runtime validation.
+ */
+export const FILTER_OPERATORS = [
+    'equals',
+    'notEquals',
+    'contains',
+    'notContains',
+    'iContains',
+    'startsWith',
+    'endsWith',
+    'gt',
+    'gte',
+    'lt',
+    'lte',
+    'between',
+    'notBetween',
+    'in',
+    'notIn',
+    'isAnyOf',
+    'isEmpty',
+    'isNotEmpty',
+    'isNull',
+    'isNotNull',
+    'exists',
+    'notExists',
+];
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AA4BA;;GAEG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAA8B;IACzD,QAAQ;IACR,WAAW;IACX,UAAU;IACV,aAAa;IACb,WAAW;IACX,YAAY;IACZ,UAAU;IACV,IAAI;IACJ,KAAK;IACL,IAAI;IACJ,KAAK;IACL,SAAS;IACT,YAAY;IACZ,IAAI;IACJ,OAAO;IACP,SAAS;IACT,SAAS;IACT,YAAY;IACZ,QAAQ;IACR,WAAW;IACX,QAAQ;IACR,WAAW;CACH,CAAC"}

package/dist/validate-operator-value.d.ts

@@ -0,0 +1,35 @@
+import type { FilterOperator } from './types.js';
+/** Operators that accept a non-array scalar: string | number | boolean | Date | null */
+export declare const SCALAR_OPS: readonly ["equals", "notEquals", "gt", "gte", "lt", "lte"];
+/** Operators that require a string value */
+export declare const STRING_OPS: readonly ["contains", "notContains", "iContains", "startsWith", "endsWith"];
+/** Operators that require an array value */
+export declare const ARRAY_OPS: readonly ["in", "notIn", "isAnyOf"];
+/** Operators that require a 2-element tuple [low, high] */
+export declare const TUPLE_OPS: readonly ["between", "notBetween"];
+/** Operators that accept no value (unary) */
+export declare const UNARY_OPS: readonly ["isNull", "isNotNull", "isEmpty", "isNotEmpty", "exists", "notExists"];
+/** Range operators — the only ones allowed in add() */
+export declare const RANGE_OPS: readonly ["gt", "gte", "lt", "lte"];
+export declare const SCALAR_OPERATORS: ReadonlySet<FilterOperator>;
+export declare const STRING_OPERATORS: ReadonlySet<FilterOperator>;
+export declare const ARRAY_OPERATORS: ReadonlySet<FilterOperator>;
+export declare const TUPLE_OPERATORS: ReadonlySet<FilterOperator>;
+export declare const UNARY_OPERATORS: ReadonlySet<FilterOperator>;
+export declare const RANGE_OPERATORS: ReadonlySet<FilterOperator>;
+/**
+ * Validates that the value matches the operator's expected type.
+ * Throws a descriptive `Error` on mismatch.
+ *
+ * @param operator - the filter operator
+ * @param value    - the value supplied by the caller
+ */
+export declare function validateOperatorValue(operator: FilterOperator, value: unknown): void;
+/**
+ * Validates that an operator is allowed inside `add()`.
+ * Only range operators (gt, gte, lt, lte) make sense for accumulation.
+ *
+ * @param operator - the filter operator used in add()
+ */
+export declare function validateAddOperator(operator: FilterOperator): void;
+//# sourceMappingURL=validate-operator-value.d.ts.map

package/dist/validate-operator-value.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"validate-operator-value.d.ts","sourceRoot":"","sources":["../src/validate-operator-value.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAUjD,wFAAwF;AACxF,eAAO,MAAM,UAAU,4DAA6D,CAAC;AACrF,4CAA4C;AAC5C,eAAO,MAAM,UAAU,6EAMb,CAAC;AACX,4CAA4C;AAC5C,eAAO,MAAM,SAAS,qCAAsC,CAAC;AAC7D,2DAA2D;AAC3D,eAAO,MAAM,SAAS,oCAAqC,CAAC;AAC5D,6CAA6C;AAC7C,eAAO,MAAM,SAAS,kFAOZ,CAAC;AACX,uDAAuD;AACvD,eAAO,MAAM,SAAS,qCAAsC,CAAC;AAE7D,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAAuB,CAAC;AACjF,eAAO,MAAM,gBAAgB,EAAE,WAAW,CAAC,cAAc,CAAuB,CAAC;AACjF,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,cAAc,CAAsB,CAAC;AAC/E,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,cAAc,CAAsB,CAAC;AAC/E,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,cAAc,CAAsB,CAAC;AAC/E,eAAO,MAAM,eAAe,EAAE,WAAW,CAAC,cAAc,CAAsB,CAAC;AAI/E;;;;;;GAMG;AACH,wBAAgB,qBAAqB,CAAC,QAAQ,EAAE,cAAc,EAAE,KAAK,EAAE,OAAO,GAAG,IAAI,CAsCpF;AAED;;;;;GAKG;AACH,wBAAgB,mBAAmB,CAAC,QAAQ,EAAE,cAAc,GAAG,IAAI,CAMlE"}

package/dist/validate-operator-value.js

@@ -0,0 +1,91 @@
+// ─── Operator categories ──────────────────────────────────────────────────────
+// The `*_OPS` tuples are the SINGLE runtime source of truth for the operator
+// matrix. Their narrow literal element types are asserted, per group, against
+// the field-types.ts type-level groups in the drift-guard test — so the runtime
+// validator and the compile-time builder cannot silently diverge. The
+// `*_OPERATORS` Sets are derived from the tuples and keep their public
+// `ReadonlySet<FilterOperator>` shape for consumers.
+/** Operators that accept a non-array scalar: string | number | boolean | Date | null */
+export const SCALAR_OPS = ['equals', 'notEquals', 'gt', 'gte', 'lt', 'lte'];
+/** Operators that require a string value */
+export const STRING_OPS = [
+    'contains',
+    'notContains',
+    'iContains',
+    'startsWith',
+    'endsWith',
+];
+/** Operators that require an array value */
+export const ARRAY_OPS = ['in', 'notIn', 'isAnyOf'];
+/** Operators that require a 2-element tuple [low, high] */
+export const TUPLE_OPS = ['between', 'notBetween'];
+/** Operators that accept no value (unary) */
+export const UNARY_OPS = [
+    'isNull',
+    'isNotNull',
+    'isEmpty',
+    'isNotEmpty',
+    'exists',
+    'notExists',
+];
+/** Range operators — the only ones allowed in add() */
+export const RANGE_OPS = ['gt', 'gte', 'lt', 'lte'];
+export const SCALAR_OPERATORS = new Set(SCALAR_OPS);
+export const STRING_OPERATORS = new Set(STRING_OPS);
+export const ARRAY_OPERATORS = new Set(ARRAY_OPS);
+export const TUPLE_OPERATORS = new Set(TUPLE_OPS);
+export const UNARY_OPERATORS = new Set(UNARY_OPS);
+export const RANGE_OPERATORS = new Set(RANGE_OPS);
+// ─── Validation ───────────────────────────────────────────────────────────────
+/**
+ * Validates that the value matches the operator's expected type.
+ * Throws a descriptive `Error` on mismatch.
+ *
+ * @param operator - the filter operator
+ * @param value    - the value supplied by the caller
+ */
+export function validateOperatorValue(operator, value) {
+    if (UNARY_OPERATORS.has(operator)) {
+        // Unary operators accept only null or undefined (no meaningful value)
+        if (value !== null && value !== undefined) {
+            throw new Error(`Operator "${operator}" does not accept a value.`);
+        }
+        return;
+    }
+    if (STRING_OPERATORS.has(operator)) {
+        if (typeof value !== 'string') {
+            throw new Error(`Operator "${operator}" expects a string value.`);
+        }
+        return;
+    }
+    if (TUPLE_OPERATORS.has(operator)) {
+        if (!Array.isArray(value) || value.length !== 2) {
+            throw new Error(`Operator "${operator}" expects [low, high] tuple.`);
+        }
+        return;
+    }
+    if (ARRAY_OPERATORS.has(operator)) {
+        if (!Array.isArray(value)) {
+            throw new Error(`Operator "${operator}" expects an array value.`);
+        }
+        return;
+    }
+    if (SCALAR_OPERATORS.has(operator)) {
+        if (Array.isArray(value)) {
+            throw new Error(`Operator "${operator}" expects a scalar value, not an array. Use "in" for arrays.`);
+        }
+        return;
+    }
+}
+/**
+ * Validates that an operator is allowed inside `add()`.
+ * Only range operators (gt, gte, lt, lte) make sense for accumulation.
+ *
+ * @param operator - the filter operator used in add()
+ */
+export function validateAddOperator(operator) {
+    if (!RANGE_OPERATORS.has(operator)) {
+        throw new Error(`Operator "${operator}" should use where() (replace), not add(). add() is for range operators (gt, gte, lt, lte) on the same field.`);
+    }
+}
+//# sourceMappingURL=validate-operator-value.js.map

package/dist/validate-operator-value.js.map

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

package/package.json

@@ -0,0 +1,64 @@
+{
+  "name": "@adonis-agora/filter-client",
+  "version": "0.1.0",
+  "description": "Client-side query builder for @agora/filter — build filter query strings, with optional TanStack Table state sync.",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/DavideCarvalho/adonis-filter.git",
+    "directory": "packages/client"
+  },
+  "author": "Davi Carvalho <davi@goflip.ai>",
+  "type": "module",
+  "main": "./dist/index.js",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "default": "./dist/index.js"
+    },
+    "./tanstack": {
+      "types": "./dist/tanstack.d.ts",
+      "import": "./dist/tanstack.js",
+      "default": "./dist/tanstack.js"
+    }
+  },
+  "files": [
+    "dist/",
+    "README.md",
+    "CHANGELOG.md"
+  ],
+  "sideEffects": false,
+  "peerDependencies": {
+    "@tanstack/table-core": ">=8.0.0"
+  },
+  "peerDependenciesMeta": {
+    "@tanstack/table-core": {
+      "optional": true
+    }
+  },
+  "devDependencies": {
+    "@tanstack/table-core": "^8.20.0",
+    "typescript": "^5.4.0",
+    "vitest": "^3.0.0"
+  },
+  "engines": {
+    "node": ">=20.6.0"
+  },
+  "keywords": [
+    "adonisjs",
+    "adonis",
+    "filter",
+    "query",
+    "client",
+    "builder",
+    "agora"
+  ],
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "test": "vitest run",
+    "test:types": "tsc -p tsconfig.typecheck.json",
+    "typecheck": "tsc -p tsconfig.json --noEmit && tsc -p tsconfig.typecheck.json"
+  }
+}