strata-storage 1.0.0

package/dist/plugin/definitions.d.ts

@@ -0,0 +1,219 @@
+/**
+ * Strata Storage Capacitor Plugin Definitions
+ * Interface definitions for native platform implementations
+ */
+import type { StorageValue } from '@/types';
+/**
+ * Main plugin interface
+ */
+export interface StrataStoragePlugin {
+    /**
+     * Check if a specific storage type is available on the platform
+     */
+    isAvailable(options: {
+        storage: NativeStorageType;
+    }): Promise<{
+        available: boolean;
+    }>;
+    /**
+     * Get a value from native storage
+     */
+    get(options: NativeGetOptions): Promise<{
+        value: StorageValue | null;
+    }>;
+    /**
+     * Set a value in native storage
+     */
+    set(options: NativeSetOptions): Promise<void>;
+    /**
+     * Remove a value from native storage
+     */
+    remove(options: NativeRemoveOptions): Promise<void>;
+    /**
+     * Clear native storage
+     */
+    clear(options: NativeClearOptions): Promise<void>;
+    /**
+     * Get all keys from native storage
+     */
+    keys(options: NativeKeysOptions): Promise<{
+        keys: string[];
+    }>;
+    /**
+     * Get storage size information
+     */
+    size(options: NativeSizeOptions): Promise<NativeSizeResult>;
+    /**
+     * Perform native query (if supported)
+     */
+    query?(options: NativeQueryOptions): Promise<{
+        results: Array<{
+            key: string;
+            value: unknown;
+        }>;
+    }>;
+    /**
+     * iOS-specific: Access UserDefaults
+     */
+    getUserDefaults?(options: {
+        key: string;
+        suiteName?: string;
+    }): Promise<{
+        value: unknown;
+    }>;
+    /**
+     * iOS-specific: Set UserDefaults
+     */
+    setUserDefaults?(options: {
+        key: string;
+        value: unknown;
+        suiteName?: string;
+    }): Promise<void>;
+    /**
+     * iOS-specific: Access Keychain
+     */
+    getKeychain?(options: {
+        key: string;
+        service?: string;
+        accessGroup?: string;
+    }): Promise<{
+        value: string | null;
+    }>;
+    /**
+     * iOS-specific: Set Keychain
+     */
+    setKeychain?(options: {
+        key: string;
+        value: string;
+        service?: string;
+        accessGroup?: string;
+        accessible?: KeychainAccessible;
+    }): Promise<void>;
+    /**
+     * Android-specific: Get encrypted preference
+     */
+    getEncryptedPreference?(options: {
+        key: string;
+        fileName?: string;
+    }): Promise<{
+        value: unknown;
+    }>;
+    /**
+     * Android-specific: Set encrypted preference
+     */
+    setEncryptedPreference?(options: {
+        key: string;
+        value: unknown;
+        fileName?: string;
+    }): Promise<void>;
+}
+/**
+ * Native storage types
+ */
+export type NativeStorageType = 'preferences' | 'sqlite' | 'secure' | 'filesystem';
+/**
+ * Native get options
+ */
+export interface NativeGetOptions {
+    key: string;
+    storage: NativeStorageType;
+    database?: string;
+    table?: string;
+}
+/**
+ * Native set options
+ */
+export interface NativeSetOptions {
+    key: string;
+    value: StorageValue;
+    storage: NativeStorageType;
+    database?: string;
+    table?: string;
+}
+/**
+ * Native remove options
+ */
+export interface NativeRemoveOptions {
+    key: string;
+    storage: NativeStorageType;
+    database?: string;
+    table?: string;
+}
+/**
+ * Native clear options
+ */
+export interface NativeClearOptions {
+    storage: NativeStorageType;
+    database?: string;
+    table?: string;
+    pattern?: string;
+}
+/**
+ * Native keys options
+ */
+export interface NativeKeysOptions {
+    storage: NativeStorageType;
+    database?: string;
+    table?: string;
+    pattern?: string;
+}
+/**
+ * Native size options
+ */
+export interface NativeSizeOptions {
+    storage: NativeStorageType;
+    database?: string;
+    table?: string;
+    detailed?: boolean;
+}
+/**
+ * Native size result
+ */
+export interface NativeSizeResult {
+    total: number;
+    count: number;
+    detailed?: {
+        keys: number;
+        values: number;
+        metadata: number;
+    };
+}
+/**
+ * Native query options
+ */
+export interface NativeQueryOptions {
+    storage: NativeStorageType;
+    database?: string;
+    table?: string;
+    condition: Record<string, unknown>;
+}
+/**
+ * iOS Keychain accessibility options
+ */
+export type KeychainAccessible = 'whenUnlocked' | 'afterFirstUnlock' | 'whenUnlockedThisDeviceOnly' | 'afterFirstUnlockThisDeviceOnly' | 'whenPasscodeSetThisDeviceOnly';
+/**
+ * Platform information
+ */
+export interface PlatformInfo {
+    platform: 'ios' | 'android' | 'web';
+    version: string;
+    isSimulator: boolean;
+}
+/**
+ * Storage permissions
+ */
+export interface StoragePermissions {
+    read: boolean;
+    write: boolean;
+    delete: boolean;
+}
+/**
+ * Migration options
+ */
+export interface MigrationOptions {
+    fromStorage: NativeStorageType;
+    toStorage: NativeStorageType;
+    keys?: string[];
+    transform?: (value: unknown) => unknown;
+}
+//# sourceMappingURL=definitions.d.ts.map

package/dist/plugin/definitions.d.ts.map

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

package/dist/plugin/definitions.js

@@ -0,0 +1,5 @@
+/**
+ * Strata Storage Capacitor Plugin Definitions
+ * Interface definitions for native platform implementations
+ */
+export {};

package/dist/plugin/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * Strata Storage Capacitor Plugin
+ * Main plugin registration and web implementation
+ */
+import type { StrataStoragePlugin } from './definitions';
+export declare let StrataStorage: StrataStoragePlugin;
+export * from './definitions';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/plugin/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EAAE,mBAAmB,EAAE,MAAM,eAAe,CAAC;AAczD,eAAO,IAAI,aAAa,EAAE,mBAAgC,CAAC;AAiB3D,cAAc,eAAe,CAAC"}

package/dist/plugin/index.js

@@ -0,0 +1,27 @@
+/**
+ * Strata Storage Capacitor Plugin
+ * Main plugin registration and web implementation
+ */
+// Mock implementation for when Capacitor is not available
+const mockPlugin = {
+    isAvailable: async () => ({ available: false }),
+    get: async () => ({ value: null }),
+    set: async () => { },
+    remove: async () => { },
+    clear: async () => { },
+    keys: async () => ({ keys: [] }),
+    size: async () => ({ total: 0, count: 0 }),
+};
+// Export the plugin - will be initialized based on environment
+export let StrataStorage = mockPlugin;
+// Initialize plugin when module loads
+if (typeof window !== 'undefined') {
+    // Check if Capacitor is available
+    const cap = window.Capacitor;
+    if (cap && cap.registerPlugin) {
+        StrataStorage = cap.registerPlugin('StrataStorage', {
+            web: () => import('./web').then((m) => new m.StrataStorageWeb()),
+        });
+    }
+}
+export * from './definitions';

package/dist/plugin/web.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Strata Storage Web Implementation
+ * Web platform implementation of the Capacitor plugin
+ */
+import type { StrataStoragePlugin, NativeStorageType, NativeGetOptions, NativeSetOptions, NativeRemoveOptions, NativeClearOptions, NativeKeysOptions, NativeSizeOptions, NativeSizeResult } from './definitions';
+import type { StorageValue } from '@/types';
+export declare class StrataStorageWeb implements StrataStoragePlugin {
+    isAvailable(_options: {
+        storage: NativeStorageType;
+    }): Promise<{
+        available: boolean;
+    }>;
+    get(_options: NativeGetOptions): Promise<{
+        value: StorageValue | null;
+    }>;
+    set(_options: NativeSetOptions): Promise<void>;
+    remove(_options: NativeRemoveOptions): Promise<void>;
+    clear(_options: NativeClearOptions): Promise<void>;
+    keys(_options: NativeKeysOptions): Promise<{
+        keys: string[];
+    }>;
+    size(_options: NativeSizeOptions): Promise<NativeSizeResult>;
+}
+//# sourceMappingURL=web.d.ts.map

package/dist/plugin/web.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"web.d.ts","sourceRoot":"","sources":["../../src/plugin/web.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,KAAK,EACV,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,gBAAgB,EAChB,mBAAmB,EACnB,kBAAkB,EAClB,iBAAiB,EACjB,iBAAiB,EACjB,gBAAgB,EACjB,MAAM,eAAe,CAAC;AACvB,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAE5C,qBAAa,gBAAiB,YAAW,mBAAmB;IACpD,WAAW,CAAC,QAAQ,EAAE;QAAE,OAAO,EAAE,iBAAiB,CAAA;KAAE,GAAG,OAAO,CAAC;QAAE,SAAS,EAAE,OAAO,CAAA;KAAE,CAAC;IAMtF,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC;QAAE,KAAK,EAAE,YAAY,GAAG,IAAI,CAAA;KAAE,CAAC;IAKxE,GAAG,CAAC,QAAQ,EAAE,gBAAgB,GAAG,OAAO,CAAC,IAAI,CAAC;IAK9C,MAAM,CAAC,QAAQ,EAAE,mBAAmB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKpD,KAAK,CAAC,QAAQ,EAAE,kBAAkB,GAAG,OAAO,CAAC,IAAI,CAAC;IAKlD,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE,MAAM,EAAE,CAAA;KAAE,CAAC;IAK9D,IAAI,CAAC,QAAQ,EAAE,iBAAiB,GAAG,OAAO,CAAC,gBAAgB,CAAC;CAInE"}

package/dist/plugin/web.js

@@ -0,0 +1,35 @@
+/**
+ * Strata Storage Web Implementation
+ * Web platform implementation of the Capacitor plugin
+ */
+export class StrataStorageWeb {
+    async isAvailable(_options) {
+        // Web platform doesn't support native storage types
+        // This is handled by the web adapters instead
+        return { available: false };
+    }
+    async get(_options) {
+        // Not implemented for web - use web adapters instead
+        throw new Error('Native storage not available on web platform');
+    }
+    async set(_options) {
+        // Not implemented for web - use web adapters instead
+        throw new Error('Native storage not available on web platform');
+    }
+    async remove(_options) {
+        // Not implemented for web - use web adapters instead
+        throw new Error('Native storage not available on web platform');
+    }
+    async clear(_options) {
+        // Not implemented for web - use web adapters instead
+        throw new Error('Native storage not available on web platform');
+    }
+    async keys(_options) {
+        // Not implemented for web - use web adapters instead
+        throw new Error('Native storage not available on web platform');
+    }
+    async size(_options) {
+        // Not implemented for web - use web adapters instead
+        throw new Error('Native storage not available on web platform');
+    }
+}