@umituz/react-native-storage 1.0.0

package/LICENSE

@@ -0,0 +1,22 @@
+MIT License
+
+Copyright (c) 2024 Ümit UZ
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.
+

package/README.md

@@ -0,0 +1,102 @@
+# @umituz/react-native-storage
+
+Domain-Driven Design storage system for React Native apps with type-safe AsyncStorage operations.
+
+## Installation
+
+```bash
+npm install @umituz/react-native-storage
+```
+
+## Peer Dependencies
+
+- `react` >= 18.2.0
+- `react-native` >= 0.74.0
+- `@react-native-async-storage/async-storage` >= 1.21.0
+
+## Features
+
+- ✅ Domain-Driven Design (DDD) architecture
+- ✅ Type-safe storage operations
+- ✅ Result-based error handling
+- ✅ React hooks for easy integration
+- ✅ Storage key management utilities
+- ✅ Automatic serialization/deserialization
+
+## Usage
+
+### Basic Usage with Hook
+
+```typescript
+import { useStorage, StorageKey } from '@umituz/react-native-storage';
+
+const MyComponent = () => {
+  const storage = useStorage();
+
+  // Get item
+  const value = await storage.getItem('my-key', 'default-value');
+
+  // Set item
+  await storage.setItem('my-key', 'my-value');
+
+  // Remove item
+  await storage.removeItem('my-key');
+
+  // Clear all
+  await storage.clear();
+};
+```
+
+### Using Storage Keys
+
+```typescript
+import { StorageKey, createUserKey, createAppKey } from '@umituz/react-native-storage';
+
+// Create typed storage keys
+const userKey = createUserKey('preferences');
+const appKey = createAppKey('settings');
+
+// Use with storage
+const storage = useStorage();
+await storage.setItem(userKey, { theme: 'dark' });
+```
+
+### Using Storage State Hook
+
+```typescript
+import { useStorageState } from '@umituz/react-native-storage';
+
+const MyComponent = () => {
+  const [value, setValue, isLoading] = useStorageState('my-key', 'default');
+
+  return (
+    <View>
+      <Text>{value}</Text>
+      <Button onPress={() => setValue('new-value')} />
+    </View>
+  );
+};
+```
+
+## API
+
+### Hooks
+
+- `useStorage()`: Main storage hook for CRUD operations
+- `useStorageState(key, defaultValue)`: React state hook with storage persistence
+
+### Utilities
+
+- `StorageKey`: Type-safe storage key class
+- `createUserKey(key)`: Create user-specific storage key
+- `createAppKey(key)`: Create app-wide storage key
+
+### Repository
+
+- `storageRepository`: Direct access to storage repository
+- `AsyncStorageRepository`: Repository implementation class
+
+## License
+
+MIT
+

package/lib/application/ports/IStorageRepository.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 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>>>;
+}
+//# sourceMappingURL=IStorageRepository.d.ts.map

package/lib/application/ports/IStorageRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStorageRepository.d.ts","sourceRoot":"","sources":["../../../src/application/ports/IStorageRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAEzE;;;GAGG;AACH,MAAM,WAAW,kBAAkB;IACjC;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAEpE;;OAEG;IACH,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC,CAAC;IAE7D;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAE7E;;OAEG;IACH,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC,CAAC;IAEtE;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAEtD;;OAEG;IACH,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAC;IAEvC;;OAEG;IACH,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC,CAAC;IAEzC;;OAEG;IACH,WAAW,CAAC,IAAI,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;CACpF"}

package/lib/application/ports/IStorageRepository.js

@@ -0,0 +1,10 @@
+/**
+ * Storage Repository Interface (Port)
+ *
+ * Domain-Driven Design: Application port for storage operations
+ * Infrastructure layer implements this interface
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+export {};
+//# sourceMappingURL=IStorageRepository.js.map

package/lib/application/ports/IStorageRepository.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"IStorageRepository.js","sourceRoot":"","sources":["../../../src/application/ports/IStorageRepository.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG"}

package/lib/domain/entities/StorageResult.d.ts

@@ -0,0 +1,38 @@
+/**
+ * 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 declare const success: <T>(data: T) => StorageResult<T>;
+/**
+ * Create failure result
+ */
+export declare const failure: <T>(error: StorageError, fallback?: T) => StorageResult<T>;
+/**
+ * Unwrap result with default value
+ */
+export declare const unwrap: <T>(result: StorageResult<T>, defaultValue: T) => T;
+/**
+ * Map result data
+ */
+export declare const map: <T, U>(result: StorageResult<T>, fn: (data: T) => U) => StorageResult<U>;
+//# sourceMappingURL=StorageResult.d.ts.map

package/lib/domain/entities/StorageResult.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageResult.d.ts","sourceRoot":"","sources":["../../../src/domain/entities/StorageResult.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,wBAAwB,CAAC;AAE3D;;;GAGG;AACH,MAAM,MAAM,aAAa,CAAC,CAAC,IACvB;IAAE,OAAO,EAAE,IAAI,CAAC;IAAC,IAAI,EAAE,CAAC,CAAA;CAAE,GAC1B;IAAE,OAAO,EAAE,KAAK,CAAC;IAAC,KAAK,EAAE,YAAY,CAAC;IAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;CAAE,CAAC;AAE1D;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,MAAM,CAAC,KAAG,aAAa,CAAC,CAAC,CAGlD,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,OAAO,GAAI,CAAC,EAAE,OAAO,YAAY,EAAE,WAAW,CAAC,KAAG,aAAa,CAAC,CAAC,CAI5E,CAAC;AAEH;;GAEG;AACH,eAAO,MAAM,MAAM,GAAI,CAAC,EAAE,QAAQ,aAAa,CAAC,CAAC,CAAC,EAAE,cAAc,CAAC,KAAG,CAKrE,CAAC;AAEF;;GAEG;AACH,eAAO,MAAM,GAAG,GAAI,CAAC,EAAE,CAAC,EACtB,QAAQ,aAAa,CAAC,CAAC,CAAC,EACxB,IAAI,CAAC,IAAI,EAAE,CAAC,KAAK,CAAC,KACjB,aAAa,CAAC,CAAC,CAKjB,CAAC"}

package/lib/domain/entities/StorageResult.js

@@ -0,0 +1,42 @@
+/**
+ * Storage Result Entity
+ *
+ * Domain-Driven Design: Entity representing storage operation result
+ * Functional programming pattern for error handling (Result type)
+ *
+ * Theme: {{THEME_NAME}} ({{CATEGORY}} category)
+ */
+/**
+ * Create success result
+ */
+export const success = (data) => ({
+    success: true,
+    data,
+});
+/**
+ * Create failure result
+ */
+export const failure = (error, fallback) => ({
+    success: false,
+    error,
+    fallback,
+});
+/**
+ * Unwrap result with default value
+ */
+export const unwrap = (result, defaultValue) => {
+    if (result.success) {
+        return result.data;
+    }
+    return result.fallback ?? defaultValue;
+};
+/**
+ * Map result data
+ */
+export const map = (result, fn) => {
+    if (result.success) {
+        return success(fn(result.data));
+    }
+    return result;
+};
+//# sourceMappingURL=StorageResult.js.map

package/lib/domain/entities/StorageResult.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageResult.js","sourceRoot":"","sources":["../../../src/domain/entities/StorageResult.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAYH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAI,IAAO,EAAoB,EAAE,CAAC,CAAC;IACxD,OAAO,EAAE,IAAI;IACb,IAAI;CACL,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAI,KAAmB,EAAE,QAAY,EAAoB,EAAE,CAAC,CAAC;IAClF,OAAO,EAAE,KAAK;IACd,KAAK;IACL,QAAQ;CACT,CAAC,CAAC;AAEH;;GAEG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAI,MAAwB,EAAE,YAAe,EAAK,EAAE;IACxE,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,MAAM,CAAC,IAAI,CAAC;IACrB,CAAC;IACD,OAAO,MAAM,CAAC,QAAQ,IAAI,YAAY,CAAC;AACzC,CAAC,CAAC;AAEF;;GAEG;AACH,MAAM,CAAC,MAAM,GAAG,GAAG,CACjB,MAAwB,EACxB,EAAkB,EACA,EAAE;IACpB,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;QACnB,OAAO,OAAO,CAAC,EAAE,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC;IAClC,CAAC;IACD,OAAO,MAA0B,CAAC;AACpC,CAAC,CAAC"}

package/lib/domain/errors/StorageError.d.ts

@@ -0,0 +1,51 @@
+/**
+ * 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 declare class StorageError extends Error {
+    readonly key?: string | undefined;
+    constructor(message: string, key?: string | undefined);
+}
+/**
+ * Storage Read Error
+ */
+export declare class StorageReadError extends StorageError {
+    readonly cause?: unknown;
+    constructor(key: string, cause?: unknown);
+}
+/**
+ * Storage Write Error
+ */
+export declare class StorageWriteError extends StorageError {
+    readonly cause?: unknown;
+    constructor(key: string, cause?: unknown);
+}
+/**
+ * Storage Delete Error
+ */
+export declare class StorageDeleteError extends StorageError {
+    readonly cause?: unknown;
+    constructor(key: string, cause?: unknown);
+}
+/**
+ * Storage Serialization Error
+ */
+export declare class StorageSerializationError extends StorageError {
+    readonly cause?: unknown;
+    constructor(key: string, cause?: unknown);
+}
+/**
+ * Storage Deserialization Error
+ */
+export declare class StorageDeserializationError extends StorageError {
+    readonly cause?: unknown;
+    constructor(key: string, cause?: unknown);
+}
+//# sourceMappingURL=StorageError.d.ts.map

package/lib/domain/errors/StorageError.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageError.d.ts","sourceRoot":"","sources":["../../../src/domain/errors/StorageError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,qBAAa,YAAa,SAAQ,KAAK;aACQ,GAAG,CAAC,EAAE,MAAM;gBAA7C,OAAO,EAAE,MAAM,EAAkB,GAAG,CAAC,EAAE,MAAM,YAAA;CAI1D;AAED;;GAEG;AACH,qBAAa,gBAAiB,SAAQ,YAAY;IAChD,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKzC;AAED;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,YAAY;IACjD,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKzC;AAED;;GAEG;AACH,qBAAa,kBAAmB,SAAQ,YAAY;IAClD,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKzC;AAED;;GAEG;AACH,qBAAa,yBAA0B,SAAQ,YAAY;IACzD,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKzC;AAED;;GAEG;AACH,qBAAa,2BAA4B,SAAQ,YAAY;IAC3D,SAAgB,KAAK,CAAC,EAAE,OAAO,CAAC;gBAEpB,GAAG,EAAE,MAAM,EAAE,KAAK,CAAC,EAAE,OAAO;CAKzC"}

package/lib/domain/errors/StorageError.js

@@ -0,0 +1,69 @@
+/**
+ * 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, key) {
+        super(message);
+        this.key = key;
+        this.name = 'StorageError';
+    }
+}
+/**
+ * Storage Read Error
+ */
+export class StorageReadError extends StorageError {
+    constructor(key, cause) {
+        super(`Failed to read from storage: ${key}`, key);
+        this.name = 'StorageReadError';
+        this.cause = cause;
+    }
+}
+/**
+ * Storage Write Error
+ */
+export class StorageWriteError extends StorageError {
+    constructor(key, cause) {
+        super(`Failed to write to storage: ${key}`, key);
+        this.name = 'StorageWriteError';
+        this.cause = cause;
+    }
+}
+/**
+ * Storage Delete Error
+ */
+export class StorageDeleteError extends StorageError {
+    constructor(key, cause) {
+        super(`Failed to delete from storage: ${key}`, key);
+        this.name = 'StorageDeleteError';
+        this.cause = cause;
+    }
+}
+/**
+ * Storage Serialization Error
+ */
+export class StorageSerializationError extends StorageError {
+    constructor(key, cause) {
+        super(`Failed to serialize data for key: ${key}`, key);
+        this.name = 'StorageSerializationError';
+        this.cause = cause;
+    }
+}
+/**
+ * Storage Deserialization Error
+ */
+export class StorageDeserializationError extends StorageError {
+    constructor(key, cause) {
+        super(`Failed to deserialize data for key: ${key}`, key);
+        this.name = 'StorageDeserializationError';
+        this.cause = cause;
+    }
+}
+//# sourceMappingURL=StorageError.js.map

package/lib/domain/errors/StorageError.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageError.js","sourceRoot":"","sources":["../../../src/domain/errors/StorageError.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;GAEG;AACH,MAAM,OAAO,YAAa,SAAQ,KAAK;IACrC,YAAY,OAAe,EAAkB,GAAY;QACvD,KAAK,CAAC,OAAO,CAAC,CAAC;QAD4B,QAAG,GAAH,GAAG,CAAS;QAEvD,IAAI,CAAC,IAAI,GAAG,cAAc,CAAC;IAC7B,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,gBAAiB,SAAQ,YAAY;IAGhD,YAAY,GAAW,EAAE,KAAe;QACtC,KAAK,CAAC,gCAAgC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QAClD,IAAI,CAAC,IAAI,GAAG,kBAAkB,CAAC;QAC/B,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,iBAAkB,SAAQ,YAAY;IAGjD,YAAY,GAAW,EAAE,KAAe;QACtC,KAAK,CAAC,+BAA+B,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QACjD,IAAI,CAAC,IAAI,GAAG,mBAAmB,CAAC;QAChC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,kBAAmB,SAAQ,YAAY;IAGlD,YAAY,GAAW,EAAE,KAAe;QACtC,KAAK,CAAC,kCAAkC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QACpD,IAAI,CAAC,IAAI,GAAG,oBAAoB,CAAC;QACjC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,yBAA0B,SAAQ,YAAY;IAGzD,YAAY,GAAW,EAAE,KAAe;QACtC,KAAK,CAAC,qCAAqC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QACvD,IAAI,CAAC,IAAI,GAAG,2BAA2B,CAAC;QACxC,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF;AAED;;GAEG;AACH,MAAM,OAAO,2BAA4B,SAAQ,YAAY;IAG3D,YAAY,GAAW,EAAE,KAAe;QACtC,KAAK,CAAC,uCAAuC,GAAG,EAAE,EAAE,GAAG,CAAC,CAAC;QACzD,IAAI,CAAC,IAAI,GAAG,6BAA6B,CAAC;QAC1C,IAAI,CAAC,KAAK,GAAG,KAAK,CAAC;IACrB,CAAC;CACF"}

package/lib/domain/value-objects/StorageKey.d.ts

@@ -0,0 +1,43 @@
+/**
+ * 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 declare enum StorageKey {
+    ONBOARDING_COMPLETED = "@onboarding_completed",
+    LANGUAGE = "@app_language",
+    THEME_MODE = "@app_theme_mode",
+    SETTINGS = "app_settings",
+    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 declare const createUserKey: (baseKey: StorageKey, userId: string) => string;
+/**
+ * Helper to create app-specific storage key
+ *
+ * @param baseKey Base storage key
+ * @param appName App identifier
+ * @returns App-specific key
+ */
+export declare const createAppKey: (baseKey: StorageKey, appName: string) => string;
+//# sourceMappingURL=StorageKey.d.ts.map

package/lib/domain/value-objects/StorageKey.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageKey.d.ts","sourceRoot":"","sources":["../../../src/domain/value-objects/StorageKey.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,oBAAY,UAAU;IAEpB,oBAAoB,0BAA0B;IAG9C,QAAQ,kBAAkB;IAG1B,UAAU,oBAAoB;IAG9B,QAAQ,iBAAiB;IAGzB,WAAW,6BAA6B;CACzC;AAED;;GAEG;AACH,MAAM,MAAM,iBAAiB,GAAG;IAC9B,IAAI,EAAE,UAAU,CAAC;IACjB,MAAM,EAAE,MAAM,CAAC;CAChB,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,aAAa,GAAI,SAAS,UAAU,EAAE,QAAQ,MAAM,KAAG,MAEnE,CAAC;AAEF;;;;;;GAMG;AACH,eAAO,MAAM,YAAY,GAAI,SAAS,UAAU,EAAE,SAAS,MAAM,KAAG,MAEnE,CAAC"}

package/lib/domain/value-objects/StorageKey.js

@@ -0,0 +1,46 @@
+/**
+ * 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 var StorageKey;
+(function (StorageKey) {
+    // Onboarding
+    StorageKey["ONBOARDING_COMPLETED"] = "@onboarding_completed";
+    // Localization
+    StorageKey["LANGUAGE"] = "@app_language";
+    // Theme
+    StorageKey["THEME_MODE"] = "@app_theme_mode";
+    // Settings (requires userId suffix)
+    StorageKey["SETTINGS"] = "app_settings";
+    // Query Cache (requires app name prefix)
+    StorageKey["QUERY_CACHE"] = "{{APP_NAME}}_query_cache";
+})(StorageKey || (StorageKey = {}));
+/**
+ * Helper to create user-specific storage key
+ *
+ * @param baseKey Base storage key
+ * @param userId User identifier
+ * @returns User-specific key
+ */
+export const createUserKey = (baseKey, userId) => {
+    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, appName) => {
+    return `${appName}_${baseKey}`;
+};
+//# sourceMappingURL=StorageKey.js.map

package/lib/domain/value-objects/StorageKey.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"StorageKey.js","sourceRoot":"","sources":["../../../src/domain/value-objects/StorageKey.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH;;;GAGG;AACH,MAAM,CAAN,IAAY,UAeX;AAfD,WAAY,UAAU;IACpB,aAAa;IACb,4DAA8C,CAAA;IAE9C,eAAe;IACf,wCAA0B,CAAA;IAE1B,QAAQ;IACR,4CAA8B,CAAA;IAE9B,oCAAoC;IACpC,uCAAyB,CAAA;IAEzB,yCAAyC;IACzC,sDAAwC,CAAA;AAC1C,CAAC,EAfW,UAAU,KAAV,UAAU,QAerB;AAUD;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC,OAAmB,EAAE,MAAc,EAAU,EAAE;IAC3E,OAAO,GAAG,OAAO,IAAI,MAAM,EAAE,CAAC;AAChC,CAAC,CAAC;AAEF;;;;;;GAMG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,OAAmB,EAAE,OAAe,EAAU,EAAE;IAC3E,OAAO,GAAG,OAAO,IAAI,OAAO,EAAE,CAAC;AACjC,CAAC,CAAC"}

package/lib/index.d.ts

@@ -0,0 +1,27 @@
+/**
+ * Storage Domain - Public API
+ *
+ * Domain-Driven Design (DDD) Architecture
+ *
+ * This is the SINGLE SOURCE OF TRUTH for all storage operations.
+ * ALL imports from the storage domain MUST go through this file.
+ *
+ * Architecture:
+ * - domain: Entities, value objects, errors (business logic)
+ * - application: Ports (interfaces), use cases (not needed for simple CRUD)
+ * - infrastructure: Repository implementation (AsyncStorage adapter)
+ * - presentation: Hooks (React integration)
+ *
+ * Usage:
+ *   import { useStorage, useStorageState, StorageKey } from '@umituz/react-native-storage';
+ */
+export { StorageKey, createUserKey, createAppKey, } from './domain/value-objects/StorageKey';
+export type { DynamicStorageKey } from './domain/value-objects/StorageKey';
+export { StorageError, StorageReadError, StorageWriteError, StorageDeleteError, StorageSerializationError, StorageDeserializationError, } from './domain/errors/StorageError';
+export type { StorageResult } from './domain/entities/StorageResult';
+export { success, failure, unwrap, map, } from './domain/entities/StorageResult';
+export type { IStorageRepository } from './application/ports/IStorageRepository';
+export { AsyncStorageRepository, storageRepository, } from './infrastructure/repositories/AsyncStorageRepository';
+export { useStorage } from './presentation/hooks/useStorage';
+export { useStorageState } from './presentation/hooks/useStorageState';
+//# sourceMappingURL=index.d.ts.map

package/lib/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAMH,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,mCAAmC,CAAC;AAE3C,YAAY,EAAE,iBAAiB,EAAE,MAAM,mCAAmC,CAAC;AAE3E,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AAEtC,YAAY,EAAE,aAAa,EAAE,MAAM,iCAAiC,CAAC;AAErE,OAAO,EACL,OAAO,EACP,OAAO,EACP,MAAM,EACN,GAAG,GACJ,MAAM,iCAAiC,CAAC;AAMzC,YAAY,EAAE,kBAAkB,EAAE,MAAM,wCAAwC,CAAC;AAMjF,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,sDAAsD,CAAC;AAM9D,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC"}

package/lib/index.js

@@ -0,0 +1,33 @@
+/**
+ * Storage Domain - Public API
+ *
+ * Domain-Driven Design (DDD) Architecture
+ *
+ * This is the SINGLE SOURCE OF TRUTH for all storage operations.
+ * ALL imports from the storage domain MUST go through this file.
+ *
+ * Architecture:
+ * - domain: Entities, value objects, errors (business logic)
+ * - application: Ports (interfaces), use cases (not needed for simple CRUD)
+ * - infrastructure: Repository implementation (AsyncStorage adapter)
+ * - presentation: Hooks (React integration)
+ *
+ * Usage:
+ *   import { useStorage, useStorageState, StorageKey } from '@umituz/react-native-storage';
+ */
+// =============================================================================
+// DOMAIN LAYER - Business Logic
+// =============================================================================
+export { StorageKey, createUserKey, createAppKey, } from './domain/value-objects/StorageKey';
+export { StorageError, StorageReadError, StorageWriteError, StorageDeleteError, StorageSerializationError, StorageDeserializationError, } from './domain/errors/StorageError';
+export { success, failure, unwrap, map, } from './domain/entities/StorageResult';
+// =============================================================================
+// INFRASTRUCTURE LAYER - Implementation
+// =============================================================================
+export { AsyncStorageRepository, storageRepository, } from './infrastructure/repositories/AsyncStorageRepository';
+// =============================================================================
+// PRESENTATION LAYER - Hooks
+// =============================================================================
+export { useStorage } from './presentation/hooks/useStorage';
+export { useStorageState } from './presentation/hooks/useStorageState';
+//# sourceMappingURL=index.js.map

package/lib/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;GAgBG;AAEH,gFAAgF;AAChF,gCAAgC;AAChC,gFAAgF;AAEhF,OAAO,EACL,UAAU,EACV,aAAa,EACb,YAAY,GACb,MAAM,mCAAmC,CAAC;AAI3C,OAAO,EACL,YAAY,EACZ,gBAAgB,EAChB,iBAAiB,EACjB,kBAAkB,EAClB,yBAAyB,EACzB,2BAA2B,GAC5B,MAAM,8BAA8B,CAAC;AAItC,OAAO,EACL,OAAO,EACP,OAAO,EACP,MAAM,EACN,GAAG,GACJ,MAAM,iCAAiC,CAAC;AAQzC,gFAAgF;AAChF,wCAAwC;AACxC,gFAAgF;AAEhF,OAAO,EACL,sBAAsB,EACtB,iBAAiB,GAClB,MAAM,sDAAsD,CAAC;AAE9D,gFAAgF;AAChF,6BAA6B;AAC7B,gFAAgF;AAEhF,OAAO,EAAE,UAAU,EAAE,MAAM,iCAAiC,CAAC;AAC7D,OAAO,EAAE,eAAe,EAAE,MAAM,sCAAsC,CAAC"}

package/lib/infrastructure/repositories/AsyncStorageRepository.d.ts

@@ -0,0 +1,50 @@
+/**
+ * AsyncStorage Repository
+ *
+ * Domain-Driven Design: Infrastructure implementation of IStorageRepository
+ * Adapts React Native AsyncStorage to domain interface
+ */
+import type { IStorageRepository } from '../../application/ports/IStorageRepository';
+import type { StorageResult } from '../../domain/entities/StorageResult';
+/**
+ * AsyncStorage Repository Implementation
+ */
+export declare class AsyncStorageRepository implements IStorageRepository {
+    /**
+     * Get item from AsyncStorage with type safety
+     */
+    getItem<T>(key: string, defaultValue: T): Promise<StorageResult<T>>;
+    /**
+     * Set item in AsyncStorage with automatic 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 AsyncStorage
+     */
+    removeItem(key: string): Promise<StorageResult<void>>;
+    /**
+     * Check if key exists in storage
+     */
+    hasItem(key: string): Promise<boolean>;
+    /**
+     * Clear all AsyncStorage data (use with caution!)
+     */
+    clearAll(): Promise<StorageResult<void>>;
+    /**
+     * Get multiple items at once (more efficient than multiple getItem calls)
+     */
+    getMultiple(keys: string[]): Promise<StorageResult<Record<string, string | null>>>;
+}
+/**
+ * Singleton instance
+ */
+export declare const storageRepository: AsyncStorageRepository;
+//# sourceMappingURL=AsyncStorageRepository.d.ts.map

package/lib/infrastructure/repositories/AsyncStorageRepository.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"AsyncStorageRepository.d.ts","sourceRoot":"","sources":["../../../src/infrastructure/repositories/AsyncStorageRepository.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,KAAK,EAAE,kBAAkB,EAAE,MAAM,4CAA4C,CAAC;AACrF,OAAO,KAAK,EAAE,aAAa,EAAE,MAAM,qCAAqC,CAAC;AAUzE;;GAEG;AACH,qBAAa,sBAAuB,YAAW,kBAAkB;IAC/D;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAoBzE;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,CAAC,GAAG,OAAO,CAAC,aAAa,CAAC,CAAC,CAAC,CAAC;IAgBlE;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAelF;;OAEG;IACG,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,CAAC;IAS3E;;OAEG;IACG,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAS3D;;OAEG;IACG,OAAO,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAS5C;;OAEG;IACG,QAAQ,IAAI,OAAO,CAAC,aAAa,CAAC,IAAI,CAAC,CAAC;IAS9C;;OAEG;IACG,WAAW,CACf,IAAI,EAAE,MAAM,EAAE,GACb,OAAO,CAAC,aAAa,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,IAAI,CAAC,CAAC,CAAC;CASzD;AAED;;GAEG;AACH,eAAO,MAAM,iBAAiB,wBAA+B,CAAC"}