@iskra-bun/kv-kit 0.1.0

package/CHANGELOG.md

@@ -0,0 +1,7 @@
+# @iskra-bun/kv-kit
+
+## 0.1.0
+
+### Minor Changes
+
+- Initial public release.

package/README.md

@@ -0,0 +1,31 @@
+# @iskra-bun/kv-kit
+
+Key-Value store de Iskra con adaptadores intercambiables de Redis y memoria.
+
+## Instalacion
+
+```bash
+bun add @iskra-bun/kv-kit @iskra-bun/core
+```
+
+## Uso rapido
+
+```typescript
+import { App } from '@iskra-bun/core'
+import { KVManager } from '@iskra-bun/kv-kit'
+
+const app = new App({ name: 'mi-app' })
+app.register(new KVManager({ adapter: 'memory' }))
+
+await app.start()
+```
+
+Cambia `adapter: 'redis'` para usar Redis en produccion; la API (`get`/`set`/`del`/`has`, TTL) es identica entre adaptadores.
+
+## Documentacion
+
+Guia completa: [docs/kv-kit.md](../../docs/kv-kit.md)
+
+## Licencia
+
+AGPL-3.0-or-later

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+import { Driver, App } from '@iskra-bun/core';
+
+interface KVAdapter {
+    id: string;
+    connect(): Promise<void> | void;
+    disconnect(): Promise<void> | void;
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+declare class KVManager implements Driver, KVAdapter {
+    name: string;
+    id: string;
+    private app;
+    private adapter;
+    constructor();
+    init(app: App): void;
+    connect(): Promise<void>;
+    disconnect(): Promise<void>;
+    start(): Promise<void>;
+    stop(): Promise<void>;
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}
+
+export { type KVAdapter, KVManager };

package/dist/index.js

@@ -0,0 +1,118 @@
+// src/adapters/memory.ts
+var MemoryAdapter = class {
+  id = "memory";
+  store = /* @__PURE__ */ new Map();
+  connect() {
+  }
+  disconnect() {
+    this.store.clear();
+  }
+  async get(key) {
+    return this.store.get(key);
+  }
+  async set(key, value, ttl) {
+    this.store.set(key, value);
+    if (ttl) {
+      setTimeout(() => this.store.delete(key), ttl * 1e3);
+    }
+  }
+  async del(key) {
+    this.store.delete(key);
+  }
+  async has(key) {
+    return this.store.has(key);
+  }
+};
+
+// src/adapters/redis.ts
+import Redis from "ioredis";
+var RedisAdapter = class {
+  id = "redis";
+  client = null;
+  options;
+  constructor(options) {
+    this.options = options;
+  }
+  connect() {
+    this.client = new Redis(this.options);
+  }
+  disconnect() {
+    this.client?.disconnect();
+  }
+  async get(key) {
+    const val = await this.client?.get(key);
+    try {
+      return val ? JSON.parse(val) : null;
+    } catch {
+      return val;
+    }
+  }
+  async set(key, value, ttl) {
+    const val = typeof value === "object" ? JSON.stringify(value) : value;
+    if (ttl) {
+      await this.client?.set(key, val, "EX", ttl);
+    } else {
+      await this.client?.set(key, val);
+    }
+  }
+  async del(key) {
+    await this.client?.del(key);
+  }
+  async has(key) {
+    const exists = await this.client?.exists(key);
+    return exists === 1;
+  }
+};
+
+// src/manager.ts
+var KVManager = class {
+  name = "KVManager";
+  id = "manager";
+  app = null;
+  adapter;
+  constructor() {
+    this.adapter = new MemoryAdapter();
+  }
+  init(app) {
+    this.app = app;
+    const config = app.config.kv;
+    if (config?.driver === "redis") {
+      app.logger.info("Initializing KV with Redis");
+      this.adapter = new RedisAdapter(config.connection);
+    } else {
+      app.logger.info("Initializing KV with Memory");
+      this.adapter = new MemoryAdapter();
+    }
+  }
+  async connect() {
+    await this.adapter.connect();
+    this.app?.logger.info("KV Store connected");
+  }
+  async disconnect() {
+    await this.adapter.disconnect();
+  }
+  // Driver Interface
+  async start() {
+    await this.connect();
+  }
+  async stop() {
+    await this.disconnect();
+  }
+  // Proxy methods
+  get(key) {
+    return this.adapter.get(key);
+  }
+  set(key, value, ttl) {
+    return this.adapter.set(key, value, ttl);
+  }
+  del(key) {
+    return this.adapter.del(key);
+  }
+  has(key) {
+    return this.adapter.has(key);
+  }
+};
+export {
+  KVManager
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/adapters/memory.ts","../src/adapters/redis.ts","../src/manager.ts"],"sourcesContent":["import type { KVAdapter } from '../types';\n\nexport class MemoryAdapter implements KVAdapter {\n    id = 'memory';\n    private store = new Map<string, any>();\n\n    connect() {\n        // No-op\n    }\n    disconnect() {\n        this.store.clear();\n    }\n\n    async get(key: string) {\n        return this.store.get(key);\n    }\n\n    async set(key: string, value: any, ttl?: number) {\n        this.store.set(key, value);\n        if (ttl) {\n            setTimeout(() => this.store.delete(key), ttl * 1000);\n        }\n    }\n\n    async del(key: string) {\n        this.store.delete(key);\n    }\n\n    async has(key: string) {\n        return this.store.has(key);\n    }\n}\n","import type { KVAdapter } from '../types';\nimport Redis from 'ioredis';\n\nexport class RedisAdapter implements KVAdapter {\n    id = 'redis';\n    private client: Redis | null = null;\n    private options: any;\n\n    constructor(options: any) {\n        this.options = options;\n    }\n\n    connect() {\n        this.client = new Redis(this.options);\n    }\n\n    disconnect() {\n        this.client?.disconnect();\n    }\n\n    async get(key: string) {\n        const val = await this.client?.get(key);\n        try {\n            return val ? JSON.parse(val) : null;\n        } catch {\n            return val;\n        }\n    }\n\n    async set(key: string, value: any, ttl?: number) {\n        const val = typeof value === 'object' ? JSON.stringify(value) : value;\n        if (ttl) {\n            await this.client?.set(key, val, 'EX', ttl);\n        } else {\n            await this.client?.set(key, val);\n        }\n    }\n\n    async del(key: string) {\n        await this.client?.del(key);\n    }\n\n    async has(key: string) {\n        const exists = await this.client?.exists(key);\n        return exists === 1;\n    }\n}\n","import type { App, Driver } from '@iskra-bun/core';\nimport type { KVAdapter } from './types';\nimport { MemoryAdapter } from './adapters/memory';\nimport { RedisAdapter } from './adapters/redis';\n\nexport class KVManager implements Driver, KVAdapter {\n    name = 'KVManager';\n    id = 'manager';\n    private app: App | null = null;\n    private adapter: KVAdapter;\n\n    constructor() {\n        // Default to memory until configured\n        this.adapter = new MemoryAdapter();\n    }\n\n    init(app: App) {\n        this.app = app;\n        const config = app.config.kv;\n\n        if (config?.driver === 'redis') {\n            app.logger.info('Initializing KV with Redis');\n            this.adapter = new RedisAdapter(config.connection);\n        } else {\n            app.logger.info('Initializing KV with Memory');\n            this.adapter = new MemoryAdapter();\n        }\n    }\n\n    async connect() {\n        await this.adapter.connect();\n        this.app?.logger.info('KV Store connected');\n    }\n\n    async disconnect() {\n        await this.adapter.disconnect();\n    }\n\n    // Driver Interface\n    async start() {\n        await this.connect();\n    }\n\n    async stop() {\n        await this.disconnect();\n    }\n\n    // Proxy methods\n    get(key: string) { return this.adapter.get(key); }\n    set(key: string, value: any, ttl?: number) { return this.adapter.set(key, value, ttl); }\n    del(key: string) { return this.adapter.del(key); }\n    has(key: string) { return this.adapter.has(key); }\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,57 @@
+{
+    "name": "@iskra-bun/kv-kit",
+    "version": "0.1.0",
+    "description": "Key-Value store de Iskra con adaptadores de Redis y memoria.",
+    "keywords": [
+        "iskra",
+        "bun",
+        "typescript",
+        "redis",
+        "kv",
+        "key-value",
+        "cache"
+    ],
+    "author": "Joan Lascano",
+    "license": "AGPL-3.0-or-later",
+    "repository": {
+        "type": "git",
+        "url": "git+https://github.com/fearful/iskra.git",
+        "directory": "packages/kv-kit"
+    },
+    "homepage": "https://github.com/fearful/iskra/tree/main/packages/kv-kit#readme",
+    "bugs": "https://github.com/fearful/iskra/issues",
+    "type": "module",
+    "main": "./dist/index.js",
+    "module": "./dist/index.js",
+    "types": "./dist/index.d.ts",
+    "exports": {
+        ".": {
+            "source": "./src/index.ts",
+            "bun": "./src/index.ts",
+            "types": "./dist/index.d.ts",
+            "import": "./dist/index.js",
+            "default": "./dist/index.js"
+        }
+    },
+    "files": [
+        "dist",
+        "src",
+        "README.md",
+        "CHANGELOG.md"
+    ],
+    "publishConfig": {
+        "access": "public"
+    },
+    "scripts": {
+        "test": "bun test",
+        "build": "tsup --config ../../tsup.config.ts"
+    },
+    "dependencies": {
+        "@iskra-bun/core": "0.1.0",
+        "ioredis": "^5.4.1"
+    },
+    "devDependencies": {
+        "@types/bun": "^1.3.5",
+        "@types/node": "^22.10.2"
+    }
+}

package/src/adapters/memory.ts

@@ -0,0 +1,32 @@
+import type { KVAdapter } from '../types';
+
+export class MemoryAdapter implements KVAdapter {
+    id = 'memory';
+    private store = new Map<string, any>();
+
+    connect() {
+        // No-op
+    }
+    disconnect() {
+        this.store.clear();
+    }
+
+    async get(key: string) {
+        return this.store.get(key);
+    }
+
+    async set(key: string, value: any, ttl?: number) {
+        this.store.set(key, value);
+        if (ttl) {
+            setTimeout(() => this.store.delete(key), ttl * 1000);
+        }
+    }
+
+    async del(key: string) {
+        this.store.delete(key);
+    }
+
+    async has(key: string) {
+        return this.store.has(key);
+    }
+}

package/src/adapters/redis.ts

@@ -0,0 +1,47 @@
+import type { KVAdapter } from '../types';
+import Redis from 'ioredis';
+
+export class RedisAdapter implements KVAdapter {
+    id = 'redis';
+    private client: Redis | null = null;
+    private options: any;
+
+    constructor(options: any) {
+        this.options = options;
+    }
+
+    connect() {
+        this.client = new Redis(this.options);
+    }
+
+    disconnect() {
+        this.client?.disconnect();
+    }
+
+    async get(key: string) {
+        const val = await this.client?.get(key);
+        try {
+            return val ? JSON.parse(val) : null;
+        } catch {
+            return val;
+        }
+    }
+
+    async set(key: string, value: any, ttl?: number) {
+        const val = typeof value === 'object' ? JSON.stringify(value) : value;
+        if (ttl) {
+            await this.client?.set(key, val, 'EX', ttl);
+        } else {
+            await this.client?.set(key, val);
+        }
+    }
+
+    async del(key: string) {
+        await this.client?.del(key);
+    }
+
+    async has(key: string) {
+        const exists = await this.client?.exists(key);
+        return exists === 1;
+    }
+}

package/src/index.ts

@@ -0,0 +1,2 @@
+export { KVManager } from './manager';
+export type { KVAdapter } from './types';

package/src/manager.ts

@@ -0,0 +1,53 @@
+import type { App, Driver } from '@iskra-bun/core';
+import type { KVAdapter } from './types';
+import { MemoryAdapter } from './adapters/memory';
+import { RedisAdapter } from './adapters/redis';
+
+export class KVManager implements Driver, KVAdapter {
+    name = 'KVManager';
+    id = 'manager';
+    private app: App | null = null;
+    private adapter: KVAdapter;
+
+    constructor() {
+        // Default to memory until configured
+        this.adapter = new MemoryAdapter();
+    }
+
+    init(app: App) {
+        this.app = app;
+        const config = app.config.kv;
+
+        if (config?.driver === 'redis') {
+            app.logger.info('Initializing KV with Redis');
+            this.adapter = new RedisAdapter(config.connection);
+        } else {
+            app.logger.info('Initializing KV with Memory');
+            this.adapter = new MemoryAdapter();
+        }
+    }
+
+    async connect() {
+        await this.adapter.connect();
+        this.app?.logger.info('KV Store connected');
+    }
+
+    async disconnect() {
+        await this.adapter.disconnect();
+    }
+
+    // Driver Interface
+    async start() {
+        await this.connect();
+    }
+
+    async stop() {
+        await this.disconnect();
+    }
+
+    // Proxy methods
+    get(key: string) { return this.adapter.get(key); }
+    set(key: string, value: any, ttl?: number) { return this.adapter.set(key, value, ttl); }
+    del(key: string) { return this.adapter.del(key); }
+    has(key: string) { return this.adapter.has(key); }
+}

package/src/types.ts

@@ -0,0 +1,10 @@
+export interface KVAdapter {
+    id: string; // 'memory', 'redis', 'libsql'
+    connect(): Promise<void> | void;
+    disconnect(): Promise<void> | void;
+
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+}