strata-storage 1.6.0 → 2.0.0

package/Readme.md

@@ -23,21 +23,56 @@ Zero-dependency universal storage plugin providing a unified API for all storage
 npm install strata-storage
 ```
 
+### Provider-less Usage (Zero Setup)
 ```typescript
-import { Strata } from 'strata-storage';
+import { storage } from 'strata-storage';
 
-const storage = new Strata();
-await storage.initialize();
-
-// Works everywhere - web, iOS, Android
+// Works immediately - no setup, no providers, no initialization!
 await storage.set('user', { name: 'John', age: 30 });
 const user = await storage.get('user');
 ```
 
+### With Capacitor (Optional)
+```typescript
+import { storage } from 'strata-storage';
+import { registerCapacitorAdapters } from 'strata-storage/capacitor';
+
+// Only if you need native features
+if (window.Capacitor) {
+  await registerCapacitorAdapters(storage);
+}
+
+// Use native storage when available
+await storage.set('secure-data', 'secret', { storage: 'secure' });
+```
+
+### With Firebase (Optional)
+```typescript
+import { storage } from 'strata-storage';
+import { enableFirebaseSync } from 'strata-storage/firebase';
+
+// Only if you need cloud sync
+if (needCloudSync) {
+  await enableFirebaseSync(storage, {
+    apiKey: 'your-api-key',
+    projectId: 'your-project-id',
+    firestore: true
+  });
+}
+
+// Works offline-first, syncs when online
+await storage.set('data', value, { storage: 'firestore' });
+```
+
 ## ✨ Features
 
 ### Core Features
-- ✅ **Zero Dependencies** - No external packages, pure implementation
+- ✅ **Zero Dependencies** - No runtime dependencies, pure implementation
+- ✅ **Provider-less Architecture** - No providers, contexts, or wrappers needed (like zustand)
+- ✅ **Works Everywhere** - React, Vue, Angular, Vanilla JS, Node.js - same API
+- ✅ **Zero Configuration** - Import and use immediately, no setup required
+- ✅ **Opt-in Complexity** - Start simple, add features only when needed
+- ✅ **Dynamic Provider Loading** - Providers load only when used, keeping bundle small
 - ✅ **Universal API** - Single interface for all storage types
 - ✅ **Cross-Platform** - Web, iOS, Android support
 - ✅ **TypeScript** - Full type safety and IntelliSense
@@ -67,22 +102,23 @@ const user = await storage.get('user');
 ## 📖 Basic Usage
 
 ```typescript
-// Initialize with configuration
-const storage = new Strata({
-  defaultStorages: ['indexedDB', 'localStorage', 'memory'],
-  encryption: { enabled: true },
-  compression: { enabled: true },
-  ttl: { defaultTTL: 3600000 } // 1 hour
-});
+import { storage } from 'strata-storage';
+
+// No initialization needed - works immediately!
 
-await storage.initialize();
+// Simple usage
+await storage.set('key', 'value');
+const value = await storage.get('key');
+await storage.remove('key');
+await storage.clear();
 
-// Store with options
+// Advanced options
 await storage.set('key', value, {
-  ttl: 3600000,        // Expire in 1 hour
-  encrypt: true,       // Encrypt this value
-  compress: true,      // Compress if beneficial
-  tags: ['user-data'] // Tag for grouping
+  storage: 'indexedDB',  // Choose specific storage
+  ttl: 3600000,         // Expire in 1 hour
+  encrypt: true,        // Encrypt this value
+  compress: true,       // Compress if beneficial
+  tags: ['user-data']   // Tag for grouping
 });
 
 // Query data
@@ -97,13 +133,23 @@ storage.subscribe((change) => {
 });
 ```
 
+## 🎯 Provider-less Architecture
+
+Strata Storage follows a provider-less architecture similar to Zustand. The core library works everywhere with zero dependencies, and platform-specific features (like Capacitor) are completely optional.
+
+- **Minimal by default** - Only includes web storage adapters
+- **Opt-in native features** - Explicitly add Capacitor support when needed
+- **Better tree-shaking** - Unused adapters are eliminated by bundlers
+- **Smaller bundle size** - Web-only projects don't include native code
+
 ## 🏗 Project Status
 
 Currently in active development. Phase 1-5 completed:
 - ✅ Project setup and core architecture
 - ✅ Memory and web storage adapters
-- ✅ Capacitor plugin structure
+- ✅ Capacitor plugin structure (now optional)
 - ✅ Advanced features (encryption, compression, sync, query, TTL)
+- ✅ Provider-less architecture
 - 🚧 Native implementations (iOS/Android)
 - 🚧 Testing and documentation
 

package/dist/README.md

@@ -23,21 +23,56 @@ Zero-dependency universal storage plugin providing a unified API for all storage
 npm install strata-storage
 ```
 
+### Provider-less Usage (Zero Setup)
 ```typescript
-import { Strata } from 'strata-storage';
+import { storage } from 'strata-storage';
 
-const storage = new Strata();
-await storage.initialize();
-
-// Works everywhere - web, iOS, Android
+// Works immediately - no setup, no providers, no initialization!
 await storage.set('user', { name: 'John', age: 30 });
 const user = await storage.get('user');
 ```
 
+### With Capacitor (Optional)
+```typescript
+import { storage } from 'strata-storage';
+import { registerCapacitorAdapters } from 'strata-storage/capacitor';
+
+// Only if you need native features
+if (window.Capacitor) {
+  await registerCapacitorAdapters(storage);
+}
+
+// Use native storage when available
+await storage.set('secure-data', 'secret', { storage: 'secure' });
+```
+
+### With Firebase (Optional)
+```typescript
+import { storage } from 'strata-storage';
+import { enableFirebaseSync } from 'strata-storage/firebase';
+
+// Only if you need cloud sync
+if (needCloudSync) {
+  await enableFirebaseSync(storage, {
+    apiKey: 'your-api-key',
+    projectId: 'your-project-id',
+    firestore: true
+  });
+}
+
+// Works offline-first, syncs when online
+await storage.set('data', value, { storage: 'firestore' });
+```
+
 ## ✨ Features
 
 ### Core Features
-- ✅ **Zero Dependencies** - No external packages, pure implementation
+- ✅ **Zero Dependencies** - No runtime dependencies, pure implementation
+- ✅ **Provider-less Architecture** - No providers, contexts, or wrappers needed (like zustand)
+- ✅ **Works Everywhere** - React, Vue, Angular, Vanilla JS, Node.js - same API
+- ✅ **Zero Configuration** - Import and use immediately, no setup required
+- ✅ **Opt-in Complexity** - Start simple, add features only when needed
+- ✅ **Dynamic Provider Loading** - Providers load only when used, keeping bundle small
 - ✅ **Universal API** - Single interface for all storage types
 - ✅ **Cross-Platform** - Web, iOS, Android support
 - ✅ **TypeScript** - Full type safety and IntelliSense
@@ -67,22 +102,23 @@ const user = await storage.get('user');
 ## 📖 Basic Usage
 
 ```typescript
-// Initialize with configuration
-const storage = new Strata({
-  defaultStorages: ['indexedDB', 'localStorage', 'memory'],
-  encryption: { enabled: true },
-  compression: { enabled: true },
-  ttl: { defaultTTL: 3600000 } // 1 hour
-});
+import { storage } from 'strata-storage';
+
+// No initialization needed - works immediately!
 
-await storage.initialize();
+// Simple usage
+await storage.set('key', 'value');
+const value = await storage.get('key');
+await storage.remove('key');
+await storage.clear();
 
-// Store with options
+// Advanced options
 await storage.set('key', value, {
-  ttl: 3600000,        // Expire in 1 hour
-  encrypt: true,       // Encrypt this value
-  compress: true,      // Compress if beneficial
-  tags: ['user-data'] // Tag for grouping
+  storage: 'indexedDB',  // Choose specific storage
+  ttl: 3600000,         // Expire in 1 hour
+  encrypt: true,        // Encrypt this value
+  compress: true,       // Compress if beneficial
+  tags: ['user-data']   // Tag for grouping
 });
 
 // Query data
@@ -97,13 +133,23 @@ storage.subscribe((change) => {
 });
 ```
 
+## 🎯 Provider-less Architecture
+
+Strata Storage follows a provider-less architecture similar to Zustand. The core library works everywhere with zero dependencies, and platform-specific features (like Capacitor) are completely optional.
+
+- **Minimal by default** - Only includes web storage adapters
+- **Opt-in native features** - Explicitly add Capacitor support when needed
+- **Better tree-shaking** - Unused adapters are eliminated by bundlers
+- **Smaller bundle size** - Web-only projects don't include native code
+
 ## 🏗 Project Status
 
 Currently in active development. Phase 1-5 completed:
 - ✅ Project setup and core architecture
 - ✅ Memory and web storage adapters
-- ✅ Capacitor plugin structure
+- ✅ Capacitor plugin structure (now optional)
 - ✅ Advanced features (encryption, compression, sync, query, TTL)
+- ✅ Provider-less architecture
 - 🚧 Native implementations (iOS/Android)
 - 🚧 Testing and documentation
 

package/dist/adapters/web/MemoryAdapter.js

@@ -134,7 +134,7 @@ export class MemoryAdapter extends BaseAdapter {
     async query(condition) {
         const results = [];
         for (const [key, item] of this.storage.entries()) {
-            if (!this.isExpired(item) && this.queryEngine.matches(item.value, condition)) {
+            if (!this.isExpired(item) && this.queryEngine.matches(item, condition)) {
                 results.push({
                     key,
                     value: deepClone(item.value),

package/dist/capacitor.d.ts

@@ -0,0 +1,20 @@
+import type { Strata } from './core/Strata';
+export { PreferencesAdapter } from './adapters/capacitor/PreferencesAdapter';
+export { SqliteAdapter } from './adapters/capacitor/SqliteAdapter';
+export { SecureAdapter } from './adapters/capacitor/SecureAdapter';
+export { FilesystemAdapter } from './adapters/capacitor/FilesystemAdapter';
+export { StrataStorage } from './plugin';
+/**
+ * Register Capacitor adapters with a Strata instance
+ * This is completely optional and only needed for Capacitor apps
+ */
+export declare function registerCapacitorAdapters(storage: Strata): Promise<void>;
+/**
+ * Helper to check if running in Capacitor environment
+ */
+export declare function isCapacitorEnvironment(): boolean;
+/**
+ * Get Capacitor-specific storage types
+ */
+export declare function getCapacitorStorageTypes(): string[];
+//# sourceMappingURL=capacitor.d.ts.map

package/dist/capacitor.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"capacitor.d.ts","sourceRoot":"","sources":["../src/capacitor.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,eAAe,CAAC;AAO5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,yCAAyC,CAAC;AAC7E,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,aAAa,EAAE,MAAM,oCAAoC,CAAC;AACnE,OAAO,EAAE,iBAAiB,EAAE,MAAM,wCAAwC,CAAC;AAG3E,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AAEzC;;;GAGG;AACH,wBAAsB,yBAAyB,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAsB9E;AAED;;GAEG;AACH,wBAAgB,sBAAsB,IAAI,OAAO,CAMhD;AAED;;GAEG;AACH,wBAAgB,wBAAwB,IAAI,MAAM,EAAE,CAEnD"}

package/dist/capacitor.js

@@ -0,0 +1,48 @@
+import { PreferencesAdapter } from "./adapters/capacitor/PreferencesAdapter.js";
+import { SqliteAdapter } from "./adapters/capacitor/SqliteAdapter.js";
+import { SecureAdapter } from "./adapters/capacitor/SecureAdapter.js";
+import { FilesystemAdapter } from "./adapters/capacitor/FilesystemAdapter.js";
+// Export Capacitor adapters
+export { PreferencesAdapter } from "./adapters/capacitor/PreferencesAdapter.js";
+export { SqliteAdapter } from "./adapters/capacitor/SqliteAdapter.js";
+export { SecureAdapter } from "./adapters/capacitor/SecureAdapter.js";
+export { FilesystemAdapter } from "./adapters/capacitor/FilesystemAdapter.js";
+// Export the plugin for direct access if needed
+export { StrataStorage } from "./plugin/index.js";
+/**
+ * Register Capacitor adapters with a Strata instance
+ * This is completely optional and only needed for Capacitor apps
+ */
+export async function registerCapacitorAdapters(storage) {
+    // Check if Capacitor is available
+    const hasCapacitor = typeof window !== 'undefined' &&
+        window.Capacitor &&
+        window.Capacitor.isNativePlatform();
+    if (!hasCapacitor) {
+        console.warn('Capacitor not detected. Capacitor adapters will not be registered.');
+        return;
+    }
+    // Register Capacitor adapters
+    storage.registerAdapter(new PreferencesAdapter());
+    storage.registerAdapter(new SqliteAdapter());
+    storage.registerAdapter(new SecureAdapter());
+    storage.registerAdapter(new FilesystemAdapter());
+    // Re-initialize to make new adapters available
+    if (storage.isInitialized) {
+        await storage.initialize();
+    }
+}
+/**
+ * Helper to check if running in Capacitor environment
+ */
+export function isCapacitorEnvironment() {
+    return (typeof window !== 'undefined' &&
+        window.Capacitor &&
+        window.Capacitor.isNativePlatform());
+}
+/**
+ * Get Capacitor-specific storage types
+ */
+export function getCapacitorStorageTypes() {
+    return ['preferences', 'sqlite', 'secure', 'filesystem'];
+}

package/dist/core/Strata.d.ts

@@ -2,7 +2,8 @@
  * Strata Storage - Main entry point
  * Zero-dependency universal storage solution
  */
-import type { StrataConfig, StorageOptions, StorageType, SizeInfo, ClearOptions, ExportOptions, ImportOptions, SubscriptionCallback, UnsubscribeFunction, QueryCondition, StorageCapabilities } from '@/types';
+import type { StrataConfig, StorageAdapter, StorageOptions, StorageType, Platform, SizeInfo, ClearOptions, ExportOptions, ImportOptions, SubscriptionCallback, UnsubscribeFunction, QueryCondition, StorageCapabilities } from '@/types';
+import { AdapterRegistry } from './AdapterRegistry';
 /**
  * Main Strata class - unified storage interface
  */
@@ -11,12 +12,21 @@ export declare class Strata {
     private registry;
     private defaultAdapter?;
     private adapters;
-    private platform;
+    private readonly _platform;
     private encryptionManager?;
     private compressionManager?;
     private syncManager?;
     private ttlManager?;
+    private _initialized;
     constructor(config?: StrataConfig);
+    /**
+     * Check if Strata has been initialized
+     */
+    get isInitialized(): boolean;
+    /**
+     * Get the detected platform
+     */
+    get platform(): Platform;
     /**
      * Initialize Strata with available adapters
      */
@@ -107,6 +117,22 @@ export declare class Strata {
      * Manually trigger TTL cleanup
      */
     cleanupExpired(options?: StorageOptions): Promise<number>;
+    /**
+     * Register a custom storage adapter
+     * This allows external adapters to be registered after initialization
+     *
+     * @example
+     * ```typescript
+     * import { MyCustomAdapter } from './my-adapter';
+     * storage.registerAdapter(new MyCustomAdapter());
+     * ```
+     */
+    registerAdapter(adapter: StorageAdapter): void;
+    /**
+     * Get the adapter registry (for advanced use cases)
+     * @internal
+     */
+    getRegistry(): AdapterRegistry;
     /**
      * Close all adapters
      */
@@ -114,7 +140,6 @@ export declare class Strata {
     private normalizeConfig;
     private detectPlatform;
     private getDefaultStorages;
-    private registerAdapters;
     private selectDefaultAdapter;
     private initializeAdapters;
     private selectAdapter;

package/dist/core/Strata.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"Strata.d.ts","sourceRoot":"","sources":["../../src/core/Strata.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"Strata.d.ts","sourceRoot":"","sources":["../../src/core/Strata.ts"],"names":[],"mappings":"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"}

package/dist/core/Strata.js

@@ -3,7 +3,7 @@
  * Zero-dependency universal storage solution
  */
 import { AdapterRegistry } from "./AdapterRegistry.js";
-import { isBrowser, isNode, isCapacitor } from "../utils/index.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";
@@ -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.js");
-            const { LocalStorageAdapter } = await import("../adapters/web/LocalStorageAdapter.js");
-            const { SessionStorageAdapter } = await import("../adapters/web/SessionStorageAdapter.js");
-            const { IndexedDBAdapter } = await import("../adapters/web/IndexedDBAdapter.js");
-            const { CookieAdapter } = await import("../adapters/web/CookieAdapter.js");
-            const { CacheAdapter } = await import("../adapters/web/CacheAdapter.js");
-            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.js");
-                const { SqliteAdapter } = await import("../adapters/capacitor/SqliteAdapter.js");
-                const { SecureAdapter } = await import("../adapters/capacitor/SecureAdapter.js");
-                const { FilesystemAdapter } = await import("../adapters/capacitor/FilesystemAdapter.js");
-                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/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/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"}