@devbro/neko-sql 0.1.30 → 0.1.32

package/README.md

@@ -14,16 +14,56 @@ SQL engine for quick abstracted relational database connections.
 currently supported databases:
 
 - postgresql
+- sqlite
 
 future planned:
 
 - mysql
-- sqlite
 - mssql
 
 ## how to use
 
-please check test classes for reboust examples
+### PostgreSQL Example
+
+```typescript
+import { PostgresqlConnection } from '@devbro/neko-sql';
+
+const conn = new PostgresqlConnection({
+  host: 'localhost',
+  database: 'mydb',
+  user: 'myuser',
+  password: 'mypassword',
+  port: 5432,
+});
+
+await conn.connect();
+
+// Use Query builder
+const query = conn.getQuery();
+const results = await query.table('users').whereOp('id', '=', 1).get();
+
+await conn.disconnect();
+```
+
+### SQLite Example
+
+```typescript
+import { SqliteConnection } from '@devbro/neko-sql';
+
+const conn = new SqliteConnection({
+  filename: './database.db',
+});
+
+await conn.connect();
+
+// Use Query builder
+const query = conn.getQuery();
+const results = await query.table('users').whereOp('id', '=', 1).get();
+
+await conn.disconnect();
+```
+
+please check test classes for more robust examples
 
 ## APIs
 

package/dist/databases/index.d.mts

@@ -1,6 +1,10 @@
 export { PostgresqlConnection } from './postgresql/PostgresqlConnection.mjs';
 export { PostgresqlQueryGrammar } from './postgresql/PostgresqlQueryGrammar.mjs';
 export { PostgresqlSchemaGrammar } from './postgresql/PostgresqlSchemaGrammar.mjs';
+export { SqliteConfig, SqliteConnection } from './sqlite/SqliteConnection.mjs';
+export { SqliteQueryGrammar } from './sqlite/SqliteQueryGrammar.mjs';
+export { SqliteSchemaGrammar } from './sqlite/SqliteSchemaGrammar.mjs';
 import '../Blueprint-D3WHeqRS.mjs';
 import '@devbro/neko-helper';
 import 'pg';
+import 'better-sqlite3';

package/dist/databases/index.mjs

@@ -1,2 +1,3 @@
 export * from "./postgresql/index.mjs";
+export * from "./sqlite/index.mjs";
 //# sourceMappingURL=index.mjs.map

package/dist/databases/index.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../src/databases/index.mts"],"sourcesContent":["export * from './postgresql/index.mjs';\n"],"mappings":"AAAA,cAAc;","names":[]}
+{"version":3,"sources":["../../src/databases/index.mts"],"sourcesContent":["export * from './postgresql/index.mjs';\nexport * from './sqlite/index.mjs';\n"],"mappings":"AAAA,cAAc;AACd,cAAc;","names":[]}

package/dist/databases/postgresql/PostgresqlConnection.d.mts

@@ -1,7 +1,7 @@
-import { PostgresqlQueryGrammar } from './PostgresqlQueryGrammar.mjs';
-import { PostgresqlSchemaGrammar } from './PostgresqlSchemaGrammar.mjs';
 import { b as Connection, c as connection_events, m as CompiledSql, d as Query, S as Schema } from '../../Blueprint-D3WHeqRS.mjs';
 import { PoolClient, Pool, PoolConfig } from 'pg';
+import { PostgresqlQueryGrammar } from './PostgresqlQueryGrammar.mjs';
+import { PostgresqlSchemaGrammar } from './PostgresqlSchemaGrammar.mjs';
 import '@devbro/neko-helper';
 
 declare class PostgresqlConnection extends Connection {

package/dist/databases/postgresql/PostgresqlConnection.mjs

@@ -44,7 +44,8 @@ class PostgresqlConnection extends ConnectionAbs {
     }
   }
   async connect() {
-    this.eventManager.emit("connect");
+    this.eventManager.emit("connect").catch(() => {
+    });
     this.connection = await PostgresqlConnection.pool.connect();
     return true;
   }
@@ -57,7 +58,8 @@ class PostgresqlConnection extends ConnectionAbs {
     if (sql.parts && sql.parts.length > 0) {
       sql2 = sql.parts.map((v) => v === "?" ? "$" + counter++ : v).join(" ");
     }
-    this.eventManager.emit("query", { sql: sql2, bindings: sql.bindings });
+    this.eventManager.emit("query", { sql: sql2, bindings: sql.bindings }).catch(() => {
+    });
     if (!this.isConnected()) {
       await this.connect();
     }
@@ -73,7 +75,8 @@ class PostgresqlConnection extends ConnectionAbs {
     }
     await this.connection?.release();
     this.connection = void 0;
-    this.eventManager.emit("disconnect");
+    this.eventManager.emit("disconnect").catch(() => {
+    });
     return true;
   }
   getQuery() {
@@ -97,9 +100,8 @@ class PostgresqlConnection extends ConnectionAbs {
   async rollback() {
     await this.runQuery({ sql: "ROLLBACK", bindings: [], parts: ["ROLLBACK"] });
   }
-  static async destroy() {
-    PostgresqlConnection.pool.end();
-    return;
+  static destroy() {
+    return PostgresqlConnection.pool.end();
   }
   isConnected() {
     return this.connection !== void 0;
@@ -136,7 +138,7 @@ class PostgresqlConnection extends ConnectionAbs {
     if (this.isConnected()) {
       throw new Error("Cannot create database while connected.");
     }
-    let conn = new Client({
+    const conn = new Client({
       ...PostgresqlConnection.pool.options,
       database: "postgres"
     });
@@ -149,7 +151,7 @@ class PostgresqlConnection extends ConnectionAbs {
     if (this.isConnected()) {
       throw new Error("Cannot drop database while connected.");
     }
-    let conn = new Client({
+    const conn = new Client({
       ...PostgresqlConnection.pool.options,
       database: "postgres"
       // connect to default 'postgres' database to drop others

package/dist/databases/postgresql/PostgresqlConnection.mjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../../../src/databases/postgresql/PostgresqlConnection.mts"],"sourcesContent":["import { connection_events, Connection as ConnectionAbs } from '../../Connection.mjs';\nimport { Client, PoolClient, PoolConfig } from 'pg';\nimport { Pool } from 'pg';\nimport { CompiledSql } from '../../types.mjs';\nimport { Query } from '../../Query.mjs';\nimport { PostgresqlQueryGrammar } from './PostgresqlQueryGrammar.mjs';\nimport { Schema } from '../../Schema.mjs';\nimport { PostgresqlSchemaGrammar } from './PostgresqlSchemaGrammar.mjs';\nimport Cursor from 'pg-cursor';\nimport { EventManager } from '@devbro/neko-helper';\n\nexport class PostgresqlConnection extends ConnectionAbs {\n  private eventManager = new EventManager();\n\n  on(event: connection_events, listener: (...args: any[]) => void): this {\n    this.eventManager.on(event, listener);\n    return this;\n  }\n  off(event: connection_events, listener: (...args: any[]) => void): this {\n    this.eventManager.off(event, listener);\n    return this;\n  }\n  emit(event: connection_events, ...args: any[]): Promise<boolean> {\n    return this.eventManager.emit(event, ...args);\n  }\n\n  connection: PoolClient | undefined;\n  static pool: Pool;\n\n  static defaults: PoolConfig = {\n    port: 5432,\n    ssl: false,\n    max: 20,\n    idleTimeoutMillis: 1, // wait X milli seconds before closing an idle/released connection\n    connectionTimeoutMillis: 30000, // wait up to 30 seconds to obtain a new connection\n    maxUses: 7500,\n  };\n\n  constructor(params: PoolConfig) {\n    super();\n    if (!PostgresqlConnection.pool) {\n      PostgresqlConnection.pool = new Pool({ ...PostgresqlConnection.defaults, ...params });\n    }\n  }\n  async connect(): Promise<boolean> {\n    this.eventManager.emit('connect');\n    this.connection = await PostgresqlConnection.pool.connect();\n    return true;\n  }\n  async runQuery(sql: CompiledSql | string): Promise<any> {\n    if( typeof sql === 'string') {\n      sql = { sql: sql, bindings: [], parts: [sql] };\n    }\n    let counter = 1;\n    let sql2 = sql.sql;\n    if (sql.parts && sql.parts.length > 0) {\n      sql2 = sql.parts.map((v) => (v === '?' ? '$' + counter++ : v)).join(' ');\n    }\n\n    this.eventManager.emit('query', { sql: sql2, bindings: sql.bindings });\n\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n    const result = await this.connection!.query(sql2, sql.bindings);\n    return result?.rows;\n  }\n\n  async runCursor(sql: CompiledSql): Promise<any> {\n    return this.connection?.query(new Cursor(sql.sql, sql.bindings));\n  }\n\n  async disconnect(): Promise<boolean> {\n    if (this.connection === undefined) {\n      return true;\n    }\n    await this.connection?.release();\n    this.connection = undefined;\n    this.eventManager.emit('disconnect');\n    return true;\n  }\n\n  getQuery(): Query {\n    return new Query(this, new PostgresqlQueryGrammar());\n  }\n\n  getSchema(): Schema {\n    return new Schema(this, new PostgresqlSchemaGrammar());\n  }\n\n  getQueryGrammar(): PostgresqlQueryGrammar {\n    return new PostgresqlQueryGrammar();\n  }\n  getSchemaGrammar(): PostgresqlSchemaGrammar {\n    return new PostgresqlSchemaGrammar();\n  }\n\n  async beginTransaction(): Promise<void> {\n    await this.runQuery({ sql: 'BEGIN', bindings: [], parts: ['BEGIN'] });\n  }\n\n  async commit(): Promise<void> {\n    await this.runQuery({ sql: 'COMMIT', bindings: [], parts: ['COMMIT'] });\n  }\n\n  async rollback(): Promise<void> {\n    await this.runQuery({ sql: 'ROLLBACK', bindings: [], parts: ['ROLLBACK'] });\n  }\n\n  static async destroy(): Promise<void> {\n    PostgresqlConnection.pool.end();\n    return;\n  }\n\n  isConnected(): boolean {\n    return this.connection !== undefined;\n  }\n\n  /**\n   * Validates and escapes a PostgreSQL identifier (database name, table name, etc.)\n   * Uses a whitelist approach to ensure only safe characters are allowed\n   */\n  private validateAndEscapeIdentifier(name: string): string {\n    // PostgreSQL identifiers can contain: letters, digits, underscores, and dollar signs\n    // They must start with a letter or underscore\n    const validIdentifierPattern = /^[a-zA-Z_][a-zA-Z0-9_$]*$/;\n\n    if (!validIdentifierPattern.test(name)) {\n      throw new Error(\n        `Invalid identifier: \"${name}\". Identifiers must start with a letter or underscore and contain only letters, digits, underscores, and dollar signs.`\n      );\n    }\n\n    // PostgreSQL reserved keywords that should be quoted\n    const reservedKeywords = new Set([\n      'user',\n      'table',\n      'database',\n      'order',\n      'group',\n      'select',\n      'insert',\n      'update',\n      'delete',\n    ]);\n\n    // Quote the identifier if it's a reserved keyword or contains uppercase letters\n    if (reservedKeywords.has(name.toLowerCase()) || name !== name.toLowerCase()) {\n      // Escape any double quotes in the name\n      const escapedName = name.replace(/\"/g, '\"\"');\n      return `\"${escapedName}\"`;\n    }\n\n    return name;\n  }\n\n  async createDatabase(name: string): Promise<void> {\n    if (this.isConnected()) {\n      throw new Error('Cannot create database while connected.');\n    }\n\n    let conn = new Client({\n      ...PostgresqlConnection.pool.options,\n      database: 'postgres',\n    });\n    await conn.connect();\n    const safeName = this.validateAndEscapeIdentifier(name);\n    await conn.query(`CREATE DATABASE ${safeName}`);\n    await conn.end();\n  }\n\n  async dropDatabase(name: string): Promise<void> {\n    if (this.isConnected()) {\n      throw new Error('Cannot drop database while connected.');\n    }\n\n    let conn = new Client({\n      ...PostgresqlConnection.pool.options,\n      database: 'postgres', // connect to default 'postgres' database to drop others\n    });\n    await conn.connect();\n    const safeName = this.validateAndEscapeIdentifier(name);\n    await conn.query(`DROP DATABASE ${safeName}`);\n    await conn.end();\n  }\n\n  async listDatabases(): Promise<string[]> {\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n    const result = await this.connection!.query(\n      'SELECT datname FROM pg_database WHERE datistemplate = false ORDER BY datname'\n    );\n    return result.rows.map((row: any) => row.datname);\n  }\n\n  async existsDatabase(name: string): Promise<boolean> {\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n    const result = await this.connection!.query('SELECT 1 FROM pg_database WHERE datname = $1', [\n      name,\n    ]);\n    return result.rows.length > 0;\n  }\n}\n"],"mappings":"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","names":[]}
+{"version":3,"sources":["../../../src/databases/postgresql/PostgresqlConnection.mts"],"sourcesContent":["import { connection_events, Connection as ConnectionAbs } from '../../Connection.mjs';\nimport { Client, PoolClient, PoolConfig } from 'pg';\nimport { Pool } from 'pg';\nimport { CompiledSql } from '../../types.mjs';\nimport { Query } from '../../Query.mjs';\nimport { PostgresqlQueryGrammar } from './PostgresqlQueryGrammar.mjs';\nimport { Schema } from '../../Schema.mjs';\nimport { PostgresqlSchemaGrammar } from './PostgresqlSchemaGrammar.mjs';\nimport Cursor from 'pg-cursor';\nimport { EventManager } from '@devbro/neko-helper';\n\nexport class PostgresqlConnection extends ConnectionAbs {\n  private eventManager = new EventManager();\n\n  on(event: connection_events, listener: (...args: any[]) => void): this {\n    this.eventManager.on(event, listener);\n    return this;\n  }\n  off(event: connection_events, listener: (...args: any[]) => void): this {\n    this.eventManager.off(event, listener);\n    return this;\n  }\n  emit(event: connection_events, ...args: any[]): Promise<boolean> {\n    return this.eventManager.emit(event, ...args);\n  }\n\n  connection: PoolClient | undefined;\n  static pool: Pool;\n\n  static defaults: PoolConfig = {\n    port: 5432,\n    ssl: false,\n    max: 20,\n    idleTimeoutMillis: 1, // wait X milli seconds before closing an idle/released connection\n    connectionTimeoutMillis: 30000, // wait up to 30 seconds to obtain a new connection\n    maxUses: 7500,\n  };\n\n  constructor(params: PoolConfig) {\n    super();\n    if (!PostgresqlConnection.pool) {\n      PostgresqlConnection.pool = new Pool({ ...PostgresqlConnection.defaults, ...params });\n    }\n  }\n  async connect(): Promise<boolean> {\n    this.eventManager.emit('connect').catch(() => {});\n    this.connection = await PostgresqlConnection.pool.connect();\n    return true;\n  }\n  async runQuery(sql: CompiledSql | string): Promise<any> {\n    if (typeof sql === 'string') {\n      sql = { sql: sql, bindings: [], parts: [sql] };\n    }\n    let counter = 1;\n    let sql2 = sql.sql;\n    if (sql.parts && sql.parts.length > 0) {\n      sql2 = sql.parts.map((v) => (v === '?' ? '$' + counter++ : v)).join(' ');\n    }\n\n    this.eventManager.emit('query', { sql: sql2, bindings: sql.bindings }).catch(() => {});\n\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n    const result = await this.connection!.query(sql2, sql.bindings);\n    return result?.rows;\n  }\n\n  async runCursor(sql: CompiledSql): Promise<any> {\n    return this.connection?.query(new Cursor(sql.sql, sql.bindings));\n  }\n\n  async disconnect(): Promise<boolean> {\n    if (this.connection === undefined) {\n      return true;\n    }\n    await this.connection?.release();\n    this.connection = undefined;\n    this.eventManager.emit('disconnect').catch(() => {});\n    return true;\n  }\n\n  getQuery(): Query {\n    return new Query(this, new PostgresqlQueryGrammar());\n  }\n\n  getSchema(): Schema {\n    return new Schema(this, new PostgresqlSchemaGrammar());\n  }\n\n  getQueryGrammar(): PostgresqlQueryGrammar {\n    return new PostgresqlQueryGrammar();\n  }\n  getSchemaGrammar(): PostgresqlSchemaGrammar {\n    return new PostgresqlSchemaGrammar();\n  }\n\n  async beginTransaction(): Promise<void> {\n    await this.runQuery({ sql: 'BEGIN', bindings: [], parts: ['BEGIN'] });\n  }\n\n  async commit(): Promise<void> {\n    await this.runQuery({ sql: 'COMMIT', bindings: [], parts: ['COMMIT'] });\n  }\n\n  async rollback(): Promise<void> {\n    await this.runQuery({ sql: 'ROLLBACK', bindings: [], parts: ['ROLLBACK'] });\n  }\n\n  static destroy(): Promise<void> {\n    return PostgresqlConnection.pool.end();\n  }\n\n  isConnected(): boolean {\n    return this.connection !== undefined;\n  }\n\n  /**\n   * Validates and escapes a PostgreSQL identifier (database name, table name, etc.)\n   * Uses a whitelist approach to ensure only safe characters are allowed\n   */\n  private validateAndEscapeIdentifier(name: string): string {\n    // PostgreSQL identifiers can contain: letters, digits, underscores, and dollar signs\n    // They must start with a letter or underscore\n    const validIdentifierPattern = /^[a-zA-Z_][a-zA-Z0-9_$]*$/;\n\n    if (!validIdentifierPattern.test(name)) {\n      throw new Error(\n        `Invalid identifier: \"${name}\". Identifiers must start with a letter or underscore and contain only letters, digits, underscores, and dollar signs.`\n      );\n    }\n\n    // PostgreSQL reserved keywords that should be quoted\n    const reservedKeywords = new Set([\n      'user',\n      'table',\n      'database',\n      'order',\n      'group',\n      'select',\n      'insert',\n      'update',\n      'delete',\n    ]);\n\n    // Quote the identifier if it's a reserved keyword or contains uppercase letters\n    if (reservedKeywords.has(name.toLowerCase()) || name !== name.toLowerCase()) {\n      // Escape any double quotes in the name\n      const escapedName = name.replace(/\"/g, '\"\"');\n      return `\"${escapedName}\"`;\n    }\n\n    return name;\n  }\n\n  async createDatabase(name: string): Promise<void> {\n    if (this.isConnected()) {\n      throw new Error('Cannot create database while connected.');\n    }\n\n    const conn = new Client({\n      ...PostgresqlConnection.pool.options,\n      database: 'postgres',\n    });\n    await conn.connect();\n    const safeName = this.validateAndEscapeIdentifier(name);\n    await conn.query(`CREATE DATABASE ${safeName}`);\n    await conn.end();\n  }\n\n  async dropDatabase(name: string): Promise<void> {\n    if (this.isConnected()) {\n      throw new Error('Cannot drop database while connected.');\n    }\n\n    const conn = new Client({\n      ...PostgresqlConnection.pool.options,\n      database: 'postgres', // connect to default 'postgres' database to drop others\n    });\n    await conn.connect();\n    const safeName = this.validateAndEscapeIdentifier(name);\n    await conn.query(`DROP DATABASE ${safeName}`);\n    await conn.end();\n  }\n\n  async listDatabases(): Promise<string[]> {\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n    const result = await this.connection!.query(\n      'SELECT datname FROM pg_database WHERE datistemplate = false ORDER BY datname'\n    );\n    return result.rows.map((row: any) => row.datname);\n  }\n\n  async existsDatabase(name: string): Promise<boolean> {\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n    const result = await this.connection!.query('SELECT 1 FROM pg_database WHERE datname = $1', [\n      name,\n    ]);\n    return result.rows.length > 0;\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/databases/sqlite/SqliteConnection.d.mts

@@ -0,0 +1,132 @@
+import { b as Connection, c as connection_events, m as CompiledSql, d as Query, S as Schema } from '../../Blueprint-D3WHeqRS.mjs';
+import Database from 'better-sqlite3';
+import { SqliteQueryGrammar } from './SqliteQueryGrammar.mjs';
+import { SqliteSchemaGrammar } from './SqliteSchemaGrammar.mjs';
+import '@devbro/neko-helper';
+
+/**
+ * Configuration options for SQLite database connection
+ */
+interface SqliteConfig {
+    /** Path to the SQLite database file */
+    filename: string;
+    /** Open the database in read-only mode (default: false) */
+    readonly?: boolean;
+    /** Throw an error if the database file doesn't exist (default: false) */
+    fileMustExist?: boolean;
+    /** Timeout in milliseconds for database operations (default: 5000) */
+    timeout?: number;
+    /** Optional verbose logging function for debugging SQL statements */
+    verbose?: (message?: unknown, ...additionalArgs: unknown[]) => void;
+}
+/**
+ * SQLite database connection implementation
+ *
+ * Provides a connection to SQLite databases using better-sqlite3.
+ * Supports transactions, queries, schema operations, and database management.
+ */
+declare class SqliteConnection extends Connection {
+    private eventManager;
+    on(event: connection_events, listener: (...args: any[]) => void): this;
+    off(event: connection_events, listener: (...args: any[]) => void): this;
+    emit(event: connection_events, ...args: any[]): Promise<boolean>;
+    connection: Database.Database | undefined;
+    private config;
+    /** Default configuration values for SQLite connections */
+    static defaults: Partial<SqliteConfig>;
+    constructor(params: SqliteConfig);
+    /**
+     * Establishes a connection to the SQLite database
+     * Creates or opens the database file specified in the configuration
+     */
+    connect(): Promise<boolean>;
+    /**
+     * Executes a SQL query against the database
+     * Automatically detects SELECT queries and queries with RETURNING clauses
+     *
+     * @param sql - Compiled SQL or raw SQL string to execute
+     * @returns Query results (rows for SELECT, run info for INSERT/UPDATE/DELETE)
+     */
+    runQuery(sql: CompiledSql | string): Promise<any>;
+    /**
+     * Executes a query and returns an iterator for streaming results
+     * Useful for large result sets to avoid loading all rows into memory
+     *
+     * @param sql - Compiled SQL to execute
+     * @returns Iterator over query results
+     */
+    runCursor(sql: CompiledSql): Promise<any>;
+    /**
+     * Closes the database connection
+     */
+    disconnect(): Promise<boolean>;
+    /**
+     * Creates a new query builder instance for this connection
+     */
+    getQuery(): Query;
+    /**
+     * Creates a new schema builder instance for this connection
+     */
+    getSchema(): Schema;
+    /**
+     * Gets the query grammar for building SQL statements
+     */
+    getQueryGrammar(): SqliteQueryGrammar;
+    /**
+     * Gets the schema grammar for building DDL statements
+     */
+    getSchemaGrammar(): SqliteSchemaGrammar;
+    /**
+     * Starts a new database transaction
+     */
+    beginTransaction(): Promise<void>;
+    /**
+     * Commits the current transaction
+     */
+    commit(): Promise<void>;
+    /**
+     * Rolls back the current transaction
+     */
+    rollback(): Promise<void>;
+    /**
+     * Checks if the database connection is active
+     */
+    isConnected(): boolean;
+    /**
+     * Validates and escapes a SQLite identifier (database name, table name, etc.)
+     * Uses a whitelist approach to ensure only safe characters are allowed
+     *
+     * @param name - The identifier to validate and escape
+     * @returns The escaped identifier, quoted if it's a reserved keyword
+     * @throws Error if the identifier contains invalid characters
+     */
+    private validateAndEscapeIdentifier;
+    /**
+     * Creates a new SQLite database file
+     *
+     * @param name - Name or path of the database file to create
+     */
+    createDatabase(name: string): Promise<void>;
+    /**
+     * Deletes a SQLite database file
+     *
+     * @param name - Name or path of the database file to delete
+     */
+    dropDatabase(name: string): Promise<void>;
+    /**
+     * Lists available databases
+     * For SQLite, this returns the current database filename
+     *
+     * @returns Array containing the current database filename
+     */
+    listDatabases(): Promise<string[]>;
+    /**
+     * Checks if a database file exists
+     *
+     * @param name - Name or path of the database file to check
+     * @returns True if the database file exists, false otherwise
+     */
+    existsDatabase(name: string): Promise<boolean>;
+}
+
+export { type SqliteConfig, SqliteConnection };

package/dist/databases/sqlite/SqliteConnection.mjs

@@ -0,0 +1,242 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { Connection as ConnectionAbs } from "../../Connection.mjs";
+import Database from "better-sqlite3";
+import { Query } from "../../Query.mjs";
+import { SqliteQueryGrammar } from "./SqliteQueryGrammar.mjs";
+import { Schema } from "../../Schema.mjs";
+import { SqliteSchemaGrammar } from "./SqliteSchemaGrammar.mjs";
+import { EventManager } from "@devbro/neko-helper";
+import * as fs from "fs";
+class SqliteConnection extends ConnectionAbs {
+  static {
+    __name(this, "SqliteConnection");
+  }
+  eventManager = new EventManager();
+  on(event, listener) {
+    this.eventManager.on(event, listener);
+    return this;
+  }
+  off(event, listener) {
+    this.eventManager.off(event, listener);
+    return this;
+  }
+  emit(event, ...args) {
+    return this.eventManager.emit(event, ...args);
+  }
+  connection;
+  config;
+  /** Default configuration values for SQLite connections */
+  static defaults = {
+    readonly: false,
+    fileMustExist: false,
+    timeout: 5e3
+  };
+  constructor(params) {
+    super();
+    this.config = { ...SqliteConnection.defaults, ...params };
+  }
+  /**
+   * Establishes a connection to the SQLite database
+   * Creates or opens the database file specified in the configuration
+   */
+  async connect() {
+    this.eventManager.emit("connect").catch(() => {
+    });
+    this.connection = new Database(this.config.filename, {
+      readonly: this.config.readonly,
+      fileMustExist: this.config.fileMustExist,
+      timeout: this.config.timeout,
+      verbose: this.config.verbose
+    });
+    return true;
+  }
+  /**
+   * Executes a SQL query against the database
+   * Automatically detects SELECT queries and queries with RETURNING clauses
+   *
+   * @param sql - Compiled SQL or raw SQL string to execute
+   * @returns Query results (rows for SELECT, run info for INSERT/UPDATE/DELETE)
+   */
+  async runQuery(sql) {
+    if (typeof sql === "string") {
+      sql = { sql, bindings: [], parts: [sql] };
+    }
+    this.eventManager.emit("query", { sql: sql.sql, bindings: sql.bindings }).catch(() => {
+    });
+    if (!this.isConnected()) {
+      await this.connect();
+    }
+    try {
+      const stmt = this.connection.prepare(sql.sql);
+      const sqlUpper = sql.sql.trim().toUpperCase();
+      if (sqlUpper.startsWith("SELECT") || sqlUpper.includes("RETURNING")) {
+        return stmt.all(...sql.bindings);
+      } else {
+        const result = stmt.run(...sql.bindings);
+        return result;
+      }
+    } catch (error) {
+      this.eventManager.emit("error", error).catch(() => {
+      });
+      throw error;
+    }
+  }
+  /**
+   * Executes a query and returns an iterator for streaming results
+   * Useful for large result sets to avoid loading all rows into memory
+   *
+   * @param sql - Compiled SQL to execute
+   * @returns Iterator over query results
+   */
+  async runCursor(sql) {
+    if (!this.isConnected()) {
+      await this.connect();
+    }
+    const stmt = this.connection.prepare(sql.sql);
+    return stmt.iterate(...sql.bindings);
+  }
+  /**
+   * Closes the database connection
+   */
+  async disconnect() {
+    if (this.connection === void 0) {
+      return true;
+    }
+    this.connection.close();
+    this.connection = void 0;
+    this.eventManager.emit("disconnect").catch(() => {
+    });
+    return true;
+  }
+  /**
+   * Creates a new query builder instance for this connection
+   */
+  getQuery() {
+    return new Query(this, new SqliteQueryGrammar());
+  }
+  /**
+   * Creates a new schema builder instance for this connection
+   */
+  getSchema() {
+    return new Schema(this, new SqliteSchemaGrammar());
+  }
+  /**
+   * Gets the query grammar for building SQL statements
+   */
+  getQueryGrammar() {
+    return new SqliteQueryGrammar();
+  }
+  /**
+   * Gets the schema grammar for building DDL statements
+   */
+  getSchemaGrammar() {
+    return new SqliteSchemaGrammar();
+  }
+  /**
+   * Starts a new database transaction
+   */
+  async beginTransaction() {
+    await this.runQuery({
+      sql: "BEGIN TRANSACTION",
+      bindings: [],
+      parts: ["BEGIN", "TRANSACTION"]
+    });
+  }
+  /**
+   * Commits the current transaction
+   */
+  async commit() {
+    await this.runQuery({ sql: "COMMIT", bindings: [], parts: ["COMMIT"] });
+  }
+  /**
+   * Rolls back the current transaction
+   */
+  async rollback() {
+    await this.runQuery({ sql: "ROLLBACK", bindings: [], parts: ["ROLLBACK"] });
+  }
+  /**
+   * Checks if the database connection is active
+   */
+  isConnected() {
+    return this.connection !== void 0 && this.connection.open;
+  }
+  /**
+   * Validates and escapes a SQLite identifier (database name, table name, etc.)
+   * Uses a whitelist approach to ensure only safe characters are allowed
+   *
+   * @param name - The identifier to validate and escape
+   * @returns The escaped identifier, quoted if it's a reserved keyword
+   * @throws Error if the identifier contains invalid characters
+   */
+  validateAndEscapeIdentifier(name) {
+    const validIdentifierPattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;
+    if (!validIdentifierPattern.test(name)) {
+      throw new Error(
+        `Invalid identifier: "${name}". Identifiers must start with a letter or underscore and contain only letters, digits, and underscores.`
+      );
+    }
+    const reservedKeywords = /* @__PURE__ */ new Set([
+      "table",
+      "database",
+      "order",
+      "group",
+      "select",
+      "insert",
+      "update",
+      "delete",
+      "index",
+      "from",
+      "where"
+    ]);
+    if (reservedKeywords.has(name.toLowerCase())) {
+      const escapedName = name.replace(/"/g, '""');
+      return `"${escapedName}"`;
+    }
+    return name;
+  }
+  /**
+   * Creates a new SQLite database file
+   *
+   * @param name - Name or path of the database file to create
+   */
+  async createDatabase(name) {
+    const dbPath = name.endsWith(".db") ? name : `${name}.db`;
+    const tempDb = new Database(dbPath);
+    tempDb.close();
+  }
+  /**
+   * Deletes a SQLite database file
+   *
+   * @param name - Name or path of the database file to delete
+   */
+  async dropDatabase(name) {
+    const dbPath = name.endsWith(".db") ? name : `${name}.db`;
+    if (fs.existsSync(dbPath)) {
+      fs.unlinkSync(dbPath);
+    }
+  }
+  /**
+   * Lists available databases
+   * For SQLite, this returns the current database filename
+   *
+   * @returns Array containing the current database filename
+   */
+  async listDatabases() {
+    return [this.config.filename];
+  }
+  /**
+   * Checks if a database file exists
+   *
+   * @param name - Name or path of the database file to check
+   * @returns True if the database file exists, false otherwise
+   */
+  async existsDatabase(name) {
+    const dbPath = name.endsWith(".db") ? name : `${name}.db`;
+    return fs.existsSync(dbPath);
+  }
+}
+export {
+  SqliteConnection
+};
+//# sourceMappingURL=SqliteConnection.mjs.map

package/dist/databases/sqlite/SqliteConnection.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../src/databases/sqlite/SqliteConnection.mts"],"sourcesContent":["import { connection_events, Connection as ConnectionAbs } from '../../Connection.mjs';\nimport Database from 'better-sqlite3';\nimport { CompiledSql } from '../../types.mjs';\nimport { Query } from '../../Query.mjs';\nimport { SqliteQueryGrammar } from './SqliteQueryGrammar.mjs';\nimport { Schema } from '../../Schema.mjs';\nimport { SqliteSchemaGrammar } from './SqliteSchemaGrammar.mjs';\nimport { EventManager } from '@devbro/neko-helper';\nimport * as fs from 'fs';\n\n/**\n * Configuration options for SQLite database connection\n */\nexport interface SqliteConfig {\n  /** Path to the SQLite database file */\n  filename: string;\n  /** Open the database in read-only mode (default: false) */\n  readonly?: boolean;\n  /** Throw an error if the database file doesn't exist (default: false) */\n  fileMustExist?: boolean;\n  /** Timeout in milliseconds for database operations (default: 5000) */\n  timeout?: number;\n  /** Optional verbose logging function for debugging SQL statements */\n  verbose?: (message?: unknown, ...additionalArgs: unknown[]) => void;\n}\n\n/**\n * SQLite database connection implementation\n *\n * Provides a connection to SQLite databases using better-sqlite3.\n * Supports transactions, queries, schema operations, and database management.\n */\nexport class SqliteConnection extends ConnectionAbs {\n  private eventManager = new EventManager();\n\n  on(event: connection_events, listener: (...args: any[]) => void): this {\n    this.eventManager.on(event, listener);\n    return this;\n  }\n  off(event: connection_events, listener: (...args: any[]) => void): this {\n    this.eventManager.off(event, listener);\n    return this;\n  }\n  emit(event: connection_events, ...args: any[]): Promise<boolean> {\n    return this.eventManager.emit(event, ...args);\n  }\n\n  connection: Database.Database | undefined;\n  private config: SqliteConfig;\n\n  /** Default configuration values for SQLite connections */\n  static defaults: Partial<SqliteConfig> = {\n    readonly: false,\n    fileMustExist: false,\n    timeout: 5000,\n  };\n\n  constructor(params: SqliteConfig) {\n    super();\n    this.config = { ...SqliteConnection.defaults, ...params } as SqliteConfig;\n  }\n\n  /**\n   * Establishes a connection to the SQLite database\n   * Creates or opens the database file specified in the configuration\n   */\n  async connect(): Promise<boolean> {\n    this.eventManager.emit('connect').catch(() => {});\n    this.connection = new Database(this.config.filename, {\n      readonly: this.config.readonly,\n      fileMustExist: this.config.fileMustExist,\n      timeout: this.config.timeout,\n      verbose: this.config.verbose,\n    });\n    return true;\n  }\n\n  /**\n   * Executes a SQL query against the database\n   * Automatically detects SELECT queries and queries with RETURNING clauses\n   *\n   * @param sql - Compiled SQL or raw SQL string to execute\n   * @returns Query results (rows for SELECT, run info for INSERT/UPDATE/DELETE)\n   */\n  async runQuery(sql: CompiledSql | string): Promise<any> {\n    if (typeof sql === 'string') {\n      sql = { sql: sql, bindings: [], parts: [sql] };\n    }\n\n    this.eventManager.emit('query', { sql: sql.sql, bindings: sql.bindings }).catch(() => {});\n\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n\n    try {\n      const stmt = this.connection!.prepare(sql.sql);\n\n      // Check if the query is a SELECT or contains RETURNING clause\n      const sqlUpper = sql.sql.trim().toUpperCase();\n      if (sqlUpper.startsWith('SELECT') || sqlUpper.includes('RETURNING')) {\n        return stmt.all(...sql.bindings);\n      } else {\n        const result = stmt.run(...sql.bindings);\n        return result;\n      }\n    } catch (error) {\n      this.eventManager.emit('error', error).catch(() => {});\n      throw error;\n    }\n  }\n\n  /**\n   * Executes a query and returns an iterator for streaming results\n   * Useful for large result sets to avoid loading all rows into memory\n   *\n   * @param sql - Compiled SQL to execute\n   * @returns Iterator over query results\n   */\n  async runCursor(sql: CompiledSql): Promise<any> {\n    // SQLite doesn't have native cursor support, return iterator\n    if (!this.isConnected()) {\n      await this.connect();\n    }\n    const stmt = this.connection!.prepare(sql.sql);\n    return stmt.iterate(...sql.bindings);\n  }\n\n  /**\n   * Closes the database connection\n   */\n  async disconnect(): Promise<boolean> {\n    if (this.connection === undefined) {\n      return true;\n    }\n    this.connection.close();\n    this.connection = undefined;\n    this.eventManager.emit('disconnect').catch(() => {});\n    return true;\n  }\n\n  /**\n   * Creates a new query builder instance for this connection\n   */\n  getQuery(): Query {\n    return new Query(this, new SqliteQueryGrammar());\n  }\n\n  /**\n   * Creates a new schema builder instance for this connection\n   */\n  getSchema(): Schema {\n    return new Schema(this, new SqliteSchemaGrammar());\n  }\n\n  /**\n   * Gets the query grammar for building SQL statements\n   */\n  getQueryGrammar(): SqliteQueryGrammar {\n    return new SqliteQueryGrammar();\n  }\n\n  /**\n   * Gets the schema grammar for building DDL statements\n   */\n  getSchemaGrammar(): SqliteSchemaGrammar {\n    return new SqliteSchemaGrammar();\n  }\n\n  /**\n   * Starts a new database transaction\n   */\n  async beginTransaction(): Promise<void> {\n    await this.runQuery({\n      sql: 'BEGIN TRANSACTION',\n      bindings: [],\n      parts: ['BEGIN', 'TRANSACTION'],\n    });\n  }\n\n  /**\n   * Commits the current transaction\n   */\n  async commit(): Promise<void> {\n    await this.runQuery({ sql: 'COMMIT', bindings: [], parts: ['COMMIT'] });\n  }\n\n  /**\n   * Rolls back the current transaction\n   */\n  async rollback(): Promise<void> {\n    await this.runQuery({ sql: 'ROLLBACK', bindings: [], parts: ['ROLLBACK'] });\n  }\n\n  /**\n   * Checks if the database connection is active\n   */\n  isConnected(): boolean {\n    return this.connection !== undefined && this.connection.open;\n  }\n\n  /**\n   * Validates and escapes a SQLite identifier (database name, table name, etc.)\n   * Uses a whitelist approach to ensure only safe characters are allowed\n   *\n   * @param name - The identifier to validate and escape\n   * @returns The escaped identifier, quoted if it's a reserved keyword\n   * @throws Error if the identifier contains invalid characters\n   */\n  private validateAndEscapeIdentifier(name: string): string {\n    // SQLite identifiers can contain: letters, digits, underscores\n    // They must start with a letter or underscore\n    const validIdentifierPattern = /^[a-zA-Z_][a-zA-Z0-9_]*$/;\n\n    if (!validIdentifierPattern.test(name)) {\n      throw new Error(\n        `Invalid identifier: \"${name}\". Identifiers must start with a letter or underscore and contain only letters, digits, and underscores.`\n      );\n    }\n\n    // SQLite reserved keywords that should be quoted\n    const reservedKeywords = new Set([\n      'table',\n      'database',\n      'order',\n      'group',\n      'select',\n      'insert',\n      'update',\n      'delete',\n      'index',\n      'from',\n      'where',\n    ]);\n\n    // Quote the identifier if it's a reserved keyword\n    if (reservedKeywords.has(name.toLowerCase())) {\n      // Escape any double quotes in the name\n      const escapedName = name.replace(/\"/g, '\"\"');\n      return `\"${escapedName}\"`;\n    }\n\n    return name;\n  }\n\n  /**\n   * Creates a new SQLite database file\n   *\n   * @param name - Name or path of the database file to create\n   */\n  async createDatabase(name: string): Promise<void> {\n    // SQLite databases are files, creating a database means creating a new connection\n    const dbPath = name.endsWith('.db') ? name : `${name}.db`;\n    const tempDb = new Database(dbPath);\n    tempDb.close();\n  }\n\n  /**\n   * Deletes a SQLite database file\n   *\n   * @param name - Name or path of the database file to delete\n   */\n  async dropDatabase(name: string): Promise<void> {\n    // SQLite databases are files, dropping means deleting the file\n    const dbPath = name.endsWith('.db') ? name : `${name}.db`;\n    if (fs.existsSync(dbPath)) {\n      fs.unlinkSync(dbPath);\n    }\n  }\n\n  /**\n   * Lists available databases\n   * For SQLite, this returns the current database filename\n   *\n   * @returns Array containing the current database filename\n   */\n  async listDatabases(): Promise<string[]> {\n    // SQLite doesn't have a concept of multiple databases in the same connection\n    // This would require listing files in a directory\n    return [this.config.filename];\n  }\n\n  /**\n   * Checks if a database file exists\n   *\n   * @param name - Name or path of the database file to check\n   * @returns True if the database file exists, false otherwise\n   */\n  async existsDatabase(name: string): Promise<boolean> {\n    const dbPath = name.endsWith('.db') ? name : `${name}.db`;\n    return fs.existsSync(dbPath);\n  }\n}\n"],"mappings":"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","names":[]}

package/dist/databases/sqlite/SqliteQueryGrammar.d.mts

@@ -0,0 +1,17 @@
+import { e as QueryGrammar, d as Query, m as CompiledSql, P as Parameter } from '../../Blueprint-D3WHeqRS.mjs';
+import '@devbro/neko-helper';
+
+declare class SqliteQueryGrammar extends QueryGrammar {
+    constructor();
+    toSql(query: Query): CompiledSql;
+    compileInsert(query: Query, data: Record<string, any>): CompiledSql;
+    compileInsertGetId(query: Query, data: Record<string, any>, options?: {
+        primaryKey: string[];
+    }): CompiledSql;
+    compileUpdate(query: Query, data: Record<string, any>): CompiledSql;
+    compileDelete(query: Query): CompiledSql;
+    compileUpsert(query: Query, data: Record<string, Parameter>, conflictFields: string[], updateFields: string[]): CompiledSql;
+    compileCount(query: Query): CompiledSql;
+}
+
+export { SqliteQueryGrammar };

package/dist/databases/sqlite/SqliteQueryGrammar.mjs

@@ -0,0 +1,40 @@
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+import { QueryGrammar } from "../../QueryGrammar.mjs";
+import { Arr } from "@devbro/neko-helper";
+class SqliteQueryGrammar extends QueryGrammar {
+  static {
+    __name(this, "SqliteQueryGrammar");
+  }
+  constructor() {
+    super();
+  }
+  toSql(query) {
+    return super.toSql(query);
+  }
+  compileInsert(query, data) {
+    return super.compileInsert(query, data);
+  }
+  compileInsertGetId(query, data, options = { primaryKey: ["id"] }) {
+    const rc = super.compileInsert(query, data);
+    rc.sql += ` RETURNING ${options.primaryKey.join(", ")}`;
+    rc.parts = rc.parts.concat(["RETURNING", ...Arr.intersperse(options.primaryKey, ",")]);
+    return rc;
+  }
+  compileUpdate(query, data) {
+    return super.compileUpdate(query, data);
+  }
+  compileDelete(query) {
+    return super.compileDelete(query);
+  }
+  compileUpsert(query, data, conflictFields, updateFields) {
+    return super.compileUpsert(query, data, conflictFields, updateFields);
+  }
+  compileCount(query) {
+    return super.compileCount(query);
+  }
+}
+export {
+  SqliteQueryGrammar
+};
+//# sourceMappingURL=SqliteQueryGrammar.mjs.map