@nestjs-filter-grammar/client-query-builder 0.1.0

package/README.md

@@ -0,0 +1,143 @@
+# @nestjs-filter-grammar/client-query-builder
+
+Type-safe client-side filter and sort query builder for APIs using `@nestjs-filter-grammar`. Generates typed filter/sort objects from your API's OpenAPI spec.
+
+## Installation
+
+```bash
+npm install @nestjs-filter-grammar/client-query-builder
+```
+
+## Code Generation
+
+Generate typed filter/sort builders from an OpenAPI spec that contains `x-filter-grammar` extensions (automatically added by the `@Filter()` decorator when `@nestjs/swagger` is installed).
+
+```bash
+npx filter-grammar generate ./openapi.json -o ./src/generated
+```
+
+Options:
+- `-o, --output <dir>` — Output directory (default: `./src/generated`)
+
+This generates one file per endpoint with `FilterX` and `SortX` objects, plus a barrel `index.ts`.
+
+### Generated Output
+
+For a `GET /users` endpoint:
+
+```typescript
+// generated/users.ts
+import { field, sortField } from '@nestjs-filter-grammar/client-query-builder';
+
+export const FilterUsers = {
+  name: field<string>('name', ['=', '!=', '*~']),
+  status: field<'active' | 'inactive' | 'pending'>('status', ['=', '!=']),
+  age: field<number>('age', ['>=', '<=']),
+} as const;
+
+export const SortUsers = {
+  name: sortField('name'),
+  age: sortField('age'),
+} as const;
+```
+
+## Runtime API
+
+### Filter Conditions
+
+```typescript
+import { FilterUsers } from './generated';
+
+// Simple equality
+FilterUsers.name.eq('John').build()           // "name=John"
+
+// Multi-value (IN)
+FilterUsers.status.eq('active', 'pending').build()  // "status=active,pending"
+
+// Null
+FilterUsers.email.eq(null).build()            // "email=null"
+
+// Comparison
+FilterUsers.age.gte(18).build()               // "age>=18"
+
+// Case-insensitive contains
+FilterUsers.name.iContains('john').build()    // "name*~john"
+```
+
+### Combining with `and()` / `or()`
+
+```typescript
+import { and, or } from '@nestjs-filter-grammar/client-query-builder';
+
+// AND
+and(
+  FilterUsers.name.eq('John'),
+  FilterUsers.age.gte(18),
+).build()
+// → "name=John;age>=18"
+
+// OR
+or(
+  FilterUsers.status.eq('active'),
+  FilterUsers.status.eq('pending'),
+).build()
+// → "status=active|status=pending"
+
+// Nested — automatically parenthesized
+and(
+  FilterUsers.name.eq('John'),
+  or(
+    FilterUsers.status.eq('active'),
+    FilterUsers.status.eq('pending'),
+  ),
+).build()
+// → "name=John;(status=active|status=pending)"
+```
+
+### Sort
+
+```typescript
+import { sort } from '@nestjs-filter-grammar/client-query-builder';
+import { SortUsers } from './generated';
+
+SortUsers.name.asc().build()    // "+name"
+SortUsers.age.desc().build()    // "-age"
+
+// Multiple
+sort(
+  SortUsers.name.asc(),
+  SortUsers.age.desc(),
+).build()
+// → "+name,-age"
+```
+
+### Full Example
+
+```typescript
+import { and, or, sort } from '@nestjs-filter-grammar/client-query-builder';
+import { FilterUsers, SortUsers } from './generated';
+
+const filter = and(
+  or(
+    FilterUsers.status.eq('active'),
+    FilterUsers.status.eq('pending'),
+  ),
+  FilterUsers.age.gte(18),
+).build();
+
+const sortStr = sort(
+  SortUsers.name.asc(),
+  SortUsers.age.desc(),
+).build();
+
+const response = await fetch(`/api/users?filter=${filter}&sort=${sortStr}`);
+```
+
+## Value Handling
+
+- Plain strings pass through: `name=John`
+- Values with special characters are auto-quoted: `name="Smith, Jr."`
+- Quotes and backslashes inside values are escaped: `name="say \"hi\""`
+- Numbers serialize as-is: `age>=18`
+- Booleans serialize as-is: `active=true`
+- Null: `email=null`

package/bin/filter-grammar.js

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+require('../dist/cli/index.js');

package/dist/cli/codegen.d.ts

@@ -0,0 +1,18 @@
+export interface FieldDef {
+    operators: string[];
+    type: 'string' | 'number' | 'boolean' | 'enum';
+    values?: (string | number)[];
+}
+export interface EndpointDef {
+    fields: Record<string, FieldDef>;
+    sortable: string[];
+}
+export declare function generateFile(name: string, endpoint: EndpointDef): string;
+export interface BarrelEntry {
+    filename: string;
+    name: string;
+    hasFilter: boolean;
+    hasSort: boolean;
+}
+export declare function generateBarrel(entries: BarrelEntry[]): string;
+//# sourceMappingURL=codegen.d.ts.map

package/dist/cli/codegen.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.d.ts","sourceRoot":"","sources":["../../src/cli/codegen.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,QAAQ;IACvB,SAAS,EAAE,MAAM,EAAE,CAAC;IACpB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,SAAS,GAAG,MAAM,CAAC;IAC/C,MAAM,CAAC,EAAE,CAAC,MAAM,GAAG,MAAM,CAAC,EAAE,CAAC;CAC9B;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAAC;IACjC,QAAQ,EAAE,MAAM,EAAE,CAAC;CACpB;AAWD,wBAAgB,YAAY,CAAC,IAAI,EAAE,MAAM,EAAE,QAAQ,EAAE,WAAW,GAAG,MAAM,CAyBxE;AAED,MAAM,WAAW,WAAW;IAC1B,QAAQ,EAAE,MAAM,CAAC;IACjB,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,OAAO,CAAC;IACnB,OAAO,EAAE,OAAO,CAAC;CAClB;AAED,wBAAgB,cAAc,CAAC,OAAO,EAAE,WAAW,EAAE,GAAG,MAAM,CAY7D"}

package/dist/cli/codegen.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generateFile = generateFile;
+exports.generateBarrel = generateBarrel;
+function typeToGeneric(fieldDef) {
+    if (fieldDef.type === 'enum' && fieldDef.values) {
+        return fieldDef.values
+            .map((v) => (typeof v === 'string' ? `'${v}'` : String(v)))
+            .join(' | ');
+    }
+    return fieldDef.type;
+}
+function generateFile(name, endpoint) {
+    const lines = [
+        "import { field, sortField } from '@nestjs-filter-grammar/client-query-builder';",
+        '',
+    ];
+    lines.push(`export const Filter${name} = {`);
+    for (const [fieldName, def] of Object.entries(endpoint.fields)) {
+        const generic = typeToGeneric(def);
+        const operators = JSON.stringify(def.operators);
+        lines.push(`  ${fieldName}: field<${generic}>('${fieldName}', ${operators}),`);
+    }
+    lines.push('} as const;');
+    if (endpoint.sortable.length > 0) {
+        lines.push('');
+        lines.push(`export const Sort${name} = {`);
+        for (const fieldName of endpoint.sortable) {
+            lines.push(`  ${fieldName}: sortField('${fieldName}'),`);
+        }
+        lines.push('} as const;');
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+function generateBarrel(entries) {
+    const lines = [];
+    for (const entry of entries) {
+        const exports = [];
+        if (entry.hasFilter)
+            exports.push(`Filter${entry.name}`);
+        if (entry.hasSort)
+            exports.push(`Sort${entry.name}`);
+        if (exports.length > 0) {
+            lines.push(`export { ${exports.join(', ')} } from './${entry.filename}';`);
+        }
+    }
+    lines.push('');
+    return lines.join('\n');
+}
+//# sourceMappingURL=codegen.js.map

package/dist/cli/codegen.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"codegen.js","sourceRoot":"","sources":["../../src/cli/codegen.ts"],"names":[],"mappings":";;AAoBA,oCAyBC;AASD,wCAYC;AAvDD,SAAS,aAAa,CAAC,QAAkB;IACvC,IAAI,QAAQ,CAAC,IAAI,KAAK,MAAM,IAAI,QAAQ,CAAC,MAAM,EAAE,CAAC;QAChD,OAAO,QAAQ,CAAC,MAAM;aACnB,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;aAC1D,IAAI,CAAC,KAAK,CAAC,CAAC;IACjB,CAAC;IACD,OAAO,QAAQ,CAAC,IAAI,CAAC;AACvB,CAAC;AAED,SAAgB,YAAY,CAAC,IAAY,EAAE,QAAqB;IAC9D,MAAM,KAAK,GAAa;QACtB,iFAAiF;QACjF,EAAE;KACH,CAAC;IAEF,KAAK,CAAC,IAAI,CAAC,sBAAsB,IAAI,MAAM,CAAC,CAAC;IAC7C,KAAK,MAAM,CAAC,SAAS,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,QAAQ,CAAC,MAAM,CAAC,EAAE,CAAC;QAC/D,MAAM,OAAO,GAAG,aAAa,CAAC,GAAG,CAAC,CAAC;QACnC,MAAM,SAAS,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,SAAS,CAAC,CAAC;QAChD,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,WAAW,OAAO,MAAM,SAAS,MAAM,SAAS,IAAI,CAAC,CAAC;IACjF,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAE1B,IAAI,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACjC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACf,KAAK,CAAC,IAAI,CAAC,oBAAoB,IAAI,MAAM,CAAC,CAAC;QAC3C,KAAK,MAAM,SAAS,IAAI,QAAQ,CAAC,QAAQ,EAAE,CAAC;YAC1C,KAAK,CAAC,IAAI,CAAC,KAAK,SAAS,gBAAgB,SAAS,KAAK,CAAC,CAAC;QAC3D,CAAC;QACD,KAAK,CAAC,IAAI,CAAC,aAAa,CAAC,CAAC;IAC5B,CAAC;IAED,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC;AASD,SAAgB,cAAc,CAAC,OAAsB;IACnD,MAAM,KAAK,GAAa,EAAE,CAAC;IAC3B,KAAK,MAAM,KAAK,IAAI,OAAO,EAAE,CAAC;QAC5B,MAAM,OAAO,GAAa,EAAE,CAAC;QAC7B,IAAI,KAAK,CAAC,SAAS;YAAE,OAAO,CAAC,IAAI,CAAC,SAAS,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACzD,IAAI,KAAK,CAAC,OAAO;YAAE,OAAO,CAAC,IAAI,CAAC,OAAO,KAAK,CAAC,IAAI,EAAE,CAAC,CAAC;QACrD,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;YACvB,KAAK,CAAC,IAAI,CAAC,YAAY,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,cAAc,KAAK,CAAC,QAAQ,IAAI,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IACD,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IACf,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC1B,CAAC"}

package/dist/cli/generate.d.ts

@@ -0,0 +1,2 @@
+export declare function generate(specPath: string, outputDir: string): void;
+//# sourceMappingURL=generate.d.ts.map

package/dist/cli/generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate.d.ts","sourceRoot":"","sources":["../../src/cli/generate.ts"],"names":[],"mappings":"AA+BA,wBAAgB,QAAQ,CAAC,QAAQ,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,GAAG,IAAI,CAoDlE"}

package/dist/cli/generate.js

@@ -0,0 +1,95 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
+    Object.defineProperty(o, "default", { enumerable: true, value: v });
+}) : function(o, v) {
+    o["default"] = v;
+});
+var __importStar = (this && this.__importStar) || (function () {
+    var ownKeys = function(o) {
+        ownKeys = Object.getOwnPropertyNames || function (o) {
+            var ar = [];
+            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
+            return ar;
+        };
+        return ownKeys(o);
+    };
+    return function (mod) {
+        if (mod && mod.__esModule) return mod;
+        var result = {};
+        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
+        __setModuleDefault(result, mod);
+        return result;
+    };
+})();
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.generate = generate;
+const fs_1 = require("fs");
+const path_1 = require("path");
+const yaml = __importStar(require("js-yaml"));
+const name_resolver_1 = require("./name-resolver");
+const codegen_1 = require("./codegen");
+function loadSpec(filePath) {
+    if (!(0, fs_1.existsSync)(filePath)) {
+        throw new Error(`File not found: ${filePath}`);
+    }
+    const content = (0, fs_1.readFileSync)(filePath, 'utf-8');
+    const ext = (0, path_1.extname)(filePath).toLowerCase();
+    if (ext === '.yaml' || ext === '.yml') {
+        return yaml.load(content);
+    }
+    return JSON.parse(content);
+}
+function generate(specPath, outputDir) {
+    const spec = loadSpec(specPath);
+    if (!spec.paths) {
+        console.warn('No paths found in spec');
+        return;
+    }
+    const endpoints = new Map();
+    for (const [path, methods] of Object.entries(spec.paths)) {
+        for (const operation of Object.values(methods)) {
+            const ext = operation['x-filter-grammar'];
+            if (ext) {
+                endpoints.set(path, {
+                    fields: ext.fields,
+                    sortable: ext.sortable,
+                });
+                break;
+            }
+        }
+    }
+    if (endpoints.size === 0) {
+        console.warn('No x-filter-grammar extensions found in spec');
+        return;
+    }
+    const names = (0, name_resolver_1.resolveNames)([...endpoints.keys()]);
+    (0, fs_1.mkdirSync)(outputDir, { recursive: true });
+    const barrelEntries = [];
+    for (const [path, endpoint] of endpoints) {
+        const name = names.get(path);
+        const filename = name.charAt(0).toLowerCase() + name.slice(1);
+        const content = (0, codegen_1.generateFile)(name, endpoint);
+        (0, fs_1.writeFileSync)((0, path_1.join)(outputDir, `${filename}.ts`), content);
+        barrelEntries.push({
+            filename,
+            name,
+            hasFilter: Object.keys(endpoint.fields).length > 0,
+            hasSort: endpoint.sortable.length > 0,
+        });
+    }
+    const barrelContent = (0, codegen_1.generateBarrel)(barrelEntries);
+    (0, fs_1.writeFileSync)((0, path_1.join)(outputDir, 'index.ts'), barrelContent);
+    console.log(`Generated ${barrelEntries.length} file(s) in ${outputDir}`);
+}
+//# sourceMappingURL=generate.js.map

package/dist/cli/generate.js.map

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

package/dist/cli/index.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=index.d.ts.map

package/dist/cli/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":""}

package/dist/cli/index.js

@@ -0,0 +1,24 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const commander_1 = require("commander");
+const generate_1 = require("./generate");
+const program = new commander_1.Command();
+program
+    .name('filter-grammar')
+    .description('Generate type-safe filter/sort query builders from OpenAPI specs');
+program
+    .command('generate')
+    .description('Generate TypeScript filter/sort builders from an OpenAPI spec')
+    .argument('<spec>', 'Path to OpenAPI JSON or YAML file')
+    .option('-o, --output <dir>', 'Output directory', './src/generated')
+    .action((spec, opts) => {
+    try {
+        (0, generate_1.generate)(spec, opts.output);
+    }
+    catch (err) {
+        console.error(`Error: ${err.message}`);
+        process.exit(1);
+    }
+});
+program.parse();
+//# sourceMappingURL=index.js.map

package/dist/cli/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/cli/index.ts"],"names":[],"mappings":";;AAAA,yCAAoC;AACpC,yCAAsC;AAEtC,MAAM,OAAO,GAAG,IAAI,mBAAO,EAAE,CAAC;AAE9B,OAAO;KACJ,IAAI,CAAC,gBAAgB,CAAC;KACtB,WAAW,CAAC,kEAAkE,CAAC,CAAC;AAEnF,OAAO;KACJ,OAAO,CAAC,UAAU,CAAC;KACnB,WAAW,CAAC,+DAA+D,CAAC;KAC5E,QAAQ,CAAC,QAAQ,EAAE,mCAAmC,CAAC;KACvD,MAAM,CAAC,oBAAoB,EAAE,kBAAkB,EAAE,iBAAiB,CAAC;KACnE,MAAM,CAAC,CAAC,IAAY,EAAE,IAAwB,EAAE,EAAE;IACjD,IAAI,CAAC;QACH,IAAA,mBAAQ,EAAC,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,OAAO,CAAC,KAAK,CAAC,UAAW,GAAa,CAAC,OAAO,EAAE,CAAC,CAAC;QAClD,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;AACH,CAAC,CAAC,CAAC;AAEL,OAAO,CAAC,KAAK,EAAE,CAAC"}

package/dist/cli/name-resolver.d.ts

@@ -0,0 +1,2 @@
+export declare function resolveNames(paths: string[]): Map<string, string>;
+//# sourceMappingURL=name-resolver.d.ts.map

package/dist/cli/name-resolver.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-resolver.d.ts","sourceRoot":"","sources":["../../src/cli/name-resolver.ts"],"names":[],"mappings":"AAoBA,wBAAgB,YAAY,CAAC,KAAK,EAAE,MAAM,EAAE,GAAG,GAAG,CAAC,MAAM,EAAE,MAAM,CAAC,CAyBjE"}

package/dist/cli/name-resolver.js

@@ -0,0 +1,43 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveNames = resolveNames;
+function pathToName(path) {
+    const segments = path
+        .split('/')
+        .filter((s) => s && !s.startsWith('{') && !isCommonPrefix(s));
+    if (segments.length === 0)
+        return 'Root';
+    // Use the last meaningful segment as the resource name
+    const last = segments[segments.length - 1];
+    return last.split('-').map(capitalize).join('');
+}
+function isCommonPrefix(segment) {
+    return /^(api|v\d+)$/i.test(segment);
+}
+function capitalize(s) {
+    return s.charAt(0).toUpperCase() + s.slice(1);
+}
+function resolveNames(paths) {
+    const rawNames = new Map();
+    for (const path of paths) {
+        rawNames.set(path, pathToName(path));
+    }
+    const nameCounts = new Map();
+    for (const name of rawNames.values()) {
+        nameCounts.set(name, (nameCounts.get(name) ?? 0) + 1);
+    }
+    const result = new Map();
+    const usedNames = new Map();
+    for (const [path, name] of rawNames) {
+        if ((nameCounts.get(name) ?? 0) > 1) {
+            const count = usedNames.get(name) ?? 0;
+            result.set(path, count === 0 ? name : `${name}Fields`);
+            usedNames.set(name, count + 1);
+        }
+        else {
+            result.set(path, name);
+        }
+    }
+    return result;
+}
+//# sourceMappingURL=name-resolver.js.map

package/dist/cli/name-resolver.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"name-resolver.js","sourceRoot":"","sources":["../../src/cli/name-resolver.ts"],"names":[],"mappings":";;AAoBA,oCAyBC;AA7CD,SAAS,UAAU,CAAC,IAAY;IAC9B,MAAM,QAAQ,GAAG,IAAI;SAClB,KAAK,CAAC,GAAG,CAAC;SACV,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC,CAAC,CAAC,CAAC;IAEhE,IAAI,QAAQ,CAAC,MAAM,KAAK,CAAC;QAAE,OAAO,MAAM,CAAC;IAEzC,uDAAuD;IACvD,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;IAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,UAAU,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;AAClD,CAAC;AAED,SAAS,cAAc,CAAC,OAAe;IACrC,OAAO,eAAe,CAAC,IAAI,CAAC,OAAO,CAAC,CAAC;AACvC,CAAC;AAED,SAAS,UAAU,CAAC,CAAS;IAC3B,OAAO,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,WAAW,EAAE,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC;AAChD,CAAC;AAED,SAAgB,YAAY,CAAC,KAAe;IAC1C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;QACzB,QAAQ,CAAC,GAAG,CAAC,IAAI,EAAE,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IACvC,CAAC;IAED,MAAM,UAAU,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC7C,KAAK,MAAM,IAAI,IAAI,QAAQ,CAAC,MAAM,EAAE,EAAE,CAAC;QACrC,UAAU,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACxD,CAAC;IAED,MAAM,MAAM,GAAG,IAAI,GAAG,EAAkB,CAAC;IACzC,MAAM,SAAS,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE5C,KAAK,MAAM,CAAC,IAAI,EAAE,IAAI,CAAC,IAAI,QAAQ,EAAE,CAAC;QACpC,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,EAAE,CAAC;YACpC,MAAM,KAAK,GAAG,SAAS,CAAC,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;YACvC,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,GAAG,IAAI,QAAQ,CAAC,CAAC;YACvD,SAAS,CAAC,GAAG,CAAC,IAAI,EAAE,KAAK,GAAG,CAAC,CAAC,CAAC;QACjC,CAAC;aAAM,CAAC;YACN,MAAM,CAAC,GAAG,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC;QACzB,CAAC;IACH,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC"}

package/dist/combinators.d.ts

@@ -0,0 +1,4 @@
+import { Buildable, CompoundCondition } from './condition';
+export declare function and(...conditions: Buildable[]): CompoundCondition;
+export declare function or(...conditions: Buildable[]): CompoundCondition;
+//# sourceMappingURL=combinators.d.ts.map

package/dist/combinators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.d.ts","sourceRoot":"","sources":["../src/combinators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAE3D,wBAAgB,GAAG,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAEjE;AAED,wBAAgB,EAAE,CAAC,GAAG,UAAU,EAAE,SAAS,EAAE,GAAG,iBAAiB,CAEhE"}

package/dist/combinators.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.and = and;
+exports.or = or;
+const condition_1 = require("./condition");
+function and(...conditions) {
+    return new condition_1.CompoundCondition('AND', conditions);
+}
+function or(...conditions) {
+    return new condition_1.CompoundCondition('OR', conditions);
+}
+//# sourceMappingURL=combinators.js.map

package/dist/combinators.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"combinators.js","sourceRoot":"","sources":["../src/combinators.ts"],"names":[],"mappings":";;AAEA,kBAEC;AAED,gBAEC;AARD,2CAA2D;AAE3D,SAAgB,GAAG,CAAC,GAAG,UAAuB;IAC5C,OAAO,IAAI,6BAAiB,CAAC,KAAK,EAAE,UAAU,CAAC,CAAC;AAClD,CAAC;AAED,SAAgB,EAAE,CAAC,GAAG,UAAuB;IAC3C,OAAO,IAAI,6BAAiB,CAAC,IAAI,EAAE,UAAU,CAAC,CAAC;AACjD,CAAC"}

package/dist/condition.d.ts

@@ -0,0 +1,18 @@
+export interface Buildable {
+    build(): string;
+    readonly compoundType?: 'AND' | 'OR';
+}
+export declare class Condition implements Buildable {
+    private readonly fieldName;
+    private readonly operator;
+    private readonly values;
+    constructor(fieldName: string, operator: string, values: (string | number | boolean | null)[]);
+    build(): string;
+}
+export declare class CompoundCondition implements Buildable {
+    private readonly children;
+    readonly compoundType: 'AND' | 'OR';
+    constructor(type: 'AND' | 'OR', children: Buildable[]);
+    build(): string;
+}
+//# sourceMappingURL=condition.d.ts.map

package/dist/condition.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.d.ts","sourceRoot":"","sources":["../src/condition.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,SAAS;IACxB,KAAK,IAAI,MAAM,CAAC;IAChB,QAAQ,CAAC,YAAY,CAAC,EAAE,KAAK,GAAG,IAAI,CAAC;CACtC;AAED,qBAAa,SAAU,YAAW,SAAS;IAEvC,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,QAAQ;IACzB,OAAO,CAAC,QAAQ,CAAC,MAAM;gBAFN,SAAS,EAAE,MAAM,EACjB,QAAQ,EAAE,MAAM,EAChB,MAAM,EAAE,CAAC,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,CAAC,EAAE;IAG/D,KAAK,IAAI,MAAM;CAIhB;AAED,qBAAa,iBAAkB,YAAW,SAAS;IAK/C,OAAO,CAAC,QAAQ,CAAC,QAAQ;IAJ3B,QAAQ,CAAC,YAAY,EAAE,KAAK,GAAG,IAAI,CAAC;gBAGlC,IAAI,EAAE,KAAK,GAAG,IAAI,EACD,QAAQ,EAAE,SAAS,EAAE;IAKxC,KAAK,IAAI,MAAM;CAiBhB"}

package/dist/condition.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.CompoundCondition = exports.Condition = void 0;
+const serialize_1 = require("./serialize");
+class Condition {
+    constructor(fieldName, operator, values) {
+        this.fieldName = fieldName;
+        this.operator = operator;
+        this.values = values;
+    }
+    build() {
+        const serializedValues = this.values.map(serialize_1.serializeValue).join(',');
+        return `${this.fieldName}${this.operator}${serializedValues}`;
+    }
+}
+exports.Condition = Condition;
+class CompoundCondition {
+    constructor(type, children) {
+        this.children = children;
+        this.compoundType = type;
+    }
+    build() {
+        if (this.children.length === 1) {
+            return this.children[0].build();
+        }
+        const separator = this.compoundType === 'AND' ? ';' : '|';
+        return this.children
+            .map((child) => {
+            const built = child.build();
+            if (child.compoundType && child.compoundType !== this.compoundType) {
+                return `(${built})`;
+            }
+            return built;
+        })
+            .join(separator);
+    }
+}
+exports.CompoundCondition = CompoundCondition;
+//# sourceMappingURL=condition.js.map

package/dist/condition.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"condition.js","sourceRoot":"","sources":["../src/condition.ts"],"names":[],"mappings":";;;AAAA,2CAA6C;AAO7C,MAAa,SAAS;IACpB,YACmB,SAAiB,EACjB,QAAgB,EAChB,MAA4C;QAF5C,cAAS,GAAT,SAAS,CAAQ;QACjB,aAAQ,GAAR,QAAQ,CAAQ;QAChB,WAAM,GAAN,MAAM,CAAsC;IAC5D,CAAC;IAEJ,KAAK;QACH,MAAM,gBAAgB,GAAG,IAAI,CAAC,MAAM,CAAC,GAAG,CAAC,0BAAc,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACnE,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,QAAQ,GAAG,gBAAgB,EAAE,CAAC;IAChE,CAAC;CACF;AAXD,8BAWC;AAED,MAAa,iBAAiB;IAG5B,YACE,IAAkB,EACD,QAAqB;QAArB,aAAQ,GAAR,QAAQ,CAAa;QAEtC,IAAI,CAAC,YAAY,GAAG,IAAI,CAAC;IAC3B,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,QAAQ,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/B,OAAO,IAAI,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC;QAClC,CAAC;QAED,MAAM,SAAS,GAAG,IAAI,CAAC,YAAY,KAAK,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC;QAE1D,OAAO,IAAI,CAAC,QAAQ;aACjB,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE;YACb,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC;YAC5B,IAAI,KAAK,CAAC,YAAY,IAAI,KAAK,CAAC,YAAY,KAAK,IAAI,CAAC,YAAY,EAAE,CAAC;gBACnE,OAAO,IAAI,KAAK,GAAG,CAAC;YACtB,CAAC;YACD,OAAO,KAAK,CAAC;QACf,CAAC,CAAC;aACD,IAAI,CAAC,SAAS,CAAC,CAAC;IACrB,CAAC;CACF;AA3BD,8CA2BC"}

package/dist/field.d.ts

@@ -0,0 +1,2 @@
+export declare function field<T>(name: string, operatorSymbols: string[]): Record<string, Function>;
+//# sourceMappingURL=field.d.ts.map

package/dist/field.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.d.ts","sourceRoot":"","sources":["../src/field.ts"],"names":[],"mappings":"AAKA,wBAAgB,KAAK,CAAC,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,eAAe,EAAE,MAAM,EAAE,GAAG,MAAM,CAAC,MAAM,EAAE,QAAQ,CAAC,CAiB1F"}

package/dist/field.js

@@ -0,0 +1,22 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.field = field;
+const condition_1 = require("./condition");
+const serialize_1 = require("./serialize");
+const MULTI_VALUE_METHODS = new Set(['eq', 'neq', 'iEq', 'iNeq']);
+function field(name, operatorSymbols) {
+    const methods = {};
+    for (const symbol of operatorSymbols) {
+        const methodName = (0, serialize_1.methodNameForSymbol)(symbol);
+        if (!methodName)
+            continue;
+        if (MULTI_VALUE_METHODS.has(methodName)) {
+            methods[methodName] = (...values) => new condition_1.Condition(name, symbol, values);
+        }
+        else {
+            methods[methodName] = (value) => new condition_1.Condition(name, symbol, [value]);
+        }
+    }
+    return methods;
+}
+//# sourceMappingURL=field.js.map

package/dist/field.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"field.js","sourceRoot":"","sources":["../src/field.ts"],"names":[],"mappings":";;AAKA,sBAiBC;AAtBD,2CAAwC;AACxC,2CAAkD;AAElD,MAAM,mBAAmB,GAAG,IAAI,GAAG,CAAC,CAAC,IAAI,EAAE,KAAK,EAAE,KAAK,EAAE,MAAM,CAAC,CAAC,CAAC;AAElE,SAAgB,KAAK,CAAI,IAAY,EAAE,eAAyB;IAC9D,MAAM,OAAO,GAA6B,EAAE,CAAC;IAE7C,KAAK,MAAM,MAAM,IAAI,eAAe,EAAE,CAAC;QACrC,MAAM,UAAU,GAAG,IAAA,+BAAmB,EAAC,MAAM,CAAC,CAAC;QAC/C,IAAI,CAAC,UAAU;YAAE,SAAS;QAE1B,IAAI,mBAAmB,CAAC,GAAG,CAAC,UAAU,CAAC,EAAE,CAAC;YACxC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,MAAoB,EAAE,EAAE,CAChD,IAAI,qBAAS,CAAC,IAAI,EAAE,MAAM,EAAE,MAA8C,CAAC,CAAC;QAChF,CAAC;aAAM,CAAC;YACN,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,KAAQ,EAAE,EAAE,CACjC,IAAI,qBAAS,CAAC,IAAI,EAAE,MAAM,EAAE,CAAC,KAAyC,CAAC,CAAC,CAAC;QAC7E,CAAC;IACH,CAAC;IAED,OAAO,OAAO,CAAC;AACjB,CAAC"}

package/dist/index.d.ts

@@ -0,0 +1,7 @@
+export { Condition, CompoundCondition } from './condition';
+export type { Buildable } from './condition';
+export { and, or } from './combinators';
+export { field } from './field';
+export { sortField, sort, SortExpression } from './sort';
+export { serializeValue } from './serialize';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAC3D,YAAY,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAC7C,OAAO,EAAE,GAAG,EAAE,EAAE,EAAE,MAAM,eAAe,CAAC;AACxC,OAAO,EAAE,KAAK,EAAE,MAAM,SAAS,CAAC;AAChC,OAAO,EAAE,SAAS,EAAE,IAAI,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAC;AACzD,OAAO,EAAE,cAAc,EAAE,MAAM,aAAa,CAAC"}

package/dist/index.js

@@ -0,0 +1,18 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeValue = exports.SortExpression = exports.sort = exports.sortField = exports.field = exports.or = exports.and = exports.CompoundCondition = exports.Condition = void 0;
+var condition_1 = require("./condition");
+Object.defineProperty(exports, "Condition", { enumerable: true, get: function () { return condition_1.Condition; } });
+Object.defineProperty(exports, "CompoundCondition", { enumerable: true, get: function () { return condition_1.CompoundCondition; } });
+var combinators_1 = require("./combinators");
+Object.defineProperty(exports, "and", { enumerable: true, get: function () { return combinators_1.and; } });
+Object.defineProperty(exports, "or", { enumerable: true, get: function () { return combinators_1.or; } });
+var field_1 = require("./field");
+Object.defineProperty(exports, "field", { enumerable: true, get: function () { return field_1.field; } });
+var sort_1 = require("./sort");
+Object.defineProperty(exports, "sortField", { enumerable: true, get: function () { return sort_1.sortField; } });
+Object.defineProperty(exports, "sort", { enumerable: true, get: function () { return sort_1.sort; } });
+Object.defineProperty(exports, "SortExpression", { enumerable: true, get: function () { return sort_1.SortExpression; } });
+var serialize_1 = require("./serialize");
+Object.defineProperty(exports, "serializeValue", { enumerable: true, get: function () { return serialize_1.serializeValue; } });
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,yCAA2D;AAAlD,sGAAA,SAAS,OAAA;AAAE,8GAAA,iBAAiB,OAAA;AAErC,6CAAwC;AAA/B,kGAAA,GAAG,OAAA;AAAE,iGAAA,EAAE,OAAA;AAChB,iCAAgC;AAAvB,8FAAA,KAAK,OAAA;AACd,+BAAyD;AAAhD,iGAAA,SAAS,OAAA;AAAE,4FAAA,IAAI,OAAA;AAAE,sGAAA,cAAc,OAAA;AACxC,yCAA6C;AAApC,2GAAA,cAAc,OAAA"}

package/dist/serialize.d.ts

@@ -0,0 +1,4 @@
+export declare function serializeValue(value: string | number | boolean | null): string;
+export declare function operatorSymbol(methodName: string): string;
+export declare function methodNameForSymbol(symbol: string): string;
+//# sourceMappingURL=serialize.d.ts.map

package/dist/serialize.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.d.ts","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":"AAEA,wBAAgB,cAAc,CAAC,KAAK,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAS9E;AAmBD,wBAAgB,cAAc,CAAC,UAAU,EAAE,MAAM,GAAG,MAAM,CAEzD;AAOD,wBAAgB,mBAAmB,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,CAE1D"}

package/dist/serialize.js

@@ -0,0 +1,44 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.serializeValue = serializeValue;
+exports.operatorSymbol = operatorSymbol;
+exports.methodNameForSymbol = methodNameForSymbol;
+const NEEDS_QUOTING = /[,"|;!=><^$*~()\\\s]/;
+function serializeValue(value) {
+    if (value === null)
+        return 'null';
+    if (typeof value === 'number' || typeof value === 'boolean')
+        return String(value);
+    if (NEEDS_QUOTING.test(value)) {
+        const escaped = value.replace(/\\/g, '\\\\').replace(/"/g, '\\"');
+        return `"${escaped}"`;
+    }
+    return value;
+}
+const OPERATOR_SYMBOLS = {
+    eq: '=',
+    neq: '!=',
+    gt: '>',
+    lt: '<',
+    gte: '>=',
+    lte: '<=',
+    iEq: '~',
+    iNeq: '!~',
+    startsWith: '^=',
+    endsWith: '$=',
+    contains: '*=',
+    iStartsWith: '^~',
+    iEndsWith: '$~',
+    iContains: '*~',
+};
+function operatorSymbol(methodName) {
+    return OPERATOR_SYMBOLS[methodName];
+}
+const SYMBOL_TO_METHOD = {};
+for (const [method, symbol] of Object.entries(OPERATOR_SYMBOLS)) {
+    SYMBOL_TO_METHOD[symbol] = method;
+}
+function methodNameForSymbol(symbol) {
+    return SYMBOL_TO_METHOD[symbol];
+}
+//# sourceMappingURL=serialize.js.map

package/dist/serialize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serialize.js","sourceRoot":"","sources":["../src/serialize.ts"],"names":[],"mappings":";;AAEA,wCASC;AAmBD,wCAEC;AAOD,kDAEC;AAzCD,MAAM,aAAa,GAAG,sBAAsB,CAAC;AAE7C,SAAgB,cAAc,CAAC,KAAuC;IACpE,IAAI,KAAK,KAAK,IAAI;QAAE,OAAO,MAAM,CAAC;IAClC,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,OAAO,KAAK,KAAK,SAAS;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,CAAC;IAElF,IAAI,aAAa,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9B,MAAM,OAAO,GAAG,KAAK,CAAC,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;QAClE,OAAO,IAAI,OAAO,GAAG,CAAC;IACxB,CAAC;IACD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,gBAAgB,GAA2B;IAC/C,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,IAAI;IACT,EAAE,EAAE,GAAG;IACP,EAAE,EAAE,GAAG;IACP,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,IAAI;IACT,GAAG,EAAE,GAAG;IACR,IAAI,EAAE,IAAI;IACV,UAAU,EAAE,IAAI;IAChB,QAAQ,EAAE,IAAI;IACd,QAAQ,EAAE,IAAI;IACd,WAAW,EAAE,IAAI;IACjB,SAAS,EAAE,IAAI;IACf,SAAS,EAAE,IAAI;CAChB,CAAC;AAEF,SAAgB,cAAc,CAAC,UAAkB;IAC/C,OAAO,gBAAgB,CAAC,UAAU,CAAC,CAAC;AACtC,CAAC;AAED,MAAM,gBAAgB,GAA2B,EAAE,CAAC;AACpD,KAAK,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,gBAAgB,CAAC,EAAE,CAAC;IAChE,gBAAgB,CAAC,MAAM,CAAC,GAAG,MAAM,CAAC;AACpC,CAAC;AAED,SAAgB,mBAAmB,CAAC,MAAc;IAChD,OAAO,gBAAgB,CAAC,MAAM,CAAC,CAAC;AAClC,CAAC"}

package/dist/sort.d.ts

@@ -0,0 +1,13 @@
+import { Buildable } from './condition';
+export declare class SortExpression implements Buildable {
+    private readonly fieldName;
+    private readonly direction;
+    constructor(fieldName: string, direction: '+' | '-');
+    build(): string;
+}
+export declare function sortField(name: string): {
+    asc(): SortExpression;
+    desc(): SortExpression;
+};
+export declare function sort(...expressions: SortExpression[]): Buildable;
+//# sourceMappingURL=sort.d.ts.map

package/dist/sort.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.d.ts","sourceRoot":"","sources":["../src/sort.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,aAAa,CAAC;AAExC,qBAAa,cAAe,YAAW,SAAS;IAE5C,OAAO,CAAC,QAAQ,CAAC,SAAS;IAC1B,OAAO,CAAC,QAAQ,CAAC,SAAS;gBADT,SAAS,EAAE,MAAM,EACjB,SAAS,EAAE,GAAG,GAAG,GAAG;IAGvC,KAAK,IAAI,MAAM;CAGhB;AAED,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG;IAAE,GAAG,IAAI,cAAc,CAAC;IAAC,IAAI,IAAI,cAAc,CAAA;CAAE,CAKzF;AAED,wBAAgB,IAAI,CAAC,GAAG,WAAW,EAAE,cAAc,EAAE,GAAG,SAAS,CAIhE"}

package/dist/sort.js

@@ -0,0 +1,27 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.SortExpression = void 0;
+exports.sortField = sortField;
+exports.sort = sort;
+class SortExpression {
+    constructor(fieldName, direction) {
+        this.fieldName = fieldName;
+        this.direction = direction;
+    }
+    build() {
+        return `${this.direction}${this.fieldName}`;
+    }
+}
+exports.SortExpression = SortExpression;
+function sortField(name) {
+    return {
+        asc: () => new SortExpression(name, '+'),
+        desc: () => new SortExpression(name, '-'),
+    };
+}
+function sort(...expressions) {
+    return {
+        build: () => expressions.map((e) => e.build()).join(','),
+    };
+}
+//# sourceMappingURL=sort.js.map

package/dist/sort.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"sort.js","sourceRoot":"","sources":["../src/sort.ts"],"names":[],"mappings":";;;AAaA,8BAKC;AAED,oBAIC;AAtBD,MAAa,cAAc;IACzB,YACmB,SAAiB,EACjB,SAAoB;QADpB,cAAS,GAAT,SAAS,CAAQ;QACjB,cAAS,GAAT,SAAS,CAAW;IACpC,CAAC;IAEJ,KAAK;QACH,OAAO,GAAG,IAAI,CAAC,SAAS,GAAG,IAAI,CAAC,SAAS,EAAE,CAAC;IAC9C,CAAC;CACF;AATD,wCASC;AAED,SAAgB,SAAS,CAAC,IAAY;IACpC,OAAO;QACL,GAAG,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC;QACxC,IAAI,EAAE,GAAG,EAAE,CAAC,IAAI,cAAc,CAAC,IAAI,EAAE,GAAG,CAAC;KAC1C,CAAC;AACJ,CAAC;AAED,SAAgB,IAAI,CAAC,GAAG,WAA6B;IACnD,OAAO;QACL,KAAK,EAAE,GAAG,EAAE,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;KACzD,CAAC;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,28 @@
+{
+  "name": "@nestjs-filter-grammar/client-query-builder",
+  "version": "0.1.0",
+  "description": "Type-safe client-side filter/sort query builder with OpenAPI codegen for @nestjs-filter-grammar",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "bin": {
+    "filter-grammar": "./bin/filter-grammar.js"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.build.json",
+    "test": "vitest run",
+    "test:watch": "vitest",
+    "typecheck": "tsc --noEmit"
+  },
+  "dependencies": {
+    "commander": "^12.0.0",
+    "js-yaml": "^4.0.0"
+  },
+  "devDependencies": {
+    "@types/js-yaml": "^4.0.0",
+    "@types/node": "^20.19.37"
+  },
+  "files": [
+    "dist",
+    "bin"
+  ]
+}