![\"rapiq\"](\"https://raw.githubusercontent.com/tada5hi/rapiq/master/.github/assets/logo.svg\"){kind=logo}
\n \n\n \n \n \n
\n Parse a function-call filter language into a rapiq Query.
\n For when a single string must carry a whole condition tree:
\n search boxes, saved filters, CLI flags.\n
\n ![\"npm](\"https://img.shields.io/npm/v/@rapiq/parser-expression?color=%23a21caf&label=npm\")
![\"types\"](\"https://img.shields.io/npm/types/@rapiq/parser-expression?color=%23db2777\")
![\"License:](\"https://img.shields.io/npm/l/@rapiq/parser-expression?color=blue\")
\n Documentation\n ·\n Monorepo\n ·\n npm\n
\n\n---\n\nPart of [**rapiq**](https://github.com/tada5hi/rapiq). Typed REST queries: *build, transport, validate, execute.*\nA tokenizer + recursive-descent parser for a compact, human-readable filter language: the default filter format the [URL codec](https://www.npmjs.com/package/@rapiq/codec-url) writes.\n\n```txt\nand(eq(name, 'John'), gte(age, '18'))\nor(in(status, 'active', 'pending'), gt(age, '65'))\nnot(contains(user.name, 'Bob'))\n```\n\n- 🧵 **One string, whole tree**: arbitrary `and` / `or` / `not` nesting fits in a single value; ideal for URLs, saved filters and CLI flags.\n- 🎯 **Explicit operators**: `eq`, `ne`, `lt(e)`, `gt(e)`, `in`, `nin`, `contains`, `startsWith`, `endsWith`, and their negations, with no operator guessing.\n- 🛡️ **Fails loud**: syntax errors and schema violations throw `FiltersParseError` immediately; there is no silent-drop mode for malformed expressions.\n- 🔗 **Same AST as every dialect**: only `filters` is expression-flavoured; fields, relations, pagination and sorts reuse `@rapiq/parser-simple`.\n\n## Installation\n\n```sh\nnpm install @rapiq/core @rapiq/parser-simple @rapiq/parser-expression\n```\n\n## Usage\n\n```typescript\nimport { ExpressionParser } from '@rapiq/parser-expression';\n\nconst parser = new ExpressionParser(registry);\n\nconst query = parser.parse({\n filters: \"and(eq(name, 'John'), gte(age, '18'))\",\n sorts: '-age',\n pagination: { limit: 25 },\n}, { schema: 'user' });\n```\n\nOnly the `filters` parameter uses the expression language; fields, relations, pagination and sorts accept the same input as [@rapiq/parser-simple](https://www.npmjs.com/package/@rapiq/parser-simple), and the whole thing returns the same [`Query`](https://rapiq.tada5hi.net/guide/query-ast) AST. A standalone `parseFilters(input, options)` returns just the `Filters` node.\n\n**The grammar**: `eq`, `ne`, `lt`, `lte`, `gt`, `gte`, `in`, `nin`, `contains`, `startsWith`, `endsWith` (and negations) as leaf conditions, composed with `and(…)` / `or(…)` / `not(…)`. Values are always single-quoted (`gte(age, '18')`); quoted numerals coerce to numbers, `'true'` / `'false'` to booleans, `'null'` to `null`.\n\nSyntax errors and schema violations throw `FiltersParseError` immediately; the expression parser has no silent-drop mode for malformed expressions.\n\n## The rapiq family\n\n| Package | Purpose |\n|---|---|\n| [@rapiq/core](https://github.com/tada5hi/rapiq/tree/master/packages/core) | Query AST, typed build layer & schema system (the shared foundation) |\n| [@rapiq/parser-simple](https://github.com/tada5hi/rapiq/tree/master/packages/parser-simple) | Parse plain object/array input (the \"simple\" dialect) |\n| **[@rapiq/parser-expression](https://github.com/tada5hi/rapiq/tree/master/packages/parser-expression)** | Parse filter expressions like `and(eq(name,'John'), gte(age,'18'))` |\n| [@rapiq/parser-mongo](https://github.com/tada5hi/rapiq/tree/master/packages/parser-mongo) | Parse MongoDB-style filter documents like `{ age: { $gte: 18 } }` |\n| [@rapiq/codec-url](https://github.com/tada5hi/rapiq/tree/master/packages/codec-url) | URL query-string transport codec |\n| [@rapiq/adapter-sql](https://github.com/tada5hi/rapiq/tree/master/packages/adapter-sql) | Dialect-agnostic SQL fragment adapter (pg, mysql, sqlite, mssql, oracle) |\n| [@rapiq/adapter-typeorm](https://github.com/tada5hi/rapiq/tree/master/packages/adapter-typeorm) | Apply a query to a TypeORM `SelectQueryBuilder` |\n| [@rapiq/adapter-prisma](https://github.com/tada5hi/rapiq/tree/master/packages/adapter-prisma) | Serialize a query into a Prisma argument object |\n| [@rapiq/adapter-drizzle](https://github.com/tada5hi/rapiq/tree/master/packages/adapter-drizzle) | Serialize a query into a Drizzle relational query config |\n| [@rapiq/adapter-memory](https://github.com/tada5hi/rapiq/tree/master/packages/adapter-memory) | Evaluate a query against in-memory objects & arrays |\n\n## Documentation\n\nFull guide (grammar & operator table): [rapiq.tada5hi.net/packages/parser-expression](https://rapiq.tada5hi.net/packages/parser-expression)\n\n## License\n\nPublished under the [MIT License](https://github.com/tada5hi/rapiq/blob/master/LICENSE).\n","readmeFilename":"README.md"}