import { parse } from "@muhgholy/search-query-parser"; const terms = parse('"Promo Code" -spam from:newsletter after:-7d'); // Returns: TParsedTerm[] // [ // { type: 'phrase', value: 'Promo Code', negated: false }, // { type: 'text', value: 'spam', negated: true }, // { type: 'from', value: 'newsletter', negated: false }, // { type: 'after', value: '-7d', negated: false, date: Date } // ] // Simple iteration for (const term of terms) { switch (term.type) { case "text": case "phrase": // Handle text search break; case "from": // Handle from filter break; case "after": if (term.date) { // Use resolved date } break; case "or": // Handle OR logic // term.terms contains the operands break; case "group": // Handle group // term.terms contains the inner terms break; } }

const terms = parse('"hello world" from:john -spam', { operatorsAllowed: ["from", "to"], // Only allow specific operators // OR operatorsDisallowed: ["size"], // Block specific operators // Custom operators operators: [{ name: "priority", aliases: ["p"], type: "string", allowNegation: true }], });

const tokens = tokenize('from:john "hello world"');

parseDate("-7d"); // { date: Date (7 days ago) } parseDate("2024-01-01"); // { date: Date } parseDate("last week"); // { date: Date }

escapeRegex("hello.*world"); // 'hello\\.\\*world'

validate('"unclosed quote'); // { valid: false, errors: ['Unmatched quote: "'] }

hasTerms(""); // false hasTerms("hello"); // true

summarize('"Promo" from:newsletter after:-7d'); // ['Exact: "Promo"', 'From: newsletter', 'After: 12/6/2024']

type TDefaultTermType = | "text" // Plain text | "phrase" // Exact phrase | "from" // From filter | "to" // To filter | "subject" // Subject filter | "body" // Body filter | "header-k" // Header key | "header-v" // Header value | "has" // Has property | "is" // Status filter | "in" // Folder filter | "before" // Before date | "after" // After date | "label" // Label filter | "size" // Size filter | "or" // Logical OR | "group"; // Parenthesized group type TTermType = TDefaultTermType; type TParsedTerm<T extends string = TTermType> = { type: T; value: string; negated: boolean; date?: Date; // Resolved date (for date types) dateRange?: { // Resolved date range start: Date; end: Date; }; size?: { // Parsed size (for size type) op: "gt" | "lt" | "eq"; bytes: number; }; terms?: TParsedTerm<T>[]; // For 'or' and 'group' types }; type TParseResult<T extends string = TTermType> = TParsedTerm<T>[]; type TOperatorDef<T extends string = TTermType> = { name: string; // Operator name (becomes term type) aliases: string[]; // Alternative names type: "string" | "date" | "size"; // Value parsing type allowNegation: boolean; // Whether negation is allowed }; type TParserOptions<T extends string = TTermType> = { operators?: TOperatorDef<T>[]; caseSensitive?: boolean; operatorsAllowed?: string[]; operatorsDisallowed?: string[]; };

import { parse, escapeRegex } from "@muhgholy/search-query-parser"; function buildMongoQuery(searchQuery: string) { const terms = parse(searchQuery); const conditions = []; for (const term of terms) { const regex = { $regex: escapeRegex(term.value), $options: "i" }; switch (term.type) { case "text": case "phrase": conditions.push({ $or: [{ title: term.negated ? { $not: regex } : regex }, { content: term.negated ? { $not: regex } : regex }], }); break; case "from": conditions.push({ "from.email": regex }); break; case "after": if (term.date) { conditions.push({ createdAt: { $gte: term.date } }); } break; } } return conditions.length ? { $and: conditions } : {}; }

import { parse, escapeRegex } from "@muhgholy/search-query-parser"; function buildSQLWhere(searchQuery: string) { const terms = parse(searchQuery); const clauses = []; const params = []; for (const term of terms) { switch (term.type) { case "text": clauses.push(term.negated ? "(title NOT LIKE ? AND content NOT LIKE ?)" : "(title LIKE ? OR content LIKE ?)"); params.push(`%${term.value}%`, `%${term.value}%`); break; case "after": if (term.date) { clauses.push("created_at >= ?"); params.push(term.date.toISOString()); } break; } } return { where: clauses.join(" AND "), params }; }