quiverdb 0.5.0 → 0.6.0

package/README.md

@@ -1,29 +1,29 @@
 # quiverdb
 
-Bun-native SQLite wrapper binding for Quiver via bun:ffi.
+SQLite wrapper binding for Quiver via koffi FFI. Works with Node.js, Deno, and Bun.
 
 ## Requirements
 
-- Bun >= 1.0.0
-- `libquiver.dll` and `libquiver_c.dll` in system PATH
+- Node.js >= 20, Deno >= 2.0, or Bun >= 1.0
+- `libquiver.dll` and `libquiver_c.dll` (or `.so`/`.dylib`) in system PATH
 
 ## Installation
 
 ```bash
-bun add quiverdb
+npm install quiverdb
 ```
 
-The native Quiver DLLs must be compiled separately and available in your system PATH. See the Quiver project build instructions for details.
+The native Quiver libraries must be compiled separately and available in your system PATH. See the Quiver project build instructions for details.
 
-## DLL Setup
+## Native Library Setup
 
-This binding loads the Quiver C API library (`libquiver_c.dll`) at runtime via `bun:ffi`. The core library (`libquiver.dll`) is a dependency that must also be loadable.
+This binding loads the Quiver C API library (`libquiver_c`) at runtime via koffi. The core library (`libquiver`) is a dependency that must also be loadable.
 
-Options for making the DLLs available:
+Options for making the libraries available:
 
 1. Add the `build/bin/` directory to your system PATH
-2. Copy both DLLs to a directory already in PATH
-3. Place both DLLs alongside your application entry point
+2. Copy both libraries to a directory already in PATH
+3. Place both libraries alongside your application entry point
 
 ## Quick Start
 

package/dist/composites.d.ts

@@ -0,0 +1,9 @@
+declare module "./database.js" {
+    interface Database {
+        readScalarsById(collection: string, id: number): Record<string, number | string | null>;
+        readVectorsById(collection: string, id: number): Record<string, number[] | string[]>;
+        readSetsById(collection: string, id: number): Record<string, number[] | string[]>;
+    }
+}
+export {};
+//# sourceMappingURL=composites.d.ts.map

package/dist/composites.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"composites.d.ts","sourceRoot":"","sources":["../src/composites.ts"],"names":[],"mappings":"AAEA,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,QAAQ;QAChB,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,MAAM,GAAG,IAAI,CAAC,CAAC;QACxF,eAAe,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;QACrF,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,MAAM,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,MAAM,EAAE,CAAC,CAAC;KACnF;CACF"}

package/dist/composites.js

@@ -0,0 +1,69 @@
+import { Database } from "./database.js";
+Database.prototype.readScalarsById = function (collection, id) {
+    const attributes = this.listScalarAttributes(collection);
+    const result = {};
+    for (const attr of attributes) {
+        switch (attr.dataType) {
+            case 0: // INTEGER
+                result[attr.name] = this.readScalarIntegerById(collection, attr.name, id);
+                break;
+            case 1: // FLOAT
+                result[attr.name] = this.readScalarFloatById(collection, attr.name, id);
+                break;
+            case 2: // STRING
+            case 3: // DATE_TIME
+                result[attr.name] = this.readScalarStringById(collection, attr.name, id);
+                break;
+            default:
+                throw new Error(`Unknown data type ${attr.dataType} for attribute '${attr.name}'`);
+        }
+    }
+    return result;
+};
+Database.prototype.readVectorsById = function (collection, id) {
+    const groups = this.listVectorGroups(collection);
+    const result = {};
+    for (const group of groups) {
+        for (const col of group.valueColumns) {
+            switch (col.dataType) {
+                case 0: // INTEGER
+                    result[col.name] = this.readVectorIntegersById(collection, col.name, id);
+                    break;
+                case 1: // FLOAT
+                    result[col.name] = this.readVectorFloatsById(collection, col.name, id);
+                    break;
+                case 2: // STRING
+                case 3: // DATE_TIME
+                    result[col.name] = this.readVectorStringsById(collection, col.name, id);
+                    break;
+                default:
+                    throw new Error(`Unknown data type ${col.dataType} for column '${col.name}'`);
+            }
+        }
+    }
+    return result;
+};
+Database.prototype.readSetsById = function (collection, id) {
+    const groups = this.listSetGroups(collection);
+    const result = {};
+    for (const group of groups) {
+        for (const col of group.valueColumns) {
+            switch (col.dataType) {
+                case 0: // INTEGER
+                    result[col.name] = this.readSetIntegersById(collection, col.name, id);
+                    break;
+                case 1: // FLOAT
+                    result[col.name] = this.readSetFloatsById(collection, col.name, id);
+                    break;
+                case 2: // STRING
+                case 3: // DATE_TIME
+                    result[col.name] = this.readSetStringsById(collection, col.name, id);
+                    break;
+                default:
+                    throw new Error(`Unknown data type ${col.dataType} for column '${col.name}'`);
+            }
+        }
+    }
+    return result;
+};
+//# sourceMappingURL=composites.js.map

package/dist/composites.js.map

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

package/dist/create.d.ts

@@ -0,0 +1,9 @@
+import type { ElementData } from "./types.js";
+declare module "./database.js" {
+    interface Database {
+        createElement(collection: string, data: ElementData): number;
+        updateElement(collection: string, id: number, data: ElementData): void;
+        deleteElement(collection: string, id: number): void;
+    }
+}
+//# sourceMappingURL=create.d.ts.map

package/dist/create.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create.d.ts","sourceRoot":"","sources":["../src/create.ts"],"names":[],"mappings":"AAIA,OAAO,KAAK,EAAE,WAAW,EAAS,MAAM,YAAY,CAAC;AAErD,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,QAAQ;QAChB,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,MAAM,CAAC;QAC7D,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,EAAE,IAAI,EAAE,WAAW,GAAG,IAAI,CAAC;QACvE,aAAa,CAAC,UAAU,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,IAAI,CAAC;KACrD;CACF"}

package/dist/create.js

@@ -0,0 +1,104 @@
+import { Database } from "./database.js";
+import { check, QuiverError } from "./errors.js";
+import { allocPtrOut, readPtrOut } from "./ffi-helpers.js";
+import { getSymbols } from "./loader.js";
+function setElementArray(lib, elemPtr, name, values) {
+    if (values.length === 0) {
+        check(lib.quiver_element_set_array_integer(elemPtr, name, null, 0));
+        return;
+    }
+    const first = values[0];
+    if (typeof first === "bigint") {
+        const arr = BigInt64Array.from(values, (v) => BigInt(v));
+        check(lib.quiver_element_set_array_integer(elemPtr, name, arr, values.length));
+        return;
+    }
+    if (typeof first === "number") {
+        const allIntegers = values.every((v) => Number.isInteger(v));
+        if (allIntegers) {
+            const arr = BigInt64Array.from(values, (v) => BigInt(v));
+            check(lib.quiver_element_set_array_integer(elemPtr, name, arr, values.length));
+        }
+        else {
+            const arr = Float64Array.from(values);
+            check(lib.quiver_element_set_array_float(elemPtr, name, arr, values.length));
+        }
+        return;
+    }
+    if (typeof first === "string") {
+        check(lib.quiver_element_set_array_string(elemPtr, name, values, values.length));
+        return;
+    }
+    throw new QuiverError(`Unsupported array element type for '${name}': ${typeof first}`);
+}
+function setElementField(lib, elemPtr, name, value) {
+    if (value === null) {
+        check(lib.quiver_element_set_null(elemPtr, name));
+        return;
+    }
+    if (typeof value === "bigint") {
+        check(lib.quiver_element_set_integer(elemPtr, name, value));
+        return;
+    }
+    if (typeof value === "number") {
+        if (Number.isInteger(value)) {
+            check(lib.quiver_element_set_integer(elemPtr, name, value));
+        }
+        else {
+            check(lib.quiver_element_set_float(elemPtr, name, value));
+        }
+        return;
+    }
+    if (typeof value === "string") {
+        check(lib.quiver_element_set_string(elemPtr, name, value));
+        return;
+    }
+    if (Array.isArray(value)) {
+        setElementArray(lib, elemPtr, name, value);
+        return;
+    }
+    throw new QuiverError(`Unsupported value type for '${name}': ${typeof value}`);
+}
+Database.prototype.createElement = function (collection, data) {
+    const lib = getSymbols();
+    const handle = this._handle;
+    const outElem = allocPtrOut();
+    check(lib.quiver_element_create(outElem));
+    const elemPtr = readPtrOut(outElem);
+    try {
+        for (const [key, value] of Object.entries(data)) {
+            if (value === undefined)
+                continue;
+            setElementField(lib, elemPtr, key, value);
+        }
+        const outId = new BigInt64Array(1);
+        check(lib.quiver_database_create_element(handle, collection, elemPtr, outId));
+        return Number(outId[0]);
+    }
+    finally {
+        lib.quiver_element_destroy(elemPtr);
+    }
+};
+Database.prototype.updateElement = function (collection, id, data) {
+    const lib = getSymbols();
+    const handle = this._handle;
+    const outElem = allocPtrOut();
+    check(lib.quiver_element_create(outElem));
+    const elemPtr = readPtrOut(outElem);
+    try {
+        for (const [key, value] of Object.entries(data)) {
+            if (value === undefined)
+                continue;
+            setElementField(lib, elemPtr, key, value);
+        }
+        check(lib.quiver_database_update_element(handle, collection, id, elemPtr));
+    }
+    finally {
+        lib.quiver_element_destroy(elemPtr);
+    }
+};
+Database.prototype.deleteElement = function (collection, id) {
+    const lib = getSymbols();
+    check(lib.quiver_database_delete_element(this._handle, collection, id));
+};
+//# sourceMappingURL=create.js.map

package/dist/create.js.map

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

package/dist/csv.d.ts

@@ -0,0 +1,11 @@
+export interface CsvOptions {
+    dateTimeFormat?: string;
+    enumLabels?: Record<string, Record<string, Record<string, number>>>;
+}
+declare module "./database.js" {
+    interface Database {
+        exportCsv(collection: string, group: string, filePath: string, options?: CsvOptions): void;
+        importCsv(collection: string, group: string, filePath: string, options?: CsvOptions): void;
+    }
+}
+//# sourceMappingURL=csv.d.ts.map

package/dist/csv.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"csv.d.ts","sourceRoot":"","sources":["../src/csv.ts"],"names":[],"mappings":"AAOA,MAAM,WAAW,UAAU;IACzB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,UAAU,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;CACrE;AAED,OAAO,QAAQ,eAAe,CAAC;IAC7B,UAAU,QAAQ;QAChB,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;QAC3F,SAAS,CAAC,UAAU,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,UAAU,GAAG,IAAI,CAAC;KAC5F;CACF"}

package/dist/csv.js

@@ -0,0 +1,67 @@
+import koffi from "koffi";
+import { Database } from "./database.js";
+import { check } from "./errors.js";
+import { allocNativeInt64, allocNativeString, allocNativeStringArray, nativeAddress } from "./ffi-helpers.js";
+import { getSymbols } from "./loader.js";
+/**
+ * Build the 56-byte quiver_csv_options_t struct as a Buffer.
+ * Returns [structBuffer, keepalive] where keepalive prevents GC of native allocations.
+ */
+function buildCsvOptionsBuffer(options) {
+    const buf = Buffer.alloc(56);
+    const keepalive = [];
+    const dtfStr = allocNativeString(options?.dateTimeFormat ?? "");
+    keepalive.push(dtfStr);
+    buf.writeBigUInt64LE(nativeAddress(dtfStr), 0);
+    if (!options?.enumLabels || Object.keys(options.enumLabels).length === 0) {
+        return [buf, keepalive];
+    }
+    const groupAttrNames = [];
+    const groupLocaleNames = [];
+    const groupEntryCounts = [];
+    const allLabels = [];
+    const allValues = [];
+    for (const [attrName, locales] of Object.entries(options.enumLabels)) {
+        for (const [localeName, entries] of Object.entries(locales)) {
+            groupAttrNames.push(attrName);
+            groupLocaleNames.push(localeName);
+            groupEntryCounts.push(Object.keys(entries).length);
+            for (const [label, value] of Object.entries(entries)) {
+                allLabels.push(label);
+                allValues.push(value);
+            }
+        }
+    }
+    const groupCount = groupAttrNames.length;
+    const { table: attrTable, keepalive: attrPtrs } = allocNativeStringArray(groupAttrNames);
+    keepalive.push(attrTable, ...attrPtrs);
+    const { table: localeTable, keepalive: localePtrs } = allocNativeStringArray(groupLocaleNames);
+    keepalive.push(localeTable, ...localePtrs);
+    const entryCounts = koffi.alloc("uint64_t", groupCount);
+    for (let i = 0; i < groupCount; i++) {
+        koffi.encode(entryCounts, i * 8, "uint64_t", BigInt(groupEntryCounts[i]));
+    }
+    keepalive.push(entryCounts);
+    const { table: labelsTable, keepalive: labelPtrs } = allocNativeStringArray(allLabels);
+    keepalive.push(labelsTable, ...labelPtrs);
+    const valuesArr = allocNativeInt64(allValues);
+    keepalive.push(valuesArr);
+    buf.writeBigUInt64LE(nativeAddress(attrTable), 8);
+    buf.writeBigUInt64LE(nativeAddress(localeTable), 16);
+    buf.writeBigUInt64LE(nativeAddress(entryCounts), 24);
+    buf.writeBigUInt64LE(nativeAddress(labelsTable), 32);
+    buf.writeBigUInt64LE(nativeAddress(valuesArr), 40);
+    buf.writeBigUInt64LE(BigInt(groupCount), 48);
+    return [buf, keepalive];
+}
+Database.prototype.exportCsv = function (collection, group, filePath, options) {
+    const lib = getSymbols();
+    const [optsBuf, _keepalive] = buildCsvOptionsBuffer(options);
+    check(lib.quiver_database_export_csv(this._handle, collection, group, filePath, optsBuf));
+};
+Database.prototype.importCsv = function (collection, group, filePath, options) {
+    const lib = getSymbols();
+    const [optsBuf, _keepalive] = buildCsvOptionsBuffer(options);
+    check(lib.quiver_database_import_csv(this._handle, collection, group, filePath, optsBuf));
+};
+//# sourceMappingURL=csv.js.map

package/dist/csv.js.map

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

package/dist/database.d.ts

@@ -0,0 +1,13 @@
+import type { NativePointer } from "./loader.js";
+export declare class Database {
+    private _ptr;
+    private _closed;
+    private constructor();
+    static fromSchema(dbPath: string, schemaPath: string): Database;
+    static fromMigrations(dbPath: string, migrationsPath: string): Database;
+    close(): void;
+    private ensureOpen;
+    /** @internal */
+    get _handle(): NativePointer;
+}
+//# sourceMappingURL=database.d.ts.map

package/dist/database.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.d.ts","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAKjD,qBAAa,QAAQ;IACnB,OAAO,CAAC,IAAI,CAAgB;IAC5B,OAAO,CAAC,OAAO,CAAS;IAExB,OAAO;IAIP,MAAM,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,GAAG,QAAQ;IAU/D,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,EAAE,cAAc,EAAE,MAAM,GAAG,QAAQ;IAUvE,KAAK,IAAI,IAAI;IAOb,OAAO,CAAC,UAAU;IAMlB,gBAAgB;IAChB,IAAI,OAAO,IAAI,aAAa,CAG3B;CACF"}

package/dist/database.js

@@ -0,0 +1,42 @@
+import { check, QuiverError } from "./errors.js";
+import { allocPtrOut, makeDefaultOptions, readPtrOut } from "./ffi-helpers.js";
+import { getSymbols } from "./loader.js";
+export class Database {
+    _ptr;
+    _closed = false;
+    constructor(nativePtr) {
+        this._ptr = nativePtr;
+    }
+    static fromSchema(dbPath, schemaPath) {
+        const lib = getSymbols();
+        const options = makeDefaultOptions();
+        const outDb = allocPtrOut();
+        check(lib.quiver_database_from_schema(dbPath, schemaPath, options, outDb));
+        return new Database(readPtrOut(outDb));
+    }
+    static fromMigrations(dbPath, migrationsPath) {
+        const lib = getSymbols();
+        const options = makeDefaultOptions();
+        const outDb = allocPtrOut();
+        check(lib.quiver_database_from_migrations(dbPath, migrationsPath, options, outDb));
+        return new Database(readPtrOut(outDb));
+    }
+    close() {
+        if (this._closed)
+            return;
+        const lib = getSymbols();
+        check(lib.quiver_database_close(this._ptr));
+        this._closed = true;
+    }
+    ensureOpen() {
+        if (this._closed) {
+            throw new QuiverError("Database is closed");
+        }
+    }
+    /** @internal */
+    get _handle() {
+        this.ensureOpen();
+        return this._ptr;
+    }
+}
+//# sourceMappingURL=database.js.map

package/dist/database.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"database.js","sourceRoot":"","sources":["../src/database.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,kBAAkB,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC/E,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,OAAO,QAAQ;IACX,IAAI,CAAgB;IACpB,OAAO,GAAG,KAAK,CAAC;IAExB,YAAoB,SAAwB;QAC1C,IAAI,CAAC,IAAI,GAAG,SAAS,CAAC;IACxB,CAAC;IAED,MAAM,CAAC,UAAU,CAAC,MAAc,EAAE,UAAkB;QAClD,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;QAE5B,KAAK,CAAC,GAAG,CAAC,2BAA2B,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAE3E,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,MAAM,CAAC,cAAc,CAAC,MAAc,EAAE,cAAsB;QAC1D,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,OAAO,GAAG,kBAAkB,EAAE,CAAC;QACrC,MAAM,KAAK,GAAG,WAAW,EAAE,CAAC;QAE5B,KAAK,CAAC,GAAG,CAAC,+BAA+B,CAAC,MAAM,EAAE,cAAc,EAAE,OAAO,EAAE,KAAK,CAAC,CAAC,CAAC;QAEnF,OAAO,IAAI,QAAQ,CAAC,UAAU,CAAC,KAAK,CAAC,CAAC,CAAC;IACzC,CAAC;IAED,KAAK;QACH,IAAI,IAAI,CAAC,OAAO;YAAE,OAAO;QACzB,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,KAAK,CAAC,GAAG,CAAC,qBAAqB,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;QAC5C,IAAI,CAAC,OAAO,GAAG,IAAI,CAAC;IACtB,CAAC;IAEO,UAAU;QAChB,IAAI,IAAI,CAAC,OAAO,EAAE,CAAC;YACjB,MAAM,IAAI,WAAW,CAAC,oBAAoB,CAAC,CAAC;QAC9C,CAAC;IACH,CAAC;IAED,gBAAgB;IAChB,IAAI,OAAO;QACT,IAAI,CAAC,UAAU,EAAE,CAAC;QAClB,OAAO,IAAI,CAAC,IAAI,CAAC;IACnB,CAAC;CACF"}

package/dist/errors.d.ts

@@ -0,0 +1,5 @@
+export declare class QuiverError extends Error {
+    constructor(message: string);
+}
+export declare function check(err: number): void;
+//# sourceMappingURL=errors.d.ts.map

package/dist/errors.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAEA,qBAAa,WAAY,SAAQ,KAAK;gBACxB,OAAO,EAAE,MAAM;CAI5B;AAED,wBAAgB,KAAK,CAAC,GAAG,EAAE,MAAM,GAAG,IAAI,CASvC"}

package/dist/errors.js

@@ -0,0 +1,18 @@
+import { getSymbols } from "./loader.js";
+export class QuiverError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = "QuiverError";
+    }
+}
+export function check(err) {
+    if (err !== 0) {
+        const lib = getSymbols();
+        const detail = lib.quiver_get_last_error();
+        if (detail) {
+            throw new QuiverError(detail);
+        }
+        throw new QuiverError("Unknown error");
+    }
+}
+//# sourceMappingURL=errors.js.map

package/dist/errors.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"errors.js","sourceRoot":"","sources":["../src/errors.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzC,MAAM,OAAO,WAAY,SAAQ,KAAK;IACpC,YAAY,OAAe;QACzB,KAAK,CAAC,OAAO,CAAC,CAAC;QACf,IAAI,CAAC,IAAI,GAAG,aAAa,CAAC;IAC5B,CAAC;CACF;AAED,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,IAAI,GAAG,KAAK,CAAC,EAAE,CAAC;QACd,MAAM,GAAG,GAAG,UAAU,EAAE,CAAC;QACzB,MAAM,MAAM,GAAG,GAAG,CAAC,qBAAqB,EAAE,CAAC;QAC3C,IAAI,MAAM,EAAE,CAAC;YACX,MAAM,IAAI,WAAW,CAAC,MAAM,CAAC,CAAC;QAChC,CAAC;QACD,MAAM,IAAI,WAAW,CAAC,eAAe,CAAC,CAAC;IACzC,CAAC;AACH,CAAC"}

package/dist/ffi-helpers.d.ts

@@ -0,0 +1,57 @@
+import type { NativePointer } from "./loader.js";
+/**
+ * Construct the 8-byte quiver_database_options_t struct as a Buffer.
+ * Layout: offset 0 = int32 read_only (default 0), offset 4 = int32 console_level (default 1 = QUIVER_LOG_INFO).
+ */
+export declare function makeDefaultOptions(): Buffer;
+/** Allocate an 8-byte buffer for a pointer out-parameter. */
+export declare function allocPtrOut(): Buffer;
+/** Read a pointer from an out-parameter buffer. */
+export declare function readPtrOut(buf: Buffer): NativePointer;
+/** Allocate and read a uint64 out-parameter. */
+export declare function allocUint64Out(): Buffer;
+/** Read a uint64 value from an out-parameter buffer. */
+export declare function readUint64Out(buf: Buffer): number;
+/**
+ * Read a null-terminated C string from a pointer stored in a Buffer.
+ * koffi.decode(externalPtr, "str") segfaults with external pointers,
+ * so we decode from the original Buffer that holds the char* pointer.
+ */
+export declare function decodeStringFromBuf(buf: Buffer): string;
+/** Read an array of int64 values from a native pointer, returning JS numbers. */
+export declare function decodeInt64Array(ptr: NativePointer, count: number): number[];
+/** Read an array of float64 values from a native pointer. */
+export declare function decodeFloat64Array(ptr: NativePointer, count: number): number[];
+/** Read an array of uint64 values from a native pointer, returning JS numbers. */
+export declare function decodeUint64Array(ptr: NativePointer, count: number): number[];
+/** Read an array of pointers from a native pointer using offset-based reading. */
+export declare function decodePtrArray(ptr: NativePointer, count: number): NativePointer[];
+/** Read an array of C strings from a char** pointer. */
+export declare function decodeStringArray(ptr: NativePointer, count: number): string[];
+/** Encode a JS string as a null-terminated C string buffer. */
+export declare function toCString(str: string): Buffer;
+/**
+ * Allocate native memory for a typed array and write values into it.
+ * Returns [nativePtr, address] where nativePtr must be kept alive to prevent GC.
+ */
+export declare function allocNativeInt64(values: number[]): NativePointer;
+export declare function allocNativeFloat64(values: number[]): NativePointer;
+/**
+ * Build a native pointer table from an array of native pointers.
+ * The returned pointer contains an array of void* addresses.
+ */
+export declare function allocNativePtrTable(ptrs: NativePointer[]): NativePointer;
+/**
+ * Allocate a native string (null-terminated) and return its external pointer.
+ */
+export declare function allocNativeString(str: string): NativePointer;
+/**
+ * Build a native string pointer table (const char* const*) from an array of strings.
+ */
+export declare function allocNativeStringArray(strings: string[]): {
+    table: NativePointer;
+    keepalive: NativePointer[];
+};
+/** Get the native address of an external pointer as BigInt. */
+export declare function nativeAddress(ptr: NativePointer): bigint;
+//# sourceMappingURL=ffi-helpers.d.ts.map

package/dist/ffi-helpers.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ffi-helpers.d.ts","sourceRoot":"","sources":["../src/ffi-helpers.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,aAAa,CAAC;AAEjD;;;GAGG;AACH,wBAAgB,kBAAkB,IAAI,MAAM,CAK3C;AAED,6DAA6D;AAC7D,wBAAgB,WAAW,IAAI,MAAM,CAEpC;AAED,mDAAmD;AACnD,wBAAgB,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAErD;AAED,gDAAgD;AAChD,wBAAgB,cAAc,IAAI,MAAM,CAEvC;AAED,wDAAwD;AACxD,wBAAgB,aAAa,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEjD;AAED;;;;GAIG;AACH,wBAAgB,mBAAmB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAEvD;AAED,iFAAiF;AACjF,wBAAgB,gBAAgB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ5E;AAED,6DAA6D;AAC7D,wBAAgB,kBAAkB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAG9E;AAED,kFAAkF;AAClF,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAQ7E;AAED,kFAAkF;AAClF,wBAAgB,cAAc,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,aAAa,EAAE,CAOjF;AAED,wDAAwD;AACxD,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,aAAa,EAAE,KAAK,EAAE,MAAM,GAAG,MAAM,EAAE,CAG7E;AAED,+DAA+D;AAC/D,wBAAgB,SAAS,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,CAE7C;AAED;;;GAGG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAMhE;AAED,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,aAAa,CAMlE;AAED;;;GAGG;AACH,wBAAgB,mBAAmB,CAAC,IAAI,EAAE,aAAa,EAAE,GAAG,aAAa,CAMxE;AAED;;GAEG;AACH,wBAAgB,iBAAiB,CAAC,GAAG,EAAE,MAAM,GAAG,aAAa,CAO5D;AAED;;GAEG;AACH,wBAAgB,sBAAsB,CAAC,OAAO,EAAE,MAAM,EAAE,GAAG;IAAE,KAAK,EAAE,aAAa,CAAC;IAAC,SAAS,EAAE,aAAa,EAAE,CAAA;CAAE,CAI9G;AAED,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,GAAG,EAAE,aAAa,GAAG,MAAM,CAExD"}

package/dist/ffi-helpers.js

@@ -0,0 +1,136 @@
+import koffi from "koffi";
+/**
+ * Construct the 8-byte quiver_database_options_t struct as a Buffer.
+ * Layout: offset 0 = int32 read_only (default 0), offset 4 = int32 console_level (default 1 = QUIVER_LOG_INFO).
+ */
+export function makeDefaultOptions() {
+    const buf = Buffer.alloc(8);
+    buf.writeInt32LE(0, 0); // read_only = false
+    buf.writeInt32LE(1, 4); // console_level = QUIVER_LOG_INFO
+    return buf;
+}
+/** Allocate an 8-byte buffer for a pointer out-parameter. */
+export function allocPtrOut() {
+    return Buffer.alloc(8);
+}
+/** Read a pointer from an out-parameter buffer. */
+export function readPtrOut(buf) {
+    return koffi.decode(buf, "void *");
+}
+/** Allocate and read a uint64 out-parameter. */
+export function allocUint64Out() {
+    return Buffer.alloc(8);
+}
+/** Read a uint64 value from an out-parameter buffer. */
+export function readUint64Out(buf) {
+    return Number(buf.readBigUInt64LE());
+}
+/**
+ * Read a null-terminated C string from a pointer stored in a Buffer.
+ * koffi.decode(externalPtr, "str") segfaults with external pointers,
+ * so we decode from the original Buffer that holds the char* pointer.
+ */
+export function decodeStringFromBuf(buf) {
+    return koffi.decode(buf, koffi.array("str", 1))[0];
+}
+/** Read an array of int64 values from a native pointer, returning JS numbers. */
+export function decodeInt64Array(ptr, count) {
+    if (count === 0)
+        return [];
+    const bigInts = koffi.decode(ptr, koffi.array("int64_t", count));
+    const result = new Array(count);
+    for (let i = 0; i < count; i++) {
+        result[i] = Number(bigInts[i]);
+    }
+    return result;
+}
+/** Read an array of float64 values from a native pointer. */
+export function decodeFloat64Array(ptr, count) {
+    if (count === 0)
+        return [];
+    return Array.from(koffi.decode(ptr, koffi.array("double", count)));
+}
+/** Read an array of uint64 values from a native pointer, returning JS numbers. */
+export function decodeUint64Array(ptr, count) {
+    if (count === 0)
+        return [];
+    const bigInts = koffi.decode(ptr, koffi.array("uint64_t", count));
+    const result = new Array(count);
+    for (let i = 0; i < count; i++) {
+        result[i] = Number(bigInts[i]);
+    }
+    return result;
+}
+/** Read an array of pointers from a native pointer using offset-based reading. */
+export function decodePtrArray(ptr, count) {
+    if (count === 0)
+        return [];
+    const result = new Array(count);
+    for (let i = 0; i < count; i++) {
+        result[i] = koffi.decode(ptr, i * 8, "void *");
+    }
+    return result;
+}
+/** Read an array of C strings from a char** pointer. */
+export function decodeStringArray(ptr, count) {
+    if (count === 0)
+        return [];
+    return koffi.decode(ptr, koffi.array("str", count));
+}
+/** Encode a JS string as a null-terminated C string buffer. */
+export function toCString(str) {
+    return Buffer.from(`${str}\0`);
+}
+/**
+ * Allocate native memory for a typed array and write values into it.
+ * Returns [nativePtr, address] where nativePtr must be kept alive to prevent GC.
+ */
+export function allocNativeInt64(values) {
+    const p = koffi.alloc("int64_t", values.length);
+    for (let i = 0; i < values.length; i++) {
+        koffi.encode(p, i * 8, "int64_t", BigInt(values[i]));
+    }
+    return p;
+}
+export function allocNativeFloat64(values) {
+    const p = koffi.alloc("double", values.length);
+    for (let i = 0; i < values.length; i++) {
+        koffi.encode(p, i * 8, "double", values[i]);
+    }
+    return p;
+}
+/**
+ * Build a native pointer table from an array of native pointers.
+ * The returned pointer contains an array of void* addresses.
+ */
+export function allocNativePtrTable(ptrs) {
+    const p = koffi.alloc("void *", ptrs.length);
+    for (let i = 0; i < ptrs.length; i++) {
+        koffi.encode(p, i * 8, "void *", ptrs[i]);
+    }
+    return p;
+}
+/**
+ * Allocate a native string (null-terminated) and return its external pointer.
+ */
+export function allocNativeString(str) {
+    const buf = Buffer.from(`${str}\0`);
+    const p = koffi.alloc("char", buf.length);
+    for (let i = 0; i < buf.length; i++) {
+        koffi.encode(p, i, "char", buf[i]);
+    }
+    return p;
+}
+/**
+ * Build a native string pointer table (const char* const*) from an array of strings.
+ */
+export function allocNativeStringArray(strings) {
+    const strPtrs = strings.map((s) => allocNativeString(s));
+    const table = allocNativePtrTable(strPtrs);
+    return { table, keepalive: strPtrs };
+}
+/** Get the native address of an external pointer as BigInt. */
+export function nativeAddress(ptr) {
+    return koffi.address(ptr);
+}
+//# sourceMappingURL=ffi-helpers.js.map