@umituz/react-native-storage 1.0.0

package/lib/infrastructure/repositories/AsyncStorageRepository.js

@@ -0,0 +1,137 @@
+/**
+ * AsyncStorage Repository
+ *
+ * Domain-Driven Design: Infrastructure implementation of IStorageRepository
+ * Adapts React Native AsyncStorage to domain interface
+ */
+import AsyncStorage from '@react-native-async-storage/async-storage';
+import { success, failure } from '../../domain/entities/StorageResult';
+import { StorageReadError, StorageWriteError, StorageDeleteError, StorageSerializationError, StorageDeserializationError, } from '../../domain/errors/StorageError';
+/**
+ * AsyncStorage Repository Implementation
+ */
+export class AsyncStorageRepository {
+    /**
+     * Get item from AsyncStorage with type safety
+     */
+    async getItem(key, defaultValue) {
+        try {
+            const value = await AsyncStorage.getItem(key);
+            if (value === null) {
+                // Missing keys on first app launch are NORMAL, not errors
+                return success(defaultValue);
+            }
+            try {
+                const parsed = JSON.parse(value);
+                return success(parsed);
+            }
+            catch (parseError) {
+                return failure(new StorageDeserializationError(key, parseError), defaultValue);
+            }
+        }
+        catch (error) {
+            return failure(new StorageReadError(key, error), defaultValue);
+        }
+    }
+    /**
+     * Set item in AsyncStorage with automatic JSON serialization
+     */
+    async setItem(key, value) {
+        try {
+            let serialized;
+            try {
+                serialized = JSON.stringify(value);
+            }
+            catch (serializeError) {
+                return failure(new StorageSerializationError(key, serializeError));
+            }
+            await AsyncStorage.setItem(key, serialized);
+            return success(value);
+        }
+        catch (error) {
+            return failure(new StorageWriteError(key, error));
+        }
+    }
+    /**
+     * Get string value (no JSON parsing)
+     */
+    async getString(key, defaultValue) {
+        try {
+            const value = await AsyncStorage.getItem(key);
+            if (value === null) {
+                // Missing keys on first app launch are NORMAL, not errors
+                return success(defaultValue);
+            }
+            return success(value);
+        }
+        catch (error) {
+            return failure(new StorageReadError(key, error), defaultValue);
+        }
+    }
+    /**
+     * Set string value (no JSON serialization)
+     */
+    async setString(key, value) {
+        try {
+            await AsyncStorage.setItem(key, value);
+            return success(value);
+        }
+        catch (error) {
+            return failure(new StorageWriteError(key, error));
+        }
+    }
+    /**
+     * Remove item from AsyncStorage
+     */
+    async removeItem(key) {
+        try {
+            await AsyncStorage.removeItem(key);
+            return success(undefined);
+        }
+        catch (error) {
+            return failure(new StorageDeleteError(key, error));
+        }
+    }
+    /**
+     * Check if key exists in storage
+     */
+    async hasItem(key) {
+        try {
+            const value = await AsyncStorage.getItem(key);
+            return value !== null;
+        }
+        catch {
+            return false;
+        }
+    }
+    /**
+     * Clear all AsyncStorage data (use with caution!)
+     */
+    async clearAll() {
+        try {
+            await AsyncStorage.clear();
+            return success(undefined);
+        }
+        catch (error) {
+            return failure(new StorageDeleteError('ALL_KEYS', error));
+        }
+    }
+    /**
+     * Get multiple items at once (more efficient than multiple getItem calls)
+     */
+    async getMultiple(keys) {
+        try {
+            const pairs = await AsyncStorage.multiGet(keys);
+            const result = Object.fromEntries(pairs);
+            return success(result);
+        }
+        catch (error) {
+            return failure(new StorageReadError('MULTIPLE_KEYS', error));
+        }
+    }
+}
+/**
+ * Singleton instance
+ */
+export const storageRepository = new AsyncStorageRepository();
+//# sourceMappingURL=AsyncStorageRepository.js.map

package/lib/infrastructure/repositories/AsyncStorageRepository.js.map

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

package/lib/presentation/hooks/useStorage.d.ts

@@ -0,0 +1,23 @@
+/**
+ * useStorage Hook
+ *
+ * Domain-Driven Design: Presentation layer hook for storage operations
+ * Provides clean API for components to interact with storage domain
+ */
+import type { StorageResult } from '../../domain/entities/StorageResult';
+import type { StorageKey } from '../../domain/value-objects/StorageKey';
+/**
+ * Storage Hook
+ * Provides type-safe storage operations
+ */
+export declare const useStorage: () => {
+    getItem: <T>(key: string | StorageKey, defaultValue: T) => Promise<T>;
+    setItem: <T>(key: string | StorageKey, value: T) => Promise<boolean>;
+    getString: (key: string | StorageKey, defaultValue: string) => Promise<string>;
+    setString: (key: string | StorageKey, value: string) => Promise<boolean>;
+    removeItem: (key: string | StorageKey) => Promise<boolean>;
+    hasItem: (key: string | StorageKey) => Promise<boolean>;
+    clearAll: () => Promise<boolean>;
+    getItemWithResult: <T>(key: string | StorageKey, defaultValue: T) => Promise<StorageResult<T>>;
+};
+//# sourceMappingURL=useStorage.d.ts.map

package/lib/presentation/hooks/useStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStorage.d.ts","sourceRoot":"","sources":["../../../src/presentation/hooks/useStorage.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAIH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAExE;;;GAGG;AACH,eAAO,MAAM,UAAU;cAIc,CAAC,OAAO,MAAM,GAAG,UAAU,gBAAgB,CAAC,KAAG,OAAO,CAAC,CAAC,CAAC;cASzD,CAAC,OAAO,MAAM,GAAG,UAAU,SAAS,CAAC,KAAG,OAAO,CAAC,OAAO,CAAC;qBASjD,MAAM,GAAG,UAAU,gBAAgB,MAAM,KAAG,OAAO,CAAC,MAAM,CAAC;qBAS3D,MAAM,GAAG,UAAU,SAAS,MAAM,KAAG,OAAO,CAAC,OAAO,CAAC;sBASpD,MAAM,GAAG,UAAU,KAAG,OAAO,CAAC,OAAO,CAAC;mBASzC,MAAM,GAAG,UAAU,KAAG,OAAO,CAAC,OAAO,CAAC;oBAQvC,OAAO,CAAC,OAAO,CAAC;wBAQV,CAAC,OACvC,MAAM,GAAG,UAAU,gBACV,CAAC,KACd,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;CAe7B,CAAC"}

package/lib/presentation/hooks/useStorage.js

@@ -0,0 +1,87 @@
+/**
+ * useStorage Hook
+ *
+ * Domain-Driven Design: Presentation layer hook for storage operations
+ * Provides clean API for components to interact with storage domain
+ */
+import { useCallback } from 'react';
+import { storageRepository } from '../../infrastructure/repositories/AsyncStorageRepository';
+import { unwrap } from '../../domain/entities/StorageResult';
+/**
+ * Storage Hook
+ * Provides type-safe storage operations
+ */
+export const useStorage = () => {
+    /**
+     * Get item from storage
+     */
+    const getItem = useCallback(async (key, defaultValue) => {
+        const keyString = typeof key === 'string' ? key : String(key);
+        const result = await storageRepository.getItem(keyString, defaultValue);
+        return unwrap(result, defaultValue);
+    }, []);
+    /**
+     * Set item in storage
+     */
+    const setItem = useCallback(async (key, value) => {
+        const keyString = typeof key === 'string' ? key : String(key);
+        const result = await storageRepository.setItem(keyString, value);
+        return result.success;
+    }, []);
+    /**
+     * Get string from storage
+     */
+    const getString = useCallback(async (key, defaultValue) => {
+        const keyString = typeof key === 'string' ? key : String(key);
+        const result = await storageRepository.getString(keyString, defaultValue);
+        return unwrap(result, defaultValue);
+    }, []);
+    /**
+     * Set string in storage
+     */
+    const setString = useCallback(async (key, value) => {
+        const keyString = typeof key === 'string' ? key : String(key);
+        const result = await storageRepository.setString(keyString, value);
+        return result.success;
+    }, []);
+    /**
+     * Remove item from storage
+     */
+    const removeItem = useCallback(async (key) => {
+        const keyString = typeof key === 'string' ? key : String(key);
+        const result = await storageRepository.removeItem(keyString);
+        return result.success;
+    }, []);
+    /**
+     * Check if item exists
+     */
+    const hasItem = useCallback(async (key) => {
+        const keyString = typeof key === 'string' ? key : String(key);
+        return storageRepository.hasItem(keyString);
+    }, []);
+    /**
+     * Clear all storage
+     */
+    const clearAll = useCallback(async () => {
+        const result = await storageRepository.clearAll();
+        return result.success;
+    }, []);
+    /**
+     * Get item with full result (success/error)
+     */
+    const getItemWithResult = useCallback(async (key, defaultValue) => {
+        const keyString = typeof key === 'string' ? key : String(key);
+        return storageRepository.getItem(keyString, defaultValue);
+    }, []);
+    return {
+        getItem,
+        setItem,
+        getString,
+        setString,
+        removeItem,
+        hasItem,
+        clearAll,
+        getItemWithResult,
+    };
+};
+//# sourceMappingURL=useStorage.js.map

package/lib/presentation/hooks/useStorage.js.map

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

package/lib/presentation/hooks/useStorageState.d.ts

@@ -0,0 +1,21 @@
+/**
+ * useStorageState Hook
+ *
+ * Domain-Driven Design: Presentation layer hook for state + storage sync
+ * Combines React state with automatic storage persistence
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+import type { StorageKey } from '../../domain/value-objects/StorageKey';
+/**
+ * Storage State Hook
+ * Syncs React state with AsyncStorage automatically
+ *
+ * @example
+ * ```typescript
+ * const [theme, setTheme] = useStorageState(StorageKey.THEME_MODE, 'light');
+ * // State is automatically persisted to storage
+ * ```
+ */
+export declare const useStorageState: <T>(key: string | StorageKey, defaultValue: T) => [T, (value: T) => Promise<void>, boolean];
+//# sourceMappingURL=useStorageState.d.ts.map

package/lib/presentation/hooks/useStorageState.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStorageState.d.ts","sourceRoot":"","sources":["../../../src/presentation/hooks/useStorageState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAKH,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,uCAAuC,CAAC;AAExE;;;;;;;;;GASG;AACH,eAAO,MAAM,eAAe,GAAI,CAAC,EAC/B,KAAK,MAAM,GAAG,UAAU,EACxB,cAAc,CAAC,KACd,CAAC,CAAC,EAAE,CAAC,KAAK,EAAE,CAAC,KAAK,OAAO,CAAC,IAAI,CAAC,EAAE,OAAO,CA2B1C,CAAC"}

package/lib/presentation/hooks/useStorageState.js

@@ -0,0 +1,43 @@
+/**
+ * useStorageState Hook
+ *
+ * Domain-Driven Design: Presentation layer hook for state + storage sync
+ * Combines React state with automatic storage persistence
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+import { useState, useEffect, useCallback } from 'react';
+import { storageRepository } from '../../infrastructure/repositories/AsyncStorageRepository';
+import { unwrap } from '../../domain/entities/StorageResult';
+/**
+ * Storage State Hook
+ * Syncs React state with AsyncStorage automatically
+ *
+ * @example
+ * ```typescript
+ * const [theme, setTheme] = useStorageState(StorageKey.THEME_MODE, 'light');
+ * // State is automatically persisted to storage
+ * ```
+ */
+export const useStorageState = (key, defaultValue) => {
+    const keyString = typeof key === 'string' ? key : String(key);
+    const [state, setState] = useState(defaultValue);
+    const [isLoading, setIsLoading] = useState(true);
+    // Load initial value from storage
+    useEffect(() => {
+        const loadFromStorage = async () => {
+            const result = await storageRepository.getItem(keyString, defaultValue);
+            const value = unwrap(result, defaultValue);
+            setState(value);
+            setIsLoading(false);
+        };
+        loadFromStorage();
+    }, [keyString, defaultValue]);
+    // Update state and persist to storage
+    const updateState = useCallback(async (value) => {
+        setState(value);
+        await storageRepository.setItem(keyString, value);
+    }, [keyString]);
+    return [state, updateState, isLoading];
+};
+//# sourceMappingURL=useStorageState.js.map

package/lib/presentation/hooks/useStorageState.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"useStorageState.js","sourceRoot":"","sources":["../../../src/presentation/hooks/useStorageState.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,MAAM,OAAO,CAAC;AACzD,OAAO,EAAE,iBAAiB,EAAE,MAAM,0DAA0D,CAAC;AAC7F,OAAO,EAAE,MAAM,EAAE,MAAM,qCAAqC,CAAC;AAG7D;;;;;;;;;GASG;AACH,MAAM,CAAC,MAAM,eAAe,GAAG,CAC7B,GAAwB,EACxB,YAAe,EAC4B,EAAE;IAC7C,MAAM,SAAS,GAAG,OAAO,GAAG,KAAK,QAAQ,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC;IAC9D,MAAM,CAAC,KAAK,EAAE,QAAQ,CAAC,GAAG,QAAQ,CAAI,YAAY,CAAC,CAAC;IACpD,MAAM,CAAC,SAAS,EAAE,YAAY,CAAC,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC;IAEjD,kCAAkC;IAClC,SAAS,CAAC,GAAG,EAAE;QACb,MAAM,eAAe,GAAG,KAAK,IAAI,EAAE;YACjC,MAAM,MAAM,GAAG,MAAM,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC;YACxE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,EAAE,YAAY,CAAC,CAAC;YAC3C,QAAQ,CAAC,KAAK,CAAC,CAAC;YAChB,YAAY,CAAC,KAAK,CAAC,CAAC;QACtB,CAAC,CAAC;QAEF,eAAe,EAAE,CAAC;IACpB,CAAC,EAAE,CAAC,SAAS,EAAE,YAAY,CAAC,CAAC,CAAC;IAE9B,sCAAsC;IACtC,MAAM,WAAW,GAAG,WAAW,CAC7B,KAAK,EAAE,KAAQ,EAAE,EAAE;QACjB,QAAQ,CAAC,KAAK,CAAC,CAAC;QAChB,MAAM,iBAAiB,CAAC,OAAO,CAAC,SAAS,EAAE,KAAK,CAAC,CAAC;IACpD,CAAC,EACD,CAAC,SAAS,CAAC,CACZ,CAAC;IAEF,OAAO,CAAC,KAAK,EAAE,WAAW,EAAE,SAAS,CAAC,CAAC;AACzC,CAAC,CAAC"}

package/package.json

@@ -0,0 +1,55 @@
+{
+  "name": "@umituz/react-native-storage",
+  "version": "1.0.0",
+  "description": "Domain-Driven Design storage system for React Native apps with type-safe AsyncStorage operations",
+  "main": "./lib/index.js",
+  "types": "./lib/index.d.ts",
+  "scripts": {
+    "build": "tsc",
+    "typecheck": "tsc --noEmit",
+    "lint": "tsc --noEmit",
+    "clean": "rm -rf lib",
+    "prebuild": "npm run clean",
+    "prepublishOnly": "npm run build",
+    "version:patch": "npm version patch -m 'chore: release v%s'",
+    "version:minor": "npm version minor -m 'chore: release v%s'",
+    "version:major": "npm version major -m 'chore: release v%s'"
+  },
+  "keywords": [
+    "react-native",
+    "storage",
+    "async-storage",
+    "ddd",
+    "domain-driven-design",
+    "type-safe"
+  ],
+  "author": "Ümit UZ <umit@umituz.com>",
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/umituz/react-native-storage"
+  },
+  "peerDependencies": {
+    "@react-native-async-storage/async-storage": "^1.21.0",
+    "react": ">=18.2.0",
+    "react-native": ">=0.74.0"
+  },
+  "devDependencies": {
+    "@react-native-async-storage/async-storage": "^1.24.0",
+    "@types/react": "^18.2.45",
+    "@types/react-native": "^0.73.0",
+    "react": "^18.2.0",
+    "react-native": "^0.74.0",
+    "typescript": "^5.3.3"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "files": [
+    "lib",
+    "src",
+    "README.md",
+    "LICENSE"
+  ]
+}
+

package/src/application/ports/IStorageRepository.ts

@@ -0,0 +1,56 @@
+/**
+ * Storage Repository Interface (Port)
+ *
+ * Domain-Driven Design: Application port for storage operations
+ * Infrastructure layer implements this interface
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+
+import type { StorageResult } from '../../domain/entities/StorageResult';
+
+/**
+ * Storage Repository Interface
+ * Defines contract for storage operations
+ */
+export interface IStorageRepository {
+  /**
+   * Get item from storage with JSON parsing
+   */
+  getItem<T>(key: string, defaultValue: T): Promise<StorageResult<T>>;
+
+  /**
+   * Set item in storage with JSON serialization
+   */
+  setItem<T>(key: string, value: T): Promise<StorageResult<T>>;
+
+  /**
+   * Get string value (no JSON parsing)
+   */
+  getString(key: string, defaultValue: string): Promise<StorageResult<string>>;
+
+  /**
+   * Set string value (no JSON serialization)
+   */
+  setString(key: string, value: string): Promise<StorageResult<string>>;
+
+  /**
+   * Remove item from storage
+   */
+  removeItem(key: string): Promise<StorageResult<void>>;
+
+  /**
+   * Check if key exists in storage
+   */
+  hasItem(key: string): Promise<boolean>;
+
+  /**
+   * Clear all storage data
+   */
+  clearAll(): Promise<StorageResult<void>>;
+
+  /**
+   * Get multiple items at once
+   */
+  getMultiple(keys: string[]): Promise<StorageResult<Record<string, string | null>>>;
+}

package/src/domain/entities/StorageResult.ts

@@ -0,0 +1,58 @@
+/**
+ * Storage Result Entity
+ *
+ * Domain-Driven Design: Entity representing storage operation result
+ * Functional programming pattern for error handling (Result type)
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+
+import type { StorageError } from '../errors/StorageError';
+
+/**
+ * Storage Operation Result
+ * Success/Failure pattern for type-safe error handling
+ */
+export type StorageResult<T> =
+  | { success: true; data: T }
+  | { success: false; error: StorageError; fallback?: T };
+
+/**
+ * Create success result
+ */
+export const success = <T>(data: T): StorageResult<T> => ({
+  success: true,
+  data,
+});
+
+/**
+ * Create failure result
+ */
+export const failure = <T>(error: StorageError, fallback?: T): StorageResult<T> => ({
+  success: false,
+  error,
+  fallback,
+});
+
+/**
+ * Unwrap result with default value
+ */
+export const unwrap = <T>(result: StorageResult<T>, defaultValue: T): T => {
+  if (result.success) {
+    return result.data;
+  }
+  return result.fallback ?? defaultValue;
+};
+
+/**
+ * Map result data
+ */
+export const map = <T, U>(
+  result: StorageResult<T>,
+  fn: (data: T) => U
+): StorageResult<U> => {
+  if (result.success) {
+    return success(fn(result.data));
+  }
+  return result as StorageResult<U>;
+};

package/src/domain/errors/StorageError.ts

@@ -0,0 +1,83 @@
+/**
+ * Storage Error Types
+ *
+ * Domain-Driven Design: Domain errors for storage operations
+ * Typed errors for better error handling and debugging
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+
+/**
+ * Base Storage Error
+ */
+export class StorageError extends Error {
+  constructor(message: string, public readonly key?: string) {
+    super(message);
+    this.name = 'StorageError';
+  }
+}
+
+/**
+ * Storage Read Error
+ */
+export class StorageReadError extends StorageError {
+  public readonly cause?: unknown;
+
+  constructor(key: string, cause?: unknown) {
+    super(`Failed to read from storage: ${key}`, key);
+    this.name = 'StorageReadError';
+    this.cause = cause;
+  }
+}
+
+/**
+ * Storage Write Error
+ */
+export class StorageWriteError extends StorageError {
+  public readonly cause?: unknown;
+
+  constructor(key: string, cause?: unknown) {
+    super(`Failed to write to storage: ${key}`, key);
+    this.name = 'StorageWriteError';
+    this.cause = cause;
+  }
+}
+
+/**
+ * Storage Delete Error
+ */
+export class StorageDeleteError extends StorageError {
+  public readonly cause?: unknown;
+
+  constructor(key: string, cause?: unknown) {
+    super(`Failed to delete from storage: ${key}`, key);
+    this.name = 'StorageDeleteError';
+    this.cause = cause;
+  }
+}
+
+/**
+ * Storage Serialization Error
+ */
+export class StorageSerializationError extends StorageError {
+  public readonly cause?: unknown;
+
+  constructor(key: string, cause?: unknown) {
+    super(`Failed to serialize data for key: ${key}`, key);
+    this.name = 'StorageSerializationError';
+    this.cause = cause;
+  }
+}
+
+/**
+ * Storage Deserialization Error
+ */
+export class StorageDeserializationError extends StorageError {
+  public readonly cause?: unknown;
+
+  constructor(key: string, cause?: unknown) {
+    super(`Failed to deserialize data for key: ${key}`, key);
+    this.name = 'StorageDeserializationError';
+    this.cause = cause;
+  }
+}

package/src/domain/value-objects/StorageKey.ts

@@ -0,0 +1,59 @@
+/**
+ * Storage Key Value Object
+ *
+ * Domain-Driven Design: Value Object for storage keys
+ * Ensures type safety and prevents invalid key usage
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+
+/**
+ * Storage Key Type
+ * All valid storage keys must be defined here
+ */
+export enum StorageKey {
+  // Onboarding
+  ONBOARDING_COMPLETED = '@onboarding_completed',
+
+  // Localization
+  LANGUAGE = '@app_language',
+
+  // Theme
+  THEME_MODE = '@app_theme_mode',
+
+  // Settings (requires userId suffix)
+  SETTINGS = 'app_settings',
+
+  // Query Cache (requires app name prefix)
+  QUERY_CACHE = '{{APP_NAME}}_query_cache',
+}
+
+/**
+ * Storage key with dynamic suffix
+ */
+export type DynamicStorageKey = {
+  base: StorageKey;
+  suffix: string;
+};
+
+/**
+ * Helper to create user-specific storage key
+ *
+ * @param baseKey Base storage key
+ * @param userId User identifier
+ * @returns User-specific key
+ */
+export const createUserKey = (baseKey: StorageKey, userId: string): string => {
+  return `${baseKey}_${userId}`;
+};
+
+/**
+ * Helper to create app-specific storage key
+ *
+ * @param baseKey Base storage key
+ * @param appName App identifier
+ * @returns App-specific key
+ */
+export const createAppKey = (baseKey: StorageKey, appName: string): string => {
+  return `${appName}_${baseKey}`;
+};