node-sqlite-kv 0.2.2 → 0.3.1

package/dist/index.d.mts

@@ -4,18 +4,18 @@ interface KVSyncOptions {
     journalMode?: JournalMode;
 }
 type SQLitePath = ":memory:" | (string & {});
-
+declare const journalModes: JournalMode[];
 declare class KVSync<T = any> {
     #private;
     constructor(options?: KVSyncOptions);
-    set<K = T>(key: string, value: K): K;
+    set<K = T>(key: string, value: K | undefined): K;
     get<K = T>(key: string): K | null;
-    delete<K = T>(key: string): K | null;
-    all<K = T>(): {
+    delete(key: string): KVSync;
+    all<K = T>(filter?: (key: string, value: K) => boolean): {
         key: string;
         value: K;
     }[];
-    clear(): void;
+    clear(): KVSync;
     setJournalMode(mode: JournalMode): this;
     transaction<R>(callback: (kv: KVSync<T>) => R): {
         oldValues: {
@@ -29,4 +29,4 @@ declare class KVSync<T = any> {
     };
 }
 
-export { type JournalMode, KVSync, type KVSyncOptions, type SQLitePath, KVSync as default };
+export { type JournalMode, KVSync, type KVSyncOptions, type SQLitePath, journalModes };

package/dist/index.d.ts

@@ -4,18 +4,18 @@ interface KVSyncOptions {
     journalMode?: JournalMode;
 }
 type SQLitePath = ":memory:" | (string & {});
-
+declare const journalModes: JournalMode[];
 declare class KVSync<T = any> {
     #private;
     constructor(options?: KVSyncOptions);
-    set<K = T>(key: string, value: K): K;
+    set<K = T>(key: string, value: K | undefined): K;
     get<K = T>(key: string): K | null;
-    delete<K = T>(key: string): K | null;
-    all<K = T>(): {
+    delete(key: string): KVSync;
+    all<K = T>(filter?: (key: string, value: K) => boolean): {
         key: string;
         value: K;
     }[];
-    clear(): void;
+    clear(): KVSync;
     setJournalMode(mode: JournalMode): this;
     transaction<R>(callback: (kv: KVSync<T>) => R): {
         oldValues: {
@@ -29,6 +29,4 @@ declare class KVSync<T = any> {
     };
 }
 
-// @ts-ignore
-export = KVSync;
-export { type JournalMode, KVSync, type KVSyncOptions, type SQLitePath };
+export { type JournalMode, KVSync, type KVSyncOptions, type SQLitePath, journalModes };

package/dist/index.js

@@ -32,22 +32,28 @@ var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: tru
 var index_exports = {};
 __export(index_exports, {
   KVSync: () => KVSync,
-  default: () => KVSync
+  journalModes: () => journalModes
 });
 module.exports = __toCommonJS(index_exports);
-
-// src/structures/KVSync.ts
 var import_node_sqlite = require("node:sqlite");
 var import_node_v8 = require("node:v8");
 var import_node_fs = __toESM(require("node:fs"));
 var import_node_path = __toESM(require("node:path"));
+var journalModes = [
+  "DELETE",
+  "MEMORY",
+  "OFF",
+  "PERSIST",
+  "TRUNCATE",
+  "WAL"
+];
 var KVSync = class {
   static {
     __name(this, "KVSync");
   }
   #db;
   /**
-   * Create a new key-value store
+   * Instantiate a new key-value store
    * @param path Where the database is stored, or `:memory:` for in-memory storage
    */
   constructor(options) {
@@ -57,79 +63,92 @@ var KVSync = class {
     }
     this.#db = new import_node_sqlite.DatabaseSync(dbPath);
     this.setJournalMode(options?.journalMode ?? "DELETE");
-    this.#db.exec(`
-            CREATE TABLE IF NOT EXISTS kv (
-                key TEXT PRIMARY KEY NOT NULL,
-                value BLOB NOT NULL
-            ) STRICT;
-        `);
+    this.#db.exec(
+      "CREATE TABLE IF NOT EXISTS kv (key TEXT PRIMARY KEY NOT NULL, value BLOB NOT NULL) STRICT;"
+    );
   }
   /**
-   * Sets a key in the database
+   * Set a key in the database
    * @param key Key name
    * @param value Key value
    * @returns Provided value
    */
   set(key, value) {
+    if (!key || typeof key !== "string") {
+      throw new Error(
+        "[KVSync]: Key must be provided and be a non-empty string."
+      );
+    }
+    if (value === void 0) {
+      throw new Error(
+        "[KVSync]: Provided value is undefined. Did you mean to use delete() instead?"
+      );
+    }
     this.#db.prepare("INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)").run(key, (0, import_node_v8.serialize)(value));
     return value;
   }
   /**
-   * Gets a value from the database
+   * Get a value from the database
    * @param key Key name
    * @returns Value or null
    */
   get(key) {
+    if (!key || typeof key !== "string") {
+      throw new Error(
+        "[KVSync]: Key must be provided and be a non-empty string."
+      );
+    }
     const row = this.#db.prepare("SELECT value FROM kv WHERE key = ?").get(key);
     return row ? (0, import_node_v8.deserialize)(row.value) : null;
   }
   /**
-   * Deletes a key from the database
+   * Delete a key from the database
    * @param key Key name
-   * @returns Deleted key or null
+   * @returns KVSync instance
    */
   delete(key) {
-    const existing = this.get(key);
-    if (existing !== null) {
-      this.#db.prepare("DELETE FROM kv WHERE key = ?").run(key);
+    if (!key || typeof key !== "string") {
+      throw new Error(
+        "[KVSync]: Key must be provided and be a non-empty string."
+      );
     }
-    return existing;
+    this.#db.prepare("DELETE FROM kv WHERE key = ?").run(key);
+    return this;
   }
   /**
    * Get all data in the database
    * @returns Array of objects containing keys and values
    */
-  all() {
-    return this.#db.prepare("SELECT key, value FROM kv").all().map((record) => ({
-      key: record.key,
-      value: (0, import_node_v8.deserialize)(record.value)
-    }));
+  all(filter) {
+    const rows = this.#db.prepare("SELECT key, value FROM kv").iterate();
+    const result = [];
+    for (const row of rows) {
+      const key = row.key;
+      const value = (0, import_node_v8.deserialize)(row.value);
+      if (!filter || filter(key, value)) {
+        result.push({ key, value });
+      }
+    }
+    return result;
   }
   /**
    * Remove all entries from the database
    */
   clear() {
-    this.#db.exec("DELETE FROM kv");
+    this.#db.exec("DELETE FROM kv;");
+    return this;
   }
   /**
-   * Updates the journal mode
+   * Update the journal mode
    * @param mode New journal mode
    */
   setJournalMode(mode) {
-    const journalModes = [
-      "DELETE",
-      "MEMORY",
-      "OFF",
-      "PERSIST",
-      "TRUNCATE",
-      "WAL"
-    ];
     if (!journalModes.includes(mode)) {
       throw new Error(
-        `Invalid KVSync journal mode specified. Received: "${mode}", expected one of: ${journalModes.join(", ")}`
+        `[KVSync]: Invalid journal mode specified. Received: "${mode}", expected one of: ${journalModes.join(", ")}`
       );
     }
-    this.#db.exec(`PRAGMA journal_mode = ${mode}`);
+    this.#db.exec(`PRAGMA journal_mode = ${mode};`);
     return this;
   }
   /**
@@ -138,7 +157,16 @@ var KVSync = class {
    * @returns Object containing oldValues and newValues each containing arrays of keys and values
    */
   transaction(callback) {
-    this.#db.exec("BEGIN TRANSACTION;");
+    if (!callback) {
+      throw new Error(
+        "[KVSync]: A callback must be provided when using transaction()."
+      );
+    }
+    if (typeof callback !== "function") {
+      throw new Error(
+        `[KVSync]: Transaction callback must be of type function. Received: ${typeof callback}`
+      );
+    }
     const oldMap = /* @__PURE__ */ new Map();
     const newMap = /* @__PURE__ */ new Map();
     const tx = Object.create(this);
@@ -147,9 +175,8 @@ var KVSync = class {
         const oldValue = this.get(key);
         oldMap.set(key, oldValue === null ? void 0 : oldValue);
       }
-      const result = this.set(key, value);
-      newMap.set(key, result);
-      return result;
+      newMap.set(key, value);
+      return value ?? null;
     };
     tx.delete = (key) => {
       if (!oldMap.has(key)) {
@@ -157,11 +184,18 @@ var KVSync = class {
         oldMap.set(key, oldValue === null ? void 0 : oldValue);
       }
       newMap.set(key, null);
-      this.delete(key);
-      return oldMap.get(key);
+      return tx;
     };
     try {
       callback(tx);
+      this.#db.exec("BEGIN TRANSACTION;");
+      for (const [key, value] of newMap.entries()) {
+        if (value === null) {
+          this.delete(key);
+        } else {
+          this.set(key, value);
+        }
+      }
       this.#db.exec("COMMIT;");
     } catch (error) {
       this.#db.exec("ROLLBACK;");
@@ -181,5 +215,6 @@ var KVSync = class {
 };
 // Annotate the CommonJS export names for ESM import in node:
 0 && (module.exports = {
-  KVSync
+  KVSync,
+  journalModes
 });

package/dist/index.mjs

@@ -1,18 +1,26 @@
 var __defProp = Object.defineProperty;
 var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
 
-// src/structures/KVSync.ts
+// src/index.ts
 import { DatabaseSync } from "node:sqlite";
 import { serialize, deserialize } from "node:v8";
 import fs from "node:fs";
 import path from "node:path";
+var journalModes = [
+  "DELETE",
+  "MEMORY",
+  "OFF",
+  "PERSIST",
+  "TRUNCATE",
+  "WAL"
+];
 var KVSync = class {
   static {
     __name(this, "KVSync");
   }
   #db;
   /**
-   * Create a new key-value store
+   * Instantiate a new key-value store
    * @param path Where the database is stored, or `:memory:` for in-memory storage
    */
   constructor(options) {
@@ -22,79 +30,92 @@ var KVSync = class {
     }
     this.#db = new DatabaseSync(dbPath);
     this.setJournalMode(options?.journalMode ?? "DELETE");
-    this.#db.exec(`
-            CREATE TABLE IF NOT EXISTS kv (
-                key TEXT PRIMARY KEY NOT NULL,
-                value BLOB NOT NULL
-            ) STRICT;
-        `);
+    this.#db.exec(
+      "CREATE TABLE IF NOT EXISTS kv (key TEXT PRIMARY KEY NOT NULL, value BLOB NOT NULL) STRICT;"
+    );
   }
   /**
-   * Sets a key in the database
+   * Set a key in the database
    * @param key Key name
    * @param value Key value
    * @returns Provided value
    */
   set(key, value) {
+    if (!key || typeof key !== "string") {
+      throw new Error(
+        "[KVSync]: Key must be provided and be a non-empty string."
+      );
+    }
+    if (value === void 0) {
+      throw new Error(
+        "[KVSync]: Provided value is undefined. Did you mean to use delete() instead?"
+      );
+    }
     this.#db.prepare("INSERT OR REPLACE INTO kv (key, value) VALUES (?, ?)").run(key, serialize(value));
     return value;
   }
   /**
-   * Gets a value from the database
+   * Get a value from the database
    * @param key Key name
    * @returns Value or null
    */
   get(key) {
+    if (!key || typeof key !== "string") {
+      throw new Error(
+        "[KVSync]: Key must be provided and be a non-empty string."
+      );
+    }
     const row = this.#db.prepare("SELECT value FROM kv WHERE key = ?").get(key);
     return row ? deserialize(row.value) : null;
   }
   /**
-   * Deletes a key from the database
+   * Delete a key from the database
    * @param key Key name
-   * @returns Deleted key or null
+   * @returns KVSync instance
    */
   delete(key) {
-    const existing = this.get(key);
-    if (existing !== null) {
-      this.#db.prepare("DELETE FROM kv WHERE key = ?").run(key);
+    if (!key || typeof key !== "string") {
+      throw new Error(
+        "[KVSync]: Key must be provided and be a non-empty string."
+      );
     }
-    return existing;
+    this.#db.prepare("DELETE FROM kv WHERE key = ?").run(key);
+    return this;
   }
   /**
    * Get all data in the database
    * @returns Array of objects containing keys and values
    */
-  all() {
-    return this.#db.prepare("SELECT key, value FROM kv").all().map((record) => ({
-      key: record.key,
-      value: deserialize(record.value)
-    }));
+  all(filter) {
+    const rows = this.#db.prepare("SELECT key, value FROM kv").iterate();
+    const result = [];
+    for (const row of rows) {
+      const key = row.key;
+      const value = deserialize(row.value);
+      if (!filter || filter(key, value)) {
+        result.push({ key, value });
+      }
+    }
+    return result;
   }
   /**
    * Remove all entries from the database
    */
   clear() {
-    this.#db.exec("DELETE FROM kv");
+    this.#db.exec("DELETE FROM kv;");
+    return this;
   }
   /**
-   * Updates the journal mode
+   * Update the journal mode
    * @param mode New journal mode
    */
   setJournalMode(mode) {
-    const journalModes = [
-      "DELETE",
-      "MEMORY",
-      "OFF",
-      "PERSIST",
-      "TRUNCATE",
-      "WAL"
-    ];
     if (!journalModes.includes(mode)) {
       throw new Error(
-        `Invalid KVSync journal mode specified. Received: "${mode}", expected one of: ${journalModes.join(", ")}`
+        `[KVSync]: Invalid journal mode specified. Received: "${mode}", expected one of: ${journalModes.join(", ")}`
       );
     }
-    this.#db.exec(`PRAGMA journal_mode = ${mode}`);
+    this.#db.exec(`PRAGMA journal_mode = ${mode};`);
     return this;
   }
   /**
@@ -103,7 +124,16 @@ var KVSync = class {
    * @returns Object containing oldValues and newValues each containing arrays of keys and values
    */
   transaction(callback) {
-    this.#db.exec("BEGIN TRANSACTION;");
+    if (!callback) {
+      throw new Error(
+        "[KVSync]: A callback must be provided when using transaction()."
+      );
+    }
+    if (typeof callback !== "function") {
+      throw new Error(
+        `[KVSync]: Transaction callback must be of type function. Received: ${typeof callback}`
+      );
+    }
     const oldMap = /* @__PURE__ */ new Map();
     const newMap = /* @__PURE__ */ new Map();
     const tx = Object.create(this);
@@ -112,9 +142,8 @@ var KVSync = class {
         const oldValue = this.get(key);
         oldMap.set(key, oldValue === null ? void 0 : oldValue);
       }
-      const result = this.set(key, value);
-      newMap.set(key, result);
-      return result;
+      newMap.set(key, value);
+      return value ?? null;
     };
     tx.delete = (key) => {
       if (!oldMap.has(key)) {
@@ -122,11 +151,18 @@ var KVSync = class {
         oldMap.set(key, oldValue === null ? void 0 : oldValue);
       }
       newMap.set(key, null);
-      this.delete(key);
-      return oldMap.get(key);
+      return tx;
     };
     try {
       callback(tx);
+      this.#db.exec("BEGIN TRANSACTION;");
+      for (const [key, value] of newMap.entries()) {
+        if (value === null) {
+          this.delete(key);
+        } else {
+          this.set(key, value);
+        }
+      }
       this.#db.exec("COMMIT;");
     } catch (error) {
       this.#db.exec("ROLLBACK;");
@@ -146,5 +182,5 @@ var KVSync = class {
 };
 export {
   KVSync,
-  KVSync as default
+  journalModes
 };

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "node-sqlite-kv",
   "description": "Key-value store with node:sqlite",
-  "version": "0.2.2",
+  "version": "0.3.1",
   "repository": {
     "url": "https://github.com/e60m5ss/node-sqlite-kv"
   },
@@ -26,7 +26,7 @@
     "useTabs": false
   },
   "devDependencies": {
-    "@types/node": "^25.1.0",
+    "@types/node": "^25.2.0",
     "prettier": "^3.8.1",
     "tsup": "^8.5.1",
     "typescript": "^5.9.3"