@cranberry-money/shared-services 8.1.3 → 10.0.2

package/README.md

@@ -1,550 +1,259 @@
-# @cranberry-money/shared-services v3.0.0
+# @cranberry-money/shared-services
 
-**Functional Architecture Shared Services** with pure functions, dependency injection, and comprehensive TypeScript support for the Blueberry platform.
+**Platform-agnostic service functions** that work with any axios-compatible API client.
 
 [![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/)
-[![React](https://img.shields.io/badge/React-18+-61dafb.svg)](https://reactjs.org/)
 
-## 🎉 What's New in v3.0.0
+## 📦 Package Overview
 
-- **Pure Functional Architecture**: Complete migration to functional programming patterns
-- **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
+This package provides reusable service functions for the Blueberry platform ecosystem. Services are pure functions that accept an API client, allowing the same business logic to work across web browsers, mobile apps, and testing environments.
+
+### Core Philosophy
+
+- **One service implementation, multiple platforms**: Write once, use everywhere
+- **Platform owns authentication**: Each platform handles auth its own way (cookies, tokens, etc.)
+- **Simple and functional**: No complex patterns, just functions that call APIs
+- **Fully typed**: Complete TypeScript support with types from `@cranberry-money/shared-types`
 
 ## 🚀 Quick Start
 
 ### Installation
 
 ```bash
-npm install @cranberry-money/shared-services@^3.0.0
+npm install @cranberry-money/shared-services
 ```
 
-### Basic Setup
+### Basic Usage
 
-```typescript
-import {
-  createWebServiceFactory,
-  initializeFeatureFlags
-} from '@cranberry-money/shared-services';
-
-// 1. Initialize feature flags (optional but recommended)
-await initializeFeatureFlags({
-  useFunctionalApiClient: true,
-  useFunctionalAuth: true,
-  useFunctionalPortfolios: true,
-  enablePerformanceMonitoring: true,
-});
-
-// 2. Create service factory
-const services = createWebServiceFactory('https://api.example.com', {
-  apiTimeout: 10000,
-  enableCredentials: true,
-});
-
-// 3. Set up authentication provider
-const AuthProvider = services.auth.createAuthProvider();
-
-function App() {
-  return (
-    <AuthProvider>
-      <Dashboard />
-    </AuthProvider>
-  );
-}
-```
-
-## 🏗 Architecture Overview
-
-### Service Factory Pattern
-
-The v3.0.0 architecture uses a service factory pattern that creates all services with explicit dependency injection:
+#### Web Application (with cookies)
 
 ```typescript
-// Create services with platform-specific configuration
-const services = createWebServiceFactory(apiBaseUrl, options);
+// src/services/webApiClient.ts
+import axios from 'axios';
 
-// All services are available through the factory
-const portfolios = await services.portfolio.getPortfolios();
-const apiClient = services.auth.createAuthDependencies().apiClient;
+export const webApiClient = axios.create({
+  baseURL: import.meta.env.VITE_API_URL,
+  withCredentials: true, // Use cookies for auth
+});
 ```
 
-### Pure Functional Design
-
-All operations are pure functions with explicit dependencies:
-
 ```typescript
-// Pure function with explicit dependencies
-import { signin, createWebTokenStorage } from '@cranberry-money/shared-services';
+// src/services/portfolios.ts
+import { webApiClient } from './webApiClient';
+import { createPortfolioService } from '@cranberry-money/shared-services';
 
-const authDeps = {
-  apiClient: services.auth.createAuthDependencies().apiClient,
-  tokenStorage: createWebTokenStorage(),
-};
+// Create your platform-specific service
+export const portfolioService = createPortfolioService(webApiClient);
 
-const result = await signin(credentials, authDeps);
+// Use in your application
+const portfolios = await portfolioService.getAll();
+const portfolio = await portfolioService.create({ name: 'My Portfolio' });
 ```
 
-## 🔐 Authentication
-
-### React Context Integration
-
-```typescript
-import {
-  useFunctionalAuthState,
-  useFunctionalAuthActions,
-  FunctionalAuthGuard
-} from '@cranberry-money/shared-services';
-
-function Dashboard() {
-  const authState = useFunctionalAuthState();
-  const authActions = useFunctionalAuthActions();
-
-  const handleSignin = async () => {
-    try {
-      await authActions.signin({
-        email: 'user@example.com',
-        password: 'password123',
-      });
-    } catch (error) {
-      console.error('Signin failed:', error);
-    }
-  };
-
-  return (
-    <FunctionalAuthGuard fallback={<LoginForm />}>
-      <div>
-        <h1>Welcome, {authState.user?.firstName}!</h1>
-        <button onClick={authActions.signout}>Sign Out</button>
-      </div>
-    </FunctionalAuthGuard>
-  );
-}
-```
-
-### Platform-Specific Token Storage
+#### Mobile Application (with tokens)
 
 ```typescript
-// Web (localStorage)
-import { createWebTokenStorage } from '@cranberry-money/shared-services';
-const webStorage = createWebTokenStorage();
-
-// Mobile (secure storage)
-import { createMobileTokenStorage } from '@cranberry-money/shared-services';
+// src/services/mobileApiClient.ts
+import axios from 'axios';
 import * as SecureStore from 'expo-secure-store';
-const mobileStorage = createMobileTokenStorage(SecureStore);
-
-// Testing (in-memory)
-import { createMemoryTokenStorage } from '@cranberry-money/shared-services';
-const testStorage = createMemoryTokenStorage();
-```
-
-## 🌐 API Client
-
-### Functional API Client
-
-```typescript
-import { createFunctionalApiClient } from '@cranberry-money/shared-services';
-
-const apiClient = createFunctionalApiClient({
-  baseURL: 'https://api.example.com',
-  timeout: 10000,
-  defaultHeaders: {
-    'X-Client-Version': '3.0.0',
-  },
-});
 
-// Make requests
-const data = await apiClient.get('/api/data');
-const result = await apiClient.post('/api/items', { name: 'Item' });
-```
-
-### Platform-Specific Clients
-
-```typescript
-// Web-optimized client
-import { createFunctionalWebApiClient } from '@cranberry-money/shared-services';
-const webClient = createFunctionalWebApiClient('https://api.example.com');
-
-// Mobile-optimized client
-import { createFunctionalMobileApiClient } from '@cranberry-money/shared-services';
-const mobileClient = createFunctionalMobileApiClient('https://api.example.com');
-```
-
-## 💼 Service Usage
-
-### Portfolio Services
-
-```typescript
-// Get portfolios with filtering and sorting
-const portfolios = await services.portfolio.getPortfolios({
-  isActive: true,
-  sortBy: 'totalValue',
-  sortOrder: 'desc',
-});
-
-// Create new portfolio
-const newPortfolio = await services.portfolio.createPortfolio({
-  name: 'My Investment Portfolio',
-  description: 'Long-term growth strategy',
+export const mobileApiClient = axios.create({
+  baseURL: process.env.API_URL,
 });
 
-// Update portfolio
-const updated = await services.portfolio.updatePortfolio('portfolio-id', {
-  name: 'Updated Portfolio Name',
-  isActive: true,
+// Add auth token to requests
+mobileApiClient.interceptors.request.use(async (config) => {
+  const token = await SecureStore.getItemAsync('authToken');
+  if (token) {
+    config.headers.Authorization = `Bearer ${token}`;
+  }
+  return config;
 });
 ```
 
-### Reference Data Services
-
 ```typescript
-import { createReferenceDataMigration } from '@cranberry-money/shared-services';
-
-const referenceData = createReferenceDataMigration(services);
+// src/services/portfolios.ts
+import { mobileApiClient } from './mobileApiClient';
+import { createPortfolioService } from '@cranberry-money/shared-services';
 
-// Get countries, industries, sectors, stock exchanges
-const countries = await referenceData.getActiveCountries();
-const industries = await referenceData.getIndustries();
-const sectors = await referenceData.getSectorsByIndustry('tech-industry-id');
-const exchanges = await referenceData.getStockExchangesByCountry('usa-id');
+export const portfolioService = createPortfolioService(mobileApiClient);
 ```
 
-## 🚦 Migration from v2.x
+## 📚 Service Patterns
 
-### Feature Flag Migration
+### Pattern 1: Service Factory (Recommended)
 
-```typescript
-// Start with all functional features disabled
-await initializeFeatureFlags({
-  useFunctionalApiClient: false,
-  useFunctionalAuth: false,
-  useFunctionalPortfolios: false,
-});
-
-// Enable gradually
-const flags = getFeatureFlags();
-await flags.updateFlags({ useFunctionalApiClient: true });
-// Test for 1-2 days...
-
-await flags.updateFlags({ useFunctionalPortfolios: true });
-// Test for 1-2 days...
-
-await flags.updateFlags({ useFunctionalAuth: true });
-// Complete migration
-```
-
-### Migration Helpers
+Group related operations together:
 
 ```typescript
-import { createMigrationHelpers } from '@cranberry-money/shared-services';
-
-const helpers = createMigrationHelpers(services, {
-  apiClient: legacyApiClient,
-  authManager: legacyAuthManager,
-});
+import { createPortfolioService } from '@cranberry-money/shared-services';
+import { webApiClient } from './webApiClient'; // or mobileApiClient for mobile
 
-// Use migration adapter that switches based on feature flags
-const data = await helpers.apiClient.get('/api/data');
+const portfolioService = createPortfolioService(webApiClient);
 
-// Validate migration readiness
-const validation = helpers.validateMigration();
-if (!validation.isValid) {
-  console.error('Migration issues:', validation.errors);
-}
+// All portfolio operations in one object
+await portfolioService.getAll({ page: 1 });
+await portfolioService.getByUuid('123');
+await portfolioService.create({ name: 'Tech Portfolio' });
+await portfolioService.update('123', { name: 'Updated Portfolio' });
+await portfolioService.delete('123');
 ```
 
-## 📊 Performance Monitoring
+### Pattern 2: Individual Functions
 
-### Built-in Benchmarking
+For better tree-shaking and selective imports:
 
 ```typescript
-import { runQuickPerformanceCheck, runComprehensivePerformanceAnalysis } from '@cranberry-money/shared-services';
+import { getPortfolios, createPortfolio } from '@cranberry-money/shared-services';
+import { webApiClient } from './webApiClient'; // or mobileApiClient for mobile
 
-// Quick performance check
-const quickReport = await runQuickPerformanceCheck();
-console.log(quickReport);
+// Create platform-specific functions
+const getMyPortfolios = getPortfolios(webApiClient);
+const createMyPortfolio = createPortfolio(webApiClient);
 
-// Comprehensive analysis
-const detailedReport = await runComprehensivePerformanceAnalysis();
-console.log(detailedReport);
-```
-
-### Performance Tracking
-
-```typescript
-import { monitorMigrationPerformance } from '@cranberry-money/shared-services';
-
-// Wrap functions for automatic performance tracking
-const monitored = monitorMigrationPerformance('api.getPortfolios', 'functional', () =>
-  services.portfolio.getPortfolios()
-);
-
-const result = await monitored();
-// Automatically logs performance metrics
+// Use them
+await getMyPortfolios({ page: 1 });
+await createMyPortfolio({ name: 'New Portfolio' });
 ```
 
 ## 🧪 Testing
 
-### Pure Function Testing
-
-```typescript
-import { signin, createMemoryTokenStorage } from '@cranberry-money/shared-services';
-
-describe('Authentication', () => {
-  it('should signin successfully', async () => {
-    const mockApiClient = {
-      post: jest.fn().mockResolvedValue({
-        access: 'access-token',
-        refresh: 'refresh-token',
-        user: { id: '1', email: 'test@example.com' },
-      }),
-    };
-
-    const deps = {
-      apiClient: mockApiClient,
-      tokenStorage: createMemoryTokenStorage(),
-    };
-
-    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/', {
-      email: 'test@example.com',
-      password: 'password',
-    });
-  });
-});
-```
-
-### React Testing
+Services are easy to test with mock API clients:
 
 ```typescript
-import { render, screen } from '@testing-library/react';
-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>;
-};
-
-test('should display user name when authenticated', () => {
-  render(
-    <TestAuthProvider>
-      <Dashboard />
-    </TestAuthProvider>
-  );
-
-  // Test auth-dependent component
-});
-```
-
-## 🔧 Configuration
-
-### Web Application Setup
-
-```typescript
-import { createWebServiceFactory } from '@cranberry-money/shared-services';
-
-const services = createWebServiceFactory(process.env.REACT_APP_API_URL, {
-  apiTimeout: 15000,
-  enableCredentials: true,
-});
-
-export { services };
-```
-
-### Mobile Application Setup
-
-```typescript
-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,
-});
-
-export { services };
-```
-
-### Environment-Based Configuration
-
-```typescript
-const getApiUrl = () => {
-  switch (process.env.NODE_ENV) {
-    case 'production':
-      return 'https://api.myportfolio.com';
-    case 'staging':
-      return 'https://staging-api.myportfolio.com';
-    default:
-      return 'http://localhost:8000';
-  }
-};
-
-const services = createWebServiceFactory(getApiUrl());
-```
-
-## 📚 Advanced Usage
+import { createPortfolioService } from '@cranberry-money/shared-services';
+
+describe('Portfolio Service', () => {
+  const mockApiClient = {
+    get: jest.fn(),
+    post: jest.fn(),
+    patch: jest.fn(),
+    delete: jest.fn()
+  };
 
-### Custom Service Factory
+  const portfolioService = createPortfolioService(mockApiClient);
 
-```typescript
-import { createServiceFactory } from '@cranberry-money/shared-services';
-
-const customServices = createServiceFactory({
-  platform: {
-    platform: 'web',
-    apiBaseUrl: 'https://custom-api.com',
-    apiTimeout: 5000,
-  },
+  it('should fetch portfolios', async () => {
+    mockApiClient.get.mockResolvedValue({ 
+      data: { results: [], count: 0 } 
+    });
+    
+    const result = await portfolioService.getAll();
+    
+    expect(mockApiClient.get).toHaveBeenCalledWith('/api/portfolios/', {
+      params: undefined
+    });
+  });
 });
 ```
 
-### Error Handling
+## 🔄 React Query Integration
 
-```typescript
-import { isFunctionalApiError } from '@cranberry-money/shared-services';
-
-try {
-  const data = await services.portfolio.getPortfolios();
-} catch (error) {
-  if (isFunctionalApiError(error)) {
-    console.error(`API Error (${error.status}): ${error.message}`);
-    if (error.details) {
-      console.error('Details:', error.details);
-    }
-  } else {
-    console.error('Unexpected error:', error);
-  }
-}
-```
-
-### Integration with React Query
+Works seamlessly with React Query:
 
 ```typescript
 import { useQuery, useMutation, useQueryClient } from '@tanstack/react-query';
+import { portfolioService } from '@services/portfolios';
 
-function usePortfolios() {
+export const usePortfolios = (params?) => {
   return useQuery({
-    queryKey: ['portfolios'],
-    queryFn: () =>
-      services.portfolio.getPortfolios({
-        isActive: true,
-        sortBy: 'totalValue',
-        sortOrder: 'desc',
-      }),
-    staleTime: 5 * 60 * 1000, // 5 minutes
+    queryKey: ['portfolios', params],
+    queryFn: () => portfolioService.getAll(params),
+    staleTime: 5 * 60 * 1000,
   });
-}
+};
 
-function useCreatePortfolio() {
+export const useCreatePortfolio = () => {
   const queryClient = useQueryClient();
-
+  
   return useMutation({
-    mutationFn: data => services.portfolio.createPortfolio(data),
+    mutationFn: portfolioService.create,
     onSuccess: () => {
       queryClient.invalidateQueries({ queryKey: ['portfolios'] });
     },
   });
-}
+};
 ```
 
-## 📖 Documentation
-
-- **[Migration Guide](../../docs/MIGRATION-V3.md)**: Complete guide for migrating from v2.x
-- **[Architecture Overview](../../docs/ARCHITECTURE.md)**: Detailed architecture documentation
-- **[Best Practices](../../docs/BEST-PRACTICES.md)**: Code standards and patterns
-- **[Service Development Guide](../../docs/SERVICE-DEVELOPMENT-GUIDE.md)**: Creating new services
-
-## 🛠 Development
-
-```bash
-# Install dependencies
-npm install
+## 🌐 Available Services
 
-# Build the package
-npm run build
+### Financial Services
+- `createPortfolioService` - Portfolio management
+- `createAccountService` - Account operations
+- `createTradeService` - Trading operations
+- `createInstrumentService` - Financial instruments
+- `createWithdrawalService` - Withdrawal requests
 
-# Run tests
-npm run test
+### Banking Services
+- `createBankService` - Bank management
+- `createCashAccountService` - Cash accounts
+- `createTransactionService` - Transactions
 
-# Run tests with coverage
-npm run test:coverage
+### User & Compliance
+- `createAuthService` - Authentication
+- `createUserService` - User profiles
+- `createDocumentService` - Documents
+- `createTaxResidencyService` - Tax information
+- `createInvestmentPreferenceService` - Investment preferences
 
-# Type check
-npm run typecheck
+### Reference Data
+- `createCountryService` - Country data
+- `createIndustryService` - Industries
+- `createSectorService` - Sectors
+- `createStockExchangeService` - Stock exchanges
 
-# Lint code
-npm run lint
-```
+## 📦 API Client Requirements
 
-## 📦 Package Structure
+Your API client must implement this interface:
 
-```
-src/
-├── api/                    # Functional API client
-│   ├── functional-client.ts
-│   └── __tests__/
-├── auth/                   # Authentication system
-│   ├── functional/         # Pure auth functions
-│   ├── react/             # React integration
-│   └── __tests__/
-├── services/              # Service factories
-│   ├── factories/         # Factory pattern implementation
-│   └── __tests__/
-├── migration/             # Migration utilities
-│   ├── domains/           # Domain-specific migrations
-│   ├── feature-flags.ts   # Feature flag system
-│   ├── migration-helpers.ts
-│   └── __tests__/
-├── integration/           # Integration examples
-│   ├── blueberry-integration.tsx
-│   ├── performance-benchmark.ts
-│   └── __tests__/
-└── index.ts              # Main exports
+```typescript
+interface ApiClient {
+  get<T>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+  post<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+  put<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+  patch<T>(url: string, data?: any, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+  delete<T>(url: string, config?: AxiosRequestConfig): Promise<AxiosResponse<T>>;
+}
 ```
 
-## 🔗 Dependencies
+Any axios instance automatically satisfies this interface.
 
-### Required
+## 🔗 Related Packages
 
-- `axios` - HTTP client library
-- `react` >=18.0.0 - React framework (peer dependency)
-- `typescript` >=4.5.0 - TypeScript support (peer dependency)
+- `@cranberry-money/shared-types` - TypeScript type definitions
+- `@cranberry-money/shared-constants` - API endpoints and business constants
+- `@cranberry-money/shared-utils` - Utility functions for formatting and validation
 
-### Optional
+## 💡 Migration from Local Services
 
-- `@tanstack/react-query` - For optimized data fetching
-- `expo-secure-store` - For mobile secure storage
+If you're currently using local service implementations in your app:
 
-## 🆙 Version Support
+### Before (Local Implementation)
+```typescript
+// src/services/portfolios.ts
+import webApiClient from './webApiClient';
 
-- **v3.x**: Current (Active development)
-- **v2.x**: Legacy (Security fixes only, 6 months)
-- **v1.x**: End of life
+export const getPortfolios = (params?) => {
+  return webApiClient.get('/api/portfolios/', { params });
+};
+```
 
-## 🤝 Contributing
+### After (Shared Implementation)
+```typescript
+// src/services/portfolios.ts
+import webApiClient from './webApiClient';
+import { createPortfolioService } from '@cranberry-money/shared-services';
 
-1. Fork the repository
-2. Create a feature branch (`git checkout -b feature/amazing-feature`)
-3. Commit your changes (`git commit -m 'Add amazing feature'`)
-4. Push to the branch (`git push origin feature/amazing-feature`)
-5. Open a Pull Request
+export const portfolioService = createPortfolioService(webApiClient);
+// or
+export const { getAll: getPortfolios } = createPortfolioService(webApiClient);
+```
 
 ## 📄 License
 
 MIT License - see the [LICENSE](LICENSE) file for details.
 
-## 🙏 Acknowledgments
-
-- 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.
+For complete documentation and architecture details, see the [Cranberry Development Guide](../../docs/CRANBERRY-DEVELOPMENT-GUIDE.md).

package/dist/auth.d.ts

@@ -0,0 +1,85 @@
+/**
+ * Platform-agnostic authentication service functions.
+ * Works with any axios-compatible API client.
+ */
+import { AxiosInstance, AxiosResponse } from 'axios';
+import type { SigninPayload, SignupPayload, EmailVerificationPayload, TokenRefreshData as TokenRefreshResponse, TokenRefreshPayload } from '@cranberry-money/shared-types';
+/**
+ * Individual authentication functions with dependency injection
+ */
+/**
+ * Sign in a user
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts signin payload and returns API response
+ */
+export declare const signin: (apiClient: AxiosInstance) => (data: SigninPayload) => Promise<AxiosResponse>;
+/**
+ * Sign out the current user
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that performs signout
+ */
+export declare const signout: (apiClient: AxiosInstance) => () => Promise<AxiosResponse>;
+/**
+ * Sign up a new user
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts signup payload and returns API response
+ */
+export declare const signup: (apiClient: AxiosInstance) => (data: SignupPayload) => Promise<AxiosResponse>;
+/**
+ * Verify user's email with verification code
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts verification payload and returns API response
+ */
+export declare const verifyEmail: (apiClient: AxiosInstance) => (data: EmailVerificationPayload) => Promise<AxiosResponse>;
+/**
+ * Resend email verification code
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that performs resend operation
+ */
+export declare const resendVerificationCode: (apiClient: AxiosInstance) => () => Promise<AxiosResponse>;
+/**
+ * Refresh authentication token
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts refresh payload and returns token response
+ */
+export declare const refreshToken: (apiClient: AxiosInstance) => (data: TokenRefreshPayload) => Promise<AxiosResponse<TokenRefreshResponse>>;
+/**
+ * Authentication service interface
+ */
+export interface AuthService {
+    signin: (data: SigninPayload) => Promise<AxiosResponse>;
+    signout: () => Promise<AxiosResponse>;
+    signup: (data: SignupPayload) => Promise<AxiosResponse>;
+    verifyEmail: (data: EmailVerificationPayload) => Promise<AxiosResponse>;
+    resendVerificationCode: () => Promise<AxiosResponse>;
+    refreshToken: (data: TokenRefreshPayload) => Promise<AxiosResponse<TokenRefreshResponse>>;
+}
+/**
+ * Create a complete authentication service with all operations
+ * @param apiClient - Axios-compatible API client
+ * @returns Object containing all auth operations
+ *
+ * @example
+ * // Web application with cookies
+ * const webApiClient = axios.create({
+ *   baseURL: 'https://api.example.com',
+ *   withCredentials: true
+ * });
+ * const authService = createAuthService(webApiClient);
+ * await authService.signin({ email: 'user@example.com', password: 'pass' });
+ *
+ * @example
+ * // Mobile application with tokens
+ * const mobileApiClient = axios.create({
+ *   baseURL: 'https://api.example.com'
+ * });
+ * // Add token interceptor for mobile
+ * mobileApiClient.interceptors.request.use(async (config) => {
+ *   const token = await getStoredToken();
+ *   if (token) config.headers.Authorization = `Bearer ${token}`;
+ *   return config;
+ * });
+ * const authService = createAuthService(mobileApiClient);
+ */
+export declare const createAuthService: (apiClient: AxiosInstance) => AuthService;
+//# sourceMappingURL=auth.d.ts.map

package/dist/auth.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.d.ts","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,aAAa,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAErD,OAAO,KAAK,EACV,aAAa,EACb,aAAa,EACb,wBAAwB,EACxB,gBAAgB,IAAI,oBAAoB,EACxC,mBAAmB,EACpB,MAAM,+BAA+B,CAAC;AAEvC;;GAEG;AAEH;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,WAAW,aAAa,MACrC,MAAM,aAAa,KAAG,OAAO,CAAC,aAAa,CAGpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,OAAO,GAAI,WAAW,aAAa,WACnC,OAAO,CAAC,aAAa,CAGjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,MAAM,GAAI,WAAW,aAAa,MACrC,MAAM,aAAa,KAAG,OAAO,CAAC,aAAa,CAGpD,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,WAAW,GAAI,WAAW,aAAa,MAC1C,MAAM,wBAAwB,KAAG,OAAO,CAAC,aAAa,CAG/D,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,sBAAsB,GAAI,WAAW,aAAa,WAClD,OAAO,CAAC,aAAa,CAGjC,CAAC;AAEF;;;;GAIG;AACH,eAAO,MAAM,YAAY,GAAI,WAAW,aAAa,MAC3C,MAAM,mBAAmB,KAAG,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAGhF,CAAC;AAEF;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,OAAO,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACtC,MAAM,EAAE,CAAC,IAAI,EAAE,aAAa,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACxD,WAAW,EAAE,CAAC,IAAI,EAAE,wBAAwB,KAAK,OAAO,CAAC,aAAa,CAAC,CAAC;IACxE,sBAAsB,EAAE,MAAM,OAAO,CAAC,aAAa,CAAC,CAAC;IACrD,YAAY,EAAE,CAAC,IAAI,EAAE,mBAAmB,KAAK,OAAO,CAAC,aAAa,CAAC,oBAAoB,CAAC,CAAC,CAAC;CAC3F;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,eAAO,MAAM,iBAAiB,GAAI,WAAW,aAAa,KAAG,WAS5D,CAAC"}

package/dist/auth.js

@@ -0,0 +1,106 @@
+/**
+ * Platform-agnostic authentication service functions.
+ * Works with any axios-compatible API client.
+ */
+import { AUTH_ENDPOINTS } from '@cranberry-money/shared-constants';
+/**
+ * Individual authentication functions with dependency injection
+ */
+/**
+ * Sign in a user
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts signin payload and returns API response
+ */
+export const signin = (apiClient) => {
+    return (data) => {
+        return apiClient.post(AUTH_ENDPOINTS.SIGNIN, data);
+    };
+};
+/**
+ * Sign out the current user
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that performs signout
+ */
+export const signout = (apiClient) => {
+    return () => {
+        return apiClient.post(AUTH_ENDPOINTS.SIGNOUT);
+    };
+};
+/**
+ * Sign up a new user
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts signup payload and returns API response
+ */
+export const signup = (apiClient) => {
+    return (data) => {
+        return apiClient.post(AUTH_ENDPOINTS.SIGNUP, data);
+    };
+};
+/**
+ * Verify user's email with verification code
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts verification payload and returns API response
+ */
+export const verifyEmail = (apiClient) => {
+    return (data) => {
+        return apiClient.post(AUTH_ENDPOINTS.EMAIL_VERIFICATION, data);
+    };
+};
+/**
+ * Resend email verification code
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that performs resend operation
+ */
+export const resendVerificationCode = (apiClient) => {
+    return () => {
+        return apiClient.post(AUTH_ENDPOINTS.RESEND_VERIFICATION);
+    };
+};
+/**
+ * Refresh authentication token
+ * @param apiClient - Axios-compatible API client
+ * @returns Function that accepts refresh payload and returns token response
+ */
+export const refreshToken = (apiClient) => {
+    return (data) => {
+        return apiClient.post(AUTH_ENDPOINTS.TOKEN_REFRESH, data);
+    };
+};
+/**
+ * Create a complete authentication service with all operations
+ * @param apiClient - Axios-compatible API client
+ * @returns Object containing all auth operations
+ *
+ * @example
+ * // Web application with cookies
+ * const webApiClient = axios.create({
+ *   baseURL: 'https://api.example.com',
+ *   withCredentials: true
+ * });
+ * const authService = createAuthService(webApiClient);
+ * await authService.signin({ email: 'user@example.com', password: 'pass' });
+ *
+ * @example
+ * // Mobile application with tokens
+ * const mobileApiClient = axios.create({
+ *   baseURL: 'https://api.example.com'
+ * });
+ * // Add token interceptor for mobile
+ * mobileApiClient.interceptors.request.use(async (config) => {
+ *   const token = await getStoredToken();
+ *   if (token) config.headers.Authorization = `Bearer ${token}`;
+ *   return config;
+ * });
+ * const authService = createAuthService(mobileApiClient);
+ */
+export const createAuthService = (apiClient) => {
+    return {
+        signin: signin(apiClient),
+        signout: signout(apiClient),
+        signup: signup(apiClient),
+        verifyEmail: verifyEmail(apiClient),
+        resendVerificationCode: resendVerificationCode(apiClient),
+        refreshToken: refreshToken(apiClient),
+    };
+};
+//# sourceMappingURL=auth.js.map

package/dist/auth.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"auth.js","sourceRoot":"","sources":["../src/auth.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EAAE,cAAc,EAAE,MAAM,mCAAmC,CAAC;AASnE;;GAEG;AAEH;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAwB,EAAE,EAAE;IACjD,OAAO,CAAC,IAAmB,EAA0B,EAAE;QACrD,OAAO,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,OAAO,GAAG,CAAC,SAAwB,EAAE,EAAE;IAClD,OAAO,GAA2B,EAAE;QAClC,OAAO,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,OAAO,CAAC,CAAC;IAChD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,CAAC,SAAwB,EAAE,EAAE;IACjD,OAAO,CAAC,IAAmB,EAA0B,EAAE;QACrD,OAAO,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,MAAM,EAAE,IAAI,CAAC,CAAC;IACrD,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,SAAwB,EAAE,EAAE;IACtD,OAAO,CAAC,IAA8B,EAA0B,EAAE;QAChE,OAAO,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,kBAAkB,EAAE,IAAI,CAAC,CAAC;IACjE,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,SAAwB,EAAE,EAAE;IACjE,OAAO,GAA2B,EAAE;QAClC,OAAO,SAAS,CAAC,IAAI,CAAC,cAAc,CAAC,mBAAmB,CAAC,CAAC;IAC5D,CAAC,CAAC;AACJ,CAAC,CAAC;AAEF;;;;GAIG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,SAAwB,EAAE,EAAE;IACvD,OAAO,CAAC,IAAyB,EAAgD,EAAE;QACjF,OAAO,SAAS,CAAC,IAAI,CAAuB,cAAc,CAAC,aAAa,EAAE,IAAI,CAAC,CAAC;IAClF,CAAC,CAAC;AACJ,CAAC,CAAC;AAcF;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,SAAwB,EAAe,EAAE;IACzE,OAAO;QACL,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC;QACzB,OAAO,EAAE,OAAO,CAAC,SAAS,CAAC;QAC3B,MAAM,EAAE,MAAM,CAAC,SAAS,CAAC;QACzB,WAAW,EAAE,WAAW,CAAC,SAAS,CAAC;QACnC,sBAAsB,EAAE,sBAAsB,CAAC,SAAS,CAAC;QACzD,YAAY,EAAE,YAAY,CAAC,SAAS,CAAC;KACtC,CAAC;AACJ,CAAC,CAAC"}

package/dist/index.d.ts

@@ -1 +1,6 @@
+/**
+ * @cranberry-money/shared-services
+ * Platform-agnostic service functions for the Blueberry platform ecosystem.
+ */
+export { signin, signout, signup, verifyEmail, resendVerificationCode, refreshToken, createAuthService, type AuthService, } from './auth';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAGH,OAAO,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,WAAW,EACX,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,EACjB,KAAK,WAAW,GACjB,MAAM,QAAQ,CAAC"}

package/dist/index.js

@@ -1,3 +1,7 @@
-"use strict";
-// Placeholder for  package
+/**
+ * @cranberry-money/shared-services
+ * Platform-agnostic service functions for the Blueberry platform ecosystem.
+ */
+// Authentication services
+export { signin, signout, signup, verifyEmail, resendVerificationCode, refreshToken, createAuthService, } from './auth';
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";AAAA,2BAA2B"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,0BAA0B;AAC1B,OAAO,EACL,MAAM,EACN,OAAO,EACP,MAAM,EACN,WAAW,EACX,sBAAsB,EACtB,YAAY,EACZ,iBAAiB,GAElB,MAAM,QAAQ,CAAC"}

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cranberry-money/shared-services",
-  "version": "8.1.3",
-  "description": "Functional architecture shared services with pure functions, dependency injection, and comprehensive TypeScript support for the Blueberry platform",
+  "version": "10.0.2",
+  "description": "Platform-agnostic API services with pure functions and dependency injection. Includes auth, portfolios, instruments, countries, sectors, and more.",
   "type": "module",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,6 +29,8 @@
     "prepublishOnly": "npm run clean && npm run typecheck && npm run build"
   },
   "dependencies": {
+    "@cranberry-money/shared-constants": "^8.1.3",
+    "@cranberry-money/shared-types": "^8.1.3",
     "axios": "^1.9.0"
   },
   "peerDependencies": {