strata-storage 1.0.0

package/dist/types/index.d.ts

@@ -0,0 +1,558 @@
+/**
+ * Core type definitions for Strata Storage
+ * Zero dependencies - all types defined from scratch
+ */
+/**
+ * Supported storage types across all platforms
+ */
+export type StorageType = 'memory' | 'localStorage' | 'sessionStorage' | 'indexedDB' | 'cookies' | 'cache' | 'preferences' | 'sqlite' | 'filesystem' | 'secure';
+/**
+ * Platform types
+ */
+export type Platform = 'web' | 'ios' | 'android' | 'node' | 'auto';
+/**
+ * Storage strategies for automatic adapter selection
+ */
+export declare enum StorageStrategy {
+    PERFORMANCE_FIRST = "performance_first",
+    PERSISTENCE_FIRST = "persistence_first",
+    SECURITY_FIRST = "security_first",
+    CAPACITY_FIRST = "capacity_first"
+}
+/**
+ * Options for storage operations
+ */
+export interface StorageOptions {
+    /**
+     * Storage type to use (overrides default)
+     */
+    storage?: StorageType | StorageType[];
+    /**
+     * Enable encryption for this operation
+     */
+    encrypt?: boolean;
+    /**
+     * Password for encryption/decryption
+     */
+    encryptionPassword?: string;
+    /**
+     * Skip decryption when reading encrypted values
+     */
+    skipDecryption?: boolean;
+    /**
+     * Ignore decryption errors and return null instead
+     */
+    ignoreDecryptionErrors?: boolean;
+    /**
+     * Enable compression for this operation
+     */
+    compress?: boolean;
+    /**
+     * Time to live in milliseconds
+     */
+    ttl?: number;
+    /**
+     * Sliding expiration - reset TTL on access
+     */
+    sliding?: boolean;
+    /**
+     * Expire at specific time (overrides ttl)
+     */
+    expireAt?: Date | number;
+    /**
+     * Expire after a certain date
+     */
+    expireAfter?: Date | number;
+    /**
+     * Tags for grouping and querying
+     */
+    tags?: string[];
+    /**
+     * Namespace for isolation
+     */
+    namespace?: string;
+    /**
+     * Metadata to attach
+     */
+    metadata?: Record<string, unknown>;
+}
+/**
+ * Storage value with metadata
+ */
+export interface StorageValue<T = unknown> {
+    /**
+     * The actual stored value
+     */
+    value: T;
+    /**
+     * Creation timestamp
+     */
+    created: number;
+    /**
+     * Last update timestamp
+     */
+    updated: number;
+    /**
+     * Expiration timestamp (if TTL is set)
+     */
+    expires?: number;
+    /**
+     * Tags for grouping
+     */
+    tags?: string[];
+    /**
+     * Custom metadata
+     */
+    metadata?: Record<string, unknown>;
+    /**
+     * Whether value is encrypted
+     */
+    encrypted?: boolean;
+    /**
+     * Whether value is compressed
+     */
+    compressed?: boolean;
+}
+/**
+ * Storage change event
+ */
+export interface StorageChange<T = unknown> {
+    /**
+     * The key that changed
+     */
+    key: string;
+    /**
+     * Old value (if available)
+     */
+    oldValue?: T;
+    /**
+     * New value (if available)
+     */
+    newValue?: T;
+    /**
+     * Source of the change
+     */
+    source: 'local' | 'remote' | 'sync';
+    /**
+     * Storage type where change occurred
+     */
+    storage: StorageType;
+    /**
+     * Timestamp of change
+     */
+    timestamp: number;
+}
+/**
+ * Subscription callback
+ */
+export type SubscriptionCallback<T = unknown> = (change: StorageChange<T>) => void;
+/**
+ * Unsubscribe function
+ */
+export type UnsubscribeFunction = () => void;
+/**
+ * Query operators for advanced operations
+ */
+export interface QueryOperators {
+    $eq?: unknown;
+    $ne?: unknown;
+    $gt?: number | string;
+    $gte?: number | string;
+    $lt?: number | string;
+    $lte?: number | string;
+    $in?: unknown[];
+    $nin?: unknown[];
+    $regex?: string | RegExp;
+    $exists?: boolean;
+    $type?: string;
+    $and?: QueryCondition[];
+    $or?: QueryCondition[];
+    $not?: QueryCondition;
+}
+/**
+ * Query condition
+ */
+export type QueryCondition = {
+    [key: string]: unknown | QueryOperators;
+};
+/**
+ * Clear options
+ */
+export interface ClearOptions {
+    /**
+     * Pattern to match keys (glob or regex)
+     */
+    pattern?: string | RegExp;
+    /**
+     * Tags to filter by
+     */
+    tags?: string[];
+    /**
+     * Only clear expired items
+     */
+    expiredOnly?: boolean;
+    /**
+     * Namespace to clear
+     */
+    namespace?: string;
+}
+/**
+ * Size information
+ */
+export interface SizeInfo {
+    /**
+     * Total size in bytes
+     */
+    total: number;
+    /**
+     * Size by storage type
+     */
+    byStorage?: Record<StorageType, number>;
+    /**
+     * Number of items
+     */
+    count: number;
+    /**
+     * Detailed breakdown
+     */
+    detailed?: {
+        keys: number;
+        values: number;
+        metadata: number;
+    };
+}
+/**
+ * Storage adapter capabilities
+ */
+export interface StorageCapabilities {
+    /**
+     * Supports persistence across sessions
+     */
+    persistent: boolean;
+    /**
+     * Supports synchronous operations
+     */
+    synchronous: boolean;
+    /**
+     * Supports subscriptions/watching
+     */
+    observable: boolean;
+    /**
+     * Supports transactions
+     */
+    transactional: boolean;
+    /**
+     * Supports querying
+     */
+    queryable: boolean;
+    /**
+     * Maximum storage size (bytes, -1 for unlimited)
+     */
+    maxSize: number;
+    /**
+     * Supports binary data
+     */
+    binary: boolean;
+    /**
+     * Supports encryption
+     */
+    encrypted: boolean;
+    /**
+     * Cross-tab/window support
+     */
+    crossTab: boolean;
+}
+/**
+ * Strata configuration
+ */
+export interface StrataConfig {
+    /**
+     * Target platform
+     */
+    platform?: Platform;
+    /**
+     * Storage selection strategy
+     */
+    strategy?: StorageStrategy;
+    /**
+     * Default storage types in order of preference
+     */
+    defaultStorages?: StorageType[];
+    /**
+     * Adapter configuration
+     */
+    adapters?: {
+        memory?: boolean | {
+            maxSize?: number;
+        };
+        localStorage?: boolean | {
+            prefix?: string;
+        };
+        sessionStorage?: boolean | {
+            prefix?: string;
+        };
+        indexedDB?: boolean | {
+            dbName?: string;
+            version?: number;
+        };
+        cookies?: boolean | {
+            secure?: boolean;
+            sameSite?: 'strict' | 'lax' | 'none';
+        };
+        cache?: boolean | {
+            cacheName?: string;
+        };
+        preferences?: boolean;
+        sqlite?: boolean | {
+            filename?: string;
+        };
+        filesystem?: boolean | {
+            directory?: string;
+        };
+        secure?: boolean;
+    };
+    /**
+     * Native configuration (for mobile platforms)
+     */
+    native?: {
+        preferences?: boolean;
+        sqlite?: boolean;
+        secure?: boolean;
+        filesystem?: boolean;
+    };
+    /**
+     * Sync configuration
+     */
+    sync?: {
+        enabled?: boolean;
+        storages?: StorageType[];
+        interval?: number;
+        conflictResolution?: 'latest' | 'merge' | ((conflicts: unknown[]) => unknown);
+    };
+    /**
+     * Cache configuration
+     */
+    cache?: {
+        enabled?: boolean;
+        maxSize?: string | number;
+        ttl?: number;
+    };
+    /**
+     * Compression configuration
+     */
+    compression?: {
+        enabled?: boolean;
+        threshold?: number;
+        algorithm?: 'lz' | 'gzip';
+    };
+    /**
+     * Encryption configuration
+     */
+    encryption?: {
+        enabled?: boolean;
+        algorithm?: 'AES-GCM' | 'AES-CBC';
+        password?: string;
+        keyLength?: 128 | 192 | 256;
+        iterations?: number;
+        saltLength?: number;
+        keyDerivation?: 'PBKDF2' | 'scrypt';
+    };
+    /**
+     * TTL (Time To Live) configuration
+     */
+    ttl?: {
+        /**
+         * Default TTL in milliseconds
+         */
+        defaultTTL?: number;
+        /**
+         * Cleanup interval in milliseconds (default: 60000 - 1 minute)
+         */
+        cleanupInterval?: number;
+        /**
+         * Enable automatic cleanup (default: true)
+         */
+        autoCleanup?: boolean;
+        /**
+         * Maximum number of items to check per cleanup cycle
+         */
+        batchSize?: number;
+        /**
+         * Callback when items expire
+         */
+        onExpire?: (keys: string[]) => void;
+    };
+    /**
+     * Debug configuration
+     */
+    debug?: {
+        enabled?: boolean;
+        verbosity?: 'minimal' | 'normal' | 'verbose';
+        logOperations?: boolean;
+        logPerformance?: boolean;
+    };
+    /**
+     * Performance configuration
+     */
+    performance?: {
+        slowThreshold?: number;
+        batchSize?: number;
+    };
+}
+/**
+ * Storage adapter interface - all adapters must implement this
+ */
+export interface StorageAdapter {
+    /**
+     * Adapter name
+     */
+    readonly name: StorageType;
+    /**
+     * Adapter capabilities
+     */
+    readonly capabilities: StorageCapabilities;
+    /**
+     * Check if adapter is available on current platform
+     */
+    isAvailable(): Promise<boolean>;
+    /**
+     * Initialize the adapter
+     */
+    initialize(config?: unknown): Promise<void>;
+    /**
+     * Get a value
+     */
+    get<T = unknown>(key: string): Promise<StorageValue<T> | null>;
+    /**
+     * Set a value
+     */
+    set<T = unknown>(key: string, value: StorageValue<T>): Promise<void>;
+    /**
+     * Remove a value
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Clear all or matching values
+     */
+    clear(options?: ClearOptions): Promise<void>;
+    /**
+     * Check if key exists
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * Get all keys
+     */
+    keys(pattern?: string | RegExp): Promise<string[]>;
+    /**
+     * Get storage size
+     */
+    size(detailed?: boolean): Promise<SizeInfo>;
+    /**
+     * Subscribe to changes
+     */
+    subscribe?(callback: SubscriptionCallback): UnsubscribeFunction;
+    /**
+     * Query values (if supported)
+     */
+    query?<T = unknown>(condition: QueryCondition): Promise<Array<{
+        key: string;
+        value: T;
+    }>>;
+    /**
+     * Begin transaction (if supported)
+     */
+    transaction?(): Promise<Transaction>;
+    /**
+     * Close/cleanup adapter
+     */
+    close?(): Promise<void>;
+}
+/**
+ * Transaction interface for atomic operations
+ */
+export interface Transaction {
+    /**
+     * Get within transaction
+     */
+    get<T = unknown>(key: string): Promise<T | null>;
+    /**
+     * Set within transaction
+     */
+    set<T = unknown>(key: string, value: T): Promise<void>;
+    /**
+     * Remove within transaction
+     */
+    remove(key: string): Promise<void>;
+    /**
+     * Commit transaction
+     */
+    commit(): Promise<void>;
+    /**
+     * Rollback transaction
+     */
+    rollback(): Promise<void>;
+}
+/**
+ * Migration interface
+ */
+export interface Migration {
+    /**
+     * Migration version
+     */
+    version: number;
+    /**
+     * Migration description
+     */
+    description?: string;
+    /**
+     * Run the migration
+     */
+    up(storage: StorageAdapter): Promise<void>;
+    /**
+     * Rollback the migration
+     */
+    down?(storage: StorageAdapter): Promise<void>;
+}
+/**
+ * Export/Import formats
+ */
+export type ExportFormat = 'json' | 'csv' | 'sql' | 'binary';
+/**
+ * Export options
+ */
+export interface ExportOptions {
+    /**
+     * Format to export in
+     */
+    format?: ExportFormat;
+    /**
+     * Include metadata
+     */
+    includeMetadata?: boolean;
+    /**
+     * Keys to export (all if not specified)
+     */
+    keys?: string[];
+    /**
+     * Pretty print JSON
+     */
+    pretty?: boolean;
+}
+/**
+ * Import options
+ */
+export interface ImportOptions {
+    /**
+     * Format to import from
+     */
+    format?: ExportFormat;
+    /**
+     * Overwrite existing keys
+     */
+    overwrite?: boolean;
+    /**
+     * Merge strategy
+     */
+    merge?: 'replace' | 'deep' | 'shallow';
+}
+//# sourceMappingURL=index.d.ts.map

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

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

package/dist/types/index.js

@@ -0,0 +1,14 @@
+/**
+ * Core type definitions for Strata Storage
+ * Zero dependencies - all types defined from scratch
+ */
+/**
+ * Storage strategies for automatic adapter selection
+ */
+export var StorageStrategy;
+(function (StorageStrategy) {
+    StorageStrategy["PERFORMANCE_FIRST"] = "performance_first";
+    StorageStrategy["PERSISTENCE_FIRST"] = "persistence_first";
+    StorageStrategy["SECURITY_FIRST"] = "security_first";
+    StorageStrategy["CAPACITY_FIRST"] = "capacity_first";
+})(StorageStrategy || (StorageStrategy = {}));

package/dist/utils/errors.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Custom error classes for Strata Storage
+ */
+/**
+ * Base error class for all Strata errors
+ */
+export declare class StrataError extends Error {
+    readonly code: string;
+    readonly details?: unknown;
+    constructor(message: string, code: string, details?: unknown);
+}
+/**
+ * Error thrown when storage quota is exceeded
+ */
+export declare class QuotaExceededError extends StrataError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Error thrown when adapter is not available
+ */
+export declare class AdapterNotAvailableError extends StrataError {
+    constructor(adapterName: string, details?: unknown);
+}
+/**
+ * Error thrown when operation is not supported
+ */
+export declare class NotSupportedError extends StrataError {
+    constructor(operation: string, adapterName?: string, details?: unknown);
+}
+/**
+ * Error thrown when encryption fails
+ */
+export declare class EncryptionError extends StrataError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Error thrown when compression fails
+ */
+export declare class CompressionError extends StrataError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Error thrown when serialization fails
+ */
+export declare class SerializationError extends StrataError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Error thrown when validation fails
+ */
+export declare class ValidationError extends StrataError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error thrown when transaction fails
+ */
+export declare class TransactionError extends StrataError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Error thrown when migration fails
+ */
+export declare class MigrationError extends StrataError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error thrown when sync operation fails
+ */
+export declare class SyncError extends StrataError {
+    constructor(message?: string, details?: unknown);
+}
+/**
+ * Check if error is a Strata error
+ */
+export declare function isStrataError(error: unknown): error is StrataError;
+/**
+ * General storage error
+ */
+export declare class StorageError extends StrataError {
+    constructor(message: string, details?: unknown);
+}
+/**
+ * Error thrown when a key is not found
+ */
+export declare class NotFoundError extends StrataError {
+    constructor(key: string, details?: unknown);
+}
+/**
+ * Check if error is a quota exceeded error
+ */
+export declare function isQuotaError(error: unknown): boolean;
+//# sourceMappingURL=errors.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"errors.d.ts","sourceRoot":"","sources":["../../src/utils/errors.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;GAEG;AACH,qBAAa,WAAY,SAAQ,KAAK;IACpC,SAAgB,IAAI,EAAE,MAAM,CAAC;IAC7B,SAAgB,OAAO,CAAC,EAAE,OAAO,CAAC;gBAEtB,OAAO,EAAE,MAAM,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAW7D;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,SAA2B,EAAE,OAAO,CAAC,EAAE,OAAO;CAIlE;AAED;;GAEG;AACH,qBAAa,wBAAyB,SAAQ,WAAW;gBAC3C,WAAW,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAInD;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,WAAW;gBACpC,SAAS,EAAE,MAAM,EAAE,WAAW,CAAC,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAOvE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,SAAgC,EAAE,OAAO,CAAC,EAAE,OAAO;CAIvE;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,OAAO,SAAiC,EAAE,OAAO,CAAC,EAAE,OAAO;CAIxE;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,WAAW;gBACrC,OAAO,SAAyB,EAAE,OAAO,CAAC,EAAE,OAAO;CAIhE;AAED;;GAEG;AACH,qBAAa,eAAgB,SAAQ,WAAW;gBAClC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,WAAW;gBACnC,OAAO,SAAuB,EAAE,OAAO,CAAC,EAAE,OAAO;CAI9D;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,WAAW;gBACjC,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,SAAU,SAAQ,WAAW;gBAC5B,OAAO,SAA0B,EAAE,OAAO,CAAC,EAAE,OAAO;CAIjE;AAED;;GAEG;AACH,wBAAgB,aAAa,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,WAAW,CAElE;AAED;;GAEG;AACH,qBAAa,YAAa,SAAQ,WAAW;gBAC/B,OAAO,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI/C;AAED;;GAEG;AACH,qBAAa,aAAc,SAAQ,WAAW;gBAChC,GAAG,EAAE,MAAM,EAAE,OAAO,CAAC,EAAE,OAAO;CAI3C;AAED;;GAEG;AACH,wBAAgB,YAAY,CAAC,KAAK,EAAE,OAAO,GAAG,OAAO,CAepD"}