@proseql/cli 0.2.4

package/dist/output/csv.js

@@ -0,0 +1,54 @@
+/**
+ * ProseQL CLI - CSV Output Formatter
+ *
+ * Formats records as CSV with proper quoting and comma escaping.
+ */
+/**
+ * Escape a value for CSV output.
+ * Values containing commas, quotes, or newlines are wrapped in quotes.
+ * Quotes within values are doubled.
+ *
+ * @param value - Value to escape
+ * @returns Escaped CSV value
+ */
+function escapeValue(value) {
+    if (value === null || value === undefined) {
+        return "";
+    }
+    const str = typeof value === "object" ? JSON.stringify(value) : String(value);
+    // Check if the value needs quoting
+    if (str.includes(",") ||
+        str.includes('"') ||
+        str.includes("\n") ||
+        str.includes("\r")) {
+        // Double any existing quotes and wrap in quotes
+        return `"${str.replace(/"/g, '""')}"`;
+    }
+    return str;
+}
+/**
+ * Format records as CSV.
+ * Writes header row with all unique field names, then data rows.
+ *
+ * @param records - Array of records to format
+ * @returns CSV string with header and data rows
+ */
+export function formatAsCsv(records) {
+    if (records.length === 0) {
+        return "";
+    }
+    // Collect all unique field names across all records
+    const fieldSet = new Set();
+    for (const record of records) {
+        for (const key of Object.keys(record)) {
+            fieldSet.add(key);
+        }
+    }
+    const fields = Array.from(fieldSet);
+    // Build header row
+    const headerRow = fields.map(escapeValue).join(",");
+    // Build data rows
+    const dataRows = records.map((record) => fields.map((field) => escapeValue(record[field])).join(","));
+    return [headerRow, ...dataRows].join("\n");
+}
+//# sourceMappingURL=csv.js.map

package/dist/output/csv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.js","sourceRoot":"","sources":["../../src/output/csv.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;;;GAOG;AACH,SAAS,WAAW,CAAC,KAAc;IAClC,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC3C,OAAO,EAAE,CAAC;IACX,CAAC;IAED,MAAM,GAAG,GAAG,OAAO,KAAK,KAAK,QAAQ,CAAC,CAAC,CAAC,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;IAE9E,mCAAmC;IACnC,IACC,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QACjB,GAAG,CAAC,QAAQ,CAAC,GAAG,CAAC;QACjB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC;QAClB,GAAG,CAAC,QAAQ,CAAC,IAAI,CAAC,EACjB,CAAC;QACF,gDAAgD;QAChD,OAAO,IAAI,GAAG,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,CAAC;IACvC,CAAC;IAED,OAAO,GAAG,CAAC;AACZ,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,WAAW,CAC1B,OAA+C;IAE/C,IAAI,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC1B,OAAO,EAAE,CAAC;IACX,CAAC;IAED,oDAAoD;IACpD,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAU,CAAC;IACnC,KAAK,MAAM,MAAM,IAAI,OAAO,EAAE,CAAC;QAC9B,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;YACvC,QAAQ,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;QACnB,CAAC;IACF,CAAC;IACD,MAAM,MAAM,GAAG,KAAK,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAC;IAEpC,mBAAmB;IACnB,MAAM,SAAS,GAAG,MAAM,CAAC,GAAG,CAAC,WAAW,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAEpD,kBAAkB;IAClB,MAAM,QAAQ,GAAG,OAAO,CAAC,GAAG,CAAC,CAAC,MAAM,EAAE,EAAE,CACvC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,WAAW,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAC3D,CAAC;IAEF,OAAO,CAAC,SAAS,EAAE,GAAG,QAAQ,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAC5C,CAAC"}

package/dist/output/formatter.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ProseQL CLI - Output Formatter Dispatcher
+ *
+ * Accepts a format flag and record array, delegates to the appropriate formatter.
+ */
+/**
+ * Supported output formats.
+ */
+export type OutputFormat = "table" | "json" | "yaml" | "csv";
+/**
+ * Format the given records based on the specified format.
+ *
+ * @param format - The output format to use
+ * @param records - Array of records to format
+ * @returns Formatted string output
+ */
+export declare function format(format: OutputFormat, records: ReadonlyArray<Record<string, unknown>>): string;
+//# sourceMappingURL=formatter.d.ts.map

package/dist/output/formatter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.d.ts","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAOH;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,CAAC;AAE7D;;;;;;GAMG;AACH,wBAAgB,MAAM,CACrB,MAAM,EAAE,YAAY,EACpB,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7C,MAAM,CAWR"}

package/dist/output/formatter.js

@@ -0,0 +1,29 @@
+/**
+ * ProseQL CLI - Output Formatter Dispatcher
+ *
+ * Accepts a format flag and record array, delegates to the appropriate formatter.
+ */
+import { formatAsCsv } from "./csv.js";
+import { formatAsJson } from "./json.js";
+import { formatAsTable } from "./table.js";
+import { formatAsYaml } from "./yaml.js";
+/**
+ * Format the given records based on the specified format.
+ *
+ * @param format - The output format to use
+ * @param records - Array of records to format
+ * @returns Formatted string output
+ */
+export function format(format, records) {
+    switch (format) {
+        case "json":
+            return formatAsJson(records);
+        case "yaml":
+            return formatAsYaml(records);
+        case "csv":
+            return formatAsCsv(records);
+        case "table":
+            return formatAsTable(records);
+    }
+}
+//# sourceMappingURL=formatter.js.map

package/dist/output/formatter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"formatter.js","sourceRoot":"","sources":["../../src/output/formatter.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AAOzC;;;;;;GAMG;AACH,MAAM,UAAU,MAAM,CACrB,MAAoB,EACpB,OAA+C;IAE/C,QAAQ,MAAM,EAAE,CAAC;QAChB,KAAK,MAAM;YACV,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAC9B,KAAK,MAAM;YACV,OAAO,YAAY,CAAC,OAAO,CAAC,CAAC;QAC9B,KAAK,KAAK;YACT,OAAO,WAAW,CAAC,OAAO,CAAC,CAAC;QAC7B,KAAK,OAAO;YACX,OAAO,aAAa,CAAC,OAAO,CAAC,CAAC;IAChC,CAAC;AACF,CAAC"}

package/dist/output/json.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ProseQL CLI - JSON Output Formatter
+ *
+ * Formats records as JSON with 2-space indentation.
+ */
+/**
+ * Format records as pretty-printed JSON.
+ *
+ * @param records - Array of records to format
+ * @returns JSON string with 2-space indentation
+ */
+export declare function formatAsJson(records: ReadonlyArray<Record<string, unknown>>): string;
+//# sourceMappingURL=json.d.ts.map

package/dist/output/json.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7C,MAAM,CAER"}

package/dist/output/json.js

@@ -0,0 +1,15 @@
+/**
+ * ProseQL CLI - JSON Output Formatter
+ *
+ * Formats records as JSON with 2-space indentation.
+ */
+/**
+ * Format records as pretty-printed JSON.
+ *
+ * @param records - Array of records to format
+ * @returns JSON string with 2-space indentation
+ */
+export function formatAsJson(records) {
+    return JSON.stringify(records, null, 2);
+}
+//# sourceMappingURL=json.js.map

package/dist/output/json.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"json.js","sourceRoot":"","sources":["../../src/output/json.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC3B,OAA+C;IAE/C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC;AACzC,CAAC"}

package/dist/output/table.d.ts

@@ -0,0 +1,18 @@
+/**
+ * ProseQL CLI - Table Output Formatter
+ *
+ * Formats records as an aligned ASCII table.
+ * Calculates column widths from headers and data, truncates values exceeding terminal width.
+ */
+/**
+ * Format records as an aligned ASCII table.
+ *
+ * @param records - Array of records to format
+ * @param options - Optional configuration
+ * @param options.maxColumnWidth - Maximum width for any column (default: 40)
+ * @returns Formatted table string
+ */
+export declare function formatAsTable(records: ReadonlyArray<Record<string, unknown>>, options?: {
+    readonly maxColumnWidth?: number;
+}): string;
+//# sourceMappingURL=table.d.ts.map

package/dist/output/table.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"table.d.ts","sourceRoot":"","sources":["../../src/output/table.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAyDH;;;;;;;GAOG;AACH,wBAAgB,aAAa,CAC5B,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,EAC/C,OAAO,CAAC,EAAE;IAAE,QAAQ,CAAC,cAAc,CAAC,EAAE,MAAM,CAAA;CAAE,GAC5C,MAAM,CA4DR"}

package/dist/output/table.js

@@ -0,0 +1,115 @@
+/**
+ * ProseQL CLI - Table Output Formatter
+ *
+ * Formats records as an aligned ASCII table.
+ * Calculates column widths from headers and data, truncates values exceeding terminal width.
+ */
+/**
+ * Default maximum width for a single column before truncation.
+ */
+const DEFAULT_MAX_COLUMN_WIDTH = 40;
+/**
+ * Get the display width of a value (handling null, undefined, objects).
+ *
+ * @param value - Value to measure
+ * @returns String representation of the value
+ */
+function stringify(value) {
+    if (value === null) {
+        return "null";
+    }
+    if (value === undefined) {
+        return "";
+    }
+    if (typeof value === "object") {
+        return JSON.stringify(value);
+    }
+    return String(value);
+}
+/**
+ * Truncate a string to a maximum length, adding ellipsis if needed.
+ *
+ * @param str - String to truncate
+ * @param maxLen - Maximum length
+ * @returns Truncated string with ellipsis if truncated
+ */
+function truncate(str, maxLen) {
+    if (str.length <= maxLen) {
+        return str;
+    }
+    if (maxLen <= 3) {
+        return str.slice(0, maxLen);
+    }
+    return `${str.slice(0, maxLen - 3)}...`;
+}
+/**
+ * Pad a string to a given length with spaces (left-align).
+ *
+ * @param str - String to pad
+ * @param len - Target length
+ * @returns Padded string
+ */
+function padRight(str, len) {
+    if (str.length >= len) {
+        return str;
+    }
+    return str + " ".repeat(len - str.length);
+}
+/**
+ * Format records as an aligned ASCII table.
+ *
+ * @param records - Array of records to format
+ * @param options - Optional configuration
+ * @param options.maxColumnWidth - Maximum width for any column (default: 40)
+ * @returns Formatted table string
+ */
+export function formatAsTable(records, options) {
+    if (records.length === 0) {
+        return "(no results)";
+    }
+    const maxColumnWidth = options?.maxColumnWidth ?? DEFAULT_MAX_COLUMN_WIDTH;
+    // Collect all unique field names across all records
+    const fieldSet = new Set();
+    for (const record of records) {
+        for (const key of Object.keys(record)) {
+            fieldSet.add(key);
+        }
+    }
+    const fields = Array.from(fieldSet);
+    // Calculate column widths (min of actual content width and max column width)
+    const columnWidths = new Map();
+    for (const field of fields) {
+        // Start with header width
+        let maxWidth = field.length;
+        // Check all data values
+        for (const record of records) {
+            const value = stringify(record[field]);
+            maxWidth = Math.max(maxWidth, value.length);
+        }
+        // Clamp to max column width
+        columnWidths.set(field, Math.min(maxWidth, maxColumnWidth));
+    }
+    // Helper to get column width with fallback (width is always set for fields in the loop above)
+    const getWidth = (field) => columnWidths.get(field) ?? 0;
+    // Build header row
+    const headerRow = fields
+        .map((field) => {
+        const width = getWidth(field);
+        return padRight(truncate(field, width), width);
+    })
+        .join("  ");
+    // Build separator row
+    const separatorRow = fields
+        .map((field) => "-".repeat(getWidth(field)))
+        .join("  ");
+    // Build data rows
+    const dataRows = records.map((record) => fields
+        .map((field) => {
+        const value = stringify(record[field]);
+        const width = getWidth(field);
+        return padRight(truncate(value, width), width);
+    })
+        .join("  "));
+    return [headerRow, separatorRow, ...dataRows].join("\n");
+}
+//# sourceMappingURL=table.js.map

package/dist/output/table.js.map

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

package/dist/output/yaml.d.ts

@@ -0,0 +1,13 @@
+/**
+ * ProseQL CLI - YAML Output Formatter
+ *
+ * Formats records as YAML using the same YAML library as @proseql/core.
+ */
+/**
+ * Format records as YAML.
+ *
+ * @param records - Array of records to format
+ * @returns YAML string with 2-space indentation
+ */
+export declare function formatAsYaml(records: ReadonlyArray<Record<string, unknown>>): string;
+//# sourceMappingURL=yaml.d.ts.map

package/dist/output/yaml.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.d.ts","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAIH;;;;;GAKG;AACH,wBAAgB,YAAY,CAC3B,OAAO,EAAE,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC,GAC7C,MAAM,CAER"}

package/dist/output/yaml.js

@@ -0,0 +1,16 @@
+/**
+ * ProseQL CLI - YAML Output Formatter
+ *
+ * Formats records as YAML using the same YAML library as @proseql/core.
+ */
+import YAML from "yaml";
+/**
+ * Format records as YAML.
+ *
+ * @param records - Array of records to format
+ * @returns YAML string with 2-space indentation
+ */
+export function formatAsYaml(records) {
+    return YAML.stringify(records, { indent: 2 });
+}
+//# sourceMappingURL=yaml.js.map

package/dist/output/yaml.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"yaml.js","sourceRoot":"","sources":["../../src/output/yaml.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB;;;;;GAKG;AACH,MAAM,UAAU,YAAY,CAC3B,OAA+C;IAE/C,OAAO,IAAI,CAAC,SAAS,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,CAAC,CAAC;AAC/C,CAAC"}

package/dist/parsers/filter-parser.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Filter Parser - Parses CLI --where expressions into proseql where clause objects
+ *
+ * Supports operators: =, !=, >, <, >=, <=, contains, startsWith, endsWith
+ * Auto-detects value types: numbers, booleans, strings
+ *
+ * Examples:
+ *   "year > 1970"        -> { year: { $gt: 1970 } }
+ *   "status = active"    -> { status: { $eq: "active" } }
+ *   "active = true"      -> { active: { $eq: true } }
+ *   "title contains War" -> { title: { $contains: "War" } }
+ */
+import { Effect } from "effect";
+declare const FilterParseError_base: new <A extends Record<string, any> = {}>(args: import("effect/Types").Equals<A, {}> extends true ? void : { readonly [P in keyof A as P extends "_tag" ? never : P]: A[P]; }) => import("effect/Cause").YieldableError & {
+    readonly _tag: "FilterParseError";
+} & Readonly<A>;
+/**
+ * Error thrown when a filter expression cannot be parsed
+ */
+export declare class FilterParseError extends FilterParseError_base<{
+    readonly expression: string;
+    readonly reason: string;
+}> {
+    get message(): string;
+}
+/**
+ * Where clause type - record of field to filter operators
+ */
+export type WhereClause = Record<string, {
+    $eq?: string | number | boolean;
+} | {
+    $ne?: string | number | boolean;
+} | {
+    $gt?: string | number;
+} | {
+    $lt?: string | number;
+} | {
+    $gte?: string | number;
+} | {
+    $lte?: string | number;
+} | {
+    $contains?: string;
+} | {
+    $startsWith?: string;
+} | {
+    $endsWith?: string;
+}>;
+/**
+ * Parse a single filter expression into a where clause object
+ *
+ * @param expression - Filter expression string (e.g., "year > 1970")
+ * @returns Effect containing the where clause or a FilterParseError
+ */
+export declare function parseFilter(expression: string): Effect.Effect<WhereClause, FilterParseError>;
+/**
+ * Parse multiple filter expressions and combine them into a single where clause
+ * Multiple filters on different fields are combined with AND logic
+ * Multiple filters on the same field are merged
+ *
+ * @param expressions - Array of filter expression strings
+ * @returns Effect containing the combined where clause or a FilterParseError
+ */
+export declare function parseFilters(expressions: readonly string[]): Effect.Effect<WhereClause, FilterParseError>;
+export {};
+//# sourceMappingURL=filter-parser.d.ts.map

package/dist/parsers/filter-parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"filter-parser.d.ts","sourceRoot":"","sources":["../../src/parsers/filter-parser.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;GAWG;AAEH,OAAO,EAAQ,MAAM,EAAE,MAAM,QAAQ,CAAC;;;;AAEtC;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,sBAAqC;IAC1E,QAAQ,CAAC,UAAU,EAAE,MAAM,CAAC;IAC5B,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;CACxB,CAAC;IACD,IAAI,OAAO,IAAI,MAAM,CAEpB;CACD;AAyLD;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,CAC/B,MAAM,EACJ;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GACnC;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAA;CAAE,GACnC;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzB;IAAE,GAAG,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GACzB;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC1B;IAAE,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAA;CAAE,GAC1B;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,GACtB;IAAE,WAAW,CAAC,EAAE,MAAM,CAAA;CAAE,GACxB;IAAE,SAAS,CAAC,EAAE,MAAM,CAAA;CAAE,CACxB,CAAC;AAEF;;;;;GAKG;AACH,wBAAgB,WAAW,CAC1B,UAAU,EAAE,MAAM,GAChB,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAW9C;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAC3B,WAAW,EAAE,SAAS,MAAM,EAAE,GAC5B,MAAM,CAAC,MAAM,CAAC,WAAW,EAAE,gBAAgB,CAAC,CAuB9C"}

package/dist/parsers/filter-parser.js

@@ -0,0 +1,198 @@
+/**
+ * Filter Parser - Parses CLI --where expressions into proseql where clause objects
+ *
+ * Supports operators: =, !=, >, <, >=, <=, contains, startsWith, endsWith
+ * Auto-detects value types: numbers, booleans, strings
+ *
+ * Examples:
+ *   "year > 1970"        -> { year: { $gt: 1970 } }
+ *   "status = active"    -> { status: { $eq: "active" } }
+ *   "active = true"      -> { active: { $eq: true } }
+ *   "title contains War" -> { title: { $contains: "War" } }
+ */
+import { Data, Effect } from "effect";
+/**
+ * Error thrown when a filter expression cannot be parsed
+ */
+export class FilterParseError extends Data.TaggedError("FilterParseError") {
+    get message() {
+        return `Failed to parse filter "${this.expression}": ${this.reason}`;
+    }
+}
+/**
+ * Supported comparison operators
+ */
+const COMPARISON_OPERATORS = [">=", "<=", "!=", ">", "<", "="];
+/**
+ * Supported word operators (case-insensitive)
+ */
+const WORD_OPERATORS = ["contains", "startswith", "endswith"];
+/**
+ * Map CLI operators to proseql filter operators
+ */
+function mapOperator(op) {
+    switch (op) {
+        case "=":
+            return "$eq";
+        case "!=":
+            return "$ne";
+        case ">":
+            return "$gt";
+        case "<":
+            return "$lt";
+        case ">=":
+            return "$gte";
+        case "<=":
+            return "$lte";
+        case "contains":
+            return "$contains";
+        case "startswith":
+            return "$startsWith";
+        case "endswith":
+            return "$endsWith";
+    }
+}
+/**
+ * Parse a string value into the appropriate type (number, boolean, or string)
+ */
+function parseValue(value) {
+    const trimmed = value.trim();
+    // Check for boolean
+    if (trimmed.toLowerCase() === "true") {
+        return true;
+    }
+    if (trimmed.toLowerCase() === "false") {
+        return false;
+    }
+    // Check for number
+    const num = Number(trimmed);
+    if (!Number.isNaN(num) && trimmed !== "") {
+        return num;
+    }
+    // Default to string - strip quotes if present
+    if ((trimmed.startsWith('"') && trimmed.endsWith('"')) ||
+        (trimmed.startsWith("'") && trimmed.endsWith("'"))) {
+        return trimmed.slice(1, -1);
+    }
+    return trimmed;
+}
+/**
+ * Try to parse a filter expression with comparison operators (=, !=, >, <, >=, <=)
+ */
+function tryParseComparisonOperator(expression) {
+    // Try each operator in order (longest first to avoid partial matches)
+    for (const op of COMPARISON_OPERATORS) {
+        const index = expression.indexOf(op);
+        if (index > 0) {
+            const field = expression.slice(0, index).trim();
+            const valueStr = expression.slice(index + op.length).trim();
+            if (field && valueStr) {
+                return {
+                    field,
+                    operator: op,
+                    value: parseValue(valueStr),
+                };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Try to parse a filter expression with word operators (contains, startsWith, endsWith)
+ */
+function tryParseWordOperator(expression) {
+    const _lowerExpr = expression.toLowerCase();
+    for (const op of WORD_OPERATORS) {
+        // Look for the operator as a word boundary (space before and after)
+        const pattern = new RegExp(`\\s+${op}\\s+`, "i");
+        const match = expression.match(pattern);
+        if (match && match.index !== undefined) {
+            const field = expression.slice(0, match.index).trim();
+            const valueStr = expression.slice(match.index + match[0].length).trim();
+            if (field && valueStr) {
+                return {
+                    field,
+                    operator: op,
+                    value: parseValue(valueStr),
+                };
+            }
+        }
+    }
+    return undefined;
+}
+/**
+ * Parse a single filter expression into a parsed filter object
+ */
+function parseExpression(expression) {
+    return Effect.gen(function* () {
+        const trimmed = expression.trim();
+        if (!trimmed) {
+            return yield* Effect.fail(new FilterParseError({
+                expression,
+                reason: "Empty expression",
+            }));
+        }
+        // Try comparison operators first
+        const comparisonResult = tryParseComparisonOperator(trimmed);
+        if (comparisonResult) {
+            return comparisonResult;
+        }
+        // Try word operators
+        const wordResult = tryParseWordOperator(trimmed);
+        if (wordResult) {
+            return wordResult;
+        }
+        return yield* Effect.fail(new FilterParseError({
+            expression,
+            reason: "No valid operator found. Supported operators: =, !=, >, <, >=, <=, contains, startsWith, endsWith",
+        }));
+    });
+}
+/**
+ * Parse a single filter expression into a where clause object
+ *
+ * @param expression - Filter expression string (e.g., "year > 1970")
+ * @returns Effect containing the where clause or a FilterParseError
+ */
+export function parseFilter(expression) {
+    return Effect.gen(function* () {
+        const parsed = yield* parseExpression(expression);
+        const operator = mapOperator(parsed.operator);
+        return {
+            [parsed.field]: {
+                [operator]: parsed.value,
+            },
+        };
+    });
+}
+/**
+ * Parse multiple filter expressions and combine them into a single where clause
+ * Multiple filters on different fields are combined with AND logic
+ * Multiple filters on the same field are merged
+ *
+ * @param expressions - Array of filter expression strings
+ * @returns Effect containing the combined where clause or a FilterParseError
+ */
+export function parseFilters(expressions) {
+    return Effect.gen(function* () {
+        if (expressions.length === 0) {
+            return {};
+        }
+        const parsedFilters = yield* Effect.all(expressions.map(parseFilter));
+        // Merge all filters into a single where clause
+        const combined = {};
+        for (const filter of parsedFilters) {
+            for (const [field, conditions] of Object.entries(filter)) {
+                if (combined[field]) {
+                    // Merge conditions for the same field
+                    combined[field] = { ...combined[field], ...conditions };
+                }
+                else {
+                    combined[field] = conditions;
+                }
+            }
+        }
+        return combined;
+    });
+}
+//# sourceMappingURL=filter-parser.js.map

package/dist/parsers/filter-parser.js.map

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