@quereus/quereus 0.1.0

package/dist/src/func/builtins/generation.js

@@ -0,0 +1,36 @@
+import { SqlDataType } from "../../common/types.js";
+import { createTableValuedFunction } from "../registration.js";
+// Generate a sequence of numbers (table-valued function)
+export const generateSeriesFunc = createTableValuedFunction({
+    name: 'generate_series',
+    numArgs: 2,
+    deterministic: true,
+    returnType: {
+        typeClass: 'relation',
+        isReadOnly: true,
+        isSet: true,
+        columns: [
+            {
+                name: 'value',
+                type: {
+                    typeClass: 'scalar',
+                    affinity: SqlDataType.INTEGER,
+                    nullable: false,
+                    isReadOnly: true
+                },
+                generated: true
+            }
+        ],
+        keys: [[{ index: 0 }]],
+        rowConstraints: []
+    }
+}, async function* (start, end) {
+    const startNum = Number(start);
+    const endNum = Number(end);
+    if (isNaN(startNum) || isNaN(endNum))
+        return;
+    for (let i = startNum; i <= endNum; ++i) {
+        yield [i];
+    }
+});
+//# sourceMappingURL=generation.js.map

package/dist/src/func/builtins/generation.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generation.js","sourceRoot":"","sources":["../../../../src/func/builtins/generation.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,WAAW,EAAE,MAAM,uBAAuB,CAAC;AACpD,OAAO,EAAE,yBAAyB,EAAE,MAAM,oBAAoB,CAAC;AAE/D,yDAAyD;AACzD,MAAM,CAAC,MAAM,kBAAkB,GAAG,yBAAyB,CAC1D;IACC,IAAI,EAAE,iBAAiB;IACvB,OAAO,EAAE,CAAC;IACV,aAAa,EAAE,IAAI;IACnB,UAAU,EAAE;QACX,SAAS,EAAE,UAAU;QACrB,UAAU,EAAE,IAAI;QAChB,KAAK,EAAE,IAAI;QACX,OAAO,EAAE;YACR;gBACC,IAAI,EAAE,OAAO;gBACb,IAAI,EAAE;oBACL,SAAS,EAAE,QAAQ;oBACnB,QAAQ,EAAE,WAAW,CAAC,OAAO;oBAC7B,QAAQ,EAAE,KAAK;oBACf,UAAU,EAAE,IAAI;iBAChB;gBACD,SAAS,EAAE,IAAI;aACf;SACD;QACD,IAAI,EAAE,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;QACtB,cAAc,EAAE,EAAE;KAClB;CACD,EACD,KAAK,SAAS,CAAC,EAAE,KAAe,EAAE,GAAa;IAC9C,MAAM,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC;IAC/B,MAAM,MAAM,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IAE3B,IAAI,KAAK,CAAC,QAAQ,CAAC,IAAI,KAAK,CAAC,MAAM,CAAC;QAAE,OAAO;IAE7C,KAAK,IAAI,CAAC,GAAG,QAAQ,EAAE,CAAC,IAAI,MAAM,EAAE,EAAE,CAAC,EAAE,CAAC;QACzC,MAAM,CAAC,CAAC,CAAC,CAAC;IACX,CAAC;AACF,CAAC,CACD,CAAC"}

package/dist/src/func/builtins/index.d.ts

@@ -0,0 +1,4 @@
+import type { FunctionSchema } from '../../schema/function.js';
+export declare const BUILTIN_FUNCTIONS: FunctionSchema[];
+export { createScalarFunction, createTableValuedFunction, createIntegratedTableValuedFunction as createDatabaseAwareTableValuedFunction, createAggregateFunction, } from '../registration.js';
+//# sourceMappingURL=index.d.ts.map

package/dist/src/func/builtins/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/index.ts"],"names":[],"mappings":"AAcA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,0BAA0B,CAAC;AAa/D,eAAO,MAAM,iBAAiB,EAAE,cAAc,EA0F7C,CAAC;AAGF,OAAO,EACN,oBAAoB,EACpB,yBAAyB,EACzB,mCAAmC,IAAI,sCAAsC,EAC7E,uBAAuB,GACvB,MAAM,oBAAoB,CAAC"}

package/dist/src/func/builtins/index.js

@@ -0,0 +1,106 @@
+import { absFunc, roundFunc, coalesceFunc, nullifFunc, typeofFunc, randomFunc, randomblobFunc, iifFunc, sqrtFunc, powFunc, powerFunc, floorFunc, ceilFunc, ceilingFunc, clampFunc, greatestFunc, leastFunc, chooseFunc } from './scalar.js';
+import { lowerFunc, upperFunc } from './string.js';
+import { lengthFunc, substrFunc, substringFunc, likeFunc, globFunc, trimFunc, ltrimFunc, rtrimFunc, replaceFunc, instrFunc, lpadFunc, rpadFunc, reverseFunc, stringConcatFunc, splitStringFunc } from './string.js';
+import { countStarFunc, sumFunc, avgFunc, minFunc, maxFunc, countXFunc, groupConcatFuncRev, totalFunc, varPopFunc, varSampFunc, stdDevPopFunc, stdDevSampFunc } from './aggregate.js';
+import { dateFunc, timeFunc, datetimeFunc, juliandayFunc, strftimeFunc } from './datetime.js';
+import { jsonValidFunc, jsonTypeFunc, jsonExtractFunc, jsonQuoteFunc, jsonArrayFunc, jsonObjectFunc, jsonInsertFunc, jsonReplaceFunc, jsonSetFunc, jsonRemoveFunc, jsonArrayLengthFunc, jsonPatchFunc, jsonGroupArrayFunc, jsonGroupObjectFunc } from './json.js';
+import { generateSeriesFunc } from './generation.js';
+import { queryPlanFunc, schedulerProgramFunc, stackTraceFunc, executionTraceFunc, rowTraceFunc } from './explain.js';
+import { schemaFunc, tableInfoFunc, functionInfoFunc } from './schema.js';
+import { jsonEachFunc, jsonTreeFunc } from './json-tvf.js';
+// Additional useful functions integrated from examples
+// Combine all built-in function definitions into a single array
+export const BUILTIN_FUNCTIONS = [
+    // Scalar Functions
+    absFunc,
+    roundFunc,
+    coalesceFunc,
+    nullifFunc,
+    typeofFunc,
+    randomFunc,
+    randomblobFunc,
+    iifFunc,
+    sqrtFunc,
+    powFunc,
+    powerFunc,
+    floorFunc,
+    ceilFunc,
+    ceilingFunc,
+    clampFunc,
+    greatestFunc,
+    leastFunc,
+    chooseFunc,
+    // String Functions
+    lowerFunc,
+    upperFunc,
+    lengthFunc,
+    substrFunc,
+    substringFunc,
+    likeFunc,
+    globFunc,
+    trimFunc,
+    ltrimFunc,
+    rtrimFunc,
+    replaceFunc,
+    instrFunc,
+    reverseFunc,
+    lpadFunc,
+    rpadFunc,
+    stringConcatFunc,
+    splitStringFunc,
+    // Aggregates
+    countStarFunc,
+    sumFunc,
+    avgFunc,
+    minFunc,
+    maxFunc,
+    countXFunc,
+    groupConcatFuncRev,
+    totalFunc,
+    varPopFunc,
+    varSampFunc,
+    stdDevPopFunc,
+    stdDevSampFunc,
+    // Date/Time Functions
+    dateFunc,
+    timeFunc,
+    datetimeFunc,
+    juliandayFunc,
+    strftimeFunc,
+    // JSON Functions
+    jsonValidFunc,
+    jsonTypeFunc,
+    jsonExtractFunc,
+    jsonQuoteFunc,
+    jsonArrayFunc,
+    jsonObjectFunc,
+    // JSON Manipulation
+    jsonInsertFunc,
+    jsonReplaceFunc,
+    jsonSetFunc,
+    jsonRemoveFunc,
+    // Additional JSON
+    jsonArrayLengthFunc,
+    jsonPatchFunc,
+    // JSON Aggregates
+    jsonGroupArrayFunc,
+    jsonGroupObjectFunc,
+    // Generation functions
+    generateSeriesFunc,
+    // Explain functions
+    queryPlanFunc,
+    schedulerProgramFunc,
+    stackTraceFunc,
+    executionTraceFunc,
+    rowTraceFunc,
+    // Schema introspection functions
+    schemaFunc,
+    tableInfoFunc,
+    functionInfoFunc,
+    // JSON table-valued functions
+    jsonEachFunc,
+    jsonTreeFunc,
+];
+// Export registration utilities for easy access
+export { createScalarFunction, createTableValuedFunction, createIntegratedTableValuedFunction as createDatabaseAwareTableValuedFunction, createAggregateFunction, } from '../registration.js';
+//# sourceMappingURL=index.js.map

package/dist/src/func/builtins/index.js.map

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

package/dist/src/func/builtins/json-helpers.d.ts

@@ -0,0 +1,64 @@
+import type { SqlValue } from '../../common/types.js';
+/**
+ * Safely parses a JSON string into a JavaScript value
+ *
+ * @param jsonString The string to parse as JSON
+ * @returns The parsed value or null if parsing failed
+ */
+export declare function safeJsonParse(jsonString: SqlValue): any | null;
+/**
+ * Parses a JSON path and returns information needed for modification
+ *
+ * Handles standard JSON path syntax ($, $.key, $[0], etc.) and optionally
+ * creates intermediate objects/arrays for operations like json_set.
+ *
+ * @param data The JSON data structure to traverse
+ * @param path The JSON path string
+ * @param createParents Whether to create missing intermediate objects/arrays
+ * @returns Path resolution information or null if the path is invalid
+ */
+export declare function resolveJsonPathForModify(data: any, path: string, createParents?: boolean): {
+    parent: any;
+    key: string | number;
+    value: any;
+    exists: boolean;
+} | null;
+/**
+ * Converts an SQL value to a JSON-compatible value for insertion or modification
+ *
+ * Handles type conversion for SQL types that don't directly map to JSON:
+ * - BigInt: Converts to number if in safe range, otherwise to string
+ * - Blob: Converts to null as blobs can't be represented in JSON
+ * - NaN/Infinity: Converts to null
+ * - JSON strings: Parses into actual objects/arrays
+ *
+ * @param value The SQL value to convert
+ * @returns A JSON-compatible value
+ */
+export declare function prepareJsonValue(value: SqlValue): any;
+/**
+ * Creates a deep copy of JSON-compatible data
+ *
+ * @param data The data to copy
+ * @returns A deep copy of the input data
+ */
+export declare function deepCopyJson(data: any): any;
+/**
+ * Determines the SQLite JSON type name for a JavaScript value
+ *
+ * @param value The value to check
+ * @returns The SQLite JSON type name ('null', 'true', 'false', 'integer', 'real', 'text', 'array', 'object')
+ */
+export declare function getJsonType(value: any): string;
+/**
+ * Evaluates a simple JSON path against data
+ *
+ * A simplified version of path evaluation that handles basic paths
+ * but doesn't support all features of resolveJsonPathForModify.
+ *
+ * @param data The JSON data to query
+ * @param path The path to evaluate
+ * @returns The value at the path or undefined if not found
+ */
+export declare function evaluateJsonPathBasic(data: any, path: string): any | undefined;
+//# sourceMappingURL=json-helpers.d.ts.map

package/dist/src/func/builtins/json-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-helpers.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/json-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,QAAQ,EAAE,MAAM,uBAAuB,CAAC;AAItD;;;;;GAKG;AACH,wBAAgB,aAAa,CAAC,UAAU,EAAE,QAAQ,GAAG,GAAG,GAAG,IAAI,CAS9D;AAED;;;;;;;;;;GAUG;AACH,wBAAgB,wBAAwB,CACvC,IAAI,EAAE,GAAG,EACT,IAAI,EAAE,MAAM,EACZ,aAAa,GAAE,OAAe,GAC5B;IAAE,MAAM,EAAE,GAAG,CAAC;IAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAAC;IAAC,KAAK,EAAE,GAAG,CAAC;IAAC,MAAM,EAAE,OAAO,CAAA;CAAE,GAAG,IAAI,CAqF3E;AAED;;;;;;;;;;;GAWG;AACH,wBAAgB,gBAAgB,CAAC,KAAK,EAAE,QAAQ,GAAG,GAAG,CAqBrD;AAED;;;;;GAKG;AACH,wBAAgB,YAAY,CAAC,IAAI,EAAE,GAAG,GAAG,GAAG,CAc3C;AAED;;;;;GAKG;AACH,wBAAgB,WAAW,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM,CAW9C;AAED;;;;;;;;;GASG;AACH,wBAAgB,qBAAqB,CAAC,IAAI,EAAE,GAAG,EAAE,IAAI,EAAE,MAAM,GAAG,GAAG,GAAG,SAAS,CA0B9E"}

package/dist/src/func/builtins/json-helpers.js

@@ -0,0 +1,237 @@
+import { createLogger } from '../../common/logger.js';
+const log = createLogger('func:builtins:json-helpers');
+/**
+ * Safely parses a JSON string into a JavaScript value
+ *
+ * @param jsonString The string to parse as JSON
+ * @returns The parsed value or null if parsing failed
+ */
+export function safeJsonParse(jsonString) {
+    if (typeof jsonString !== 'string') {
+        return null;
+    }
+    try {
+        return JSON.parse(jsonString);
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * Parses a JSON path and returns information needed for modification
+ *
+ * Handles standard JSON path syntax ($, $.key, $[0], etc.) and optionally
+ * creates intermediate objects/arrays for operations like json_set.
+ *
+ * @param data The JSON data structure to traverse
+ * @param path The JSON path string
+ * @param createParents Whether to create missing intermediate objects/arrays
+ * @returns Path resolution information or null if the path is invalid
+ */
+export function resolveJsonPathForModify(data, path, createParents = false) {
+    if (!path || typeof path !== 'string')
+        return null;
+    let current = data;
+    let parent = null;
+    let finalKey = null;
+    let remainingPath = path.startsWith('$') ? path.substring(1) : path;
+    if (remainingPath === '') {
+        return { parent: null, key: '', value: data, exists: true };
+    }
+    while (remainingPath.length > 0) {
+        parent = current;
+        finalKey = null;
+        if (current === undefined || current === null)
+            return null;
+        if (remainingPath.startsWith('.')) {
+            remainingPath = remainingPath.substring(1);
+            let keyStr;
+            if (remainingPath.startsWith('"')) {
+                const endQuote = remainingPath.indexOf('"', 1);
+                if (endQuote === -1)
+                    return null;
+                keyStr = remainingPath.substring(1, endQuote);
+                remainingPath = remainingPath.substring(endQuote + 1);
+            }
+            else {
+                const match = remainingPath.match(/^([^[.\\s]+)/);
+                if (!match)
+                    return null;
+                keyStr = match[1];
+                remainingPath = remainingPath.substring(keyStr.length);
+            }
+            if (typeof current !== 'object' || Array.isArray(current)) {
+                if (!createParents || typeof parent !== 'object' || parent === null || Array.isArray(parent) || typeof finalKey !== 'string') {
+                    return { parent, key: keyStr, value: undefined, exists: false };
+                }
+                log(`JSON Path: Creating intermediate object for key "%s"`, finalKey);
+                parent[finalKey] = {};
+                current = parent[finalKey];
+                parent = current;
+                finalKey = keyStr;
+                current = current[keyStr];
+            }
+            else {
+                finalKey = keyStr;
+                current = current[keyStr];
+            }
+        }
+        else if (remainingPath.startsWith('[')) {
+            const endBracket = remainingPath.indexOf(']');
+            if (endBracket === -1)
+                return null;
+            const indexStr = remainingPath.substring(1, endBracket).trim();
+            const index = parseInt(indexStr, 10);
+            remainingPath = remainingPath.substring(endBracket + 1);
+            if (!Number.isInteger(index) || index < 0)
+                return null;
+            if (!Array.isArray(current)) {
+                if (!createParents || parent === null || finalKey === null) {
+                    return { parent, key: index, value: undefined, exists: false };
+                }
+                const newParentArray = [];
+                if (Array.isArray(parent) && typeof finalKey === 'number') {
+                    log(`JSON Path: Creating intermediate array for index %d`, finalKey);
+                    parent[finalKey] = newParentArray;
+                }
+                else if (typeof parent === 'object' && !Array.isArray(parent) && typeof finalKey === 'string') {
+                    log(`JSON Path: Creating intermediate array for key "%s"`, finalKey);
+                    parent[finalKey] = newParentArray;
+                }
+                else {
+                    return { parent, key: index, value: undefined, exists: false };
+                }
+                current = newParentArray;
+                parent = current;
+                finalKey = index;
+                current = index < current.length ? current[index] : undefined;
+            }
+            else {
+                finalKey = index;
+                current = index < current.length ? current[index] : undefined;
+            }
+        }
+        else {
+            return null;
+        }
+    }
+    if (finalKey === null)
+        return null;
+    return { parent, key: finalKey, value: current, exists: current !== undefined };
+}
+/**
+ * Converts an SQL value to a JSON-compatible value for insertion or modification
+ *
+ * Handles type conversion for SQL types that don't directly map to JSON:
+ * - BigInt: Converts to number if in safe range, otherwise to string
+ * - Blob: Converts to null as blobs can't be represented in JSON
+ * - NaN/Infinity: Converts to null
+ * - JSON strings: Parses into actual objects/arrays
+ *
+ * @param value The SQL value to convert
+ * @returns A JSON-compatible value
+ */
+export function prepareJsonValue(value) {
+    if (typeof value === 'bigint') {
+        if (value >= Number.MIN_SAFE_INTEGER && value <= Number.MAX_SAFE_INTEGER) {
+            return Number(value);
+        }
+        return value.toString();
+    }
+    if (value instanceof Uint8Array) {
+        return null;
+    }
+    if (typeof value === 'number' && !Number.isFinite(value)) {
+        return null;
+    }
+    if (typeof value === 'string') {
+        try {
+            return JSON.parse(value);
+        }
+        catch {
+            return value;
+        }
+    }
+    return value;
+}
+/**
+ * Creates a deep copy of JSON-compatible data
+ *
+ * @param data The data to copy
+ * @returns A deep copy of the input data
+ */
+export function deepCopyJson(data) {
+    if (data === null || typeof data !== 'object') {
+        return data;
+    }
+    if (Array.isArray(data)) {
+        return data.map(deepCopyJson);
+    }
+    const copy = {};
+    for (const key in data) {
+        if (Object.prototype.hasOwnProperty.call(data, key)) {
+            copy[key] = deepCopyJson(data[key]);
+        }
+    }
+    return copy;
+}
+/**
+ * Determines the SQLite JSON type name for a JavaScript value
+ *
+ * @param value The value to check
+ * @returns The SQLite JSON type name ('null', 'true', 'false', 'integer', 'real', 'text', 'array', 'object')
+ */
+export function getJsonType(value) {
+    if (value === null)
+        return 'null';
+    switch (typeof value) {
+        case 'boolean': return value ? 'true' : 'false';
+        case 'number': return Number.isInteger(value) ? 'integer' : 'real';
+        case 'string': return 'text';
+        case 'object':
+            if (Array.isArray(value))
+                return 'array';
+            return 'object';
+        default: return 'null';
+    }
+}
+/**
+ * Evaluates a simple JSON path against data
+ *
+ * A simplified version of path evaluation that handles basic paths
+ * but doesn't support all features of resolveJsonPathForModify.
+ *
+ * @param data The JSON data to query
+ * @param path The path to evaluate
+ * @returns The value at the path or undefined if not found
+ */
+export function evaluateJsonPathBasic(data, path) {
+    if (!path || path === '$')
+        return data;
+    const parts = path.startsWith('$.') ? path.substring(2).split('.') :
+        path.startsWith('$') ? path.substring(1).split('.') :
+            path.split('.');
+    let current = data;
+    for (const part of parts) {
+        if (current === null || current === undefined)
+            return undefined;
+        const arrayMatch = part.match(/^\s*\[(\d+)\]\s*$/);
+        if (arrayMatch) {
+            const index = parseInt(arrayMatch[1], 10);
+            if (Array.isArray(current) && index >= 0 && index < current.length) {
+                current = current[index];
+            }
+            else {
+                return undefined;
+            }
+        }
+        else if (typeof current === 'object' && current !== null && Object.prototype.hasOwnProperty.call(current, part)) {
+            current = current[part];
+        }
+        else {
+            return undefined;
+        }
+    }
+    return current;
+}
+//# sourceMappingURL=json-helpers.js.map

package/dist/src/func/builtins/json-helpers.js.map

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

package/dist/src/func/builtins/json-tvf.d.ts

@@ -0,0 +1,3 @@
+export declare const jsonEachFunc: import("../../schema/function.js").TableValuedFunctionSchema;
+export declare const jsonTreeFunc: import("../../schema/function.js").TableValuedFunctionSchema;
+//# sourceMappingURL=json-tvf.d.ts.map

package/dist/src/func/builtins/json-tvf.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"json-tvf.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/json-tvf.ts"],"names":[],"mappings":"AAUA,eAAO,MAAM,YAAY,8DAmGxB,CAAC;AAGF,eAAO,MAAM,YAAY,8DAgHxB,CAAC"}