@sudobility/di 1.5.0 → 1.5.3

package/README.md

@@ -1,67 +1,283 @@
-# @johnqh/di
+# @sudobility/di
 
-Platform-agnostic dependency injection interfaces for React and React Native projects.
+Platform-agnostic dependency injection for React and React Native with automatic platform detection.
 
 ## Overview
 
-This library provides abstract TypeScript interfaces for dependency injection patterns that work across web and React Native platforms. It contains no platform-specific code and focuses purely on defining contracts for common services.
+This library provides unified DI services that work identically on Web and React Native. The bundler automatically selects the correct platform implementation, so you write the same code for both platforms.
 
 ## Features
 
-- 🚀 **Platform Agnostic**: Works with both React and React Native
-- 📱 **React Native Compatible**: No web-specific dependencies
-- 🔌 **Dependency Injection**: Clean interface-based architecture
-- 🎯 **TypeScript First**: Fully typed interfaces
-- 🏗️ **Modular**: Import only what you need
+- **Unified API**: Same code works on Web and React Native
+- **Automatic Platform Detection**: Bundler selects correct implementation
+- **TypeScript First**: Fully typed interfaces and implementations
+- **Lazy Loading**: Native modules loaded only when used
+- **Singleton Management**: Built-in service lifecycle management
+- **Modular**: Import only what you need
 
 ## Installation
 
 ```bash
-npm install @johnqh/di
+npm install @sudobility/di
 ```
 
-## Usage
+### Optional Peer Dependencies
+
+**Web:**
+```bash
+npm install firebase
+```
+
+**React Native:**
+```bash
+npm install @react-native-async-storage/async-storage
+npm install @react-native-community/netinfo
+npm install @react-native-firebase/app @react-native-firebase/analytics
+npm install @react-native-firebase/remote-config @react-native-firebase/messaging
+npm install @notifee/react-native
+```
+
+## Quick Start
+
+### 1. Initialize Services
 
 ```typescript
+// main.tsx or App.tsx
 import {
-  NetworkClient,
-  StorageProvider,
-  AnalyticsService,
-  EnvProvider
-} from '@johnqh/di';
-
-// Implement interfaces for your specific platform
-class MyNetworkClient implements NetworkClient {
-  // Your implementation
-}
+  initializeStorageService,
+  initializeNetworkService,
+  initializeFirebaseService,
+} from '@sudobility/di';
+
+// Call before rendering app
+initializeStorageService();
+initializeNetworkService();
+initializeFirebaseService(firebaseConfig);
 ```
 
-## Included Interfaces
+### 2. Use Services
 
-### Network
-- `NetworkClient` - HTTP client interface
-- `NetworkResponse` - Response type
-- `NetworkRequestOptions` - Request configuration
+```typescript
+import {
+  getStorageService,
+  getNetworkService,
+  getFirebaseService,
+  networkClient,
+} from '@sudobility/di';
+
+// Storage
+const storage = getStorageService();
+await storage.setItem('token', 'abc123');
+const token = await storage.getItem('token');
+
+// Network requests
+const response = await networkClient.get<User>('/api/user');
+
+// Network status
+const network = getNetworkService();
+const isOnline = network.isOnline();
+
+// Firebase
+const firebase = getFirebaseService();
+firebase.analytics.logEvent('screen_view', { screen: 'Home' });
+```
+
+## API Reference
 
 ### Storage
-- `StorageProvider` - Storage abstraction
-- `PlatformStorage` - Basic storage interface
-- `StorageService` - Enhanced storage service
 
-### Analytics
-- `AnalyticsService` - Analytics tracking interface
-- `EmailAnalyticsService` - Email-specific analytics
+```typescript
+import { getStorageService, storage } from '@sudobility/di';
+
+const storageService = getStorageService();
+
+// Basic operations
+await storageService.setItem('key', 'value');
+const value = await storageService.getItem('key');
+await storageService.removeItem('key');
+await storageService.clear();
+const keys = await storageService.getAllKeys();
+```
+
+### Network Requests
+
+```typescript
+import { networkClient } from '@sudobility/di';
+
+// GET
+const response = await networkClient.get<User>('/api/user');
+if (response.ok) {
+  console.log(response.data);
+}
+
+// POST with body
+const result = await networkClient.post<Result>('/api/submit', {
+  name: 'John',
+  email: 'john@example.com'
+});
+
+// PUT and DELETE
+await networkClient.put('/api/user/1', { name: 'Jane' });
+await networkClient.delete('/api/user/1');
 
-### Environment
-- `EnvProvider` - Environment configuration
-- `AppConfig` - Application configuration
+// With options
+const response = await networkClient.get('/api/data', {
+  headers: { 'Authorization': 'Bearer token' },
+  timeout: 5000,
+});
+```
+
+### Network Status
+
+```typescript
+import { getNetworkService } from '@sudobility/di';
+
+const network = getNetworkService();
+
+// Check connection
+const isOnline = network.isOnline();
+
+// Watch for changes
+const unsubscribe = network.watchNetworkStatus((online) => {
+  console.log('Connection:', online ? 'Online' : 'Offline');
+});
+
+// Cleanup when done
+unsubscribe();
+```
 
-### Authentication
-- Auth interfaces for various providers
+### Firebase
 
-### Navigation & Notifications
-- Platform-agnostic navigation and notification interfaces
+```typescript
+import { getFirebaseService } from '@sudobility/di';
+
+const firebase = getFirebaseService();
+
+// Analytics
+firebase.analytics.logEvent('purchase', { item: 'premium', price: 9.99 });
+firebase.analytics.setUserId('user123');
+firebase.analytics.setUserProperties({ plan: 'pro' });
+
+// Remote Config
+await firebase.remoteConfig.fetchAndActivate();
+const showFeature = firebase.remoteConfig.getValue('new_feature').asBoolean();
+const apiUrl = firebase.remoteConfig.getValue('api_url').asString();
+const maxItems = firebase.remoteConfig.getValue('max_items').asNumber();
+
+// Messaging (FCM)
+const granted = await firebase.messaging.requestPermission();
+if (granted) {
+  const token = await firebase.messaging.getToken();
+  console.log('FCM Token:', token);
+}
+
+const unsubscribe = firebase.messaging.onMessage((message) => {
+  console.log('Push notification:', message.notification?.title);
+});
+```
+
+### React Native Only Services
+
+```typescript
+import {
+  getThemeService,
+  getNavigationService,
+  getNotificationService,
+} from '@sudobility/di';
+
+// Theme
+const theme = getThemeService();
+const isDark = theme.isDarkMode();
+theme.applyTheme('dark'); // 'light' | 'dark' | 'system'
+theme.watchSystemTheme((mode) => {
+  console.log('System theme:', mode);
+});
+
+// Navigation (call setNavigationRef first in App.tsx)
+const nav = getNavigationService();
+nav.navigate('Profile', { userId: '123' });
+nav.goBack();
+nav.replace('Home');
+
+// Notifications
+const notifications = getNotificationService();
+await notifications.requestPermission();
+await notifications.showNotification('Hello', {
+  body: 'You have a new message',
+  data: { screen: 'inbox' }
+});
+await notifications.setBadgeCount(5);
+```
+
+## Import Paths
+
+```typescript
+// Auto-detect platform (recommended)
+import { ... } from '@sudobility/di';
+
+// Explicit web imports
+import { ... } from '@sudobility/di/web';
+
+// Explicit React Native imports
+import { ... } from '@sudobility/di/rn';
+
+// Interfaces only (no implementations)
+import type { ... } from '@sudobility/di/interfaces';
+
+// Mocks for testing
+import { MockStorageService, MockNetworkClient } from '@sudobility/di/mocks';
+```
+
+## Unified Exports
+
+These exports work identically on both platforms:
+
+| Export | Description |
+|--------|-------------|
+| `networkClient` | Pre-configured network client instance |
+| `storage` | Basic storage instance |
+| `advancedStorage` | Storage with TTL support |
+| `getStorageService()` | Get storage service singleton |
+| `getNetworkService()` | Get network service singleton |
+| `getFirebaseService()` | Get Firebase service singleton |
+| `initializeStorageService()` | Initialize storage singleton |
+| `initializeNetworkService()` | Initialize network singleton |
+| `initializeFirebaseService()` | Initialize Firebase singleton |
+| `StorageService` | Storage service class |
+| `NetworkService` | Network service class |
+| `FirebaseService` | Firebase service class |
+
+## Platform-Specific Exports
+
+### Web Only
+- `WebStorageService`, `WebNetworkService`, `WebFirebaseService`
+- `webStorage`, `webNetworkClient`
+- `WebUINavigationService`
+
+### React Native Only
+- `RNStorageService`, `RNNetworkService`, `RNFirebaseService`
+- `rnStorage`, `rnNetworkClient`
+- `getThemeService()`, `getNavigationService()`, `getNotificationService()`
+- `RNThemeService`, `RNNavigationService`, `RNNotificationService`
+
+## Testing with Mocks
+
+```typescript
+import {
+  MockStorageService,
+  MockNetworkClient,
+  MockAnalyticsClient,
+} from '@sudobility/di/mocks';
+
+// In your tests
+const mockStorage = new MockStorageService();
+await mockStorage.setItem('key', 'value');
+expect(await mockStorage.getItem('key')).toBe('value');
+
+const mockNetwork = new MockNetworkClient();
+// Configure mock responses...
+```
 
 ## License
 
-MIT
+MIT

package/dist/mocks/firebase.mock.d.ts

@@ -0,0 +1,109 @@
+import type { AnalyticsService, RemoteConfigService, RemoteConfigValue, FCMService, FCMMessage, FCMPermissionState, FirebaseService, FirebaseConfig, FirebaseInitOptions } from '../web/firebase/firebase.interface.js';
+export interface RecordedFirebaseAnalyticsEvent {
+    type: 'event' | 'userProperty' | 'userId';
+    name?: string;
+    parameters?: Record<string, unknown>;
+    properties?: Record<string, string>;
+    userId?: string;
+    timestamp: number;
+}
+export declare class MockAnalyticsService implements AnalyticsService {
+    private events;
+    private supported;
+    private currentUserId;
+    private userProperties;
+    logEvent(eventName: string, parameters?: Record<string, unknown>): void;
+    setUserProperties(properties: Record<string, string>): void;
+    setUserId(userId: string): void;
+    isSupported(): boolean;
+    setSupported(supported: boolean): void;
+    getEvents(): RecordedFirebaseAnalyticsEvent[];
+    getEventsByType(type: 'event' | 'userProperty' | 'userId'): RecordedFirebaseAnalyticsEvent[];
+    getEventsByName(name: string): RecordedFirebaseAnalyticsEvent[];
+    getUserId(): string | null;
+    getUserProperties(): Record<string, string>;
+    reset(): void;
+}
+export declare class MockRemoteConfigValue implements RemoteConfigValue {
+    private value;
+    private source;
+    constructor(value: string, source?: 'static' | 'default' | 'remote');
+    asBoolean(): boolean;
+    asString(): string;
+    asNumber(): number;
+    getSource(): 'static' | 'default' | 'remote';
+}
+export declare class MockRemoteConfigService implements RemoteConfigService {
+    private configs;
+    private supported;
+    private fetchDelay;
+    private fetchShouldFail;
+    private fetchError;
+    fetchAndActivate(): Promise<boolean>;
+    getValue(key: string): RemoteConfigValue;
+    getAll(): Record<string, RemoteConfigValue>;
+    isSupported(): boolean;
+    setSupported(supported: boolean): void;
+    setConfig(key: string, value: string, source?: 'static' | 'default' | 'remote'): void;
+    setConfigs(configs: Record<string, string>): void;
+    setFetchDelay(delay: number): void;
+    setFetchShouldFail(shouldFail: boolean, error?: Error): void;
+    clearConfig(key: string): void;
+    reset(): void;
+}
+export interface RecordedFCMEvent {
+    type: 'permissionRequest' | 'getToken' | 'deleteToken' | 'messageReceived';
+    token?: string | null;
+    message?: FCMMessage;
+    timestamp: number;
+}
+export declare class MockFCMService implements FCMService {
+    private events;
+    private supported;
+    private permissionStatus;
+    private mockToken;
+    private messageListeners;
+    private permissionRequestDelay;
+    private tokenRequestDelay;
+    private shouldFailPermission;
+    private shouldFailToken;
+    requestPermission(): Promise<boolean>;
+    getToken(): Promise<string | null>;
+    deleteToken(): Promise<boolean>;
+    onMessage(callback: (message: FCMMessage) => void): () => void;
+    isSupported(): boolean;
+    getPermissionStatus(): FCMPermissionState;
+    setSupported(supported: boolean): void;
+    setToken(token: string | null): void;
+    setPermissionGranted(granted: boolean): void;
+    setPermissionRequestDelay(delay: number): void;
+    setTokenRequestDelay(delay: number): void;
+    setShouldFailPermission(shouldFail: boolean): void;
+    setShouldFailToken(shouldFail: boolean): void;
+    simulateMessage(message: FCMMessage): void;
+    getEvents(): RecordedFCMEvent[];
+    getEventsByType(type: 'permissionRequest' | 'getToken' | 'deleteToken' | 'messageReceived'): RecordedFCMEvent[];
+    getListenerCount(): number;
+    reset(): void;
+}
+export declare class MockFirebaseService implements FirebaseService {
+    analytics: MockAnalyticsService;
+    remoteConfig: MockRemoteConfigService;
+    messaging: MockFCMService;
+    private configured;
+    private developmentMode;
+    private config;
+    private options;
+    constructor(config?: FirebaseConfig, options?: FirebaseInitOptions);
+    isConfigured(): boolean;
+    isDevelopment(): boolean;
+    setConfigured(configured: boolean): void;
+    setDevelopmentMode(developmentMode: boolean): void;
+    getConfig(): FirebaseConfig | null;
+    getOptions(): FirebaseInitOptions | null;
+    reset(): void;
+}
+export declare function getMockFirebaseService(): MockFirebaseService;
+export declare function initializeMockFirebaseService(config?: FirebaseConfig, options?: FirebaseInitOptions): MockFirebaseService;
+export declare function resetMockFirebaseService(): void;
+//# sourceMappingURL=firebase.mock.d.ts.map

package/dist/mocks/firebase.mock.d.ts.map

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