qast 1.2.0 → 2.0.0

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

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

package/dist/errors.d.ts

@@ -10,11 +10,16 @@ export declare class QastError extends Error {
 export declare class TokenizationError extends QastError {
     readonly position: number;
     readonly query: string;
-    constructor(message: string, position: number, query: string);
+    readonly suggestions?: string[];
+    constructor(message: string, position: number, query: string, suggestions?: string[]);
     /**
      * Get a snippet of the query around the error position
      */
     getSnippet(): string;
+    /**
+     * Get suggestions for fixing the error
+     */
+    getSuggestions(): string[];
 }
 /**
  * Error thrown during parsing when the query syntax is invalid
@@ -22,7 +27,12 @@ export declare class TokenizationError extends QastError {
 export declare class ParseError extends QastError {
     readonly position: number;
     readonly query: string;
-    constructor(message: string, position?: number, query?: string);
+    readonly suggestions?: string[];
+    constructor(message: string, position?: number, query?: string, suggestions?: string[]);
+    /**
+     * Get suggestions for fixing the error
+     */
+    getSuggestions(): string[];
 }
 /**
  * Error thrown during validation when a field or operator is not allowed
@@ -30,6 +40,11 @@ export declare class ParseError extends QastError {
 export declare class ValidationError extends QastError {
     readonly field?: string;
     readonly operator?: string;
-    constructor(message: string, field?: string, operator?: string);
+    readonly suggestions?: string[];
+    constructor(message: string, field?: string, operator?: string, suggestions?: string[]);
+    /**
+     * Get suggestions for fixing the error
+     */
+    getSuggestions(): string[];
 }
 //# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM;IAO5D;;OAEG;IACH,UAAU,IAAI,MAAM;CAOrB;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACvC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,MAAM,CAAC;gBAElB,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM;CAM/D;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM;CAM/D"}
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,SAAU,SAAQ,KAAK;gBACtB,OAAO,EAAE,MAAM;CAK5B;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,SAAS;IAC9C,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAsBpF;;OAEG;IACH,UAAU,IAAI,MAAM;IAUpB;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;CAsB3B;AAED;;GAEG;AACH,qBAAa,UAAW,SAAQ,SAAS;IACvC,SAAgB,QAAQ,EAAE,MAAM,CAAC;IACjC,SAAgB,KAAK,EAAE,MAAM,CAAC;IAC9B,SAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAqBtF;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;CAsB3B;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,SAAS;IAC5C,SAAgB,KAAK,CAAC,EAAE,MAAM,CAAC;IAC/B,SAAgB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClC,SAAgB,WAAW,CAAC,EAAE,MAAM,EAAE,CAAC;gBAE3B,OAAO,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,MAAM,EAAE,QAAQ,CAAC,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE;IAkBtF;;OAEG;IACH,cAAc,IAAI,MAAM,EAAE;CAyB3B"}

package/dist/errors.js

@@ -16,21 +16,64 @@ exports.QastError = QastError;
  * Error thrown during tokenization when an invalid token is encountered
  */
 class TokenizationError extends QastError {
-    constructor(message, position, query) {
-        super(`${message} at position ${position}`);
+    constructor(message, position, query, suggestions) {
+        // Generate snippet without using this
+        const contextSize = 20;
+        const start = Math.max(0, position - contextSize);
+        const end = Math.min(query.length, position + contextSize);
+        const before = query.substring(start, position);
+        const after = query.substring(position, end);
+        const lineNumber = query.substring(0, position).split('\n').length;
+        const snippet = `Line ${lineNumber}, Column ${position - query.lastIndexOf('\n', position - 1)}\n${before}[ERROR]${after}`;
+        const enhancedMessage = `${message} at position ${position}\n${snippet}`;
+        if (suggestions && suggestions.length > 0) {
+            super(`${enhancedMessage}\nSuggestions: ${suggestions.join(', ')}`);
+        }
+        else {
+            super(enhancedMessage);
+        }
         this.position = position;
         this.query = query;
+        this.suggestions = suggestions;
         this.name = 'TokenizationError';
     }
     /**
      * Get a snippet of the query around the error position
      */
     getSnippet() {
-        const start = Math.max(0, this.position - 10);
-        const end = Math.min(this.query.length, this.position + 10);
+        const contextSize = 20;
+        const start = Math.max(0, this.position - contextSize);
+        const end = Math.min(this.query.length, this.position + contextSize);
         const before = this.query.substring(start, this.position);
         const after = this.query.substring(this.position, end);
-        return `${before}[ERROR]${after}`;
+        const lineNumber = this.query.substring(0, this.position).split('\n').length;
+        return `Line ${lineNumber}, Column ${this.position - this.query.lastIndexOf('\n', this.position - 1)}\n${before}[ERROR]${after}`;
+    }
+    /**
+     * Get suggestions for fixing the error
+     */
+    getSuggestions() {
+        if (this.suggestions) {
+            return this.suggestions;
+        }
+        const char = this.query[this.position];
+        const suggestions = [];
+        if (char === undefined) {
+            suggestions.push('Query appears to be incomplete');
+        }
+        else if (/[{}[\]]/.test(char)) {
+            suggestions.push('Unmatched bracket or brace');
+        }
+        else if (char === '"' || char === "'") {
+            suggestions.push('Unterminated string literal - check for matching quotes');
+        }
+        else if (/\d/.test(char)) {
+            suggestions.push('Invalid number format');
+        }
+        else {
+            suggestions.push(`Unexpected character: ${char}`);
+        }
+        return suggestions;
     }
 }
 exports.TokenizationError = TokenizationError;
@@ -38,24 +81,99 @@ exports.TokenizationError = TokenizationError;
  * Error thrown during parsing when the query syntax is invalid
  */
 class ParseError extends QastError {
-    constructor(message, position, query) {
-        super(message);
+    constructor(message, position, query, suggestions) {
+        let enhancedMessage = message;
+        if (position !== undefined && position >= 0 && query) {
+            const contextSize = 20;
+            const start = Math.max(0, position - contextSize);
+            const end = Math.min(query.length, position + contextSize);
+            const before = query.substring(start, position);
+            const after = query.substring(position, end);
+            const lineNumber = query.substring(0, position).split('\n').length;
+            enhancedMessage = `${message}\nPosition: ${position} (Line ${lineNumber})\nContext: ${before}[ERROR]${after}`;
+        }
+        if (suggestions && suggestions.length > 0) {
+            enhancedMessage += `\nSuggestions: ${suggestions.join(', ')}`;
+        }
+        super(enhancedMessage);
         this.position = position ?? -1;
         this.query = query ?? '';
+        this.suggestions = suggestions;
         this.name = 'ParseError';
     }
+    /**
+     * Get suggestions for fixing the error
+     */
+    getSuggestions() {
+        if (this.suggestions) {
+            return this.suggestions;
+        }
+        const suggestions = [];
+        if (this.message.includes('Expected')) {
+            suggestions.push('Check the syntax around the error position');
+            suggestions.push('Ensure all parentheses are properly closed');
+            suggestions.push('Verify operator syntax (e.g., "eq", "gt", "and")');
+        }
+        else if (this.message.includes('parenthesis')) {
+            suggestions.push('Check for unmatched opening or closing parentheses');
+            suggestions.push('Ensure all opening parentheses have matching closing ones');
+        }
+        else if (this.message.includes('operator')) {
+            suggestions.push('Valid operators: eq, ne, gt, lt, gte, lte, in, notIn, contains, startsWith, endsWith, like, regex, matches');
+        }
+        else if (this.message.includes('Empty query')) {
+            suggestions.push('Provide a non-empty query string');
+        }
+        return suggestions;
+    }
 }
 exports.ParseError = ParseError;
 /**
  * Error thrown during validation when a field or operator is not allowed
  */
 class ValidationError extends QastError {
-    constructor(message, field, operator) {
-        super(message);
+    constructor(message, field, operator, suggestions) {
+        let enhancedMessage = message;
+        if (field) {
+            enhancedMessage += `\nField: ${field}`;
+        }
+        if (operator) {
+            enhancedMessage += `\nOperator: ${operator}`;
+        }
+        if (suggestions && suggestions.length > 0) {
+            enhancedMessage += `\nSuggestions: ${suggestions.join(', ')}`;
+        }
+        super(enhancedMessage);
         this.field = field;
         this.operator = operator;
+        this.suggestions = suggestions;
         this.name = 'ValidationError';
     }
+    /**
+     * Get suggestions for fixing the error
+     */
+    getSuggestions() {
+        if (this.suggestions) {
+            return this.suggestions;
+        }
+        const suggestions = [];
+        if (this.field) {
+            suggestions.push(`Field "${this.field}" is not in the allowed fields list`);
+            suggestions.push('Check your whitelist configuration');
+        }
+        if (this.operator) {
+            suggestions.push(`Operator "${this.operator}" is not in the allowed operators list`);
+            suggestions.push('Check your whitelist configuration');
+        }
+        if (this.message.includes('complexity')) {
+            suggestions.push('Reduce query depth or number of conditions');
+            suggestions.push('Check your complexity limit settings');
+        }
+        if (this.message.includes('length')) {
+            suggestions.push('Reduce query string length or array/string value sizes');
+        }
+        return suggestions;
+    }
 }
 exports.ValidationError = ValidationError;
 //# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -1 +1 @@
-{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":";;;AAAA;;GAEG;AACH,MAAa,SAAU,SAAQ,KAAK;IAClC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,IAAI,CAAC,WAAW,CAAC,IAAI,CAAC;QAClC,KAAK,CAAC,iBAAiB,CAAC,IAAI,EAAE,IAAI,CAAC,WAAW,CAAC,CAAC;IAClD,CAAC;CACF;AAND,8BAMC;AAED;;GAEG;AACH,MAAa,iBAAkB,SAAQ,SAAS;IAI9C,YAAY,OAAe,EAAE,QAAgB,EAAE,KAAa;QAC1D,KAAK,CAAC,GAAG,OAAO,gBAAgB,QAAQ,EAAE,CAAC,CAAC;QAC5C,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;IAClC,CAAC;IAED;;OAEG;IACH,UAAU;QACR,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QAC9C,MAAM,GAAG,GAAG,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,MAAM,EAAE,IAAI,CAAC,QAAQ,GAAG,EAAE,CAAC,CAAC;QAC5D,MAAM,MAAM,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,KAAK,EAAE,IAAI,CAAC,QAAQ,CAAC,CAAC;QAC1D,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,SAAS,CAAC,IAAI,CAAC,QAAQ,EAAE,GAAG,CAAC,CAAC;QACvD,OAAO,GAAG,MAAM,UAAU,KAAK,EAAE,CAAC;IACpC,CAAC;CACF;AArBD,8CAqBC;AAED;;GAEG;AACH,MAAa,UAAW,SAAQ,SAAS;IAIvC,YAAY,OAAe,EAAE,QAAiB,EAAE,KAAc;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,QAAQ,GAAG,QAAQ,IAAI,CAAC,CAAC,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,IAAI,EAAE,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,YAAY,CAAC;IAC3B,CAAC;CACF;AAVD,gCAUC;AAED;;GAEG;AACH,MAAa,eAAgB,SAAQ,SAAS;IAI5C,YAAY,OAAe,EAAE,KAAc,EAAE,QAAiB;QAC5D,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;QACnB,IAAI,CAAC,QAAQ,GAAG,QAAQ,CAAC;QACzB,IAAI,CAAC,IAAI,GAAG,iBAAiB,CAAC;IAChC,CAAC;CACF;AAVD,0CAUC"}
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -4,21 +4,48 @@
  * A library that parses human-readable query strings into ASTs
  * and transforms them into ORM-compatible filter objects.
  */
-export { parseQueryString } from './parser/parser';
+export { parseQueryString, parseQueryStringFilter } from './parser/parser';
 export { Tokenizer, Token, TokenType } from './parser/tokenizer';
 export { validateQuery, validateQueryComplexity, extractFields, extractOperators, } from './parser/validator';
 export { toPrismaFilter, PrismaFilter } from './adapters/prisma';
-export { toTypeORMFilter, TypeORMFilter } from './adapters/typeorm';
-export { toSequelizeFilter, SequelizeFilter } from './adapters/sequelize';
-export { QastNode, ComparisonNode, LogicalNode, LogicalOperator, Operator, QastValue, ParseOptions, WhitelistOptions, ComplexityOptions, isComparisonNode, isLogicalNode, } from './types/ast';
+export { toTypeORMFilter, TypeORMFilter, transformTypeORMOperators } from './adapters/typeorm';
+export { toSequelizeFilter, SequelizeFilter, transformSequelizeOperators } from './adapters/sequelize';
+export { toMongooseFilter, MongooseFilter } from './adapters/mongoose';
+export { toKnexFilter, KnexFilter, KnexQueryCallback } from './adapters/knex';
+export { toDrizzleFilter, DrizzleFilter, transformDrizzleConditions } from './adapters/drizzle';
+export { QastNode, ComparisonNode, LogicalNode, NotNode, BetweenNode, NullCheckNode, LogicalOperator, Operator, QastValue, ParseOptions, WhitelistOptions, ComplexityOptions, QueryAST, OrderByClause, SortDirection, isComparisonNode, isLogicalNode, isNotNode, isBetweenNode, isNullCheckNode, } from './types/ast';
 export { QastError, ParseError, ValidationError, TokenizationError, } from './errors';
-import { ParseOptions, QastNode } from './types/ast';
+export { QueryBuilder, FieldBuilder, queryBuilder } from './builder/query-builder';
+export { serializeQuery } from './utils/serializer';
+export { cloneAST, mergeQueries, optimizeAST, getQueryStats, diffQueries, QueryStats, QueryDiff } from './utils/ast-utils';
+export { QueryCache, memoizeQuery, createCachedParser } from './utils/cache';
+export { sanitizeFieldName, estimateQueryCost, RateLimiter, QueryCost } from './parser/validator';
+export { qastExpressMiddleware, QastRequest } from './integrations/express';
+export { QastPipe, QastFullPipe, QastQuery } from './integrations/nestjs';
+export { qastPlugin as qastFastifyPlugin, QastFastifyRequest } from './integrations/fastify';
+export { qastMiddleware as qastHonoMiddleware, QastContext } from './integrations/hono';
+import { ParseOptions, QastNode, QueryAST } from './types/ast';
 /**
- * Parse a query string into an AST
+ * Field schema type for type-safe field access
+ */
+export interface FieldSchema {
+    [field: string]: 'string' | 'number' | 'boolean' | 'date' | 'array' | 'null';
+}
+/**
+ * Type-safe parse options
+ */
+export interface TypedParseOptions<T extends FieldSchema = FieldSchema> extends ParseOptions {
+    /**
+     * Field schema for type checking (optional, for type inference only)
+     */
+    schema?: T;
+}
+/**
+ * Parse a query string into an AST (backward compatible - returns only filter)
  *
  * @param query - The query string to parse (e.g., 'age gt 25 and name eq "John"')
  * @param options - Optional parsing options (whitelisting, validation, complexity limits)
- * @returns The parsed AST node
+ * @returns The parsed AST node (filter only)
  *
  * @example
  * ```ts
@@ -38,6 +65,54 @@ import { ParseOptions, QastNode } from './types/ast';
  *   maxStringLength: 200,
  * });
  * ```
+ *
+ * @example
+ * ```ts
+ * // Type-safe parsing with schema
+ * interface UserSchema extends FieldSchema {
+ *   age: 'number';
+ *   name: 'string';
+ *   active: 'boolean';
+ * }
+ *
+ * const ast = parseQuery<UserSchema>('age gt 25', {
+ *   allowedFields: ['age', 'name', 'active'],
+ *   schema: { age: 'number', name: 'string', active: 'boolean' }
+ * });
+ * ```
+ */
+export declare function parseQuery<T extends FieldSchema = FieldSchema>(query: string, options?: TypedParseOptions<T>): QastNode;
+/**
+ * Parse a query string into a full QueryAST (includes filter, sorting, pagination)
+ *
+ * @param query - The query string to parse (e.g., 'age gt 25 orderBy age desc limit 10')
+ * @param options - Optional parsing options (whitelisting, validation, complexity limits)
+ * @returns The parsed QueryAST with filter, orderBy, limit, and offset
+ *
+ * @example
+ * ```ts
+ * const queryAST = parseQueryFull('age gt 25 orderBy age desc limit 10 offset 20');
+ * // queryAST.filter - the filter AST
+ * // queryAST.orderBy - array of sort specifications
+ * // queryAST.limit - limit value
+ * // queryAST.offset - offset value
+ * ```
+ */
+/**
+ * Parse a query string into a full QueryAST (includes filter, sorting, pagination)
+ *
+ * @param query - The query string to parse (e.g., 'age gt 25 orderBy age desc limit 10')
+ * @param options - Optional parsing options (whitelisting, validation, complexity limits)
+ * @returns The parsed QueryAST with filter, orderBy, limit, and offset
+ *
+ * @example
+ * ```ts
+ * const queryAST = parseQueryFull('age gt 25 orderBy age desc limit 10 offset 20');
+ * // queryAST.filter - the filter AST
+ * // queryAST.orderBy - array of sort specifications
+ * // queryAST.limit - limit value
+ * // queryAST.offset - offset value
+ * ```
  */
-export declare function parseQuery(query: string, options?: ParseOptions): QastNode;
+export declare function parseQueryFull<T extends FieldSchema = FieldSchema>(query: string, options?: TypedParseOptions<T>): QueryAST;
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AACnD,OAAO,EAAE,SAAS,EAAE,KAAK,EAAE,SAAS,EAAE,MAAM,oBAAoB,CAAC;AAGjE,OAAO,EACL,aAAa,EACb,uBAAuB,EACvB,aAAa,EACb,gBAAgB,GACjB,MAAM,oBAAoB,CAAC;AAG5B,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAC;AACjE,OAAO,EAAE,eAAe,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AACpE,OAAO,EAAE,iBAAiB,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAC;AAG1E,OAAO,EACL,QAAQ,EACR,cAAc,EACd,WAAW,EACX,eAAe,EACf,QAAQ,EACR,SAAS,EACT,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,gBAAgB,EAChB,aAAa,GACd,MAAM,aAAa,CAAC;AAGrB,OAAO,EACL,SAAS,EACT,UAAU,EACV,eAAe,EACf,iBAAiB,GAClB,MAAM,UAAU,CAAC;AAKlB,OAAO,EAAE,YAAY,EAAE,QAAQ,EAAoB,MAAM,aAAa,CAAC;AAGvE;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,wBAAgB,UAAU,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,QAAQ,CA0C1E"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -6,11 +6,13 @@
  * and transforms them into ORM-compatible filter objects.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.TokenizationError = exports.ValidationError = exports.ParseError = exports.QastError = exports.isLogicalNode = exports.isComparisonNode = exports.toSequelizeFilter = exports.toTypeORMFilter = exports.toPrismaFilter = exports.extractOperators = exports.extractFields = exports.validateQueryComplexity = exports.validateQuery = exports.TokenType = exports.Tokenizer = exports.parseQueryString = void 0;
+exports.qastHonoMiddleware = exports.qastFastifyPlugin = exports.QastQuery = exports.QastFullPipe = exports.QastPipe = exports.qastExpressMiddleware = exports.RateLimiter = exports.estimateQueryCost = exports.sanitizeFieldName = exports.createCachedParser = exports.memoizeQuery = exports.QueryCache = exports.diffQueries = exports.getQueryStats = exports.optimizeAST = exports.mergeQueries = exports.cloneAST = exports.serializeQuery = exports.queryBuilder = exports.FieldBuilder = exports.QueryBuilder = exports.TokenizationError = exports.ValidationError = exports.ParseError = exports.QastError = exports.isNullCheckNode = exports.isBetweenNode = exports.isNotNode = exports.isLogicalNode = exports.isComparisonNode = exports.transformDrizzleConditions = exports.toDrizzleFilter = exports.toKnexFilter = exports.toMongooseFilter = exports.transformSequelizeOperators = exports.toSequelizeFilter = exports.transformTypeORMOperators = exports.toTypeORMFilter = exports.toPrismaFilter = exports.extractOperators = exports.extractFields = exports.validateQueryComplexity = exports.validateQuery = exports.TokenType = exports.Tokenizer = exports.parseQueryStringFilter = exports.parseQueryString = void 0;
 exports.parseQuery = parseQuery;
+exports.parseQueryFull = parseQueryFull;
 // Export parser
 var parser_1 = require("./parser/parser");
 Object.defineProperty(exports, "parseQueryString", { enumerable: true, get: function () { return parser_1.parseQueryString; } });
+Object.defineProperty(exports, "parseQueryStringFilter", { enumerable: true, get: function () { return parser_1.parseQueryStringFilter; } });
 var tokenizer_1 = require("./parser/tokenizer");
 Object.defineProperty(exports, "Tokenizer", { enumerable: true, get: function () { return tokenizer_1.Tokenizer; } });
 Object.defineProperty(exports, "TokenType", { enumerable: true, get: function () { return tokenizer_1.TokenType; } });
@@ -25,28 +27,75 @@ var prisma_1 = require("./adapters/prisma");
 Object.defineProperty(exports, "toPrismaFilter", { enumerable: true, get: function () { return prisma_1.toPrismaFilter; } });
 var typeorm_1 = require("./adapters/typeorm");
 Object.defineProperty(exports, "toTypeORMFilter", { enumerable: true, get: function () { return typeorm_1.toTypeORMFilter; } });
+Object.defineProperty(exports, "transformTypeORMOperators", { enumerable: true, get: function () { return typeorm_1.transformTypeORMOperators; } });
 var sequelize_1 = require("./adapters/sequelize");
 Object.defineProperty(exports, "toSequelizeFilter", { enumerable: true, get: function () { return sequelize_1.toSequelizeFilter; } });
+Object.defineProperty(exports, "transformSequelizeOperators", { enumerable: true, get: function () { return sequelize_1.transformSequelizeOperators; } });
+var mongoose_1 = require("./adapters/mongoose");
+Object.defineProperty(exports, "toMongooseFilter", { enumerable: true, get: function () { return mongoose_1.toMongooseFilter; } });
+var knex_1 = require("./adapters/knex");
+Object.defineProperty(exports, "toKnexFilter", { enumerable: true, get: function () { return knex_1.toKnexFilter; } });
+var drizzle_1 = require("./adapters/drizzle");
+Object.defineProperty(exports, "toDrizzleFilter", { enumerable: true, get: function () { return drizzle_1.toDrizzleFilter; } });
+Object.defineProperty(exports, "transformDrizzleConditions", { enumerable: true, get: function () { return drizzle_1.transformDrizzleConditions; } });
 // Export types
 var ast_1 = require("./types/ast");
 Object.defineProperty(exports, "isComparisonNode", { enumerable: true, get: function () { return ast_1.isComparisonNode; } });
 Object.defineProperty(exports, "isLogicalNode", { enumerable: true, get: function () { return ast_1.isLogicalNode; } });
+Object.defineProperty(exports, "isNotNode", { enumerable: true, get: function () { return ast_1.isNotNode; } });
+Object.defineProperty(exports, "isBetweenNode", { enumerable: true, get: function () { return ast_1.isBetweenNode; } });
+Object.defineProperty(exports, "isNullCheckNode", { enumerable: true, get: function () { return ast_1.isNullCheckNode; } });
+// FieldSchema and TypedParseOptions are exported above in the function signatures
 // Export errors
 var errors_1 = require("./errors");
 Object.defineProperty(exports, "QastError", { enumerable: true, get: function () { return errors_1.QastError; } });
 Object.defineProperty(exports, "ParseError", { enumerable: true, get: function () { return errors_1.ParseError; } });
 Object.defineProperty(exports, "ValidationError", { enumerable: true, get: function () { return errors_1.ValidationError; } });
 Object.defineProperty(exports, "TokenizationError", { enumerable: true, get: function () { return errors_1.TokenizationError; } });
+// Export query builder
+var query_builder_1 = require("./builder/query-builder");
+Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return query_builder_1.QueryBuilder; } });
+Object.defineProperty(exports, "FieldBuilder", { enumerable: true, get: function () { return query_builder_1.FieldBuilder; } });
+Object.defineProperty(exports, "queryBuilder", { enumerable: true, get: function () { return query_builder_1.queryBuilder; } });
+// Export utilities
+var serializer_1 = require("./utils/serializer");
+Object.defineProperty(exports, "serializeQuery", { enumerable: true, get: function () { return serializer_1.serializeQuery; } });
+var ast_utils_1 = require("./utils/ast-utils");
+Object.defineProperty(exports, "cloneAST", { enumerable: true, get: function () { return ast_utils_1.cloneAST; } });
+Object.defineProperty(exports, "mergeQueries", { enumerable: true, get: function () { return ast_utils_1.mergeQueries; } });
+Object.defineProperty(exports, "optimizeAST", { enumerable: true, get: function () { return ast_utils_1.optimizeAST; } });
+Object.defineProperty(exports, "getQueryStats", { enumerable: true, get: function () { return ast_utils_1.getQueryStats; } });
+Object.defineProperty(exports, "diffQueries", { enumerable: true, get: function () { return ast_utils_1.diffQueries; } });
+var cache_1 = require("./utils/cache");
+Object.defineProperty(exports, "QueryCache", { enumerable: true, get: function () { return cache_1.QueryCache; } });
+Object.defineProperty(exports, "memoizeQuery", { enumerable: true, get: function () { return cache_1.memoizeQuery; } });
+Object.defineProperty(exports, "createCachedParser", { enumerable: true, get: function () { return cache_1.createCachedParser; } });
+// Export security utilities
+var validator_2 = require("./parser/validator");
+Object.defineProperty(exports, "sanitizeFieldName", { enumerable: true, get: function () { return validator_2.sanitizeFieldName; } });
+Object.defineProperty(exports, "estimateQueryCost", { enumerable: true, get: function () { return validator_2.estimateQueryCost; } });
+Object.defineProperty(exports, "RateLimiter", { enumerable: true, get: function () { return validator_2.RateLimiter; } });
+// Export framework integrations
+var express_1 = require("./integrations/express");
+Object.defineProperty(exports, "qastExpressMiddleware", { enumerable: true, get: function () { return express_1.qastExpressMiddleware; } });
+var nestjs_1 = require("./integrations/nestjs");
+Object.defineProperty(exports, "QastPipe", { enumerable: true, get: function () { return nestjs_1.QastPipe; } });
+Object.defineProperty(exports, "QastFullPipe", { enumerable: true, get: function () { return nestjs_1.QastFullPipe; } });
+Object.defineProperty(exports, "QastQuery", { enumerable: true, get: function () { return nestjs_1.QastQuery; } });
+var fastify_1 = require("./integrations/fastify");
+Object.defineProperty(exports, "qastFastifyPlugin", { enumerable: true, get: function () { return fastify_1.qastPlugin; } });
+var hono_1 = require("./integrations/hono");
+Object.defineProperty(exports, "qastHonoMiddleware", { enumerable: true, get: function () { return hono_1.qastMiddleware; } });
 // Main parse function with options
 const parser_2 = require("./parser/parser");
-const validator_2 = require("./parser/validator");
+const validator_3 = require("./parser/validator");
 const errors_2 = require("./errors");
 /**
- * Parse a query string into an AST
+ * Parse a query string into an AST (backward compatible - returns only filter)
  *
  * @param query - The query string to parse (e.g., 'age gt 25 and name eq "John"')
  * @param options - Optional parsing options (whitelisting, validation, complexity limits)
- * @returns The parsed AST node
+ * @returns The parsed AST node (filter only)
  *
  * @example
  * ```ts
@@ -66,13 +115,64 @@ const errors_2 = require("./errors");
  *   maxStringLength: 200,
  * });
  * ```
+ *
+ * @example
+ * ```ts
+ * // Type-safe parsing with schema
+ * interface UserSchema extends FieldSchema {
+ *   age: 'number';
+ *   name: 'string';
+ *   active: 'boolean';
+ * }
+ *
+ * const ast = parseQuery<UserSchema>('age gt 25', {
+ *   allowedFields: ['age', 'name', 'active'],
+ *   schema: { age: 'number', name: 'string', active: 'boolean' }
+ * });
+ * ```
  */
 function parseQuery(query, options) {
+    const queryAST = parseQueryFull(query, options);
+    return queryAST.filter;
+}
+/**
+ * Parse a query string into a full QueryAST (includes filter, sorting, pagination)
+ *
+ * @param query - The query string to parse (e.g., 'age gt 25 orderBy age desc limit 10')
+ * @param options - Optional parsing options (whitelisting, validation, complexity limits)
+ * @returns The parsed QueryAST with filter, orderBy, limit, and offset
+ *
+ * @example
+ * ```ts
+ * const queryAST = parseQueryFull('age gt 25 orderBy age desc limit 10 offset 20');
+ * // queryAST.filter - the filter AST
+ * // queryAST.orderBy - array of sort specifications
+ * // queryAST.limit - limit value
+ * // queryAST.offset - offset value
+ * ```
+ */
+/**
+ * Parse a query string into a full QueryAST (includes filter, sorting, pagination)
+ *
+ * @param query - The query string to parse (e.g., 'age gt 25 orderBy age desc limit 10')
+ * @param options - Optional parsing options (whitelisting, validation, complexity limits)
+ * @returns The parsed QueryAST with filter, orderBy, limit, and offset
+ *
+ * @example
+ * ```ts
+ * const queryAST = parseQueryFull('age gt 25 orderBy age desc limit 10 offset 20');
+ * // queryAST.filter - the filter AST
+ * // queryAST.orderBy - array of sort specifications
+ * // queryAST.limit - limit value
+ * // queryAST.offset - offset value
+ * ```
+ */
+function parseQueryFull(query, options) {
     // Check query string length before parsing (early rejection)
     if (options?.maxQueryLength !== undefined && query.length > options.maxQueryLength) {
         throw new errors_2.ValidationError(`Query string is too long (${query.length} characters) - maximum allowed is ${options.maxQueryLength}`);
     }
-    const ast = (0, parser_2.parseQueryString)(query);
+    const queryAST = (0, parser_2.parseQueryString)(query);
     if (options) {
         // Validate against whitelists if enabled
         if (options.validate !== false) {
@@ -82,7 +182,7 @@ function parseQuery(query, options) {
             };
             // Only validate if whitelists are provided
             if (whitelist.allowedFields || whitelist.allowedOperators) {
-                (0, validator_2.validateQuery)(ast, whitelist);
+                (0, validator_3.validateQuery)(queryAST.filter, whitelist);
             }
         }
         // Enforce complexity limits if configured
@@ -91,7 +191,7 @@ function parseQuery(query, options) {
             options.maxArrayLength !== undefined ||
             options.maxStringLength !== undefined;
         if (hasComplexityLimits) {
-            (0, validator_2.validateQueryComplexity)(ast, {
+            (0, validator_3.validateQueryComplexity)(queryAST.filter, {
                 maxDepth: options.maxDepth,
                 maxNodes: options.maxNodes,
                 maxArrayLength: options.maxArrayLength,
@@ -99,6 +199,6 @@ function parseQuery(query, options) {
             });
         }
     }
-    return ast;
+    return queryAST;
 }
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA;;;;;GAKG;;;AA0EH,gCA0CC;AAlHD,gBAAgB;AAChB,0CAAmD;AAA1C,0GAAA,gBAAgB,OAAA;AACzB,gDAAiE;AAAxD,sGAAA,SAAS,OAAA;AAAS,sGAAA,SAAS,OAAA;AAEpC,oBAAoB;AACpB,gDAK4B;AAJ1B,0GAAA,aAAa,OAAA;AACb,oHAAA,uBAAuB,OAAA;AACvB,0GAAA,aAAa,OAAA;AACb,6GAAA,gBAAgB,OAAA;AAGlB,kBAAkB;AAClB,4CAAiE;AAAxD,wGAAA,cAAc,OAAA;AACvB,8CAAoE;AAA3D,0GAAA,eAAe,OAAA;AACxB,kDAA0E;AAAjE,8GAAA,iBAAiB,OAAA;AAE1B,eAAe;AACf,mCAYqB;AAFnB,uGAAA,gBAAgB,OAAA;AAChB,oGAAA,aAAa,OAAA;AAGf,gBAAgB;AAChB,mCAKkB;AAJhB,mGAAA,SAAS,OAAA;AACT,oGAAA,UAAU,OAAA;AACV,yGAAA,eAAe,OAAA;AACf,2GAAA,iBAAiB,OAAA;AAGnB,mCAAmC;AACnC,4CAAmD;AACnD,kDAA4E;AAE5E,qCAA2C;AAE3C;;;;;;;;;;;;;;;;;;;;;;;;;GAyBG;AACH,SAAgB,UAAU,CAAC,KAAa,EAAE,OAAsB;IAC9D,6DAA6D;IAC7D,IAAI,OAAO,EAAE,cAAc,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,OAAO,CAAC,cAAc,EAAE,CAAC;QACnF,MAAM,IAAI,wBAAe,CACvB,6BAA6B,KAAK,CAAC,MAAM,qCAAqC,OAAO,CAAC,cAAc,EAAE,CACvG,CAAC;IACJ,CAAC;IAED,MAAM,GAAG,GAAG,IAAA,yBAAgB,EAAC,KAAK,CAAC,CAAC;IAEpC,IAAI,OAAO,EAAE,CAAC;QACZ,yCAAyC;QACzC,IAAI,OAAO,CAAC,QAAQ,KAAK,KAAK,EAAE,CAAC;YAC/B,MAAM,SAAS,GAAqB;gBAClC,aAAa,EAAE,OAAO,CAAC,aAAa;gBACpC,gBAAgB,EAAE,OAAO,CAAC,gBAAgB;aAC3C,CAAC;YAEF,2CAA2C;YAC3C,IAAI,SAAS,CAAC,aAAa,IAAI,SAAS,CAAC,gBAAgB,EAAE,CAAC;gBAC1D,IAAA,yBAAa,EAAC,GAAG,EAAE,SAAS,CAAC,CAAC;YAChC,CAAC;QACH,CAAC;QAED,0CAA0C;QAC1C,MAAM,mBAAmB,GACvB,OAAO,CAAC,QAAQ,KAAK,SAAS;YAC9B,OAAO,CAAC,QAAQ,KAAK,SAAS;YAC9B,OAAO,CAAC,cAAc,KAAK,SAAS;YACpC,OAAO,CAAC,eAAe,KAAK,SAAS,CAAC;QAExC,IAAI,mBAAmB,EAAE,CAAC;YACxB,IAAA,mCAAuB,EAAC,GAAG,EAAE;gBAC3B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,QAAQ,EAAE,OAAO,CAAC,QAAQ;gBAC1B,cAAc,EAAE,OAAO,CAAC,cAAc;gBACtC,eAAe,EAAE,OAAO,CAAC,eAAe;aACzC,CAAC,CAAC;QACL,CAAC;IACH,CAAC;IAED,OAAO,GAAG,CAAC;AACb,CAAC"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/integrations/express.d.ts

@@ -0,0 +1,14 @@
+import { Request, Response, NextFunction } from 'express';
+import { ParseOptions, QueryAST, QastNode } from '../index';
+/**
+ * Express request with parsed QAST filter
+ */
+export interface QastRequest extends Request {
+    qastFilter?: QastNode;
+    qastQuery?: QueryAST;
+}
+/**
+ * Express middleware for parsing QAST queries
+ */
+export declare function qastExpressMiddleware(options?: ParseOptions): (req: Request, res: Response, next: NextFunction) => void;
+//# sourceMappingURL=express.d.ts.map

package/dist/integrations/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../src/integrations/express.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC1D,OAAO,EAAkB,YAAY,EAAE,QAAQ,EAAE,QAAQ,EAAE,MAAM,UAAU,CAAC;AAG5E;;GAEG;AACH,MAAM,WAAW,WAAY,SAAQ,OAAO;IAC1C,UAAU,CAAC,EAAE,QAAQ,CAAC;IACtB,SAAS,CAAC,EAAE,QAAQ,CAAC;CACtB;AAED;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,CAAC,EAAE,YAAY,IAClD,KAAK,OAAO,EAAE,KAAK,QAAQ,EAAE,MAAM,YAAY,KAAG,IAAI,CAsB/D"}

package/dist/integrations/express.js

@@ -0,0 +1,33 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.qastExpressMiddleware = qastExpressMiddleware;
+const index_1 = require("../index");
+const errors_1 = require("../errors");
+/**
+ * Express middleware for parsing QAST queries
+ */
+function qastExpressMiddleware(options) {
+    return (req, res, next) => {
+        try {
+            const queryString = req.query.filter;
+            if (queryString) {
+                const qastQuery = (0, index_1.parseQueryFull)(queryString, options);
+                req.qastQuery = qastQuery;
+                req.qastFilter = qastQuery.filter; // For backward compatibility
+            }
+            next();
+        }
+        catch (error) {
+            if (error instanceof errors_1.ValidationError) {
+                res.status(400).json({
+                    error: error.message,
+                    details: error.getSnippet ? error.getSnippet() : undefined,
+                });
+            }
+            else {
+                next(error);
+            }
+        }
+    };
+}
+//# sourceMappingURL=express.js.map