@cranberry-money/shared-services 1.2.0 → 1.3.0

package/dist/services/portfolios/allocations/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Portfolio allocations service exports
+ */
+export * from './types';
+export * from './service';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/portfolios/allocations/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/allocations/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/services/portfolios/allocations/index.js

@@ -0,0 +1,6 @@
+/**
+ * Portfolio allocations service exports
+ */
+export * from './types';
+export * from './service';
+export * from './utils';

package/dist/services/portfolios/allocations/service.d.ts

@@ -0,0 +1,6 @@
+import type { AssetAllocation, AssetAllocationPayload } from './types';
+export declare const getPortfolioAllocations: (portfolioUuid: string) => Promise<import("axios").AxiosResponse<AssetAllocation[], any>>;
+export declare const createAssetAllocation: (data: AssetAllocationPayload) => Promise<import("axios").AxiosResponse<AssetAllocation, any>>;
+export declare const updateAssetAllocation: (uuid: string, data: Partial<AssetAllocationPayload>) => Promise<import("axios").AxiosResponse<AssetAllocation, any>>;
+export declare const deleteAssetAllocation: (uuid: string) => Promise<import("axios").AxiosResponse<void, any>>;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/portfolios/allocations/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/allocations/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,eAAe,EAAE,sBAAsB,EAAE,MAAM,SAAS,CAAC;AAKvE,eAAO,MAAM,uBAAuB,GAAI,eAAe,MAAM,mEAK5D,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,MAAM,sBAAsB,iEAEjE,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,EAAE,MAAM,OAAO,CAAC,sBAAsB,CAAC,iEAExF,CAAC;AAEF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,sDAEjD,CAAC"}

package/dist/services/portfolios/allocations/service.js

@@ -0,0 +1,19 @@
+import { webApiClient } from '../../../api/apiClient';
+import { API_ENDPOINTS } from '../constants';
+// ASSET ALLOCATIONS API FUNCTIONS
+// Fetch allocations for a specific portfolio
+export const getPortfolioAllocations = (portfolioUuid) => {
+    // Always sort by created_at to show allocations in their creation order
+    return webApiClient.get(`${API_ENDPOINTS.PORTFOLIOS}${portfolioUuid}/allocations/`, {
+        params: { order_by: 'created_at' },
+    });
+};
+export const createAssetAllocation = (data) => {
+    return webApiClient.post(API_ENDPOINTS.ASSET_ALLOCATIONS, data);
+};
+export const updateAssetAllocation = (uuid, data) => {
+    return webApiClient.patch(`${API_ENDPOINTS.ASSET_ALLOCATIONS}${uuid}/`, data);
+};
+export const deleteAssetAllocation = (uuid) => {
+    return webApiClient.delete(`${API_ENDPOINTS.ASSET_ALLOCATIONS}${uuid}/`);
+};

package/dist/services/portfolios/allocations/types.d.ts

@@ -0,0 +1,17 @@
+/**
+ * Asset Allocations types and interfaces
+ */
+export interface AssetAllocation {
+    uuid: string;
+    portfolio: string;
+    instrument: string;
+    instrumentName: string;
+    instrumentSymbol: string;
+    percentage: string;
+}
+export interface AssetAllocationPayload {
+    portfolio: string;
+    instrument: string;
+    percentage: string | number;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/portfolios/allocations/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/allocations/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,MAAM,WAAW,eAAe;IAC9B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,UAAU,EAAE,MAAM,CAAC;CACpB;AAGD,MAAM,WAAW,sBAAsB;IACrC,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,MAAM,CAAC;IACnB,UAAU,EAAE,MAAM,GAAG,MAAM,CAAC;CAC7B"}

package/dist/services/portfolios/allocations/types.js

@@ -0,0 +1,4 @@
+/**
+ * Asset Allocations types and interfaces
+ */
+export {};

package/dist/services/portfolios/allocations/utils.d.ts

@@ -0,0 +1,3 @@
+import type { AssetAllocation } from './types';
+export declare const validateAllocations: (allocations: AssetAllocation[]) => boolean;
+//# sourceMappingURL=utils.d.ts.map

package/dist/services/portfolios/allocations/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/allocations/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,eAAe,EAAE,MAAM,SAAS,CAAC;AAK/C,eAAO,MAAM,mBAAmB,GAAI,aAAa,eAAe,EAAE,KAAG,OAKpE,CAAC"}

package/dist/services/portfolios/allocations/utils.js

@@ -0,0 +1,7 @@
+// ASSET ALLOCATIONS UTILITY FUNCTIONS
+// Utility function to validate if allocation percentages sum to 100%
+export const validateAllocations = (allocations) => {
+    const totalPercentage = allocations.reduce((sum, allocation) => sum + parseFloat(allocation.percentage), 0);
+    // Allow for small floating point errors (e.g., 99.99 or 100.01)
+    return Math.abs(totalPercentage - 100) < 0.01;
+};

package/dist/services/portfolios/holdings/index.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Portfolio holdings service exports
+ */
+export * from './types';
+export * from './service';
+export * from './utils';
+//# sourceMappingURL=index.d.ts.map

package/dist/services/portfolios/holdings/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/holdings/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}

package/dist/services/portfolios/holdings/index.js

@@ -0,0 +1,6 @@
+/**
+ * Portfolio holdings service exports
+ */
+export * from './types';
+export * from './service';
+export * from './utils';

package/dist/services/portfolios/holdings/service.d.ts

@@ -0,0 +1,10 @@
+import type { PaginatedResponse } from '../../../api/types';
+import type { AssetHolding, AssetHoldingSnapshot, AssetHoldingFilters, AssetHoldingSnapshotFilters } from './types';
+export type PaginatedAssetHoldings = PaginatedResponse<AssetHolding>;
+export type PaginatedAssetHoldingSnapshots = PaginatedResponse<AssetHoldingSnapshot>;
+export declare const getAssetHoldings: (filters?: AssetHoldingFilters) => Promise<import("axios").AxiosResponse<PaginatedAssetHoldings, any>>;
+export declare const getPortfolioHoldings: (portfolioUuid: string, orderBy?: string) => Promise<import("axios").AxiosResponse<AssetHolding[], any>>;
+export declare const getAssetHoldingByUuid: (uuid: string) => Promise<import("axios").AxiosResponse<AssetHolding, any>>;
+export declare const getAssetHoldingSnapshots: (filters?: AssetHoldingSnapshotFilters) => Promise<import("axios").AxiosResponse<PaginatedAssetHoldingSnapshots, any>>;
+export declare const getAssetHoldingSnapshotById: (id: number) => Promise<import("axios").AxiosResponse<AssetHoldingSnapshot, any>>;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/portfolios/holdings/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/holdings/service.ts"],"names":[],"mappings":"AACA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,oBAAoB,CAAC;AAE5D,OAAO,KAAK,EAAE,YAAY,EAAE,oBAAoB,EAAE,mBAAmB,EAAE,2BAA2B,EAAE,MAAM,SAAS,CAAC;AAGpH,MAAM,MAAM,sBAAsB,GAAG,iBAAiB,CAAC,YAAY,CAAC,CAAC;AACrE,MAAM,MAAM,8BAA8B,GAAG,iBAAiB,CAAC,oBAAoB,CAAC,CAAC;AAKrF,eAAO,MAAM,gBAAgB,GAAI,UAAU,mBAAmB,wEAW7D,CAAC;AAGF,eAAO,MAAM,oBAAoB,GAAI,eAAe,MAAM,EAAE,UAAU,MAAM,gEAK3E,CAAC;AAGF,eAAO,MAAM,qBAAqB,GAAI,MAAM,MAAM,8DAEjD,CAAC;AAKF,eAAO,MAAM,wBAAwB,GAAI,UAAU,2BAA2B,gFAW7E,CAAC;AAGF,eAAO,MAAM,2BAA2B,GAAI,IAAI,MAAM,sEAErD,CAAC"}

package/dist/services/portfolios/holdings/service.js

@@ -0,0 +1,53 @@
+import { webApiClient } from '../../../api/apiClient';
+import { API_ENDPOINTS } from '../constants';
+// ASSET HOLDINGS API FUNCTIONS
+// Fetch asset holdings with optional filtering
+export const getAssetHoldings = (filters) => {
+    const params = {};
+    if (filters?.portfolioId)
+        params.portfolio_id = filters.portfolioId;
+    if (filters?.portfolioUuid)
+        params.portfolio_uuid = filters.portfolioUuid;
+    if (filters?.instrument)
+        params.instrument = filters.instrument;
+    if (filters?.minQuantity)
+        params.min_quantity = filters.minQuantity.toString();
+    if (filters?.maxQuantity)
+        params.max_quantity = filters.maxQuantity.toString();
+    if (filters?.orderBy)
+        params.order_by = filters.orderBy;
+    return webApiClient.get(API_ENDPOINTS.ASSET_HOLDINGS, { params });
+};
+// Fetch holdings for a specific portfolio
+export const getPortfolioHoldings = (portfolioUuid, orderBy) => {
+    const params = {};
+    if (orderBy)
+        params.order_by = orderBy;
+    return webApiClient.get(`${API_ENDPOINTS.PORTFOLIOS}${portfolioUuid}/holdings/`, { params });
+};
+// Get asset holding by UUID
+export const getAssetHoldingByUuid = (uuid) => {
+    return webApiClient.get(`${API_ENDPOINTS.ASSET_HOLDINGS}${uuid}/`);
+};
+// ASSET HOLDING SNAPSHOTS API FUNCTIONS
+// Fetch asset holding snapshots with optional filtering
+export const getAssetHoldingSnapshots = (filters) => {
+    const params = {};
+    if (filters?.assetHoldingId)
+        params.asset_holding_id = filters.assetHoldingId;
+    if (filters?.portfolioId)
+        params.portfolio_id = filters.portfolioId;
+    if (filters?.reason)
+        params.reason = filters.reason;
+    if (filters?.startDate)
+        params.start_date = filters.startDate;
+    if (filters?.endDate)
+        params.end_date = filters.endDate;
+    if (filters?.orderBy)
+        params.order_by = filters.orderBy;
+    return webApiClient.get(API_ENDPOINTS.ASSET_HOLDING_SNAPSHOTS, { params });
+};
+// Get asset holding snapshot by ID
+export const getAssetHoldingSnapshotById = (id) => {
+    return webApiClient.get(`${API_ENDPOINTS.ASSET_HOLDING_SNAPSHOTS}${id}/`);
+};

package/dist/services/portfolios/holdings/types.d.ts

@@ -0,0 +1,42 @@
+/**
+ * Asset Holdings types and interfaces
+ */
+export interface AssetHolding {
+    uuid: string;
+    portfolio: string;
+    instrument: any;
+    instrumentName: string;
+    instrumentSymbol: string;
+    quantity: number;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AssetHoldingSnapshot {
+    id: number;
+    assetHolding: string;
+    portfolioId: number;
+    instrumentName: string;
+    instrumentSymbol: string;
+    quantity: number;
+    snapshotReason: 'TRADE' | 'REBALANCE' | 'VALUATION' | 'AUDIT';
+    snapshotDate: string;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface AssetHoldingFilters {
+    portfolioId?: string;
+    portfolioUuid?: string;
+    instrument?: string;
+    minQuantity?: number;
+    maxQuantity?: number;
+    orderBy?: string;
+}
+export interface AssetHoldingSnapshotFilters {
+    assetHoldingId?: string;
+    portfolioId?: string;
+    reason?: 'TRADE' | 'REBALANCE' | 'VALUATION' | 'AUDIT';
+    startDate?: string;
+    endDate?: string;
+    orderBy?: string;
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/portfolios/holdings/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/holdings/types.ts"],"names":[],"mappings":"AAAA;;GAEG;AAMH,MAAM,WAAW,YAAY;IAC3B,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,EAAE,MAAM,CAAC;IAClB,UAAU,EAAE,GAAG,CAAC;IAChB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,oBAAoB;IACnC,EAAE,EAAE,MAAM,CAAC;IACX,YAAY,EAAE,MAAM,CAAC;IACrB,WAAW,EAAE,MAAM,CAAC;IACpB,cAAc,EAAE,MAAM,CAAC;IACvB,gBAAgB,EAAE,MAAM,CAAC;IACzB,QAAQ,EAAE,MAAM,CAAC;IACjB,cAAc,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;IAC9D,YAAY,EAAE,MAAM,CAAC;IACrB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAGD,MAAM,WAAW,mBAAmB;IAClC,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,2BAA2B;IAC1C,cAAc,CAAC,EAAE,MAAM,CAAC;IACxB,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,OAAO,GAAG,WAAW,GAAG,WAAW,GAAG,OAAO,CAAC;IACvD,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB"}

package/dist/services/portfolios/holdings/types.js

@@ -0,0 +1,4 @@
+/**
+ * Asset Holdings types and interfaces
+ */
+export {};

package/dist/services/portfolios/holdings/utils.d.ts

@@ -0,0 +1,8 @@
+import type { AssetHolding } from './types';
+export declare const calculatePortfolioValue: (holdings: AssetHolding[], prices: Record<string, number>) => number;
+export declare const calculateHoldingAllocations: (holdings: AssetHolding[]) => Record<string, number>;
+export declare const groupHoldingsByInstrument: (holdings: AssetHolding[]) => Record<string, AssetHolding[]>;
+export declare const filterHoldingsByMinQuantity: (holdings: AssetHolding[], minQuantity: number) => AssetHolding[];
+export declare const sortHoldings: (holdings: AssetHolding[], sortBy: "quantity" | "symbol" | "name" | "createdAt", direction?: "asc" | "desc") => AssetHolding[];
+export declare const formatQuantity: (quantity: number) => string;
+//# sourceMappingURL=utils.d.ts.map

package/dist/services/portfolios/holdings/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../../src/services/portfolios/holdings/utils.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAK5C,eAAO,MAAM,uBAAuB,GAAI,UAAU,YAAY,EAAE,EAAE,QAAQ,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,KAAG,MAKlG,CAAC;AAGF,eAAO,MAAM,2BAA2B,GAAI,UAAU,YAAY,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,MAAM,CAW3F,CAAC;AAGF,eAAO,MAAM,yBAAyB,GAAI,UAAU,YAAY,EAAE,KAAG,MAAM,CAAC,MAAM,EAAE,YAAY,EAAE,CAYjG,CAAC;AAGF,eAAO,MAAM,2BAA2B,GAAI,UAAU,YAAY,EAAE,EAAE,aAAa,MAAM,KAAG,YAAY,EAEvG,CAAC;AAGF,eAAO,MAAM,YAAY,GACvB,UAAU,YAAY,EAAE,EACxB,QAAQ,UAAU,GAAG,QAAQ,GAAG,MAAM,GAAG,WAAW,EACpD,YAAW,KAAK,GAAG,MAAe,KACjC,YAAY,EAsCd,CAAC;AAGF,eAAO,MAAM,cAAc,GAAI,UAAU,MAAM,KAAG,MAQjD,CAAC"}

package/dist/services/portfolios/holdings/utils.js

@@ -0,0 +1,82 @@
+// ASSET HOLDINGS UTILITY FUNCTIONS
+// Calculate total portfolio value based on holdings and prices
+export const calculatePortfolioValue = (holdings, prices) => {
+    return holdings.reduce((total, holding) => {
+        const price = prices[holding.instrument.uuid] || 0;
+        return total + holding.quantity * price;
+    }, 0);
+};
+// Calculate holding allocation percentages within a portfolio
+export const calculateHoldingAllocations = (holdings) => {
+    const totalQuantity = holdings.reduce((sum, holding) => sum + holding.quantity, 0);
+    if (totalQuantity === 0)
+        return {};
+    const allocations = {};
+    holdings.forEach((holding) => {
+        allocations[holding.instrument.uuid] = (holding.quantity / totalQuantity) * 100;
+    });
+    return allocations;
+};
+// Group holdings by instrument for aggregated view
+export const groupHoldingsByInstrument = (holdings) => {
+    return holdings.reduce((groups, holding) => {
+        const instrumentUuid = holding.instrument.uuid;
+        if (!groups[instrumentUuid]) {
+            groups[instrumentUuid] = [];
+        }
+        groups[instrumentUuid].push(holding);
+        return groups;
+    }, {});
+};
+// Filter holdings with quantities above a threshold
+export const filterHoldingsByMinQuantity = (holdings, minQuantity) => {
+    return holdings.filter((holding) => holding.quantity >= minQuantity);
+};
+// Sort holdings by various criteria
+export const sortHoldings = (holdings, sortBy, direction = 'desc') => {
+    return [...holdings].sort((a, b) => {
+        let valueA;
+        let valueB;
+        switch (sortBy) {
+            case 'quantity':
+                valueA = a.quantity;
+                valueB = b.quantity;
+                break;
+            case 'symbol':
+                valueA = a.instrumentSymbol;
+                valueB = b.instrumentSymbol;
+                break;
+            case 'name':
+                valueA = a.instrumentName;
+                valueB = b.instrumentName;
+                break;
+            case 'createdAt':
+                valueA = a.createdAt;
+                valueB = b.createdAt;
+                break;
+            default:
+                return 0;
+        }
+        if (typeof valueA === 'string' && typeof valueB === 'string') {
+            const comparison = valueA.localeCompare(valueB);
+            return direction === 'asc' ? comparison : -comparison;
+        }
+        if (typeof valueA === 'number' && typeof valueB === 'number') {
+            const comparison = valueA - valueB;
+            return direction === 'asc' ? comparison : -comparison;
+        }
+        return 0;
+    });
+};
+// Format quantity for display with proper units
+export const formatQuantity = (quantity) => {
+    if (quantity >= 1000000) {
+        return `${(quantity / 1000000).toFixed(1)}M`;
+    }
+    else if (quantity >= 1000) {
+        return `${(quantity / 1000).toFixed(1)}K`;
+    }
+    else {
+        return quantity.toString();
+    }
+};

package/dist/services/portfolios/index.d.ts

@@ -5,4 +5,6 @@ export * from './constants';
 export * from './types';
 export * from './service';
 export * from './utils';
+export * as Allocations from './allocations';
+export * as Holdings from './holdings';
 //# sourceMappingURL=index.d.ts.map

package/dist/services/portfolios/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/portfolios/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/portfolios/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH,cAAc,aAAa,CAAC;AAC5B,cAAc,SAAS,CAAC;AACxB,cAAc,WAAW,CAAC;AAC1B,cAAc,SAAS,CAAC;AAGxB,OAAO,KAAK,WAAW,MAAM,eAAe,CAAC;AAC7C,OAAO,KAAK,QAAQ,MAAM,YAAY,CAAC"}

package/dist/services/portfolios/index.js

@@ -5,3 +5,6 @@ export * from './constants';
 export * from './types';
 export * from './service';
 export * from './utils';
+// Sub-services
+export * as Allocations from './allocations';
+export * as Holdings from './holdings';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cranberry-money/shared-services",
-  "version": "1.2.0",
+  "version": "1.3.0",
   "description": "Shared API services and client for MyPortfolio platform",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",