flamecache 0.0.1

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 Anish Roy
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,556 @@
+# Flamecache
+
+[![npm version](https://badge.fury.io/js/flamecache.svg)](https://www.npmjs.com/package/flamecache)
+[![License: MIT](https://img.shields.io/badge/License-MIT-yellow.svg)](https://opensource.org/licenses/MIT)
+[![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue)](https://www.typescriptlang.org/)
+[![Tests](https://github.com/iamanishroy/flamecache/workflows/CI/badge.svg)](https://github.com/iamanishroy/flamecache/actions)
+
+> A Redis-like caching layer for Firebase Realtime Database with automatic expiration, counters, and batch operations.
+
+Flamecache is a lightweight, robust caching solution that brings Redis-style operations to Firebase Realtime Database. Perfect for serverless applications, real-time apps, and projects already using Firebase.
+
+## ✨ Features
+
+- 🚀 **Redis-like API** - Familiar `get`, `set`, `incr`, `decr`, `expire` operations
+- ⚡ **Fast & Lightweight** - Only 5KB (bundled), no heavy dependencies
+- 🔄 **Auto-expiration** - Built-in TTL support with automatic cleanup
+- 📊 **Counters** - Atomic increment/decrement operations
+- 📦 **Batch Operations** - Multi-get, multi-set, multi-delete
+- 🎯 **TypeScript** - Full type safety with generics
+- 🔌 **Zero Config** - Works out of the box
+- 🌐 **Serverless Ready** - Perfect for Firebase Functions, Vercel, Netlify
+
+## 📦 Installation
+
+```bash
+npm install flamecache firebase
+```
+
+Flamecache requires Firebase as a peer dependency. If you don't have Firebase installed:
+
+```bash
+npm install firebase flamecache
+```
+
+## 🚀 Quick Start
+
+```typescript
+import { createCache } from 'flamecache';
+
+// Initialize cache
+const cache = createCache({
+  firebase: {
+    apiKey: 'your-api-key',
+    databaseURL: 'https://your-project.firebaseio.com',
+    projectId: 'your-project-id',
+  },
+  ttl: 3600, // Default TTL: 1 hour
+});
+
+// Basic usage
+await cache.set('user:123', { name: 'Alice', email: 'alice@example.com' });
+const user = await cache.get('user:123');
+
+// With custom TTL (in seconds)
+await cache.set('temp:token', 'abc123', 300); // Expires in 5 minutes
+
+// Counters
+await cache.incr('views:post:456'); // Increment view count
+const views = await cache.get('views:post:456'); // 1
+
+// Read-through caching
+const posts = await cache.wrap(
+  'posts:latest',
+  async () => {
+    // This function only runs on cache miss
+    const response = await fetch('https://api.example.com/posts');
+    return response.json();
+  },
+  600
+); // Cache for 10 minutes
+```
+
+## 📖 API Reference
+
+### Core Operations
+
+#### `get<T>(key: string): Promise<T | null>`
+
+Retrieve a value from cache.
+
+```typescript
+const user = await cache.get<User>('user:123');
+if (user) {
+  console.log(user.name);
+}
+```
+
+#### `set<T>(key: string, data: T, ttl?: number): Promise<void>`
+
+Store a value in cache with optional TTL (in seconds).
+
+```typescript
+// With default TTL
+await cache.set('user:123', userData);
+
+// With custom TTL (10 minutes)
+await cache.set('session:abc', sessionData, 600);
+
+// Never expires
+await cache.set('config', configData, 0);
+```
+
+#### `del(key: string): Promise<void>`
+
+Delete a key from cache.
+
+```typescript
+await cache.del('user:123');
+```
+
+#### `has(key: string): Promise<boolean>`
+
+Check if a key exists and is not expired.
+
+```typescript
+if (await cache.has('session:abc')) {
+  console.log('Session is valid');
+}
+```
+
+#### `clear(): Promise<void>`
+
+Clear all cache entries.
+
+```typescript
+await cache.clear();
+```
+
+### Counter Operations
+
+#### `incr(key: string, by?: number): Promise<number>`
+
+Increment a numeric value. Returns the new value.
+
+```typescript
+const views = await cache.incr('views:post:123'); // Increment by 1
+const score = await cache.incr('score:player', 10); // Increment by 10
+```
+
+#### `decr(key: string, by?: number): Promise<number>`
+
+Decrement a numeric value. Returns the new value.
+
+```typescript
+const stock = await cache.decr('stock:item:456'); // Decrement by 1
+const credits = await cache.decr('credits:user', 5); // Decrement by 5
+```
+
+### TTL Operations
+
+#### `expire(key: string, ttl: number): Promise<boolean>`
+
+Set or update expiration time for an existing key (in seconds).
+
+```typescript
+await cache.expire('session:abc', 300); // Expire in 5 minutes
+await cache.expire('permanent:key', 0); // Remove expiration
+```
+
+#### `getTtl(key: string): Promise<number>`
+
+Get remaining time-to-live in seconds.
+
+- Returns `0` if key doesn't exist or is expired
+- Returns `-1` if key has no expiration
+- Returns remaining seconds otherwise
+
+```typescript
+const remaining = await cache.ttl('session:abc');
+if (remaining > 0 && remaining < 300) {
+  console.log('Session expiring soon!');
+}
+```
+
+#### `touch(key: string, ttl?: number): Promise<boolean>`
+
+Refresh TTL without changing the value.
+
+```typescript
+// Use default TTL
+await cache.touch('session:abc');
+
+// Use custom TTL
+await cache.touch('session:abc', 3600);
+```
+
+### Batch Operations
+
+#### `mget<T>(keys: string[]): Promise<(T | null)[]>`
+
+Get multiple keys at once.
+
+```typescript
+const [user1, user2, user3] = await cache.mget(['user:1', 'user:2', 'user:3']);
+```
+
+#### `mset(entries: Record<string, any>, ttl?: number): Promise<void>`
+
+Set multiple keys at once.
+
+```typescript
+await cache.mset(
+  {
+    'user:1': userData1,
+    'user:2': userData2,
+    'user:3': userData3,
+  },
+  600
+); // All expire in 10 minutes
+```
+
+#### `mdel(keys: string[]): Promise<void>`
+
+Delete multiple keys at once.
+
+```typescript
+await cache.mdel(['temp:1', 'temp:2', 'temp:3']);
+```
+
+### Advanced Operations
+
+#### `wrap<T>(key: string, fetchFn: () => Promise<T>, ttl?: number): Promise<T>`
+
+Read-through caching pattern. Gets from cache or fetches and stores automatically.
+
+```typescript
+const userData = await cache.wrap(
+  'user:123',
+  async () => {
+    // This only runs on cache miss
+    const response = await fetch(`/api/users/123`);
+    return response.json();
+  },
+  300
+);
+```
+
+#### `pull<T>(key: string): Promise<T | null>`
+
+Get and delete in one operation (atomic pop).
+
+```typescript
+const token = await cache.pull('temp:verification-token');
+// Token is retrieved and deleted
+```
+
+## 🎯 Use Cases
+
+### 1. Rate Limiting
+
+```typescript
+async function checkRateLimit(userId: string): Promise<boolean> {
+  const key = `ratelimit:${userId}`;
+  const count = await cache.incr(key);
+
+  // Set expiration on first request
+  if (count === 1) {
+    await cache.expire(key, 60); // Reset every minute
+  }
+
+  return count <= 100; // Max 100 requests per minute
+}
+
+// Usage
+if (!(await checkRateLimit('user123'))) {
+  throw new Error('Rate limit exceeded');
+}
+```
+
+### 2. Session Management
+
+```typescript
+class SessionManager {
+  async create(userId: string, data: any): Promise<string> {
+    const sessionId = generateId();
+    await cache.set(
+      `session:${sessionId}`,
+      {
+        userId,
+        ...data,
+        createdAt: Date.now(),
+      },
+      3600
+    ); // 1 hour session
+    return sessionId;
+  }
+
+  async get(sessionId: string) {
+    return await cache.get(`session:${sessionId}`);
+  }
+
+  async extend(sessionId: string): Promise<boolean> {
+    return await cache.touch(`session:${sessionId}`, 3600);
+  }
+
+  async destroy(sessionId: string): Promise<void> {
+    await cache.del(`session:${sessionId}`);
+  }
+}
+```
+
+### 3. API Response Caching
+
+```typescript
+async function getUser(userId: string) {
+  return cache.wrap(
+    `api:user:${userId}`,
+    async () => {
+      console.log('Fetching from API...');
+      const response = await fetch(`https://api.example.com/users/${userId}`);
+      return response.json();
+    },
+    600
+  ); // Cache for 10 minutes
+}
+
+// First call - fetches from API
+const user1 = await getUser('123');
+
+// Second call - uses cache (within 10 minutes)
+const user2 = await getUser('123');
+```
+
+### 4. Leaderboard / Scoring
+
+```typescript
+async function addScore(playerId: string, points: number) {
+  await cache.incr(`score:${playerId}`, points);
+}
+
+async function getTopScores(playerIds: string[]) {
+  const keys = playerIds.map((id) => `score:${id}`);
+  const scores = await cache.mget<number>(keys);
+
+  return playerIds
+    .map((id, i) => ({
+      playerId: id,
+      score: scores[i] || 0,
+    }))
+    .sort((a, b) => b.score - a.score);
+}
+```
+
+### 5. Temporary Tokens
+
+```typescript
+async function createVerificationToken(email: string): Promise<string> {
+  const token = generateToken();
+  await cache.set(`verify:${token}`, { email }, 900); // 15 minutes
+  return token;
+}
+
+async function verifyToken(token: string) {
+  // Pull removes the token after reading (one-time use)
+  const data = await cache.pull(`verify:${token}`);
+  if (!data) {
+    throw new Error('Invalid or expired token');
+  }
+  return data;
+}
+```
+
+### 6. Real-time Analytics
+
+```typescript
+// Track page views
+async function trackPageView(pageId: string) {
+  await cache.incr(`views:${pageId}`);
+  await cache.incr(`views:today:${pageId}`);
+
+  // Expire daily stats at midnight
+  const secondsUntilMidnight = getSecondsUntilMidnight();
+  await cache.expire(`views:today:${pageId}`, secondsUntilMidnight);
+}
+
+// Get analytics
+async function getAnalytics(pageIds: string[]) {
+  const totalKeys = pageIds.map((id) => `views:${id}`);
+  const todayKeys = pageIds.map((id) => `views:today:${id}`);
+
+  const [totalViews, todayViews] = await Promise.all([
+    cache.mget<number>(totalKeys),
+    cache.mget<number>(todayKeys),
+  ]);
+
+  return pageIds.map((id, i) => ({
+    pageId: id,
+    total: totalViews[i] || 0,
+    today: todayViews[i] || 0,
+  }));
+}
+```
+
+## 🔧 Configuration
+
+```typescript
+interface CacheConfig {
+  // Firebase configuration (required)
+  firebase: {
+    apiKey: string;
+    authDomain?: string;
+    databaseURL: string;
+    projectId: string;
+    storageBucket?: string;
+    messagingSenderId?: string;
+    appId?: string;
+  };
+
+  // Root path in Firebase database (default: 'flamecache')
+  rootPath?: string;
+
+  // Default TTL in seconds (default: 3600 = 1 hour, 0 = never expires)
+  ttl?: number;
+
+  // Enable debug logs (default: false)
+  debug?: boolean;
+}
+
+// Example with all options
+const cache = createCache({
+  firebase: {
+    /* ... */
+  },
+  rootPath: 'my-cache',
+  ttl: 7200, // 2 hours
+  debug: true, // Log all operations
+});
+```
+
+## 🔑 Key Naming Conventions
+
+Use colons (`:`) to create hierarchical keys for better organization:
+
+```typescript
+// Good ✅
+'user:123';
+'user:123:profile';
+'session:abc123';
+'api:github:users:456';
+'ratelimit:user:789';
+'cache:posts:latest';
+
+// Avoid ❌
+'user_123';
+'user-profile-123';
+'session.abc123';
+```
+
+## 🎨 TypeScript Support
+
+Full TypeScript support with generics:
+
+```typescript
+interface User {
+  id: string;
+  name: string;
+  email: string;
+}
+
+// Type-safe operations
+const user = await cache.get<User>('user:123');
+// user is typed as User | null
+
+await cache.set<User>('user:123', {
+  id: '123',
+  name: 'Alice',
+  email: 'alice@example.com',
+});
+
+// Works with complex types
+type ApiResponse = {
+  data: User[];
+  meta: { total: number };
+};
+
+const response = await cache.wrap<ApiResponse>('api:users', fetchUsers);
+```
+
+## 🔒 Firebase Security Rules
+
+### Development
+
+```json
+{
+  "rules": {
+    "cache": {
+      ".read": true,
+      ".write": true
+    }
+  }
+}
+```
+
+### Production
+
+```json
+{
+  "rules": {
+    "cache": {
+      ".read": "auth != null",
+      ".write": "auth != null"
+    }
+  }
+}
+```
+
+### Advanced (per-user caching)
+
+```json
+{
+  "rules": {
+    "cache": {
+      "users": {
+        "$uid": {
+          ".read": "$uid === auth.uid",
+          ".write": "$uid === auth.uid"
+        }
+      },
+      "public": {
+        ".read": true,
+        ".write": "auth != null"
+      }
+    }
+  }
+}
+```
+
+## 🤝 Contributing
+
+Contributions are welcome! Please feel free to submit a Pull Request.
+
+```bash
+# Clone the repo
+git clone https://github.com/iamanishroy/flamecache.git
+cd flamecache
+
+# Install dependencies
+npm install
+
+# Run tests
+npm test
+
+# Build
+npm run build
+```
+
+## 📝 License
+
+MIT © [Anish Roy](https://anishroy.com)
+
+## 🔗 Links
+
+- [GitHub Repository](https://github.com/iamanishroy/flamecache)
+- [npm Package](https://www.npmjs.com/package/flamecache)
+- [Report Issues](https://github.com/iamanishroy/flamecache/issues)
+- [Firebase Documentation](https://firebase.google.com/docs/database)

package/dist/index.d.mts

@@ -0,0 +1,42 @@
+import { FirebaseOptions } from 'firebase/app';
+export { FirebaseOptions } from 'firebase/app';
+
+interface CacheConfig {
+    firebase: FirebaseOptions;
+    rootPath?: string;
+    ttl?: number;
+    debug?: boolean;
+}
+interface CacheEntry<T> {
+    data: T;
+    exp: number | null;
+}
+
+declare class FirebaseCache {
+    private db;
+    private root;
+    private ttl;
+    private debug;
+    constructor(config: CacheConfig);
+    private path;
+    private log;
+    get<T = any>(key: string): Promise<T | null>;
+    set<T = any>(key: string, data: T, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    wrap<T = any>(key: string, fetchFn: () => Promise<T>, ttl?: number): Promise<T>;
+    mget<T = any>(keys: string[]): Promise<(T | null)[]>;
+    mset(entries: Record<string, any>, ttl?: number): Promise<void>;
+    mdel(keys: string[]): Promise<void>;
+    clear(): Promise<void>;
+    disconnect(): Promise<void>;
+    touch(key: string, ttl?: number): Promise<boolean>;
+    pull<T = any>(key: string): Promise<T | null>;
+    incr(key: string, by?: number): Promise<number>;
+    decr(key: string, by?: number): Promise<number>;
+    expire(key: string, ttl: number): Promise<boolean>;
+    getTtl(key: string): Promise<number>;
+}
+declare function createCache(config: CacheConfig): FirebaseCache;
+
+export { type CacheConfig, type CacheEntry, FirebaseCache, createCache };

package/dist/index.d.ts

@@ -0,0 +1,42 @@
+import { FirebaseOptions } from 'firebase/app';
+export { FirebaseOptions } from 'firebase/app';
+
+interface CacheConfig {
+    firebase: FirebaseOptions;
+    rootPath?: string;
+    ttl?: number;
+    debug?: boolean;
+}
+interface CacheEntry<T> {
+    data: T;
+    exp: number | null;
+}
+
+declare class FirebaseCache {
+    private db;
+    private root;
+    private ttl;
+    private debug;
+    constructor(config: CacheConfig);
+    private path;
+    private log;
+    get<T = any>(key: string): Promise<T | null>;
+    set<T = any>(key: string, data: T, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    has(key: string): Promise<boolean>;
+    wrap<T = any>(key: string, fetchFn: () => Promise<T>, ttl?: number): Promise<T>;
+    mget<T = any>(keys: string[]): Promise<(T | null)[]>;
+    mset(entries: Record<string, any>, ttl?: number): Promise<void>;
+    mdel(keys: string[]): Promise<void>;
+    clear(): Promise<void>;
+    disconnect(): Promise<void>;
+    touch(key: string, ttl?: number): Promise<boolean>;
+    pull<T = any>(key: string): Promise<T | null>;
+    incr(key: string, by?: number): Promise<number>;
+    decr(key: string, by?: number): Promise<number>;
+    expire(key: string, ttl: number): Promise<boolean>;
+    getTtl(key: string): Promise<number>;
+}
+declare function createCache(config: CacheConfig): FirebaseCache;
+
+export { type CacheConfig, type CacheEntry, FirebaseCache, createCache };

package/dist/index.js

@@ -0,0 +1,174 @@
+'use strict';
+
+var app = require('firebase/app');
+var database = require('firebase/database');
+
+// src/cache.ts
+var FirebaseCache = class {
+  constructor(config) {
+    let app$1;
+    const existingApp = app.getApps().find((a) => a.name === (config.rootPath || "[DEFAULT]"));
+    if (existingApp) {
+      app$1 = existingApp;
+    } else {
+      app$1 = app.initializeApp(config.firebase, config.rootPath || "[DEFAULT]");
+    }
+    this.db = database.getDatabase(app$1);
+    this.root = config.rootPath || "flamecache";
+    this.ttl = config.ttl || 3600;
+    this.debug = config.debug || false;
+  }
+  path(key) {
+    return `${this.root}/${key}`;
+  }
+  log(...args) {
+    if (this.debug) console.log("[Flamecache]", ...args);
+  }
+  async get(key) {
+    try {
+      const snapshot = await database.get(database.ref(this.db, this.path(key)));
+      if (!snapshot.exists()) {
+        this.log("miss:", key);
+        return null;
+      }
+      const entry = snapshot.val();
+      if (entry.exp && Date.now() > entry.exp) {
+        this.log("expired:", key);
+        await this.del(key);
+        return null;
+      }
+      this.log("hit:", key);
+      return entry.data;
+    } catch (err) {
+      this.log("error get:", key, err);
+      return null;
+    }
+  }
+  async set(key, data, ttl) {
+    try {
+      const seconds = ttl !== void 0 ? ttl : this.ttl;
+      const entry = {
+        data,
+        exp: seconds > 0 ? Date.now() + seconds * 1e3 : null
+      };
+      await database.set(database.ref(this.db, this.path(key)), entry);
+      this.log("set:", key, `(${seconds}s)`);
+    } catch (err) {
+      this.log("error set:", key, err);
+      throw err;
+    }
+  }
+  async del(key) {
+    try {
+      await database.remove(database.ref(this.db, this.path(key)));
+      this.log("del:", key);
+    } catch (err) {
+      this.log("error del:", key, err);
+    }
+  }
+  async has(key) {
+    return await this.get(key) !== null;
+  }
+  async wrap(key, fetchFn, ttl) {
+    const cached = await this.get(key);
+    if (cached !== null) return cached;
+    this.log("fetch:", key);
+    const data = await fetchFn();
+    await this.set(key, data, ttl);
+    return data;
+  }
+  async mget(keys) {
+    return Promise.all(keys.map((k) => this.get(k)));
+  }
+  async mset(entries, ttl) {
+    await Promise.all(
+      Object.entries(entries).map(([k, v]) => this.set(k, v, ttl))
+    );
+  }
+  async mdel(keys) {
+    await Promise.all(keys.map((k) => this.del(k)));
+  }
+  async clear() {
+    try {
+      await database.remove(database.ref(this.db, this.root));
+      this.log("cleared all");
+    } catch (err) {
+      this.log("error clear:", err);
+      throw err;
+    }
+  }
+  async disconnect() {
+    await database.goOffline(this.db);
+    this.log("disconnected");
+  }
+  async touch(key, ttl) {
+    const data = await this.get(key);
+    if (data === null) return false;
+    await this.set(key, data, ttl);
+    return true;
+  }
+  async pull(key) {
+    const data = await this.get(key);
+    if (data !== null) await this.del(key);
+    return data;
+  }
+  async incr(key, by = 1) {
+    const op = by >= 0 ? "incr" : "decr";
+    try {
+      const path = this.path(key);
+      const dbRef = database.ref(this.db, path);
+      await database.update(dbRef, {
+        "data": database.increment(by),
+        "exp": this.ttl > 0 ? Date.now() + this.ttl * 1e3 : null
+      });
+      const newValue = await this.get(key);
+      const sign = by >= 0 ? "+" : "";
+      this.log(`${op}:`, key, `${sign}${by} (atomic)`);
+      return newValue ?? 0;
+    } catch (err) {
+      this.log(`error ${op}:`, key, err);
+      throw err;
+    }
+  }
+  async decr(key, by = 1) {
+    return this.incr(key, -by);
+  }
+  async expire(key, ttl) {
+    try {
+      const snapshot = await database.get(database.ref(this.db, this.path(key)));
+      if (!snapshot.exists()) {
+        this.log("expire failed - key not found:", key);
+        return false;
+      }
+      const entry = snapshot.val();
+      entry.exp = ttl > 0 ? Date.now() + ttl * 1e3 : null;
+      await database.set(database.ref(this.db, this.path(key)), entry);
+      this.log("expire:", key, `(${ttl}s)`);
+      return true;
+    } catch (err) {
+      this.log("error expire:", key, err);
+      return false;
+    }
+  }
+  async getTtl(key) {
+    try {
+      const snapshot = await database.get(database.ref(this.db, this.path(key)));
+      if (!snapshot.exists()) return 0;
+      const entry = snapshot.val();
+      if (!entry.exp) return -1;
+      const remaining = Math.max(0, Math.floor((entry.exp - Date.now()) / 1e3));
+      return remaining;
+    } catch (err) {
+      this.log("error ttl:", key, err);
+      return 0;
+    }
+  }
+};
+function createCache(config) {
+  return new FirebaseCache(config);
+}
+
+exports.FirebaseCache = FirebaseCache;
+exports.createCache = createCache;
+//# sourceMappingURL=index.js.map
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts"],"names":["app","getApps","initializeApp","getDatabase","get","ref","set","remove","goOffline","update","increment"],"mappings":"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","file":"index.js","sourcesContent":["import { initializeApp, getApps } from 'firebase/app';\nimport { \n  getDatabase, \n  ref, \n  get, \n  set, \n  remove, \n  goOffline,\n  update,\n  increment,\n  Database \n} from 'firebase/database';\nimport { CacheConfig, CacheEntry } from './types';\n\nexport class FirebaseCache {\n  private db: Database;\n  private root: string;\n  private ttl: number;\n  private debug: boolean;\n\n  constructor(config: CacheConfig) {\n    let app;\n    const existingApp = getApps().find(a => a.name === (config.rootPath || '[DEFAULT]'));\n    if (existingApp) {\n      app = existingApp;\n    } else {\n      app = initializeApp(config.firebase, config.rootPath || '[DEFAULT]');\n    }\n    \n    this.db = getDatabase(app);\n    this.root = config.rootPath || 'flamecache';\n    this.ttl = config.ttl || 3600;\n    this.debug = config.debug || false;\n  }\n\n  private path(key: string): string {\n    return `${this.root}/${key}`;\n  }\n\n  private log(...args: any[]): void {\n    if (this.debug) console.log('[Flamecache]', ...args);\n  }\n\n  async get<T = any>(key: string): Promise<T | null> {\n    try {\n      const snapshot = await get(ref(this.db, this.path(key)));\n      if (!snapshot.exists()) {\n        this.log('miss:', key);\n        return null;\n      }\n\n      const entry: CacheEntry<T> = snapshot.val();\n      \n      if (entry.exp && Date.now() > entry.exp) {\n        this.log('expired:', key);\n        await this.del(key);\n        return null;\n      }\n\n      this.log('hit:', key);\n      return entry.data;\n    } catch (err) {\n      this.log('error get:', key, err);\n      return null;\n    }\n  }\n\n  async set<T = any>(key: string, data: T, ttl?: number): Promise<void> {\n    try {\n      const seconds = ttl !== undefined ? ttl : this.ttl;\n      const entry: CacheEntry<T> = {\n        data,\n        exp: seconds > 0 ? Date.now() + (seconds * 1000) : null\n      };\n      \n      await set(ref(this.db, this.path(key)), entry);\n      this.log('set:', key, `(${seconds}s)`);\n    } catch (err) {\n      this.log('error set:', key, err);\n      throw err;\n    }\n  }\n\n  async del(key: string): Promise<void> {\n    try {\n      await remove(ref(this.db, this.path(key)));\n      this.log('del:', key);\n    } catch (err) {\n      this.log('error del:', key, err);\n    }\n  }\n\n  async has(key: string): Promise<boolean> {\n    return (await this.get(key)) !== null;\n  }\n\n  async wrap<T = any>(\n    key: string,\n    fetchFn: () => Promise<T>,\n    ttl?: number\n  ): Promise<T> {\n    const cached = await this.get<T>(key);\n    if (cached !== null) return cached;\n\n    this.log('fetch:', key);\n    const data = await fetchFn();\n    await this.set(key, data, ttl);\n    return data;\n  }\n\n  async mget<T = any>(keys: string[]): Promise<(T | null)[]> {\n    return Promise.all(keys.map(k => this.get<T>(k)));\n  }\n\n  async mset(entries: Record<string, any>, ttl?: number): Promise<void> {\n    await Promise.all(\n      Object.entries(entries).map(([k, v]) => this.set(k, v, ttl))\n    );\n  }\n\n  async mdel(keys: string[]): Promise<void> {\n    await Promise.all(keys.map(k => this.del(k)));\n  }\n\n  async clear(): Promise<void> {\n    try {\n      await remove(ref(this.db, this.root));\n      this.log('cleared all');\n    } catch (err) {\n      this.log('error clear:', err);\n      throw err;\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    await goOffline(this.db);\n    this.log('disconnected');\n  }\n\n  async touch(key: string, ttl?: number): Promise<boolean> {\n    const data = await this.get(key);\n    if (data === null) return false;\n    await this.set(key, data, ttl);\n    return true;\n  }\n\n  async pull<T = any>(key: string): Promise<T | null> {\n    const data = await this.get<T>(key);\n    if (data !== null) await this.del(key);\n    return data;\n  }\n\n  async incr(key: string, by: number = 1): Promise<number> {\n    const op = by >= 0 ? 'incr' : 'decr';\n    try {\n      const path = this.path(key);\n      const dbRef = ref(this.db, path);\n      \n      await update(dbRef, {\n        'data': increment(by),\n        'exp': this.ttl > 0 ? Date.now() + (this.ttl * 1000) : null\n      });\n\n      const newValue = await this.get<number>(key);\n      const sign = by >= 0 ? '+' : '';\n      this.log(`${op}:`, key, `${sign}${by} (atomic)`);\n      return newValue ?? 0;\n    } catch (err) {\n      this.log(`error ${op}:`, key, err);\n      throw err;\n    }\n  }\n\n  async decr(key: string, by: number = 1): Promise<number> {\n    return this.incr(key, -by);\n  }\n\n  async expire(key: string, ttl: number): Promise<boolean> {\n    try {\n      const snapshot = await get(ref(this.db, this.path(key)));\n      if (!snapshot.exists()) {\n        this.log('expire failed - key not found:', key);\n        return false;\n      }\n\n      const entry: CacheEntry<any> = snapshot.val();\n      entry.exp = ttl > 0 ? Date.now() + (ttl * 1000) : null;\n      \n      await set(ref(this.db, this.path(key)), entry);\n      this.log('expire:', key, `(${ttl}s)`);\n      return true;\n    } catch (err) {\n      this.log('error expire:', key, err);\n      return false;\n    }\n  }\n\n  async getTtl(key: string): Promise<number> {\n    try {\n      const snapshot = await get(ref(this.db, this.path(key)));\n      if (!snapshot.exists()) return 0;\n\n      const entry: CacheEntry<any> = snapshot.val();\n      \n      if (!entry.exp) return -1;\n      \n      const remaining = Math.max(0, Math.floor((entry.exp - Date.now()) / 1000));\n      return remaining;\n    } catch (err) {\n      this.log('error ttl:', key, err);\n      return 0;\n    }\n  }\n}\n\nexport function createCache(config: CacheConfig): FirebaseCache {\n  return new FirebaseCache(config);\n}\n"]}

package/dist/index.mjs

@@ -0,0 +1,171 @@
+import { getApps, initializeApp } from 'firebase/app';
+import { getDatabase, get, ref, set, remove, goOffline, update, increment } from 'firebase/database';
+
+// src/cache.ts
+var FirebaseCache = class {
+  constructor(config) {
+    let app;
+    const existingApp = getApps().find((a) => a.name === (config.rootPath || "[DEFAULT]"));
+    if (existingApp) {
+      app = existingApp;
+    } else {
+      app = initializeApp(config.firebase, config.rootPath || "[DEFAULT]");
+    }
+    this.db = getDatabase(app);
+    this.root = config.rootPath || "flamecache";
+    this.ttl = config.ttl || 3600;
+    this.debug = config.debug || false;
+  }
+  path(key) {
+    return `${this.root}/${key}`;
+  }
+  log(...args) {
+    if (this.debug) console.log("[Flamecache]", ...args);
+  }
+  async get(key) {
+    try {
+      const snapshot = await get(ref(this.db, this.path(key)));
+      if (!snapshot.exists()) {
+        this.log("miss:", key);
+        return null;
+      }
+      const entry = snapshot.val();
+      if (entry.exp && Date.now() > entry.exp) {
+        this.log("expired:", key);
+        await this.del(key);
+        return null;
+      }
+      this.log("hit:", key);
+      return entry.data;
+    } catch (err) {
+      this.log("error get:", key, err);
+      return null;
+    }
+  }
+  async set(key, data, ttl) {
+    try {
+      const seconds = ttl !== void 0 ? ttl : this.ttl;
+      const entry = {
+        data,
+        exp: seconds > 0 ? Date.now() + seconds * 1e3 : null
+      };
+      await set(ref(this.db, this.path(key)), entry);
+      this.log("set:", key, `(${seconds}s)`);
+    } catch (err) {
+      this.log("error set:", key, err);
+      throw err;
+    }
+  }
+  async del(key) {
+    try {
+      await remove(ref(this.db, this.path(key)));
+      this.log("del:", key);
+    } catch (err) {
+      this.log("error del:", key, err);
+    }
+  }
+  async has(key) {
+    return await this.get(key) !== null;
+  }
+  async wrap(key, fetchFn, ttl) {
+    const cached = await this.get(key);
+    if (cached !== null) return cached;
+    this.log("fetch:", key);
+    const data = await fetchFn();
+    await this.set(key, data, ttl);
+    return data;
+  }
+  async mget(keys) {
+    return Promise.all(keys.map((k) => this.get(k)));
+  }
+  async mset(entries, ttl) {
+    await Promise.all(
+      Object.entries(entries).map(([k, v]) => this.set(k, v, ttl))
+    );
+  }
+  async mdel(keys) {
+    await Promise.all(keys.map((k) => this.del(k)));
+  }
+  async clear() {
+    try {
+      await remove(ref(this.db, this.root));
+      this.log("cleared all");
+    } catch (err) {
+      this.log("error clear:", err);
+      throw err;
+    }
+  }
+  async disconnect() {
+    await goOffline(this.db);
+    this.log("disconnected");
+  }
+  async touch(key, ttl) {
+    const data = await this.get(key);
+    if (data === null) return false;
+    await this.set(key, data, ttl);
+    return true;
+  }
+  async pull(key) {
+    const data = await this.get(key);
+    if (data !== null) await this.del(key);
+    return data;
+  }
+  async incr(key, by = 1) {
+    const op = by >= 0 ? "incr" : "decr";
+    try {
+      const path = this.path(key);
+      const dbRef = ref(this.db, path);
+      await update(dbRef, {
+        "data": increment(by),
+        "exp": this.ttl > 0 ? Date.now() + this.ttl * 1e3 : null
+      });
+      const newValue = await this.get(key);
+      const sign = by >= 0 ? "+" : "";
+      this.log(`${op}:`, key, `${sign}${by} (atomic)`);
+      return newValue ?? 0;
+    } catch (err) {
+      this.log(`error ${op}:`, key, err);
+      throw err;
+    }
+  }
+  async decr(key, by = 1) {
+    return this.incr(key, -by);
+  }
+  async expire(key, ttl) {
+    try {
+      const snapshot = await get(ref(this.db, this.path(key)));
+      if (!snapshot.exists()) {
+        this.log("expire failed - key not found:", key);
+        return false;
+      }
+      const entry = snapshot.val();
+      entry.exp = ttl > 0 ? Date.now() + ttl * 1e3 : null;
+      await set(ref(this.db, this.path(key)), entry);
+      this.log("expire:", key, `(${ttl}s)`);
+      return true;
+    } catch (err) {
+      this.log("error expire:", key, err);
+      return false;
+    }
+  }
+  async getTtl(key) {
+    try {
+      const snapshot = await get(ref(this.db, this.path(key)));
+      if (!snapshot.exists()) return 0;
+      const entry = snapshot.val();
+      if (!entry.exp) return -1;
+      const remaining = Math.max(0, Math.floor((entry.exp - Date.now()) / 1e3));
+      return remaining;
+    } catch (err) {
+      this.log("error ttl:", key, err);
+      return 0;
+    }
+  }
+};
+function createCache(config) {
+  return new FirebaseCache(config);
+}
+
+export { FirebaseCache, createCache };
+//# sourceMappingURL=index.mjs.map
+//# sourceMappingURL=index.mjs.map

package/dist/index.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/cache.ts"],"names":[],"mappings":"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","file":"index.mjs","sourcesContent":["import { initializeApp, getApps } from 'firebase/app';\nimport { \n  getDatabase, \n  ref, \n  get, \n  set, \n  remove, \n  goOffline,\n  update,\n  increment,\n  Database \n} from 'firebase/database';\nimport { CacheConfig, CacheEntry } from './types';\n\nexport class FirebaseCache {\n  private db: Database;\n  private root: string;\n  private ttl: number;\n  private debug: boolean;\n\n  constructor(config: CacheConfig) {\n    let app;\n    const existingApp = getApps().find(a => a.name === (config.rootPath || '[DEFAULT]'));\n    if (existingApp) {\n      app = existingApp;\n    } else {\n      app = initializeApp(config.firebase, config.rootPath || '[DEFAULT]');\n    }\n    \n    this.db = getDatabase(app);\n    this.root = config.rootPath || 'flamecache';\n    this.ttl = config.ttl || 3600;\n    this.debug = config.debug || false;\n  }\n\n  private path(key: string): string {\n    return `${this.root}/${key}`;\n  }\n\n  private log(...args: any[]): void {\n    if (this.debug) console.log('[Flamecache]', ...args);\n  }\n\n  async get<T = any>(key: string): Promise<T | null> {\n    try {\n      const snapshot = await get(ref(this.db, this.path(key)));\n      if (!snapshot.exists()) {\n        this.log('miss:', key);\n        return null;\n      }\n\n      const entry: CacheEntry<T> = snapshot.val();\n      \n      if (entry.exp && Date.now() > entry.exp) {\n        this.log('expired:', key);\n        await this.del(key);\n        return null;\n      }\n\n      this.log('hit:', key);\n      return entry.data;\n    } catch (err) {\n      this.log('error get:', key, err);\n      return null;\n    }\n  }\n\n  async set<T = any>(key: string, data: T, ttl?: number): Promise<void> {\n    try {\n      const seconds = ttl !== undefined ? ttl : this.ttl;\n      const entry: CacheEntry<T> = {\n        data,\n        exp: seconds > 0 ? Date.now() + (seconds * 1000) : null\n      };\n      \n      await set(ref(this.db, this.path(key)), entry);\n      this.log('set:', key, `(${seconds}s)`);\n    } catch (err) {\n      this.log('error set:', key, err);\n      throw err;\n    }\n  }\n\n  async del(key: string): Promise<void> {\n    try {\n      await remove(ref(this.db, this.path(key)));\n      this.log('del:', key);\n    } catch (err) {\n      this.log('error del:', key, err);\n    }\n  }\n\n  async has(key: string): Promise<boolean> {\n    return (await this.get(key)) !== null;\n  }\n\n  async wrap<T = any>(\n    key: string,\n    fetchFn: () => Promise<T>,\n    ttl?: number\n  ): Promise<T> {\n    const cached = await this.get<T>(key);\n    if (cached !== null) return cached;\n\n    this.log('fetch:', key);\n    const data = await fetchFn();\n    await this.set(key, data, ttl);\n    return data;\n  }\n\n  async mget<T = any>(keys: string[]): Promise<(T | null)[]> {\n    return Promise.all(keys.map(k => this.get<T>(k)));\n  }\n\n  async mset(entries: Record<string, any>, ttl?: number): Promise<void> {\n    await Promise.all(\n      Object.entries(entries).map(([k, v]) => this.set(k, v, ttl))\n    );\n  }\n\n  async mdel(keys: string[]): Promise<void> {\n    await Promise.all(keys.map(k => this.del(k)));\n  }\n\n  async clear(): Promise<void> {\n    try {\n      await remove(ref(this.db, this.root));\n      this.log('cleared all');\n    } catch (err) {\n      this.log('error clear:', err);\n      throw err;\n    }\n  }\n\n  async disconnect(): Promise<void> {\n    await goOffline(this.db);\n    this.log('disconnected');\n  }\n\n  async touch(key: string, ttl?: number): Promise<boolean> {\n    const data = await this.get(key);\n    if (data === null) return false;\n    await this.set(key, data, ttl);\n    return true;\n  }\n\n  async pull<T = any>(key: string): Promise<T | null> {\n    const data = await this.get<T>(key);\n    if (data !== null) await this.del(key);\n    return data;\n  }\n\n  async incr(key: string, by: number = 1): Promise<number> {\n    const op = by >= 0 ? 'incr' : 'decr';\n    try {\n      const path = this.path(key);\n      const dbRef = ref(this.db, path);\n      \n      await update(dbRef, {\n        'data': increment(by),\n        'exp': this.ttl > 0 ? Date.now() + (this.ttl * 1000) : null\n      });\n\n      const newValue = await this.get<number>(key);\n      const sign = by >= 0 ? '+' : '';\n      this.log(`${op}:`, key, `${sign}${by} (atomic)`);\n      return newValue ?? 0;\n    } catch (err) {\n      this.log(`error ${op}:`, key, err);\n      throw err;\n    }\n  }\n\n  async decr(key: string, by: number = 1): Promise<number> {\n    return this.incr(key, -by);\n  }\n\n  async expire(key: string, ttl: number): Promise<boolean> {\n    try {\n      const snapshot = await get(ref(this.db, this.path(key)));\n      if (!snapshot.exists()) {\n        this.log('expire failed - key not found:', key);\n        return false;\n      }\n\n      const entry: CacheEntry<any> = snapshot.val();\n      entry.exp = ttl > 0 ? Date.now() + (ttl * 1000) : null;\n      \n      await set(ref(this.db, this.path(key)), entry);\n      this.log('expire:', key, `(${ttl}s)`);\n      return true;\n    } catch (err) {\n      this.log('error expire:', key, err);\n      return false;\n    }\n  }\n\n  async getTtl(key: string): Promise<number> {\n    try {\n      const snapshot = await get(ref(this.db, this.path(key)));\n      if (!snapshot.exists()) return 0;\n\n      const entry: CacheEntry<any> = snapshot.val();\n      \n      if (!entry.exp) return -1;\n      \n      const remaining = Math.max(0, Math.floor((entry.exp - Date.now()) / 1000));\n      return remaining;\n    } catch (err) {\n      this.log('error ttl:', key, err);\n      return 0;\n    }\n  }\n}\n\nexport function createCache(config: CacheConfig): FirebaseCache {\n  return new FirebaseCache(config);\n}\n"]}

package/package.json

@@ -0,0 +1,67 @@
+{
+  "name": "flamecache",
+  "version": "0.0.1",
+  "description": "Simple and robust caching layer using Firebase Realtime Database",
+  "main": "./dist/index.js",
+  "module": "./dist/index.mjs",
+  "types": "./dist/index.d.ts",
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "require": "./dist/index.js",
+      "import": "./dist/index.mjs"
+    }
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "test": "jest",
+    "test:watch": "jest --watch",
+    "prepublishOnly": "npm run build && npm test",
+    "lint": "eslint src",
+    "example": "tsx -r dotenv/config examples/runner.ts",
+    "format": "prettier --write \"src/**/*.ts\"",
+    "clean": "rm -rf dist",
+    "typecheck": "tsc --noEmit"
+  },
+  "keywords": [
+    "firebase",
+    "cache",
+    "caching",
+    "redis-like",
+    "realtime-database"
+  ],
+  "author": "Anish Roy",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/iamanishroy/flamecache.git"
+  },
+  "peerDependencies": {
+    "firebase": "^10.0.0 || ^11.0.0"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@types/jest": "^29.5.0",
+    "@types/node": "^20.0.0",
+    "@typescript-eslint/eslint-plugin": "^6.0.0",
+    "@typescript-eslint/parser": "^6.0.0",
+    "dotenv": "^17.2.3",
+    "eslint": "^8.0.0",
+    "firebase": "^10.0.0",
+    "jest": "^29.5.0",
+    "prettier": "^3.0.0",
+    "ts-jest": "^29.1.0",
+    "tsup": "^8.0.0",
+    "tsx": "^4.21.0",
+    "typescript": "^5.0.0"
+  },
+  "engines": {
+    "node": ">=16.0.0"
+  }
+}