@quereus/quereus 0.1.0

package/dist/src/util/comparison.js

@@ -0,0 +1,397 @@
+import { createLogger } from '../common/logger.js';
+const log = createLogger('util:comparison');
+const warnLog = log.extend('warn');
+// Map to store registered collations
+const collations = new Map();
+/**
+ * Binary (default) collation function.
+ * Performs standard lexicographical comparison of strings.
+ */
+export const BINARY_COLLATION = (a, b) => {
+    return a < b ? -1 : a > b ? 1 : 0;
+};
+/**
+ * Case-insensitive collation function.
+ * Compares strings after converting them to lowercase.
+ */
+export const NOCASE_COLLATION = (a, b) => {
+    const lowerA = a.toLowerCase();
+    const lowerB = b.toLowerCase();
+    return lowerA < lowerB ? -1 : lowerA > lowerB ? 1 : 0;
+};
+/**
+ * Right-trim collation function.
+ * Compares strings after removing trailing spaces.
+ */
+export const RTRIM_COLLATION = (a, b) => {
+    let lenA = a.length;
+    let lenB = b.length;
+    while (lenA > 0 && a[lenA - 1] === ' ')
+        lenA--;
+    while (lenB > 0 && b[lenB - 1] === ' ')
+        lenB--;
+    const minLen = Math.min(lenA, lenB);
+    for (let i = 0; i < minLen; i++) {
+        if (a[i] !== b[i]) {
+            return a[i] < b[i] ? -1 : 1;
+        }
+    }
+    return lenA - lenB;
+};
+// Register built-in collations
+collations.set('BINARY', BINARY_COLLATION);
+collations.set('NOCASE', NOCASE_COLLATION);
+collations.set('RTRIM', RTRIM_COLLATION);
+/**
+ * Registers a collation function with the given name.
+ * @param name The name of the collation (case-insensitive)
+ * @param func The collation function to register
+ */
+export function registerCollation(name, func) {
+    const upperName = name.toUpperCase();
+    if (collations.has(upperName)) {
+        warnLog(`Overwriting existing collation: %s`, upperName);
+    }
+    collations.set(upperName, func);
+}
+/**
+ * Gets a registered collation function by name.
+ * @param name The collation name (case-insensitive)
+ * @returns The collation function, or undefined if not found
+ */
+export function getCollation(name) {
+    return collations.get(name.toUpperCase());
+}
+/**
+ * Resolves a collation name to its function. Optimized for hot path usage.
+ * @param collationName The collation name
+ * @returns The collation function (defaults to BINARY if not found)
+ */
+export function resolveCollation(collationName) {
+    if (collationName === 'BINARY')
+        return BINARY_COLLATION; // Fast path for most common case
+    const func = collations.get(collationName.toUpperCase());
+    if (!func) {
+        warnLog(`Unknown collation requested: %s. Falling back to BINARY.`, collationName);
+        return BINARY_COLLATION;
+    }
+    return func;
+}
+/**
+ * Evaluates a JavaScript value according to simplified, JS-idiomatic truthiness rules.
+ * - null/undefined are false
+ * - boolean is its own value
+ * - number: 0 is false, non-zero is true
+ * - bigint: 0n is false, non-zero is true
+ * - string: empty string is false, non-empty is true
+ * - Uint8Array (BLOB): always false
+ *
+ * @param value The value to evaluate
+ * @returns True or false
+ */
+export function evaluateIsTrue(value) {
+    if (value === null || value === undefined) {
+        return false;
+    }
+    switch (typeof value) {
+        case 'boolean':
+            return value;
+        case 'number':
+            return value !== 0;
+        case 'bigint':
+            return value !== 0n;
+        case 'string':
+            return value.length > 0;
+        case 'object':
+            if (value instanceof Uint8Array) {
+                return false;
+            }
+            return false;
+        default:
+            return false;
+    }
+}
+/** Represents SQLite storage classes for comparison purposes */
+var StorageClass;
+(function (StorageClass) {
+    StorageClass[StorageClass["NULL"] = 0] = "NULL";
+    StorageClass[StorageClass["NUMERIC"] = 1] = "NUMERIC";
+    StorageClass[StorageClass["TEXT"] = 2] = "TEXT";
+    StorageClass[StorageClass["BLOB"] = 3] = "BLOB";
+    StorageClass[StorageClass["UNKNOWN"] = 99] = "UNKNOWN";
+})(StorageClass || (StorageClass = {}));
+/**
+ * Determines the effective storage class for comparison, converting boolean to numeric.
+ * Optimized with early returns for common cases.
+ */
+function getStorageClass(v) {
+    if (v === null)
+        return StorageClass.NULL; // Most common null check
+    const type = typeof v;
+    // Fast path for numbers (most common non-null case)
+    if (type === 'number')
+        return StorageClass.NUMERIC;
+    if (type === 'string')
+        return StorageClass.TEXT;
+    if (type === 'boolean' || type === 'bigint')
+        return StorageClass.NUMERIC;
+    if (type === 'object' && v instanceof Uint8Array)
+        return StorageClass.BLOB;
+    return StorageClass.UNKNOWN;
+}
+/**
+ * Returns the SQLite fundamental datatype name of a value.
+ * @param v The value
+ * @returns The datatype name as a string
+ */
+export function getSqlDataTypeName(v) {
+    if (v === null || v === undefined)
+        return 'null';
+    const type = typeof v;
+    if (type === 'boolean')
+        return 'integer';
+    if (type === 'number') {
+        return Number.isInteger(v) ? 'integer' : 'real';
+    }
+    if (type === 'bigint')
+        return 'integer';
+    if (type === 'string')
+        return 'text';
+    if (type === 'object' && v instanceof Uint8Array)
+        return 'blob';
+    return 'null';
+}
+/**
+ * Fast path comparison for two numbers (most common case).
+ * @param a First number
+ * @param b Second number
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+function compareNumbers(a, b) {
+    return a < b ? -1 : a > b ? 1 : 0;
+}
+/**
+ * Optimized comparison for same-type values.
+ * @param a First value
+ * @param b Second value
+ * @param storageClass The storage class of both values
+ * @param collationFunc The collation function (for TEXT types)
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+function compareSameType(a, b, storageClass, collationFunc) {
+    switch (storageClass) {
+        case StorageClass.NUMERIC: {
+            // Convert booleans to numbers inline for efficiency
+            const valA = typeof a === 'boolean' ? (a ? 1 : 0) : a;
+            const valB = typeof b === 'boolean' ? (b ? 1 : 0) : b;
+            return compareNumbers(valA, valB);
+        }
+        case StorageClass.TEXT: {
+            return collationFunc(a, b);
+        }
+        case StorageClass.BLOB: {
+            const blobA = a;
+            const blobB = b;
+            const len = Math.min(blobA.length, blobB.length);
+            for (let i = 0; i < len; i++) {
+                if (blobA[i] !== blobB[i]) {
+                    return blobA[i] < blobB[i] ? -1 : 1;
+                }
+            }
+            return blobA.length < blobB.length ? -1 : blobA.length > blobB.length ? 1 : 0;
+        }
+        default: {
+            return 0;
+        }
+    }
+}
+/**
+ * Compares two SQLite values based on SQLite's comparison rules.
+ * Follows SQLite's type ordering: NULL < Numeric < TEXT < BLOB
+ *
+ * @param a First value
+ * @param b Second value
+ * @param collationName The collation to use for text comparison (defaults to BINARY)
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export function compareSqlValues(a, b, collationName = 'BINARY') {
+    const collationFunc = collationName === 'BINARY' ? BINARY_COLLATION : resolveCollation(collationName);
+    return compareSqlValuesFast(a, b, collationFunc);
+}
+/**
+ * Optimized version of compareSqlValues that takes a pre-resolved collation function.
+ * This avoids the collation lookup on every call.
+ *
+ * @param a First value
+ * @param b Second value
+ * @param collationFunc Pre-resolved collation function
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b
+ */
+export function compareSqlValuesFast(a, b, collationFunc) {
+    const classA = getStorageClass(a);
+    const classB = getStorageClass(b);
+    // Fast path: NULL comparisons
+    if (classA === StorageClass.NULL) {
+        return classB === StorageClass.NULL ? 0 : -1;
+    }
+    if (classB === StorageClass.NULL) {
+        return 1;
+    }
+    // Fast path: same type comparison
+    if (classA === classB) {
+        return compareSameType(a, b, classA, collationFunc);
+    }
+    // Different types: compare by storage class ordering
+    return classA - classB;
+}
+/**
+ * Direction flags for optimized comparisons (avoids string comparison in hot path)
+ */
+export var SortDirection;
+(function (SortDirection) {
+    SortDirection[SortDirection["ASC"] = 0] = "ASC";
+    SortDirection[SortDirection["DESC"] = 1] = "DESC";
+})(SortDirection || (SortDirection = {}));
+/**
+ * NULL ordering flags for optimized comparisons
+ */
+export var NullsOrdering;
+(function (NullsOrdering) {
+    NullsOrdering[NullsOrdering["DEFAULT"] = 0] = "DEFAULT";
+    NullsOrdering[NullsOrdering["FIRST"] = 1] = "FIRST";
+    NullsOrdering[NullsOrdering["LAST"] = 2] = "LAST";
+})(NullsOrdering || (NullsOrdering = {}));
+/**
+ * Highly optimized comparison function for ORDER BY operations.
+ * Takes pre-resolved collation function and numeric flags to avoid string comparisons.
+ *
+ * @param a First value
+ * @param b Second value
+ * @param direction Sort direction (SortDirection.ASC or SortDirection.DESC)
+ * @param nullsOrdering NULL ordering (NullsOrdering enum)
+ * @param collationFunc Pre-resolved collation function
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b (after applying direction and null ordering)
+ */
+export function compareWithOrderByFast(a, b, direction, nullsOrdering, collationFunc) {
+    let comparison;
+    // Fast path: both values are non-NULL (most common case)
+    if (a !== null && b !== null) {
+        comparison = compareSqlValuesFast(a, b, collationFunc);
+    }
+    else if (a === null && b === null) {
+        comparison = 0;
+    }
+    else if (a === null) {
+        // Handle NULL ordering with numeric flags (faster than string comparison)
+        if (nullsOrdering === NullsOrdering.LAST) {
+            comparison = 1; // nulls last
+        }
+        else if (nullsOrdering === NullsOrdering.FIRST) {
+            comparison = -1; // nulls first
+        }
+        else {
+            // Default behavior: nulls first for ASC, nulls last for DESC
+            comparison = direction === SortDirection.DESC ? 1 : -1;
+        }
+    }
+    else { // b === null
+        if (nullsOrdering === NullsOrdering.LAST) {
+            comparison = -1; // nulls last (b is null, so a comes first)
+        }
+        else if (nullsOrdering === NullsOrdering.FIRST) {
+            comparison = 1; // nulls first (b is null, so b comes first)
+        }
+        else {
+            // Default behavior: nulls first for ASC, nulls last for DESC
+            comparison = direction === SortDirection.DESC ? -1 : 1;
+        }
+    }
+    // Apply DESC direction (branchless when direction is ASC)
+    return direction === SortDirection.DESC ? -comparison : comparison;
+}
+/**
+ * Compares two SQL values with ORDER BY semantics including direction and NULL ordering.
+ * This consolidates the comparison logic used by both sort and window operations.
+ *
+ * @param a First value
+ * @param b Second value
+ * @param direction Sort direction ('asc' or 'desc')
+ * @param nullsOrdering Explicit NULLS ordering ('first', 'last', or undefined for default)
+ * @param collationName The collation to use for text comparison (defaults to BINARY)
+ * @returns -1 if a < b, 0 if a === b, 1 if a > b (after applying direction and null ordering)
+ */
+export function compareWithOrderBy(a, b, direction = 'asc', nullsOrdering, collationName = 'BINARY') {
+    // Convert to optimized flags and use fast path
+    const directionFlag = direction === 'desc' ? SortDirection.DESC : SortDirection.ASC;
+    const nullsFlag = nullsOrdering === 'first' ? NullsOrdering.FIRST :
+        nullsOrdering === 'last' ? NullsOrdering.LAST :
+            NullsOrdering.DEFAULT;
+    const collationFunc = collationName === 'BINARY' ? BINARY_COLLATION : resolveCollation(collationName);
+    return compareWithOrderByFast(a, b, directionFlag, nullsFlag, collationFunc);
+}
+/**
+ * Factory function to create optimized comparison functions for repeated use.
+ * Pre-resolves collation and converts string flags to numeric for maximum performance.
+ *
+ * @param direction Sort direction ('asc' or 'desc')
+ * @param nullsOrdering Explicit NULLS ordering ('first', 'last', or undefined for default)
+ * @param collationName The collation to use for text comparison (defaults to BINARY)
+ * @returns An optimized comparison function
+ */
+export function createOrderByComparator(direction = 'asc', nullsOrdering, collationName = 'BINARY') {
+    const collationFunc = collationName === 'BINARY' ? BINARY_COLLATION : resolveCollation(collationName);
+    return createOrderByComparatorFast(direction, nullsOrdering, collationFunc);
+}
+/**
+ * Optimized factory function that takes a pre-resolved collation function.
+ * This is the most efficient option when the collation function is already available.
+ *
+ * @param direction Sort direction ('asc' or 'desc')
+ * @param nullsOrdering Explicit NULLS ordering ('first', 'last', or undefined for default)
+ * @param collationFunc Pre-resolved collation function
+ * @returns An optimized comparison function
+ */
+export function createOrderByComparatorFast(direction = 'asc', nullsOrdering, collationFunc = BINARY_COLLATION) {
+    const directionFlag = direction === 'desc' ? SortDirection.DESC : SortDirection.ASC;
+    const nullsFlag = nullsOrdering === 'first' ? NullsOrdering.FIRST :
+        nullsOrdering === 'last' ? NullsOrdering.LAST :
+            NullsOrdering.DEFAULT;
+    // Return a closure that captures the pre-resolved values
+    return (a, b) => {
+        return compareWithOrderByFast(a, b, directionFlag, nullsFlag, collationFunc);
+    };
+}
+/**
+ * Determines if a SqlValue is truthy for filter purposes.
+ * In SQL semantics:
+ * - NULL is falsy
+ * - 0 (number) is falsy
+ * - Empty string is falsy
+ * - false (boolean) is falsy
+ * - Everything else is truthy
+ */
+export function isTruthy(value) {
+    return (typeof value === 'string') ? value.length > 0 : !!value;
+}
+/**
+ * Compares two rows for SQL DISTINCT semantics.
+ * Returns -1, 0, or 1 for BTree ordering.
+ */
+export function compareRows(a, b) {
+    // Let's assume correct rows
+    // if (a.length !== b.length) {
+    // 	return a.length - b.length;
+    // }
+    // Compare each value using SQL semantics
+    for (let i = 0; i < a.length; i++) {
+        const comparison = compareSqlValues(a[i], b[i]);
+        if (comparison !== 0) {
+            return comparison;
+        }
+    }
+    return 0;
+}
+// TODO: The main remaining task for comparison is implementing SQLite's
+// type affinity rules (which affect how values are treated BEFORE comparison)
+// and handling different TEXT collations.
+//# sourceMappingURL=comparison.js.map

package/dist/src/util/comparison.js.map

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

package/dist/src/util/environment.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Cross-platform environment variable utilities
+ * Works in Node.js, browsers, and React Native
+ */
+/**
+ * Cross-platform environment variable accessor
+ * Works in Node.js, browsers, and React Native
+ *
+ * @param key The environment variable name
+ * @returns The environment variable value or undefined if not found
+ */
+export declare function getEnvVar(key: string): string | undefined;
+/**
+ * Check if debug logging is enabled for a specific namespace
+ * Uses the debug library's own enabled property via createLogger
+ *
+ * @param namespace The debug namespace to check (without the 'quereus:' prefix)
+ * @returns true if debug logging is enabled for the namespace
+ */
+export declare function isDebugEnabled(namespace: string): boolean;
+/**
+ * Check if a feature flag is enabled
+ *
+ * @param flagName The feature flag name
+ * @returns true if the flag is set to 'true'
+ */
+export declare function isFeatureEnabled(flagName: string): boolean;
+//# sourceMappingURL=environment.d.ts.map

package/dist/src/util/environment.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.d.ts","sourceRoot":"","sources":["../../../src/util/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;;;;;GAMG;AACH,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAezD;AAED;;;;;;GAMG;AACH,wBAAgB,cAAc,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAGzD;AAED;;;;;GAKG;AACH,wBAAgB,gBAAgB,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAE1D"}

package/dist/src/util/environment.js

@@ -0,0 +1,47 @@
+/**
+ * Cross-platform environment variable utilities
+ * Works in Node.js, browsers, and React Native
+ */
+import { createLogger } from '../common/logger.js';
+/**
+ * Cross-platform environment variable accessor
+ * Works in Node.js, browsers, and React Native
+ *
+ * @param key The environment variable name
+ * @returns The environment variable value or undefined if not found
+ */
+export function getEnvVar(key) {
+    // Node.js environment
+    if (typeof process !== 'undefined' && process.env) {
+        return process.env[key];
+    }
+    // Browser environment - check if globalThis has the variable
+    // This allows setting environment variables like: globalThis.DEBUG = "quereus:*"
+    if (typeof globalThis !== 'undefined' && globalThis[key]) {
+        return globalThis[key];
+    }
+    // React Native or other environments might set environment variables differently
+    // For now, return undefined for unsupported environments
+    return undefined;
+}
+/**
+ * Check if debug logging is enabled for a specific namespace
+ * Uses the debug library's own enabled property via createLogger
+ *
+ * @param namespace The debug namespace to check (without the 'quereus:' prefix)
+ * @returns true if debug logging is enabled for the namespace
+ */
+export function isDebugEnabled(namespace) {
+    const logger = createLogger(namespace);
+    return logger.enabled;
+}
+/**
+ * Check if a feature flag is enabled
+ *
+ * @param flagName The feature flag name
+ * @returns true if the flag is set to 'true'
+ */
+export function isFeatureEnabled(flagName) {
+    return getEnvVar(flagName) === 'true';
+}
+//# sourceMappingURL=environment.js.map

package/dist/src/util/environment.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"environment.js","sourceRoot":"","sources":["../../../src/util/environment.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD;;;;;;GAMG;AACH,MAAM,UAAU,SAAS,CAAC,GAAW;IACpC,sBAAsB;IACtB,IAAI,OAAO,OAAO,KAAK,WAAW,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QACnD,OAAO,OAAO,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC;IACzB,CAAC;IAED,6DAA6D;IAC7D,iFAAiF;IACjF,IAAI,OAAO,UAAU,KAAK,WAAW,IAAK,UAAkB,CAAC,GAAG,CAAC,EAAE,CAAC;QACnE,OAAQ,UAAkB,CAAC,GAAG,CAAC,CAAC;IACjC,CAAC;IAED,iFAAiF;IACjF,yDAAyD;IACzD,OAAO,SAAS,CAAC;AAClB,CAAC;AAED;;;;;;GAMG;AACH,MAAM,UAAU,cAAc,CAAC,SAAiB;IAC/C,MAAM,MAAM,GAAG,YAAY,CAAC,SAAS,CAAC,CAAC;IACvC,OAAO,MAAM,CAAC,OAAO,CAAC;AACvB,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,gBAAgB,CAAC,QAAgB;IAChD,OAAO,SAAS,CAAC,QAAQ,CAAC,KAAK,MAAM,CAAC;AACvC,CAAC"}

package/dist/src/util/latches.d.ts

@@ -0,0 +1,16 @@
+/**
+ * Lightweight implementation of a mutex lock queue for managing concurrent access.
+ */
+export declare class Latches {
+    private static lockQueues;
+    /**
+     * Acquires a lock for the given key. Waits if another operation holds the lock.
+     * Returns a release function that must be called to release the lock.
+     *
+     * @param key A unique string identifier for the resource to lock.
+     *            Should use `ClassName.methodName:${id}` format to avoid conflicts.
+     * @returns A function that must be called to release the lock
+     */
+    static acquire(key: string): Promise<() => void>;
+}
+//# sourceMappingURL=latches.d.ts.map

package/dist/src/util/latches.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"latches.d.ts","sourceRoot":"","sources":["../../../src/util/latches.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,qBAAa,OAAO;IAEnB,OAAO,CAAC,MAAM,CAAC,UAAU,CAAoC;IAE7D;;;;;;;OAOG;WACU,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,IAAI,CAAC;CA+BtD"}

package/dist/src/util/latches.js

@@ -0,0 +1,41 @@
+/**
+ * Lightweight implementation of a mutex lock queue for managing concurrent access.
+ */
+export class Latches {
+    // Stores the promise representing the completion of the last queued operation for a key.
+    static lockQueues = new Map();
+    /**
+     * Acquires a lock for the given key. Waits if another operation holds the lock.
+     * Returns a release function that must be called to release the lock.
+     *
+     * @param key A unique string identifier for the resource to lock.
+     *            Should use `ClassName.methodName:${id}` format to avoid conflicts.
+     * @returns A function that must be called to release the lock
+     */
+    static async acquire(key) {
+        // Get the promise the current operation needs to wait for (if any)
+        const currentTail = this.lockQueues.get(key) ?? Promise.resolve();
+        let resolveNewTail;
+        // Create the promise that the *next* operation will wait for
+        const newTail = new Promise(resolve => {
+            resolveNewTail = resolve;
+        });
+        // Immediately set the new promise as the tail for this key
+        this.lockQueues.set(key, newTail);
+        // Wait for the previous operation (if any) to complete
+        await currentTail;
+        // Return the function to release *this* lock
+        const release = () => {
+            // Signal that this operation is complete
+            resolveNewTail();
+            // If this promise is still the current tail in the map,
+            // it means no other operation queued up behind this one while it was running.
+            // We can safely remove the entry from the map to prevent unbounded growth.
+            if (this.lockQueues.get(key) === newTail) {
+                this.lockQueues.delete(key);
+            }
+        };
+        return release;
+    }
+}
+//# sourceMappingURL=latches.js.map

package/dist/src/util/latches.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"latches.js","sourceRoot":"","sources":["../../../src/util/latches.ts"],"names":[],"mappings":"AAAA;;GAEG;AACH,MAAM,OAAO,OAAO;IACnB,yFAAyF;IACjF,MAAM,CAAC,UAAU,GAAG,IAAI,GAAG,EAAyB,CAAC;IAE7D;;;;;;;OAOG;IACH,MAAM,CAAC,KAAK,CAAC,OAAO,CAAC,GAAW;QAC/B,mEAAmE;QACnE,MAAM,WAAW,GAAG,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;QAElE,IAAI,cAA2B,CAAC;QAChC,6DAA6D;QAC7D,MAAM,OAAO,GAAG,IAAI,OAAO,CAAO,OAAO,CAAC,EAAE;YAC3C,cAAc,GAAG,OAAO,CAAC;QAC1B,CAAC,CAAC,CAAC;QAEH,2DAA2D;QAC3D,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,EAAE,OAAO,CAAC,CAAC;QAElC,uDAAuD;QACvD,MAAM,WAAW,CAAC;QAElB,6CAA6C;QAC7C,MAAM,OAAO,GAAG,GAAG,EAAE;YACpB,yCAAyC;YACzC,cAAc,EAAE,CAAC;YAEjB,wDAAwD;YACxD,8EAA8E;YAC9E,2EAA2E;YAC3E,IAAI,IAAI,CAAC,UAAU,CAAC,GAAG,CAAC,GAAG,CAAC,KAAK,OAAO,EAAE,CAAC;gBAC1C,IAAI,CAAC,UAAU,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;YAC7B,CAAC;QACF,CAAC,CAAC;QAEF,OAAO,OAAO,CAAC;IAChB,CAAC"}

package/dist/src/util/patterns.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Simple LIKE pattern matching implementation.
+ * Supports SQL LIKE patterns:
+ * - % matches any sequence of characters (including empty sequence)
+ * - _ matches any single character
+ *
+ * @param pattern The LIKE pattern
+ * @param text The text to match against
+ * @returns true if the text matches the pattern, false otherwise
+ */
+export declare function simpleLike(pattern: string, text: string): boolean;
+/**
+ * Simple GLOB pattern matching implementation.
+ * Supports SQL GLOB patterns:
+ * - * matches any sequence of characters (including empty sequence)
+ * - ? matches any single character
+ *
+ * @param pattern The GLOB pattern
+ * @param text The text to match against
+ * @returns true if the text matches the pattern, false otherwise
+ */
+export declare function simpleGlob(pattern: string, text: string): boolean;
+//# sourceMappingURL=patterns.d.ts.map

package/dist/src/util/patterns.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.d.ts","sourceRoot":"","sources":["../../../src/util/patterns.ts"],"names":[],"mappings":"AAKA;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAajE;AAED;;;;;;;;;GASG;AACH,wBAAgB,UAAU,CAAC,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,GAAG,OAAO,CAejE"}

package/dist/src/util/patterns.js

@@ -0,0 +1,54 @@
+import { createLogger } from '../common/logger.js';
+const log = createLogger('util:patterns');
+const errorLog = log.extend('error');
+/**
+ * Simple LIKE pattern matching implementation.
+ * Supports SQL LIKE patterns:
+ * - % matches any sequence of characters (including empty sequence)
+ * - _ matches any single character
+ *
+ * @param pattern The LIKE pattern
+ * @param text The text to match against
+ * @returns true if the text matches the pattern, false otherwise
+ */
+export function simpleLike(pattern, text) {
+    // Escape regex special characters except % and _
+    const escapedPattern = pattern.replace(/[.*+^${}()|[\]\\]/g, '\\$&');
+    // Convert SQL LIKE wildcards to regex equivalents
+    const regexPattern = escapedPattern.replace(/%/g, '.*').replace(/_/g, '.');
+    try {
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(text);
+    }
+    catch (e) {
+        errorLog('Invalid LIKE pattern converted to regex: ^%s$, %O', regexPattern, e);
+        return false;
+    }
+}
+/**
+ * Simple GLOB pattern matching implementation.
+ * Supports SQL GLOB patterns:
+ * - * matches any sequence of characters (including empty sequence)
+ * - ? matches any single character
+ *
+ * @param pattern The GLOB pattern
+ * @param text The text to match against
+ * @returns true if the text matches the pattern, false otherwise
+ */
+export function simpleGlob(pattern, text) {
+    // Escape regex special characters except * and ?
+    const escapedPattern = pattern.replace(/[.*+^${}()|[\]\\]/g, '\\$&');
+    // Convert SQL GLOB wildcards to regex equivalents
+    const regexPattern = escapedPattern
+        .replace(/\\\*/g, '.*')
+        .replace(/\\\?/g, '.');
+    try {
+        const regex = new RegExp(`^${regexPattern}$`);
+        return regex.test(text);
+    }
+    catch (e) {
+        errorLog('Invalid GLOB pattern converted to regex: ^%s$, %O', regexPattern, e);
+        return false;
+    }
+}
+//# sourceMappingURL=patterns.js.map

package/dist/src/util/patterns.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"patterns.js","sourceRoot":"","sources":["../../../src/util/patterns.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,MAAM,qBAAqB,CAAC;AAEnD,MAAM,GAAG,GAAG,YAAY,CAAC,eAAe,CAAC,CAAC;AAC1C,MAAM,QAAQ,GAAG,GAAG,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC;AAErC;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAY;IACvD,iDAAiD;IACjD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACrE,kDAAkD;IAClD,MAAM,YAAY,GAAG,cAAc,CAAC,OAAO,CAAC,IAAI,EAAE,IAAI,CAAC,CAAC,OAAO,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC;IAE3E,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,QAAQ,CAAC,mDAAmD,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC;AAED;;;;;;;;;GASG;AACH,MAAM,UAAU,UAAU,CAAC,OAAe,EAAE,IAAY;IACvD,iDAAiD;IACjD,MAAM,cAAc,GAAG,OAAO,CAAC,OAAO,CAAC,oBAAoB,EAAE,MAAM,CAAC,CAAC;IACrE,kDAAkD;IAClD,MAAM,YAAY,GAAG,cAAc;SACjC,OAAO,CAAC,OAAO,EAAE,IAAI,CAAC;SACtB,OAAO,CAAC,OAAO,EAAE,GAAG,CAAC,CAAC;IAExB,IAAI,CAAC;QACJ,MAAM,KAAK,GAAG,IAAI,MAAM,CAAC,IAAI,YAAY,GAAG,CAAC,CAAC;QAC9C,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACzB,CAAC;IAAC,OAAO,CAAC,EAAE,CAAC;QACZ,QAAQ,CAAC,mDAAmD,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC;QAC/E,OAAO,KAAK,CAAC;IACd,CAAC;AACF,CAAC"}