@anfenn/dync 1.0.0

package/dist/node.d.cts

@@ -0,0 +1,80 @@
+import * as better_sqlite3 from 'better-sqlite3';
+import { S as SQLiteDatabaseDriver, a as SQLiteRunResult, b as SQLiteQueryResult } from './types-CSbIAfu2.cjs';
+
+/**
+ * Options for configuring the BetterSqlite3Driver.
+ */
+interface BetterSqlite3DriverOptions {
+    /**
+     * Open the database in readonly mode.
+     * @default false
+     */
+    readonly?: boolean;
+    /**
+     * Create the database file if it doesn't exist.
+     * Set to false to throw an error if the file doesn't exist.
+     * @default true
+     */
+    fileMustExist?: boolean;
+    /**
+     * Timeout in milliseconds when waiting for the database to become unlocked.
+     * @default 5000
+     */
+    timeout?: number;
+    /**
+     * Enable verbose mode for debugging SQL statements.
+     */
+    verbose?: (message?: unknown, ...additionalArgs: unknown[]) => void;
+    /**
+     * Enable WAL (Write-Ahead Logging) mode for better concurrent access.
+     * Recommended for most use cases.
+     * @default true
+     */
+    wal?: boolean;
+}
+/**
+ * SQLite driver for Node.js using better-sqlite3.
+ * This driver is synchronous but wraps operations in Promises for API compatibility.
+ *
+ * @example
+ * ```ts
+ * import { BetterSqlite3Driver } from '@anfenn/dync/node';
+ * import { SQLiteAdapter } from '@anfenn/dync';
+ *
+ * const driver = new BetterSqlite3Driver('myapp.db', { wal: true });
+ * const adapter = new SQLiteAdapter('myapp', driver);
+ * ```
+ */
+declare class BetterSqlite3Driver implements SQLiteDatabaseDriver {
+    readonly type = "BetterSqlite3Driver";
+    private db;
+    private readonly options;
+    private opened;
+    readonly name: string;
+    constructor(databasePath: string, options?: BetterSqlite3DriverOptions);
+    open(): Promise<void>;
+    close(): Promise<void>;
+    execute(statement: string): Promise<void>;
+    run(statement: string, values?: unknown[]): Promise<SQLiteRunResult>;
+    query(statement: string, values?: unknown[]): Promise<SQLiteQueryResult>;
+    /**
+     * Access the underlying better-sqlite3 Database instance for advanced operations.
+     * Returns null if the database is not open.
+     */
+    getDatabase(): better_sqlite3.Database | null;
+    /**
+     * Execute a function within a transaction.
+     * This provides better performance when doing many writes.
+     *
+     * @example
+     * ```ts
+     * await driver.transaction(() => {
+     *   driver.run('INSERT INTO users (name) VALUES (?)', ['Alice']);
+     *   driver.run('INSERT INTO users (name) VALUES (?)', ['Bob']);
+     * });
+     * ```
+     */
+    transaction<T>(fn: () => T): T;
+}
+
+export { BetterSqlite3Driver, type BetterSqlite3DriverOptions, SQLiteDatabaseDriver, SQLiteQueryResult, SQLiteRunResult };

package/dist/node.d.ts

@@ -0,0 +1,80 @@
+import * as better_sqlite3 from 'better-sqlite3';
+import { S as SQLiteDatabaseDriver, a as SQLiteRunResult, b as SQLiteQueryResult } from './types-CSbIAfu2.js';
+
+/**
+ * Options for configuring the BetterSqlite3Driver.
+ */
+interface BetterSqlite3DriverOptions {
+    /**
+     * Open the database in readonly mode.
+     * @default false
+     */
+    readonly?: boolean;
+    /**
+     * Create the database file if it doesn't exist.
+     * Set to false to throw an error if the file doesn't exist.
+     * @default true
+     */
+    fileMustExist?: boolean;
+    /**
+     * Timeout in milliseconds when waiting for the database to become unlocked.
+     * @default 5000
+     */
+    timeout?: number;
+    /**
+     * Enable verbose mode for debugging SQL statements.
+     */
+    verbose?: (message?: unknown, ...additionalArgs: unknown[]) => void;
+    /**
+     * Enable WAL (Write-Ahead Logging) mode for better concurrent access.
+     * Recommended for most use cases.
+     * @default true
+     */
+    wal?: boolean;
+}
+/**
+ * SQLite driver for Node.js using better-sqlite3.
+ * This driver is synchronous but wraps operations in Promises for API compatibility.
+ *
+ * @example
+ * ```ts
+ * import { BetterSqlite3Driver } from '@anfenn/dync/node';
+ * import { SQLiteAdapter } from '@anfenn/dync';
+ *
+ * const driver = new BetterSqlite3Driver('myapp.db', { wal: true });
+ * const adapter = new SQLiteAdapter('myapp', driver);
+ * ```
+ */
+declare class BetterSqlite3Driver implements SQLiteDatabaseDriver {
+    readonly type = "BetterSqlite3Driver";
+    private db;
+    private readonly options;
+    private opened;
+    readonly name: string;
+    constructor(databasePath: string, options?: BetterSqlite3DriverOptions);
+    open(): Promise<void>;
+    close(): Promise<void>;
+    execute(statement: string): Promise<void>;
+    run(statement: string, values?: unknown[]): Promise<SQLiteRunResult>;
+    query(statement: string, values?: unknown[]): Promise<SQLiteQueryResult>;
+    /**
+     * Access the underlying better-sqlite3 Database instance for advanced operations.
+     * Returns null if the database is not open.
+     */
+    getDatabase(): better_sqlite3.Database | null;
+    /**
+     * Execute a function within a transaction.
+     * This provides better performance when doing many writes.
+     *
+     * @example
+     * ```ts
+     * await driver.transaction(() => {
+     *   driver.run('INSERT INTO users (name) VALUES (?)', ['Alice']);
+     *   driver.run('INSERT INTO users (name) VALUES (?)', ['Bob']);
+     * });
+     * ```
+     */
+    transaction<T>(fn: () => T): T;
+}
+
+export { BetterSqlite3Driver, type BetterSqlite3DriverOptions, SQLiteDatabaseDriver, SQLiteQueryResult, SQLiteRunResult };

package/dist/node.js

@@ -0,0 +1,89 @@
+// src/storage/sqlite/drivers/BetterSqlite3Driver.ts
+var BetterSqlite3Driver = class {
+  type = "BetterSqlite3Driver";
+  db = null;
+  options;
+  opened = false;
+  name;
+  constructor(databasePath, options = {}) {
+    this.name = databasePath;
+    this.options = {
+      wal: true,
+      ...options
+    };
+  }
+  async open() {
+    if (this.opened) return;
+    const Database = (await import("better-sqlite3")).default;
+    this.db = new Database(this.name, {
+      readonly: this.options.readonly ?? false,
+      fileMustExist: this.options.fileMustExist ?? false,
+      timeout: this.options.timeout ?? 5e3,
+      verbose: this.options.verbose
+    });
+    if (this.options.wal && !this.options.readonly) {
+      this.db.pragma("journal_mode = WAL");
+    }
+    this.opened = true;
+  }
+  async close() {
+    if (!this.db) return;
+    this.db.close();
+    this.db = null;
+    this.opened = false;
+  }
+  async execute(statement) {
+    await this.open();
+    this.db.exec(statement);
+  }
+  async run(statement, values = []) {
+    await this.open();
+    const stmt = this.db.prepare(statement);
+    const result = stmt.run(...values);
+    return {
+      changes: result.changes,
+      lastId: result.lastInsertRowid !== void 0 ? Number(result.lastInsertRowid) : void 0
+    };
+  }
+  async query(statement, values = []) {
+    await this.open();
+    const stmt = this.db.prepare(statement);
+    const rows = stmt.all(...values);
+    if (rows.length === 0) {
+      return { columns: [], values: [] };
+    }
+    const firstRow = rows[0];
+    const columns = Object.keys(firstRow);
+    const valuesMatrix = rows.map((row) => columns.map((col) => row[col]));
+    return { columns, values: valuesMatrix };
+  }
+  /**
+   * Access the underlying better-sqlite3 Database instance for advanced operations.
+   * Returns null if the database is not open.
+   */
+  getDatabase() {
+    return this.db;
+  }
+  /**
+   * Execute a function within a transaction.
+   * This provides better performance when doing many writes.
+   *
+   * @example
+   * ```ts
+   * await driver.transaction(() => {
+   *   driver.run('INSERT INTO users (name) VALUES (?)', ['Alice']);
+   *   driver.run('INSERT INTO users (name) VALUES (?)', ['Bob']);
+   * });
+   * ```
+   */
+  transaction(fn) {
+    if (!this.db) {
+      throw new Error("Database not open. Call open() first.");
+    }
+    return this.db.transaction(fn)();
+  }
+};
+export {
+  BetterSqlite3Driver
+};
+//# sourceMappingURL=node.js.map

package/dist/node.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/storage/sqlite/drivers/BetterSqlite3Driver.ts"],"sourcesContent":["import type { SQLiteDatabaseDriver, SQLiteQueryResult, SQLiteRunResult } from '../types';\n\n/**\n * Options for configuring the BetterSqlite3Driver.\n */\nexport interface BetterSqlite3DriverOptions {\n    /**\n     * Open the database in readonly mode.\n     * @default false\n     */\n    readonly?: boolean;\n\n    /**\n     * Create the database file if it doesn't exist.\n     * Set to false to throw an error if the file doesn't exist.\n     * @default true\n     */\n    fileMustExist?: boolean;\n\n    /**\n     * Timeout in milliseconds when waiting for the database to become unlocked.\n     * @default 5000\n     */\n    timeout?: number;\n\n    /**\n     * Enable verbose mode for debugging SQL statements.\n     */\n    verbose?: (message?: unknown, ...additionalArgs: unknown[]) => void;\n\n    /**\n     * Enable WAL (Write-Ahead Logging) mode for better concurrent access.\n     * Recommended for most use cases.\n     * @default true\n     */\n    wal?: boolean;\n}\n\n/**\n * SQLite driver for Node.js using better-sqlite3.\n * This driver is synchronous but wraps operations in Promises for API compatibility.\n *\n * @example\n * ```ts\n * import { BetterSqlite3Driver } from '@anfenn/dync/node';\n * import { SQLiteAdapter } from '@anfenn/dync';\n *\n * const driver = new BetterSqlite3Driver('myapp.db', { wal: true });\n * const adapter = new SQLiteAdapter('myapp', driver);\n * ```\n */\nexport class BetterSqlite3Driver implements SQLiteDatabaseDriver {\n    readonly type = 'BetterSqlite3Driver';\n    private db: import('better-sqlite3').Database | null = null;\n    private readonly options: BetterSqlite3DriverOptions;\n    private opened = false;\n    readonly name: string;\n\n    constructor(databasePath: string, options: BetterSqlite3DriverOptions = {}) {\n        this.name = databasePath;\n        this.options = {\n            wal: true,\n            ...options,\n        };\n    }\n\n    async open(): Promise<void> {\n        if (this.opened) return;\n\n        // Dynamic import to avoid bundling issues in non-Electron environments\n        const Database = (await import('better-sqlite3')).default;\n\n        this.db = new Database(this.name, {\n            readonly: this.options.readonly ?? false,\n            fileMustExist: this.options.fileMustExist ?? false,\n            timeout: this.options.timeout ?? 5000,\n            verbose: this.options.verbose,\n        });\n\n        // Enable WAL mode for better concurrent access (recommended)\n        if (this.options.wal && !this.options.readonly) {\n            this.db.pragma('journal_mode = WAL');\n        }\n\n        this.opened = true;\n    }\n\n    async close(): Promise<void> {\n        if (!this.db) return;\n\n        this.db.close();\n        this.db = null;\n        this.opened = false;\n    }\n\n    async execute(statement: string): Promise<void> {\n        await this.open();\n        this.db!.exec(statement);\n    }\n\n    async run(statement: string, values: unknown[] = []): Promise<SQLiteRunResult> {\n        await this.open();\n\n        const stmt = this.db!.prepare(statement);\n        const result = stmt.run(...values);\n\n        return {\n            changes: result.changes,\n            lastId: result.lastInsertRowid !== undefined ? Number(result.lastInsertRowid) : undefined,\n        };\n    }\n\n    async query(statement: string, values: unknown[] = []): Promise<SQLiteQueryResult> {\n        await this.open();\n\n        const stmt = this.db!.prepare(statement);\n        const rows = stmt.all(...values) as Record<string, unknown>[];\n\n        if (rows.length === 0) {\n            return { columns: [], values: [] };\n        }\n\n        const firstRow = rows[0]!;\n        const columns = Object.keys(firstRow);\n        const valuesMatrix = rows.map((row) => columns.map((col) => row[col]));\n\n        return { columns, values: valuesMatrix };\n    }\n\n    /**\n     * Access the underlying better-sqlite3 Database instance for advanced operations.\n     * Returns null if the database is not open.\n     */\n    getDatabase(): import('better-sqlite3').Database | null {\n        return this.db;\n    }\n\n    /**\n     * Execute a function within a transaction.\n     * This provides better performance when doing many writes.\n     *\n     * @example\n     * ```ts\n     * await driver.transaction(() => {\n     *   driver.run('INSERT INTO users (name) VALUES (?)', ['Alice']);\n     *   driver.run('INSERT INTO users (name) VALUES (?)', ['Bob']);\n     * });\n     * ```\n     */\n    transaction<T>(fn: () => T): T {\n        if (!this.db) {\n            throw new Error('Database not open. Call open() first.');\n        }\n        return this.db.transaction(fn)();\n    }\n}\n"],"mappings":";AAmDO,IAAM,sBAAN,MAA0D;AAAA,EACpD,OAAO;AAAA,EACR,KAA+C;AAAA,EACtC;AAAA,EACT,SAAS;AAAA,EACR;AAAA,EAET,YAAY,cAAsB,UAAsC,CAAC,GAAG;AACxE,SAAK,OAAO;AACZ,SAAK,UAAU;AAAA,MACX,KAAK;AAAA,MACL,GAAG;AAAA,IACP;AAAA,EACJ;AAAA,EAEA,MAAM,OAAsB;AACxB,QAAI,KAAK,OAAQ;AAGjB,UAAM,YAAY,MAAM,OAAO,gBAAgB,GAAG;AAElD,SAAK,KAAK,IAAI,SAAS,KAAK,MAAM;AAAA,MAC9B,UAAU,KAAK,QAAQ,YAAY;AAAA,MACnC,eAAe,KAAK,QAAQ,iBAAiB;AAAA,MAC7C,SAAS,KAAK,QAAQ,WAAW;AAAA,MACjC,SAAS,KAAK,QAAQ;AAAA,IAC1B,CAAC;AAGD,QAAI,KAAK,QAAQ,OAAO,CAAC,KAAK,QAAQ,UAAU;AAC5C,WAAK,GAAG,OAAO,oBAAoB;AAAA,IACvC;AAEA,SAAK,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,QAAuB;AACzB,QAAI,CAAC,KAAK,GAAI;AAEd,SAAK,GAAG,MAAM;AACd,SAAK,KAAK;AACV,SAAK,SAAS;AAAA,EAClB;AAAA,EAEA,MAAM,QAAQ,WAAkC;AAC5C,UAAM,KAAK,KAAK;AAChB,SAAK,GAAI,KAAK,SAAS;AAAA,EAC3B;AAAA,EAEA,MAAM,IAAI,WAAmB,SAAoB,CAAC,GAA6B;AAC3E,UAAM,KAAK,KAAK;AAEhB,UAAM,OAAO,KAAK,GAAI,QAAQ,SAAS;AACvC,UAAM,SAAS,KAAK,IAAI,GAAG,MAAM;AAEjC,WAAO;AAAA,MACH,SAAS,OAAO;AAAA,MAChB,QAAQ,OAAO,oBAAoB,SAAY,OAAO,OAAO,eAAe,IAAI;AAAA,IACpF;AAAA,EACJ;AAAA,EAEA,MAAM,MAAM,WAAmB,SAAoB,CAAC,GAA+B;AAC/E,UAAM,KAAK,KAAK;AAEhB,UAAM,OAAO,KAAK,GAAI,QAAQ,SAAS;AACvC,UAAM,OAAO,KAAK,IAAI,GAAG,MAAM;AAE/B,QAAI,KAAK,WAAW,GAAG;AACnB,aAAO,EAAE,SAAS,CAAC,GAAG,QAAQ,CAAC,EAAE;AAAA,IACrC;AAEA,UAAM,WAAW,KAAK,CAAC;AACvB,UAAM,UAAU,OAAO,KAAK,QAAQ;AACpC,UAAM,eAAe,KAAK,IAAI,CAAC,QAAQ,QAAQ,IAAI,CAAC,QAAQ,IAAI,GAAG,CAAC,CAAC;AAErE,WAAO,EAAE,SAAS,QAAQ,aAAa;AAAA,EAC3C;AAAA;AAAA;AAAA;AAAA;AAAA,EAMA,cAAwD;AACpD,WAAO,KAAK;AAAA,EAChB;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAcA,YAAe,IAAgB;AAC3B,QAAI,CAAC,KAAK,IAAI;AACV,YAAM,IAAI,MAAM,uCAAuC;AAAA,IAC3D;AACA,WAAO,KAAK,GAAG,YAAY,EAAE,EAAE;AAAA,EACnC;AACJ;","names":[]}