quiverdb 0.5.0 → 0.6.1

package/src/loader.ts

@@ -1,286 +0,0 @@
-import { dlopen, FFIType, suffix } from "bun:ffi";
-import { existsSync } from "node:fs";
-import { dirname, join } from "node:path";
-import { QuiverError } from "./errors";
-
-const CORE_LIB = `libquiver.${suffix}`;
-const C_API_LIB = `libquiver_c.${suffix}`;
-
-/**
- * Pre-load a DLL on Windows using kernel32 LoadLibraryA.
- * bun:ffi dlopen() requires at least one symbol, so it cannot be used
- * for dependency-only pre-loading (libquiver.dll has no C API symbols).
- * This is the equivalent of Python's os.add_dll_directory() approach.
- */
-function preloadWindows(dllPath: string): void {
-  const kernel32 = dlopen("kernel32.dll", {
-    LoadLibraryA: { args: [FFIType.ptr], returns: FFIType.ptr },
-  });
-  kernel32.symbols.LoadLibraryA(Buffer.from(`${dllPath}\0`));
-}
-
-const symbols = {
-  quiver_version: {
-    args: [],
-    returns: FFIType.cstring,
-  },
-  quiver_get_last_error: {
-    args: [],
-    returns: FFIType.ptr,
-  },
-  quiver_clear_last_error: {
-    args: [],
-    returns: FFIType.void,
-  },
-  quiver_database_from_schema: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_from_migrations: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_close: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Element lifecycle
-  quiver_element_create: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_element_destroy: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Element scalar setters
-  quiver_element_set_integer: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.i64],
-    returns: FFIType.i32,
-  },
-  quiver_element_set_float: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.f64],
-    returns: FFIType.i32,
-  },
-  quiver_element_set_string: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_element_set_null: {
-    args: [FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Element array setters
-  quiver_element_set_array_integer: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.i32],
-    returns: FFIType.i32,
-  },
-  quiver_element_set_array_float: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.i32],
-    returns: FFIType.i32,
-  },
-  quiver_element_set_array_string: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.i32],
-    returns: FFIType.i32,
-  },
-
-  // Database CRUD
-  quiver_database_create_element: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_delete_element: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.i64],
-    returns: FFIType.i32,
-  },
-
-  // Read scalar arrays
-  quiver_database_read_scalar_integers: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_read_scalar_floats: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_read_scalar_strings: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Read scalar by ID
-  quiver_database_read_scalar_integer_by_id: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.i64, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_read_scalar_float_by_id: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.i64, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_read_scalar_string_by_id: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.i64, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Read element IDs
-  quiver_database_read_element_ids: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Free functions
-  quiver_database_free_integer_array: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_free_float_array: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_free_string_array: {
-    args: [FFIType.ptr, FFIType.u64],
-    returns: FFIType.i32,
-  },
-  quiver_database_free_string: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Query operations (plain)
-  quiver_database_query_string: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_query_integer: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_query_float: {
-    args: [FFIType.ptr, FFIType.ptr, FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-
-  // Query operations (parameterized)
-  quiver_database_query_string_params: {
-    args: [
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.u64,
-      FFIType.ptr,
-      FFIType.ptr,
-    ],
-    returns: FFIType.i32,
-  },
-  quiver_database_query_integer_params: {
-    args: [
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.u64,
-      FFIType.ptr,
-      FFIType.ptr,
-    ],
-    returns: FFIType.i32,
-  },
-  quiver_database_query_float_params: {
-    args: [
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.ptr,
-      FFIType.u64,
-      FFIType.ptr,
-      FFIType.ptr,
-    ],
-    returns: FFIType.i32,
-  },
-
-  // Transaction control
-  quiver_database_begin_transaction: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_commit: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_rollback: {
-    args: [FFIType.ptr],
-    returns: FFIType.i32,
-  },
-  quiver_database_in_transaction: {
-    args: [FFIType.ptr, FFIType.ptr],
-    returns: FFIType.i32,
-  },
-} as const;
-
-type Library = ReturnType<typeof dlopen<typeof symbols>>;
-
-let _library: Library | null = null;
-
-function getSearchPaths(): string[] {
-  const paths: string[] = [];
-
-  // Walk up from import.meta.dir (bindings/js/src/) looking for build/bin/
-  let dir = import.meta.dir;
-  for (let i = 0; i < 5; i++) {
-    const candidate = join(dir, "build", "bin");
-    if (existsSync(join(candidate, C_API_LIB))) {
-      paths.push(candidate);
-    }
-    dir = dirname(dir);
-  }
-
-  return paths;
-}
-
-export function loadLibrary(): Library {
-  if (_library) return _library;
-
-  const searchPaths = getSearchPaths();
-
-  for (const dir of searchPaths) {
-    const corePath = join(dir, CORE_LIB);
-    const cApiPath = join(dir, C_API_LIB);
-    if (!existsSync(cApiPath)) continue;
-
-    try {
-      // Windows: pre-load core library (dependency chain)
-      if (suffix === "dll" && existsSync(corePath)) {
-        preloadWindows(corePath);
-      }
-      _library = dlopen(cApiPath, symbols);
-      return _library;
-    } catch {}
-  }
-
-  // Fallback: try system PATH (bare library name)
-  try {
-    if (suffix === "dll") {
-      try {
-        preloadWindows(CORE_LIB);
-      } catch {
-        // Core lib may already be loaded or not needed on this platform
-      }
-    }
-    _library = dlopen(C_API_LIB, symbols);
-    return _library;
-  } catch {
-    // Fall through to error
-  }
-
-  const searched =
-    searchPaths.length > 0 ? `${searchPaths.join(", ")}, system PATH` : "system PATH";
-
-  throw new QuiverError(`Cannot load native library '${C_API_LIB}'. Searched: ${searched}`);
-}
-
-export function getSymbols(): Library["symbols"] {
-  return loadLibrary().symbols;
-}

package/src/query.ts

@@ -1,164 +0,0 @@
-import { CString, ptr } from "bun:ffi";
-import { Database } from "./database";
-import { check } from "./errors";
-import { allocPointerOut, readPointerOut, toCString } from "./ffi-helpers";
-import { getSymbols } from "./loader";
-import type { QueryParam } from "./types";
-
-declare module "./database" {
-  interface Database {
-    queryString(sql: string, params?: QueryParam[]): string | null;
-    queryInteger(sql: string, params?: QueryParam[]): number | null;
-    queryFloat(sql: string, params?: QueryParam[]): number | null;
-  }
-}
-
-// C API data type enum values (from include/quiver/c/database.h)
-const DATA_TYPE_INTEGER = 0;
-const DATA_TYPE_FLOAT = 1;
-const DATA_TYPE_STRING = 2;
-const DATA_TYPE_NULL = 4;
-
-interface MarshaledParams {
-  types: Int32Array;
-  values: BigInt64Array;
-  _keepalive: unknown[];
-}
-
-function marshalParams(params: QueryParam[]): MarshaledParams {
-  const n = params.length;
-  const types = new Int32Array(n);
-  const values = new BigInt64Array(n);
-  const keepalive: unknown[] = [];
-
-  for (let i = 0; i < n; i++) {
-    const p = params[i];
-    if (p === null) {
-      types[i] = DATA_TYPE_NULL;
-      values[i] = 0n;
-    } else if (typeof p === "number") {
-      if (Number.isInteger(p)) {
-        types[i] = DATA_TYPE_INTEGER;
-        const buf = new BigInt64Array([BigInt(p)]);
-        keepalive.push(buf);
-        values[i] = BigInt(ptr(buf));
-      } else {
-        types[i] = DATA_TYPE_FLOAT;
-        const buf = new Float64Array([p]);
-        keepalive.push(buf);
-        values[i] = BigInt(ptr(buf));
-      }
-    } else if (typeof p === "string") {
-      types[i] = DATA_TYPE_STRING;
-      const buf = toCString(p);
-      keepalive.push(buf);
-      values[i] = BigInt(ptr(buf));
-    }
-  }
-
-  return { types, values, _keepalive: keepalive };
-}
-
-Database.prototype.queryString = function (
-  this: Database,
-  sql: string,
-  params?: QueryParam[],
-): string | null {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValue = allocPointerOut();
-  const outHasValue = new Int32Array(1);
-
-  if (params && params.length > 0) {
-    const marshaled = marshalParams(params);
-    check(
-      lib.quiver_database_query_string_params(
-        handle,
-        toCString(sql),
-        ptr(marshaled.types),
-        ptr(marshaled.values),
-        params.length,
-        ptr(outValue),
-        ptr(outHasValue),
-      ),
-    );
-  } else {
-    check(
-      lib.quiver_database_query_string(handle, toCString(sql), ptr(outValue), ptr(outHasValue)),
-    );
-  }
-
-  if (outHasValue[0] === 0) return null;
-
-  const strPtr = readPointerOut(outValue);
-  const result = new CString(strPtr).toString();
-  lib.quiver_database_free_string(strPtr);
-  return result;
-};
-
-Database.prototype.queryInteger = function (
-  this: Database,
-  sql: string,
-  params?: QueryParam[],
-): number | null {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValue = new BigInt64Array(1);
-  const outHasValue = new Int32Array(1);
-
-  if (params && params.length > 0) {
-    const marshaled = marshalParams(params);
-    check(
-      lib.quiver_database_query_integer_params(
-        handle,
-        toCString(sql),
-        ptr(marshaled.types),
-        ptr(marshaled.values),
-        params.length,
-        ptr(outValue),
-        ptr(outHasValue),
-      ),
-    );
-  } else {
-    check(
-      lib.quiver_database_query_integer(handle, toCString(sql), ptr(outValue), ptr(outHasValue)),
-    );
-  }
-
-  if (outHasValue[0] === 0) return null;
-  return Number(outValue[0]);
-};
-
-Database.prototype.queryFloat = function (
-  this: Database,
-  sql: string,
-  params?: QueryParam[],
-): number | null {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValue = new Float64Array(1);
-  const outHasValue = new Int32Array(1);
-
-  if (params && params.length > 0) {
-    const marshaled = marshalParams(params);
-    check(
-      lib.quiver_database_query_float_params(
-        handle,
-        toCString(sql),
-        ptr(marshaled.types),
-        ptr(marshaled.values),
-        params.length,
-        ptr(outValue),
-        ptr(outHasValue),
-      ),
-    );
-  } else {
-    check(lib.quiver_database_query_float(handle, toCString(sql), ptr(outValue), ptr(outHasValue)));
-  }
-
-  if (outHasValue[0] === 0) return null;
-  return outValue[0];
-};

package/src/read.ts

@@ -1,231 +0,0 @@
-import { CString, ptr, toArrayBuffer } from "bun:ffi";
-import { Database } from "./database";
-import { check } from "./errors";
-import { allocPointerOut, readPointerOut, readPtrAt, toCString } from "./ffi-helpers";
-import { getSymbols } from "./loader";
-
-declare module "./database" {
-  interface Database {
-    readScalarIntegers(collection: string, attribute: string): number[];
-    readScalarFloats(collection: string, attribute: string): number[];
-    readScalarStrings(collection: string, attribute: string): string[];
-    readScalarIntegerById(collection: string, attribute: string, id: number): number | null;
-    readScalarFloatById(collection: string, attribute: string, id: number): number | null;
-    readScalarStringById(collection: string, attribute: string, id: number): string | null;
-    readElementIds(collection: string): number[];
-  }
-}
-
-Database.prototype.readScalarIntegers = function (
-  this: Database,
-  collection: string,
-  attribute: string,
-): number[] {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValues = allocPointerOut();
-  const outCount = new BigUint64Array(1);
-
-  check(
-    lib.quiver_database_read_scalar_integers(
-      handle,
-      toCString(collection),
-      toCString(attribute),
-      ptr(outValues),
-      ptr(outCount),
-    ),
-  );
-
-  const count = Number(outCount[0]);
-  if (count === 0) return [];
-
-  const valuesPtr = readPointerOut(outValues);
-  const buffer = toArrayBuffer(valuesPtr, 0, count * 8);
-  const bigInts = new BigInt64Array(buffer);
-  const result: number[] = new Array(count);
-  for (let i = 0; i < count; i++) {
-    result[i] = Number(bigInts[i]);
-  }
-
-  lib.quiver_database_free_integer_array(valuesPtr);
-  return result;
-};
-
-Database.prototype.readScalarFloats = function (
-  this: Database,
-  collection: string,
-  attribute: string,
-): number[] {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValues = allocPointerOut();
-  const outCount = new BigUint64Array(1);
-
-  check(
-    lib.quiver_database_read_scalar_floats(
-      handle,
-      toCString(collection),
-      toCString(attribute),
-      ptr(outValues),
-      ptr(outCount),
-    ),
-  );
-
-  const count = Number(outCount[0]);
-  if (count === 0) return [];
-
-  const valuesPtr = readPointerOut(outValues);
-  const buffer = toArrayBuffer(valuesPtr, 0, count * 8);
-  const result = Array.from(new Float64Array(buffer));
-
-  lib.quiver_database_free_float_array(valuesPtr);
-  return result;
-};
-
-Database.prototype.readScalarStrings = function (
-  this: Database,
-  collection: string,
-  attribute: string,
-): string[] {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValues = allocPointerOut();
-  const outCount = new BigUint64Array(1);
-
-  check(
-    lib.quiver_database_read_scalar_strings(
-      handle,
-      toCString(collection),
-      toCString(attribute),
-      ptr(outValues),
-      ptr(outCount),
-    ),
-  );
-
-  const count = Number(outCount[0]);
-  if (count === 0) return [];
-
-  const arrPtr = readPointerOut(outValues);
-  const result: string[] = new Array(count);
-  for (let i = 0; i < count; i++) {
-    const strPtr = readPtrAt(arrPtr, i * 8);
-    result[i] = new CString(strPtr).toString();
-  }
-
-  lib.quiver_database_free_string_array(arrPtr, count);
-  return result;
-};
-
-Database.prototype.readScalarIntegerById = function (
-  this: Database,
-  collection: string,
-  attribute: string,
-  id: number,
-): number | null {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValue = new BigInt64Array(1);
-  const outHasValue = new Int32Array(1);
-
-  check(
-    lib.quiver_database_read_scalar_integer_by_id(
-      handle,
-      toCString(collection),
-      toCString(attribute),
-      id,
-      ptr(outValue),
-      ptr(outHasValue),
-    ),
-  );
-
-  if (outHasValue[0] === 0) return null;
-  return Number(outValue[0]);
-};
-
-Database.prototype.readScalarFloatById = function (
-  this: Database,
-  collection: string,
-  attribute: string,
-  id: number,
-): number | null {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValue = new Float64Array(1);
-  const outHasValue = new Int32Array(1);
-
-  check(
-    lib.quiver_database_read_scalar_float_by_id(
-      handle,
-      toCString(collection),
-      toCString(attribute),
-      id,
-      ptr(outValue),
-      ptr(outHasValue),
-    ),
-  );
-
-  if (outHasValue[0] === 0) return null;
-  return outValue[0];
-};
-
-Database.prototype.readScalarStringById = function (
-  this: Database,
-  collection: string,
-  attribute: string,
-  id: number,
-): string | null {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outValue = allocPointerOut();
-  const outHasValue = new Int32Array(1);
-
-  check(
-    lib.quiver_database_read_scalar_string_by_id(
-      handle,
-      toCString(collection),
-      toCString(attribute),
-      id,
-      ptr(outValue),
-      ptr(outHasValue),
-    ),
-  );
-
-  if (outHasValue[0] === 0) return null;
-
-  const strPtr = readPointerOut(outValue);
-  const result = new CString(strPtr).toString();
-  lib.quiver_database_free_string(strPtr);
-  return result;
-};
-
-Database.prototype.readElementIds = function (this: Database, collection: string): number[] {
-  const lib = getSymbols();
-  const handle = this._handle;
-
-  const outIds = allocPointerOut();
-  const outCount = new BigUint64Array(1);
-
-  check(
-    lib.quiver_database_read_element_ids(handle, toCString(collection), ptr(outIds), ptr(outCount)),
-  );
-
-  const count = Number(outCount[0]);
-  if (count === 0) return [];
-
-  const idsPtr = readPointerOut(outIds);
-  const buffer = toArrayBuffer(idsPtr, 0, count * 8);
-  const bigInts = new BigInt64Array(buffer);
-  const result: number[] = new Array(count);
-  for (let i = 0; i < count; i++) {
-    result[i] = Number(bigInts[i]);
-  }
-
-  lib.quiver_database_free_integer_array(idsPtr);
-  return result;
-};

package/src/transaction.ts

@@ -1,35 +0,0 @@
-import { ptr } from "bun:ffi";
-import { Database } from "./database";
-import { check } from "./errors";
-import { getSymbols } from "./loader";
-
-declare module "./database" {
-  interface Database {
-    beginTransaction(): void;
-    commit(): void;
-    rollback(): void;
-    inTransaction(): boolean;
-  }
-}
-
-Database.prototype.beginTransaction = function (this: Database): void {
-  const lib = getSymbols();
-  check(lib.quiver_database_begin_transaction(this._handle));
-};
-
-Database.prototype.commit = function (this: Database): void {
-  const lib = getSymbols();
-  check(lib.quiver_database_commit(this._handle));
-};
-
-Database.prototype.rollback = function (this: Database): void {
-  const lib = getSymbols();
-  check(lib.quiver_database_rollback(this._handle));
-};
-
-Database.prototype.inTransaction = function (this: Database): boolean {
-  const lib = getSymbols();
-  const outActive = new Uint8Array(1);
-  check(lib.quiver_database_in_transaction(this._handle, ptr(outActive)));
-  return outActive[0] !== 0;
-};