@onivoro/isomorphic-common 24.0.0 → 24.0.2

package/dist/libs/isomorphic/axios/libs/isomorphic/axios/README.md

@@ -1,314 +0,0 @@
-# @onivoro/isomorphic-axios
-
-HTTP client utilities and Axios configuration for both browser and server environments. This package provides a comprehensive set of tools for creating configurable Axios instances with built-in retry logic, error handling, and request/response interceptors that work seamlessly across client and server codebases.
-
-## Installation
-
-```bash
-npm install @onivoro/isomorphic-axios
-```
-
-## Features
-
-- **Isomorphic Design**: Works identically in browser and Node.js environments
-- **Advanced Axios Factory**: Create pre-configured Axios instances with custom interceptors
-- **Retry Logic**: Built-in request retry mechanism with configurable delays
-- **Error Handling**: Flexible error handling with status-specific handlers
-- **Header Management**: Dynamic header setting based on request context
-- **API Client Factory**: Streamlined creation of API clients from OpenAPI specs
-- **TypeScript Support**: Full TypeScript support with comprehensive type definitions
-
-## Quick Start
-
-### Basic Axios Instance Creation
-
-```typescript
-import { createAxiosInstance } from '@onivoro/isomorphic-axios';
-
-// Create a simple axios instance
-const apiClient = createAxiosInstance({
-  apiUrl: 'https://api.example.com',
-  accessToken: 'your-token-here'
-});
-
-// Use the instance
-const response = await apiClient.get('/users');
-```
-
-### Advanced Axios Factory with Custom Configuration
-
-```typescript
-import { axiosInstanceFactory } from '@onivoro/isomorphic-axios';
-
-const axiosInstance = axiosInstanceFactory({
-  headerSetters: {
-    'Authorization': (req) => `Bearer ${getToken()}`,
-    'X-API-Key': (req) => process.env.API_KEY,
-    'Content-Type': (req) => 'application/json'
-  },
-  errorHandlers: {
-    401: async (error, response) => {
-      // Handle unauthorized errors
-      await refreshToken();
-      return retry(error);
-    },
-    500: async (error, response) => {
-      // Handle server errors
-      console.error('Server error:', response?.data);
-      throw error;
-    },
-    0: async (error, response) => {
-      // Default error handler
-      console.error('Request failed:', error.message);
-      throw error;
-    }
-  },
-  beforeRetryHandlers: {
-    429: async (error, response) => {
-      // Handle rate limiting before retry
-      const retryAfter = response?.headers['retry-after'];
-      if (retryAfter) {
-        await new Promise(resolve => setTimeout(resolve, retryAfter * 1000));
-      }
-    }
-  },
-  axiosConfigOverride: {
-    timeout: 10000,
-    retry: 3,
-    retryDelay: 2000
-  }
-});
-```
-
-## Usage Examples
-
-### Creating API Clients
-
-```typescript
-import { createApi } from '@onivoro/isomorphic-axios';
-import { DefaultApi } from './generated-client';
-
-// Create an API client from generated OpenAPI client
-const apiClient = createApi(DefaultApi, {
-  apiUrl: 'https://api.example.com',
-  accessToken: 'your-token'
-});
-
-// Use the generated API methods
-const users = await apiClient.getUsers();
-const user = await apiClient.createUser({ name: 'John Doe' });
-```
-
-### Manual Retry Logic
-
-```typescript
-import { retryAxiosCall } from '@onivoro/isomorphic-axios';
-import axios from 'axios';
-
-const instance = axios.create();
-
-instance.interceptors.response.use(
-  response => response,
-  async (error) => {
-    if (shouldRetry(error)) {
-      return retryAxiosCall(error, instance);
-    }
-    throw error;
-  }
-);
-```
-
-### Environment-Specific Configuration
-
-```typescript
-import { createAxiosInstance } from '@onivoro/isomorphic-axios';
-
-// Browser environment
-const browserClient = createAxiosInstance({
-  apiUrl: window.location.origin + '/api',
-  accessToken: localStorage.getItem('token')
-});
-
-// Server environment
-const serverClient = createAxiosInstance({
-  apiUrl: process.env.INTERNAL_API_URL,
-  accessToken: process.env.SERVICE_TOKEN
-});
-```
-
-### Request/Response Interceptors
-
-```typescript
-import { axiosInstanceFactory } from '@onivoro/isomorphic-axios';
-
-const client = axiosInstanceFactory({
-  headerSetters: {
-    'X-Request-ID': () => generateRequestId(),
-    'X-User-Agent': () => getUserAgent(),
-    'X-Timestamp': () => new Date().toISOString()
-  },
-  errorHandlers: {
-    // Retry on network errors
-    0: async (error) => {
-      if (error.code === 'NETWORK_ERROR') {
-        throw new Error('Network connection failed');
-      }
-      throw error;
-    },
-    // Handle authentication errors
-    401: async (error) => {
-      await signOut();
-      window.location.href = '/login';
-      throw error;
-    },
-    // Handle validation errors
-    422: async (error) => {
-      const validationErrors = error.response?.data?.errors;
-      throw new ValidationError(validationErrors);
-    }
-  }
-});
-```
-
-## API Reference
-
-### Functions
-
-#### `axiosInstanceFactory<TData>(params)`
-
-Creates a fully configured Axios instance with interceptors, retry logic, and error handling.
-
-**Parameters:**
-- `headerSetters`: Object mapping header names to functions that return header values
-- `errorHandlers`: Object mapping HTTP status codes to error handling functions
-- `beforeRetryHandlers`: Object mapping status codes to functions called before retries
-- `axiosConfigOverride`: Optional Axios configuration overrides
-
-**Returns:** Configured Axios instance
-
-#### `createApi<TApi>(DefaultApi, config)`
-
-Creates an API client instance from a generated OpenAPI client class.
-
-**Parameters:**
-- `DefaultApi`: Constructor function for the generated API client
-- `config`: API configuration object with `apiUrl` and optional `accessToken`
-
-**Returns:** Configured API client instance
-
-#### `createAxiosInstance(config)`
-
-Creates a simple Axios instance with basic authentication and URL configuration.
-
-**Parameters:**
-- `config`: Configuration object with `apiUrl` and optional `accessToken`
-
-**Returns:** Configured Axios instance
-
-#### `retryAxiosCall<TData>(error, instance)`
-
-Manually retry a failed Axios request with exponential backoff.
-
-**Parameters:**
-- `error`: The error object from the failed request
-- `instance`: The Axios instance to use for the retry
-
-**Returns:** Promise resolving to the retry response
-
-### Types
-
-#### `TApiConfig`
-
-Configuration interface for API clients:
-```typescript
-interface TApiConfig {
-  apiUrl: string;
-  accessToken?: string;
-}
-```
-
-#### `THeaderSetterMap<TData>`
-
-Map of header names to functions that set header values:
-```typescript
-type THeaderSetterMap<TData> = {
-  [headerName: string]: (request: AxiosRequestConfig) => string;
-};
-```
-
-#### `TErrorHandlerMap<TData>`
-
-Map of HTTP status codes to error handling functions:
-```typescript
-type TErrorHandlerMap<TData> = {
-  [statusCode: number]: TErrorHandler<TData>;
-};
-```
-
-### Constants
-
-#### `defaultAxiosConfig`
-
-Default Axios configuration with sensible defaults:
-```typescript
-{
-  timeout: 30000,
-  retry: 2,
-  retryDelay: 1000
-}
-```
-
-## Advanced Configuration
-
-### Custom Error Recovery
-
-```typescript
-import { axiosInstanceFactory } from '@onivoro/isomorphic-axios';
-
-const resilientClient = axiosInstanceFactory({
-  errorHandlers: {
-    // Implement circuit breaker pattern
-    0: async (error) => {
-      if (circuitBreaker.isOpen()) {
-        throw new Error('Circuit breaker is open');
-      }
-      circuitBreaker.recordFailure();
-      throw error;
-    }
-  },
-  beforeRetryHandlers: {
-    // Implement exponential backoff with jitter
-    0: async (error) => {
-      const attempt = error.config.__retryCount || 0;
-      const delay = Math.min(1000 * Math.pow(2, attempt), 30000);
-      const jitter = Math.random() * 1000;
-      await new Promise(resolve => setTimeout(resolve, delay + jitter));
-    }
-  }
-});
-```
-
-### Request/Response Logging
-
-```typescript
-const debugClient = axiosInstanceFactory({
-  headerSetters: {
-    'X-Debug-Mode': () => process.env.NODE_ENV === 'development' ? 'true' : 'false'
-  },
-  errorHandlers: {
-    0: async (error) => {
-      console.error('Request failed:', {
-        url: error.config?.url,
-        method: error.config?.method,
-        status: error.response?.status,
-        data: error.response?.data
-      });
-      throw error;
-    }
-  }
-});
-```
-
-## License
-
-MIT

package/dist/libs/isomorphic/axios/libs/isomorphic/axios/package.json

@@ -1,10 +0,0 @@
-{
-  "name": "@onivoro/isomorphic-axios",
-  "version": "23.0.0",
-  "type": "commonjs",
-  "main": "./src/index.js",
-  "types": "./src/index.d.ts",
-  "dependencies": {
-    "tslib": "^2.3.0"
-  }
-}

package/dist/libs/isomorphic/common/libs/isomorphic/common/README.md

@@ -1,393 +0,0 @@
-# @onivoro/isomorphic-common
-
-Common utilities, functions, types, and constants shared between browser and server environments. This comprehensive library provides essential building blocks for TypeScript applications with a focus on type safety, reliability, and consistent behavior across different runtime environments.
-
-## Installation
-
-```bash
-npm install @onivoro/isomorphic-common
-```
-
-## Features
-
-- **Isomorphic Design**: Works identically in browser and Node.js environments
-- **String Manipulation**: Case conversion, formatting, and validation utilities
-- **Array Operations**: Chunking, sorting, deduplication, and transformation functions
-- **Date/Time Utilities**: Calendar operations, offset calculations, and formatting
-- **Financial Functions**: Currency formatting, money calculations, and validation
-- **Type Utilities**: Advanced TypeScript type helpers and interfaces
-- **Validation Functions**: Data validation and parsing utilities
-- **Testing Helpers**: Mock functions and test arrangement utilities
-- **Constants**: Common values, regex patterns, and configuration constants
-
-## Quick Start
-
-### String Operations
-
-```typescript
-import { 
-  camelCase, 
-  kebabCase, 
-  snakeCase, 
-  upperFirst,
-  sanitizeFilename,
-  formatUsd 
-} from '@onivoro/isomorphic-common';
-
-// Case conversions
-camelCase('hello world'); // 'helloWorld'
-kebabCase('Hello World'); // 'hello-world'
-snakeCase('Hello World'); // 'hello_world'
-upperFirst('hello'); // 'Hello'
-
-// File operations
-sanitizeFilename('My File/Name?.txt'); // 'My File Name .txt'
-
-// Currency formatting
-formatUsd(1234.56); // '$1,234.56'
-formatUsd('1234.56'); // '$1,234.56'
-```
-
-### Array Manipulation
-
-```typescript
-import { 
-  chunk, 
-  toUniqueArray, 
-  removeElementAtIndex,
-  sortByName,
-  sortById,
-  sortNumbers
-} from '@onivoro/isomorphic-common';
-
-// Chunking arrays
-chunk([1, 2, 3, 4, 5, 6], 3); // [[1, 2], [3, 4], [5, 6]]
-
-// Remove duplicates
-toUniqueArray([1, 2, 2, 3, 3, 4]); // [1, 2, 3, 4]
-
-// Remove element by index
-removeElementAtIndex(['a', 'b', 'c'], 1); // ['a', 'c']
-
-// Sorting utilities
-sortByName([{name: 'Bob'}, {name: 'Alice'}]); // [{name: 'Alice'}, {name: 'Bob'}]
-sortById([{id: 3}, {id: 1}, {id: 2}]); // [{id: 1}, {id: 2}, {id: 3}]
-sortNumbers([3, 1, 4, 1, 5]); // [1, 1, 3, 4, 5]
-```
-
-### Date and Time Operations
-
-```typescript
-import { 
-  addOffset, 
-  subtractOffset,
-  getDateRangeForMonth,
-  splitDateRangeIntoDays,
-  isValidDate,
-  tryParseDate,
-  toCalendarDate,
-  fromCalendarDate
-} from '@onivoro/isomorphic-common';
-
-// Date offset calculations
-const date = new Date('2023-01-15');
-addOffset(date, 7); // Add 7 days
-subtractOffset(date, 2); // Subtract 2 days
-
-// Monthly date ranges
-getDateRangeForMonth(2023, 0); // January 2023 range
-
-// Date validation
-isValidDate(new Date('2023-01-15')); // true
-isValidDate(new Date('invalid')); // false
-
-// Safe date parsing
-tryParseDate('2023-01-15'); // Date object or null
-```
-
-### Financial and Money Operations
-
-```typescript
-import { 
-  money, 
-  toDollarsAndCents,
-  round,
-  formatUsd 
-} from '@onivoro/isomorphic-common';
-
-// Money calculations (in cents)
-const price = money(19.99); // 1999 cents
-const tax = money(price * 0.08); // Calculate tax
-const total = price + tax;
-
-// Convert back to dollars
-toDollarsAndCents(total); // { dollars: 21, cents: 59 }
-
-// Rounding
-round(19.999, 2); // 20.00
-round(19.994, 2); // 19.99
-
-// Currency display
-formatUsd(total / 100); // '$21.59'
-```
-
-## Usage Examples
-
-### Data Transformation
-
-```typescript
-import { 
-  mapEnumToOptions,
-  mapEntitiesToOptions,
-  convertObjectToLiteral,
-  propertiestoArray
-} from '@onivoro/isomorphic-common';
-
-enum Status {
-  ACTIVE = 'active',
-  INACTIVE = 'inactive',
-  PENDING = 'pending'
-}
-
-// Convert enum to dropdown options
-const statusOptions = mapEnumToOptions(Status);
-// [{ label: 'Active', value: 'active' }, ...]
-
-// Convert entities to options
-const users = [{ id: 1, name: 'John' }, { id: 2, name: 'Jane' }];
-const userOptions = mapEntitiesToOptions(users, 'name', 'id');
-// [{ label: 'John', value: 1 }, { label: 'Jane', value: 2 }]
-```
-
-### Boolean and String Parsing
-
-```typescript
-import { 
-  parseBool,
-  fromBooleanString,
-  toBooleanString,
-  fromCsvString,
-  toCsvString
-} from '@onivoro/isomorphic-common';
-
-// Boolean parsing
-parseBool('true'); // true
-parseBool('1'); // true
-parseBool('yes'); // true
-parseBool('false'); // false
-
-// CSV operations
-const items = fromCsvString('apple,banana,cherry');
-// ['apple', 'banana', 'cherry']
-
-toCsvString(['apple', 'banana', 'cherry']);
-// 'apple,banana,cherry'
-```
-
-### Testing Utilities
-
-```typescript
-import { 
-  arrangeActAssert,
-  mockCalls 
-} from '@onivoro/isomorphic-common';
-
-// Test structure helper
-const testCase = arrangeActAssert({
-  arrange: () => ({ input: 'test data' }),
-  act: (arranged) => processData(arranged.input),
-  assert: (result) => expect(result).toBeTruthy()
-});
-
-// Mock function calls tracking
-const mockTracker = mockCalls();
-mockTracker.track('functionName', ['arg1', 'arg2']);
-mockTracker.getCalls('functionName'); // [['arg1', 'arg2']]
-```
-
-## API Reference
-
-### String Functions
-
-#### Case Conversion
-- `camelCase(string)` - Convert to camelCase
-- `kebabCase(string)` - Convert to kebab-case  
-- `snakeCase(string)` - Convert to snake_case
-- `upperFirst(string)` - Capitalize first letter
-
-#### String Utilities
-- `sanitizeFilename(filename)` - Remove invalid filename characters
-- `removeAlphaChars(string)` - Remove alphabetic characters
-- `words(string)` - Split string into words array
-- `toString(value)` - Convert value to string safely
-
-### Array Functions
-
-#### Array Manipulation
-- `chunk<T>(array, numDivisions)` - Split array into chunks
-- `toUniqueArray<T>(array)` - Remove duplicate elements
-- `removeElementAtIndex<T>(array, index)` - Remove element by index
-
-#### Sorting Functions
-- `sortByName<T>(array)` - Sort objects by name property
-- `sortById<T>(array)` - Sort objects by id property
-- `sortByFullName<T>(array)` - Sort objects by full name
-- `sortByCreatedAt<T>(array)` - Sort objects by creation date
-- `sortNumbers(array)` - Sort numeric array
-
-### Date/Time Functions
-
-#### Date Operations
-- `addOffset(date, days)` - Add days to date
-- `subtractOffset(date, days)` - Subtract days from date
-- `getDateRangeForMonth(year, month)` - Get month's date range
-- `getDateLastMonth()` - Get previous month's date
-- `splitDateRangeIntoDays(start, end)` - Split range into daily intervals
-
-#### Date Utilities
-- `isValidDate(date)` - Check if date is valid
-- `tryParseDate(string)` - Safely parse date string
-- `toCalendarDate(date)` - Convert to calendar format
-- `fromCalendarDate(string)` - Parse calendar date string
-- `useDate(date)` - React hook for date handling
-
-#### Time Constants
-- `MILLIS_PER_MINUTE` - Milliseconds in a minute
-- `MILLIS_PER_HOUR` - Milliseconds in an hour
-- `MILLIS_PER_DAY` - Milliseconds in a day
-
-### Financial Functions
-
-#### Money Operations
-- `money(amount)` - Convert dollars to cents
-- `toDollarsAndCents(cents)` - Convert cents to dollars/cents object
-- `formatUsd(amount)` - Format as USD currency
-- `round(number, precision)` - Round to decimal places
-
-### Type Utilities
-
-#### Interfaces
-- `ILookup<T>` - Key-value lookup interface
-- `IAccessToken` - Access token structure
-- `IEntityProvider<T>` - Entity provider interface
-
-#### Type Helpers
-- `KeysOf<T>` - Extract keys of type T
-- `Createable<T>` - Type for creatable entities
-- `Nameable` - Type for entities with name property
-- `Company` - Company type definition
-
-### Data Transformation
-
-#### Enum Utilities
-- `mapEnumToOptions(enum)` - Convert enum to option array
-- `mapEnumToArrayOfValues(enum)` - Convert enum to value array
-- `mapEnumToLookupArray(enum)` - Convert enum to lookup array
-
-#### Object Utilities
-- `convertObjectToLiteral(object)` - Convert to literal object
-- `propertiesToArray(object)` - Convert properties to array
-- `mapEntitiesToOptions(entities, labelKey, valueKey)` - Convert entities to options
-
-### Validation Functions
-
-#### Data Validation
-- `parseBool(value)` - Parse boolean from various formats
-- `isSymbol(value)` - Check if value is symbol
-- `tryJsonParse(string)` - Safely parse JSON
-- `tryJsonStringify(object)` - Safely stringify JSON
-
-#### String Validation
-- `fromBooleanString(string)` - Convert string to boolean
-- `toBooleanString(boolean)` - Convert boolean to string
-- `fromCsvString(string)` - Parse CSV string
-- `toCsvString(array)` - Convert array to CSV
-
-### Utility Functions
-
-#### General Utilities
-- `sleep(milliseconds)` - Async sleep function
-- `getTag(value)` - Get object type tag
-- `getUserFullName(user)` - Get user's full name
-- `toDecimalBase(number, base)` - Convert to decimal base
-
-#### Testing Helpers
-- `arrangeActAssert(config)` - Structure test cases
-- `mockCalls()` - Track mock function calls
-
-### Constants
-
-#### Headers and Authentication
-- `API_ID_HEADER` - API ID header constant
-- `API_KEY_HEADER` - API key header constant  
-- `AUTH_COOKIE_NAME` - Authentication cookie name
-
-#### Regular Expressions
-- `REGEXES` - Common regex patterns object
-
-## Advanced Usage
-
-### Custom Type Guards
-
-```typescript
-import { isSymbol, isValidDate } from '@onivoro/isomorphic-common';
-
-function processValue(value: unknown) {
-  if (isSymbol(value)) {
-    return value.toString();
-  }
-  
-  if (value instanceof Date && isValidDate(value)) {
-    return value.toISOString();
-  }
-  
-  return String(value);
-}
-```
-
-### Complex Data Transformations
-
-```typescript
-import { 
-  chunk, 
-  mapEntitiesToOptions, 
-  sortByName,
-  toUniqueArray 
-} from '@onivoro/isomorphic-common';
-
-function processUserData(users: User[]) {
-  return chunk(
-    toUniqueArray(
-      sortByName(users)
-    ),
-    10 // Process in batches of 10
-  ).map(batch => 
-    mapEntitiesToOptions(batch, 'fullName', 'id')
-  );
-}
-```
-
-### Date Range Operations
-
-```typescript
-import { 
-  getDateRangeForMonth,
-  splitDateRangeIntoDays,
-  addOffset,
-  subtractOffset 
-} from '@onivoro/isomorphic-common';
-
-function getMonthlyReportDates(year: number, month: number) {
-  const { start, end } = getDateRangeForMonth(year, month);
-  
-  // Add buffer days
-  const reportStart = subtractOffset(start, 1);
-  const reportEnd = addOffset(end, 1);
-  
-  return splitDateRangeIntoDays(reportStart, reportEnd);
-}
-```
-
-## License
-
-MIT