strata-storage 1.5.0 → 2.0.0

package/dist/core/Strata.js

@@ -2,13 +2,13 @@
  * Strata Storage - Main entry point
  * Zero-dependency universal storage solution
  */
-import { AdapterRegistry } from './AdapterRegistry';
-import { isBrowser, isNode, isCapacitor } from '@/utils';
-import { StorageError, EncryptionError } from '@/utils/errors';
-import { EncryptionManager } from '@/features/encryption';
-import { CompressionManager } from '@/features/compression';
-import { SyncManager } from '@/features/sync';
-import { TTLManager } from '@/features/ttl';
+import { AdapterRegistry } from "./AdapterRegistry.js";
+import { isBrowser, isNode } from "../utils/index.js";
+import { StorageError, EncryptionError } from "../utils/errors.js";
+import { EncryptionManager } from "../features/encryption.js";
+import { CompressionManager } from "../features/compression.js";
+import { SyncManager } from "../features/sync.js";
+import { TTLManager } from "../features/ttl.js";
 /**
  * Main Strata class - unified storage interface
  */
@@ -17,22 +17,35 @@ export class Strata {
     registry;
     defaultAdapter;
     adapters = new Map();
-    platform;
+    _platform;
     encryptionManager;
     compressionManager;
     syncManager;
     ttlManager;
+    _initialized = false;
     constructor(config = {}) {
         this.config = this.normalizeConfig(config);
-        this.platform = this.detectPlatform();
+        this._platform = this.detectPlatform();
         this.registry = new AdapterRegistry();
     }
+    /**
+     * Check if Strata has been initialized
+     */
+    get isInitialized() {
+        return this._initialized;
+    }
+    /**
+     * Get the detected platform
+     */
+    get platform() {
+        return this._platform;
+    }
     /**
      * Initialize Strata with available adapters
      */
     async initialize() {
-        // Register all adapters based on platform
-        await this.registerAdapters();
+        // No automatic adapter registration - adapters should be registered before initialize()
+        // This allows for zero-dependency operation and explicit opt-in for features
         // Find and set default adapter
         await this.selectDefaultAdapter();
         // Initialize configured adapters
@@ -64,6 +77,8 @@ export class Strata {
         if (this.defaultAdapter && this.config.ttl?.autoCleanup !== false) {
             this.ttlManager.startAutoCleanup(() => this.defaultAdapter.keys(), (key) => this.defaultAdapter.get(key), (key) => this.defaultAdapter.remove(key));
         }
+        // Mark as initialized
+        this._initialized = true;
     }
     /**
      * Get a value from storage
@@ -429,6 +444,26 @@ export class Strata {
         const expired = await this.ttlManager.cleanup(() => adapter.keys(), (key) => adapter.get(key), (key) => adapter.remove(key));
         return expired.length;
     }
+    /**
+     * Register a custom storage adapter
+     * This allows external adapters to be registered after initialization
+     *
+     * @example
+     * ```typescript
+     * import { MyCustomAdapter } from "./my-adapter.js";
+     * storage.registerAdapter(new MyCustomAdapter());
+     * ```
+     */
+    registerAdapter(adapter) {
+        this.registry.register(adapter);
+    }
+    /**
+     * Get the adapter registry (for advanced use cases)
+     * @internal
+     */
+    getRegistry() {
+        return this.registry;
+    }
     /**
      * Close all adapters
      */
@@ -456,13 +491,11 @@ export class Strata {
     normalizeConfig(config) {
         return {
             platform: config.platform || this.detectPlatform(),
-            defaultStorages: config.defaultStorages || this.getDefaultStorages(),
+            defaultStorages: config.defaultStorages || ['memory'], // Default to memory adapter
             ...config,
         };
     }
     detectPlatform() {
-        if (isCapacitor())
-            return 'web'; // Capacitor runs in web context
         if (isBrowser())
             return 'web';
         if (isNode())
@@ -470,50 +503,16 @@ export class Strata {
         return 'web'; // Default to web
     }
     getDefaultStorages() {
-        switch (this.platform) {
-            case 'web':
-                if (isCapacitor()) {
-                    return ['preferences', 'sqlite', 'indexedDB', 'localStorage', 'memory'];
-                }
-                return ['indexedDB', 'localStorage', 'memory'];
-            case 'node':
-                return ['filesystem', 'memory'];
-            case 'ios':
-            case 'android':
-                return ['preferences', 'sqlite', 'secure', 'memory'];
-            default:
-                return ['memory'];
-        }
-    }
-    async registerAdapters() {
-        // Register adapters based on platform
-        if (this.platform === 'web') {
-            // Dynamically import and register web adapters
-            const { MemoryAdapter } = await import('@/adapters/web/MemoryAdapter');
-            const { LocalStorageAdapter } = await import('@/adapters/web/LocalStorageAdapter');
-            const { SessionStorageAdapter } = await import('@/adapters/web/SessionStorageAdapter');
-            const { IndexedDBAdapter } = await import('@/adapters/web/IndexedDBAdapter');
-            const { CookieAdapter } = await import('@/adapters/web/CookieAdapter');
-            const { CacheAdapter } = await import('@/adapters/web/CacheAdapter');
-            this.registry.register(new MemoryAdapter());
-            this.registry.register(new LocalStorageAdapter());
-            this.registry.register(new SessionStorageAdapter());
-            this.registry.register(new IndexedDBAdapter());
-            this.registry.register(new CookieAdapter());
-            this.registry.register(new CacheAdapter());
-            // If running in Capacitor, also register native adapters
-            if (isCapacitor()) {
-                const { PreferencesAdapter } = await import('@/adapters/capacitor/PreferencesAdapter');
-                const { SqliteAdapter } = await import('@/adapters/capacitor/SqliteAdapter');
-                const { SecureAdapter } = await import('@/adapters/capacitor/SecureAdapter');
-                const { FilesystemAdapter } = await import('@/adapters/capacitor/FilesystemAdapter');
-                this.registry.register(new PreferencesAdapter());
-                this.registry.register(new SqliteAdapter());
-                this.registry.register(new SecureAdapter());
-                this.registry.register(new FilesystemAdapter());
-            }
-        }
-        // Additional adapters will be registered as they are implemented
+        // Only return adapters that are actually registered
+        const registered = Array.from(this.registry.getAll().keys()).map((key) => String(key));
+        // Prefer these storages in order if available
+        const preferredOrder = ['indexedDB', 'localStorage', 'sessionStorage', 'memory'];
+        const available = preferredOrder.filter((storage) => registered.includes(storage));
+        // Always include memory as fallback if registered
+        if (available.length === 0 && registered.includes('memory')) {
+            return ['memory'];
+        }
+        return (available.length > 0 ? available : registered);
     }
     async selectDefaultAdapter() {
         const storages = this.config.defaultStorages || this.getDefaultStorages();

package/dist/features/compression/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../compression';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/compression/index.d.ts.map

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

package/dist/features/compression/index.js

@@ -0,0 +1 @@
+export * from "../compression.js";

package/dist/features/compression.js

@@ -2,7 +2,7 @@
  * Compression Feature - Pure JavaScript LZ-string implementation
  * Zero-dependency compression/decompression for storage values
  */
-import { CompressionError } from '@/utils/errors';
+import { CompressionError } from "../utils/errors.js";
 /**
  * Compression manager using pure JavaScript LZ-string algorithm
  */

package/dist/features/encryption/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../encryption';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/encryption/index.d.ts.map

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

package/dist/features/encryption/index.js

@@ -0,0 +1 @@
+export * from "../encryption.js";

package/dist/features/encryption.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/features/encryption.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAqC;gBAEzC,MAAM,GAAE,gBAAqB;IASzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IAyCtE;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiCtF;;OAEG;YACW,SAAS;IA0CvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,gBAAgB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;IAc7C;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU1C"}
+{"version":3,"file":"encryption.d.ts","sourceRoot":"","sources":["../../src/features/encryption.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAIH;;GAEG;AACH,MAAM,WAAW,gBAAgB;IAC/B,SAAS,CAAC,EAAE,SAAS,GAAG,SAAS,CAAC;IAClC,SAAS,CAAC,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;IAC5B,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,UAAU,CAAC,EAAE,MAAM,CAAC;CACrB;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAC;IACb,IAAI,EAAE,MAAM,CAAC;IACb,EAAE,EAAE,MAAM,CAAC;IACX,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED;;GAEG;AACH,qBAAa,iBAAiB;IAC5B,OAAO,CAAC,MAAM,CAA6B;IAC3C,OAAO,CAAC,QAAQ,CAAqC;gBAEzC,MAAM,GAAE,gBAAqB;IASzC;;OAEG;IACH,WAAW,IAAI,OAAO;IAItB;;OAEG;IACG,OAAO,CAAC,IAAI,EAAE,OAAO,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC;IA6CtE;;OAEG;IACG,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,CAAC,CAAC;IAiCtF;;OAEG;YACW,SAAS;IA8CvB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,OAAO,CAAC,cAAc;IAStB;;OAEG;IACH,UAAU,IAAI,IAAI;IAIlB;;OAEG;IACH,gBAAgB,CAAC,MAAM,GAAE,MAAW,GAAG,MAAM;IAc7C;;OAEG;IACG,IAAI,CAAC,IAAI,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;CAU1C"}

package/dist/features/encryption.js

@@ -2,7 +2,7 @@
  * Encryption Feature - Web Crypto API implementation
  * Zero-dependency encryption/decryption for storage values
  */
-import { EncryptionError } from '@/utils/errors';
+import { EncryptionError } from "../utils/errors.js";
 /**
  * Encryption manager using Web Crypto API
  */
@@ -48,8 +48,8 @@ export class EncryptionManager {
             // Convert to base64 for storage
             return {
                 data: this.bufferToBase64(encryptedBuffer),
-                salt: this.bufferToBase64(salt),
-                iv: this.bufferToBase64(iv),
+                salt: this.bufferToBase64(salt.buffer.slice(salt.byteOffset, salt.byteOffset + salt.byteLength)),
+                iv: this.bufferToBase64(iv.buffer.slice(iv.byteOffset, iv.byteOffset + iv.byteLength)),
                 algorithm: this.config.algorithm,
                 iterations: this.config.iterations,
             };
@@ -91,7 +91,8 @@ export class EncryptionManager {
      */
     async deriveKey(password, salt, iterations = this.config.iterations) {
         // Check cache
-        const cacheKey = `${password}-${this.bufferToBase64(salt)}-${iterations}`;
+        const saltBuffer = salt.buffer.slice(salt.byteOffset, salt.byteOffset + salt.byteLength);
+        const cacheKey = `${password}-${this.bufferToBase64(saltBuffer)}-${iterations}`;
         if (this.keyCache.has(cacheKey)) {
             return this.keyCache.get(cacheKey);
         }
@@ -105,7 +106,7 @@ export class EncryptionManager {
         // Derive key using PBKDF2
         const key = await crypto.subtle.deriveKey({
             name: 'PBKDF2',
-            salt: salt,
+            salt: saltBuffer,
             iterations: iterations,
             hash: 'SHA-256',
         }, keyMaterial, {

package/dist/features/observer/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../observer';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/observer/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/observer/index.ts"],"names":[],"mappings":"AAAA,cAAc,aAAa,CAAC"}

package/dist/features/observer/index.js

@@ -0,0 +1 @@
+export * from "../observer.js";

package/dist/features/observer.d.ts

@@ -0,0 +1,20 @@
+/**
+ * Storage Observer - Watch for storage changes
+ */
+import type { ObserverCallback, StorageEvent } from '@/types';
+export declare class StorageObserver {
+    private observers;
+    /**
+     * Subscribe to storage events
+     */
+    subscribe(callback: ObserverCallback): () => void;
+    /**
+     * Emit a storage event
+     */
+    emit(event: StorageEvent): void;
+    /**
+     * Clear all observers
+     */
+    clear(): void;
+}
+//# sourceMappingURL=observer.d.ts.map

package/dist/features/observer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"observer.d.ts","sourceRoot":"","sources":["../../src/features/observer.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,OAAO,KAAK,EAAE,gBAAgB,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE9D,qBAAa,eAAe;IAC1B,OAAO,CAAC,SAAS,CAAoC;IAErD;;OAEG;IACH,SAAS,CAAC,QAAQ,EAAE,gBAAgB,GAAG,MAAM,IAAI;IAKjD;;OAEG;IACH,IAAI,CAAC,KAAK,EAAE,YAAY,GAAG,IAAI;IAU/B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd"}

package/dist/features/observer.js

@@ -0,0 +1,32 @@
+/**
+ * Storage Observer - Watch for storage changes
+ */
+export class StorageObserver {
+    observers = new Set();
+    /**
+     * Subscribe to storage events
+     */
+    subscribe(callback) {
+        this.observers.add(callback);
+        return () => this.observers.delete(callback);
+    }
+    /**
+     * Emit a storage event
+     */
+    emit(event) {
+        this.observers.forEach((callback) => {
+            try {
+                callback(event);
+            }
+            catch (error) {
+                console.error('Error in storage observer:', error);
+            }
+        });
+    }
+    /**
+     * Clear all observers
+     */
+    clear() {
+        this.observers.clear();
+    }
+}

package/dist/features/query/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../query';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/query/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/query/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC"}

package/dist/features/query/index.js

@@ -0,0 +1 @@
+export * from "../query.js";

package/dist/features/query.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/features/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO;IAwB3D;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,eAAe;IAqDvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,MAAM;IA+Bd;;OAEG;IACH,OAAO,CAAC,OAAO;IAyBf;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;IAoBxD;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA2B5E;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAc1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}
+{"version":3,"file":"query.d.ts","sourceRoot":"","sources":["../../src/features/query.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,cAAc,EAAkB,MAAM,SAAS,CAAC;AAE9D;;GAEG;AACH,qBAAa,WAAW;IACtB;;OAEG;IACH,OAAO,CAAC,KAAK,EAAE,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO;IAwB3D;;OAEG;IACH,OAAO,CAAC,YAAY;IAIpB;;OAEG;IACH,OAAO,CAAC,gBAAgB;IASxB;;OAEG;IACH,OAAO,CAAC,eAAe;IA2DvB;;OAEG;IACH,OAAO,CAAC,aAAa;IAkBrB;;OAEG;IACH,OAAO,CAAC,cAAc;IAmBtB;;OAEG;IACH,OAAO,CAAC,MAAM;IA+Bd;;OAEG;IACH,OAAO,CAAC,OAAO;IAyBf;;OAEG;IACH,OAAO,CAAC,YAAY;IAOpB;;OAEG;IACH,OAAO,CAAC,OAAO;IASf;;OAEG;IACH,OAAO,CAAC,WAAW;IAcnB;;OAEG;IACH,IAAI,CAAC,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,GAAG,CAAC,EAAE;IAoBxD;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,UAAU,EAAE,MAAM,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IA2B5E;;OAEG;IACH,OAAO,CAAC,cAAc;IAetB;;OAEG;IACH,OAAO,CAAC,iBAAiB;CAc1B;AAED;;GAEG;AACH,wBAAgB,iBAAiB,IAAI,WAAW,CAE/C"}

package/dist/features/query.js

@@ -63,7 +63,14 @@ export class QueryEngine {
             case '$lte':
                 return this.compare(value, operand) <= 0;
             case '$in':
-                return Array.isArray(operand) && operand.some((v) => this.equals(value, v));
+                if (!Array.isArray(operand))
+                    return false;
+                // If value is an array, check if any operand value is in the array
+                if (Array.isArray(value)) {
+                    return operand.some((v) => value.some((item) => this.equals(item, v)));
+                }
+                // Otherwise check if value equals any operand value
+                return operand.some((v) => this.equals(value, v));
             case '$nin':
                 return Array.isArray(operand) && !operand.some((v) => this.equals(value, v));
             case '$regex':

package/dist/features/sync/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../sync';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/sync/index.d.ts.map

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

package/dist/features/sync/index.js

@@ -0,0 +1 @@
+export * from "../sync.js";

package/dist/features/sync.js

@@ -2,7 +2,7 @@
  * Cross-tab Synchronization Feature
  * Zero-dependency implementation using BroadcastChannel and storage events
  */
-import { EventEmitter } from '@/utils';
+import { EventEmitter } from "../utils/index.js";
 /**
  * Cross-tab synchronization manager
  */

package/dist/features/ttl/index.d.ts

@@ -0,0 +1,2 @@
+export * from '../ttl';
+//# sourceMappingURL=index.d.ts.map

package/dist/features/ttl/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/features/ttl/index.ts"],"names":[],"mappings":"AAAA,cAAc,QAAQ,CAAC"}

package/dist/features/ttl/index.js

@@ -0,0 +1 @@
+export * from "../ttl.js";

package/dist/features/ttl.js

@@ -2,7 +2,7 @@
  * TTL (Time To Live) Manager
  * Handles automatic expiration of storage items
  */
-import { EventEmitter } from '@/utils';
+import { EventEmitter } from "../utils/index.js";
 /**
  * TTL Manager for handling item expiration
  */

package/dist/firebase.d.ts

@@ -0,0 +1,26 @@
+import type { Strata } from './core/Strata';
+/**
+ * Firebase sync configuration
+ */
+export interface FirebaseSyncConfig {
+    apiKey: string;
+    authDomain: string;
+    projectId: string;
+    storageBucket?: string;
+    messagingSenderId?: string;
+    appId: string;
+    realtimeDatabase?: boolean;
+    firestore?: boolean;
+    collectionName?: string;
+    syncInterval?: number;
+}
+/**
+ * Enable Firebase sync for Strata Storage
+ * This dynamically imports Firebase SDK only when needed
+ */
+export declare function enableFirebaseSync(storage: Strata, config: FirebaseSyncConfig): Promise<void>;
+/**
+ * Check if Firebase is available in the environment
+ */
+export declare function isFirebaseAvailable(): Promise<boolean>;
+//# sourceMappingURL=firebase.d.ts.map

package/dist/firebase.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"firebase.d.ts","sourceRoot":"","sources":["../src/firebase.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAE5C;;GAEG;AACH,MAAM,WAAW,kBAAkB;IACjC,MAAM,EAAE,MAAM,CAAC;IACf,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,KAAK,EAAE,MAAM,CAAC;IACd,gBAAgB,CAAC,EAAE,OAAO,CAAC;IAC3B,SAAS,CAAC,EAAE,OAAO,CAAC;IACpB,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,YAAY,CAAC,EAAE,MAAM,CAAC;CACvB;AAED;;;GAGG;AACH,wBAAsB,kBAAkB,CACtC,OAAO,EAAE,MAAM,EACf,MAAM,EAAE,kBAAkB,GACzB,OAAO,CAAC,IAAI,CAAC,CA2If;AAED;;GAEG;AACH,wBAAsB,mBAAmB,IAAI,OAAO,CAAC,OAAO,CAAC,CAO5D"}

package/dist/firebase.js

@@ -0,0 +1,147 @@
+/**
+ * Enable Firebase sync for Strata Storage
+ * This dynamically imports Firebase SDK only when needed
+ */
+export async function enableFirebaseSync(storage, config) {
+    // Dynamically import Firebase only when this function is called
+    try {
+        const { initializeApp, getApps } = await import('firebase/app');
+        // Initialize Firebase if not already initialized
+        if (!getApps().length) {
+            initializeApp({
+                apiKey: config.apiKey,
+                authDomain: config.authDomain,
+                projectId: config.projectId,
+                storageBucket: config.storageBucket,
+                messagingSenderId: config.messagingSenderId,
+                appId: config.appId,
+            });
+        }
+        if (config.firestore) {
+            const { getFirestore, doc, setDoc, getDoc, deleteDoc } = await import('firebase/firestore');
+            const db = getFirestore();
+            const collectionName = config.collectionName || 'strata-storage';
+            // Create custom adapter for Firestore
+            const firestoreAdapter = {
+                name: 'firestore',
+                capabilities: {
+                    persistent: true,
+                    synchronous: false,
+                    observable: true,
+                    transactional: false,
+                    queryable: true,
+                    maxSize: -1,
+                    binary: true,
+                    encrypted: false,
+                    crossTab: true,
+                },
+                async get(key) {
+                    const docRef = doc(db, collectionName, key);
+                    const docSnap = await getDoc(docRef);
+                    return docSnap.exists() ? docSnap.data() : null;
+                },
+                async set(key, value) {
+                    const docRef = doc(db, collectionName, key);
+                    await setDoc(docRef, { value, timestamp: Date.now() });
+                },
+                async remove(key) {
+                    const docRef = doc(db, collectionName, key);
+                    await deleteDoc(docRef);
+                },
+                async has(key) {
+                    const docRef = doc(db, collectionName, key);
+                    const docSnap = await getDoc(docRef);
+                    return docSnap.exists();
+                },
+                async clear() {
+                    // Firestore doesn't have a direct clear method
+                    console.warn('Clear operation not supported for Firestore adapter');
+                },
+                async keys() {
+                    // Would need to implement with queries
+                    return [];
+                },
+                async size() {
+                    return { total: 0, count: 0 };
+                },
+                async initialize() {
+                    // Already initialized
+                },
+                async isAvailable() {
+                    return true;
+                },
+            };
+            // Register the Firestore adapter
+            storage.registerAdapter(firestoreAdapter);
+        }
+        if (config.realtimeDatabase) {
+            const { getDatabase, ref, set, get, remove } = await import('firebase/database');
+            const db = getDatabase();
+            // Create custom adapter for Realtime Database
+            const realtimeAdapter = {
+                name: 'realtime',
+                capabilities: {
+                    persistent: true,
+                    synchronous: false,
+                    observable: true,
+                    transactional: false,
+                    queryable: false,
+                    maxSize: -1,
+                    binary: false,
+                    encrypted: false,
+                    crossTab: true,
+                },
+                async get(key) {
+                    const snapshot = await get(ref(db, `strata-storage/${key}`));
+                    return snapshot.exists() ? snapshot.val() : null;
+                },
+                async set(key, value) {
+                    await set(ref(db, `strata-storage/${key}`), value);
+                },
+                async remove(key) {
+                    await remove(ref(db, `strata-storage/${key}`));
+                },
+                async has(key) {
+                    const snapshot = await get(ref(db, `strata-storage/${key}`));
+                    return snapshot.exists();
+                },
+                async clear() {
+                    await remove(ref(db, 'strata-storage'));
+                },
+                async keys() {
+                    const snapshot = await get(ref(db, 'strata-storage'));
+                    return snapshot.exists() ? Object.keys(snapshot.val()) : [];
+                },
+                async size() {
+                    const snapshot = await get(ref(db, 'strata-storage'));
+                    const count = snapshot.exists() ? Object.keys(snapshot.val()).length : 0;
+                    return { total: count * 100, count }; // Rough estimate
+                },
+                async initialize() {
+                    // Already initialized
+                },
+                async isAvailable() {
+                    return true;
+                },
+            };
+            // Register the Realtime Database adapter
+            storage.registerAdapter(realtimeAdapter);
+        }
+        console.log('Firebase sync enabled successfully');
+    }
+    catch (error) {
+        throw new Error(`Failed to enable Firebase sync: ${error instanceof Error ? error.message : 'Unknown error'}`);
+    }
+}
+/**
+ * Check if Firebase is available in the environment
+ */
+export async function isFirebaseAvailable() {
+    try {
+        await import('firebase/app');
+        return true;
+    }
+    catch {
+        return false;
+    }
+}