@knymbus/firestoredb 1.0.2

package/dist/cjs/ParallelPipe.d.ts

@@ -0,0 +1,22 @@
+/**
+ * PARALLEL TRANSFORM STREAM
+ * @example
+ * // 1. Stream data from Firestore
+const source = Products.find({ status: 'pending' }).stream();
+
+// 2. Process 50 items in parallel with 3 retries
+const processor = parallelPipe(50, 3, async (doc) => {
+    const apiData = await transformNetworkAction(doc); // Your slow O(n) task
+    return { ...doc, ...apiData, status: 'processed' };
+});
+
+// 3. Write back to Firestore
+const saver = new WritableStream({
+    async write(doc) { await Products.updateOne(doc._id, doc); }
+});
+
+// 4. Pipe through
+await source.pipeThrough(processor).pipeTo(saver);
+ */
+export declare const ParallelPipe: <TIn, TOut>(concurrency: number, retryCount: number, transformFn: (item: TIn) => Promise<TOut>) => TransformStream<TIn, TOut>;
+//# sourceMappingURL=ParallelPipe.d.ts.map

package/dist/cjs/ParallelPipe.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ParallelPipe.d.ts","sourceRoot":"","sources":["../../src/ParallelPipe.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,eAAO,MAAM,YAAY,GAAI,GAAG,EAAE,IAAI,EAClC,aAAa,MAAM,EACnB,YAAY,MAAM,EAClB,aAAa,CAAC,IAAI,EAAE,GAAG,KAAK,OAAO,CAAC,IAAI,CAAC,+BAsB5C,CAAC"}

package/dist/cjs/ParallelPipe.js

@@ -0,0 +1,63 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.ParallelPipe = void 0;
+/**
+ * PARALLEL TRANSFORM STREAM
+ * @example
+ * // 1. Stream data from Firestore
+const source = Products.find({ status: 'pending' }).stream();
+
+// 2. Process 50 items in parallel with 3 retries
+const processor = parallelPipe(50, 3, async (doc) => {
+    const apiData = await transformNetworkAction(doc); // Your slow O(n) task
+    return { ...doc, ...apiData, status: 'processed' };
+});
+
+// 3. Write back to Firestore
+const saver = new WritableStream({
+    async write(doc) { await Products.updateOne(doc._id, doc); }
+});
+
+// 4. Pipe through
+await source.pipeThrough(processor).pipeTo(saver);
+ */
+const ParallelPipe = (concurrency, retryCount, transformFn) => {
+    const inFlight = new Set();
+    const executeWithRetry = (item_1, ...args_1) => __awaiter(void 0, [item_1, ...args_1], void 0, function* (item, attempt = 0) {
+        try {
+            return yield transformFn(item);
+        }
+        catch (err) {
+            if (attempt < retryCount)
+                return yield executeWithRetry(item, attempt + 1);
+            throw err;
+        }
+    });
+    return new TransformStream({
+        transform(item, controller) {
+            return __awaiter(this, void 0, void 0, function* () {
+                const p = (() => __awaiter(this, void 0, void 0, function* () {
+                    const result = yield executeWithRetry(item);
+                    controller.enqueue(result);
+                }))();
+                inFlight.add(p);
+                p.finally(() => inFlight.delete(p));
+                if (inFlight.size >= concurrency)
+                    yield Promise.race(inFlight);
+            });
+        },
+        flush() {
+            return __awaiter(this, void 0, void 0, function* () { yield Promise.all(inFlight); });
+        }
+    });
+};
+exports.ParallelPipe = ParallelPipe;

package/dist/cjs/index.d.ts

@@ -0,0 +1,4 @@
+export * from './FirestoreDB';
+export * from './ParallelPipe';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA"}

package/dist/cjs/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./FirestoreDB"), exports);
+__exportStar(require("./ParallelPipe"), exports);
+__exportStar(require("./types"), exports);

package/dist/cjs/types.d.ts

@@ -0,0 +1,22 @@
+export type DocumentInput<T> = Partial<T> & {
+    _id?: string;
+};
+/**
+ * We allow keys from T, or any string (for nested dot-notation)
+ */
+export type QueryFilter<T> = {
+    [P in keyof T]?: any;
+} & Record<string, any>;
+export type UpdateDocument<T> = {
+    docId: string;
+    entity: Partial<T>;
+};
+type FirestoreDBDocument = {
+    _id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date;
+};
+export type WithSystemFields<T> = T & FirestoreDBDocument;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/cjs/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC5D;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAGxB,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACrB,CAAA;AAID,KAAK,mBAAmB,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,CAAC,EAAE,IAAI,CAAA;CACnB,CAAA;AAGD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC"}

package/dist/cjs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/cjs/utils/$Operators.d.ts

@@ -0,0 +1,4 @@
+import { WhereFilterOp } from "firebase/firestore";
+export type $OperatorSymbols = '$gt' | '$gte' | '$lt' | '$lte' | '$ne' | '$in' | '$nin';
+export declare const $OperatorMap: Record<$OperatorSymbols, WhereFilterOp>;
+//# sourceMappingURL=$Operators.d.ts.map

package/dist/cjs/utils/$Operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$Operators.d.ts","sourceRoot":"","sources":["../../../src/utils/$Operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AACvF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAQhE,CAAC"}

package/dist/cjs/utils/$Operators.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.$OperatorMap = void 0;
+exports.$OperatorMap = {
+    '$gt': '>',
+    '$gte': '>=',
+    '$lt': '<',
+    '$lte': '<=',
+    '$ne': '!=',
+    '$in': 'in',
+    '$nin': 'not-in'
+};

package/dist/cjs/utils/Hasher.d.ts

@@ -0,0 +1,11 @@
+export declare class Hasher {
+    /**
+     * Generates a short, consistent hash from any object or string.
+     */
+    static hash(input: any): string;
+    /**
+     * Generates a specific cache key for a collection.
+     */
+    static generateCacheKey(collectionName: string, queryParams: object): string;
+}
+//# sourceMappingURL=Hasher.d.ts.map

package/dist/cjs/utils/Hasher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hasher.d.ts","sourceRoot":"","sources":["../../../src/utils/Hasher.ts"],"names":[],"mappings":"AAAA,qBAAa,MAAM;IACf;;OAEG;WACW,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAetC;;OAEG;WACW,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;CAItF"}

package/dist/cjs/utils/Hasher.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Hasher = void 0;
+class Hasher {
+    /**
+     * Generates a short, consistent hash from any object or string.
+     */
+    static hash(input) {
+        const str = typeof input === 'string' ? input : JSON.stringify(input);
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            // High-performance bitwise hashing
+            hash = (hash << 5) - hash + char;
+            hash |= 0; // Convert to 32-bit integer
+        }
+        // Return as an unsigned base36 string (short and URL-friendly)
+        return (hash >>> 0).toString(36);
+    }
+    /**
+     * Generates a specific cache key for a collection.
+     */
+    static generateCacheKey(collectionName, queryParams) {
+        const hash = this.hash(queryParams);
+        return `${collectionName}_${hash}`;
+    }
+}
+exports.Hasher = Hasher;

package/dist/cjs/utils/LRUCache.d.ts

@@ -0,0 +1,13 @@
+export declare class LRUCache {
+    private cache;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    get(key: string): {
+        data: any;
+        timestamp: number;
+    } | null;
+    set(key: string, value: any): void;
+    delete(key: string): void;
+    keys(): MapIterator<string>;
+}
+//# sourceMappingURL=LRUCache.d.ts.map

package/dist/cjs/utils/LRUCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LRUCache.d.ts","sourceRoot":"","sources":["../../../src/utils/LRUCache.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;IACjB,OAAO,CAAC,KAAK,CAAuD;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,SAAM;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM;cAPyB,GAAG;mBAAa,MAAM;;IAiB9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAgB3B,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,IAAI;CAGP"}

package/dist/cjs/utils/LRUCache.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LRUCache = void 0;
+class LRUCache {
+    constructor(maxSize = 100) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const item = this.cache.get(key);
+        if (!item)
+            return null;
+        // "Refresh" the item: delete and re-insert to move it to the end (most recent)
+        this.cache.delete(key);
+        this.cache.set(key, item);
+        return item;
+    }
+    set(key, value) {
+        // If key exists, delete first to update its position
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxSize) {
+            // EVICT: Remove the very first item (the least recently used)
+            const firstKey = this.cache.keys().next();
+            if (!firstKey.done) {
+                this.cache.delete(firstKey.value);
+            }
+        }
+        this.cache.set(key, { data: value, timestamp: Date.now() });
+    }
+    delete(key) {
+        this.cache.delete(key);
+    }
+    keys() {
+        return this.cache.keys();
+    }
+}
+exports.LRUCache = LRUCache;

package/dist/cjs/utils/hydrateDates.d.ts

@@ -0,0 +1,6 @@
+/**
+* RECURSIVE DATE HYDRATION HELPER
+* Deeply scans an object and converts any Firestore Timestamps to JS Dates.
+*/
+export declare const hydrateDates: (data: any) => Record<string, any>;
+//# sourceMappingURL=hydrateDates.d.ts.map

package/dist/cjs/utils/hydrateDates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateDates.d.ts","sourceRoot":"","sources":["../../../src/utils/hydrateDates.ts"],"names":[],"mappings":"AACA;;;EAGE;AACF,eAAO,MAAM,YAAY,GAAI,MAAM,GAAG,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAoB1D,CAAA"}

package/dist/cjs/utils/hydrateDates.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hydrateDates = void 0;
+/**
+* RECURSIVE DATE HYDRATION HELPER
+* Deeply scans an object and converts any Firestore Timestamps to JS Dates.
+*/
+const hydrateDates = (data) => {
+    if (!data || typeof data !== 'object')
+        return data;
+    if (typeof data !== 'object')
+        return data;
+    // 1. Handle Arrays
+    if (Array.isArray(data)) {
+        return data.map(item => (0, exports.hydrateDates)(item));
+    }
+    // 2. Check if the object is a Firestore Timestamp
+    // Standard Firestore Timestamps have a .toDate() method
+    if (typeof data.toDate === 'function') {
+        return data.toDate();
+    }
+    // 3. Handle Nested Objects
+    const hydrated = {};
+    for (const [key, value] of Object.entries(data)) {
+        hydrated[key] = (0, exports.hydrateDates)(value);
+    }
+    return hydrated;
+};
+exports.hydrateDates = hydrateDates;

package/dist/cjs/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './hydrateDates';
+export * from './Hasher';
+export * from './LRUCache';
+export * from './$Operators';
+//# sourceMappingURL=index.d.ts.map

package/dist/cjs/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/dist/cjs/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./hydrateDates"), exports);
+__exportStar(require("./Hasher"), exports);
+__exportStar(require("./LRUCache"), exports);
+__exportStar(require("./$Operators"), exports);

package/dist/index.d.ts

@@ -0,0 +1,4 @@
+export * from './FirestoreDB';
+export * from './ParallelPipe';
+export * from './types';
+//# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,cAAc,eAAe,CAAC;AAC9B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,SAAS,CAAA"}

package/dist/index.js

@@ -0,0 +1,19 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./FirestoreDB"), exports);
+__exportStar(require("./ParallelPipe"), exports);
+__exportStar(require("./types"), exports);

package/dist/types.d.ts

@@ -0,0 +1,22 @@
+export type DocumentInput<T> = Partial<T> & {
+    _id?: string;
+};
+/**
+ * We allow keys from T, or any string (for nested dot-notation)
+ */
+export type QueryFilter<T> = {
+    [P in keyof T]?: any;
+} & Record<string, any>;
+export type UpdateDocument<T> = {
+    docId: string;
+    entity: Partial<T>;
+};
+type FirestoreDBDocument = {
+    _id: string;
+    createdAt: Date;
+    updatedAt: Date;
+    deletedAt?: Date;
+};
+export type WithSystemFields<T> = T & FirestoreDBDocument;
+export {};
+//# sourceMappingURL=types.d.ts.map

package/dist/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../src/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,aAAa,CAAC,CAAC,IAAI,OAAO,CAAC,CAAC,CAAC,GAAG;IAAE,GAAG,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAC5D;;GAEG;AACH,MAAM,MAAM,WAAW,CAAC,CAAC,IAAI;KACxB,CAAC,IAAI,MAAM,CAAC,CAAC,CAAC,EAAE,GAAG;CACvB,GAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAAC,CAAC;AAGxB,MAAM,MAAM,cAAc,CAAC,CAAC,IAAI;IAC5B,KAAK,EAAE,MAAM,CAAA;IACb,MAAM,EAAE,OAAO,CAAC,CAAC,CAAC,CAAA;CACrB,CAAA;AAID,KAAK,mBAAmB,GAAG;IACvB,GAAG,EAAE,MAAM,CAAC;IACZ,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,EAAE,IAAI,CAAA;IACf,SAAS,CAAC,EAAE,IAAI,CAAA;CACnB,CAAA;AAGD,MAAM,MAAM,gBAAgB,CAAC,CAAC,IAAI,CAAC,GAAG,mBAAmB,CAAC"}

package/dist/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/utils/$Operators.d.ts

@@ -0,0 +1,4 @@
+import { WhereFilterOp } from "firebase/firestore";
+export type $OperatorSymbols = '$gt' | '$gte' | '$lt' | '$lte' | '$ne' | '$in' | '$nin';
+export declare const $OperatorMap: Record<$OperatorSymbols, WhereFilterOp>;
+//# sourceMappingURL=$Operators.d.ts.map

package/dist/utils/$Operators.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"$Operators.d.ts","sourceRoot":"","sources":["../../src/utils/$Operators.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,aAAa,EAAE,MAAM,oBAAoB,CAAC;AAEnD,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,CAAA;AACvF,eAAO,MAAM,YAAY,EAAE,MAAM,CAAC,gBAAgB,EAAE,aAAa,CAQhE,CAAC"}

package/dist/utils/$Operators.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.$OperatorMap = void 0;
+exports.$OperatorMap = {
+    '$gt': '>',
+    '$gte': '>=',
+    '$lt': '<',
+    '$lte': '<=',
+    '$ne': '!=',
+    '$in': 'in',
+    '$nin': 'not-in'
+};

package/dist/utils/Hasher.d.ts

@@ -0,0 +1,11 @@
+export declare class Hasher {
+    /**
+     * Generates a short, consistent hash from any object or string.
+     */
+    static hash(input: any): string;
+    /**
+     * Generates a specific cache key for a collection.
+     */
+    static generateCacheKey(collectionName: string, queryParams: object): string;
+}
+//# sourceMappingURL=Hasher.d.ts.map

package/dist/utils/Hasher.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"Hasher.d.ts","sourceRoot":"","sources":["../../src/utils/Hasher.ts"],"names":[],"mappings":"AAAA,qBAAa,MAAM;IACf;;OAEG;WACW,IAAI,CAAC,KAAK,EAAE,GAAG,GAAG,MAAM;IAetC;;OAEG;WACW,gBAAgB,CAAC,cAAc,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,MAAM;CAItF"}

package/dist/utils/Hasher.js

@@ -0,0 +1,28 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Hasher = void 0;
+class Hasher {
+    /**
+     * Generates a short, consistent hash from any object or string.
+     */
+    static hash(input) {
+        const str = typeof input === 'string' ? input : JSON.stringify(input);
+        let hash = 0;
+        for (let i = 0; i < str.length; i++) {
+            const char = str.charCodeAt(i);
+            // High-performance bitwise hashing
+            hash = (hash << 5) - hash + char;
+            hash |= 0; // Convert to 32-bit integer
+        }
+        // Return as an unsigned base36 string (short and URL-friendly)
+        return (hash >>> 0).toString(36);
+    }
+    /**
+     * Generates a specific cache key for a collection.
+     */
+    static generateCacheKey(collectionName, queryParams) {
+        const hash = this.hash(queryParams);
+        return `${collectionName}_${hash}`;
+    }
+}
+exports.Hasher = Hasher;

package/dist/utils/LRUCache.d.ts

@@ -0,0 +1,13 @@
+export declare class LRUCache {
+    private cache;
+    private readonly maxSize;
+    constructor(maxSize?: number);
+    get(key: string): {
+        data: any;
+        timestamp: number;
+    } | null;
+    set(key: string, value: any): void;
+    delete(key: string): void;
+    keys(): MapIterator<string>;
+}
+//# sourceMappingURL=LRUCache.d.ts.map

package/dist/utils/LRUCache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"LRUCache.d.ts","sourceRoot":"","sources":["../../src/utils/LRUCache.ts"],"names":[],"mappings":"AAAA,qBAAa,QAAQ;IACjB,OAAO,CAAC,KAAK,CAAuD;IACpE,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAS;gBAErB,OAAO,SAAM;IAIzB,GAAG,CAAC,GAAG,EAAE,MAAM;cAPyB,GAAG;mBAAa,MAAM;;IAiB9D,GAAG,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,GAAG;IAgB3B,MAAM,CAAC,GAAG,EAAE,MAAM;IAIlB,IAAI;CAGP"}

package/dist/utils/LRUCache.js

@@ -0,0 +1,39 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.LRUCache = void 0;
+class LRUCache {
+    constructor(maxSize = 100) {
+        this.cache = new Map();
+        this.maxSize = maxSize;
+    }
+    get(key) {
+        const item = this.cache.get(key);
+        if (!item)
+            return null;
+        // "Refresh" the item: delete and re-insert to move it to the end (most recent)
+        this.cache.delete(key);
+        this.cache.set(key, item);
+        return item;
+    }
+    set(key, value) {
+        // If key exists, delete first to update its position
+        if (this.cache.has(key)) {
+            this.cache.delete(key);
+        }
+        else if (this.cache.size >= this.maxSize) {
+            // EVICT: Remove the very first item (the least recently used)
+            const firstKey = this.cache.keys().next();
+            if (!firstKey.done) {
+                this.cache.delete(firstKey.value);
+            }
+        }
+        this.cache.set(key, { data: value, timestamp: Date.now() });
+    }
+    delete(key) {
+        this.cache.delete(key);
+    }
+    keys() {
+        return this.cache.keys();
+    }
+}
+exports.LRUCache = LRUCache;

package/dist/utils/hydrateDates.d.ts

@@ -0,0 +1,6 @@
+/**
+* RECURSIVE DATE HYDRATION HELPER
+* Deeply scans an object and converts any Firestore Timestamps to JS Dates.
+*/
+export declare const hydrateDates: (data: any) => Record<string, any>;
+//# sourceMappingURL=hydrateDates.d.ts.map

package/dist/utils/hydrateDates.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hydrateDates.d.ts","sourceRoot":"","sources":["../../src/utils/hydrateDates.ts"],"names":[],"mappings":"AACA;;;EAGE;AACF,eAAO,MAAM,YAAY,GAAI,MAAM,GAAG,KAAG,MAAM,CAAC,MAAM,EAAE,GAAG,CAoB1D,CAAA"}

package/dist/utils/hydrateDates.js

@@ -0,0 +1,29 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.hydrateDates = void 0;
+/**
+* RECURSIVE DATE HYDRATION HELPER
+* Deeply scans an object and converts any Firestore Timestamps to JS Dates.
+*/
+const hydrateDates = (data) => {
+    if (!data || typeof data !== 'object')
+        return data;
+    if (typeof data !== 'object')
+        return data;
+    // 1. Handle Arrays
+    if (Array.isArray(data)) {
+        return data.map(item => (0, exports.hydrateDates)(item));
+    }
+    // 2. Check if the object is a Firestore Timestamp
+    // Standard Firestore Timestamps have a .toDate() method
+    if (typeof data.toDate === 'function') {
+        return data.toDate();
+    }
+    // 3. Handle Nested Objects
+    const hydrated = {};
+    for (const [key, value] of Object.entries(data)) {
+        hydrated[key] = (0, exports.hydrateDates)(value);
+    }
+    return hydrated;
+};
+exports.hydrateDates = hydrateDates;

package/dist/utils/index.d.ts

@@ -0,0 +1,5 @@
+export * from './hydrateDates';
+export * from './Hasher';
+export * from './LRUCache';
+export * from './$Operators';
+//# sourceMappingURL=index.d.ts.map

package/dist/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/utils/index.ts"],"names":[],"mappings":"AAAA,cAAc,gBAAgB,CAAA;AAC9B,cAAc,UAAU,CAAA;AACxB,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA"}

package/dist/utils/index.js

@@ -0,0 +1,20 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+__exportStar(require("./hydrateDates"), exports);
+__exportStar(require("./Hasher"), exports);
+__exportStar(require("./LRUCache"), exports);
+__exportStar(require("./$Operators"), exports);