@cranberry-money/shared-services 1.2.0 → 1.4.0

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export * from './services/PortfolioService';
 export * as AccountsService from './services/accounts';
 export * as AuthService from './services/auth';
 export * as PortfoliosService from './services/portfolios';
+export * as UsersService from './services/users';
 export * from './query/QueryClient';
 export * from './query/useAuth';
 export * from './query/usePortfolios';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACb,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAGrB,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAG5C,OAAO,KAAK,eAAe,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAG3D,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,cAAc,qBAAqB,CAAC;AACpC,cAAc,sBAAsB,CAAC;AAGrC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,yBAAyB,CAAC;AACxC,cAAc,+BAA+B,CAAC;AAC9C,cAAc,4BAA4B,CAAC;AAG3C,OAAO,EACL,eAAe,EACf,kBAAkB,EAClB,qBAAqB,EACrB,YAAY,EACb,MAAM,iBAAiB,CAAC;AAEzB,YAAY,EACV,UAAU,EACV,gBAAgB,EAChB,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EACjB,MAAM,aAAa,CAAC;AAGrB,cAAc,wBAAwB,CAAC;AACvC,cAAc,wBAAwB,CAAC;AACvC,cAAc,6BAA6B,CAAC;AAG5C,OAAO,KAAK,eAAe,MAAM,qBAAqB,CAAC;AACvD,OAAO,KAAK,WAAW,MAAM,iBAAiB,CAAC;AAC/C,OAAO,KAAK,iBAAiB,MAAM,uBAAuB,CAAC;AAC3D,OAAO,KAAK,YAAY,MAAM,kBAAkB,CAAC;AAGjD,cAAc,qBAAqB,CAAC;AACpC,cAAc,iBAAiB,CAAC;AAChC,cAAc,uBAAuB,CAAC;AAGtC,cAAc,oBAAoB,CAAC;AACnC,cAAc,0BAA0B,CAAC;AACzC,cAAc,uBAAuB,CAAC"}

package/dist/index.js

@@ -19,6 +19,7 @@ export * from './services/PortfolioService';
 export * as AccountsService from './services/accounts';
 export * as AuthService from './services/auth';
 export * as PortfoliosService from './services/portfolios';
+export * as UsersService from './services/users';
 // React Query integration
 export * from './query/QueryClient';
 export * from './query/useAuth';

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/dist/services/users/constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Users domain API constants
+ */
+export declare const API_ENDPOINTS: {
+    readonly USER_PROFILES: "/api/user-profiles/";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/services/users/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/services/users/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,aAAa;;CAGhB,CAAC"}

package/dist/services/users/constants.js

@@ -0,0 +1,8 @@
+/**
+ * Users domain API constants
+ */
+// API Endpoints
+export const API_ENDPOINTS = {
+    // User profiles
+    USER_PROFILES: '/api/user-profiles/',
+};

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

@@ -0,0 +1,9 @@
+/**
+ * Users service exports
+ */
+export * from './constants';
+export * from './types';
+export * from './service';
+export * from './utils';
+export * as InvestmentPreferences from './investment_preferences';
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/services/users/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,qBAAqB,MAAM,0BAA0B,CAAC"}

package/dist/services/users/index.js

@@ -0,0 +1,9 @@
+/**
+ * Users service exports
+ */
+export * from './constants';
+export * from './types';
+export * from './service';
+export * from './utils';
+// Sub-services
+export * as InvestmentPreferences from './investment_preferences';

package/dist/services/users/investment_preferences/constants.d.ts

@@ -0,0 +1,7 @@
+/**
+ * Investment preferences API constants
+ */
+export declare const API_ENDPOINTS: {
+    readonly INVESTMENT_PREFERENCES: "/api/investment-preferences/";
+};
+//# sourceMappingURL=constants.d.ts.map

package/dist/services/users/investment_preferences/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../../src/services/users/investment_preferences/constants.ts"],"names":[],"mappings":"AAAA;;GAEG;AAGH,eAAO,MAAM,aAAa;;CAEhB,CAAC"}

package/dist/services/users/investment_preferences/constants.js

@@ -0,0 +1,7 @@
+/**
+ * Investment preferences API constants
+ */
+// API Endpoints
+export const API_ENDPOINTS = {
+    INVESTMENT_PREFERENCES: '/api/investment-preferences/',
+};

package/dist/services/users/investment_preferences/index.d.ts

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

package/dist/services/users/investment_preferences/index.d.ts.map

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

package/dist/services/users/investment_preferences/index.js

@@ -0,0 +1,6 @@
+/**
+ * Investment preferences service exports
+ */
+export * from './constants';
+export * from './types';
+export * from './service';

package/dist/services/users/investment_preferences/service.d.ts

@@ -0,0 +1,5 @@
+import type { InvestmentPreference, InvestmentPreferencePayload, PaginatedInvestmentPreferences } from './types';
+export declare const createInvestmentPreference: (data: InvestmentPreferencePayload) => Promise<import("axios").AxiosResponse<InvestmentPreference, any>>;
+export declare const updateInvestmentPreference: (uuid: string, data: Partial<InvestmentPreferencePayload>) => Promise<import("axios").AxiosResponse<InvestmentPreference, any>>;
+export declare const getInvestmentPreferences: () => Promise<import("axios").AxiosResponse<PaginatedInvestmentPreferences, any>>;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/users/investment_preferences/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../../src/services/users/investment_preferences/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,oBAAoB,EAAE,2BAA2B,EAAE,8BAA8B,EAAE,MAAM,SAAS,CAAC;AAGjH,eAAO,MAAM,0BAA0B,GAAI,MAAM,2BAA2B,sEAE3E,CAAC;AAEF,eAAO,MAAM,0BAA0B,GAAI,MAAM,MAAM,EAAE,MAAM,OAAO,CAAC,2BAA2B,CAAC,sEAElG,CAAC;AAEF,eAAO,MAAM,wBAAwB,mFAEpC,CAAC"}

package/dist/services/users/investment_preferences/service.js

@@ -0,0 +1,12 @@
+import { webApiClient } from '../../../api/apiClient';
+import { API_ENDPOINTS } from './constants';
+// Investment preferences services
+export const createInvestmentPreference = (data) => {
+    return webApiClient.post(API_ENDPOINTS.INVESTMENT_PREFERENCES, data);
+};
+export const updateInvestmentPreference = (uuid, data) => {
+    return webApiClient.patch(`${API_ENDPOINTS.INVESTMENT_PREFERENCES}${uuid}/`, data);
+};
+export const getInvestmentPreferences = () => {
+    return webApiClient.get(API_ENDPOINTS.INVESTMENT_PREFERENCES);
+};

package/dist/services/users/investment_preferences/types.d.ts

@@ -0,0 +1,23 @@
+export interface InvestmentPreference {
+    uuid: string;
+    userProfile: string;
+    investmentHorizon: string;
+    riskTolerance: string;
+    investmentExperience: string;
+    investmentAmount: string;
+    sourceOfFunds: string[];
+}
+export interface InvestmentPreferencePayload {
+    investmentHorizon: string;
+    riskTolerance: string;
+    investmentExperience: string;
+    investmentAmount: number;
+    sourceOfFunds: string[];
+}
+export interface PaginatedInvestmentPreferences {
+    count: number;
+    next: string | null;
+    previous: string | null;
+    results: InvestmentPreference[];
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/services/users/investment_preferences/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../../src/services/users/investment_preferences/types.ts"],"names":[],"mappings":"AACA,MAAM,WAAW,oBAAoB;IACnC,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,MAAM,CAAC;IACpB,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAGD,MAAM,WAAW,2BAA2B;IAC1C,iBAAiB,EAAE,MAAM,CAAC;IAC1B,aAAa,EAAE,MAAM,CAAC;IACtB,oBAAoB,EAAE,MAAM,CAAC;IAC7B,gBAAgB,EAAE,MAAM,CAAC;IACzB,aAAa,EAAE,MAAM,EAAE,CAAC;CACzB;AAGD,MAAM,WAAW,8BAA8B;IAC7C,KAAK,EAAE,MAAM,CAAC;IACd,IAAI,EAAE,MAAM,GAAG,IAAI,CAAC;IACpB,QAAQ,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,OAAO,EAAE,oBAAoB,EAAE,CAAC;CACjC"}

package/dist/services/users/investment_preferences/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/users/service.d.ts

@@ -0,0 +1,6 @@
+import type { UserProfile, UserProfilePayload, UserProfileCompletionPayload, PaginatedUserProfiles } from './types';
+export declare const createUserProfile: (data: UserProfilePayload) => Promise<import("axios").AxiosResponse<UserProfile, any>>;
+export declare const updateUserProfile: (uuid: string, data: UserProfilePayload) => Promise<import("axios").AxiosResponse<UserProfile, any>>;
+export declare const updateUserProfileCompletion: (uuid: string, data: UserProfileCompletionPayload) => Promise<import("axios").AxiosResponse<UserProfile, any>>;
+export declare const getUserProfiles: () => Promise<import("axios").AxiosResponse<PaginatedUserProfiles, any>>;
+//# sourceMappingURL=service.d.ts.map

package/dist/services/users/service.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"service.d.ts","sourceRoot":"","sources":["../../../src/services/users/service.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,WAAW,EAAE,kBAAkB,EAAE,4BAA4B,EAAE,qBAAqB,EAAE,MAAM,SAAS,CAAC;AAGpH,eAAO,MAAM,iBAAiB,GAAI,MAAM,kBAAkB,6DAEzD,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,MAAM,MAAM,EAAE,MAAM,kBAAkB,6DAEvE,CAAC;AAEF,eAAO,MAAM,2BAA2B,GAAI,MAAM,MAAM,EAAE,MAAM,4BAA4B,6DAE3F,CAAC;AAEF,eAAO,MAAM,eAAe,0EAE3B,CAAC"}

package/dist/services/users/service.js

@@ -0,0 +1,15 @@
+import { webApiClient } from '../../api/apiClient';
+import { API_ENDPOINTS } from './constants';
+// User profile services
+export const createUserProfile = (data) => {
+    return webApiClient.post(API_ENDPOINTS.USER_PROFILES, data);
+};
+export const updateUserProfile = (uuid, data) => {
+    return webApiClient.patch(`${API_ENDPOINTS.USER_PROFILES}${uuid}/`, data);
+};
+export const updateUserProfileCompletion = (uuid, data) => {
+    return webApiClient.patch(`${API_ENDPOINTS.USER_PROFILES}${uuid}/`, data);
+};
+export const getUserProfiles = () => {
+    return webApiClient.get(API_ENDPOINTS.USER_PROFILES);
+};

package/dist/services/users/types.d.ts

@@ -0,0 +1,32 @@
+import type { PaginatedResponse } from '../../api/types';
+export interface UserProfile {
+    uuid: string;
+    citizenshipCountry: string;
+    fullName: string;
+    dateOfBirth: string;
+    residentialAddress: string;
+    isPoliticallyExposed: boolean;
+    phoneNumber: string;
+    investmentGoals: string[];
+    riskTolerance: string | null;
+    withdrawPreferences: string | null;
+    isIdVerified: boolean;
+    termsAndConditions: boolean;
+    isSignupCompleted: boolean;
+    createdAt: string;
+    updatedAt: string;
+}
+export interface UserProfilePayload {
+    fullName: string;
+    dateOfBirth: string;
+    citizenshipCountry: string;
+    residentialAddress: string;
+    isPoliticallyExposed: boolean;
+    phoneNumber: string;
+}
+export interface UserProfileCompletionPayload {
+    termsAndConditions?: boolean;
+    isSignupCompleted?: boolean;
+}
+export type PaginatedUserProfiles = PaginatedResponse<UserProfile>;
+//# sourceMappingURL=types.d.ts.map

package/dist/services/users/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/services/users/types.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AAGzD,MAAM,WAAW,WAAW;IAC1B,IAAI,EAAE,MAAM,CAAC;IACb,kBAAkB,EAAE,MAAM,CAAC;IAC3B,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,aAAa,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,mBAAmB,EAAE,MAAM,GAAG,IAAI,CAAC;IACnC,YAAY,EAAE,OAAO,CAAC;IACtB,kBAAkB,EAAE,OAAO,CAAC;IAC5B,iBAAiB,EAAE,OAAO,CAAC;IAC3B,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,EAAE,MAAM,CAAC;CACnB;AAED,MAAM,WAAW,kBAAkB;IACjC,QAAQ,EAAE,MAAM,CAAC;IACjB,WAAW,EAAE,MAAM,CAAC;IACpB,kBAAkB,EAAE,MAAM,CAAC;IAC3B,kBAAkB,EAAE,MAAM,CAAC;IAC3B,oBAAoB,EAAE,OAAO,CAAC;IAC9B,WAAW,EAAE,MAAM,CAAC;CACrB;AAED,MAAM,WAAW,4BAA4B;IAC3C,kBAAkB,CAAC,EAAE,OAAO,CAAC;IAC7B,iBAAiB,CAAC,EAAE,OAAO,CAAC;CAC7B;AAED,MAAM,MAAM,qBAAqB,GAAG,iBAAiB,CAAC,WAAW,CAAC,CAAC"}

package/dist/services/users/types.js

@@ -0,0 +1 @@
+export {};

package/dist/services/users/utils.d.ts

@@ -0,0 +1,2 @@
+export declare const userUtilsPlaceholder: () => void;
+//# sourceMappingURL=utils.d.ts.map

package/dist/services/users/utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"utils.d.ts","sourceRoot":"","sources":["../../../src/services/users/utils.ts"],"names":[],"mappings":"AAIA,eAAO,MAAM,oBAAoB,YAEhC,CAAC"}

package/dist/services/users/utils.js

@@ -0,0 +1,6 @@
+// This file is reserved for user profile-related utilities
+// Authentication utilities are available in the auth service
+// Placeholder function to make this a proper module
+export const userUtilsPlaceholder = () => {
+    // Add user profile utilities here as needed
+};

package/package.json

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