ofcoop-shared-core 0.1.0-alpha.0

package/dist/services/createOfcoopCreditCompositionProviders.js

@@ -0,0 +1,233 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOfcoopCreditCompositionProviders = createOfcoopCreditCompositionProviders;
+function dateOnly(iso) {
+    return iso.slice(0, 10);
+}
+function dateShiftIso(baseDateIso, diffDays) {
+    const d = new Date(`${baseDateIso}T00:00:00.000Z`);
+    d.setUTCDate(d.getUTCDate() + diffDays);
+    return d.toISOString().slice(0, 10);
+}
+function toLoanStatusComposition(board) {
+    const out = { aktif: 0, jatuhTempo: 0, macet: 0, lunas: 0 };
+    for (const item of board) {
+        if (item.status === 'defaulted') {
+            out.macet += 1;
+            continue;
+        }
+        if (item.status === 'closed') {
+            out.lunas += 1;
+            continue;
+        }
+        if (item.overdueInstallmentCount > 0) {
+            out.jatuhTempo += 1;
+        }
+        else {
+            out.aktif += 1;
+        }
+    }
+    return out;
+}
+function toLoanAgingBuckets(overdueItems, todayDate) {
+    const bucket = { d0to7: 0, d8to30: 0, d31to60: 0, dOver60: 0 };
+    const todayMs = Date.parse(`${todayDate}T00:00:00.000Z`);
+    for (const item of overdueItems) {
+        const dueMs = Date.parse(`${dateOnly(item.dueDate)}T00:00:00.000Z`);
+        const ageDays = Math.max(0, Math.floor((todayMs - dueMs) / (24 * 60 * 60 * 1000)));
+        if (ageDays <= 7)
+            bucket.d0to7 += 1;
+        else if (ageDays <= 30)
+            bucket.d8to30 += 1;
+        else if (ageDays <= 60)
+            bucket.d31to60 += 1;
+        else
+            bucket.dOver60 += 1;
+    }
+    return bucket;
+}
+function requireTenant(scope) {
+    if (!scope?.tenantId)
+        return null;
+    return {
+        tenantId: scope.tenantId,
+        ...(scope.branchId ? { branchId: scope.branchId } : {}),
+    };
+}
+function createOfcoopCreditCompositionProviders(credit) {
+    const member360 = {
+        async getCreditByMember(memberId, scope) {
+            const loans = await credit.loanService.listLoansByMember(memberId, {
+                includeDeleted: false,
+                ...(scope?.tenantId ? { tenantId: scope.tenantId } : {}),
+                ...(scope?.branchId ? { branchId: scope.branchId } : {}),
+            });
+            const summary = {
+                totalLoans: loans.length,
+                activeLoans: loans.filter((l) => l.status === 'active').length,
+                closedLoans: loans.filter((l) => l.status === 'closed').length,
+                defaultedLoans: loans.filter((l) => l.status === 'defaulted').length,
+                totalPrincipalAmount: loans.reduce((sum, l) => sum + l.principalAmount, 0),
+            };
+            const recentLoans = [...loans]
+                .sort((a, b) => b.startDate.localeCompare(a.startDate))
+                .slice(0, 5)
+                .map((loan) => ({
+                loanId: loan.id,
+                status: loan.status,
+                principalAmount: loan.principalAmount,
+                startDate: loan.startDate,
+            }));
+            return { summary, recentLoans };
+        },
+        async getSettlementSummaryByMember(memberId, scope) {
+            const scoped = requireTenant(scope);
+            if (!scoped) {
+                return {
+                    totalOutstanding: 0,
+                    totalOverdue: 0,
+                    settlementStatus: 'clear',
+                    notes: 'tenantId missing in scope',
+                };
+            }
+            const board = await credit.loanBoardService.listLoanBoard(scoped, { memberId });
+            const totalOutstanding = board.reduce((sum, item) => sum + item.outstandingAmount, 0);
+            const totalOverdue = board
+                .filter((item) => item.overdueInstallmentCount > 0)
+                .reduce((sum, item) => sum + item.outstandingAmount, 0);
+            return {
+                totalOutstanding,
+                totalOverdue,
+                settlementStatus: totalOverdue > 0 ? 'overdue' : totalOutstanding > 0 ? 'pending' : 'clear',
+            };
+        },
+    };
+    const dashboard = {
+        async getLoanStatusComposition(scope) {
+            const scoped = requireTenant(scope);
+            if (!scoped)
+                return { aktif: 0, jatuhTempo: 0, macet: 0, lunas: 0 };
+            const board = await credit.loanBoardService.listLoanBoard(scoped);
+            return toLoanStatusComposition(board);
+        },
+        async getLoanAgingBuckets(scope) {
+            const scoped = requireTenant(scope);
+            if (!scoped)
+                return { d0to7: 0, d8to30: 0, d31to60: 0, dOver60: 0 };
+            const todayDate = dateOnly(new Date().toISOString());
+            const sixtyDaysAgo = dateShiftIso(todayDate, -60);
+            const overdue = await credit.loanDueWindowService.listLoansDueInWindow(scoped, {
+                dateFrom: `1970-01-01T00:00:00.000Z`,
+                dateTo: `${todayDate}T23:59:59.999Z`,
+            });
+            const recentOverdue = overdue.filter((item) => item.installmentStatus === 'overdue' && dateOnly(item.dueDate) >= sixtyDaysAgo);
+            const olderOverdue = overdue.filter((item) => item.installmentStatus === 'overdue' && dateOnly(item.dueDate) < sixtyDaysAgo);
+            const bucket = toLoanAgingBuckets(recentOverdue, todayDate);
+            bucket.dOver60 += olderOverdue.length;
+            return bucket;
+        },
+        async getTotalOverdueAmount(scope) {
+            const scoped = requireTenant(scope);
+            if (!scoped)
+                return 0;
+            const overdue = await credit.loanDueWindowService.listLoansDueInWindow(scoped, {
+                dateFrom: `1970-01-01T00:00:00.000Z`,
+                dateTo: `${new Date().toISOString().slice(0, 10)}T23:59:59.999Z`,
+            });
+            return overdue
+                .filter((item) => item.installmentStatus === 'overdue')
+                .reduce((sum, item) => sum + item.outstandingAmount, 0);
+        },
+        async getAnggotaCreditSummary(memberId, scope) {
+            const scoped = requireTenant(scope);
+            if (!scoped) {
+                return {
+                    activeLoans: 0,
+                    outstandingPrincipalAmount: 0,
+                    totalOverdueAmount: 0,
+                    nextDueDate: null,
+                };
+            }
+            const board = await credit.loanBoardService.listLoanBoard(scoped, { memberId });
+            const activeLoans = board.filter((item) => item.status === 'active').length;
+            const outstandingPrincipalAmount = board.reduce((sum, item) => sum + item.outstandingAmount, 0);
+            const totalOverdueAmount = board
+                .filter((item) => item.overdueInstallmentCount > 0)
+                .reduce((sum, item) => sum + item.outstandingAmount, 0);
+            const nextDueDate = [...board]
+                .map((item) => item.nextDueDate)
+                .filter(Boolean)
+                .sort((a, b) => String(a).localeCompare(String(b)))[0] ?? null;
+            return {
+                activeLoans,
+                outstandingPrincipalAmount,
+                totalOverdueAmount,
+                nextDueDate,
+            };
+        },
+        async getLoanRiskMap(scope) {
+            const scoped = requireTenant(scope);
+            if (!scoped)
+                return [];
+            const todayDate = dateOnly(new Date().toISOString());
+            const board = await credit.loanBoardService.listLoanBoard(scoped);
+            const overdue = await credit.loanDueWindowService.listLoansDueInWindow(scoped, {
+                dateFrom: `1970-01-01T00:00:00.000Z`,
+                dateTo: `${todayDate}T23:59:59.999Z`,
+            });
+            const overdueAgeByLoan = new Map();
+            const todayMs = Date.parse(`${todayDate}T00:00:00.000Z`);
+            for (const item of overdue) {
+                if (item.installmentStatus !== 'overdue')
+                    continue;
+                const dueMs = Date.parse(`${dateOnly(item.dueDate)}T00:00:00.000Z`);
+                const ageDays = Math.max(0, Math.floor((todayMs - dueMs) / (24 * 60 * 60 * 1000)));
+                const prev = overdueAgeByLoan.get(item.loanId) ?? 0;
+                if (ageDays > prev)
+                    overdueAgeByLoan.set(item.loanId, ageDays);
+            }
+            return board.map((item) => {
+                const overdueAgeDays = overdueAgeByLoan.get(item.loanId) ?? 0;
+                const riskLevel = overdueAgeDays > 60 || item.outstandingAmount >= 5000000
+                    ? 'high'
+                    : overdueAgeDays > 30 || item.outstandingAmount >= 1000000
+                        ? 'medium'
+                        : 'low';
+                return {
+                    loanId: item.loanId,
+                    memberId: item.memberId,
+                    outstandingAmount: item.outstandingAmount,
+                    overdueAgeDays,
+                    riskLevel,
+                };
+            });
+        },
+    };
+    const report = {
+        async getCreditSummary(_period, scope) {
+            const scoped = requireTenant(scope);
+            if (!scoped) {
+                return {
+                    loanCount: 0,
+                    activeLoanCount: 0,
+                    closedLoanCount: 0,
+                    defaultedLoanCount: 0,
+                    outstandingPrincipalAmount: 0,
+                    totalOverdueAmount: 0,
+                };
+            }
+            const board = await credit.loanBoardService.listLoanBoard(scoped);
+            return {
+                loanCount: board.length,
+                activeLoanCount: board.filter((item) => item.status === 'active').length,
+                closedLoanCount: board.filter((item) => item.status === 'closed').length,
+                defaultedLoanCount: board.filter((item) => item.status === 'defaulted').length,
+                outstandingPrincipalAmount: board.reduce((sum, item) => sum + item.outstandingAmount, 0),
+                totalOverdueAmount: board
+                    .filter((item) => item.overdueInstallmentCount > 0)
+                    .reduce((sum, item) => sum + item.outstandingAmount, 0),
+            };
+        },
+    };
+    return { member360, dashboard, report };
+}

package/dist/services/createOfcoopDashboardCompositionProviders.d.ts

@@ -0,0 +1,18 @@
+import type { MemberServiceContract } from '../contracts/MemberContract';
+import type { SavingLedgerServiceContract } from '../contracts/SavingLedgerContract';
+import type { ShuPeriodContract, ShuServiceContract } from '../contracts/ShuContract';
+import type { DashboardScopeRef, DashboardSummaryProviders } from './DashboardSummaryService';
+interface OfcoopDashboardCompositionServicesRef {
+    memberService: Pick<MemberServiceContract, 'listMembers'>;
+    savingLedgerService: Pick<SavingLedgerServiceContract, 'listSavingEntriesByMember' | 'getSavingBalanceByMember'>;
+    shuService?: Pick<ShuServiceContract, 'listShuAllocations' | 'listShuPeriods'>;
+}
+interface CreateOfcoopDashboardCompositionOptions {
+    monthsWindow?: number;
+    heatmapDays?: number;
+    referenceDate?: string;
+    resolveCurrentShuPeriodId?: (scope?: DashboardScopeRef) => Promise<string | null>;
+}
+export declare function resolveCurrentShuPeriodIdFromRows(periods: ShuPeriodContract[], referenceDateIso?: string): string | null;
+export declare function createOfcoopDashboardCompositionProviders(services: OfcoopDashboardCompositionServicesRef, options?: CreateOfcoopDashboardCompositionOptions): Pick<DashboardSummaryProviders, 'getOnboardingFunnel' | 'getWajibComplianceTrend' | 'getSavingTypeCompositionByPeriod' | 'getMemberGrowthTrend' | 'getShuDistributionSummary' | 'getOperationalActivityHeatmap'>;
+export {};

package/dist/services/createOfcoopDashboardCompositionProviders.js

@@ -0,0 +1,228 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveCurrentShuPeriodIdFromRows = resolveCurrentShuPeriodIdFromRows;
+exports.createOfcoopDashboardCompositionProviders = createOfcoopDashboardCompositionProviders;
+const DAY_MS = 24 * 60 * 60 * 1000;
+function dateOnly(iso) {
+    return iso.slice(0, 10);
+}
+function monthKeyFromIso(iso) {
+    return iso.slice(0, 7);
+}
+function monthStartUtc(monthKey) {
+    return new Date(`${monthKey}-01T00:00:00.000Z`);
+}
+function monthEndUtc(monthKey) {
+    const start = monthStartUtc(monthKey);
+    return new Date(Date.UTC(start.getUTCFullYear(), start.getUTCMonth() + 1, 0, 23, 59, 59, 999));
+}
+function listRecentMonthKeys(windowSize, referenceIso = new Date().toISOString()) {
+    const ref = new Date(referenceIso);
+    const out = [];
+    for (let i = windowSize - 1; i >= 0; i -= 1) {
+        const d = new Date(Date.UTC(ref.getUTCFullYear(), ref.getUTCMonth() - i, 1));
+        out.push(`${d.getUTCFullYear()}-${String(d.getUTCMonth() + 1).padStart(2, '0')}`);
+    }
+    return out;
+}
+function toScopeQuery(scope) {
+    return {
+        ...(scope?.tenantId ? { tenantId: scope.tenantId } : {}),
+        ...(scope?.branchId ? { branchId: scope.branchId } : {}),
+    };
+}
+function periodContainsDate(period, dateOnlyIso) {
+    return period.startDate <= dateOnlyIso && period.endDate >= dateOnlyIso;
+}
+function resolveCurrentShuPeriodIdFromRows(periods, referenceDateIso = new Date().toISOString()) {
+    if (periods.length === 0)
+        return null;
+    const referenceDate = dateOnly(referenceDateIso);
+    const activePeriods = periods.filter((row) => periodContainsDate(row, referenceDate));
+    if (activePeriods.length > 0) {
+        return [...activePeriods].sort((a, b) => b.endDate.localeCompare(a.endDate))[0]?.id ?? null;
+    }
+    const finalized = periods.filter((row) => row.status === 'finalized');
+    if (finalized.length > 0) {
+        return [...finalized].sort((a, b) => b.endDate.localeCompare(a.endDate))[0]?.id ?? null;
+    }
+    return [...periods].sort((a, b) => b.endDate.localeCompare(a.endDate))[0]?.id ?? null;
+}
+function memberIsActiveAtMonth(member, monthKey) {
+    const end = monthEndUtc(monthKey).toISOString();
+    const joined = member.joinDate <= end;
+    if (!joined)
+        return false;
+    if (member.status !== 'active')
+        return false;
+    if (member.exitDate && member.exitDate <= end)
+        return false;
+    return true;
+}
+function memberIsJoinedAtMonth(member, monthKey) {
+    const end = monthEndUtc(monthKey).toISOString();
+    return member.joinDate <= end;
+}
+async function collectEntriesByMember(savingLedgerService, memberIds, dateFromIso, dateToIso, scope) {
+    const rows = await Promise.all(memberIds.map((memberId) => savingLedgerService.listSavingEntriesByMember(memberId, {
+        includeDeleted: false,
+        dateFrom: dateFromIso,
+        dateTo: dateToIso,
+        ...toScopeQuery(scope),
+    })));
+    return rows.flat();
+}
+function createOfcoopDashboardCompositionProviders(services, options = {}) {
+    const monthsWindow = Math.max(1, Math.min(24, options.monthsWindow ?? 6));
+    const heatmapDays = Math.max(1, Math.min(180, options.heatmapDays ?? 30));
+    const resolveCurrentShuPeriodId = async (scope) => {
+        if (options.resolveCurrentShuPeriodId) {
+            return options.resolveCurrentShuPeriodId(scope);
+        }
+        if (!services.shuService?.listShuPeriods)
+            return null;
+        const periods = await services.shuService.listShuPeriods({
+            includeDeleted: false,
+            ...(scope?.tenantId ? { tenantId: scope.tenantId } : {}),
+            ...(scope?.branchId ? { branchId: scope.branchId } : {}),
+        });
+        return resolveCurrentShuPeriodIdFromRows(periods, options.referenceDate);
+    };
+    return {
+        async getOnboardingFunnel(scope) {
+            const members = await services.memberService.listMembers({
+                includeDeleted: false,
+                ...toScopeQuery(scope),
+            });
+            const balances = await Promise.all(members.map((member) => services.savingLedgerService.getSavingBalanceByMember(member.id)));
+            const verifikasiPokok = balances.filter((b) => b.pokok > 0).length;
+            const aktif = members.filter((member, idx) => member.status === 'active' && (balances[idx]?.pokok ?? 0) > 0).length;
+            return {
+                daftar: members.length,
+                verifikasiPokok,
+                aktif,
+            };
+        },
+        async getWajibComplianceTrend(scope) {
+            const monthKeys = listRecentMonthKeys(monthsWindow);
+            const members = await services.memberService.listMembers({
+                includeDeleted: false,
+                status: 'active',
+                ...toScopeQuery(scope),
+            });
+            const memberIds = members.map((member) => member.id);
+            if (memberIds.length === 0) {
+                return monthKeys.map((month) => ({ month, patuh: 0, menunggak: 0 }));
+            }
+            const firstMonth = monthKeys[0];
+            const lastMonth = monthKeys[monthKeys.length - 1];
+            const entries = await collectEntriesByMember(services.savingLedgerService, memberIds, `${firstMonth}-01T00:00:00.000Z`, monthEndUtc(lastMonth).toISOString(), scope);
+            const wajibCreditMonthSet = new Set(entries
+                .filter((entry) => entry.savingType === 'wajib' && entry.entryType === 'credit' && entry.amount > 0)
+                .map((entry) => `${entry.memberId}:${monthKeyFromIso(entry.transactionDate)}`));
+            return monthKeys.map((month) => {
+                let patuh = 0;
+                let menunggak = 0;
+                for (const memberId of memberIds) {
+                    if (wajibCreditMonthSet.has(`${memberId}:${month}`))
+                        patuh += 1;
+                    else
+                        menunggak += 1;
+                }
+                return { month, patuh, menunggak };
+            });
+        },
+        async getSavingTypeCompositionByPeriod(scope) {
+            const monthKeys = listRecentMonthKeys(monthsWindow);
+            const members = await services.memberService.listMembers({
+                includeDeleted: false,
+                ...toScopeQuery(scope),
+            });
+            const memberIds = members.map((member) => member.id);
+            if (memberIds.length === 0) {
+                return monthKeys.map((period) => ({ period, pokok: 0, wajib: 0, sukarela: 0 }));
+            }
+            const firstMonth = monthKeys[0];
+            const lastMonth = monthKeys[monthKeys.length - 1];
+            const entries = await collectEntriesByMember(services.savingLedgerService, memberIds, `${firstMonth}-01T00:00:00.000Z`, monthEndUtc(lastMonth).toISOString(), scope);
+            const buckets = new Map();
+            for (const month of monthKeys) {
+                buckets.set(month, { period: month, pokok: 0, wajib: 0, sukarela: 0 });
+            }
+            for (const entry of entries) {
+                const month = monthKeyFromIso(entry.transactionDate);
+                const bucket = buckets.get(month);
+                if (!bucket)
+                    continue;
+                const sign = entry.entryType === 'credit' ? 1 : -1;
+                if (entry.savingType === 'pokok')
+                    bucket.pokok += sign * entry.amount;
+                if (entry.savingType === 'wajib')
+                    bucket.wajib += sign * entry.amount;
+                if (entry.savingType === 'sukarela')
+                    bucket.sukarela += sign * entry.amount;
+            }
+            return monthKeys.map((month) => buckets.get(month) ?? { period: month, pokok: 0, wajib: 0, sukarela: 0 });
+        },
+        async getMemberGrowthTrend(scope) {
+            const monthKeys = listRecentMonthKeys(monthsWindow);
+            const members = await services.memberService.listMembers({
+                includeDeleted: false,
+                ...toScopeQuery(scope),
+            });
+            return monthKeys.map((month) => {
+                const joined = members.filter((member) => memberIsJoinedAtMonth(member, month)).length;
+                const active = members.filter((member) => memberIsActiveAtMonth(member, month)).length;
+                return {
+                    month,
+                    active,
+                    nonActive: Math.max(0, joined - active),
+                };
+            });
+        },
+        async getShuDistributionSummary(scope) {
+            if (!services.shuService)
+                return [];
+            const periodId = await resolveCurrentShuPeriodId(scope);
+            if (!periodId)
+                return [];
+            const allocations = await services.shuService.listShuAllocations(periodId, { includeDeleted: false });
+            const scoped = allocations.filter((row) => {
+                if (scope?.tenantId && row.tenantId !== scope.tenantId)
+                    return false;
+                if (scope?.branchId && row.branchId !== scope.branchId)
+                    return false;
+                return true;
+            });
+            return [...scoped]
+                .sort((a, b) => b.allocationAmount - a.allocationAmount)
+                .slice(0, 10)
+                .map((row) => ({
+                memberId: row.memberId,
+                allocationAmount: row.allocationAmount,
+            }));
+        },
+        async getOperationalActivityHeatmap(scope) {
+            const members = await services.memberService.listMembers({
+                includeDeleted: false,
+                ...toScopeQuery(scope),
+            });
+            const memberIds = members.map((member) => member.id);
+            if (memberIds.length === 0)
+                return [];
+            const toDateIso = new Date().toISOString();
+            const fromDateIso = new Date(Date.now() - (heatmapDays - 1) * DAY_MS).toISOString();
+            const entries = await collectEntriesByMember(services.savingLedgerService, memberIds, fromDateIso, toDateIso, scope);
+            const map = new Map();
+            for (const entry of entries) {
+                const day = dateOnly(entry.transactionDate);
+                const hour = new Date(entry.transactionDate).getUTCHours();
+                const key = `${day}:${hour}`;
+                const prev = map.get(key) ?? { day, hour, total: 0 };
+                prev.total += 1;
+                map.set(key, prev);
+            }
+            return Array.from(map.values()).sort((a, b) => (a.day === b.day ? a.hour - b.hour : a.day.localeCompare(b.day)));
+        },
+    };
+}

package/dist/services/createOfcoopDomainAuditCompositionProviders.d.ts

@@ -0,0 +1,36 @@
+import type { AuditTrailEvent, AuditTrailQueryInput } from './AuditTrailQueryService';
+import type { Member360Providers } from './Member360Service';
+export declare const OFCOOP_AUDIT_EVENT_CATALOG: readonly ["member.created", "member.updated", "saving.entry-recorded", "saving.policy-upserted", "shu.config-upserted", "shu.period-created", "shu.period-finalized", "shu.allocations-generated"];
+export declare const OFCOOP_CREDIT_AUDIT_EVENT_CATALOG: readonly ["loan.created", "loan.closed", "installment.schedule-generated", "installment.payment-recorded", "credit-policy.created", "credit-policy.updated"];
+interface DomainAuditEventRef {
+    eventId: string;
+    name: string;
+    occurredAt: string;
+    entityId?: string;
+    tenantId?: string | null;
+    branchId?: string | null;
+    payload?: Record<string, unknown>;
+}
+interface DomainAuditServiceRef {
+    queryEvents: (query: {
+        memberId?: string;
+        eventNames?: string[];
+        fromTimestamp?: string;
+        toTimestamp?: string;
+        tenantId?: string | null;
+        branchId?: string | null;
+        limit?: number;
+    }) => Promise<DomainAuditEventRef[]>;
+}
+interface OfcoopDomainAuditServicesRef {
+    ofcoop?: DomainAuditServiceRef;
+    ofcoopCredit?: DomainAuditServiceRef;
+}
+export declare function createOfcoopDomainAuditCompositionProviders(services: OfcoopDomainAuditServicesRef): {
+    member360: Pick<Member360Providers, 'getAuditByMember'>;
+    auditTrailProvider: {
+        listEvents: (query: AuditTrailQueryInput) => Promise<AuditTrailEvent[]>;
+    };
+    eventCatalog: string[];
+};
+export {};

package/dist/services/createOfcoopDomainAuditCompositionProviders.js

@@ -0,0 +1,117 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.OFCOOP_CREDIT_AUDIT_EVENT_CATALOG = exports.OFCOOP_AUDIT_EVENT_CATALOG = void 0;
+exports.createOfcoopDomainAuditCompositionProviders = createOfcoopDomainAuditCompositionProviders;
+exports.OFCOOP_AUDIT_EVENT_CATALOG = [
+    'member.created',
+    'member.updated',
+    'saving.entry-recorded',
+    'saving.policy-upserted',
+    'shu.config-upserted',
+    'shu.period-created',
+    'shu.period-finalized',
+    'shu.allocations-generated',
+];
+exports.OFCOOP_CREDIT_AUDIT_EVENT_CATALOG = [
+    'loan.created',
+    'loan.closed',
+    'installment.schedule-generated',
+    'installment.payment-recorded',
+    'credit-policy.created',
+    'credit-policy.updated',
+];
+function isOfcoopEventType(value) {
+    return exports.OFCOOP_AUDIT_EVENT_CATALOG.includes(value);
+}
+function isOfcoopCreditEventType(value) {
+    return exports.OFCOOP_CREDIT_AUDIT_EVENT_CATALOG.includes(value);
+}
+function toMember360Audit(event) {
+    return {
+        eventId: event.eventId,
+        eventType: event.name,
+        occurredAt: event.occurredAt,
+        message: event.entityId ? `entity:${event.entityId}` : event.name,
+    };
+}
+function extractMemberId(event) {
+    const value = event.payload?.memberId;
+    return typeof value === 'string' && value.trim() ? value : null;
+}
+function toAuditTrailEvent(event, sourceDomain, fallbackMemberId) {
+    return {
+        eventId: event.eventId,
+        sourceDomain,
+        eventType: event.name,
+        occurredAt: event.occurredAt,
+        memberId: extractMemberId(event) ?? fallbackMemberId ?? undefined,
+        tenantId: event.tenantId ?? undefined,
+        branchId: event.branchId ?? undefined,
+        summary: event.entityId ? `entity:${event.entityId}` : event.name,
+    };
+}
+function sortByOccurredAtDesc(rows) {
+    return [...rows].sort((a, b) => b.occurredAt.localeCompare(a.occurredAt));
+}
+const OFCOOP_COMPOSITION_AUDIT_EVENT_CATALOG = [
+    ...exports.OFCOOP_AUDIT_EVENT_CATALOG,
+    ...exports.OFCOOP_CREDIT_AUDIT_EVENT_CATALOG,
+];
+function createOfcoopDomainAuditCompositionProviders(services) {
+    const member360 = {
+        async getAuditByMember(memberId, scope) {
+            const [ofcoopRows, ofcoopCreditRows] = await Promise.all([
+                services.ofcoop?.queryEvents({
+                    memberId,
+                    ...(scope?.tenantId ? { tenantId: scope.tenantId } : {}),
+                    ...(scope?.branchId ? { branchId: scope.branchId } : {}),
+                    limit: 100,
+                }) ?? Promise.resolve([]),
+                services.ofcoopCredit?.queryEvents({
+                    memberId,
+                    ...(scope?.tenantId ? { tenantId: scope.tenantId } : {}),
+                    ...(scope?.branchId ? { branchId: scope.branchId } : {}),
+                    limit: 100,
+                }) ?? Promise.resolve([]),
+            ]);
+            return sortByOccurredAtDesc([...ofcoopRows, ...ofcoopCreditRows]).slice(0, 100).map(toMember360Audit);
+        },
+    };
+    const auditTrailProvider = {
+        async listEvents(query) {
+            const requestedTypes = query.eventTypes ?? [];
+            const ofcoopEventNames = requestedTypes.length > 0 ? requestedTypes.filter(isOfcoopEventType) : undefined;
+            const ofcoopCreditEventNames = requestedTypes.length > 0 ? requestedTypes.filter(isOfcoopCreditEventType) : undefined;
+            const [ofcoopRows, ofcoopCreditRows] = await Promise.all([
+                services.ofcoop?.queryEvents({
+                    ...(query.memberId ? { memberId: query.memberId } : {}),
+                    ...(query.fromTimestamp ? { fromTimestamp: query.fromTimestamp } : {}),
+                    ...(query.toTimestamp ? { toTimestamp: query.toTimestamp } : {}),
+                    ...(query.scope?.tenantId ? { tenantId: query.scope.tenantId } : {}),
+                    ...(query.scope?.branchId ? { branchId: query.scope.branchId } : {}),
+                    ...(ofcoopEventNames ? { eventNames: ofcoopEventNames } : {}),
+                    ...(query.limit ? { limit: query.limit } : {}),
+                }) ?? Promise.resolve([]),
+                services.ofcoopCredit?.queryEvents({
+                    ...(query.memberId ? { memberId: query.memberId } : {}),
+                    ...(query.fromTimestamp ? { fromTimestamp: query.fromTimestamp } : {}),
+                    ...(query.toTimestamp ? { toTimestamp: query.toTimestamp } : {}),
+                    ...(query.scope?.tenantId ? { tenantId: query.scope.tenantId } : {}),
+                    ...(query.scope?.branchId ? { branchId: query.scope.branchId } : {}),
+                    ...(ofcoopCreditEventNames ? { eventNames: ofcoopCreditEventNames } : {}),
+                    ...(query.limit ? { limit: query.limit } : {}),
+                }) ?? Promise.resolve([]),
+            ]);
+            const mapped = [
+                ...ofcoopRows.map((row) => toAuditTrailEvent(row, 'ofcoop', query.memberId)),
+                ...ofcoopCreditRows.map((row) => toAuditTrailEvent(row, 'ofcoop-credit', query.memberId)),
+            ];
+            return sortByOccurredAtDesc(mapped);
+        },
+    };
+    return {
+        member360,
+        auditTrailProvider,
+        eventCatalog: [...OFCOOP_COMPOSITION_AUDIT_EVENT_CATALOG],
+    };
+}

package/dist/services/createOfcoopReportCompositionProviders.d.ts

@@ -0,0 +1,10 @@
+import type { ShuServiceContract } from '../contracts/ShuContract';
+import type { ReportPeriod, ReportScopeRef, ReportSummaryProviders } from './ReportSummaryService';
+interface OfcoopReportCompositionServicesRef {
+    shuService: Pick<ShuServiceContract, 'listShuAllocations'>;
+}
+interface CreateOfcoopReportCompositionOptions {
+    resolveShuPeriodIdsForRange: (period: ReportPeriod, scope?: ReportScopeRef) => Promise<string[]>;
+}
+export declare function createOfcoopReportCompositionProviders(services: OfcoopReportCompositionServicesRef, options: CreateOfcoopReportCompositionOptions): Pick<ReportSummaryProviders, 'getShuSummary'>;
+export {};

package/dist/services/createOfcoopReportCompositionProviders.js

@@ -0,0 +1,30 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.createOfcoopReportCompositionProviders = createOfcoopReportCompositionProviders;
+function createOfcoopReportCompositionProviders(services, options) {
+    return {
+        async getShuSummary(period, scope) {
+            const periodIds = await options.resolveShuPeriodIdsForRange(period, scope);
+            if (!periodIds.length) {
+                return {
+                    allocationCount: 0,
+                    totalAllocatedAmount: 0,
+                };
+            }
+            const allocationsByPeriod = await Promise.all(periodIds.map((periodId) => services.shuService.listShuAllocations(periodId, { includeDeleted: false })));
+            const allocations = allocationsByPeriod
+                .flat()
+                .filter((row) => {
+                if (scope?.tenantId && row.tenantId !== scope.tenantId)
+                    return false;
+                if (scope?.branchId && row.branchId !== scope.branchId)
+                    return false;
+                return true;
+            });
+            return {
+                allocationCount: allocations.length,
+                totalAllocatedAmount: allocations.reduce((sum, row) => sum + row.allocationAmount, 0),
+            };
+        },
+    };
+}