@holo-js/db-sqlite 0.1.3

package/dist/index.d.ts

@@ -0,0 +1,64 @@
+interface DriverQueryResult<TRow extends Record<string, unknown> = Record<string, unknown>> {
+    rows: TRow[];
+    rowCount: number;
+}
+interface DriverExecutionResult {
+    affectedRows?: number;
+    lastInsertId?: number | string;
+}
+interface DriverAdapter {
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    query<TRow extends Record<string, unknown> = Record<string, unknown>>(sql: string, bindings?: readonly unknown[]): Promise<DriverQueryResult<TRow>>;
+    execute(sql: string, bindings?: readonly unknown[]): Promise<DriverExecutionResult>;
+    beginTransaction(): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    createSavepoint?(name: string): Promise<void>;
+    rollbackToSavepoint?(name: string): Promise<void>;
+    releaseSavepoint?(name: string): Promise<void>;
+}
+interface SQLiteStatementLike {
+    all(...params: readonly unknown[]): Record<string, unknown>[];
+    run(...params: readonly unknown[]): {
+        changes?: number;
+        lastInsertRowid?: unknown;
+    };
+}
+interface SQLiteDatabaseLike {
+    prepare(sql: string): SQLiteStatementLike;
+    exec(sql: string): unknown;
+    close(): unknown;
+}
+interface SQLiteAdapterOptions {
+    filename?: string;
+    database?: SQLiteDatabaseLike;
+    createDatabase?: (filename: string) => SQLiteDatabaseLike;
+}
+declare class SQLiteAdapter implements DriverAdapter {
+    private database?;
+    private connected;
+    private readonly filename;
+    private readonly createDatabaseInstance;
+    constructor(options?: SQLiteAdapterOptions);
+    initialize(): Promise<void>;
+    disconnect(): Promise<void>;
+    isConnected(): boolean;
+    query<TRow extends Record<string, unknown> = Record<string, unknown>>(sql: string, bindings?: readonly unknown[]): Promise<DriverQueryResult<TRow>>;
+    introspect<TRow extends Record<string, unknown> = Record<string, unknown>>(sql: string, bindings?: readonly unknown[]): Promise<DriverQueryResult<TRow>>;
+    execute(sql: string, bindings?: readonly unknown[]): Promise<DriverExecutionResult>;
+    beginTransaction(): Promise<void>;
+    commit(): Promise<void>;
+    rollback(): Promise<void>;
+    createSavepoint(name: string): Promise<void>;
+    rollbackToSavepoint(name: string): Promise<void>;
+    releaseSavepoint(name: string): Promise<void>;
+    private getDatabase;
+    private normalizeSavepointName;
+    private invokeStatement;
+    private isBindingArityError;
+}
+declare function createSQLiteAdapter(options?: SQLiteAdapterOptions): SQLiteAdapter;
+
+export { type DriverAdapter, type DriverExecutionResult, type DriverQueryResult, SQLiteAdapter, type SQLiteAdapterOptions, type SQLiteDatabaseLike, type SQLiteStatementLike, createSQLiteAdapter };

package/dist/index.mjs

@@ -0,0 +1,104 @@
+// src/index.ts
+import Database from "better-sqlite3";
+var TransactionError = class extends Error {
+};
+var SQLiteAdapter = class {
+  database;
+  connected;
+  filename;
+  createDatabaseInstance;
+  constructor(options = {}) {
+    this.database = options.database;
+    this.connected = !!options.database;
+    this.filename = options.filename ?? ":memory:";
+    this.createDatabaseInstance = options.createDatabase ?? ((filename) => new Database(filename));
+  }
+  async initialize() {
+    if (this.connected) {
+      return;
+    }
+    this.database = this.createDatabaseInstance(this.filename);
+    this.connected = true;
+  }
+  async disconnect() {
+    if (!this.connected || !this.database) {
+      return;
+    }
+    this.database.close();
+    this.database = void 0;
+    this.connected = false;
+  }
+  isConnected() {
+    return this.connected;
+  }
+  async query(sql, bindings = []) {
+    const statement = this.getDatabase().prepare(sql);
+    const rows = this.invokeStatement(statement, "all", bindings);
+    return {
+      rows,
+      rowCount: rows.length
+    };
+  }
+  async introspect(sql, bindings = []) {
+    return this.query(sql, bindings);
+  }
+  async execute(sql, bindings = []) {
+    const statement = this.getDatabase().prepare(sql);
+    const result = this.invokeStatement(statement, "run", bindings);
+    return {
+      affectedRows: result.changes,
+      lastInsertId: typeof result.lastInsertRowid === "bigint" ? Number(result.lastInsertRowid) : result.lastInsertRowid
+    };
+  }
+  async beginTransaction() {
+    this.getDatabase().exec("BEGIN");
+  }
+  async commit() {
+    this.getDatabase().exec("COMMIT");
+  }
+  async rollback() {
+    this.getDatabase().exec("ROLLBACK");
+  }
+  async createSavepoint(name) {
+    this.getDatabase().exec(`SAVEPOINT ${this.normalizeSavepointName(name)}`);
+  }
+  async rollbackToSavepoint(name) {
+    this.getDatabase().exec(`ROLLBACK TO SAVEPOINT ${this.normalizeSavepointName(name)}`);
+  }
+  async releaseSavepoint(name) {
+    this.getDatabase().exec(`RELEASE SAVEPOINT ${this.normalizeSavepointName(name)}`);
+  }
+  getDatabase() {
+    if (!this.connected || !this.database) {
+      this.database = this.createDatabaseInstance(this.filename);
+      this.connected = true;
+    }
+    return this.database;
+  }
+  normalizeSavepointName(name) {
+    if (!/^[A-Z_]\w*$/i.test(name)) {
+      throw new TransactionError(`Invalid savepoint name "${name}".`);
+    }
+    return name;
+  }
+  invokeStatement(statement, method, bindings) {
+    try {
+      return statement[method](...bindings);
+    } catch (error) {
+      if (bindings.length > 0 && this.isBindingArityError(error)) {
+        return statement[method](bindings);
+      }
+      throw error;
+    }
+  }
+  isBindingArityError(error) {
+    return error instanceof RangeError && (error.message.includes("Too many parameter values were provided") || error.message.includes("Too few parameter values were provided"));
+  }
+};
+function createSQLiteAdapter(options = {}) {
+  return new SQLiteAdapter(options);
+}
+export {
+  SQLiteAdapter,
+  createSQLiteAdapter
+};

package/package.json

@@ -0,0 +1,38 @@
+{
+  "name": "@holo-js/db-sqlite",
+  "version": "0.1.3",
+  "description": "Holo-JS Framework - SQLite database adapter",
+  "type": "module",
+  "license": "MIT",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.mjs",
+      "default": "./dist/index.mjs"
+    }
+  },
+  "main": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "files": [
+    "dist"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "stub": "tsup --watch",
+    "typecheck": "tsc -p tsconfig.json --noEmit",
+    "test": "vitest --run"
+  },
+  "peerDependencies": {
+    "@holo-js/db": "^0.1.3"
+  },
+  "dependencies": {
+    "better-sqlite3": "^11.7.0"
+  },
+  "devDependencies": {
+    "@holo-js/db": "workspace:*",
+    "@types/better-sqlite3": "^7.6.12",
+    "tsup": "^8.3.5",
+    "typescript": "^5.7.2",
+    "vitest": "^2.1.8"
+  }
+}