@cranberry-money/shared-services 1.12.1 → 3.0.0

package/dist/services/reference-data.js

@@ -0,0 +1,245 @@
+"use strict";
+/**
+ * Reference Data Services - Pure Functional Implementation
+ *
+ * Static reference data (countries, industries, sectors, etc.) as pure functions.
+ * No global state, no side effects - everything is explicit and testable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getSectorsGroupedByIndustry = exports.formatStockExchangeName = exports.formatCountryName = exports.getAllActiveReferenceData = exports.getStockExchangeByCode = exports.searchStockExchanges = exports.getActiveStockExchanges = exports.getStockExchangesByCountry = exports.getStockExchange = exports.getStockExchanges = exports.searchSectors = exports.getActiveSectors = exports.getSectorsByIndustry = exports.getSector = exports.getSectors = exports.searchIndustries = exports.getActiveIndustries = exports.getIndustry = exports.getIndustries = exports.getCountryByCode = exports.searchCountries = exports.getAvailableCountries = exports.getCountry = exports.getCountries = void 0;
+// =============================
+// COUNTRY OPERATIONS
+// =============================
+const getCountries = async ({ apiClient }, filters) => {
+    const params = {};
+    if (filters?.name)
+        params.name = filters.name;
+    if (filters?.code)
+        params.code = filters.code;
+    if (filters?.isAvailable !== undefined)
+        params.is_available = String(filters.isAvailable);
+    if (filters?.search)
+        params.search = filters.search;
+    if (filters?.ordering)
+        params.ordering = filters.ordering;
+    if (filters?.page)
+        params.page = String(filters.page);
+    if (filters?.pageSize)
+        params.page_size = String(filters.pageSize);
+    return apiClient.get('/api/countries/', { params });
+};
+exports.getCountries = getCountries;
+const getCountry = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Country UUID is required');
+    }
+    return apiClient.get(`/api/countries/${uuid}/`);
+};
+exports.getCountry = getCountry;
+const getAvailableCountries = async ({ apiClient }, filters) => {
+    return (0, exports.getCountries)({ apiClient }, { ...filters, isAvailable: true });
+};
+exports.getAvailableCountries = getAvailableCountries;
+const searchCountries = async ({ apiClient }, searchTerm, filters) => {
+    if (!searchTerm?.trim()) {
+        throw new Error('Search term is required');
+    }
+    return (0, exports.getCountries)({ apiClient }, { ...filters, search: searchTerm });
+};
+exports.searchCountries = searchCountries;
+const getCountryByCode = async ({ apiClient }, code) => {
+    if (!code?.trim()) {
+        throw new Error('Country code is required');
+    }
+    const response = await (0, exports.getCountries)({ apiClient }, { code: code.toUpperCase() });
+    return response.results[0] || null;
+};
+exports.getCountryByCode = getCountryByCode;
+// =============================
+// INDUSTRY OPERATIONS
+// =============================
+const getIndustries = async ({ apiClient }, filters) => {
+    const params = {};
+    if (filters?.name)
+        params.name = filters.name;
+    if (filters?.code)
+        params.code = filters.code;
+    if (filters?.isActive !== undefined)
+        params.is_active = String(filters.isActive);
+    if (filters?.search)
+        params.search = filters.search;
+    if (filters?.ordering)
+        params.ordering = filters.ordering;
+    if (filters?.page)
+        params.page = String(filters.page);
+    if (filters?.pageSize)
+        params.page_size = String(filters.pageSize);
+    return apiClient.get('/api/industries/', { params });
+};
+exports.getIndustries = getIndustries;
+const getIndustry = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Industry UUID is required');
+    }
+    return apiClient.get(`/api/industries/${uuid}/`);
+};
+exports.getIndustry = getIndustry;
+const getActiveIndustries = async ({ apiClient }, filters) => {
+    return (0, exports.getIndustries)({ apiClient }, { ...filters, isActive: true });
+};
+exports.getActiveIndustries = getActiveIndustries;
+const searchIndustries = async ({ apiClient }, searchTerm, filters) => {
+    if (!searchTerm?.trim()) {
+        throw new Error('Search term is required');
+    }
+    return (0, exports.getIndustries)({ apiClient }, { ...filters, search: searchTerm });
+};
+exports.searchIndustries = searchIndustries;
+// =============================
+// SECTOR OPERATIONS
+// =============================
+const getSectors = async ({ apiClient }, filters) => {
+    const params = {};
+    if (filters?.name)
+        params.name = filters.name;
+    if (filters?.code)
+        params.code = filters.code;
+    if (filters?.industry)
+        params.industry = filters.industry;
+    if (filters?.isActive !== undefined)
+        params.is_active = String(filters.isActive);
+    if (filters?.search)
+        params.search = filters.search;
+    if (filters?.ordering)
+        params.ordering = filters.ordering;
+    if (filters?.page)
+        params.page = String(filters.page);
+    if (filters?.pageSize)
+        params.page_size = String(filters.pageSize);
+    return apiClient.get('/api/sectors/', { params });
+};
+exports.getSectors = getSectors;
+const getSector = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Sector UUID is required');
+    }
+    return apiClient.get(`/api/sectors/${uuid}/`);
+};
+exports.getSector = getSector;
+const getSectorsByIndustry = async ({ apiClient }, industryUuid, filters) => {
+    if (!industryUuid?.trim()) {
+        throw new Error('Industry UUID is required');
+    }
+    return (0, exports.getSectors)({ apiClient }, { ...filters, industry: industryUuid });
+};
+exports.getSectorsByIndustry = getSectorsByIndustry;
+const getActiveSectors = async ({ apiClient }, filters) => {
+    return (0, exports.getSectors)({ apiClient }, { ...filters, isActive: true });
+};
+exports.getActiveSectors = getActiveSectors;
+const searchSectors = async ({ apiClient }, searchTerm, filters) => {
+    if (!searchTerm?.trim()) {
+        throw new Error('Search term is required');
+    }
+    return (0, exports.getSectors)({ apiClient }, { ...filters, search: searchTerm });
+};
+exports.searchSectors = searchSectors;
+// =============================
+// STOCK EXCHANGE OPERATIONS
+// =============================
+const getStockExchanges = async ({ apiClient }, filters) => {
+    const params = {};
+    if (filters?.name)
+        params.name = filters.name;
+    if (filters?.code)
+        params.code = filters.code;
+    if (filters?.country)
+        params.country = filters.country;
+    if (filters?.isActive !== undefined)
+        params.is_active = String(filters.isActive);
+    if (filters?.search)
+        params.search = filters.search;
+    if (filters?.ordering)
+        params.ordering = filters.ordering;
+    if (filters?.page)
+        params.page = String(filters.page);
+    if (filters?.pageSize)
+        params.page_size = String(filters.pageSize);
+    return apiClient.get('/api/stock-exchanges/', { params });
+};
+exports.getStockExchanges = getStockExchanges;
+const getStockExchange = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Stock exchange UUID is required');
+    }
+    return apiClient.get(`/api/stock-exchanges/${uuid}/`);
+};
+exports.getStockExchange = getStockExchange;
+const getStockExchangesByCountry = async ({ apiClient }, countryUuid, filters) => {
+    if (!countryUuid?.trim()) {
+        throw new Error('Country UUID is required');
+    }
+    return (0, exports.getStockExchanges)({ apiClient }, { ...filters, country: countryUuid });
+};
+exports.getStockExchangesByCountry = getStockExchangesByCountry;
+const getActiveStockExchanges = async ({ apiClient }, filters) => {
+    return (0, exports.getStockExchanges)({ apiClient }, { ...filters, isActive: true });
+};
+exports.getActiveStockExchanges = getActiveStockExchanges;
+const searchStockExchanges = async ({ apiClient }, searchTerm, filters) => {
+    if (!searchTerm?.trim()) {
+        throw new Error('Search term is required');
+    }
+    return (0, exports.getStockExchanges)({ apiClient }, { ...filters, search: searchTerm });
+};
+exports.searchStockExchanges = searchStockExchanges;
+const getStockExchangeByCode = async ({ apiClient }, code) => {
+    if (!code?.trim()) {
+        throw new Error('Stock exchange code is required');
+    }
+    const response = await (0, exports.getStockExchanges)({ apiClient }, { code: code.toUpperCase() });
+    return response.results[0] || null;
+};
+exports.getStockExchangeByCode = getStockExchangeByCode;
+// =============================
+// UTILITY FUNCTIONS
+// =============================
+// Helper to get all active reference data at once
+const getAllActiveReferenceData = async ({ apiClient }) => {
+    const [countries, industries, sectors, stockExchanges] = await Promise.all([
+        (0, exports.getAvailableCountries)({ apiClient }).then(res => res.results),
+        (0, exports.getActiveIndustries)({ apiClient }).then(res => res.results),
+        (0, exports.getActiveSectors)({ apiClient }).then(res => res.results),
+        (0, exports.getActiveStockExchanges)({ apiClient }).then(res => res.results),
+    ]);
+    return { countries, industries, sectors, stockExchanges };
+};
+exports.getAllActiveReferenceData = getAllActiveReferenceData;
+// Format country display name
+const formatCountryName = (country) => {
+    return `${country.name} (${country.code})`;
+};
+exports.formatCountryName = formatCountryName;
+// Format stock exchange display name
+const formatStockExchangeName = (exchange) => {
+    return `${exchange.name} (${exchange.code})`;
+};
+exports.formatStockExchangeName = formatStockExchangeName;
+// Get sectors grouped by industry
+const getSectorsGroupedByIndustry = async ({ apiClient }) => {
+    const [industries, sectors] = await Promise.all([
+        (0, exports.getActiveIndustries)({ apiClient }).then(res => res.results),
+        (0, exports.getActiveSectors)({ apiClient }).then(res => res.results),
+    ]);
+    const grouped = new Map();
+    industries.forEach(industry => {
+        grouped.set(industry.uuid, []);
+    });
+    sectors.forEach(sector => {
+        const industrySectors = grouped.get(sector.industry) || [];
+        industrySectors.push(sector);
+        grouped.set(sector.industry, industrySectors);
+    });
+    return grouped;
+};
+exports.getSectorsGroupedByIndustry = getSectorsGroupedByIndustry;

package/dist/services/tax-residencies.d.ts

@@ -0,0 +1,83 @@
+/**
+ * Tax Residency Services - Pure Functional Implementation
+ *
+ * Tax residency management operations as pure functions with explicit dependencies.
+ * No global state, no side effects - everything is explicit and testable.
+ */
+import type { ApiClient } from '../api/functional-client';
+export interface TaxResidency {
+    readonly uuid: string;
+    readonly userProfile: string;
+    readonly country: string;
+    readonly countryName: string;
+    readonly countryCode: string;
+    readonly taxIdentificationNumber?: string;
+    readonly isPrimary: boolean;
+    readonly startDate: string;
+    readonly endDate?: string;
+    readonly createdAt: string;
+    readonly updatedAt: string;
+}
+export interface CreateTaxResidencyPayload {
+    readonly userProfile: string;
+    readonly country: string;
+    readonly taxIdentificationNumber?: string;
+    readonly isPrimary?: boolean;
+    readonly startDate: string;
+    readonly endDate?: string;
+}
+export interface UpdateTaxResidencyPayload {
+    readonly country?: string;
+    readonly taxIdentificationNumber?: string;
+    readonly isPrimary?: boolean;
+    readonly startDate?: string;
+    readonly endDate?: string;
+}
+export interface TaxResidencyFilters {
+    readonly userProfile?: string;
+    readonly country?: string;
+    readonly isPrimary?: boolean;
+    readonly isActive?: boolean;
+    readonly ordering?: string;
+}
+export interface PaginatedTaxResidencies {
+    readonly results: TaxResidency[];
+    readonly count: number;
+    readonly next: string | null;
+    readonly previous: string | null;
+}
+export declare const getTaxResidencies: ({ apiClient }: {
+    apiClient: ApiClient;
+}, filters?: TaxResidencyFilters) => Promise<PaginatedTaxResidencies>;
+export declare const getTaxResidency: ({ apiClient }: {
+    apiClient: ApiClient;
+}, uuid: string) => Promise<TaxResidency>;
+export declare const createTaxResidency: ({ apiClient }: {
+    apiClient: ApiClient;
+}, data: CreateTaxResidencyPayload) => Promise<TaxResidency>;
+export declare const updateTaxResidency: ({ apiClient }: {
+    apiClient: ApiClient;
+}, uuid: string, data: UpdateTaxResidencyPayload) => Promise<TaxResidency>;
+export declare const deleteTaxResidency: ({ apiClient }: {
+    apiClient: ApiClient;
+}, uuid: string) => Promise<void>;
+export declare const setPrimaryTaxResidency: ({ apiClient }: {
+    apiClient: ApiClient;
+}, uuid: string) => Promise<TaxResidency>;
+export declare const getUserTaxResidencies: ({ apiClient }: {
+    apiClient: ApiClient;
+}, userProfileUuid: string) => Promise<PaginatedTaxResidencies>;
+export declare const getActiveTaxResidencies: ({ apiClient }: {
+    apiClient: ApiClient;
+}, userProfileUuid?: string) => Promise<PaginatedTaxResidencies>;
+export declare const getPrimaryTaxResidency: ({ apiClient }: {
+    apiClient: ApiClient;
+}, userProfileUuid: string) => Promise<TaxResidency | null>;
+export declare const getTaxResidenciesByCountry: ({ apiClient }: {
+    apiClient: ApiClient;
+}, countryUuid: string, userProfileUuid?: string) => Promise<PaginatedTaxResidencies>;
+export declare const isTaxResidencyActive: (taxResidency: TaxResidency) => boolean;
+export declare const formatTaxResidencyPeriod: (taxResidency: TaxResidency) => string;
+export declare const validateTaxIdentificationNumber: (tin: string, countryCode: string) => boolean;
+export declare const canHaveMultipleResidencies: (countryCode: string) => boolean;
+//# sourceMappingURL=tax-residencies.d.ts.map

package/dist/services/tax-residencies.d.ts.map

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

package/dist/services/tax-residencies.js

@@ -0,0 +1,179 @@
+"use strict";
+/**
+ * Tax Residency Services - Pure Functional Implementation
+ *
+ * Tax residency management operations as pure functions with explicit dependencies.
+ * No global state, no side effects - everything is explicit and testable.
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.canHaveMultipleResidencies = exports.validateTaxIdentificationNumber = exports.formatTaxResidencyPeriod = exports.isTaxResidencyActive = exports.getTaxResidenciesByCountry = exports.getPrimaryTaxResidency = exports.getActiveTaxResidencies = exports.getUserTaxResidencies = exports.setPrimaryTaxResidency = exports.deleteTaxResidency = exports.updateTaxResidency = exports.createTaxResidency = exports.getTaxResidency = exports.getTaxResidencies = void 0;
+// Tax residency operations with explicit dependencies
+const getTaxResidencies = async ({ apiClient }, filters) => {
+    const params = {};
+    if (filters?.userProfile)
+        params.user_profile = filters.userProfile;
+    if (filters?.country)
+        params.country = filters.country;
+    if (filters?.isPrimary !== undefined)
+        params.is_primary = String(filters.isPrimary);
+    if (filters?.isActive !== undefined)
+        params.is_active = String(filters.isActive);
+    if (filters?.ordering) {
+        params.ordering = filters.ordering;
+    }
+    else {
+        // Default ordering: primary first, then by country name
+        params.ordering = '-is_primary,country';
+    }
+    return apiClient.get('/api/tax-residencies/', { params });
+};
+exports.getTaxResidencies = getTaxResidencies;
+const getTaxResidency = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Tax residency UUID is required');
+    }
+    return apiClient.get(`/api/tax-residencies/${uuid}/`);
+};
+exports.getTaxResidency = getTaxResidency;
+const createTaxResidency = async ({ apiClient }, data) => {
+    // Validation
+    if (!data.userProfile?.trim()) {
+        throw new Error('User profile UUID is required');
+    }
+    if (!data.country?.trim()) {
+        throw new Error('Country UUID is required');
+    }
+    if (!data.startDate?.trim()) {
+        throw new Error('Start date is required');
+    }
+    // Validate date format (YYYY-MM-DD)
+    const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+    if (!dateRegex.test(data.startDate)) {
+        throw new Error('Start date must be in YYYY-MM-DD format');
+    }
+    if (data.endDate && !dateRegex.test(data.endDate)) {
+        throw new Error('End date must be in YYYY-MM-DD format');
+    }
+    // Validate end date is after start date
+    if (data.endDate && new Date(data.endDate) <= new Date(data.startDate)) {
+        throw new Error('End date must be after start date');
+    }
+    return apiClient.post('/api/tax-residencies/', data);
+};
+exports.createTaxResidency = createTaxResidency;
+const updateTaxResidency = async ({ apiClient }, uuid, data) => {
+    if (!uuid?.trim()) {
+        throw new Error('Tax residency UUID is required');
+    }
+    // Validate date formats if provided
+    const dateRegex = /^\d{4}-\d{2}-\d{2}$/;
+    if (data.startDate && !dateRegex.test(data.startDate)) {
+        throw new Error('Start date must be in YYYY-MM-DD format');
+    }
+    if (data.endDate && !dateRegex.test(data.endDate)) {
+        throw new Error('End date must be in YYYY-MM-DD format');
+    }
+    return apiClient.patch(`/api/tax-residencies/${uuid}/`, data);
+};
+exports.updateTaxResidency = updateTaxResidency;
+const deleteTaxResidency = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Tax residency UUID is required');
+    }
+    await apiClient.delete(`/api/tax-residencies/${uuid}/`);
+};
+exports.deleteTaxResidency = deleteTaxResidency;
+const setPrimaryTaxResidency = async ({ apiClient }, uuid) => {
+    if (!uuid?.trim()) {
+        throw new Error('Tax residency UUID is required');
+    }
+    return apiClient.post(`/api/tax-residencies/${uuid}/set-primary/`, {});
+};
+exports.setPrimaryTaxResidency = setPrimaryTaxResidency;
+// Helper functions
+const getUserTaxResidencies = async ({ apiClient }, userProfileUuid) => {
+    if (!userProfileUuid?.trim()) {
+        throw new Error('User profile UUID is required');
+    }
+    return (0, exports.getTaxResidencies)({ apiClient }, {
+        userProfile: userProfileUuid,
+        ordering: '-is_primary,start_date',
+    });
+};
+exports.getUserTaxResidencies = getUserTaxResidencies;
+const getActiveTaxResidencies = async ({ apiClient }, userProfileUuid) => {
+    return (0, exports.getTaxResidencies)({ apiClient }, {
+        userProfile: userProfileUuid,
+        isActive: true,
+        ordering: '-is_primary,country',
+    });
+};
+exports.getActiveTaxResidencies = getActiveTaxResidencies;
+const getPrimaryTaxResidency = async ({ apiClient }, userProfileUuid) => {
+    if (!userProfileUuid?.trim()) {
+        throw new Error('User profile UUID is required');
+    }
+    const response = await (0, exports.getTaxResidencies)({ apiClient }, {
+        userProfile: userProfileUuid,
+        isPrimary: true,
+        isActive: true,
+    });
+    return response.results[0] || null;
+};
+exports.getPrimaryTaxResidency = getPrimaryTaxResidency;
+const getTaxResidenciesByCountry = async ({ apiClient }, countryUuid, userProfileUuid) => {
+    if (!countryUuid?.trim()) {
+        throw new Error('Country UUID is required');
+    }
+    return (0, exports.getTaxResidencies)({ apiClient }, {
+        country: countryUuid,
+        userProfile: userProfileUuid,
+        ordering: '-is_primary,start_date',
+    });
+};
+exports.getTaxResidenciesByCountry = getTaxResidenciesByCountry;
+// Utility functions
+const isTaxResidencyActive = (taxResidency) => {
+    if (!taxResidency.endDate)
+        return true;
+    return new Date(taxResidency.endDate) >= new Date();
+};
+exports.isTaxResidencyActive = isTaxResidencyActive;
+const formatTaxResidencyPeriod = (taxResidency) => {
+    const startDate = new Date(taxResidency.startDate).toLocaleDateString();
+    if (!taxResidency.endDate) {
+        return `Since ${startDate}`;
+    }
+    const endDate = new Date(taxResidency.endDate).toLocaleDateString();
+    return `${startDate} - ${endDate}`;
+};
+exports.formatTaxResidencyPeriod = formatTaxResidencyPeriod;
+const validateTaxIdentificationNumber = (tin, countryCode) => {
+    // Basic validation - can be enhanced with country-specific rules
+    if (!tin?.trim())
+        return false;
+    // Remove spaces and special characters
+    const cleanTin = tin.replace(/[\s-]/g, '');
+    // Country-specific validation rules (examples)
+    switch (countryCode) {
+        case 'AU':
+            // Australian TFN: 8 or 9 digits
+            return /^\d{8,9}$/.test(cleanTin);
+        case 'US':
+            // US SSN: 9 digits (XXX-XX-XXXX format)
+            return /^\d{9}$/.test(cleanTin);
+        case 'GB':
+            // UK NI Number: 2 letters, 6 digits, 1 letter
+            return /^[A-Z]{2}\d{6}[A-Z]$/.test(cleanTin.toUpperCase());
+        default:
+            // Generic validation: at least 6 alphanumeric characters
+            return /^[A-Z0-9]{6,}$/i.test(cleanTin);
+    }
+};
+exports.validateTaxIdentificationNumber = validateTaxIdentificationNumber;
+const canHaveMultipleResidencies = (countryCode) => {
+    // Some countries allow dual/multiple tax residencies
+    const multiResidencyCountries = ['AU', 'CA', 'NZ', 'GB', 'IE'];
+    return multiResidencyCountries.includes(countryCode);
+};
+exports.canHaveMultipleResidencies = canHaveMultipleResidencies;