commandkit 1.2.0-rc.12 → 1.2.0-rc.13

package/dist/kv/kv.js

@@ -1,9 +1,7 @@
-const require_chunk = require('../chunk-nOFOJqeH.js');
-require('../constants-AH-9qJ89.js');
-const require_dotprops = require('../dotprops-DvJUE8fw.js');
-const require_serde = require('../serde-DHHwhltz.js');
+const require_chunk = require('../chunk-kSYXY2_d.js');
+const require_kv_dotprops = require('./dotprops.js');
+const require_kv_serde = require('./serde.js');
 let node_sqlite = require("node:sqlite");
-node_sqlite = require_chunk.__toESM(node_sqlite);
 
 //#region src/kv/kv.ts
 /**
@@ -141,8 +139,8 @@ var KV = class KV {
 			this.delete(key);
 			return;
 		}
-		const deserialized = require_serde.deserializer(JSON.parse(result.value));
-		if (key.includes(".")) return require_dotprops.getNestedValue(deserialized, key.split(".").slice(1).join("."));
+		const deserialized = require_kv_serde.deserializer(JSON.parse(result.value));
+		if (key.includes(".")) return require_kv_dotprops.getNestedValue(deserialized, key.split(".").slice(1).join("."));
 		return deserialized;
 	}
 	/**
@@ -182,12 +180,12 @@ var KV = class KV {
 			const [baseKey, ...pathParts] = key.split(".");
 			const path = pathParts.join(".");
 			const existing = this.get(baseKey) || {};
-			require_dotprops.setNestedValue(existing, path, value);
-			const serialized = require_serde.serializer(existing);
+			require_kv_dotprops.setNestedValue(existing, path, value);
+			const serialized = require_kv_serde.serializer(existing);
 			serializedValue = JSON.stringify(serialized);
 			this.statements.set.run(baseKey, serializedValue, null);
 		} else {
-			const serialized = require_serde.serializer(value);
+			const serialized = require_kv_serde.serializer(value);
 			serializedValue = JSON.stringify(serialized);
 			this.statements.set.run(key, serializedValue, null);
 		}
@@ -218,12 +216,12 @@ var KV = class KV {
 			const [baseKey, ...pathParts] = key.split(".");
 			const path = pathParts.join(".");
 			const existing = this.get(baseKey) || {};
-			require_dotprops.setNestedValue(existing, path, value);
-			const serialized = require_serde.serializer(existing);
+			require_kv_dotprops.setNestedValue(existing, path, value);
+			const serialized = require_kv_serde.serializer(existing);
 			serializedValue = JSON.stringify(serialized);
 			this.statements.setex.run(baseKey, serializedValue, expiresAt);
 		} else {
-			const serialized = require_serde.serializer(value);
+			const serialized = require_kv_serde.serializer(value);
 			serializedValue = JSON.stringify(serialized);
 			this.statements.setex.run(key, serializedValue, expiresAt);
 		}
@@ -402,7 +400,7 @@ var KV = class KV {
 	*/
 	values() {
 		return this.statements.values.all(this.getCurrentTime()).map((row) => {
-			return require_serde.deserializer(JSON.parse(row.value));
+			return require_kv_serde.deserializer(JSON.parse(row.value));
 		});
 	}
 	/**
@@ -447,7 +445,7 @@ var KV = class KV {
 		const result = this.statements.all.all(this.getCurrentTime());
 		return Object.fromEntries(result.map((row) => {
 			const serialized = JSON.parse(row.value);
-			return [row.key, require_serde.deserializer(serialized)];
+			return [row.key, require_kv_serde.deserializer(serialized)];
 		}));
 	}
 	/**
@@ -512,7 +510,7 @@ var KV = class KV {
 		const result = this.statements.all.iterate(this.getCurrentTime());
 		for (const row of result) {
 			const serialized = JSON.parse(row.value);
-			yield [row.key, require_serde.deserializer(serialized)];
+			yield [row.key, require_kv_serde.deserializer(serialized)];
 		}
 	}
 	/**

package/dist/kv/kv.js.map

@@ -1 +1 @@
-{"version":3,"file":"kv.js","names":[],"sources":["../../src/kv/kv.ts"],"sourcesContent":["import { DatabaseSync, StatementSync } from 'node:sqlite';\nimport { deserializer, serializer } from './serde';\nimport { getNestedValue, setNestedValue } from './dotprops';\n\nexport type { SerializedValue } from './serde';\n\n/**\n * Mathematical operators supported by the KV math method\n */\nexport type KvMathOperator = '+' | '-' | '*' | '/' | '^' | '%';\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, expiration, and JSON serialization.\n *\n * @example\n * ```typescript\n * const kv = new KV('data.db');\n *\n * // Store any JSON-serializable data\n * kv.set('user:123', { name: 'John', age: 30 });\n * kv.set('counter', 42);\n * kv.set('active', true);\n * kv.set('dates', [new Date(), new Date()]);\n *\n * // Use dot notation for nested properties\n * kv.set('user:123.name', 'John');\n * kv.set('user:123.settings.theme', 'dark');\n *\n * // Retrieve data\n * const user = kv.get('user:123'); // { name: 'John', age: 30, settings: { theme: 'dark' } }\n * const name = kv.get('user:123.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    const namespace = this.options.namespace ?? 'commandkit_kv';\n\n    this.db.exec(/* sql */ `\n      CREATE TABLE IF NOT EXISTS ${namespace} (\n        key TEXT PRIMARY KEY,\n        value TEXT,\n        expires_at INTEGER\n      )\n    `);\n\n    this.statements = {\n      get: this.db.prepare(\n        /* sql */ `SELECT value, expires_at FROM ${namespace} WHERE key = ?`,\n      ),\n      set: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      setex: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      delete: this.db.prepare(\n        /* sql */ `DELETE FROM ${namespace} WHERE key = ?`,\n      ),\n      has: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE key = ? AND (expires_at IS NULL OR expires_at > ?)`,\n      ),\n      keys: this.db.prepare(\n        /* sql */ `SELECT key FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      values: this.db.prepare(\n        /* sql */ `SELECT value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      clear: this.db.prepare(/* sql */ `DELETE FROM ${namespace}`),\n      count: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      all: this.db.prepare(\n        /* sql */ `SELECT key, value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      expire: this.db.prepare(\n        /* sql */ `UPDATE ${namespace} SET expires_at = ? WHERE key = ?`,\n      ),\n      ttl: this.db.prepare(\n        /* sql */ `SELECT expires_at FROM ${namespace} WHERE key = ?`,\n      ),\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 (supports dot notation for nested properties)\n   * @returns The value associated with the key, or `undefined` if not found or expired\n   *\n   * @example\n   * ```typescript\n   * // Store an object\n   * kv.set('user:123', { name: 'John', age: 30, settings: { theme: 'dark' } });\n   *\n   * // Get the entire object\n   * const user = kv.get('user:123');\n   * // { name: 'John', age: 30, settings: { theme: 'dark' } }\n   *\n   * // Get nested properties using dot notation\n   * const name = kv.get('user:123.name'); // 'John'\n   * const theme = kv.get('user:123.settings.theme'); // 'dark'\n   * ```\n   */\n  public get<T = any>(key: string): T | undefined {\n    const result = this.statements.get.get(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    const serialized = JSON.parse(result.value as string);\n    const deserialized = deserializer(serialized);\n\n    // Handle dot notation for nested properties\n    if (key.includes('.')) {\n      return getNestedValue(deserialized, key.split('.').slice(1).join('.'));\n    }\n\n    return deserialized;\n  }\n\n  /**\n   * Sets a key-value pair\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   *\n   * @example\n   * ```typescript\n   * // Store primitive values\n   * kv.set('counter', 42);\n   * kv.set('active', true);\n   * kv.set('name', 'John');\n   *\n   * // Store objects\n   * kv.set('user:123', { name: 'John', age: 30 });\n   *\n   * // Store arrays\n   * kv.set('tags', ['javascript', 'typescript', 'sqlite']);\n   *\n   * // Store dates\n   * kv.set('created', new Date());\n   *\n   * // Store maps and sets\n   * kv.set('permissions', new Map([['admin', true], ['user', false]]));\n   * kv.set('unique_ids', new Set([1, 2, 3, 4, 5]));\n   *\n   * // Use dot notation for nested properties\n   * kv.set('user:123.settings.theme', 'dark');\n   * kv.set('user:123.settings.notifications', true);\n   * ```\n   */\n  public set(key: string, value: any): void {\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(baseKey, serializedValue, null);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(key, serializedValue, null);\n    }\n  }\n\n  /**\n   * Sets a key-value pair with expiration\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   * @param ttl - Time to live in milliseconds\n   *\n   * @example\n   * ```typescript\n   * // Set with 1 hour expiration\n   * kv.setex('session:123', { userId: 123, token: 'abc123' }, 60 * 60 * 1000);\n   *\n   * // Set with 5 minutes expiration\n   * kv.setex('temp:data', { cached: true, timestamp: Date.now() }, 5 * 60 * 1000);\n   *\n   * // Use dot notation with expiration\n   * kv.setex('user:123.temp_settings', { theme: 'light' }, 30 * 60 * 1000);\n   * ```\n   */\n  public setex(key: string, value: any, ttl: number): void {\n    const expiresAt = this.getCurrentTime() + ttl;\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(baseKey, serializedValue, expiresAt);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(key, serializedValue, expiresAt);\n    }\n  }\n\n  /**\n   * Performs mathematical operations on numeric values in the KV store\n   *\n   * @param key - The key to perform math operation on (supports dot notation for nested properties)\n   * @param operator - The mathematical operator to apply\n   * @param value - The value to use in the operation\n   * @returns The updated value after the mathematical operation\n   * @throws Error if the existing value is not numeric or if the operation is invalid\n   *\n   * @example\n   * ```typescript\n   * // Initialize a counter\n   * kv.set('counter', 10);\n   *\n   * // Increment by 5\n   * const result1 = kv.math('counter', '+', 5); // 15\n   *\n   * // Multiply by 2\n   * const result2 = kv.math('counter', '*', 2); // 30\n   *\n   * // Use with bigint\n   * kv.set('big_counter', BigInt(1000));\n   * const result3 = kv.math('big_counter', '+', BigInt(500)); // 1500n\n   *\n   * // Use with dot notation\n   * kv.set('user:123', { score: 100, level: 5 });\n   * const result4 = kv.math('user:123.score', '+', 50); // 150\n   * ```\n   */\n  public math(\n    key: string,\n    operator: KvMathOperator,\n    value: number | bigint,\n  ): number | bigint {\n    const existingValue = this.get(key);\n\n    if (existingValue === undefined) {\n      throw new Error(`Key '${key}' does not exist`);\n    }\n\n    if (\n      typeof existingValue !== 'number' &&\n      typeof existingValue !== 'bigint'\n    ) {\n      throw new Error(\n        `Value at key '${key}' is not numeric. Expected number or bigint, got ${typeof existingValue}`,\n      );\n    }\n\n    // Handle mixed number/bigint operations by converting to bigint\n    const isBigIntOperation =\n      typeof existingValue === 'bigint' || typeof value === 'bigint';\n\n    const existing = isBigIntOperation\n      ? typeof existingValue === 'bigint'\n        ? existingValue\n        : BigInt(existingValue)\n      : (existingValue as number);\n    const operand = isBigIntOperation\n      ? typeof value === 'bigint'\n        ? value\n        : BigInt(value)\n      : (value as number);\n\n    let result: number | bigint;\n\n    switch (operator) {\n      case '+':\n        result = (existing as any) + (operand as any);\n        break;\n      case '-':\n        result = (existing as any) - (operand as any);\n        break;\n      case '*':\n        result = (existing as any) * (operand as any);\n        break;\n      case '/':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Division by zero');\n        }\n        result = (existing as any) / (operand as any);\n        break;\n      case '^':\n        if (isBigIntOperation && operand < 0n) {\n          throw new Error(\n            'Exponentiation with negative exponent is not supported for bigint',\n          );\n        }\n        result = (existing as any) ** (operand as any);\n        break;\n      case '%':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Modulo by zero');\n        }\n        result = (existing as any) % (operand as any);\n        break;\n      default:\n        throw new Error(`Invalid operator: ${operator}`);\n    }\n\n    // Update the value in the store\n    this.set(key, result);\n\n    return result;\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', { name: 'John', age: 30 });\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(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(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   * kv.delete('user:123.settings.theme'); // Delete nested property\n   * ```\n   */\n  public delete(key: string): void {\n    this.statements.delete.run(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   * if (kv.has('user:123.settings.theme')) {\n   *   console.log('Theme setting exists');\n   * }\n   * ```\n   */\n  public has(key: string): boolean {\n    const result = this.statements.has.get(key, this.getCurrentTime());\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(this.getCurrentTime());\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(): any[] {\n    const result = this.statements.values.all(this.getCurrentTime());\n\n    return result.map((row) => {\n      const serialized = JSON.parse(row.value as string);\n      return deserializer(serialized);\n    });\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(this.getCurrentTime());\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();\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, any> {\n    const result = this.statements.all.all(this.getCurrentTime());\n\n    return Object.fromEntries(\n      result.map((row) => {\n        const serialized = JSON.parse(row.value as string);\n        return [row.key as string, deserializer(serialized)];\n      }),\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', { name: 'John', age: 30 });\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, any]> {\n    const result = this.statements.all.iterate(this.getCurrentTime());\n\n    for (const row of result) {\n      const serialized = JSON.parse(row.value as string);\n      yield [row.key as string, deserializer(serialized)];\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', { name: 'John', age: 30 });\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\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', { name: 'John', age: 30 });\n   *   await someAsyncOperation();\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\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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"}
+{"version":3,"file":"kv.js","names":[],"sources":["../../src/kv/kv.ts"],"sourcesContent":["import { DatabaseSync, StatementSync } from 'node:sqlite';\nimport { deserializer, serializer } from './serde';\nimport { getNestedValue, setNestedValue } from './dotprops';\n\nexport type { SerializedValue } from './serde';\n\n/**\n * Mathematical operators supported by the KV math method\n */\nexport type KvMathOperator = '+' | '-' | '*' | '/' | '^' | '%';\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, expiration, and JSON serialization.\n *\n * @example\n * ```typescript\n * const kv = new KV('data.db');\n *\n * // Store any JSON-serializable data\n * kv.set('user:123', { name: 'John', age: 30 });\n * kv.set('counter', 42);\n * kv.set('active', true);\n * kv.set('dates', [new Date(), new Date()]);\n *\n * // Use dot notation for nested properties\n * kv.set('user:123.name', 'John');\n * kv.set('user:123.settings.theme', 'dark');\n *\n * // Retrieve data\n * const user = kv.get('user:123'); // { name: 'John', age: 30, settings: { theme: 'dark' } }\n * const name = kv.get('user:123.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    const namespace = this.options.namespace ?? 'commandkit_kv';\n\n    this.db.exec(/* sql */ `\n      CREATE TABLE IF NOT EXISTS ${namespace} (\n        key TEXT PRIMARY KEY,\n        value TEXT,\n        expires_at INTEGER\n      )\n    `);\n\n    this.statements = {\n      get: this.db.prepare(\n        /* sql */ `SELECT value, expires_at FROM ${namespace} WHERE key = ?`,\n      ),\n      set: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      setex: this.db.prepare(\n        /* sql */ `INSERT OR REPLACE INTO ${namespace} (key, value, expires_at) VALUES (?, ?, ?)`,\n      ),\n      delete: this.db.prepare(\n        /* sql */ `DELETE FROM ${namespace} WHERE key = ?`,\n      ),\n      has: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE key = ? AND (expires_at IS NULL OR expires_at > ?)`,\n      ),\n      keys: this.db.prepare(\n        /* sql */ `SELECT key FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      values: this.db.prepare(\n        /* sql */ `SELECT value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      clear: this.db.prepare(/* sql */ `DELETE FROM ${namespace}`),\n      count: this.db.prepare(\n        /* sql */ `SELECT COUNT(*) FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      all: this.db.prepare(\n        /* sql */ `SELECT key, value FROM ${namespace} WHERE expires_at IS NULL OR expires_at > ?`,\n      ),\n      expire: this.db.prepare(\n        /* sql */ `UPDATE ${namespace} SET expires_at = ? WHERE key = ?`,\n      ),\n      ttl: this.db.prepare(\n        /* sql */ `SELECT expires_at FROM ${namespace} WHERE key = ?`,\n      ),\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 (supports dot notation for nested properties)\n   * @returns The value associated with the key, or `undefined` if not found or expired\n   *\n   * @example\n   * ```typescript\n   * // Store an object\n   * kv.set('user:123', { name: 'John', age: 30, settings: { theme: 'dark' } });\n   *\n   * // Get the entire object\n   * const user = kv.get('user:123');\n   * // { name: 'John', age: 30, settings: { theme: 'dark' } }\n   *\n   * // Get nested properties using dot notation\n   * const name = kv.get('user:123.name'); // 'John'\n   * const theme = kv.get('user:123.settings.theme'); // 'dark'\n   * ```\n   */\n  public get<T = any>(key: string): T | undefined {\n    const result = this.statements.get.get(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    const serialized = JSON.parse(result.value as string);\n    const deserialized = deserializer(serialized);\n\n    // Handle dot notation for nested properties\n    if (key.includes('.')) {\n      return getNestedValue(deserialized, key.split('.').slice(1).join('.'));\n    }\n\n    return deserialized;\n  }\n\n  /**\n   * Sets a key-value pair\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   *\n   * @example\n   * ```typescript\n   * // Store primitive values\n   * kv.set('counter', 42);\n   * kv.set('active', true);\n   * kv.set('name', 'John');\n   *\n   * // Store objects\n   * kv.set('user:123', { name: 'John', age: 30 });\n   *\n   * // Store arrays\n   * kv.set('tags', ['javascript', 'typescript', 'sqlite']);\n   *\n   * // Store dates\n   * kv.set('created', new Date());\n   *\n   * // Store maps and sets\n   * kv.set('permissions', new Map([['admin', true], ['user', false]]));\n   * kv.set('unique_ids', new Set([1, 2, 3, 4, 5]));\n   *\n   * // Use dot notation for nested properties\n   * kv.set('user:123.settings.theme', 'dark');\n   * kv.set('user:123.settings.notifications', true);\n   * ```\n   */\n  public set(key: string, value: any): void {\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(baseKey, serializedValue, null);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.set.run(key, serializedValue, null);\n    }\n  }\n\n  /**\n   * Sets a key-value pair with expiration\n   *\n   * @param key - The key to set (supports dot notation for nested properties)\n   * @param value - The value to associate with the key (any JSON-serializable type)\n   * @param ttl - Time to live in milliseconds\n   *\n   * @example\n   * ```typescript\n   * // Set with 1 hour expiration\n   * kv.setex('session:123', { userId: 123, token: 'abc123' }, 60 * 60 * 1000);\n   *\n   * // Set with 5 minutes expiration\n   * kv.setex('temp:data', { cached: true, timestamp: Date.now() }, 5 * 60 * 1000);\n   *\n   * // Use dot notation with expiration\n   * kv.setex('user:123.temp_settings', { theme: 'light' }, 30 * 60 * 1000);\n   * ```\n   */\n  public setex(key: string, value: any, ttl: number): void {\n    const expiresAt = this.getCurrentTime() + ttl;\n    let serializedValue: string;\n\n    if (key.includes('.')) {\n      // Handle dot notation for nested properties\n      const [baseKey, ...pathParts] = key.split('.');\n      const path = pathParts.join('.');\n\n      // Get existing value or create new object\n      const existing = this.get(baseKey) || {};\n      setNestedValue(existing, path, value);\n\n      const serialized = serializer(existing);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(baseKey, serializedValue, expiresAt);\n    } else {\n      const serialized = serializer(value);\n      serializedValue = JSON.stringify(serialized);\n\n      this.statements.setex.run(key, serializedValue, expiresAt);\n    }\n  }\n\n  /**\n   * Performs mathematical operations on numeric values in the KV store\n   *\n   * @param key - The key to perform math operation on (supports dot notation for nested properties)\n   * @param operator - The mathematical operator to apply\n   * @param value - The value to use in the operation\n   * @returns The updated value after the mathematical operation\n   * @throws Error if the existing value is not numeric or if the operation is invalid\n   *\n   * @example\n   * ```typescript\n   * // Initialize a counter\n   * kv.set('counter', 10);\n   *\n   * // Increment by 5\n   * const result1 = kv.math('counter', '+', 5); // 15\n   *\n   * // Multiply by 2\n   * const result2 = kv.math('counter', '*', 2); // 30\n   *\n   * // Use with bigint\n   * kv.set('big_counter', BigInt(1000));\n   * const result3 = kv.math('big_counter', '+', BigInt(500)); // 1500n\n   *\n   * // Use with dot notation\n   * kv.set('user:123', { score: 100, level: 5 });\n   * const result4 = kv.math('user:123.score', '+', 50); // 150\n   * ```\n   */\n  public math(\n    key: string,\n    operator: KvMathOperator,\n    value: number | bigint,\n  ): number | bigint {\n    const existingValue = this.get(key);\n\n    if (existingValue === undefined) {\n      throw new Error(`Key '${key}' does not exist`);\n    }\n\n    if (\n      typeof existingValue !== 'number' &&\n      typeof existingValue !== 'bigint'\n    ) {\n      throw new Error(\n        `Value at key '${key}' is not numeric. Expected number or bigint, got ${typeof existingValue}`,\n      );\n    }\n\n    // Handle mixed number/bigint operations by converting to bigint\n    const isBigIntOperation =\n      typeof existingValue === 'bigint' || typeof value === 'bigint';\n\n    const existing = isBigIntOperation\n      ? typeof existingValue === 'bigint'\n        ? existingValue\n        : BigInt(existingValue)\n      : (existingValue as number);\n    const operand = isBigIntOperation\n      ? typeof value === 'bigint'\n        ? value\n        : BigInt(value)\n      : (value as number);\n\n    let result: number | bigint;\n\n    switch (operator) {\n      case '+':\n        result = (existing as any) + (operand as any);\n        break;\n      case '-':\n        result = (existing as any) - (operand as any);\n        break;\n      case '*':\n        result = (existing as any) * (operand as any);\n        break;\n      case '/':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Division by zero');\n        }\n        result = (existing as any) / (operand as any);\n        break;\n      case '^':\n        if (isBigIntOperation && operand < 0n) {\n          throw new Error(\n            'Exponentiation with negative exponent is not supported for bigint',\n          );\n        }\n        result = (existing as any) ** (operand as any);\n        break;\n      case '%':\n        if (operand === 0 || operand === 0n) {\n          throw new Error('Modulo by zero');\n        }\n        result = (existing as any) % (operand as any);\n        break;\n      default:\n        throw new Error(`Invalid operator: ${operator}`);\n    }\n\n    // Update the value in the store\n    this.set(key, result);\n\n    return result;\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', { name: 'John', age: 30 });\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(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(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   * kv.delete('user:123.settings.theme'); // Delete nested property\n   * ```\n   */\n  public delete(key: string): void {\n    this.statements.delete.run(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   * if (kv.has('user:123.settings.theme')) {\n   *   console.log('Theme setting exists');\n   * }\n   * ```\n   */\n  public has(key: string): boolean {\n    const result = this.statements.has.get(key, this.getCurrentTime());\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(this.getCurrentTime());\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(): any[] {\n    const result = this.statements.values.all(this.getCurrentTime());\n\n    return result.map((row) => {\n      const serialized = JSON.parse(row.value as string);\n      return deserializer(serialized);\n    });\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(this.getCurrentTime());\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();\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, any> {\n    const result = this.statements.all.all(this.getCurrentTime());\n\n    return Object.fromEntries(\n      result.map((row) => {\n        const serialized = JSON.parse(row.value as string);\n        return [row.key as string, deserializer(serialized)];\n      }),\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', { name: 'John', age: 30 });\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, any]> {\n    const result = this.statements.all.iterate(this.getCurrentTime());\n\n    for (const row of result) {\n      const serialized = JSON.parse(row.value as string);\n      yield [row.key as string, deserializer(serialized)];\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', { name: 'John', age: 30 });\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\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', { name: 'John', age: 30 });\n   *   await someAsyncOperation();\n   *   kv.set('user:456', { name: 'Jane', age: 25 });\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/kv/serde.d.ts

@@ -1,3 +1,12 @@
-import "../constants-CCFSX2NG.js";
-import { SerializedValue, deserializer, serializer } from "../serde-D4H23l2F.js";
-export { SerializedValue, deserializer, serializer };
+import { t as SerializerType } from "../constants-EpKcj0dH.js";
+
+//#region src/kv/serde.d.ts
+interface SerializedValue {
+  t: SerializerType;
+  v: any;
+}
+declare function serializer(value: any): SerializedValue;
+declare function deserializer(serialized: SerializedValue): any;
+//#endregion
+export { SerializedValue, deserializer, serializer };
+//# sourceMappingURL=serde.d.ts.map

package/dist/kv/serde.js

@@ -1,5 +1,87 @@
-require('../constants-AH-9qJ89.js');
-const require_serde = require('../serde-DHHwhltz.js');
+const require_constants = require('../constants-BFFK-hfP.js');
 
-exports.deserializer = require_serde.deserializer;
-exports.serializer = require_serde.serializer;
+//#region src/kv/serde.ts
+function serializer(value) {
+	if (value === null) return {
+		t: require_constants.SerializerType.Null,
+		v: null
+	};
+	if (value === void 0) return {
+		t: require_constants.SerializerType.Undefined,
+		v: void 0
+	};
+	if (typeof value === "string") return {
+		t: require_constants.SerializerType.String,
+		v: value
+	};
+	if (typeof value === "number") return {
+		t: require_constants.SerializerType.Number,
+		v: value
+	};
+	if (typeof value === "boolean") return {
+		t: require_constants.SerializerType.Boolean,
+		v: value
+	};
+	if (typeof value === "bigint") return {
+		t: require_constants.SerializerType.BigInt,
+		v: value.toString()
+	};
+	if (value instanceof Date) return {
+		t: require_constants.SerializerType.Date,
+		v: value.toISOString()
+	};
+	if (Array.isArray(value)) return {
+		t: require_constants.SerializerType.Array,
+		v: value
+	};
+	if (value instanceof Map) return {
+		t: require_constants.SerializerType.Map,
+		v: Array.from(value.entries())
+	};
+	if (value instanceof Set) return {
+		t: require_constants.SerializerType.Set,
+		v: Array.from(value)
+	};
+	if (Buffer.isBuffer(value)) return {
+		t: require_constants.SerializerType.Buffer,
+		v: value.toString("base64")
+	};
+	if (value instanceof RegExp) return {
+		t: require_constants.SerializerType.RegExp,
+		v: {
+			source: value.source,
+			flags: value.flags
+		}
+	};
+	if (typeof value === "object") return {
+		t: require_constants.SerializerType.Object,
+		v: value
+	};
+	return {
+		t: require_constants.SerializerType.String,
+		v: String(value)
+	};
+}
+function deserializer(serialized) {
+	switch (serialized.t) {
+		case require_constants.SerializerType.Null: return null;
+		case require_constants.SerializerType.Undefined: return;
+		case require_constants.SerializerType.String: return serialized.v;
+		case require_constants.SerializerType.Number: return serialized.v;
+		case require_constants.SerializerType.Boolean: return serialized.v;
+		case require_constants.SerializerType.BigInt: return BigInt(serialized.v);
+		case require_constants.SerializerType.Date: return new Date(serialized.v);
+		case require_constants.SerializerType.Array: return serialized.v;
+		case require_constants.SerializerType.Map: return new Map(serialized.v);
+		case require_constants.SerializerType.Set: return new Set(serialized.v);
+		case require_constants.SerializerType.Buffer: return Buffer.from(serialized.v, "base64");
+		case require_constants.SerializerType.RegExp: return new RegExp(serialized.v.source, serialized.v.flags);
+		case require_constants.SerializerType.Object: return serialized.v;
+		default: return serialized.v;
+	}
+}
+
+//#endregion
+exports.deserializer = deserializer;
+exports.serializer = serializer;
+//# sourceMappingURL=serde.js.map

package/dist/kv/serde.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"serde.js","names":[],"sources":["../../src/kv/serde.ts"],"sourcesContent":["import { SerializerType } from './constants';\n\nexport interface SerializedValue {\n  t: SerializerType;\n  v: any;\n}\n\nexport function serializer(value: any): SerializedValue {\n  if (value === null) {\n    return { t: SerializerType.Null, v: null };\n  }\n\n  if (value === undefined) {\n    return { t: SerializerType.Undefined, v: undefined };\n  }\n\n  if (typeof value === 'string') {\n    return { t: SerializerType.String, v: value };\n  }\n\n  if (typeof value === 'number') {\n    return { t: SerializerType.Number, v: value };\n  }\n\n  if (typeof value === 'boolean') {\n    return { t: SerializerType.Boolean, v: value };\n  }\n\n  if (typeof value === 'bigint') {\n    return { t: SerializerType.BigInt, v: value.toString() };\n  }\n\n  if (value instanceof Date) {\n    return { t: SerializerType.Date, v: value.toISOString() };\n  }\n\n  if (Array.isArray(value)) {\n    return { t: SerializerType.Array, v: value };\n  }\n\n  if (value instanceof Map) {\n    return { t: SerializerType.Map, v: Array.from(value.entries()) };\n  }\n\n  if (value instanceof Set) {\n    return { t: SerializerType.Set, v: Array.from(value) };\n  }\n\n  if (Buffer.isBuffer(value)) {\n    return { t: SerializerType.Buffer, v: value.toString('base64') };\n  }\n\n  if (value instanceof RegExp) {\n    return {\n      t: SerializerType.RegExp,\n      v: { source: value.source, flags: value.flags },\n    };\n  }\n\n  if (typeof value === 'object') {\n    return { t: SerializerType.Object, v: value };\n  }\n\n  // Fallback to string\n  return { t: SerializerType.String, v: String(value) };\n}\n\nexport function deserializer(serialized: SerializedValue): any {\n  switch (serialized.t) {\n    case SerializerType.Null:\n      return null;\n    case SerializerType.Undefined:\n      return undefined;\n    case SerializerType.String:\n      return serialized.v;\n    case SerializerType.Number:\n      return serialized.v;\n    case SerializerType.Boolean:\n      return serialized.v;\n    case SerializerType.BigInt:\n      return BigInt(serialized.v);\n    case SerializerType.Date:\n      return new Date(serialized.v);\n    case SerializerType.Array:\n      return serialized.v;\n    case SerializerType.Map:\n      return new Map(serialized.v);\n    case SerializerType.Set:\n      return new Set(serialized.v);\n    case SerializerType.Buffer:\n      return Buffer.from(serialized.v, 'base64');\n    case SerializerType.RegExp:\n      return new RegExp(serialized.v.source, serialized.v.flags);\n    case SerializerType.Object:\n      return serialized.v;\n    default:\n      return serialized.v;\n  }\n}\n"],"mappings":";;;AAOA,SAAgB,WAAW,OAA6B;AACtD,KAAI,UAAU,KACZ,QAAO;EAAE,GAAG,iCAAe;EAAM,GAAG;EAAM;AAG5C,KAAI,UAAU,OACZ,QAAO;EAAE,GAAG,iCAAe;EAAW,GAAG;EAAW;AAGtD,KAAI,OAAO,UAAU,SACnB,QAAO;EAAE,GAAG,iCAAe;EAAQ,GAAG;EAAO;AAG/C,KAAI,OAAO,UAAU,SACnB,QAAO;EAAE,GAAG,iCAAe;EAAQ,GAAG;EAAO;AAG/C,KAAI,OAAO,UAAU,UACnB,QAAO;EAAE,GAAG,iCAAe;EAAS,GAAG;EAAO;AAGhD,KAAI,OAAO,UAAU,SACnB,QAAO;EAAE,GAAG,iCAAe;EAAQ,GAAG,MAAM,UAAU;EAAE;AAG1D,KAAI,iBAAiB,KACnB,QAAO;EAAE,GAAG,iCAAe;EAAM,GAAG,MAAM,aAAa;EAAE;AAG3D,KAAI,MAAM,QAAQ,MAAM,CACtB,QAAO;EAAE,GAAG,iCAAe;EAAO,GAAG;EAAO;AAG9C,KAAI,iBAAiB,IACnB,QAAO;EAAE,GAAG,iCAAe;EAAK,GAAG,MAAM,KAAK,MAAM,SAAS,CAAC;EAAE;AAGlE,KAAI,iBAAiB,IACnB,QAAO;EAAE,GAAG,iCAAe;EAAK,GAAG,MAAM,KAAK,MAAM;EAAE;AAGxD,KAAI,OAAO,SAAS,MAAM,CACxB,QAAO;EAAE,GAAG,iCAAe;EAAQ,GAAG,MAAM,SAAS,SAAS;EAAE;AAGlE,KAAI,iBAAiB,OACnB,QAAO;EACL,GAAG,iCAAe;EAClB,GAAG;GAAE,QAAQ,MAAM;GAAQ,OAAO,MAAM;GAAO;EAChD;AAGH,KAAI,OAAO,UAAU,SACnB,QAAO;EAAE,GAAG,iCAAe;EAAQ,GAAG;EAAO;AAI/C,QAAO;EAAE,GAAG,iCAAe;EAAQ,GAAG,OAAO,MAAM;EAAE;;AAGvD,SAAgB,aAAa,YAAkC;AAC7D,SAAQ,WAAW,GAAnB;EACE,KAAK,iCAAe,KAClB,QAAO;EACT,KAAK,iCAAe,UAClB;EACF,KAAK,iCAAe,OAClB,QAAO,WAAW;EACpB,KAAK,iCAAe,OAClB,QAAO,WAAW;EACpB,KAAK,iCAAe,QAClB,QAAO,WAAW;EACpB,KAAK,iCAAe,OAClB,QAAO,OAAO,WAAW,EAAE;EAC7B,KAAK,iCAAe,KAClB,QAAO,IAAI,KAAK,WAAW,EAAE;EAC/B,KAAK,iCAAe,MAClB,QAAO,WAAW;EACpB,KAAK,iCAAe,IAClB,QAAO,IAAI,IAAI,WAAW,EAAE;EAC9B,KAAK,iCAAe,IAClB,QAAO,IAAI,IAAI,WAAW,EAAE;EAC9B,KAAK,iCAAe,OAClB,QAAO,OAAO,KAAK,WAAW,GAAG,SAAS;EAC5C,KAAK,iCAAe,OAClB,QAAO,IAAI,OAAO,WAAW,EAAE,QAAQ,WAAW,EAAE,MAAM;EAC5D,KAAK,iCAAe,OAClB,QAAO,WAAW;EACpB,QACE,QAAO,WAAW"}

package/dist/{label-D0KXeBhk.d.ts → label-37kaNWMH.d.ts}

@@ -1,14 +1,13 @@
 import { LabelBuilder, LabelBuilderData } from "discord.js";
 
 //#region src/components/display/label.d.ts
-
 /**
  * The label properties for the label component.
  */
 interface LabelProps extends Omit<LabelBuilderData, 'component' | 'type'> {
   /**
-   * The component that will be wrapped by the label component.
-   */
+       * The component that will be wrapped by the label component.
+       */
   children: LabelBuilderData['component'] & {};
 }
 /**
@@ -25,5 +24,5 @@ interface LabelProps extends Omit<LabelBuilderData, 'component' | 'type'> {
  */
 declare function Label(props: LabelProps): LabelBuilder;
 //#endregion
-export { Label, LabelProps };
-//# sourceMappingURL=label-D0KXeBhk.d.ts.map
+export { LabelProps as n, Label as t };
+//# sourceMappingURL=label-37kaNWMH.d.ts.map

package/dist/{label-D-uJWRZ0.js → label-B6vXvwLM.js}

@@ -1,7 +1,6 @@
-const require_chunk = require('./chunk-nOFOJqeH.js');
-const require_common = require('./common-CCx-FJI4.js');
+const require_chunk = require('./chunk-kSYXY2_d.js');
+const require_common = require('./common-CEordwf3.js');
 let discord_js = require("discord.js");
-discord_js = require_chunk.__toESM(discord_js);
 
 //#region src/components/display/label.ts
 /**
@@ -17,7 +16,7 @@ discord_js = require_chunk.__toESM(discord_js);
 * ```
 */
 function Label(props) {
-	const { children, id,...rest } = props;
+	const { children, id, ...rest } = props;
 	const label = new discord_js.LabelBuilder({
 		...rest,
 		component: children
@@ -33,4 +32,4 @@ Object.defineProperty(exports, 'Label', {
     return Label;
   }
 });
-//# sourceMappingURL=label-D-uJWRZ0.js.map
+//# sourceMappingURL=label-B6vXvwLM.js.map

package/dist/{label-D-uJWRZ0.js.map → label-B6vXvwLM.js.map}

@@ -1 +1 @@
-{"version":3,"file":"label-D-uJWRZ0.js","names":[],"sources":["../src/components/display/label.ts"],"sourcesContent":["import {\n  APIComponentInLabel,\n  LabelBuilder,\n  type LabelBuilderData,\n} from 'discord.js';\nimport { applyId } from './common';\n\n/**\n * The label properties for the label component.\n */\nexport interface LabelProps\n  extends Omit<LabelBuilderData, 'component' | 'type'> {\n  /**\n   * The component that will be wrapped by the label component.\n   */\n  children: LabelBuilderData['component'] & {};\n}\n\n/**\n * The label component wraps modal components with text as a label and optional description.\n * @param props The label properties.\n * @returns The label builder instance.\n * @example ```tsx\n * import { Label } from 'commandkit';\n *\n * const label = <Label label=\"Name\" description=\"Enter your name\">\n *   <ShortInput customId=\"name\" label=\"Name\" placeholder=\"John\" required />\n * </Label>;\n * ```\n */\nexport function Label(props: LabelProps) {\n  const { children, id, ...rest } = props;\n\n  const label = new LabelBuilder({\n    ...rest,\n    // channel select menu builder is missing?\n    component: children as unknown as APIComponentInLabel,\n  });\n\n  applyId(props, label);\n\n  return label;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;AA8BA,SAAgB,MAAM,OAAmB;CACvC,MAAM,EAAE,UAAU,GAAI,GAAG,SAAS;CAElC,MAAM,QAAQ,IAAI,wBAAa;EAC7B,GAAG;EAEH,WAAW;EACZ,CAAC;AAEF,wBAAQ,OAAO,MAAM;AAErB,QAAO"}
+{"version":3,"file":"label-B6vXvwLM.js","names":[],"sources":["../src/components/display/label.ts"],"sourcesContent":["import {\n  APIComponentInLabel,\n  LabelBuilder,\n  type LabelBuilderData,\n} from 'discord.js';\nimport { applyId } from './common';\n\n/**\n * The label properties for the label component.\n */\nexport interface LabelProps\n  extends Omit<LabelBuilderData, 'component' | 'type'> {\n  /**\n   * The component that will be wrapped by the label component.\n   */\n  children: LabelBuilderData['component'] & {};\n}\n\n/**\n * The label component wraps modal components with text as a label and optional description.\n * @param props The label properties.\n * @returns The label builder instance.\n * @example ```tsx\n * import { Label } from 'commandkit';\n *\n * const label = <Label label=\"Name\" description=\"Enter your name\">\n *   <ShortInput customId=\"name\" label=\"Name\" placeholder=\"John\" required />\n * </Label>;\n * ```\n */\nexport function Label(props: LabelProps) {\n  const { children, id, ...rest } = props;\n\n  const label = new LabelBuilder({\n    ...rest,\n    // channel select menu builder is missing?\n    component: children as unknown as APIComponentInLabel,\n  });\n\n  applyId(props, label);\n\n  return label;\n}\n"],"mappings":";;;;;;;;;;;;;;;;;AA8BA,SAAgB,MAAM,OAAmB;CACvC,MAAM,EAAE,UAAU,IAAI,GAAG,SAAS;CAElC,MAAM,QAAQ,IAAI,wBAAa;EAC7B,GAAG;EAEH,WAAW;EACZ,CAAC;AAEF,wBAAQ,OAAO,MAAM;AAErB,QAAO"}

package/dist/logger/DefaultLogger.d.ts

@@ -1,3 +1,66 @@
-import "../ILogger-BQ2ew4zR.js";
-import { DefaultLogger } from "../DefaultLogger-CHMVsizQ.js";
-export { DefaultLogger };
+import { ILogger } from "./ILogger.js";
+
+//#region src/logger/DefaultLogger.d.ts
+/**
+ * Default logger implementation that logs messages to the console.
+ * It formats the log messages with timestamps, log levels, and context information.
+ */
+declare class DefaultLogger implements ILogger {
+  stdout: NodeJS.WriteStream & {
+    fd: 1;
+  };
+  stderr: NodeJS.WriteStream & {
+    fd: 2;
+  };
+  private logger;
+  /**
+       * Creates a new instance of DefaultLogger.
+       * @param stdout The output stream for standard messages (default: process.stdout).
+       * @param stderr The output stream for error messages (default: process.stderr).
+       */
+  constructor(stdout?: NodeJS.WriteStream & {
+    fd: 1;
+  }, stderr?: NodeJS.WriteStream & {
+    fd: 2;
+  });
+  private _formatTime;
+  private _getContext;
+  private _getLevelLabel;
+  private _getPrefix;
+  private _log;
+  private _logTemplate;
+  /**
+       * Logs a debug message.
+       * @param message The message to log.
+       */
+  debug(message: any): void;
+  debug(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs an error message.
+       * @param message The error message to log.
+       */
+  error(message: any): void;
+  error(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs a default message.
+       * @param message The message to log.
+       */
+  log(message: any): void;
+  log(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs an info message.
+       * @param message The informational message to log.
+       */
+  info(message: any): void;
+  info(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs a warning message.
+       * @param message The warning message to log.
+       */
+  warn(message: any): void;
+  warn(strings: TemplateStringsArray, ...values: any[]): void;
+  private _isTemplateStringsArray;
+}
+//#endregion
+export { DefaultLogger };
+//# sourceMappingURL=DefaultLogger.d.ts.map

package/dist/logger/DefaultLogger.js

@@ -1,41 +1,26 @@
-require('../colors-DL3ucTiT.js');
-require('../ActionRow-uJxU4UGo.js');
-require('../error-codes-Ds0bnPvT.js');
-const require_commandkit = require('../commandkit-DabqpQ6v.js');
-require('../warning-CszH8HeS.js');
-require('../common-0Iw8ZeM6.js');
-require('../common-CCx-FJI4.js');
-require('../container-DC0eQigs.js');
-require('../file-DAUOZYhC.js');
-require('../media-gallery-BLhwe5lO.js');
-require('../section-BMcHN97i.js');
-require('../separator-C___2K-f.js');
-require('../text-display-BtQR88kY.js');
-require('../label-D-uJWRZ0.js');
-require('../poll-Bc6rjeUS.js');
+require('../colors-Csc0X4QJ.js');
+require('../ActionRow-CSN_UKmM.js');
+const require_commandkit = require('../commandkit-SIjTLD2R.js');
+require('../container-DCPljKVH.js');
+require('../file-Ca1kpEtE.js');
+require('../media-gallery-u3gjX7yD.js');
+require('../section-BC8LF-B2.js');
+require('../separator-BUTiW7uz.js');
+require('../text-display-DANahMN3.js');
+require('../label-B6vXvwLM.js');
+require('../poll-CFe8yvoJ.js');
 require('../display-WDb9wMCv.js');
-require('../element-DibzzA5L.js');
-require('../types-TC4g3w91.js');
-require('../EventInterceptor-BWoEJMHZ.js');
-require('../constants-BMWH2YUr.js');
-require('../PluginCommon-CPWV5xuX.js');
-require('../CompilerPlugin-CZ4412Zm.js');
-require('../RuntimePlugin-COeXe8rP.js');
-require('../types-Cdh4uaFR.js');
-require('../resolve-file-url-CJoD0FAn.js');
-require('../runtime-Skt5NiOc.js');
-require('../utils-Br3eenD1.js');
-require('../types-package-D11rQXLs.js');
-require('../constants-D0dawKxO.js');
-require('../EventWorkerContext-D_9q1Bm2.js');
-require('../signals-Cnqe9dFV.js');
-require('../helpers-D2_1jih6.js');
-require('../MessageCommandParser-CKh-tM97.js');
-require('../CommandsRouter-CWMipIis.js');
-require('../EventsRouter-C04XqRKf.js');
+require('../constants-CxkFFZ7p.js');
+require('../types-package-CsTNfvv2.js');
+require('../constants-Cw8VjCVz.js');
+require('../EventWorkerContext-Dfhgv329.js');
+require('../signals-B8z1wJ6W.js');
+require('../helpers-Btx1FSZx.js');
+require('../MessageCommandParser-Bs9fimmd.js');
+require('../CommandsRouter-C_HLsrGX.js');
+require('../EventsRouter-DZYIha6m.js');
 require('../router-BvamdzoF.js');
-require('../common-fIO6fqGZ.js');
-require('../CommandKitEventsChannel-2l9Za-le.js');
-require('../store-ZwL2gN6a.js');
+require('../common-DSRs_mfw.js');
+require('../store-D8r_hryO.js');
 
 exports.DefaultLogger = require_commandkit.DefaultLogger;

package/dist/logger/ILogger.d.ts

@@ -1,2 +1,64 @@
-import { ILogger } from "../ILogger-BQ2ew4zR.js";
-export { ILogger };
+//#region src/logger/ILogger.d.ts
+/**
+ * ILogger interface for logging functionality.
+ */
+interface ILogger {
+  /**
+       * Logs a message with the default log level.
+       * @param message The message to log.
+       */
+  log(message: any): void;
+  /**
+       * Logs a message with the default log level using template literals.
+       * @param strings The template literal strings.
+       * @param values The values to interpolate.
+       */
+  log(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs an error message.
+       * @param message The error message to log.
+       */
+  error(message: any): void;
+  /**
+       * Logs an error message using template literals.
+       * @param strings The template literal strings.
+       * @param values The values to interpolate.
+       */
+  error(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs a warning message.
+       * @param message The warning message to log.
+       */
+  warn(message: any): void;
+  /**
+       * Logs a warning message using template literals.
+       * @param strings The template literal strings.
+       * @param values The values to interpolate.
+       */
+  warn(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs an informational message.
+       * @param message The informational message to log.
+       */
+  info(message: any): void;
+  /**
+       * Logs an informational message using template literals.
+       * @param strings The template literal strings.
+       * @param values The values to interpolate.
+       */
+  info(strings: TemplateStringsArray, ...values: any[]): void;
+  /**
+       * Logs a debug message.
+       * @param message The debug message to log.
+       */
+  debug(message: any): void;
+  /**
+       * Logs a debug message using template literals.
+       * @param strings The template literal strings.
+       * @param values The values to interpolate.
+       */
+  debug(strings: TemplateStringsArray, ...values: any[]): void;
+}
+//#endregion
+export { ILogger };
+//# sourceMappingURL=ILogger.d.ts.map

package/dist/logger/ILogger.js

@@ -1 +0,0 @@
-require('../ILogger-B0q7p7L1.js');

package/dist/logger/Logger.d.ts

@@ -1,3 +1,36 @@
-import "../ILogger-BQ2ew4zR.js";
-import { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger } from "../Logger-DyV7oli4.js";
-export { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger };
+import { ILogger } from "./ILogger.js";
+
+//#region src/logger/Logger.d.ts
+/**
+ * Options for configuring the CommandKit logger.
+ */
+interface CommandKitLoggerOptions {
+  /**
+       * The logger provider to use.
+       */
+  provider: ILogger;
+}
+/**
+ * Logger implementation for CommandKit.
+ */
+interface LoggerImpl extends ILogger {
+  /**
+       * Configures the logger with the specified options.
+       * @param options The logger options to apply.
+       */
+  configure(options: CommandKitLoggerOptions): void;
+}
+/**
+ * Creates a new logger instance with the specified options.
+ * @param options The options for configuring the logger.
+ * @returns A new logger instance.
+ */
+declare function createLogger(options: CommandKitLoggerOptions): LoggerImpl;
+/**
+ * Default logger instance for CommandKit. This logger uses the DefaultLogger as its provider.
+ * The provider can be replaced with a custom logger implementation using the `configure` method.
+ */
+declare const Logger: LoggerImpl;
+//#endregion
+export { CommandKitLoggerOptions, Logger, LoggerImpl, createLogger };
+//# sourceMappingURL=Logger.d.ts.map