@actschurch/ccms-sdk 0.0.1

package/dist/utils/retry.d.ts

@@ -0,0 +1,132 @@
+/**
+ * Retry Utilities
+ * Exponential backoff, circuit breaker, and request deduplication
+ */
+/**
+ * Retry configuration
+ */
+export interface RetryConfig {
+    /** Maximum number of retry attempts (default: 3) */
+    maxRetries?: number;
+    /** Initial delay in milliseconds (default: 1000) */
+    initialDelayMs?: number;
+    /** Maximum delay in milliseconds (default: 30000) */
+    maxDelayMs?: number;
+    /** Backoff multiplier (default: 2) */
+    backoffMultiplier?: number;
+    /** Add random jitter to prevent thundering herd (default: true) */
+    jitter?: boolean;
+    /** HTTP status codes that should trigger a retry (default: [408, 429, 500, 502, 503, 504]) */
+    retryableStatuses?: number[];
+    /** Custom function to determine if error is retryable */
+    isRetryable?: (error: Error, attempt: number) => boolean;
+    /** Called before each retry attempt */
+    onRetry?: (error: Error, attempt: number, delayMs: number) => void;
+}
+/**
+ * Calculate delay with exponential backoff and optional jitter
+ */
+export declare function calculateBackoffDelay(attempt: number, config?: RetryConfig): number;
+/**
+ * Check if an error is retryable based on status code
+ */
+export declare function isRetryableError(error: Error & {
+    status?: number;
+}, config?: RetryConfig): boolean;
+/**
+ * Sleep for specified milliseconds
+ */
+export declare function sleep(ms: number): Promise<void>;
+/**
+ * Execute a function with retry logic
+ */
+export declare function withRetry<T>(fn: () => Promise<T>, config?: RetryConfig): Promise<T>;
+/**
+ * Circuit breaker state
+ */
+export type CircuitState = 'closed' | 'open' | 'half-open';
+/**
+ * Circuit breaker configuration
+ */
+export interface CircuitBreakerConfig {
+    /** Number of failures before opening circuit (default: 5) */
+    failureThreshold?: number;
+    /** Time in ms before attempting to close circuit (default: 30000) */
+    resetTimeoutMs?: number;
+    /** Number of successful calls in half-open state to close circuit (default: 1) */
+    successThreshold?: number;
+    /** Called when circuit state changes */
+    onStateChange?: (state: CircuitState, previousState: CircuitState) => void;
+}
+/**
+ * Circuit Breaker
+ * Prevents cascading failures by stopping requests when a service is failing
+ */
+export declare class CircuitBreaker {
+    private state;
+    private failures;
+    private successes;
+    private lastFailureTime;
+    private config;
+    constructor(config?: CircuitBreakerConfig);
+    /**
+     * Get current circuit state
+     */
+    getState(): CircuitState;
+    /**
+     * Check if circuit allows requests
+     */
+    canExecute(): boolean;
+    /**
+     * Record a successful call
+     */
+    recordSuccess(): void;
+    /**
+     * Record a failed call
+     */
+    recordFailure(): void;
+    /**
+     * Execute a function through the circuit breaker
+     */
+    execute<T>(fn: () => Promise<T>): Promise<T>;
+    /**
+     * Reset the circuit breaker
+     */
+    reset(): void;
+    private transitionTo;
+}
+/**
+ * Circuit breaker error
+ */
+export declare class CircuitBreakerError extends Error {
+    constructor(message: string);
+}
+/**
+ * Request deduplication
+ * Prevents duplicate in-flight requests
+ */
+export declare class RequestDeduplicator {
+    private inFlight;
+    /**
+     * Execute a request with deduplication
+     * If a request with the same key is in-flight, return its promise
+     */
+    execute<T>(key: string, fn: () => Promise<T>): Promise<T>;
+    /**
+     * Check if a request is in-flight
+     */
+    isInFlight(key: string): boolean;
+    /**
+     * Get count of in-flight requests
+     */
+    getInFlightCount(): number;
+    /**
+     * Clear all in-flight requests
+     */
+    clear(): void;
+}
+/**
+ * Create a request key from method and URL
+ */
+export declare function createRequestKey(method: string, url: string, body?: unknown): string;
+//# sourceMappingURL=retry.d.ts.map

package/dist/utils/retry.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.d.ts","sourceRoot":"","sources":["../../src/utils/retry.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH;;GAEG;AACH,MAAM,WAAW,WAAW;IAC1B,oDAAoD;IACpD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,oDAAoD;IACpD,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,qDAAqD;IACrD,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,sCAAsC;IACtC,iBAAiB,CAAC,EAAE,MAAM,CAAC;IAC3B,mEAAmE;IACnE,MAAM,CAAC,EAAE,OAAO,CAAC;IACjB,8FAA8F;IAC9F,iBAAiB,CAAC,EAAE,MAAM,EAAE,CAAC;IAC7B,yDAAyD;IACzD,WAAW,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,KAAK,OAAO,CAAC;IACzD,uCAAuC;IACvC,OAAO,CAAC,EAAE,CAAC,KAAK,EAAE,KAAK,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAC;CACpE;AAWD;;GAEG;AACH,wBAAgB,qBAAqB,CACnC,OAAO,EAAE,MAAM,EACf,MAAM,GAAE,WAAgB,GACvB,MAAM,CAoBR;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAC9B,KAAK,EAAE,KAAK,GAAG;IAAE,MAAM,CAAC,EAAE,MAAM,CAAA;CAAE,EAClC,MAAM,GAAE,WAAgB,GACvB,OAAO,CAoBT;AAED;;GAEG;AACH,wBAAgB,KAAK,CAAC,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAE/C;AAED;;GAEG;AACH,wBAAsB,SAAS,CAAC,CAAC,EAC/B,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,EACpB,MAAM,GAAE,WAAgB,GACvB,OAAO,CAAC,CAAC,CAAC,CAsCZ;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,CAAC;AAE3D;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,6DAA6D;IAC7D,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,qEAAqE;IACrE,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,kFAAkF;IAClF,gBAAgB,CAAC,EAAE,MAAM,CAAC;IAC1B,wCAAwC;IACxC,aAAa,CAAC,EAAE,CAAC,KAAK,EAAE,YAAY,EAAE,aAAa,EAAE,YAAY,KAAK,IAAI,CAAC;CAC5E;AAED;;;GAGG;AACH,qBAAa,cAAc;IACzB,OAAO,CAAC,KAAK,CAA0B;IACvC,OAAO,CAAC,QAAQ,CAAK;IACrB,OAAO,CAAC,SAAS,CAAK;IACtB,OAAO,CAAC,eAAe,CAAK;IAC5B,OAAO,CAAC,MAAM,CAA+E;gBAEjF,MAAM,GAAE,oBAAyB;IAS7C;;OAEG;IACH,QAAQ,IAAI,YAAY;IAIxB;;OAEG;IACH,UAAU,IAAI,OAAO;IAkBrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAYrB;;OAEG;IACH,aAAa,IAAI,IAAI;IAarB;;OAEG;IACG,OAAO,CAAC,CAAC,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAelD;;OAEG;IACH,KAAK,IAAI,IAAI;IAIb,OAAO,CAAC,YAAY;CAerB;AAED;;GAEG;AACH,qBAAa,mBAAoB,SAAQ,KAAK;gBAChC,OAAO,EAAE,MAAM;CAI5B;AAED;;;GAGG;AACH,qBAAa,mBAAmB;IAC9B,OAAO,CAAC,QAAQ,CAA4C;IAE5D;;;OAGG;IACG,OAAO,CAAC,CAAC,EAAE,GAAG,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,OAAO,CAAC,CAAC,CAAC,GAAG,OAAO,CAAC,CAAC,CAAC;IAgB/D;;OAEG;IACH,UAAU,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO;IAIhC;;OAEG;IACH,gBAAgB,IAAI,MAAM;IAI1B;;OAEG;IACH,KAAK,IAAI,IAAI;CAGd;AAED;;GAEG;AACH,wBAAgB,gBAAgB,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,IAAI,CAAC,EAAE,OAAO,GAAG,MAAM,CAGpF"}

package/dist/utils/retry.js

@@ -0,0 +1,253 @@
+/**
+ * Retry Utilities
+ * Exponential backoff, circuit breaker, and request deduplication
+ */
+const DEFAULT_RETRY_CONFIG = {
+    maxRetries: 3,
+    initialDelayMs: 1000,
+    maxDelayMs: 30000,
+    backoffMultiplier: 2,
+    jitter: true,
+    retryableStatuses: [408, 429, 500, 502, 503, 504],
+};
+/**
+ * Calculate delay with exponential backoff and optional jitter
+ */
+export function calculateBackoffDelay(attempt, config = {}) {
+    const { initialDelayMs = DEFAULT_RETRY_CONFIG.initialDelayMs, maxDelayMs = DEFAULT_RETRY_CONFIG.maxDelayMs, backoffMultiplier = DEFAULT_RETRY_CONFIG.backoffMultiplier, jitter = DEFAULT_RETRY_CONFIG.jitter, } = config;
+    // Exponential backoff: initialDelay * multiplier^attempt
+    let delay = initialDelayMs * Math.pow(backoffMultiplier, attempt);
+    // Cap at max delay
+    delay = Math.min(delay, maxDelayMs);
+    // Add jitter (0-50% of delay)
+    if (jitter) {
+        delay = delay * (1 + Math.random() * 0.5);
+    }
+    return Math.floor(delay);
+}
+/**
+ * Check if an error is retryable based on status code
+ */
+export function isRetryableError(error, config = {}) {
+    const { retryableStatuses = DEFAULT_RETRY_CONFIG.retryableStatuses } = config;
+    // Network errors are retryable
+    if (error.name === 'TypeError' && error.message.includes('fetch')) {
+        return true;
+    }
+    // Check status code
+    if (error.status && retryableStatuses.includes(error.status)) {
+        return true;
+    }
+    // Check for specific error codes
+    const errorCode = error.code;
+    if (errorCode === 'NETWORK_ERROR' || errorCode === 'TIMEOUT') {
+        return true;
+    }
+    return false;
+}
+/**
+ * Sleep for specified milliseconds
+ */
+export function sleep(ms) {
+    return new Promise((resolve) => setTimeout(resolve, ms));
+}
+/**
+ * Execute a function with retry logic
+ */
+export async function withRetry(fn, config = {}) {
+    const { maxRetries = DEFAULT_RETRY_CONFIG.maxRetries, isRetryable, onRetry, } = config;
+    let lastError = null;
+    for (let attempt = 0; attempt <= maxRetries; attempt++) {
+        try {
+            return await fn();
+        }
+        catch (error) {
+            lastError = error instanceof Error ? error : new Error(String(error));
+            // Check if we should retry
+            const shouldRetry = attempt < maxRetries &&
+                (isRetryable
+                    ? isRetryable(lastError, attempt)
+                    : isRetryableError(lastError, config));
+            if (!shouldRetry) {
+                throw lastError;
+            }
+            // Calculate delay
+            const delayMs = calculateBackoffDelay(attempt, config);
+            // Notify before retry
+            onRetry?.(lastError, attempt + 1, delayMs);
+            // Wait before retrying
+            await sleep(delayMs);
+        }
+    }
+    throw lastError;
+}
+/**
+ * Circuit Breaker
+ * Prevents cascading failures by stopping requests when a service is failing
+ */
+export class CircuitBreaker {
+    constructor(config = {}) {
+        this.state = 'closed';
+        this.failures = 0;
+        this.successes = 0;
+        this.lastFailureTime = 0;
+        this.config = {
+            failureThreshold: 5,
+            resetTimeoutMs: 30000,
+            successThreshold: 1,
+            ...config,
+        };
+    }
+    /**
+     * Get current circuit state
+     */
+    getState() {
+        return this.state;
+    }
+    /**
+     * Check if circuit allows requests
+     */
+    canExecute() {
+        if (this.state === 'closed') {
+            return true;
+        }
+        if (this.state === 'open') {
+            // Check if reset timeout has passed
+            if (Date.now() - this.lastFailureTime >= this.config.resetTimeoutMs) {
+                this.transitionTo('half-open');
+                return true;
+            }
+            return false;
+        }
+        // Half-open: allow limited requests
+        return true;
+    }
+    /**
+     * Record a successful call
+     */
+    recordSuccess() {
+        if (this.state === 'half-open') {
+            this.successes++;
+            if (this.successes >= this.config.successThreshold) {
+                this.transitionTo('closed');
+            }
+        }
+        else if (this.state === 'closed') {
+            // Reset failure count on success
+            this.failures = 0;
+        }
+    }
+    /**
+     * Record a failed call
+     */
+    recordFailure() {
+        this.lastFailureTime = Date.now();
+        if (this.state === 'half-open') {
+            this.transitionTo('open');
+        }
+        else if (this.state === 'closed') {
+            this.failures++;
+            if (this.failures >= this.config.failureThreshold) {
+                this.transitionTo('open');
+            }
+        }
+    }
+    /**
+     * Execute a function through the circuit breaker
+     */
+    async execute(fn) {
+        if (!this.canExecute()) {
+            throw new CircuitBreakerError('Circuit breaker is open');
+        }
+        try {
+            const result = await fn();
+            this.recordSuccess();
+            return result;
+        }
+        catch (error) {
+            this.recordFailure();
+            throw error;
+        }
+    }
+    /**
+     * Reset the circuit breaker
+     */
+    reset() {
+        this.transitionTo('closed');
+    }
+    transitionTo(newState) {
+        const previousState = this.state;
+        this.state = newState;
+        if (newState === 'closed') {
+            this.failures = 0;
+            this.successes = 0;
+        }
+        else if (newState === 'half-open') {
+            this.successes = 0;
+        }
+        if (previousState !== newState) {
+            this.config.onStateChange?.(newState, previousState);
+        }
+    }
+}
+/**
+ * Circuit breaker error
+ */
+export class CircuitBreakerError extends Error {
+    constructor(message) {
+        super(message);
+        this.name = 'CircuitBreakerError';
+    }
+}
+/**
+ * Request deduplication
+ * Prevents duplicate in-flight requests
+ */
+export class RequestDeduplicator {
+    constructor() {
+        this.inFlight = new Map();
+    }
+    /**
+     * Execute a request with deduplication
+     * If a request with the same key is in-flight, return its promise
+     */
+    async execute(key, fn) {
+        // Check if request is already in-flight
+        const existing = this.inFlight.get(key);
+        if (existing) {
+            return existing;
+        }
+        // Create new request
+        const promise = fn().finally(() => {
+            this.inFlight.delete(key);
+        });
+        this.inFlight.set(key, promise);
+        return promise;
+    }
+    /**
+     * Check if a request is in-flight
+     */
+    isInFlight(key) {
+        return this.inFlight.has(key);
+    }
+    /**
+     * Get count of in-flight requests
+     */
+    getInFlightCount() {
+        return this.inFlight.size;
+    }
+    /**
+     * Clear all in-flight requests
+     */
+    clear() {
+        this.inFlight.clear();
+    }
+}
+/**
+ * Create a request key from method and URL
+ */
+export function createRequestKey(method, url, body) {
+    const bodyHash = body ? JSON.stringify(body) : '';
+    return `${method}:${url}:${bodyHash}`;
+}
+//# sourceMappingURL=retry.js.map

package/dist/utils/retry.js.map

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

package/dist/utils/storage.d.ts

@@ -0,0 +1,146 @@
+/**
+ * Platform-agnostic Storage Utilities
+ * Works with Web (localStorage), React Native (AsyncStorage), and other platforms
+ */
+/**
+ * Synchronous storage interface (for web localStorage)
+ */
+export interface SyncStorageAdapter {
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear?(): void;
+}
+/**
+ * Asynchronous storage interface (for React Native AsyncStorage)
+ */
+export interface AsyncStorageAdapter {
+    getItem(key: string): Promise<string | null>;
+    setItem(key: string, value: string): Promise<void>;
+    removeItem(key: string): Promise<void>;
+    clear?(): Promise<void>;
+}
+/**
+ * Unified storage adapter that handles both sync and async storage
+ */
+export type StorageAdapter = SyncStorageAdapter | AsyncStorageAdapter;
+/**
+ * Check if storage adapter is async
+ */
+export declare function isAsyncStorage(storage: StorageAdapter): storage is AsyncStorageAdapter;
+/**
+ * Memory storage adapter (fallback, not persistent)
+ * Note: For auth-specific storage, use MemoryStorageAdapter from auth/storage
+ */
+export declare class UtilsMemoryStorageAdapter implements SyncStorageAdapter {
+    private storage;
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+/**
+ * Web localStorage adapter
+ */
+export declare class WebStorageAdapter implements SyncStorageAdapter {
+    private storage;
+    constructor(type?: 'local' | 'session');
+    getItem(key: string): string | null;
+    setItem(key: string, value: string): void;
+    removeItem(key: string): void;
+    clear(): void;
+}
+/**
+ * Create a default storage adapter based on environment
+ */
+export declare function createDefaultStorage(): SyncStorageAdapter;
+/**
+ * Configure the global storage adapter
+ * Call this early in your app initialization for React Native:
+ *
+ * @example
+ * // React Native with AsyncStorage
+ * import AsyncStorage from '@react-native-async-storage/async-storage';
+ * setGlobalStorage(AsyncStorage);
+ *
+ * @example
+ * // Web with localStorage (default)
+ * setGlobalStorage(new WebStorageAdapter('local'));
+ */
+export declare function setGlobalStorage(storage: StorageAdapter): void;
+/**
+ * Get the current global storage adapter
+ */
+export declare function getGlobalStorage(): StorageAdapter;
+/**
+ * Storage helper with JSON serialization
+ */
+export declare class StorageHelper<T> {
+    private storage;
+    private key;
+    private defaultValue;
+    constructor(key: string, defaultValue: T, storage?: StorageAdapter);
+    /**
+     * Get value from storage
+     */
+    get(): Promise<T>;
+    /**
+     * Get value synchronously (only works with sync storage)
+     */
+    getSync(): T;
+    /**
+     * Set value in storage
+     */
+    set(value: T): Promise<void>;
+    /**
+     * Set value synchronously (only works with sync storage)
+     */
+    setSync(value: T): void;
+    /**
+     * Remove value from storage
+     */
+    remove(): Promise<void>;
+    /**
+     * Remove value synchronously (only works with sync storage)
+     */
+    removeSync(): void;
+}
+/**
+ * Network status detection (platform-agnostic)
+ */
+export interface NetworkStatusAdapter {
+    isOnline(): boolean | Promise<boolean>;
+    subscribe(callback: (isOnline: boolean) => void): () => void;
+}
+/**
+ * Web network status adapter
+ */
+export declare class WebNetworkStatusAdapter implements NetworkStatusAdapter {
+    isOnline(): boolean;
+    subscribe(callback: (isOnline: boolean) => void): () => void;
+}
+/**
+ * Configure the global network status adapter
+ *
+ * @example
+ * // React Native with NetInfo
+ * import NetInfo from '@react-native-community/netinfo';
+ * setGlobalNetworkStatus({
+ *   isOnline: async () => {
+ *     const state = await NetInfo.fetch();
+ *     return state.isConnected ?? false;
+ *   },
+ *   subscribe: (callback) => {
+ *     const unsubscribe = NetInfo.addEventListener(state => {
+ *       callback(state.isConnected ?? false);
+ *     });
+ *     return unsubscribe;
+ *   }
+ * });
+ */
+export declare function setGlobalNetworkStatus(adapter: NetworkStatusAdapter): void;
+/**
+ * Get the current global network status adapter
+ */
+export declare function getGlobalNetworkStatus(): NetworkStatusAdapter;
+//# sourceMappingURL=storage.d.ts.map

package/dist/utils/storage.d.ts.map

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