@quereus/quereus 0.1.0

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

@@ -0,0 +1,199 @@
+import { SqlDataType } from "../../common/types.js";
+import { createTableValuedFunction } from "../registration.js";
+import { QuereusError } from "../../common/errors.js";
+import { StatusCode } from "../../common/types.js";
+import { safeJsonParse, evaluateJsonPathBasic, getJsonType } from "./json-helpers.js";
+import { jsonStringify } from "../../util/serialization.js";
+// JSON Each table-valued function
+export const jsonEachFunc = createTableValuedFunction({
+    name: 'json_each',
+    numArgs: -1, // Variable arguments (1 or 2)
+    deterministic: true,
+    returnType: {
+        typeClass: 'relation',
+        isReadOnly: true,
+        isSet: false,
+        columns: [
+            { name: 'key', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'value', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'type', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: false, isReadOnly: true }, generated: true },
+            { name: 'atom', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'id', type: { typeClass: 'scalar', affinity: SqlDataType.INTEGER, nullable: false, isReadOnly: true }, generated: true },
+            { name: 'parent', type: { typeClass: 'scalar', affinity: SqlDataType.INTEGER, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'fullkey', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: false, isReadOnly: true }, generated: true },
+            { name: 'path', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: false, isReadOnly: true }, generated: true }
+        ],
+        keys: [],
+        rowConstraints: []
+    }
+}, async function* (jsonText, rootPath) {
+    if (typeof jsonText !== 'string') {
+        throw new QuereusError('json_each() requires a JSON string as first argument', StatusCode.ERROR);
+    }
+    const parsedJson = safeJsonParse(jsonText);
+    if (parsedJson === null && typeof jsonText === 'string') {
+        throw new QuereusError('Invalid JSON provided to json_each', StatusCode.ERROR);
+    }
+    const rootPathStr = (typeof rootPath === 'string' && rootPath) ? rootPath : null;
+    let startNode = parsedJson;
+    if (rootPathStr) {
+        startNode = evaluateJsonPathBasic(startNode, rootPathStr);
+    }
+    const localStack = [];
+    let localElementIdCounter = 0;
+    if (startNode !== undefined) {
+        localStack.push({
+            value: startNode,
+            parentPath: '',
+            parentKey: null,
+            parentId: 0,
+        });
+    }
+    while (localStack.length > 0) {
+        const currentState = localStack[localStack.length - 1];
+        localStack.pop();
+        const currentValue = currentState.value;
+        const key = currentState.parentKey;
+        const id = localElementIdCounter++;
+        const path = currentState.parentPath;
+        const fullkey = key !== null ? `${path}${typeof key === 'number' ? `[${key}]` : `.${key}`}` : path;
+        const type = getJsonType(currentValue);
+        const atom = (type === 'object' || type === 'array') ? null : currentValue;
+        const valueForColumn = (type === 'object' || type === 'array') ? jsonStringify(currentValue) : currentValue;
+        const row = [
+            key,
+            valueForColumn,
+            type,
+            atom,
+            id,
+            currentState.parentId,
+            fullkey,
+            path
+        ];
+        if (Array.isArray(currentValue)) {
+            for (let i = currentValue.length - 1; i >= 0; i--) {
+                localStack.push({
+                    value: currentValue[i],
+                    parentPath: fullkey,
+                    parentKey: i,
+                    parentId: id,
+                });
+            }
+        }
+        else if (typeof currentValue === 'object' && currentValue !== null) {
+            const keys = Object.keys(currentValue).sort().reverse();
+            for (const objKey of keys) {
+                localStack.push({
+                    value: currentValue[objKey],
+                    parentPath: fullkey,
+                    parentKey: objKey,
+                    parentId: id,
+                });
+            }
+        }
+        yield row;
+    }
+});
+// JSON Tree table-valued function
+export const jsonTreeFunc = createTableValuedFunction({
+    name: 'json_tree',
+    numArgs: -1, // Variable arguments (1 or 2)
+    deterministic: true,
+    returnType: {
+        typeClass: 'relation',
+        isReadOnly: true,
+        isSet: false,
+        columns: [
+            { name: 'key', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'value', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'type', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: false, isReadOnly: true }, generated: true },
+            { name: 'atom', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'id', type: { typeClass: 'scalar', affinity: SqlDataType.INTEGER, nullable: false, isReadOnly: true }, generated: true },
+            { name: 'parent', type: { typeClass: 'scalar', affinity: SqlDataType.INTEGER, nullable: true, isReadOnly: true }, generated: true },
+            { name: 'fullkey', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: false, isReadOnly: true }, generated: true },
+            { name: 'path', type: { typeClass: 'scalar', affinity: SqlDataType.TEXT, nullable: false, isReadOnly: true }, generated: true }
+        ],
+        keys: [],
+        rowConstraints: []
+    }
+}, async function* (jsonText, rootPath) {
+    if (typeof jsonText !== 'string') {
+        throw new QuereusError('json_tree() requires a JSON string as first argument', StatusCode.ERROR);
+    }
+    const parsedJson = safeJsonParse(jsonText);
+    if (parsedJson === null && typeof jsonText === 'string') {
+        throw new QuereusError('Invalid JSON provided to json_tree', StatusCode.ERROR);
+    }
+    const rootPathStr = (typeof rootPath === 'string' && rootPath) ? rootPath : null;
+    let startNode = parsedJson;
+    if (rootPathStr) {
+        startNode = evaluateJsonPathBasic(startNode, rootPathStr);
+    }
+    const localStack = [];
+    let localElementIdCounter = 0;
+    if (startNode !== undefined) {
+        localStack.push({
+            value: startNode,
+            parentPath: '',
+            parentKey: null,
+            parentId: 0,
+            childrenPushed: false,
+        });
+    }
+    while (localStack.length > 0) {
+        const state = localStack[localStack.length - 1];
+        const value = state.value;
+        const isContainer = typeof value === 'object' && value !== null;
+        if (!state.childrenPushed) {
+            const key = state.parentKey;
+            const id = ++localElementIdCounter;
+            const path = state.parentPath;
+            const fullkey = key !== null ? `${path}${typeof key === 'number' ? `[${key}]` : `.${key}`}` : path;
+            const type = getJsonType(value);
+            const atom = !isContainer ? value : null;
+            const valueForColumn = isContainer ? jsonStringify(value) : value;
+            const row = [
+                key,
+                valueForColumn,
+                type,
+                atom,
+                id,
+                state.parentId,
+                fullkey,
+                path
+            ];
+            state.childrenPushed = true;
+            yield row;
+            if (isContainer) {
+                const parentIdForRow = id;
+                const parentFullKeyForRow = fullkey;
+                if (Array.isArray(value)) {
+                    for (let i = value.length - 1; i >= 0; i--) {
+                        localStack.push({
+                            value: value[i],
+                            parentPath: parentFullKeyForRow,
+                            parentKey: i,
+                            parentId: parentIdForRow,
+                            childrenPushed: false,
+                        });
+                    }
+                }
+                else {
+                    const keys = Object.keys(value).sort().reverse();
+                    for (const objKey of keys) {
+                        localStack.push({
+                            value: value[objKey],
+                            parentPath: parentFullKeyForRow,
+                            parentKey: objKey,
+                            parentId: parentIdForRow,
+                            childrenPushed: false,
+                        });
+                    }
+                }
+                continue;
+            }
+        }
+        localStack.pop();
+    }
+});
+//# sourceMappingURL=json-tvf.js.map

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

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

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

@@ -0,0 +1,15 @@
+export declare const jsonValidFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonTypeFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonExtractFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonQuoteFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonArrayFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonObjectFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonArrayLengthFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonPatchFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonInsertFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonReplaceFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonSetFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonRemoveFunc: import("../../schema/function.js").ScalarFunctionSchema;
+export declare const jsonGroupArrayFunc: import("../../schema/function.js").AggregateFunctionSchema;
+export declare const jsonGroupObjectFunc: import("../../schema/function.js").AggregateFunctionSchema;
+//# sourceMappingURL=json.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"json.d.ts","sourceRoot":"","sources":["../../../../src/func/builtins/json.ts"],"names":[],"mappings":"AAeA,eAAO,MAAM,aAAa,yDAKzB,CAAC;AAGF,eAAO,MAAM,YAAY,yDAgBxB,CAAC;AAGF,eAAO,MAAM,eAAe,yDA+C3B,CAAC;AAGF,eAAO,MAAM,aAAa,yDAgCzB,CAAC;AAGF,eAAO,MAAM,aAAa,yDAWzB,CAAC;AAGF,eAAO,MAAM,cAAc,yDAwB1B,CAAC;AAKF,eAAO,MAAM,mBAAmB,yDAsB/B,CAAC;AAGF,eAAO,MAAM,aAAa,yDA2BzB,CAAC;AAKF,eAAO,MAAM,cAAc,yDA+C1B,CAAC;AAGF,eAAO,MAAM,eAAe,yDA4C3B,CAAC;AAGF,eAAO,MAAM,WAAW,yDAsDvB,CAAC;AAGF,eAAO,MAAM,cAAc,yDAuC1B,CAAC;AAKF,eAAO,MAAM,kBAAkB,4DAgB9B,CAAC;AAGF,eAAO,MAAM,mBAAmB,4DAqB/B,CAAC"}

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

@@ -0,0 +1,417 @@
+import fastJsonPatch from 'fast-json-patch';
+const { applyPatch } = fastJsonPatch;
+import { createLogger } from '../../common/logger.js';
+import { createScalarFunction, createAggregateFunction } from '../registration.js';
+import { safeJsonParse, resolveJsonPathForModify, prepareJsonValue, deepCopyJson, getJsonType } from './json-helpers.js';
+const log = createLogger('func:builtins:json');
+const errorLog = log.extend('error');
+// --- JSON Functions --- //
+// json_valid(X)
+export const jsonValidFunc = createScalarFunction({ name: 'json_valid', numArgs: 1, deterministic: true }, (json) => {
+    return safeJsonParse(json) !== null ? 1 : 0;
+});
+// json_type(X, P?)
+export const jsonTypeFunc = createScalarFunction({ name: 'json_type', numArgs: -1, deterministic: true }, (json, path) => {
+    const data = safeJsonParse(json);
+    if (data === null && typeof json === 'string')
+        return null; // Invalid JSON input
+    let targetValue = data;
+    if (path !== undefined && path !== null) {
+        if (typeof path !== 'string')
+            return 'null'; // Invalid path
+        const resolved = resolveJsonPathForModify(data, path);
+        targetValue = resolved?.exists ? resolved.value : undefined;
+        // If path evaluation leads nowhere, SQLite returns NULL type
+        if (targetValue === undefined)
+            return null;
+    }
+    return getJsonType(targetValue);
+});
+// json_extract(X, P1, P2, ...)
+export const jsonExtractFunc = createScalarFunction({ name: 'json_extract', numArgs: -1, deterministic: true }, (json, ...paths) => {
+    const data = safeJsonParse(json);
+    if (data === null && typeof json === 'string')
+        return null; // Return NULL if JSON is invalid
+    if (paths.length === 0)
+        return null; // No paths provided
+    // SQLite json_extract: Find the first path that resolves
+    let extractedValue = undefined;
+    for (const pathVal of paths) {
+        if (typeof pathVal === 'string') {
+            const resolved = resolveJsonPathForModify(data, pathVal);
+            extractedValue = resolved?.exists ? resolved.value : undefined;
+            // Stop at the first path that successfully extracts a value (even if null)
+            if (extractedValue !== undefined) {
+                break;
+            }
+        }
+        else {
+            // Invalid path type itself results in overall NULL
+            return null;
+        }
+    }
+    // Map the extracted JS value to the corresponding SQL type
+    if (extractedValue === undefined) {
+        return null; // Path did not resolve
+    }
+    else if (extractedValue === null) {
+        return null;
+    }
+    else if (typeof extractedValue === 'boolean') {
+        return extractedValue ? 1 : 0;
+    }
+    else if (typeof extractedValue === 'number') {
+        return extractedValue; // Return as INTEGER or REAL
+    }
+    else if (typeof extractedValue === 'string') {
+        return extractedValue;
+    }
+    else if (typeof extractedValue === 'object') {
+        // Return arrays/objects as JSON strings
+        try {
+            return JSON.stringify(extractedValue);
+        }
+        catch {
+            return null; // Should not happen for valid extracted JSON parts
+        }
+    }
+    else {
+        // Should not happen for valid JSON (e.g., bigint, symbol, function)
+        return null;
+    }
+});
+// json_quote(X)
+export const jsonQuoteFunc = createScalarFunction({ name: 'json_quote', numArgs: 1, deterministic: true }, (value) => {
+    if (value === null)
+        return 'null';
+    switch (typeof value) {
+        case 'number':
+            if (!Number.isFinite(value))
+                return 'null'; // JSON doesn't support Infinity/NaN
+            return String(value);
+        case 'boolean':
+            return value ? 'true' : 'false';
+        case 'string':
+            return JSON.stringify(value); // Correctly escapes the string
+        case 'bigint':
+            // BigInts are not directly representable in standard JSON
+            return null;
+        case 'object':
+            if (value instanceof Uint8Array) {
+                // BLOBs cannot be represented in JSON
+                return null;
+            }
+            else if (Array.isArray(value) || (value !== null && typeof value === 'object')) {
+                // Handle arrays and plain objects by converting to JSON string
+                try {
+                    return JSON.stringify(value);
+                }
+                catch {
+                    return null;
+                }
+            }
+            return null;
+        default:
+            return null;
+    }
+});
+// json_array(X, Y, ...)
+export const jsonArrayFunc = createScalarFunction({ name: 'json_array', numArgs: -1, deterministic: true }, (...args) => {
+    // Values need to be converted to valid JSON representations before stringifying
+    const jsonCompatibleArgs = args.map(arg => prepareJsonValue(arg)); // Use helper
+    try {
+        return JSON.stringify(jsonCompatibleArgs);
+    }
+    catch {
+        return null; // Should not happen with basic types
+    }
+});
+// json_object(N1, V1, N2, V2, ...)
+export const jsonObjectFunc = createScalarFunction({ name: 'json_object', numArgs: -1, deterministic: true }, (...args) => {
+    if (args.length % 2 !== 0) {
+        // SQLite json_object returns NULL if odd number of args
+        return null;
+    }
+    const obj = {};
+    for (let i = 0; i < args.length; i += 2) {
+        const key = args[i];
+        const value = args[i + 1];
+        if (typeof key !== 'string') {
+            // SQLite requires keys to be strings
+            return null;
+        }
+        // Convert value to JSON compatible using helper
+        obj[key] = prepareJsonValue(value);
+    }
+    try {
+        return JSON.stringify(obj);
+    }
+    catch {
+        return null;
+    }
+});
+// --- Additional JSON Functions --- //
+// json_array_length(json, path?)
+export const jsonArrayLengthFunc = createScalarFunction({ name: 'json_array_length', numArgs: -1, deterministic: true }, (json, path) => {
+    const data = safeJsonParse(json);
+    if (data === null && typeof json === 'string')
+        return null;
+    let targetValue = data;
+    if (path !== undefined && path !== null) {
+        if (typeof path !== 'string')
+            return 0; // Invalid path -> 0 length
+        const resolved = resolveJsonPathForModify(data, path);
+        targetValue = resolved?.exists ? resolved.value : undefined;
+    }
+    if (Array.isArray(targetValue)) {
+        return targetValue.length;
+    }
+    else {
+        // If the target exists but is not an array, SQLite returns 0
+        // If the path doesn't resolve (targetValue is undefined), return 0?
+        // Let's return 0 if not an array, consistent with SQLite.
+        return 0;
+    }
+});
+// json_patch(json, patch)
+export const jsonPatchFunc = createScalarFunction({ name: 'json_patch', numArgs: 2, deterministic: false }, // Not deterministic as patch content varies
+(json, patchVal) => {
+    const data = safeJsonParse(json);
+    // JSON Patches must be JSON arrays
+    const patchData = safeJsonParse(patchVal);
+    if (data === null && typeof json === 'string')
+        return null; // Invalid target JSON
+    if (!Array.isArray(patchData))
+        return null; // Invalid patch JSON (must be array)
+    // Ensure patch operations have the correct structure (basic check)
+    const patch = patchData;
+    if (!patch.every(op => typeof op === 'object' && op !== null && 'op' in op && 'path' in op)) {
+        return null; // Invalid operation structure
+    }
+    try {
+        // fast-json-patch might throw on invalid patch operations or test failures
+        // applyPatch mutates by default, but since `data` is freshly parsed, it's okay.
+        // If data came from elsewhere, we might need deepCopyJson first.
+        const result = applyPatch(data, patch, true /* validate operations */).newDocument;
+        return JSON.stringify(result);
+    }
+    catch (e) {
+        errorLog('json_patch failed: %s, %O', e?.message, e);
+        return null; // Return NULL on patch failure
+    }
+});
+// --- Manipulation Functions --- //
+// json_insert(JSON, PATH, VALUE, PATH, VALUE, ...)
+export const jsonInsertFunc = createScalarFunction({ name: 'json_insert', numArgs: -1, deterministic: true }, (json, ...args) => {
+    const data = safeJsonParse(json);
+    if (data === null && typeof json === 'string')
+        return null; // Invalid JSON input
+    if (args.length === 0 || args.length % 2 !== 0)
+        return null; // Need path/value pairs
+    // Work on a copy
+    const currentData = deepCopyJson(data);
+    for (let i = 0; i < args.length; i += 2) {
+        const pathVal = args[i];
+        const valueVal = args[i + 1];
+        if (typeof pathVal !== 'string')
+            return null; // Path must be string
+        const preparedValue = prepareJsonValue(valueVal);
+        const pathInfo = resolveJsonPathForModify(currentData, pathVal);
+        if (pathInfo === null)
+            continue; // Ignore invalid paths
+        const { parent, key, exists } = pathInfo;
+        if (!exists) {
+            if (parent === null)
+                continue; // Cannot insert at root if it doesn't exist (shouldn't happen)
+            if (Array.isArray(parent) && typeof key === 'number') {
+                if (key === parent.length) {
+                    parent.push(preparedValue);
+                }
+                else if (key < parent.length) {
+                    parent.splice(key, 0, preparedValue); // Insert *before* existing element
+                }
+                // Ignore if key > parent.length?
+            }
+            else if (typeof parent === 'object' && typeof key === 'string') {
+                parent[key] = preparedValue;
+            }
+            // else: Cannot insert into non-container or invalid key type - ignore
+        }
+        // If path *does* exist, json_insert does nothing.
+    }
+    try {
+        return JSON.stringify(currentData);
+    }
+    catch {
+        return null;
+    }
+});
+// json_replace(JSON, PATH, VALUE, PATH, VALUE, ...)
+export const jsonReplaceFunc = createScalarFunction({ name: 'json_replace', numArgs: -1, deterministic: true }, (json, ...args) => {
+    const data = safeJsonParse(json);
+    if (data === null && typeof json === 'string')
+        return null;
+    if (args.length === 0 || args.length % 2 !== 0)
+        return null;
+    let currentData = deepCopyJson(data);
+    for (let i = 0; i < args.length; i += 2) {
+        const pathVal = args[i];
+        const valueVal = args[i + 1];
+        if (typeof pathVal !== 'string')
+            return null;
+        const preparedValue = prepareJsonValue(valueVal);
+        const pathInfo = resolveJsonPathForModify(currentData, pathVal);
+        if (pathInfo === null)
+            continue; // Ignore invalid paths
+        const { parent, key, exists } = pathInfo;
+        if (exists) {
+            if (parent === null && key === '') {
+                // Replace the root value
+                currentData = preparedValue;
+            }
+            else if (parent !== null && typeof key === 'string' && typeof parent === 'object' && !Array.isArray(parent)) {
+                parent[key] = preparedValue;
+            }
+            else if (parent !== null && typeof key === 'number' && Array.isArray(parent)) {
+                if (key >= 0 && key < parent.length) {
+                    parent[key] = preparedValue;
+                }
+            }
+            // else: Cannot replace non-existent or invalid path - ignore
+        }
+        // If path does *not* exist, json_replace does nothing.
+    }
+    try {
+        return JSON.stringify(currentData);
+    }
+    catch {
+        return null;
+    }
+});
+// json_set(JSON, PATH, VALUE, PATH, VALUE, ...)
+export const jsonSetFunc = createScalarFunction({ name: 'json_set', numArgs: -1, deterministic: true }, (json, ...args) => {
+    const data = safeJsonParse(json);
+    if (data === null && typeof json === 'string')
+        return null;
+    if (args.length === 0 || args.length % 2 !== 0)
+        return null;
+    let currentData = deepCopyJson(data);
+    for (let i = 0; i < args.length; i += 2) {
+        const pathVal = args[i];
+        const valueVal = args[i + 1];
+        if (typeof pathVal !== 'string')
+            return null;
+        const preparedValue = prepareJsonValue(valueVal);
+        // Pass createParents = true to enable intermediate creation
+        const pathInfo = resolveJsonPathForModify(currentData, pathVal, true);
+        if (pathInfo === null)
+            continue; // Ignore invalid paths
+        const { parent, key } = pathInfo;
+        if (parent === null && key === '') {
+            // Set the root value
+            currentData = preparedValue;
+        }
+        else if (parent !== null) {
+            if (typeof parent === 'object' && !Array.isArray(parent) && typeof key === 'string') {
+                parent[key] = preparedValue; // Set object property (create or replace)
+            }
+            else if (Array.isArray(parent) && typeof key === 'number') {
+                if (key >= 0 && key < parent.length) {
+                    parent[key] = preparedValue; // Replace existing array element
+                }
+                else if (key === parent.length) {
+                    parent.push(preparedValue); // Append to array
+                }
+                else if (key > parent.length) {
+                    // Pad array with nulls and append (SQLite behavior)
+                    while (parent.length < key) {
+                        parent.push(null);
+                    }
+                    parent.push(preparedValue);
+                }
+                // Ignore negative index?
+            }
+            // NOTE: This implementation does *not* create intermediate objects/arrays
+            // if the parent itself doesn't exist. A full json_set would need recursion here.
+        }
+    }
+    try {
+        return JSON.stringify(currentData);
+    }
+    catch {
+        return null;
+    }
+});
+// json_remove(JSON, PATH, PATH, ...)
+export const jsonRemoveFunc = createScalarFunction({ name: 'json_remove', numArgs: -1, deterministic: true }, (json, ...paths) => {
+    const data = safeJsonParse(json);
+    if (data === null && typeof json === 'string')
+        return null; // Invalid JSON input
+    if (paths.length === 0)
+        return JSON.stringify(data); // No paths means no change
+    const currentData = deepCopyJson(data);
+    for (const pathVal of paths) {
+        if (typeof pathVal !== 'string')
+            return null; // Path must be string
+        const pathInfo = resolveJsonPathForModify(currentData, pathVal);
+        if (pathInfo === null || !pathInfo.exists || pathInfo.parent === null) {
+            // Invalid path, path doesn't exist, or trying to remove root - ignore
+            continue;
+        }
+        const { parent, key } = pathInfo;
+        if (Array.isArray(parent) && typeof key === 'number') {
+            if (key >= 0 && key < parent.length) {
+                parent.splice(key, 1); // Remove array element
+            }
+        }
+        else if (typeof parent === 'object' && typeof key === 'string') {
+            if (Object.prototype.hasOwnProperty.call(parent, key)) {
+                delete parent[key]; // Remove object property
+            }
+        }
+        // else: Cannot remove from non-container or invalid key type - ignore
+    }
+    try {
+        return JSON.stringify(currentData);
+    }
+    catch {
+        return null;
+    }
+});
+// --- Aggregate Functions --- //
+// json_group_array(value)
+export const jsonGroupArrayFunc = createAggregateFunction({ name: 'json_group_array', numArgs: 1, initialValue: [] }, (acc, value) => {
+    // SQLite's json_group_array includes NULLs, unlike json_array function
+    const preparedValue = prepareJsonValue(value);
+    acc.push(preparedValue);
+    return acc;
+}, (acc) => {
+    try {
+        // Returns NULL if the group is empty, otherwise the JSON array string
+        return acc.length > 0 ? JSON.stringify(acc) : null;
+    }
+    catch {
+        return null;
+    }
+});
+// json_group_object(name, value)
+export const jsonGroupObjectFunc = createAggregateFunction({ name: 'json_group_object', numArgs: 2, initialValue: {} }, (acc, name, value) => {
+    if (name === null || name === undefined) {
+        return acc; // Skip if name is NULL/undefined
+    }
+    // Convert the name to a string key - SQLite converts non-string keys to strings
+    const stringKey = String(name);
+    // SQLite's json_group_object includes NULL values associated with keys
+    const preparedValue = prepareJsonValue(value);
+    acc[stringKey] = preparedValue;
+    return acc;
+}, (acc) => {
+    try {
+        // Returns NULL if the group is empty, otherwise the JSON object string
+        return Object.keys(acc).length > 0 ? JSON.stringify(acc) : null;
+    }
+    catch {
+        return null;
+    }
+});
+//# sourceMappingURL=json.js.map