universe-code 0.0.15 → 0.0.17

package/README.md

@@ -1 +1,9 @@
-An opinionated npm package that enforces coding discipline by standardizing structure, patterns, and optimized best practices across all projects.
+An opinionated npm package that enforces coding discipline by standardizing structure, patterns, and optimized best practices across all projects.
+
+## Documentation
+
+📦 IndexedDB Angular
+👉 [View Docs](https://github.com/connectwithfalco/universe-code/tree/main/doc/angular/indexdb)
+
+📦 IndexedDB React
+👉 [View Docs](https://github.com/connectwithfalco/universe-code/tree/main/doc/react/indexdb)

package/dist/indexdb/db.js

@@ -11,9 +11,8 @@ export class DBManager {
     return new Promise((resolve, reject) => {
       const request = indexedDB.open(this.dbName, this.version);
 
-      request.onupgradeneeded = ({ target }) => {
-        const db = target.result;
-
+      request.onupgradeneeded = (e) => {
+        const db = e.target.result;
         stores.forEach(({ name, keyPath = "id", autoIncrement = false }) => {
           if (!db.objectStoreNames.contains(name)) {
             db.createObjectStore(name, { keyPath, autoIncrement });
@@ -25,7 +24,6 @@ export class DBManager {
         this.db = request.result;
         resolve(this.db);
       };
-
       request.onerror = () => reject(request.error);
     });
   }

package/dist/indexdb/index.js

@@ -1,2 +1,11 @@
-export { DBManager } from "./db.js";
-export { Store } from "./store.js";
+import { DBManager } from './db.js';
+import { DB } from './store.js';
+
+// Export everything as a unified object or individual pieces
+export { DBManager, DB };
+
+// Default export for easy usage
+export default {
+  DBManager,
+  ...DB
+};

package/dist/indexdb/store.js

@@ -1,6 +1,8 @@
-// Single internal helper (never repeated)
-const perform = (db, storeName, mode, action) =>
-  new Promise((resolve, reject) => {
+/**
+ * Generic Transaction Wrapper
+ */
+const perform = (db, storeName, mode, action) => {
+  return new Promise((resolve, reject) => {
     const tx = db.transaction(storeName, mode);
     const store = tx.objectStore(storeName);
     const request = action(store);
@@ -8,55 +10,46 @@ const perform = (db, storeName, mode, action) =>
     request.onsuccess = () => resolve(request.result);
     request.onerror = () => reject(request.error);
   });
+};
 
-export class Store {
-  constructor(db, storeName) {
-    this.db = db;
-    this.storeName = storeName;
-  }
+export const DB = {
+  get: (db, store, key) => perform(db, store, "readonly", s => s.get(key)),
 
-  get(key) {
-    return perform(this.db, this.storeName, "readonly", s => s.get(key));
-  }
+  put: (db, store, data) => perform(db, store, "readwrite", s => s.put(data)),
 
-  put(data) {
-    return perform(this.db, this.storeName, "readwrite", s => s.put(data));
-  }
+  remove: (db, store, key) => perform(db, store, "readwrite", s => s.delete(key)),
 
-  remove(key) {
-    return perform(this.db, this.storeName, "readwrite", s => s.delete(key));
-  }
-
-  clear() {
-    return perform(this.db, this.storeName, "readwrite", s => s.clear());
-  }
+  clear: (db, store) => perform(db, store, "readwrite", s => s.clear()),
 
   /**
-   * Smart Fetch with TTL caching
+   * PRO FEATURE: getWithExpiry
+   * Automatically refreshes data from an API if the local version is too old.
    */
-  async fetch(key, ttl, apiCall) {
-    const now = Date.now();
-
+  async getWithExpiry(db, storeName, key, ttl, apiCall) {
     try {
-      const cached = await this.get(key);
+      const cached = await this.get(db, storeName, key);
+      const now = Date.now();
 
-      if (cached?.timestamp && now - cached.timestamp < ttl) {
+      // If valid data exists and is NOT expired, return it
+      if (cached && cached.timestamp && (now - cached.timestamp < ttl)) {
         return cached.data;
       }
 
-      const data = await apiCall();
+      // Otherwise, call API
+      const freshData = await apiCall();
 
-      await this.put({
+      // Save to IndexedDB with new timestamp
+      await this.put(db, storeName, {
         id: key,
-        data,
+        data: freshData,
         timestamp: now
       });
 
-      return data;
-    } catch (err) {
-      console.warn("IndexedDB fallback used:", err);
-      const fallback = await this.get(key);
-      return fallback?.data ?? null;
+      return freshData;
+    } catch (error) {
+      console.warn("API/DB Error, returning fallback if available:", error);
+      const fallback = await this.get(db, storeName, key);
+      return fallback ? fallback.data : null;
     }
   }
-}
+};

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "universe-code",
-  "version": "0.0.15",
+  "version": "0.0.17",
   "description": "Universal utility functions for all JS frameworks",
   "license": "ISC",
   "type": "module",