universe-code 0.0.74 → 0.0.75

package/README.md

@@ -2,8 +2,4 @@ An opinionated npm package that enforces coding discipline by standardizing stru
 
 ## Documentation
 
-📦 IndexedDB Angular
-👉 [View Docs](https://github.com/connectwithfalco/universe-code/tree/main/dist/guide/angular/indexdb)
-
-📦 IndexedDB React
-👉 [View Docs](https://github.com/connectwithfalco/universe-code/tree/main/dist/guide/react/indexdb)
+👉 [View Docs](https://dev-universe-code.vercel.app)

package/package.json

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

package/dist/guide/angular/indexdb/README.md

@@ -1,253 +0,0 @@
-# 🌌 universe-code (Angular)
-
-A lightweight and powerful **IndexedDB utility for Angular** that helps you cache API data, manage offline storage, and reduce unnecessary network calls — with a clean and simple API that works in any Angular application.
-
----
-
-## ✨ Features
-
-- ⚡ Easy IndexedDB setup in Angular  
-- 🧠 Built-in API caching with expiry (TTL)  
-- 📦 Simple CRUD operations  
-- 🔁 Auto re-fetch when cache expires  
-- 🧱 Framework-agnostic core with Angular-friendly usage  
-- 🛠 Clean and developer-friendly API  
-
----
-
-## 📦 Installation
-
-Install the latest version using npm:
-
-```bash
-npm install universe-code@latest
-```
-
----
-
-## ⚙️ IndexedDB Setup (One Time Only)
-
-Configure IndexedDB once in your Angular app and reuse it everywhere via a shared Angular service.
-
----
-
-## 1️⃣ Create an Angular IndexedDB Service
-
-Create the following file:
-
-**📁 `src/app/services/app-idb.service.ts`**
-
-```ts
-import { Injectable } from '@angular/core';
-import { IdbService as CoreIdbService } from 'universe-code/indexdb';
-// If your bundler does not support subpath exports, use this instead:
-// import { IdbService as CoreIdbService } from 'universe-code/dist/indexdb/services/idbService.js';
-
-interface IdbConfig {
-  dbName: string;
-  version: number;
-  storeName: string;
-}
-
-// Centralized IndexedDB configuration for this Angular app
-const IDB_CONFIG: IdbConfig = {
-  dbName: 'db',
-  version: 1,
-  storeName: 'store',
-};
-
-@Injectable({ providedIn: 'root' })
-export class AppIdbService {
-  private readonly client = new CoreIdbService(IDB_CONFIG);
-
-  fetchWithCache<T>(
-    key: string,
-    ttlMs: number,
-    apiFn: () => Promise<T>
-  ): Promise<T | null> {
-    return this.client.getWithExpiry(key, ttlMs, apiFn);
-  }
-
-  get<T = any>(key: string): Promise<T | null> {
-    return this.client.get(key);
-  }
-
-  set(data: any): Promise<any> {
-    return this.client.put(data);
-  }
-
-  remove(key: string): Promise<any> {
-    return this.client.remove(key);
-  }
-
-  clear(): Promise<any> {
-    return this.client.clear();
-  }
-}
-```
-
-### ✅ What this service does
-
-- Creates a single `IdbService` instance for the entire app  
-- Centralizes database name, version, and store name  
-- Exposes clean methods usable in any component or service  
-
----
-
-## 2️⃣ Use the Service in Your Angular Component
-
-Example `AppComponent`:
-
-```ts
-import { Component, OnInit } from '@angular/core';
-import { AppIdbService } from './services/app-idb.service';
-import { ApiService } from './services/api.service';
-import { minutesToMs } from 'universe-code/core';
-
-@Component({
-  selector: 'app-root',
-  templateUrl: './app.component.html',
-  styleUrls: ['./app.component.css'],
-})
-export class AppComponent implements OnInit {
-  constructor(
-    private readonly api: ApiService,
-    private readonly idb: AppIdbService
-  ) {}
-
-  async ngOnInit(): Promise<void> {
-    try {
-      const data = await this.idb.fetchWithCache(
-        'allEventList',
-        minutesToMs(1),
-        () => this.api.getAllEvents()
-      );
-
-      console.log('All Events:', data);
-    } catch (error) {
-      console.error('Failed to load events:', error);
-    }
-  }
-}
-```
-
-### ✅ IndexedDB is now ready
-
-Once `AppIdbService` is created, no additional setup is required.  
-Simply inject it wherever IndexedDB access is needed.
-
----
-
-## 🔁 API Fetch + Cache with Expiry
-
-```ts
-import { minutesToMs } from 'universe-code/core';
-
-async function loadUserProfile(idb: AppIdbService) {
-  const user = await idb.fetchWithCache(
-    'user-profile',
-    minutesToMs(5),
-    async () => {
-      const res = await fetch('https://example.com/api/user');
-      const json = await res.json();
-      return json.data;
-    }
-  );
-
-  console.log('User profile:', user);
-}
-```
-
-### 🧠 How it works
-
-- Calls API only if data is missing or expired  
-- Stores response in IndexedDB with timestamp  
-- Returns cached data instantly within TTL  
-- Falls back to cached data if API fails  
-
----
-
-## 📥 Get Data from IndexedDB
-
-```ts
-const data = await this.idb.get('users');
-console.log(data);
-```
-
----
-
-## ✏️ Insert / Update Data
-
-> Default store `keyPath` is `id`
-
-```ts
-await this.idb.set({
-  id: 'users',
-  data: {
-    name: 'Mark',
-    country: 'USA',
-  },
-  timestamp: Date.now(),
-});
-```
-
----
-
-## 🗑️ Delete a Specific Record
-
-```ts
-await this.idb.remove('users');
-```
-
----
-
-## 🧹 Clear Entire IndexedDB Store
-
-```ts
-await this.idb.clear();
-```
-
----
-
-## 📚 API Reference (Angular Wrapper)
-
-### `AppIdbService`
-
-| Method | Signature | Description |
-|------|----------|-------------|
-| fetchWithCache | `(key, ttlMs, apiFn)` | Fetch & cache data with expiry |
-| get | `(key)` | Get record by key |
-| set | `(data)` | Insert or update record |
-| remove | `(key)` | Delete record |
-| clear | `()` | Clear store |
-
----
-
-## ⚙️ Core: `IdbService`
-
-Used internally from `universe-code/indexdb`:
-
-- `connect()`  
-- `get(key)`  
-- `put(data)`  
-- `remove(key)`  
-- `clear()`  
-- `getWithExpiry(key, ttl, apiFn)`  
-
-Can also be used outside Angular (JS / TS / other frameworks).
-
----
-
-## ✅ Ideal Use Cases
-
-- API response caching  
-- Offline-first Angular apps  
-- Performance optimization  
-- Local session & config storage  
-- Shared data across routes/components  
-
----
-
-## 🛡 License
-
-MIT License © **universe-code**

package/dist/guide/react/indexdb/README.md

@@ -1,198 +0,0 @@
-# 🌌 universe-code (React)
-
-A lightweight and powerful **IndexedDB utility for React** that helps you cache API data, manage offline storage, and reduce unnecessary network calls — all with a clean and simple API.
-
----
-
-## ✨ Features
-
-- ⚡ Easy IndexedDB setup
-- 🧠 Built-in API caching with expiry
-- 📦 Simple CRUD operations
-- 🔁 Auto re-fetch when cache expires
-- 💻 Works perfectly with React / Next.js
-- 🛠 Clean and developer-friendly API
-
----
-
-## 📦 Installation
-
-Install the latest version using npm:
-
-```bash
-npm install universe-code@latest
-```
----
-
-## ⚙️ IndexedDB Setup (One Time Only)
-
-You must configure IndexedDB once at the root level of your app.
-
----
-
-## 1️⃣ Create IndexedDB Provider
-
-Create the following file:
-
-📁 lib/provider/idb-provider.tsx
-
-```bash
-"use client";
-
-import { configureIdb } from "universe-code/react";
-
-export function IdbProvider() {
-  configureIdb({
-    dbName: "db",
-    dbVersion: 1,
-    storeName: "store",
-  });
-
-  return null;
-}
-```
-
----
-
-### 2️⃣ Register Provider in Root Layout
-
-Call the provider once so IndexedDB initializes globally.
-
-```bash
-import { IdbProvider } from "@/lib/provider/idb-provider";
-
-export default function RootLayout({
-  children,
-}: {
-  children: React.ReactNode;
-}) {
-  return (
-    <html lang="en">
-      <body>
-        <IdbProvider />
-        {children}
-      </body>
-    </html>
-  );
-}
-```
-
----
-
-## ✅ IndexedDB is now created and ready to use.
-
-🚀 Using IndexedDB in Components
-Import the Hook
-
-```bash
-import { useIdbStore } from "universe-code/react";
-```
-
-Initialize Store
-
-```bash
-const idbStore = useIdbStore();
-```
-
-All IndexedDB helper functions are now available inside idbStore.
-
----
-
-## 🔁 API Fetch + Cache with Expiry
-
-Fetch API data and automatically store it in IndexedDB with expiry control.
-
-```bash
-idbStore
-  .getWithExpiry("users", minutesToMs(1), async () => {
-    const res = await fetch("https://example.com/api/user", {
-      method: "GET",
-      headers: {
-        "Content-Type": "application/json",
-      },
-    });
-
-    const data = await res.json();
-    return data.data;
-  })
-  .then(console.log);
-```
-### Note:
-
-import minutesToMs() from universe-code/core
-
-```bash
-import { minutesToMs } from "universe-code/core";
-```
-
-### 🧠 How it works
-
-- Calls API only if data is missing or expired
-- Saves response in IndexedDB
-- Returns cached data instantly on next call
-
----
-
-## 📥 Get Data from IndexedDB
-```bash
-const data = await idbStore.get("users");
-console.log(data);
-```
-
----
-
-## ✏️ Insert / Update Data
-```bash
-idbStore.put({
-  id: "users",
-  data: {
-    name: "Mark",
-    country: "USA",
-  },
-  timestamp: Date.now(),
-});
-```
-
----
-
-### 🗑️ Delete a Specific Record
-
-```bash
-idbStore.remove("users");
-```
-
----
-
-## 🧹 Clear Entire IndexedDB Store
-
-```bash
-idbStore.clear();
-```
-
----
-
-### 📚 API Reference
-
-| Function | Description |
-|---------|------------|
-| `get(id)` | Retrieve data from IndexedDB |
-| `put(payload)` | Insert or update data |
-| `remove(id)` | Delete a record |
-| `clear()` | Clear all IndexedDB data |
-| `getWithExpiry(id, expiry, callback)` | Fetch and cache data with expiry |
-
----
-
-## ✅ Ideal Use Cases
-
-- API response caching
-- Offline-first applications
-- Performance optimization
-- Reducing repeated API calls
-- Storing session or user data
-
----
-
-## 🛡 License
-
-MIT License © universe-code