commandkit 1.0.0-dev.20250702022547 → 1.0.0-dev.20250702125326

package/dist/cli/app-process.d.ts

@@ -1,4 +1,4 @@
-import * as child_process0 from "child_process";
+import * as child_process3 from "child_process";
 
 //#region src/cli/app-process.d.ts
 
@@ -6,7 +6,7 @@ import * as child_process0 from "child_process";
  * @private
  * @internal
  */
-declare function createAppProcess(fileName: string, cwd: string, isDev: boolean): child_process0.ChildProcess;
+declare function createAppProcess(fileName: string, cwd: string, isDev: boolean): child_process3.ChildProcess;
 //#endregion
 export { createAppProcess };
 //# sourceMappingURL=app-process.d.ts.map

package/dist/cli/common.d.ts

@@ -29,7 +29,7 @@ import "../CommandsRouter-CoOA7hkf.js";
 import "../EventsRouter-BacqK6z3.js";
 import "../index-CUPkUUOR.js";
 import "../constants-BTttfrm3.js";
-import * as typescript1 from "typescript";
+import * as typescript0 from "typescript";
 
 //#region src/cli/common.d.ts
 /**
@@ -57,7 +57,7 @@ declare function findPackageJSON(): any;
  * @private
  * @internal
  */
-declare function loadTypeScript(e?: string): Promise<typeof typescript1>;
+declare function loadTypeScript(e?: string): Promise<typeof typescript0>;
 /**
  * @private
  * @internal

package/dist/cli/information.js

@@ -1,5 +1,5 @@
 const require_chunk = require('../chunk-nOFOJqeH.js');
-const require_version = require('../version-CHYJXFOa.js');
+const require_version = require('../version-DvvD35ov.js');
 const node_fs = require_chunk.__toESM(require("node:fs"));
 const node_path = require_chunk.__toESM(require("node:path"));
 const node_child_process = require_chunk.__toESM(require("node:child_process"));

package/dist/cli/production.d.ts

@@ -1,4 +1,4 @@
-import * as child_process3 from "child_process";
+import * as child_process1 from "child_process";
 
 //#region src/cli/production.d.ts
 
@@ -6,7 +6,7 @@ import * as child_process3 from "child_process";
  * @private
  * @internal
  */
-declare function bootstrapProductionServer(configPath?: string): Promise<child_process3.ChildProcess>;
+declare function bootstrapProductionServer(configPath?: string): Promise<child_process1.ChildProcess>;
 /**
  * @private
  * @internal

package/dist/index.js

@@ -36,7 +36,7 @@ require('./store-CyzliDXj.js');
 const require_helpers = require('./helpers-DfV6HlgI.js');
 require('./app-gCenKq8k.js');
 require('./ILogger-BMIMljYD.js');
-const require_version = require('./version-CHYJXFOa.js');
+const require_version = require('./version-DvvD35ov.js');
 const require_feature_flags = require('./feature-flags-DJcINI5E.js');
 const require_init = require('./init-DeoDd5cK.js');
 

package/dist/kv/kv.d.ts

@@ -0,0 +1,321 @@
+import { DatabaseSync } from "node:sqlite";
+
+//#region src/kv/kv.d.ts
+
+/**
+ * Configuration options for the KV store
+ */
+interface KvOptions {
+  /** Enable Write-Ahead Logging for better performance and durability */
+  enableWAL?: boolean;
+  /** Namespace for the key-value store table */
+  namespace?: string;
+}
+/**
+ * A key-value store implementation using SQLite
+ *
+ * This class provides a simple, persistent key-value storage solution
+ * with support for namespaces, automatic cleanup, iteration, and expiration.
+ *
+ * @example
+ * ```typescript
+ * const kv = new KV('data.db');
+ * kv.set('user:123', JSON.stringify({ name: 'John', age: 30 }));
+ * const user = JSON.parse(kv.get('user:123') || '{}');
+ *
+ * // Using namespaces
+ * const userKv = kv.namespace('users');
+ * userKv.set('123', JSON.stringify({ name: 'John' }));
+ * ```
+ */
+declare class KV implements Disposable, AsyncDisposable {
+  private options;
+  private db;
+  private statements;
+  /**
+   * Creates a new KV store instance
+   *
+   * @param path - Database file path, buffer, URL, or existing DatabaseSync instance
+   * @param options - Configuration options for the KV store
+   */
+  constructor(path: string | Buffer | URL | DatabaseSync, options?: KvOptions);
+  /**
+   * Gets the current timestamp in milliseconds
+   */
+  private getCurrentTime;
+  /**
+   * Checks if the database connection is open
+   *
+   * @returns `true` if the database is open, `false` otherwise
+   */
+  isOpen(): boolean;
+  /**
+   * Gets the underlying SQLite database instance
+   *
+   * @returns The DatabaseSync instance
+   */
+  getDatabase(): DatabaseSync;
+  /**
+   * Closes the database connection
+   */
+  close(): void;
+  /**
+   * Disposable implementation - closes the database when disposed
+   */
+  [Symbol.dispose](): void;
+  /**
+   * AsyncDisposable implementation - closes the database when disposed
+   */
+  [Symbol.asyncDispose](): Promise<void>;
+  /**
+   * Retrieves a value by key
+   *
+   * @param key - The key to retrieve
+   * @returns The value associated with the key, or `undefined` if not found or expired
+   *
+   * @example
+   * ```typescript
+   * const value = kv.get('my-key');
+   * if (value) {
+   *   console.log('Found:', value);
+   * }
+   * ```
+   */
+  get(key: string): string | undefined;
+  /**
+   * Sets a key-value pair
+   *
+   * @param key - The key to set
+   * @param value - The value to associate with the key
+   *
+   * @example
+   * ```typescript
+   * kv.set('user:123', JSON.stringify({ name: 'John' }));
+   * kv.set('counter', '42');
+   * ```
+   */
+  set(key: string, value: string): void;
+  /**
+   * Sets a key-value pair with expiration
+   *
+   * @param key - The key to set
+   * @param value - The value to associate with the key
+   * @param ttl - Time to live in milliseconds
+   *
+   * @example
+   * ```typescript
+   * // Set with 1 hour expiration
+   * kv.setex('session:123', 'user_data', 60 * 60 * 1000);
+   *
+   * // Set with 5 minutes expiration
+   * kv.setex('temp:data', 'cached_value', 5 * 60 * 1000);
+   * ```
+   */
+  setex(key: string, value: string, ttl: number): void;
+  /**
+   * Sets expiration for an existing key
+   *
+   * @param key - The key to set expiration for
+   * @param ttl - Time to live in milliseconds
+   * @returns `true` if the key exists and expiration was set, `false` otherwise
+   *
+   * @example
+   * ```typescript
+   * kv.set('user:123', 'user_data');
+   *
+   * // Set 30 minute expiration
+   * if (kv.expire('user:123', 30 * 60 * 1000)) {
+   *   console.log('Expiration set successfully');
+   * }
+   * ```
+   */
+  expire(key: string, ttl: number): boolean;
+  /**
+   * Gets the time to live for a key
+   *
+   * @param key - The key to check
+   * @returns Time to live in milliseconds, or `-1` if the key doesn't exist, or `-2` if the key has no expiration
+   *
+   * @example
+   * ```typescript
+   * const ttl = kv.ttl('user:123');
+   * if (ttl > 0) {
+   *   console.log(`Key expires in ${ttl}ms`);
+   * } else if (ttl === -2) {
+   *   console.log('Key has no expiration');
+   * } else {
+   *   console.log('Key does not exist');
+   * }
+   * ```
+   */
+  ttl(key: string): number;
+  /**
+   * Deletes a key-value pair
+   *
+   * @param key - The key to delete
+   *
+   * @example
+   * ```typescript
+   * kv.delete('user:123');
+   * ```
+   */
+  delete(key: string): void;
+  /**
+   * Checks if a key exists and is not expired
+   *
+   * @param key - The key to check
+   * @returns `true` if the key exists and is not expired, `false` otherwise
+   *
+   * @example
+   * ```typescript
+   * if (kv.has('user:123')) {
+   *   console.log('User exists and is not expired');
+   * }
+   * ```
+   */
+  has(key: string): boolean;
+  /**
+   * Gets all keys in the current namespace (excluding expired keys)
+   *
+   * @returns Array of all non-expired keys
+   *
+   * @example
+   * ```typescript
+   * const keys = kv.keys();
+   * console.log('All keys:', keys);
+   * ```
+   */
+  keys(): string[];
+  /**
+   * Gets all values in the current namespace (excluding expired keys)
+   *
+   * @returns Array of all non-expired values
+   *
+   * @example
+   * ```typescript
+   * const values = kv.values();
+   * console.log('All values:', values);
+   * ```
+   */
+  values(): string[];
+  /**
+   * Gets the total number of key-value pairs in the current namespace (excluding expired keys)
+   *
+   * @returns The count of non-expired key-value pairs
+   *
+   * @example
+   * ```typescript
+   * const count = kv.count();
+   * console.log(`Total entries: ${count}`);
+   * ```
+   */
+  count(): number;
+  /**
+   * Removes all key-value pairs from the current namespace
+   *
+   * @example
+   * ```typescript
+   * kv.clear(); // Removes all entries in current namespace
+   * ```
+   */
+  clear(): void;
+  /**
+   * Gets all key-value pairs as an object (excluding expired keys)
+   *
+   * @returns Object with all non-expired key-value pairs
+   *
+   * @example
+   * ```typescript
+   * const all = kv.all();
+   * console.log('All entries:', all);
+   * // Output: { 'key1': 'value1', 'key2': 'value2' }
+   * ```
+   */
+  all(): Record<string, string>;
+  /**
+   * Gets all available namespaces (tables) in the database
+   *
+   * @returns Array of namespace names
+   *
+   * @example
+   * ```typescript
+   * const namespaces = kv.namespaces();
+   * console.log('Available namespaces:', namespaces);
+   * ```
+   */
+  namespaces(): string[];
+  /**
+   * Gets the current namespace name
+   *
+   * @returns The current namespace string
+   */
+  getCurrentNamespace(): string;
+  /**
+   * Creates a new KV instance with a different namespace
+   *
+   * @param namespace - The namespace to use for the new instance
+   * @returns A new KV instance with the specified namespace
+   *
+   * @example
+   * ```typescript
+   * const userKv = kv.namespace('users');
+   * const configKv = kv.namespace('config');
+   *
+   * userKv.set('123', 'John Doe');
+   * configKv.set('theme', 'dark');
+   * ```
+   */
+  namespace(namespace: string): KV;
+  /**
+   * Iterator implementation for iterating over all non-expired key-value pairs
+   *
+   * @returns Iterator yielding [key, value] tuples
+   *
+   * @example
+   * ```typescript
+   * for (const [key, value] of kv) {
+   *   console.log(`${key}: ${value}`);
+   * }
+   *
+   * // Or using spread operator
+   * const entries = [...kv];
+   * ```
+   */
+  [Symbol.iterator](): Iterator<[string, string]>;
+  /**
+   * Executes a function within a transaction
+   *
+   * @param fn - Function to execute within the transaction (can be async)
+   * @returns The result of the function
+   *
+   * @example
+   * ```typescript
+   * // Synchronous transaction
+   * kv.transaction(() => {
+   *   kv.set('user:123', JSON.stringify({ name: 'John' }));
+   *   kv.set('user:456', JSON.stringify({ name: 'Jane' }));
+   *   // If any operation fails, all changes are rolled back
+   * });
+   *
+   * // Async transaction
+   * await kv.transaction(async () => {
+   *   kv.set('user:123', JSON.stringify({ name: 'John' }));
+   *   await someAsyncOperation();
+   *   kv.set('user:456', JSON.stringify({ name: 'Jane' }));
+   *   // If any operation fails, all changes are rolled back
+   * });
+   * ```
+   */
+  transaction<T>(fn: () => T | Promise<T>): Promise<T>;
+}
+/**
+ * Opens a new KV instance
+ *
+ * @param path - Database file path, buffer, URL, or existing DatabaseSync instance
+ * @param options - Configuration options for the KV store
+ * @returns A new KV instance
+ */
+declare function openKV(path?: string | Buffer | URL | DatabaseSync, options?: KvOptions): KV;
+//#endregion
+export { KV, KvOptions, openKV };
+//# sourceMappingURL=kv.d.ts.map

package/dist/kv/kv.js

@@ -0,0 +1,428 @@
+const require_chunk = require('../chunk-nOFOJqeH.js');
+const node_sqlite = require_chunk.__toESM(require("node:sqlite"));
+
+//#region src/kv/kv.ts
+/**
+* A key-value store implementation using SQLite
+*
+* This class provides a simple, persistent key-value storage solution
+* with support for namespaces, automatic cleanup, iteration, and expiration.
+*
+* @example
+* ```typescript
+* const kv = new KV('data.db');
+* kv.set('user:123', JSON.stringify({ name: 'John', age: 30 }));
+* const user = JSON.parse(kv.get('user:123') || '{}');
+*
+* // Using namespaces
+* const userKv = kv.namespace('users');
+* userKv.set('123', JSON.stringify({ name: 'John' }));
+* ```
+*/
+var KV = class KV {
+	db;
+	statements = {};
+	/**
+	* Creates a new KV store instance
+	*
+	* @param path - Database file path, buffer, URL, or existing DatabaseSync instance
+	* @param options - Configuration options for the KV store
+	*/
+	constructor(path, options = {
+		enableWAL: true,
+		namespace: "commandkit_kv"
+	}) {
+		this.options = options;
+		this.db = path instanceof node_sqlite.DatabaseSync ? path : new node_sqlite.DatabaseSync(path, { open: true });
+		if (options.enableWAL) this.db.exec(`PRAGMA journal_mode = WAL;`);
+		this.db.prepare(`
+      CREATE TABLE IF NOT EXISTS ? (
+        key TEXT PRIMARY KEY,
+        value TEXT,
+        expires_at INTEGER
+      )
+    `).run(options.namespace ?? "commandkit_kv");
+		this.statements = {
+			get: this.db.prepare(`SELECT value, expires_at FROM ? WHERE key = ?`),
+			set: this.db.prepare(`INSERT OR REPLACE INTO ? (key, value, expires_at) VALUES (?, ?, ?)`),
+			setex: this.db.prepare(`INSERT OR REPLACE INTO ? (key, value, expires_at) VALUES (?, ?, ?)`),
+			delete: this.db.prepare(`DELETE FROM ? WHERE key = ?`),
+			has: this.db.prepare(`SELECT COUNT(*) FROM ? WHERE key = ? AND (expires_at IS NULL OR expires_at > ?)`),
+			keys: this.db.prepare(`SELECT key FROM ? WHERE expires_at IS NULL OR expires_at > ?`),
+			values: this.db.prepare(`SELECT value FROM ? WHERE expires_at IS NULL OR expires_at > ?`),
+			clear: this.db.prepare(`DELETE FROM ?`),
+			count: this.db.prepare(`SELECT COUNT(*) FROM ? WHERE expires_at IS NULL OR expires_at > ?`),
+			all: this.db.prepare(`SELECT key, value FROM ? WHERE expires_at IS NULL OR expires_at > ?`),
+			expire: this.db.prepare(`UPDATE ? SET expires_at = ? WHERE key = ?`),
+			ttl: this.db.prepare(`SELECT expires_at FROM ? WHERE key = ?`),
+			namespaces: this.db.prepare(`SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'`),
+			begin: this.db.prepare(`BEGIN TRANSACTION`),
+			commit: this.db.prepare(`COMMIT`),
+			rollback: this.db.prepare(`ROLLBACK`)
+		};
+	}
+	/**
+	* Gets the current timestamp in milliseconds
+	*/
+	getCurrentTime() {
+		return Date.now();
+	}
+	/**
+	* Checks if the database connection is open
+	*
+	* @returns `true` if the database is open, `false` otherwise
+	*/
+	isOpen() {
+		return this.db.isOpen;
+	}
+	/**
+	* Gets the underlying SQLite database instance
+	*
+	* @returns The DatabaseSync instance
+	*/
+	getDatabase() {
+		return this.db;
+	}
+	/**
+	* Closes the database connection
+	*/
+	close() {
+		if (this.db.isOpen) this.db.close();
+	}
+	/**
+	* Disposable implementation - closes the database when disposed
+	*/
+	[Symbol.dispose]() {
+		this.close();
+	}
+	/**
+	* AsyncDisposable implementation - closes the database when disposed
+	*/
+	async [Symbol.asyncDispose]() {
+		this.close();
+	}
+	/**
+	* Retrieves a value by key
+	*
+	* @param key - The key to retrieve
+	* @returns The value associated with the key, or `undefined` if not found or expired
+	*
+	* @example
+	* ```typescript
+	* const value = kv.get('my-key');
+	* if (value) {
+	*   console.log('Found:', value);
+	* }
+	* ```
+	*/
+	get(key) {
+		const result = this.statements.get.get(this.getCurrentNamespace(), key);
+		if (!result) return void 0;
+		if (result.expires_at && Number(result.expires_at) <= this.getCurrentTime()) {
+			this.delete(key);
+			return void 0;
+		}
+		return result.value;
+	}
+	/**
+	* Sets a key-value pair
+	*
+	* @param key - The key to set
+	* @param value - The value to associate with the key
+	*
+	* @example
+	* ```typescript
+	* kv.set('user:123', JSON.stringify({ name: 'John' }));
+	* kv.set('counter', '42');
+	* ```
+	*/
+	set(key, value) {
+		this.statements.set.run(this.getCurrentNamespace(), key, value, null);
+	}
+	/**
+	* Sets a key-value pair with expiration
+	*
+	* @param key - The key to set
+	* @param value - The value to associate with the key
+	* @param ttl - Time to live in milliseconds
+	*
+	* @example
+	* ```typescript
+	* // Set with 1 hour expiration
+	* kv.setex('session:123', 'user_data', 60 * 60 * 1000);
+	*
+	* // Set with 5 minutes expiration
+	* kv.setex('temp:data', 'cached_value', 5 * 60 * 1000);
+	* ```
+	*/
+	setex(key, value, ttl) {
+		const expiresAt = this.getCurrentTime() + ttl;
+		this.statements.setex.run(this.getCurrentNamespace(), key, value, expiresAt);
+	}
+	/**
+	* Sets expiration for an existing key
+	*
+	* @param key - The key to set expiration for
+	* @param ttl - Time to live in milliseconds
+	* @returns `true` if the key exists and expiration was set, `false` otherwise
+	*
+	* @example
+	* ```typescript
+	* kv.set('user:123', 'user_data');
+	*
+	* // Set 30 minute expiration
+	* if (kv.expire('user:123', 30 * 60 * 1000)) {
+	*   console.log('Expiration set successfully');
+	* }
+	* ```
+	*/
+	expire(key, ttl) {
+		if (!this.has(key)) return false;
+		const expiresAt = this.getCurrentTime() + ttl;
+		this.statements.expire.run(this.getCurrentNamespace(), expiresAt, key);
+		return true;
+	}
+	/**
+	* Gets the time to live for a key
+	*
+	* @param key - The key to check
+	* @returns Time to live in milliseconds, or `-1` if the key doesn't exist, or `-2` if the key has no expiration
+	*
+	* @example
+	* ```typescript
+	* const ttl = kv.ttl('user:123');
+	* if (ttl > 0) {
+	*   console.log(`Key expires in ${ttl}ms`);
+	* } else if (ttl === -2) {
+	*   console.log('Key has no expiration');
+	* } else {
+	*   console.log('Key does not exist');
+	* }
+	* ```
+	*/
+	ttl(key) {
+		const result = this.statements.ttl.get(this.getCurrentNamespace(), key);
+		if (!result) return -1;
+		if (!result.expires_at) return -2;
+		const remaining = Number(result.expires_at) - this.getCurrentTime();
+		return remaining > 0 ? remaining : -1;
+	}
+	/**
+	* Deletes a key-value pair
+	*
+	* @param key - The key to delete
+	*
+	* @example
+	* ```typescript
+	* kv.delete('user:123');
+	* ```
+	*/
+	delete(key) {
+		this.statements.delete.run(this.getCurrentNamespace(), key);
+	}
+	/**
+	* Checks if a key exists and is not expired
+	*
+	* @param key - The key to check
+	* @returns `true` if the key exists and is not expired, `false` otherwise
+	*
+	* @example
+	* ```typescript
+	* if (kv.has('user:123')) {
+	*   console.log('User exists and is not expired');
+	* }
+	* ```
+	*/
+	has(key) {
+		const result = this.statements.has.get(this.getCurrentNamespace(), key, this.getCurrentTime());
+		return (result === null || result === void 0 ? void 0 : result.count) !== void 0 && result.count !== null && Number(result.count) > 0;
+	}
+	/**
+	* Gets all keys in the current namespace (excluding expired keys)
+	*
+	* @returns Array of all non-expired keys
+	*
+	* @example
+	* ```typescript
+	* const keys = kv.keys();
+	* console.log('All keys:', keys);
+	* ```
+	*/
+	keys() {
+		const result = this.statements.keys.all(this.getCurrentNamespace(), this.getCurrentTime());
+		return result.map((row) => row.key);
+	}
+	/**
+	* Gets all values in the current namespace (excluding expired keys)
+	*
+	* @returns Array of all non-expired values
+	*
+	* @example
+	* ```typescript
+	* const values = kv.values();
+	* console.log('All values:', values);
+	* ```
+	*/
+	values() {
+		const result = this.statements.values.all(this.getCurrentNamespace(), this.getCurrentTime());
+		return result.map((row) => row.value);
+	}
+	/**
+	* Gets the total number of key-value pairs in the current namespace (excluding expired keys)
+	*
+	* @returns The count of non-expired key-value pairs
+	*
+	* @example
+	* ```typescript
+	* const count = kv.count();
+	* console.log(`Total entries: ${count}`);
+	* ```
+	*/
+	count() {
+		const result = this.statements.count.get(this.getCurrentNamespace(), this.getCurrentTime());
+		return Number((result === null || result === void 0 ? void 0 : result.count) ?? 0);
+	}
+	/**
+	* Removes all key-value pairs from the current namespace
+	*
+	* @example
+	* ```typescript
+	* kv.clear(); // Removes all entries in current namespace
+	* ```
+	*/
+	clear() {
+		this.statements.clear.run(this.getCurrentNamespace());
+	}
+	/**
+	* Gets all key-value pairs as an object (excluding expired keys)
+	*
+	* @returns Object with all non-expired key-value pairs
+	*
+	* @example
+	* ```typescript
+	* const all = kv.all();
+	* console.log('All entries:', all);
+	* // Output: { 'key1': 'value1', 'key2': 'value2' }
+	* ```
+	*/
+	all() {
+		const result = this.statements.all.all(this.getCurrentNamespace(), this.getCurrentTime());
+		return Object.fromEntries(result.map((row) => [row.key, row.value]));
+	}
+	/**
+	* Gets all available namespaces (tables) in the database
+	*
+	* @returns Array of namespace names
+	*
+	* @example
+	* ```typescript
+	* const namespaces = kv.namespaces();
+	* console.log('Available namespaces:', namespaces);
+	* ```
+	*/
+	namespaces() {
+		const result = this.statements.namespaces.all();
+		return result.map((row) => row.name);
+	}
+	/**
+	* Gets the current namespace name
+	*
+	* @returns The current namespace string
+	*/
+	getCurrentNamespace() {
+		return this.options.namespace ?? "commandkit_kv";
+	}
+	/**
+	* Creates a new KV instance with a different namespace
+	*
+	* @param namespace - The namespace to use for the new instance
+	* @returns A new KV instance with the specified namespace
+	*
+	* @example
+	* ```typescript
+	* const userKv = kv.namespace('users');
+	* const configKv = kv.namespace('config');
+	*
+	* userKv.set('123', 'John Doe');
+	* configKv.set('theme', 'dark');
+	* ```
+	*/
+	namespace(namespace) {
+		return new KV(this.db, {
+			enableWAL: this.options.enableWAL,
+			namespace
+		});
+	}
+	/**
+	* Iterator implementation for iterating over all non-expired key-value pairs
+	*
+	* @returns Iterator yielding [key, value] tuples
+	*
+	* @example
+	* ```typescript
+	* for (const [key, value] of kv) {
+	*   console.log(`${key}: ${value}`);
+	* }
+	*
+	* // Or using spread operator
+	* const entries = [...kv];
+	* ```
+	*/
+	*[Symbol.iterator]() {
+		const result = this.statements.all.iterate(this.getCurrentNamespace(), this.getCurrentTime());
+		for (const row of result) yield [row.key, row.value];
+	}
+	/**
+	* Executes a function within a transaction
+	*
+	* @param fn - Function to execute within the transaction (can be async)
+	* @returns The result of the function
+	*
+	* @example
+	* ```typescript
+	* // Synchronous transaction
+	* kv.transaction(() => {
+	*   kv.set('user:123', JSON.stringify({ name: 'John' }));
+	*   kv.set('user:456', JSON.stringify({ name: 'Jane' }));
+	*   // If any operation fails, all changes are rolled back
+	* });
+	*
+	* // Async transaction
+	* await kv.transaction(async () => {
+	*   kv.set('user:123', JSON.stringify({ name: 'John' }));
+	*   await someAsyncOperation();
+	*   kv.set('user:456', JSON.stringify({ name: 'Jane' }));
+	*   // If any operation fails, all changes are rolled back
+	* });
+	* ```
+	*/
+	async transaction(fn) {
+		try {
+			this.statements.begin.run();
+			const result = await fn();
+			this.statements.commit.run();
+			return result;
+		} catch (error) {
+			this.statements.rollback.run();
+			throw error;
+		}
+	}
+};
+/**
+* Opens a new KV instance
+*
+* @param path - Database file path, buffer, URL, or existing DatabaseSync instance
+* @param options - Configuration options for the KV store
+* @returns A new KV instance
+*/
+function openKV(path = "commandkit_kv.db", options = {
+	enableWAL: true,
+	namespace: "commandkit_kv"
+}) {
+	return new KV(path, options);
+}
+
+//#endregion
+exports.KV = KV;
+exports.openKV = openKV;
+//# sourceMappingURL=kv.js.map

package/dist/kv/kv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"kv.js","names":[],"sources":["../../src/kv/kv.ts"],"sourcesContent":["import { DatabaseSync, StatementSync } from 'node:sqlite';\n\n/**\n * Configuration options for the KV store\n */\nexport interface KvOptions {\n  /** Enable Write-Ahead Logging for better performance and durability */\n  enableWAL?: boolean;\n  /** Namespace for the key-value store table */\n  namespace?: string;\n}\n\n/**\n * A key-value store implementation using SQLite\n *\n * This class provides a simple, persistent key-value storage solution\n * with support for namespaces, automatic cleanup, iteration, and expiration.\n *\n * @example\n * ```typescript\n * const kv = new KV('data.db');\n * kv.set('user:123', JSON.stringify({ name: 'John', age: 30 }));\n * const user = JSON.parse(kv.get('user:123') || '{}');\n *\n * // Using namespaces\n * const userKv = kv.namespace('users');\n * userKv.set('123', JSON.stringify({ name: 'John' }));\n * ```\n */\nexport class KV implements Disposable, AsyncDisposable {\n  private db: DatabaseSync;\n  private statements: Record<string, StatementSync> = {};\n\n  /**\n   * Creates a new KV store instance\n   *\n   * @param path - Database file path, buffer, URL, or existing DatabaseSync instance\n   * @param options - Configuration options for the KV store\n   */\n  public constructor(\n    path: string | Buffer | URL | DatabaseSync,\n    private options: KvOptions = {\n      enableWAL: true,\n      namespace: 'commandkit_kv',\n    },\n  ) {\n    this.db =\n      path instanceof DatabaseSync\n        ? path\n        : new DatabaseSync(path, { open: true });\n\n    if (options.enableWAL) {\n      this.db.exec(/* sql */ `PRAGMA journal_mode = WAL;`);\n    }\n\n    this.db\n      .prepare(\n        /* sql */ `\n      CREATE TABLE IF NOT EXISTS ? (\n        key TEXT PRIMARY KEY,\n        value TEXT,\n        expires_at INTEGER\n      )\n    `,\n      )\n      .run(options.namespace ?? 'commandkit_kv');\n\n    this.statements = {\n      get: this.db.prepare(\n        /* sql */ `SELECT value, expires_at FROM ? WHERE key = ?`,\n      ),\n      set: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ? (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      setex: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ? (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      delete: this.db.prepare(/* sql */ `DELETE FROM ? WHERE key = ?`),\n      has: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ? WHERE key = ? AND (expires_at IS NULL OR expires_at > ?)`,\n      ),\n      keys: this.db.prepare(\n        /* sql */ `SELECT key FROM ? WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      values: this.db.prepare(\n        /* sql */ `SELECT value FROM ? WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      clear: this.db.prepare(/* sql */ `DELETE FROM ?`),\n      count: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ? WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      all: this.db.prepare(\n        /* sql */ `SELECT key, value FROM ? WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      expire: this.db.prepare(\n        /* sql */ `UPDATE ? SET expires_at = ? WHERE key = ?`,\n      ),\n      ttl: this.db.prepare(/* sql */ `SELECT expires_at FROM ? WHERE key = ?`),\n      namespaces: this.db.prepare(\n        /* sql */ `SELECT name FROM sqlite_master WHERE type = 'table' AND name NOT LIKE 'sqlite_%'`,\n      ),\n      begin: this.db.prepare(/* sql */ `BEGIN TRANSACTION`),\n      commit: this.db.prepare(/* sql */ `COMMIT`),\n      rollback: this.db.prepare(/* sql */ `ROLLBACK`),\n    };\n  }\n\n  /**\n   * Gets the current timestamp in milliseconds\n   */\n  private getCurrentTime(): number {\n    return Date.now();\n  }\n\n  /**\n   * Checks if the database connection is open\n   *\n   * @returns `true` if the database is open, `false` otherwise\n   */\n  public isOpen(): boolean {\n    return this.db.isOpen;\n  }\n\n  /**\n   * Gets the underlying SQLite database instance\n   *\n   * @returns The DatabaseSync instance\n   */\n  public getDatabase(): DatabaseSync {\n    return this.db;\n  }\n\n  /**\n   * Closes the database connection\n   */\n  public close(): void {\n    if (this.db.isOpen) this.db.close();\n  }\n\n  /**\n   * Disposable implementation - closes the database when disposed\n   */\n  public [Symbol.dispose]() {\n    this.close();\n  }\n\n  /**\n   * AsyncDisposable implementation - closes the database when disposed\n   */\n  public async [Symbol.asyncDispose]() {\n    this.close();\n  }\n\n  /**\n   * Retrieves a value by key\n   *\n   * @param key - The key to retrieve\n   * @returns The value associated with the key, or `undefined` if not found or expired\n   *\n   * @example\n   * ```typescript\n   * const value = kv.get('my-key');\n   * if (value) {\n   *   console.log('Found:', value);\n   * }\n   * ```\n   */\n  public get(key: string): string | undefined {\n    const result = this.statements.get.get(this.getCurrentNamespace(), key);\n\n    if (!result) return undefined;\n\n    // Check if the key has expired\n    if (\n      result.expires_at &&\n      Number(result.expires_at) <= this.getCurrentTime()\n    ) {\n      this.delete(key);\n      return undefined;\n    }\n\n    return result.value as string;\n  }\n\n  /**\n   * Sets a key-value pair\n   *\n   * @param key - The key to set\n   * @param value - The value to associate with the key\n   *\n   * @example\n   * ```typescript\n   * kv.set('user:123', JSON.stringify({ name: 'John' }));\n   * kv.set('counter', '42');\n   * ```\n   */\n  public set(key: string, value: string): void {\n    this.statements.set.run(this.getCurrentNamespace(), key, value, null);\n  }\n\n  /**\n   * Sets a key-value pair with expiration\n   *\n   * @param key - The key to set\n   * @param value - The value to associate with the key\n   * @param ttl - Time to live in milliseconds\n   *\n   * @example\n   * ```typescript\n   * // Set with 1 hour expiration\n   * kv.setex('session:123', 'user_data', 60 * 60 * 1000);\n   *\n   * // Set with 5 minutes expiration\n   * kv.setex('temp:data', 'cached_value', 5 * 60 * 1000);\n   * ```\n   */\n  public setex(key: string, value: string, ttl: number): void {\n    const expiresAt = this.getCurrentTime() + ttl;\n    this.statements.setex.run(\n      this.getCurrentNamespace(),\n      key,\n      value,\n      expiresAt,\n    );\n  }\n\n  /**\n   * Sets expiration for an existing key\n   *\n   * @param key - The key to set expiration for\n   * @param ttl - Time to live in milliseconds\n   * @returns `true` if the key exists and expiration was set, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * kv.set('user:123', 'user_data');\n   *\n   * // Set 30 minute expiration\n   * if (kv.expire('user:123', 30 * 60 * 1000)) {\n   *   console.log('Expiration set successfully');\n   * }\n   * ```\n   */\n  public expire(key: string, ttl: number): boolean {\n    if (!this.has(key)) return false;\n\n    const expiresAt = this.getCurrentTime() + ttl;\n    this.statements.expire.run(this.getCurrentNamespace(), expiresAt, key);\n    return true;\n  }\n\n  /**\n   * Gets the time to live for a key\n   *\n   * @param key - The key to check\n   * @returns Time to live in milliseconds, or `-1` if the key doesn't exist, or `-2` if the key has no expiration\n   *\n   * @example\n   * ```typescript\n   * const ttl = kv.ttl('user:123');\n   * if (ttl > 0) {\n   *   console.log(`Key expires in ${ttl}ms`);\n   * } else if (ttl === -2) {\n   *   console.log('Key has no expiration');\n   * } else {\n   *   console.log('Key does not exist');\n   * }\n   * ```\n   */\n  public ttl(key: string): number {\n    const result = this.statements.ttl.get(this.getCurrentNamespace(), key);\n\n    if (!result) return -1; // Key doesn't exist\n\n    if (!result.expires_at) return -2; // No expiration\n\n    const remaining = Number(result.expires_at) - this.getCurrentTime();\n    return remaining > 0 ? remaining : -1; // Expired or doesn't exist\n  }\n\n  /**\n   * Deletes a key-value pair\n   *\n   * @param key - The key to delete\n   *\n   * @example\n   * ```typescript\n   * kv.delete('user:123');\n   * ```\n   */\n  public delete(key: string): void {\n    this.statements.delete.run(this.getCurrentNamespace(), key);\n  }\n\n  /**\n   * Checks if a key exists and is not expired\n   *\n   * @param key - The key to check\n   * @returns `true` if the key exists and is not expired, `false` otherwise\n   *\n   * @example\n   * ```typescript\n   * if (kv.has('user:123')) {\n   *   console.log('User exists and is not expired');\n   * }\n   * ```\n   */\n  public has(key: string): boolean {\n    const result = this.statements.has.get(\n      this.getCurrentNamespace(),\n      key,\n      this.getCurrentTime(),\n    );\n\n    return (\n      result?.count !== undefined &&\n      result.count !== null &&\n      Number(result.count) > 0\n    );\n  }\n\n  /**\n   * Gets all keys in the current namespace (excluding expired keys)\n   *\n   * @returns Array of all non-expired keys\n   *\n   * @example\n   * ```typescript\n   * const keys = kv.keys();\n   * console.log('All keys:', keys);\n   * ```\n   */\n  public keys(): string[] {\n    const result = this.statements.keys.all(\n      this.getCurrentNamespace(),\n      this.getCurrentTime(),\n    );\n\n    return result.map((row) => row.key as string);\n  }\n\n  /**\n   * Gets all values in the current namespace (excluding expired keys)\n   *\n   * @returns Array of all non-expired values\n   *\n   * @example\n   * ```typescript\n   * const values = kv.values();\n   * console.log('All values:', values);\n   * ```\n   */\n  public values(): string[] {\n    const result = this.statements.values.all(\n      this.getCurrentNamespace(),\n      this.getCurrentTime(),\n    );\n\n    return result.map((row) => row.value as string);\n  }\n\n  /**\n   * Gets the total number of key-value pairs in the current namespace (excluding expired keys)\n   *\n   * @returns The count of non-expired key-value pairs\n   *\n   * @example\n   * ```typescript\n   * const count = kv.count();\n   * console.log(`Total entries: ${count}`);\n   * ```\n   */\n  public count(): number {\n    const result = this.statements.count.get(\n      this.getCurrentNamespace(),\n      this.getCurrentTime(),\n    );\n\n    return Number(result?.count ?? 0);\n  }\n\n  /**\n   * Removes all key-value pairs from the current namespace\n   *\n   * @example\n   * ```typescript\n   * kv.clear(); // Removes all entries in current namespace\n   * ```\n   */\n  public clear(): void {\n    this.statements.clear.run(this.getCurrentNamespace());\n  }\n\n  /**\n   * Gets all key-value pairs as an object (excluding expired keys)\n   *\n   * @returns Object with all non-expired key-value pairs\n   *\n   * @example\n   * ```typescript\n   * const all = kv.all();\n   * console.log('All entries:', all);\n   * // Output: { 'key1': 'value1', 'key2': 'value2' }\n   * ```\n   */\n  public all(): Record<string, string> {\n    const result = this.statements.all.all(\n      this.getCurrentNamespace(),\n      this.getCurrentTime(),\n    );\n\n    return Object.fromEntries(\n      result.map((row) => [row.key as string, row.value as string]),\n    );\n  }\n\n  /**\n   * Gets all available namespaces (tables) in the database\n   *\n   * @returns Array of namespace names\n   *\n   * @example\n   * ```typescript\n   * const namespaces = kv.namespaces();\n   * console.log('Available namespaces:', namespaces);\n   * ```\n   */\n  public namespaces(): string[] {\n    const result = this.statements.namespaces.all();\n\n    return result.map((row) => row.name as string);\n  }\n\n  /**\n   * Gets the current namespace name\n   *\n   * @returns The current namespace string\n   */\n  public getCurrentNamespace(): string {\n    return this.options.namespace ?? 'commandkit_kv';\n  }\n\n  /**\n   * Creates a new KV instance with a different namespace\n   *\n   * @param namespace - The namespace to use for the new instance\n   * @returns A new KV instance with the specified namespace\n   *\n   * @example\n   * ```typescript\n   * const userKv = kv.namespace('users');\n   * const configKv = kv.namespace('config');\n   *\n   * userKv.set('123', 'John Doe');\n   * configKv.set('theme', 'dark');\n   * ```\n   */\n  public namespace(namespace: string): KV {\n    return new KV(this.db, {\n      enableWAL: this.options.enableWAL,\n      namespace,\n    });\n  }\n\n  /**\n   * Iterator implementation for iterating over all non-expired key-value pairs\n   *\n   * @returns Iterator yielding [key, value] tuples\n   *\n   * @example\n   * ```typescript\n   * for (const [key, value] of kv) {\n   *   console.log(`${key}: ${value}`);\n   * }\n   *\n   * // Or using spread operator\n   * const entries = [...kv];\n   * ```\n   */\n  public *[Symbol.iterator](): Iterator<[string, string]> {\n    const result = this.statements.all.iterate(\n      this.getCurrentNamespace(),\n      this.getCurrentTime(),\n    );\n\n    for (const row of result) {\n      yield [row.key as string, row.value as string];\n    }\n  }\n\n  /**\n   * Executes a function within a transaction\n   *\n   * @param fn - Function to execute within the transaction (can be async)\n   * @returns The result of the function\n   *\n   * @example\n   * ```typescript\n   * // Synchronous transaction\n   * kv.transaction(() => {\n   *   kv.set('user:123', JSON.stringify({ name: 'John' }));\n   *   kv.set('user:456', JSON.stringify({ name: 'Jane' }));\n   *   // If any operation fails, all changes are rolled back\n   * });\n   *\n   * // Async transaction\n   * await kv.transaction(async () => {\n   *   kv.set('user:123', JSON.stringify({ name: 'John' }));\n   *   await someAsyncOperation();\n   *   kv.set('user:456', JSON.stringify({ name: 'Jane' }));\n   *   // If any operation fails, all changes are rolled back\n   * });\n   * ```\n   */\n  public async transaction<T>(fn: () => T | Promise<T>): Promise<T> {\n    try {\n      // Begin transaction\n      this.statements.begin.run();\n\n      // Execute the function\n      const result = await fn();\n\n      // Commit transaction\n      this.statements.commit.run();\n\n      return result;\n    } catch (error) {\n      // Rollback transaction on error\n      this.statements.rollback.run();\n      throw error;\n    }\n  }\n}\n\n/**\n * Opens a new KV instance\n *\n * @param path - Database file path, buffer, URL, or existing DatabaseSync instance\n * @param options - Configuration options for the KV store\n * @returns A new KV instance\n */\nexport function openKV(\n  path: string | Buffer | URL | DatabaseSync = 'commandkit_kv.db',\n  options: KvOptions = { enableWAL: true, namespace: 'commandkit_kv' },\n): KV {\n  return new KV(path, options);\n}\n"],"mappings":"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"}

package/dist/{version-CHYJXFOa.js → version-DvvD35ov.js}

@@ -6,7 +6,7 @@
 /**
 * The current version of CommandKit.
 */
-const version = "1.0.0-dev.20250702022547";
+const version = "1.0.0-dev.20250702125326";
 
 //#endregion
 Object.defineProperty(exports, 'version', {
@@ -15,4 +15,4 @@ Object.defineProperty(exports, 'version', {
     return version;
   }
 });
-//# sourceMappingURL=version-CHYJXFOa.js.map
+//# sourceMappingURL=version-DvvD35ov.js.map

package/dist/{version-CHYJXFOa.js.map → version-DvvD35ov.js.map}

@@ -1 +1 @@
-{"version":3,"file":"version-CHYJXFOa.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["/**\n * @private\n */\nfunction $version(): string {\n  'use macro';\n  return require('../package.json').version;\n}\n\n/**\n * The current version of CommandKit.\n */\nexport const version: string = $version();\n"],"mappings":";;;;;;;;AAWA,MAAa,UAA4B"}
+{"version":3,"file":"version-DvvD35ov.js","names":[],"sources":["../src/version.ts"],"sourcesContent":["/**\n * @private\n */\nfunction $version(): string {\n  'use macro';\n  return require('../package.json').version;\n}\n\n/**\n * The current version of CommandKit.\n */\nexport const version: string = $version();\n"],"mappings":";;;;;;;;AAWA,MAAa,UAA4B"}

package/dist/version.js

@@ -1,3 +1,3 @@
-const require_version = require('./version-CHYJXFOa.js');
+const require_version = require('./version-DvvD35ov.js');
 
 exports.version = require_version.version;

package/kv.cjs

@@ -0,0 +1,6 @@
+const { KV, openKV } = require('./dist/kv/kv.js');
+
+module.exports = {
+  KV,
+  openKV,
+};

package/kv.d.ts

@@ -0,0 +1 @@
+export * from './dist/kv/kv';

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "commandkit",
   "description": "Beginner friendly command & event handler for Discord.js",
-  "version": "1.0.0-dev.20250702022547",
+  "version": "1.0.0-dev.20250702125326",
   "license": "MIT",
   "type": "commonjs",
   "main": "./dist/index.js",
@@ -44,7 +44,9 @@
     "./semaphore.cjs",
     "./semaphore.d.ts",
     "./mutex.cjs",
-    "./mutex.d.ts"
+    "./mutex.d.ts",
+    "./kv.cjs",
+    "./kv.d.ts"
   ],
   "exports": {
     ".": {
@@ -136,6 +138,11 @@
       "require": "./mutex.cjs",
       "import": "./mutex.cjs",
       "types": "./mutex.d.ts"
+    },
+    "./kv": {
+      "require": "./kv.cjs",
+      "import": "./kv.cjs",
+      "types": "./kv.d.ts"
     }
   },
   "repository": {
@@ -171,7 +178,7 @@
     "tsx": "^4.19.2",
     "typescript": "^5.7.3",
     "vitest": "^3.0.5",
-    "tsconfig": "0.0.0-dev.20250702022547"
+    "tsconfig": "0.0.0-dev.20250702125326"
   },
   "peerDependencies": {
     "discord.js": "^14"