@cranberry-money/shared-services 1.12.1 → 3.0.0

package/dist/services/withdrawals.js

@@ -0,0 +1,345 @@
+"use strict";
+/**
+ * Withdrawal Services - Pure Functional Implementation
+ *
+ * Complete withdrawal request and liquidation workflow system.
+ * Pure functions with explicit dependencies for withdrawal management.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canProcessWithdrawal = exports.canCreateLiquidations = exports.isWithdrawalCancellable = exports.isWithdrawalEditable = exports.formatSharesQuantity = exports.getTotalEstimatedValue = exports.calculateLiquidationProgress = exports.getLiquidationStatusColor = exports.getWithdrawalStatusColor = exports.formatWithdrawalAmount = exports.LIQUIDATION_STATUS_LABELS = exports.LIQUIDATION_STATUS = exports.WITHDRAWAL_REASON_LABELS = exports.WITHDRAWAL_REASON = exports.WITHDRAWAL_TYPE_LABELS = exports.WITHDRAWAL_TYPE = exports.WITHDRAWAL_STATUS_LABELS = exports.WITHDRAWAL_STATUS = exports.executeLiquidationTrades = exports.createTradesForLiquidation = exports.getLiquidationsByWithdrawalRequest = exports.deleteWithdrawalLiquidation = exports.updateWithdrawalLiquidation = exports.createWithdrawalLiquidation = exports.getWithdrawalLiquidation = exports.getWithdrawalLiquidations = exports.processWithdrawalRequest = exports.cancelWithdrawalRequest = exports.rejectWithdrawalRequest = exports.approveWithdrawalRequest = exports.deleteWithdrawalRequest = exports.updateWithdrawalRequest = exports.createWithdrawalRequest = exports.getWithdrawalRequest = exports.getWithdrawalRequests = void 0;
+// =============================
+// WITHDRAWAL REQUEST OPERATIONS
+// =============================
+const getWithdrawalRequests = async ({ apiClient }, filters) => {
+    const params = {};
+    if (filters?.account)
+        params.account = filters.account;
+    if (filters?.status)
+        params.status = filters.status;
+    if (filters?.withdrawalType)
+        params.withdrawal_type = filters.withdrawalType;
+    if (filters?.startDate)
+        params.start_date = filters.startDate;
+    if (filters?.endDate)
+        params.end_date = filters.endDate;
+    if (filters?.minAmount)
+        params.min_amount = filters.minAmount;
+    if (filters?.maxAmount)
+        params.max_amount = filters.maxAmount;
+    if (filters?.ordering)
+        params.order_by = filters.ordering;
+    if (filters?.page)
+        params.page = String(filters.page);
+    if (filters?.pageSize)
+        params.page_size = String(filters.pageSize);
+    return apiClient.get('/api/withdrawal-requests/', { params });
+};
+exports.getWithdrawalRequests = getWithdrawalRequests;
+const getWithdrawalRequest = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    return apiClient.get(`/api/withdrawal-requests/${uuid}/`);
+};
+exports.getWithdrawalRequest = getWithdrawalRequest;
+const createWithdrawalRequest = async ({ apiClient }, data) => {
+    // Validation
+    if (!data.account?.trim()) {
+        throw new Error('Account UUID is required');
+    }
+    if (!data.requestedAmount || parseFloat(data.requestedAmount) <= 0) {
+        throw new Error('Requested amount must be greater than 0');
+    }
+    return apiClient.post('/api/withdrawal-requests/', data);
+};
+exports.createWithdrawalRequest = createWithdrawalRequest;
+const updateWithdrawalRequest = async ({ apiClient }, uuid, data) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    if (data.requestedAmount && parseFloat(data.requestedAmount) <= 0) {
+        throw new Error('Requested amount must be greater than 0');
+    }
+    return apiClient.patch(`/api/withdrawal-requests/${uuid}/`, data);
+};
+exports.updateWithdrawalRequest = updateWithdrawalRequest;
+const deleteWithdrawalRequest = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    await apiClient.delete(`/api/withdrawal-requests/${uuid}/`);
+};
+exports.deleteWithdrawalRequest = deleteWithdrawalRequest;
+// Workflow operations
+const approveWithdrawalRequest = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    return apiClient.post(`/api/withdrawal-requests/${uuid}/approve/`, {});
+};
+exports.approveWithdrawalRequest = approveWithdrawalRequest;
+const rejectWithdrawalRequest = async ({ apiClient }, uuid, reason) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    return apiClient.post(`/api/withdrawal-requests/${uuid}/reject/`, { reason });
+};
+exports.rejectWithdrawalRequest = rejectWithdrawalRequest;
+const cancelWithdrawalRequest = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    return apiClient.post(`/api/withdrawal-requests/${uuid}/cancel/`, {});
+};
+exports.cancelWithdrawalRequest = cancelWithdrawalRequest;
+const processWithdrawalRequest = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    return apiClient.post(`/api/withdrawal-requests/${uuid}/process/`, {});
+};
+exports.processWithdrawalRequest = processWithdrawalRequest;
+// =============================
+// WITHDRAWAL LIQUIDATION OPERATIONS
+// =============================
+const getWithdrawalLiquidations = async ({ apiClient }, filters) => {
+    const params = {};
+    if (filters?.withdrawalRequest)
+        params.withdrawal_request = filters.withdrawalRequest;
+    if (filters?.assetHolding)
+        params.asset_holding = filters.assetHolding;
+    if (filters?.liquidationStatus)
+        params.liquidation_status = filters.liquidationStatus;
+    if (filters?.targetCompletionStartDate)
+        params.target_completion_start_date = filters.targetCompletionStartDate;
+    if (filters?.targetCompletionEndDate)
+        params.target_completion_end_date = filters.targetCompletionEndDate;
+    if (filters?.expectedSettlementStartDate)
+        params.expected_settlement_start_date = filters.expectedSettlementStartDate;
+    if (filters?.expectedSettlementEndDate)
+        params.expected_settlement_end_date = filters.expectedSettlementEndDate;
+    if (filters?.targetTrade)
+        params.target_trade = filters.targetTrade;
+    if (filters?.minValue)
+        params.min_value = filters.minValue;
+    if (filters?.maxValue)
+        params.max_value = filters.maxValue;
+    if (filters?.ordering)
+        params.order_by = filters.ordering;
+    if (filters?.page)
+        params.page = String(filters.page);
+    if (filters?.pageSize)
+        params.page_size = String(filters.pageSize);
+    return apiClient.get('/api/withdrawal-liquidations/', { params });
+};
+exports.getWithdrawalLiquidations = getWithdrawalLiquidations;
+const getWithdrawalLiquidation = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal liquidation UUID is required');
+    }
+    return apiClient.get(`/api/withdrawal-liquidations/${uuid}/`);
+};
+exports.getWithdrawalLiquidation = getWithdrawalLiquidation;
+const createWithdrawalLiquidation = async ({ apiClient }, data) => {
+    // Validation
+    if (!data.withdrawalRequest?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    if (!data.assetHolding?.trim()) {
+        throw new Error('Asset holding UUID is required');
+    }
+    if (!data.sharesToLiquidate || data.sharesToLiquidate <= 0) {
+        throw new Error('Shares to liquidate must be greater than 0');
+    }
+    if (!data.estimatedValue || parseFloat(data.estimatedValue) <= 0) {
+        throw new Error('Estimated value must be greater than 0');
+    }
+    return apiClient.post('/api/withdrawal-liquidations/', data);
+};
+exports.createWithdrawalLiquidation = createWithdrawalLiquidation;
+const updateWithdrawalLiquidation = async ({ apiClient }, uuid, data) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal liquidation UUID is required');
+    }
+    if (data.sharesToLiquidate !== undefined && data.sharesToLiquidate <= 0) {
+        throw new Error('Shares to liquidate must be greater than 0');
+    }
+    if (data.estimatedValue !== undefined && parseFloat(data.estimatedValue) <= 0) {
+        throw new Error('Estimated value must be greater than 0');
+    }
+    return apiClient.patch(`/api/withdrawal-liquidations/${uuid}/`, data);
+};
+exports.updateWithdrawalLiquidation = updateWithdrawalLiquidation;
+const deleteWithdrawalLiquidation = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal liquidation UUID is required');
+    }
+    await apiClient.delete(`/api/withdrawal-liquidations/${uuid}/`);
+};
+exports.deleteWithdrawalLiquidation = deleteWithdrawalLiquidation;
+// Helper functions
+const getLiquidationsByWithdrawalRequest = async ({ apiClient }, withdrawalRequestUuid) => {
+    if (!withdrawalRequestUuid?.trim()) {
+        throw new Error('Withdrawal request UUID is required');
+    }
+    return (0, exports.getWithdrawalLiquidations)({ apiClient }, {
+        withdrawalRequest: withdrawalRequestUuid,
+        ordering: '-created_at',
+    });
+};
+exports.getLiquidationsByWithdrawalRequest = getLiquidationsByWithdrawalRequest;
+const createTradesForLiquidation = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal liquidation UUID is required');
+    }
+    return apiClient.post(`/api/withdrawal-liquidations/${uuid}/create-trades/`, {});
+};
+exports.createTradesForLiquidation = createTradesForLiquidation;
+const executeLiquidationTrades = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Withdrawal liquidation UUID is required');
+    }
+    return apiClient.post(`/api/withdrawal-liquidations/${uuid}/execute-trades/`, {});
+};
+exports.executeLiquidationTrades = executeLiquidationTrades;
+// =============================
+// UTILITY FUNCTIONS & CONSTANTS
+// =============================
+// Status constants
+exports.WITHDRAWAL_STATUS = {
+    PENDING_REVIEW: 'PENDING_REVIEW',
+    APPROVED: 'APPROVED',
+    REJECTED: 'REJECTED',
+    PROCESSING: 'PROCESSING',
+    AWAITING_LIQUIDATION: 'AWAITING_LIQUIDATION',
+    LIQUIDATION_IN_PROGRESS: 'LIQUIDATION_IN_PROGRESS',
+    COMPLETED: 'COMPLETED',
+    CANCELLED: 'CANCELLED',
+    FAILED: 'FAILED',
+};
+exports.WITHDRAWAL_STATUS_LABELS = {
+    PENDING_REVIEW: 'Pending Review',
+    APPROVED: 'Approved',
+    REJECTED: 'Rejected',
+    PROCESSING: 'Processing',
+    AWAITING_LIQUIDATION: 'Awaiting Liquidation',
+    LIQUIDATION_IN_PROGRESS: 'Liquidation In Progress',
+    COMPLETED: 'Completed',
+    CANCELLED: 'Cancelled',
+    FAILED: 'Failed',
+};
+exports.WITHDRAWAL_TYPE = {
+    FULL_CASH: 'FULL_CASH',
+    PARTIAL_CASH: 'PARTIAL_CASH',
+};
+exports.WITHDRAWAL_TYPE_LABELS = {
+    FULL_CASH: 'Full Cash Withdrawal',
+    PARTIAL_CASH: 'Partial Cash Withdrawal',
+};
+exports.WITHDRAWAL_REASON = {
+    INVESTMENT_STRATEGY: 'INVESTMENT_STRATEGY',
+    PERSONAL_EXPENSES: 'PERSONAL_EXPENSES',
+    EMERGENCY: 'EMERGENCY',
+    OTHER: 'OTHER',
+};
+exports.WITHDRAWAL_REASON_LABELS = {
+    INVESTMENT_STRATEGY: 'Investment Strategy',
+    PERSONAL_EXPENSES: 'Personal Expenses',
+    EMERGENCY: 'Emergency',
+    OTHER: 'Other',
+};
+exports.LIQUIDATION_STATUS = {
+    PENDING: 'PENDING',
+    TRADES_CREATED: 'TRADES_CREATED',
+    EXECUTED: 'EXECUTED',
+    SETTLED: 'SETTLED',
+    FAILED: 'FAILED',
+};
+exports.LIQUIDATION_STATUS_LABELS = {
+    PENDING: 'Pending',
+    TRADES_CREATED: 'Trades Created',
+    EXECUTED: 'Executed',
+    SETTLED: 'Settled',
+    FAILED: 'Failed',
+};
+// Utility functions
+const formatWithdrawalAmount = (amount) => {
+    const numValue = typeof amount === 'string' ? parseFloat(amount) : amount;
+    return new Intl.NumberFormat('en-AU', {
+        style: 'currency',
+        currency: 'AUD',
+    }).format(numValue);
+};
+exports.formatWithdrawalAmount = formatWithdrawalAmount;
+const getWithdrawalStatusColor = (status) => {
+    const statusColors = {
+        PENDING_REVIEW: 'text-warning-600',
+        APPROVED: 'text-success-600',
+        REJECTED: 'text-error-600',
+        PROCESSING: 'text-primary-600',
+        AWAITING_LIQUIDATION: 'text-warning-600',
+        LIQUIDATION_IN_PROGRESS: 'text-primary-600',
+        COMPLETED: 'text-success-600',
+        CANCELLED: 'text-content-muted',
+        FAILED: 'text-error-600',
+    };
+    return statusColors[status] || 'text-content-muted';
+};
+exports.getWithdrawalStatusColor = getWithdrawalStatusColor;
+const getLiquidationStatusColor = (status) => {
+    const statusColors = {
+        PENDING: 'text-warning-600',
+        TRADES_CREATED: 'text-primary-600',
+        EXECUTED: 'text-accent-secondary',
+        SETTLED: 'text-success-600',
+        FAILED: 'text-error-600',
+    };
+    return statusColors[status] || 'text-content-muted';
+};
+exports.getLiquidationStatusColor = getLiquidationStatusColor;
+const calculateLiquidationProgress = (liquidations) => {
+    const total = liquidations.length;
+    const pending = liquidations.filter(l => l.liquidationStatus === 'PENDING').length;
+    const inProgress = liquidations.filter(l => ['TRADES_CREATED', 'EXECUTED'].includes(l.liquidationStatus)).length;
+    const completed = liquidations.filter(l => l.liquidationStatus === 'SETTLED').length;
+    const failed = liquidations.filter(l => l.liquidationStatus === 'FAILED').length;
+    const completionRate = total > 0 ? (completed / total) * 100 : 0;
+    return {
+        total,
+        pending,
+        inProgress,
+        completed,
+        failed,
+        completionRate,
+    };
+};
+exports.calculateLiquidationProgress = calculateLiquidationProgress;
+const getTotalEstimatedValue = (liquidations) => {
+    return liquidations.reduce((total, liquidation) => {
+        return total + parseFloat(liquidation.estimatedValue || '0');
+    }, 0);
+};
+exports.getTotalEstimatedValue = getTotalEstimatedValue;
+const formatSharesQuantity = (shares) => {
+    return new Intl.NumberFormat('en-AU', {
+        minimumFractionDigits: 0,
+        maximumFractionDigits: 4,
+    }).format(shares);
+};
+exports.formatSharesQuantity = formatSharesQuantity;
+const isWithdrawalEditable = (status) => {
+    return ['PENDING_REVIEW', 'APPROVED'].includes(status);
+};
+exports.isWithdrawalEditable = isWithdrawalEditable;
+const isWithdrawalCancellable = (status) => {
+    return ['PENDING_REVIEW', 'APPROVED', 'AWAITING_LIQUIDATION'].includes(status);
+};
+exports.isWithdrawalCancellable = isWithdrawalCancellable;
+const canCreateLiquidations = (status) => {
+    return status === 'AWAITING_LIQUIDATION';
+};
+exports.canCreateLiquidations = canCreateLiquidations;
+const canProcessWithdrawal = (status) => {
+    return status === 'APPROVED';
+};
+exports.canProcessWithdrawal = canProcessWithdrawal;

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@cranberry-money/shared-services",
-  "version": "1.12.1",
-  "description": "Shared API services and client for MyPortfolio platform",
+  "version": "3.0.0",
+  "description": "Functional architecture shared services with pure functions, dependency injection, and comprehensive TypeScript support for the MyPortfolio platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
   "exports": {
@@ -12,46 +12,73 @@
     }
   },
   "files": [
-    "dist"
+    "dist",
+    "README.md",
+    "CHANGELOG.md",
+    "docs"
   ],
   "scripts": {
     "build": "tsc",
     "clean": "rm -rf dist",
     "typecheck": "tsc --noEmit",
-    "dev": "tsc --watch"
+    "dev": "tsc --watch",
+    "lint": "eslint src --ext .ts,.tsx",
+    "lint:fix": "eslint src --ext .ts,.tsx --fix",
+    "validate": "tsx scripts/validate-package.ts",
+    "prepare-release": "tsx scripts/prepare-release.ts",
+    "release": "npm run prepare-release && npm publish",
+    "release:dry-run": "npm run prepare-release -- --dry-run"
   },
   "dependencies": {
-    "@cranberry-money/shared-constants": "^1.0.1",
-    "@cranberry-money/shared-types": "^1.0.1",
     "axios": "^1.7.0"
   },
   "peerDependencies": {
-    "@tanstack/react-query": ">=5.0.0",
-    "typescript": ">=5.0.0"
+    "react": ">=18.0.0",
+    "typescript": ">=4.5.0"
+  },
+  "peerDependenciesMeta": {
+    "react": {
+      "optional": false
+    }
   },
   "devDependencies": {
-    "@tanstack/react-query": "^5.83.0",
-    "@types/react": "^19.1.9",
-    "@types/react-dom": "^19.1.7",
+    "@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",
     "typescript": "^5.0.0"
   },
   "keywords": [
+    "functional-programming",
+    "dependency-injection",
+    "react",
     "typescript",
-    "api",
-    "services",
-    "shared",
+    "api-client",
+    "authentication",
     "portfolio",
-    "react-query"
+    "services",
+    "pure-functions"
   ],
   "author": "MyPortfolio Team",
   "license": "MIT",
   "publishConfig": {
-    "access": "restricted",
+    "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/dist/adapters/MobileApiClient.d.ts

@@ -1,68 +0,0 @@
-/**
- * Mobile-specific API client implementation
- *
- * This implementation is designed for React Native environments
- * and includes mobile-specific features like network state awareness,
- * offline capability, and retry logic.
- */
-import { BaseApiClient, type RequestConfig, type ApiResponse, type ApiClientConfig } from '../core/BaseApiClient';
-export interface MobileApiClientConfig extends ApiClientConfig {
-    retryAttempts?: number;
-    retryDelay?: number;
-    offlineQueueEnabled?: boolean;
-}
-export declare class MobileApiClient extends BaseApiClient {
-    private retryAttempts;
-    private retryDelay;
-    private offlineQueueEnabled;
-    private offlineQueue;
-    private isOnline;
-    constructor(config: MobileApiClientConfig);
-    request<T = unknown>(config: RequestConfig): Promise<ApiResponse<T>>;
-    private executeRequest;
-    /**
-     * Queue request for when back online
-     */
-    private queueRequest;
-    /**
-     * Process offline queue when back online
-     */
-    syncWhenOnline(): Promise<void>;
-    /**
-     * Enable offline mode
-     */
-    enableOfflineMode(): void;
-    /**
-     * Enable online mode and sync queue
-     */
-    enableOnlineMode(): Promise<void>;
-    /**
-     * Set network state
-     */
-    setNetworkState(isOnline: boolean): void;
-    /**
-     * Parse response data based on content type
-     */
-    private parseResponseData;
-    /**
-     * Convert Headers to plain object
-     */
-    private parseResponseHeaders;
-    /**
-     * Check if error is an API error
-     */
-    private isApiError;
-    /**
-     * Determine if request should be retried
-     */
-    private shouldRetry;
-    /**
-     * Handle token refresh for mobile (secure storage based)
-     */
-    protected handleTokenRefresh(): Promise<boolean>;
-    /**
-     * Utility delay function
-     */
-    private delay;
-}
-//# sourceMappingURL=MobileApiClient.d.ts.map

package/dist/adapters/MobileApiClient.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"MobileApiClient.d.ts","sourceRoot":"","sources":["../../src/adapters/MobileApiClient.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAGH,OAAO,EAAE,aAAa,EAAE,KAAK,aAAa,EAAE,KAAK,WAAW,EAAE,KAAK,eAAe,EAAE,MAAM,uBAAuB,CAAC;AAElH,MAAM,WAAW,qBAAsB,SAAQ,eAAe;IAC5D,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,mBAAmB,CAAC,EAAE,OAAO,CAAC;CAC/B;AAED,qBAAa,eAAgB,SAAQ,aAAa;IAChD,OAAO,CAAC,aAAa,CAAS;IAC9B,OAAO,CAAC,UAAU,CAAS;IAC3B,OAAO,CAAC,mBAAmB,CAAU;IACrC,OAAO,CAAC,YAAY,CAAuB;IAC3C,OAAO,CAAC,QAAQ,CAAiB;gBAErB,MAAM,EAAE,qBAAqB;IAcnC,OAAO,CAAC,CAAC,GAAG,OAAO,EAAE,MAAM,EAAE,aAAa,GAAG,OAAO,CAAC,WAAW,CAAC,CAAC,CAAC,CAAC;YAS5D,cAAc;IAwF5B;;OAEG;YACW,YAAY;IAU1B;;OAEG;IACG,cAAc,IAAI,OAAO,CAAC,IAAI,CAAC;IAgBrC;;OAEG;IACH,iBAAiB,IAAI,IAAI;IAIzB;;OAEG;IACG,gBAAgB,IAAI,OAAO,CAAC,IAAI,CAAC;IAOvC;;OAEG;IACH,eAAe,CAAC,QAAQ,EAAE,OAAO,GAAG,IAAI;IAUxC;;OAEG;YACW,iBAAiB;IAe/B;;OAEG;IACH,OAAO,CAAC,oBAAoB;IAQ5B;;OAEG;IACH,OAAO,CAAC,UAAU;IAOlB;;OAEG;IACH,OAAO,CAAC,WAAW;IAsBnB;;OAEG;cACa,kBAAkB,IAAI,OAAO,CAAC,OAAO,CAAC;IAyBtD;;OAEG;IACH,OAAO,CAAC,KAAK;CAGd"}