@cranberry-money/shared-services 8.1.0 → 8.1.2

package/README.md

@@ -1,6 +1,6 @@
 # @cranberry-money/shared-services v3.0.0
 
-**Functional Architecture Shared Services** with pure functions, dependency injection, and comprehensive TypeScript support for the MyPortfolio platform.
+**Functional Architecture Shared Services** with pure functions, dependency injection, and comprehensive TypeScript support for the Blueberry platform.
 
 [![npm version](https://badge.fury.io/js/%40cranberry-money%2Fshared-services.svg)](https://badge.fury.io/js/%40cranberry-money%2Fshared-services)
 [![TypeScript](https://img.shields.io/badge/TypeScript-5.0-blue.svg)](https://www.typescriptlang.org/)
@@ -9,7 +9,7 @@
 ## 🎉 What's New in v3.0.0
 
 - **Pure Functional Architecture**: Complete migration to functional programming patterns
-- **Service Factory Pattern**: Type-safe service creation with dependency injection  
+- **Service Factory Pattern**: Type-safe service creation with dependency injection
 - **React Context Authentication**: Modern authentication with hooks and context
 - **Migration Framework**: Feature flags and tools for gradual migration from v2.x
 - **Performance Improvements**: 10-15% faster API calls, 15-20% less memory usage
@@ -25,9 +25,9 @@ npm install @cranberry-money/shared-services@^3.0.0
 ### Basic Setup
 
 ```typescript
-import { 
-  createWebServiceFactory, 
-  initializeFeatureFlags 
+import {
+  createWebServiceFactory,
+  initializeFeatureFlags
 } from '@cranberry-money/shared-services';
 
 // 1. Initialize feature flags (optional but recommended)
@@ -92,10 +92,10 @@ const result = await signin(credentials, authDeps);
 ### React Context Integration
 
 ```typescript
-import { 
-  useFunctionalAuthState, 
+import {
+  useFunctionalAuthState,
   useFunctionalAuthActions,
-  FunctionalAuthGuard 
+  FunctionalAuthGuard
 } from '@cranberry-money/shared-services';
 
 function Dashboard() {
@@ -168,7 +168,7 @@ const result = await apiClient.post('/api/items', { name: 'Item' });
 import { createFunctionalWebApiClient } from '@cranberry-money/shared-services';
 const webClient = createFunctionalWebApiClient('https://api.example.com');
 
-// Mobile-optimized client  
+// Mobile-optimized client
 import { createFunctionalMobileApiClient } from '@cranberry-money/shared-services';
 const mobileClient = createFunctionalMobileApiClient('https://api.example.com');
 ```
@@ -261,10 +261,7 @@ if (!validation.isValid) {
 ### Built-in Benchmarking
 
 ```typescript
-import { 
-  runQuickPerformanceCheck,
-  runComprehensivePerformanceAnalysis 
-} from '@cranberry-money/shared-services';
+import { runQuickPerformanceCheck, runComprehensivePerformanceAnalysis } from '@cranberry-money/shared-services';
 
 // Quick performance check
 const quickReport = await runQuickPerformanceCheck();
@@ -281,10 +278,8 @@ console.log(detailedReport);
 import { monitorMigrationPerformance } from '@cranberry-money/shared-services';
 
 // Wrap functions for automatic performance tracking
-const monitored = monitorMigrationPerformance(
-  'api.getPortfolios',
-  'functional',
-  () => services.portfolio.getPortfolios()
+const monitored = monitorMigrationPerformance('api.getPortfolios', 'functional', () =>
+  services.portfolio.getPortfolios()
 );
 
 const result = await monitored();
@@ -313,10 +308,7 @@ describe('Authentication', () => {
       tokenStorage: createMemoryTokenStorage(),
     };
 
-    const result = await signin(
-      { email: 'test@example.com', password: 'password' },
-      deps
-    );
+    const result = await signin({ email: 'test@example.com', password: 'password' }, deps);
 
     expect(result.user.email).toBe('test@example.com');
     expect(mockApiClient.post).toHaveBeenCalledWith('/api/signin/', {
@@ -336,7 +328,7 @@ import { createMemoryTokenStorage } from '@cranberry-money/shared-services';
 const TestAuthProvider = ({ children }) => {
   const services = createWebServiceFactory('http://test-api.com');
   const AuthProvider = services.auth.createAuthProvider();
-  
+
   return <AuthProvider>{children}</AuthProvider>;
 };
 
@@ -346,7 +338,7 @@ test('should display user name when authenticated', () => {
       <Dashboard />
     </TestAuthProvider>
   );
-  
+
   // Test auth-dependent component
 });
 ```
@@ -358,13 +350,10 @@ test('should display user name when authenticated', () => {
 ```typescript
 import { createWebServiceFactory } from '@cranberry-money/shared-services';
 
-const services = createWebServiceFactory(
-  process.env.REACT_APP_API_URL,
-  {
-    apiTimeout: 15000,
-    enableCredentials: true,
-  }
-);
+const services = createWebServiceFactory(process.env.REACT_APP_API_URL, {
+  apiTimeout: 15000,
+  enableCredentials: true,
+});
 
 export { services };
 ```
@@ -375,13 +364,9 @@ export { services };
 import { createMobileServiceFactory } from '@cranberry-money/shared-services';
 import * as SecureStore from 'expo-secure-store';
 
-const services = createMobileServiceFactory(
-  process.env.EXPO_PUBLIC_API_URL,
-  SecureStore,
-  {
-    apiTimeout: 20000,
-  }
-);
+const services = createMobileServiceFactory(process.env.EXPO_PUBLIC_API_URL, SecureStore, {
+  apiTimeout: 20000,
+});
 
 export { services };
 ```
@@ -446,20 +431,21 @@ import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
 function usePortfolios() {
   return useQuery({
     queryKey: ['portfolios'],
-    queryFn: () => services.portfolio.getPortfolios({
-      isActive: true,
-      sortBy: 'totalValue',
-      sortOrder: 'desc',
-    }),
+    queryFn: () =>
+      services.portfolio.getPortfolios({
+        isActive: true,
+        sortBy: 'totalValue',
+        sortOrder: 'desc',
+      }),
     staleTime: 5 * 60 * 1000, // 5 minutes
   });
 }
 
 function useCreatePortfolio() {
   const queryClient = useQueryClient();
-  
+
   return useMutation({
-    mutationFn: (data) => services.portfolio.createPortfolio(data),
+    mutationFn: data => services.portfolio.createPortfolio(data),
     onSuccess: () => {
       queryClient.invalidateQueries({ queryKey: ['portfolios'] });
     },
@@ -525,11 +511,13 @@ src/
 ## 🔗 Dependencies
 
 ### Required
+
 - `axios` - HTTP client library
 - `react` >=18.0.0 - React framework (peer dependency)
 - `typescript` >=4.5.0 - TypeScript support (peer dependency)
 
 ### Optional
+
 - `@tanstack/react-query` - For optimized data fetching
 - `expo-secure-store` - For mobile secure storage
 
@@ -553,10 +541,10 @@ MIT License - see the [LICENSE](LICENSE) file for details.
 
 ## 🙏 Acknowledgments
 
-- Built for the MyPortfolio platform
+- Built for the Blueberry platform
 - Inspired by functional programming principles
 - Designed for maximum type safety and developer experience
 
 ---
 
-**Need help migrating from v2.x?** Check out our [comprehensive migration guide](../../docs/MIGRATION-V3.md) with step-by-step instructions and examples.
+**Need help migrating from v2.x?** Check out our [comprehensive migration guide](../../docs/MIGRATION-V3.md) with step-by-step instructions and examples.

package/dist/index.js

@@ -1,2 +1,3 @@
 "use strict";
 // Placeholder for  package
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,2BAA2B"}

package/package.json

@@ -1,57 +1,49 @@
 {
   "name": "@cranberry-money/shared-services",
-  "version": "8.1.0",
-  "description": "Functional architecture shared services with pure functions, dependency injection, and comprehensive TypeScript support for the MyPortfolio platform",
+  "version": "8.1.2",
+  "description": "Functional architecture shared services with pure functions, dependency injection, and comprehensive TypeScript support for the Blueberry platform",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
     ".": {
       "types": "./dist/index.d.ts",
-      "import": "./dist/index.js",
-      "require": "./dist/index.cjs"
+      "import": "./dist/index.js"
     }
   },
   "files": [
-    "dist",
-    "README.md",
-    "CHANGELOG.md",
-    "docs"
+    "dist"
   ],
   "scripts": {
-    "build": "tsc",
-    "clean": "rm -rf dist",
+    "build": "tsc --build",
+    "clean": "rm -rf dist tsconfig.tsbuildinfo",
+    "test": "jest --passWithNoTests",
+    "test:watch": "jest --watch",
+    "test:coverage": "jest --coverage",
     "typecheck": "tsc --noEmit",
     "dev": "tsc --watch",
     "lint": "eslint src",
-    "lint:fix": "eslint src --fix"
+    "lint:fix": "eslint src --fix",
+    "format": "prettier --write 'src/**/*.{ts,tsx}'",
+    "format:check": "prettier --check 'src/**/*.{ts,tsx}'",
+    "prepublishOnly": "npm run clean && npm run typecheck && npm run build"
   },
   "dependencies": {
-    "axios": "^1.7.0"
+    "axios": "^1.9.0"
   },
   "peerDependencies": {
-    "react": ">=18.0.0",
-    "typescript": ">=4.5.0"
-  },
-  "peerDependenciesMeta": {
-    "react": {
-      "optional": false
-    }
+    "typescript": ">=5.0.0"
   },
   "devDependencies": {
+    "@types/jest": "^30.0.0",
     "@types/node": "^20.0.0",
-    "@types/react": "^18.0.0",
-    "@typescript-eslint/eslint-plugin": "^6.0.0",
-    "@typescript-eslint/parser": "^6.0.0",
-    "eslint": "^8.0.0",
-    "react": "^18.0.0",
-    "tsx": "^4.0.0",
+    "jest": "^30.0.5",
+    "ts-jest": "^29.4.1",
     "typescript": "^5.0.0"
   },
   "keywords": [
     "functional-programming",
     "dependency-injection",
-    "react",
     "typescript",
     "api-client",
     "authentication",
@@ -59,23 +51,10 @@
     "services",
     "pure-functions"
   ],
-  "author": "MyPortfolio Team",
+  "author": "Blueberry Team",
   "license": "MIT",
   "publishConfig": {
     "access": "public",
     "registry": "https://registry.npmjs.org/"
-  },
-  "repository": {
-    "type": "git",
-    "url": "git+https://github.com/your-org/cranberry.git",
-    "directory": "packages/shared-services"
-  },
-  "bugs": {
-    "url": "https://github.com/your-org/cranberry/issues"
-  },
-  "homepage": "https://github.com/your-org/cranberry/tree/main/packages/shared-services#readme",
-  "engines": {
-    "node": ">=16.0.0",
-    "npm": ">=8.0.0"
   }
 }

package/CHANGELOG.md

@@ -1,240 +0,0 @@
-# Changelog
-
-All notable changes to this project will be documented in this file.
-
-The format is based on [Keep a Changelog](https://keepachangelog.com/en/1.0.0/),
-and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0.html).
-
-## [3.0.0] - 2025-08-15
-
-### 🎉 Major Features
-
-#### Pure Functional Architecture
-- **Complete migration** from mixed OOP/functional patterns to pure functional programming
-- **Explicit dependency injection** throughout the entire codebase
-- **Immutable state management** with functional state transitions
-- **Zero global mutable state** - all dependencies passed explicitly
-
-#### Service Factory Pattern
-- **Platform-specific service creation** with `createWebServiceFactory()` and `createMobileServiceFactory()`
-- **Type-safe service composition** with full TypeScript support
-- **Dependency injection** with explicit configuration and validation
-- **Modular architecture** allowing easy extension and testing
-
-#### Enhanced Authentication System
-- **React Context-based authentication** replacing class-based AuthManager
-- **Pure functional auth operations** (signin, signout, signup, token refresh)
-- **Platform-specific token storage** (web localStorage, mobile secure storage, in-memory for testing)
-- **Automatic token refresh** with error handling and fallback
-- **React hooks integration** (`useFunctionalAuthState`, `useFunctionalAuthActions`)
-
-#### Migration Framework
-- **Feature flag system** for gradual migration from v2.x to v3.0.0
-- **Performance benchmarking tools** to compare functional vs legacy implementations
-- **Migration validation utilities** to ensure readiness before switching
-- **Compatibility layers** for smooth transition during migration
-- **Domain-specific migration adapters** for reference data services
-
-### 💥 Breaking Changes
-
-#### Removed Global Singleton API Client
-```typescript
-// ❌ REMOVED - Global singleton pattern
-import { webApiClient } from '@cranberry/shared-services';
-const data = await webApiClient.get('/api/data');
-
-// ✅ NEW - Factory pattern with dependency injection
-import { createWebServiceFactory } from '@cranberry/shared-services';
-const services = createWebServiceFactory('https://api.example.com');
-const apiClient = services.auth.createAuthDependencies().apiClient;
-const data = await apiClient.get('/api/data');
-```
-
-#### Deprecated AuthManager Class
-```typescript
-// ❌ DEPRECATED - Class-based authentication
-import { AuthManager } from '@cranberry/shared-services';
-const authManager = new AuthManager(config);
-const user = authManager.getCurrentUser();
-
-// ✅ NEW - React Context with functional hooks
-import { FunctionalAuthProvider, useFunctionalAuthState } from '@cranberry/shared-services';
-const AuthProvider = services.auth.createAuthProvider();
-// Use in React components with hooks
-const authState = useFunctionalAuthState();
-```
-
-#### Changed Service Access Pattern
-```typescript
-// ❌ OLD - Direct service imports
-import * as PortfoliosService from '@cranberry/shared-services';
-const portfolios = await PortfoliosService.getPortfolios();
-
-// ✅ NEW - Service factory pattern
-const services = createWebServiceFactory(apiUrl);
-const portfolios = await services.portfolio.getPortfolios();
-```
-
-#### Updated Export Names for Clarity
-```typescript
-// ❌ OLD - Potential naming conflicts
-import { AuthState, ApiClient, TokenStorage } from '@cranberry/shared-services';
-
-// ✅ NEW - Prefixed exports to avoid conflicts
-import { 
-  FunctionalAuthState, 
-  FunctionalApiClient, 
-  FunctionalTokenStorage 
-} from '@cranberry/shared-services';
-```
-
-#### Standardized Error Handling
-```typescript
-// ❌ OLD - Inconsistent error formats
-catch (error) {
-  const message = error.message || error.detail || 'Unknown error';
-}
-
-// ✅ NEW - Standardized API error handling
-import { isFunctionalApiError } from '@cranberry/shared-services';
-catch (error) {
-  if (isFunctionalApiError(error)) {
-    console.error(`API Error (${error.status}): ${error.message}`);
-    if (error.details) console.error('Details:', error.details);
-  }
-}
-```
-
-### ✨ New Features
-
-#### Feature Flag System
-- **Gradual migration support** with feature flags for each domain
-- **Environment-based configuration** (development, staging, production)
-- **Persistent storage** with automatic configuration loading
-- **Performance monitoring** integration during migration
-- **Rollback capabilities** for safe migration
-
-#### Migration Utilities
-- **Migration helpers** with compatibility layers between v2.x and v3.0.0
-- **Validation tools** to check migration readiness
-- **Progress tracking** with detailed metrics and reporting
-- **Performance comparison** tools for functional vs legacy implementations
-
-#### Reference Data Services
-- **Complete functional implementation** for countries, industries, sectors, stock exchanges
-- **Feature flag integration** for gradual migration
-- **Backward compatibility** during transition period
-- **Performance optimizations** with caching and filtering
-
-#### Platform-Specific Token Storage
-- **Web token storage** using localStorage with automatic cleanup
-- **Mobile secure storage** integration (Expo SecureStore, iOS Keychain, Android Keystore)
-- **In-memory storage** for testing environments
-- **Migration utilities** for converting from legacy token storage
-
-#### Performance Improvements
-- **10-15% faster API calls** due to reduced abstraction layers
-- **15-20% reduction in memory usage** through immutable state management
-- **5-10% smaller bundle size** by eliminating unnecessary OOP abstractions
-- **Built-in performance monitoring** with automatic benchmarking
-
-### 🐛 Bug Fixes
-
-- **Fixed memory leaks** in global state management by eliminating mutable global state
-- **Fixed inconsistent error handling** across services with standardized error formats
-- **Fixed TypeScript strict mode compatibility** issues with improved type definitions
-- **Fixed race conditions** in authentication flow with pure functional state management
-- **Fixed token refresh edge cases** with proper error handling and fallback mechanisms
-
-### 📚 Documentation
-
-#### Comprehensive Migration Guide
-- **Step-by-step migration instructions** from v2.x to v3.0.0
-- **Code examples** for all breaking changes
-- **Gradual migration strategy** with feature flag usage
-- **Rollback procedures** for emergency situations
-- **Performance validation** guidelines
-
-#### Integration Examples
-- **Blueberry dashboard integration** example with complete setup
-- **React Query integration** patterns and best practices
-- **Testing examples** for pure functions and React components
-- **Error handling** patterns and utilities
-
-#### API Documentation
-- **Complete TypeScript definitions** for all new APIs
-- **Usage examples** for every major feature
-- **Performance benchmarking** guides and tools
-- **Troubleshooting** guides for common migration issues
-
-### 🧪 Testing
-
-- **100% test coverage** for all new functional components
-- **Migration validation tests** to ensure compatibility
-- **Performance regression tests** to maintain performance standards
-- **Integration test examples** for React components and hooks
-- **Pure function testing** utilities and patterns
-
-### 🛠 Developer Experience
-
-- **Improved TypeScript support** with strict mode compatibility
-- **Self-documenting pure functions** with explicit dependencies
-- **Better error messages** with detailed debugging information
-- **Comprehensive examples** for all use cases
-- **Migration tooling** for smooth transition
-
-### 📦 Dependencies
-
-#### Added
-- Enhanced TypeScript support (>=4.5.0)
-- React 18+ support for new context APIs
-- Improved axios integration for HTTP client
-
-#### Removed
-- Legacy OOP class dependencies
-- Global state management libraries
-- Unused abstraction layers
-
-### 🔄 Migration Support
-
-#### Automatic Migration Tools
-- **Feature flag management** for gradual rollout
-- **Performance comparison** between old and new implementations
-- **Validation utilities** to check migration readiness
-- **Compatibility layers** to ease transition
-
-#### Support Timeline
-- **v3.0.x**: Active development and support
-- **v2.x**: Security fixes and critical bug fixes for 6 months
-- **v1.x**: End of life
-
----
-
-## [2.x.x] - Previous Versions
-
-For changes in v2.x and earlier, please see the [legacy changelog](./CHANGELOG-v2.md).
-
----
-
-## Migration Guide
-
-**Migrating from v2.x?** 
-
-📖 **[Complete Migration Guide](./docs/improvements/v3-migration-guide.md)** - Step-by-step instructions with examples
-
-🔧 **[Migration Checklist](./docs/improvements/migration-checklist.md)** - Systematic approach to migration
-
-⚡ **[Performance Guide](./docs/improvements/v3-release-preparation.md)** - Performance improvements and monitoring
-
-🚀 **[Quick Start](./README.md#quick-start)** - Get up and running with v3.0.0
-
-## Support
-
-- **GitHub Issues**: [Report bugs and request features](https://github.com/your-org/cranberry/issues)
-- **Documentation**: [Complete documentation](./docs/)
-- **Examples**: [Integration examples](./src/integration/)
-- **Migration Help**: See migration guides above
-
----
-
-*This release represents a significant architectural advancement that improves code quality, performance, and developer experience across all applications using Cranberry shared services.*