strata-storage 1.0.0

package/dist/adapters/capacitor/SqliteAdapter.d.ts

@@ -0,0 +1,68 @@
+/**
+ * SQLite Adapter - Native SQLite database storage
+ * Available on iOS and Android
+ */
+import { BaseAdapter } from '@/core/BaseAdapter';
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition, Transaction } from '@/types';
+/**
+ * Configuration options for SQLite adapter
+ */
+export interface SqliteConfig {
+    database?: string;
+    table?: string;
+    version?: number;
+}
+/**
+ * Native SQLite adapter using Capacitor plugin
+ */
+export declare class SqliteAdapter extends BaseAdapter {
+    readonly name: StorageType;
+    readonly capabilities: StorageCapabilities;
+    private database;
+    private table;
+    constructor(config?: SqliteConfig);
+    /**
+     * Check if SQLite is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Initialize the adapter
+     */
+    initialize(config?: SqliteConfig): Promise<void>;
+    /**
+     * Get a value from SQLite
+     */
+    get<T = unknown>(key: string): Promise<StorageValue<T> | null>;
+    /**
+     * Set a value in SQLite
+     */
+    set<T = unknown>(key: string, value: StorageValue<T>): Promise<void>;
+    /**
+     * Remove a value from SQLite
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Clear SQLite table
+     */
+    clear(options?: ClearOptions): Promise<void>;
+    /**
+     * Get all keys
+     */
+    keys(pattern?: string | RegExp): Promise<string[]>;
+    /**
+     * Query SQLite with conditions
+     */
+    query<T = unknown>(condition: QueryCondition): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    /**
+     * Get storage size
+     */
+    size(detailed?: boolean): Promise<SizeInfo>;
+    /**
+     * Begin a transaction
+     */
+    transaction(): Promise<Transaction>;
+}
+//# sourceMappingURL=SqliteAdapter.d.ts.map

package/dist/adapters/capacitor/SqliteAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"SqliteAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/SqliteAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACd,WAAW,EACZ,MAAM,SAAS,CAAC;AAKjB;;GAEG;AACH,MAAM,WAAW,YAAY;IAC3B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;IAC5C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAY;IACtC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,QAAQ,CAAS;IACzB,OAAO,CAAC,KAAK,CAAS;gBAEV,MAAM,GAAE,YAAiB;IAMrC;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAWrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAOtD;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IA0BpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAkB1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBlD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IA0BxD;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IA4B9F;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IAejD;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,WAAW,CAAC;CAK1C"}

package/dist/adapters/capacitor/SqliteAdapter.js

@@ -0,0 +1,277 @@
+/**
+ * SQLite Adapter - Native SQLite database storage
+ * Available on iOS and Android
+ */
+import { BaseAdapter } from '@/core/BaseAdapter';
+import { StrataStorage } from '@/plugin';
+import { StorageError, TransactionError } from '@/utils/errors';
+import { isCapacitor } from '@/utils';
+/**
+ * Native SQLite adapter using Capacitor plugin
+ */
+export class SqliteAdapter extends BaseAdapter {
+    name = 'sqlite';
+    capabilities = {
+        persistent: true,
+        synchronous: false,
+        observable: false,
+        transactional: true,
+        queryable: true,
+        maxSize: -1, // Limited by device storage
+        binary: true,
+        encrypted: false, // Can be encrypted at OS level
+        crossTab: true,
+    };
+    database;
+    table;
+    constructor(config = {}) {
+        super();
+        this.database = config.database || 'strata_storage';
+        this.table = config.table || 'storage';
+    }
+    /**
+     * Check if SQLite is available
+     */
+    async isAvailable() {
+        if (!isCapacitor())
+            return false;
+        try {
+            const result = await StrataStorage.isAvailable({ storage: 'sqlite' });
+            return result.available;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Initialize the adapter
+     */
+    async initialize(config) {
+        if (config?.database)
+            this.database = config.database;
+        if (config?.table)
+            this.table = config.table;
+        this.startTTLCleanup();
+    }
+    /**
+     * Get a value from SQLite
+     */
+    async get(key) {
+        try {
+            const result = await StrataStorage.get({
+                key,
+                storage: 'sqlite',
+                database: this.database,
+                table: this.table,
+            });
+            if (!result.value)
+                return null;
+            const value = result.value;
+            // Check TTL
+            if (this.isExpired(value)) {
+                await this.remove(key);
+                return null;
+            }
+            return value;
+        }
+        catch (error) {
+            console.error(`Failed to get key ${key} from SQLite:`, error);
+            return null;
+        }
+    }
+    /**
+     * Set a value in SQLite
+     */
+    async set(key, value) {
+        const oldValue = await this.get(key);
+        try {
+            await StrataStorage.set({
+                key,
+                value,
+                storage: 'sqlite',
+                database: this.database,
+                table: this.table,
+            });
+            this.emitChange(key, oldValue?.value, value.value, 'local');
+        }
+        catch (error) {
+            throw new StorageError(`Failed to set key ${key} in SQLite: ${error}`);
+        }
+    }
+    /**
+     * Remove a value from SQLite
+     */
+    async remove(key) {
+        const oldValue = await this.get(key);
+        try {
+            await StrataStorage.remove({
+                key,
+                storage: 'sqlite',
+                database: this.database,
+                table: this.table,
+            });
+            if (oldValue) {
+                this.emitChange(key, oldValue.value, undefined, 'local');
+            }
+        }
+        catch (error) {
+            throw new StorageError(`Failed to remove key ${key} from SQLite: ${error}`);
+        }
+    }
+    /**
+     * Clear SQLite table
+     */
+    async clear(options) {
+        if (!options || (!options.pattern && !options.tags && !options.expiredOnly)) {
+            try {
+                await StrataStorage.clear({
+                    storage: 'sqlite',
+                    database: this.database,
+                    table: this.table,
+                });
+                this.emitChange('*', undefined, undefined, 'local');
+                return;
+            }
+            catch (error) {
+                throw new StorageError(`Failed to clear SQLite: ${error}`);
+            }
+        }
+        // Use base implementation for filtered clear
+        await super.clear(options);
+    }
+    /**
+     * Get all keys
+     */
+    async keys(pattern) {
+        try {
+            const result = await StrataStorage.keys({
+                storage: 'sqlite',
+                database: this.database,
+                table: this.table,
+                pattern: pattern instanceof RegExp ? pattern.source : pattern,
+            });
+            const keys = result.keys;
+            // Check for expired keys
+            const validKeys = [];
+            for (const key of keys) {
+                const value = await this.get(key);
+                if (value) {
+                    validKeys.push(key);
+                }
+            }
+            return this.filterKeys(validKeys, pattern);
+        }
+        catch (error) {
+            throw new StorageError(`Failed to get keys from SQLite: ${error}`);
+        }
+    }
+    /**
+     * Query SQLite with conditions
+     */
+    async query(condition) {
+        try {
+            if (!StrataStorage.query) {
+                throw new StorageError('Query not supported on this platform');
+            }
+            const result = await StrataStorage.query({
+                storage: 'sqlite',
+                database: this.database,
+                table: this.table,
+                condition,
+            });
+            // Filter expired entries
+            const validResults = [];
+            for (const item of result.results) {
+                const value = await this.get(item.key);
+                if (value) {
+                    validResults.push({ key: item.key, value: value.value });
+                }
+            }
+            return validResults;
+        }
+        catch (error) {
+            throw new StorageError(`Failed to query SQLite: ${error}`);
+        }
+    }
+    /**
+     * Get storage size
+     */
+    async size(detailed) {
+        try {
+            const result = await StrataStorage.size({
+                storage: 'sqlite',
+                database: this.database,
+                table: this.table,
+                detailed,
+            });
+            return result;
+        }
+        catch (error) {
+            throw new StorageError(`Failed to get size of SQLite: ${error}`);
+        }
+    }
+    /**
+     * Begin a transaction
+     */
+    async transaction() {
+        // Transactions are handled natively
+        // For now, return a simple implementation
+        return new SqliteTransaction(this);
+    }
+}
+/**
+ * SQLite transaction implementation
+ */
+class SqliteTransaction {
+    adapter;
+    operations = [];
+    committed = false;
+    aborted = false;
+    constructor(adapter) {
+        this.adapter = adapter;
+    }
+    async get(key) {
+        if (this.aborted)
+            throw new TransactionError('Transaction already aborted');
+        const value = await this.adapter.get(key);
+        return value ? value.value : null;
+    }
+    async set(key, value) {
+        if (this.aborted)
+            throw new TransactionError('Transaction already aborted');
+        this.operations.push(async () => {
+            const now = Date.now();
+            await this.adapter.set(key, {
+                value,
+                created: now,
+                updated: now,
+            });
+        });
+    }
+    async remove(key) {
+        if (this.aborted)
+            throw new TransactionError('Transaction already aborted');
+        this.operations.push(async () => {
+            await this.adapter.remove(key);
+        });
+    }
+    async commit() {
+        if (this.aborted)
+            throw new TransactionError('Cannot commit aborted transaction');
+        if (this.committed)
+            throw new TransactionError('Transaction already committed');
+        this.committed = true;
+        // Execute all operations
+        for (const operation of this.operations) {
+            await operation();
+        }
+    }
+    async rollback() {
+        if (this.committed)
+            throw new TransactionError('Cannot rollback committed transaction');
+        if (this.aborted)
+            return;
+        this.aborted = true;
+        this.operations = [];
+    }
+}

package/dist/adapters/capacitor/index.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Capacitor Native Storage Adapters
+ * Export all native platform storage implementations
+ */
+export { PreferencesAdapter } from './PreferencesAdapter';
+export { SqliteAdapter } from './SqliteAdapter';
+export { SecureAdapter } from './SecureAdapter';
+export { FilesystemAdapter } from './FilesystemAdapter';
+//# sourceMappingURL=index.d.ts.map

package/dist/adapters/capacitor/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/adapters/capacitor/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,kBAAkB,EAAE,MAAM,sBAAsB,CAAC;AAC1D,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC"}

package/dist/adapters/capacitor/index.js

@@ -0,0 +1,8 @@
+/**
+ * Capacitor Native Storage Adapters
+ * Export all native platform storage implementations
+ */
+export { PreferencesAdapter } from './PreferencesAdapter';
+export { SqliteAdapter } from './SqliteAdapter';
+export { SecureAdapter } from './SecureAdapter';
+export { FilesystemAdapter } from './FilesystemAdapter';

package/dist/adapters/web/CacheAdapter.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Cache Adapter - Service Worker Cache API implementation
+ * Provides network-aware storage for offline support
+ */
+import { BaseAdapter } from '@/core/BaseAdapter';
+import type { StorageType, StorageCapabilities, StorageValue, ClearOptions, SizeInfo, QueryCondition } from '@/types';
+/**
+ * Cache API adapter for Service Worker environments
+ */
+export declare class CacheAdapter extends BaseAdapter {
+    readonly name: StorageType;
+    readonly capabilities: StorageCapabilities;
+    private cacheName;
+    private baseUrl;
+    private cache?;
+    constructor(cacheName?: string, baseUrl?: string);
+    /**
+     * Check if Cache API is available
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Initialize the adapter
+     */
+    initialize(config?: {
+        cacheName?: string;
+        baseUrl?: string;
+    }): Promise<void>;
+    /**
+     * Open cache
+     */
+    private openCache;
+    /**
+     * Create URL for key
+     */
+    private keyToUrl;
+    /**
+     * Extract key from URL
+     */
+    private urlToKey;
+    /**
+     * Get a value from cache
+     */
+    get<T = unknown>(key: string): Promise<StorageValue<T> | null>;
+    /**
+     * Set a value in cache
+     */
+    set<T = unknown>(key: string, value: StorageValue<T>): Promise<void>;
+    /**
+     * Remove a value from cache
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Clear cache
+     */
+    clear(options?: ClearOptions): Promise<void>;
+    /**
+     * Get all keys
+     */
+    keys(pattern?: string | RegExp): Promise<string[]>;
+    /**
+     * Query cache with conditions
+     */
+    query<T = unknown>(condition: QueryCondition): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    /**
+     * Get storage size
+     */
+    size(detailed?: boolean): Promise<SizeInfo>;
+    /**
+     * Store binary data
+     */
+    setBinary(key: string, data: ArrayBuffer | Blob, metadata?: Record<string, unknown>): Promise<void>;
+    /**
+     * Get binary data
+     */
+    getBinary(key: string): Promise<{
+        data: ArrayBuffer;
+        metadata?: Record<string, unknown>;
+    } | null>;
+    /**
+     * Close the adapter
+     */
+    close(): Promise<void>;
+    /**
+     * Check if error is quota exceeded
+     */
+    private isQuotaError;
+}
+//# sourceMappingURL=CacheAdapter.d.ts.map

package/dist/adapters/web/CacheAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"CacheAdapter.d.ts","sourceRoot":"","sources":["../../../src/adapters/web/CacheAdapter.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AACjD,OAAO,KAAK,EACV,WAAW,EACX,mBAAmB,EACnB,YAAY,EACZ,YAAY,EACZ,QAAQ,EACR,cAAc,EACf,MAAM,SAAS,CAAC;AAIjB;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;IAC3C,QAAQ,CAAC,IAAI,EAAE,WAAW,CAAW;IACrC,QAAQ,CAAC,YAAY,EAAE,mBAAmB,CAUxC;IAEF,OAAO,CAAC,SAAS,CAAS;IAC1B,OAAO,CAAC,OAAO,CAAS;IACxB,OAAO,CAAC,KAAK,CAAC,CAAQ;gBAEV,SAAS,SAAsB,EAAE,OAAO,SAA0B;IAM9E;;OAEG;IACG,WAAW,IAAI,OAAO,CAAC,OAAO,CAAC;IAIrC;;OAEG;IACG,UAAU,CAAC,MAAM,CAAC,EAAE;QAAE,SAAS,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAC,IAAI,CAAC;IAQlF;;OAEG;YACW,SAAS;IAWvB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAIhB;;OAEG;IACH,OAAO,CAAC,QAAQ;IAOhB;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,YAAY,CAAC,CAAC,CAAC,GAAG,IAAI,CAAC;IAuBpE;;OAEG;IACG,GAAG,CAAC,CAAC,GAAG,OAAO,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,YAAY,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IA0B1E;;OAEG;IACG,MAAM,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAYxC;;OAEG;IACG,KAAK,CAAC,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CAAC,IAAI,CAAC;IAalD;;OAEG;IACG,IAAI,CAAC,OAAO,CAAC,EAAE,MAAM,GAAG,MAAM,GAAG,OAAO,CAAC,MAAM,EAAE,CAAC;IAkBxD;;OAEG;IACG,KAAK,CAAC,CAAC,GAAG,OAAO,EAAE,SAAS,EAAE,cAAc,GAAG,OAAO,CAAC,KAAK,CAAC;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,KAAK,EAAE,CAAC,CAAA;KAAE,CAAC,CAAC;IAiB9F;;OAEG;IACG,IAAI,CAAC,QAAQ,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,QAAQ,CAAC;IA6CjD;;OAEG;IACG,SAAS,CACb,GAAG,EAAE,MAAM,EACX,IAAI,EAAE,WAAW,GAAG,IAAI,EACxB,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GACjC,OAAO,CAAC,IAAI,CAAC;IAyBhB;;OAEG;IACG,SAAS,CACb,GAAG,EAAE,MAAM,GACV,OAAO,CAAC;QAAE,IAAI,EAAE,WAAW,CAAC;QAAC,QAAQ,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAA;KAAE,GAAG,IAAI,CAAC;IAwB5E;;OAEG;IACG,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;IAQ5B;;OAEG;IACH,OAAO,CAAC,YAAY;CAMrB"}