search-input-query-parser 0.1.4 → 0.2.1

package/src/validate-string.ts

@@ -1,5 +1,9 @@
 import { StringLiteral, WildcardPattern } from "./first-pass-parser";
-import { ValidationError, reservedWords } from "./validator";
+import {
+  ValidationError,
+  reservedWords,
+  SearchQueryErrorCode,
+} from "./validator";
 import { validateWildcard } from "./validate-wildcard";
 
 // Validate individual strings (field:value pairs or plain terms)
@@ -20,6 +24,7 @@ export const validateString = (
   if (expr.value.endsWith(":")) {
     errors.push({
       message: "Expected field value",
+      code: SearchQueryErrorCode.EXPECTED_FIELD_VALUE,
       position: expr.position,
       length: expr.length,
     });
@@ -30,6 +35,7 @@ export const validateString = (
   if (expr.value.startsWith(":")) {
     errors.push({
       message: "Missing field name",
+      code: SearchQueryErrorCode.MISSING_FIELD_NAME,
       position: expr.position,
       length: expr.length,
     });
@@ -44,6 +50,8 @@ export const validateString = (
     if (reservedWords.has(fieldName.toUpperCase())) {
       errors.push({
         message: `${fieldName} is a reserved word`,
+        code: SearchQueryErrorCode.RESERVED_WORD_AS_FIELD,
+        value: fieldName,
         position: expr.position,
         length: fieldName.length,
       });
@@ -54,6 +62,7 @@ export const validateString = (
     if (!/^[a-zA-Z0-9_-]+$/.test(fieldName)) {
       errors.push({
         message: "Invalid characters in field name",
+        code: SearchQueryErrorCode.INVALID_FIELD_CHARS,
         position: expr.position,
         length: fieldName.length,
       });
@@ -66,6 +75,8 @@ export const validateString = (
     reservedWords.has(expr.value.toUpperCase())) {
     errors.push({
       message: `${expr.value} is a reserved word`,
+      code: SearchQueryErrorCode.RESERVED_WORD_AS_FIELD,
+      value: expr.value,
       position: expr.position,
       length: expr.length,
     });

package/src/validate-wildcard.ts

@@ -1,5 +1,5 @@
 import { StringLiteral, WildcardPattern } from "./first-pass-parser";
-import { ValidationError } from "./validator";
+import { ValidationError, SearchQueryErrorCode } from "./validator";
 
 // Validates wildcard patterns
 
@@ -18,6 +18,7 @@ export const validateWildcard = (
       const secondStar = value.indexOf("*", firstStar + 1);
       errors.push({
         message: "Only one trailing wildcard (*) is allowed",
+        code: SearchQueryErrorCode.MULTIPLE_WILDCARDS,
         position: expr.position + secondStar,
         length: 1,
       });
@@ -25,6 +26,7 @@ export const validateWildcard = (
     if ((firstStar !== -1 && firstStar !== value.length - 1) && !value.endsWith("**")) {
       errors.push({
         message: "Wildcard (*) can only appear at the end of a term",
+        code: SearchQueryErrorCode.INVALID_WILDCARD_POSITION,
         position: expr.position + firstStar,
         length: 1,
       });
@@ -37,6 +39,7 @@ export const validateWildcard = (
     if (value.endsWith("**")) {
       errors.push({
         message: "Only one trailing wildcard (*) is allowed",
+        code: SearchQueryErrorCode.MULTIPLE_WILDCARDS,
         position: expr.position + value.length - 1,
         length: 1,
       });

package/src/validator.test.ts

@@ -1,5 +1,9 @@
 import { describe, expect, test } from "@jest/globals";
-import { validateSearchQuery, ValidationError } from "./validator";
+import {
+  validateSearchQuery,
+  ValidationError,
+  SearchQueryErrorCode
+} from "./validator";
 import { tokenize, createStream } from "./lexer";
 import { parseExpression } from "./first-pass-parser";
 
@@ -23,6 +27,7 @@ describe("Search Query Validator", () => {
       expect(validateQuery("special@field:value")).toEqual([
         {
           message: "Invalid characters in field name",
+          code: SearchQueryErrorCode.INVALID_FIELD_CHARS,
           position: 0,
           length: 13,
         },
@@ -33,6 +38,7 @@ describe("Search Query Validator", () => {
       expect(validateQuery("valid:value special!:value")).toEqual([
         {
           message: "Invalid characters in field name",
+          code: SearchQueryErrorCode.INVALID_FIELD_CHARS,
           position: 12,
           length: 8,
         },
@@ -45,6 +51,7 @@ describe("Search Query Validator", () => {
       expect(validateQuery("field:")).toEqual([
         {
           message: "Expected field value",
+          code: SearchQueryErrorCode.EXPECTED_FIELD_VALUE,
           position: 0,
           length: 6,
         },
@@ -60,6 +67,7 @@ describe("Search Query Validator", () => {
       expect(validateQuery(":value")).toEqual([
         {
           message: "Missing field name",
+          code: SearchQueryErrorCode.MISSING_FIELD_NAME,
           position: 0,
           length: 6,
         },
@@ -72,6 +80,8 @@ describe("Search Query Validator", () => {
       expect(validateQuery("AND:value")).toEqual([
         {
           message: "AND is a reserved word",
+          code: SearchQueryErrorCode.RESERVED_WORD_AS_FIELD,
+          value: "AND",
           position: 0,
           length: 3,
         },
@@ -80,6 +90,8 @@ describe("Search Query Validator", () => {
       expect(validateQuery("OR:value")).toEqual([
         {
           message: "OR is a reserved word",
+          code: SearchQueryErrorCode.RESERVED_WORD_AS_FIELD,
+          value: "OR",
           position: 0,
           length: 2,
         },
@@ -104,6 +116,7 @@ describe("Search Query Validator", () => {
       expect(validateQuery("(field:value AND invalid!:value)")).toEqual([
         {
           message: "Invalid characters in field name",
+          code: SearchQueryErrorCode.INVALID_FIELD_CHARS,
           position: 17,
           length: 8,
         },
@@ -114,11 +127,14 @@ describe("Search Query Validator", () => {
       expect(validateQuery("AND:test OR invalid!:value")).toEqual([
         {
           message: "AND is a reserved word",
+          code: SearchQueryErrorCode.RESERVED_WORD_AS_FIELD,
+          value: "AND",
           position: 0,
           length: 3,
         },
         {
           message: "Invalid characters in field name",
+          code: SearchQueryErrorCode.INVALID_FIELD_CHARS,
           position: 12,
           length: 8,
         },
@@ -131,6 +147,8 @@ describe("Search Query Validator", () => {
       ).toEqual([
         {
           message: "OR is a reserved word",
+          code: SearchQueryErrorCode.RESERVED_WORD_AS_FIELD,
+          value: "OR",
           position: 18,
           length: 2,
         },
@@ -151,11 +169,13 @@ describe("Search Query Validator", () => {
       expect(validateQuery("field::value")).toEqual([
         {
           message: "Expected field value",
+          code: SearchQueryErrorCode.EXPECTED_FIELD_VALUE,
           position: 0,
           length: 6,
         },
         {
           message: "Missing field name",
+          code: SearchQueryErrorCode.MISSING_FIELD_NAME,
           position: 6,
           length: 6,
         }
@@ -166,6 +186,7 @@ describe("Search Query Validator", () => {
       expect(validateQuery("@#$:value")).toEqual([
         {
           message: "Invalid characters in field name",
+          code: SearchQueryErrorCode.INVALID_FIELD_CHARS,
           position: 0,
           length: 3,
         },
@@ -178,11 +199,14 @@ describe("Search Query Validator", () => {
       expect(validateQuery(complexQuery)).toEqual([
         {
           message: "Invalid characters in field name",
+          code: SearchQueryErrorCode.INVALID_FIELD_CHARS,
           position: 32,
           length: 8,
         },
         {
           message: "OR is a reserved word",
+          code: SearchQueryErrorCode.RESERVED_WORD_AS_FIELD,
+          value: "OR",
           position: 51,
           length: 2,
         },

package/src/validator.ts

@@ -6,9 +6,51 @@ import { FieldSchema } from "./parser";
 import { validateInExpression } from "./validate-in-expression";
 import { validateString } from "./validate-string";
 
+export enum SearchQueryErrorCode {
+  UNKNOWN_ERROR = 0,
+
+  // Syntax Errors (1000-1999)
+  UNTERMINATED_QUOTED_STRING = 1001,
+  EXPECTED_FIELD_VALUE = 1002,
+  MISSING_FIELD_NAME = 1003,
+  MISSING_FIELD_VALUE = 1004,
+  UNEXPECTED_RIGHT_PAREN = 1005,
+  EXPECTED_RIGHT_PAREN = 1006,
+  UNEXPECTED_TOKEN = 1007,
+  EXPECTED_TOKEN = 1008,
+  MISSING_OPERATOR_OR_WHITESPACE = 1009,
+  RESERVED_WORD = 1010,
+
+  // Field Validation Errors (2000-2999)
+  INVALID_FIELD_NAME = 2001,
+  INVALID_FIELD_CHARS = 2002,
+  RESERVED_WORD_AS_FIELD = 2003,
+
+  // Value Validation Errors (3000-3999)
+  INVALID_NUMERIC_VALUE = 3001,
+  INVALID_DATE_FORMAT = 3002,
+  INVALID_RANGE_FORMAT = 3003,
+  INVALID_RANGE_OPERATOR = 3004,
+  EXPECTED_RANGE_VALUE = 3005,
+  RANGE_START_GREATER_THAN_END = 3006,
+  WILDCARD_NOT_ALLOWED = 3007,
+
+  // Wildcard Errors (4000-4999)
+  INVALID_WILDCARD_POSITION = 4001,
+  MULTIPLE_WILDCARDS = 4002,
+
+  // IN Expression Errors (5000-5999)
+  EMPTY_IN_LIST = 5001,
+  INVALID_IN_VALUE = 5002,
+  EXPECTED_IN_SEPARATOR = 5003,
+  EXPECTED_LPAREN_AFTER_IN = 5004,
+}
+
 // Validation error type
 export type ValidationError = {
   message: string;
+  code: SearchQueryErrorCode;
+  value?: string;
   position: number;
   length: number;
 };