ofcoop-shared-core 0.1.0-alpha.0 → 0.1.0-alpha.2

package/dist/contracts/MemberDependentContract.d.ts

@@ -0,0 +1,43 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type DependentRelationship = 'spouse' | 'child' | 'parent' | 'sibling' | 'other';
+export interface MemberDependentContract extends ScopeRef {
+    id: string;
+    memberId: string;
+    fullName: string;
+    relationship: DependentRelationship;
+    birthDate?: string | null;
+    idNumber?: string | null;
+    isInsuranceBeneficiary: boolean;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface AddMemberDependentInput extends ScopeRef {
+    memberId: string;
+    fullName: string;
+    relationship: DependentRelationship;
+    birthDate?: string | null;
+    idNumber?: string | null;
+    isInsuranceBeneficiary?: boolean;
+    notes?: string | null;
+}
+export interface UpdateMemberDependentInput {
+    fullName?: string;
+    relationship?: DependentRelationship;
+    birthDate?: string | null;
+    idNumber?: string | null;
+    isInsuranceBeneficiary?: boolean;
+    notes?: string | null;
+}
+export interface MemberDependentQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    relationship?: DependentRelationship;
+}
+export interface MemberDependentServiceContract {
+    addDependent(input: AddMemberDependentInput): Promise<ResponseEnvelope<MemberDependentContract>>;
+    updateDependent(dependentId: string, input: UpdateMemberDependentInput): Promise<ResponseEnvelope<MemberDependentContract>>;
+    removeDependent(dependentId: string): Promise<ResponseEnvelope<MemberDependentContract>>;
+    listDependentsByMember(memberId: string, options?: MemberDependentQueryOptions): Promise<ResponseEnvelope<MemberDependentContract[]>>;
+    getDependentById(dependentId: string): Promise<ResponseEnvelope<MemberDependentContract | null>>;
+}

package/dist/contracts/MemberNumberPolicyContract.d.ts

@@ -1,9 +1,8 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
 export type CounterResetPolicy = 'never' | 'yearly';
-export interface MemberNumberPolicyContract {
+export interface MemberNumberPolicyContract extends ScopeRef {
     id: string;
     koperasiId: string;
-    branchId?: string | null;
-    tenantId?: string | null;
     prefix?: string | null;
     includeYear: boolean;
     includeMonth: boolean;
@@ -18,15 +17,11 @@ export interface MemberNumberPolicyContract {
     lastModified: string;
     deleted: boolean;
 }
-export interface MemberNumberPolicyScope {
+export interface MemberNumberPolicyScope extends ScopeRef {
     koperasiId: string;
-    tenantId: string;
-    branchId?: string | null;
 }
-export interface UpsertMemberNumberPolicyInput {
+export interface UpsertMemberNumberPolicyInput extends ScopeRef {
     koperasiId: string;
-    tenantId: string;
-    branchId?: string | null;
     prefix?: string | null;
     includeYear: boolean;
     includeMonth: boolean;
@@ -39,6 +34,6 @@ export interface UpsertMemberNumberPolicyInput {
     approvalRef?: string | null;
 }
 export interface MemberNumberPolicyServiceContract {
-    getActiveMemberNumberPolicy(scope: MemberNumberPolicyScope): Promise<MemberNumberPolicyContract | null>;
-    upsertMemberNumberPolicy(input: UpsertMemberNumberPolicyInput): Promise<MemberNumberPolicyContract>;
+    getActiveMemberNumberPolicy(scope: MemberNumberPolicyScope): Promise<ResponseEnvelope<MemberNumberPolicyContract | null>>;
+    upsertMemberNumberPolicy(input: UpsertMemberNumberPolicyInput): Promise<ResponseEnvelope<MemberNumberPolicyContract>>;
 }

package/dist/contracts/OversightPolicyContract.d.ts

@@ -0,0 +1,28 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+import type { RiskRegisterCategory } from './RiskRegisterContract.js';
+import type { WhistleReportChannel } from './WhistleReportContract.js';
+export type RiskSlaPolicyMap = Record<RiskRegisterCategory, number>;
+export type WhistleSlaPolicyMap = Record<WhistleReportChannel, number>;
+export interface OversightPolicyContract extends ScopeRef {
+    id: string;
+    effectiveDate: string;
+    riskSlaHoursByCategory: RiskSlaPolicyMap;
+    whistleSlaHoursByChannel: WhistleSlaPolicyMap;
+    escalationMaxLevel: number;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface OversightPolicyScope extends ScopeRef {
+}
+export interface UpsertOversightPolicyInput extends ScopeRef {
+    effectiveDate: string;
+    riskSlaHoursByCategory: RiskSlaPolicyMap;
+    whistleSlaHoursByChannel: WhistleSlaPolicyMap;
+    escalationMaxLevel: number;
+}
+export interface OversightPolicyServiceContract {
+    getActiveOversightPolicy(scope: OversightPolicyScope): Promise<ResponseEnvelope<OversightPolicyContract | null>>;
+    upsertOversightPolicy(input: UpsertOversightPolicyInput): Promise<ResponseEnvelope<OversightPolicyContract>>;
+    listOversightPolicies(scope: OversightPolicyScope): Promise<ResponseEnvelope<OversightPolicyContract[]>>;
+}

package/dist/contracts/RiskRegisterContract.d.ts

@@ -0,0 +1,93 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type RiskRegisterCategory = 'operational' | 'credit' | 'compliance' | 'liquidity' | 'governance' | 'other';
+export type RiskRegisterStatus = 'open' | 'mitigating' | 'accepted' | 'closed';
+export type RiskMitigationApprovalStatus = 'not_required' | 'pending' | 'approved' | 'rejected';
+export interface RiskRegisterContract extends ScopeRef {
+    id: string;
+    title: string;
+    description?: string | null;
+    category: RiskRegisterCategory;
+    likelihood: number;
+    impact: number;
+    riskScore: number;
+    status: RiskRegisterStatus;
+    ownerMemberId?: string | null;
+    mitigationPlan?: string | null;
+    slaDueAt?: string | null;
+    escalationLevel: number;
+    escalatedAt?: string | null;
+    escalationReason?: string | null;
+    mitigationApprovalStatus?: RiskMitigationApprovalStatus;
+    mitigationSubmittedAt?: string | null;
+    mitigationReviewedAt?: string | null;
+    mitigationReviewerMemberId?: string | null;
+    mitigationReviewNote?: string | null;
+    nextReviewDate?: string | null;
+    lastReviewedAt?: string | null;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CreateRiskRegisterInput extends ScopeRef {
+    title: string;
+    description?: string | null;
+    category: RiskRegisterCategory;
+    likelihood: number;
+    impact: number;
+    ownerMemberId?: string | null;
+    mitigationPlan?: string | null;
+    slaDueAt?: string | null;
+    nextReviewDate?: string | null;
+    notes?: string | null;
+}
+export interface UpdateRiskRegisterInput {
+    title?: string;
+    description?: string | null;
+    category?: RiskRegisterCategory;
+    likelihood?: number;
+    impact?: number;
+    ownerMemberId?: string | null;
+    mitigationPlan?: string | null;
+    slaDueAt?: string | null;
+    nextReviewDate?: string | null;
+    notes?: string | null;
+}
+export interface UpdateRiskRegisterStatusInput {
+    status: RiskRegisterStatus;
+    notes?: string | null;
+}
+export interface RecordRiskRegisterReviewInput {
+    reviewedAt: string;
+    notes?: string | null;
+}
+export interface EscalateRiskRegisterInput {
+    reason: string;
+    escalatedAt?: string;
+}
+export interface SubmitRiskMitigationApprovalInput {
+    submittedAt?: string;
+    note?: string | null;
+}
+export interface ReviewRiskMitigationApprovalInput {
+    decision: 'approved' | 'rejected';
+    reviewerMemberId: string;
+    reviewedAt?: string;
+    note?: string | null;
+}
+export interface RiskRegisterQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    status?: RiskRegisterStatus;
+    category?: RiskRegisterCategory;
+}
+export interface RiskRegisterServiceContract {
+    createRiskItem(input: CreateRiskRegisterInput): Promise<ResponseEnvelope<RiskRegisterContract>>;
+    updateRiskItem(riskId: string, input: UpdateRiskRegisterInput): Promise<ResponseEnvelope<RiskRegisterContract>>;
+    updateRiskItemStatus(riskId: string, input: UpdateRiskRegisterStatusInput): Promise<ResponseEnvelope<RiskRegisterContract>>;
+    recordRiskItemReview(riskId: string, input: RecordRiskRegisterReviewInput): Promise<ResponseEnvelope<RiskRegisterContract>>;
+    escalateRiskItem(riskId: string, input: EscalateRiskRegisterInput): Promise<ResponseEnvelope<RiskRegisterContract>>;
+    submitRiskMitigationApproval(riskId: string, input?: SubmitRiskMitigationApprovalInput): Promise<ResponseEnvelope<RiskRegisterContract>>;
+    reviewRiskMitigationApproval(riskId: string, input: ReviewRiskMitigationApprovalInput): Promise<ResponseEnvelope<RiskRegisterContract>>;
+    getRiskItemById(riskId: string): Promise<ResponseEnvelope<RiskRegisterContract | null>>;
+    listRiskItems(options?: RiskRegisterQueryOptions): Promise<ResponseEnvelope<RiskRegisterContract[]>>;
+}

package/dist/contracts/SavingComplianceSnapshotContract.d.ts

@@ -1,10 +1,9 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
 export type SavingComplianceStatus = 'compliant' | 'underpaid' | 'no-policy';
-export interface SavingComplianceSnapshotContract {
+export interface SavingComplianceSnapshotContract extends ScopeRef {
     id: string;
     memberId: string;
     koperasiId: string;
-    tenantId?: string | null;
-    branchId?: string | null;
     referenceDate: string;
     monthlyWajibNominalIdr: number;
     wajibCreditTotalIdr: number;
@@ -18,10 +17,8 @@ export interface SavingComplianceSnapshotContract {
     lastModified: string;
     deleted: boolean;
 }
-export interface SavingComplianceSnapshotScope {
+export interface SavingComplianceSnapshotScope extends ScopeRef {
     koperasiId: string;
-    tenantId: string;
-    branchId?: string | null;
 }
 export interface SavingComplianceSnapshotQueryOptions {
     memberId?: string;
@@ -29,6 +26,6 @@ export interface SavingComplianceSnapshotQueryOptions {
     includeDeleted?: boolean;
 }
 export interface SavingComplianceSnapshotServiceContract {
-    listComplianceSnapshots(scope: SavingComplianceSnapshotScope, options?: SavingComplianceSnapshotQueryOptions): Promise<SavingComplianceSnapshotContract[]>;
-    getComplianceSnapshotByMember(memberId: string, scope: SavingComplianceSnapshotScope): Promise<SavingComplianceSnapshotContract | null>;
+    listComplianceSnapshots(scope: SavingComplianceSnapshotScope, options?: SavingComplianceSnapshotQueryOptions): Promise<ResponseEnvelope<SavingComplianceSnapshotContract[]>>;
+    getComplianceSnapshotByMember(memberId: string, scope: SavingComplianceSnapshotScope): Promise<ResponseEnvelope<SavingComplianceSnapshotContract | null>>;
 }

package/dist/contracts/SavingLedgerContract.d.ts

@@ -1,6 +1,7 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
 export type SavingType = 'pokok' | 'wajib' | 'sukarela';
 export type SavingEntryType = 'credit' | 'debit';
-export interface SavingLedgerContract {
+export interface SavingLedgerContract extends ScopeRef {
     id: string;
     memberId: string;
     savingType: SavingType;
@@ -10,13 +11,11 @@ export interface SavingLedgerContract {
     referenceType?: string | null;
     referenceId?: string | null;
     notes?: string | null;
-    branchId?: string | null;
-    tenantId?: string | null;
     version: number;
     lastModified: string;
     deleted: boolean;
 }
-export interface SavingEntryInput {
+export interface SavingEntryInput extends ScopeRef {
     memberId: string;
     savingType: SavingType;
     amount: number;
@@ -24,8 +23,6 @@ export interface SavingEntryInput {
     referenceType?: string | null;
     referenceId?: string | null;
     notes?: string | null;
-    branchId?: string | null;
-    tenantId?: string | null;
 }
 export interface SavingBalance {
     pokok: number;
@@ -33,17 +30,15 @@ export interface SavingBalance {
     sukarela: number;
     total: number;
 }
-export interface SavingLedgerQueryOptions {
+export interface SavingLedgerQueryOptions extends Partial<ScopeRef> {
     includeDeleted?: boolean;
     dateFrom?: string;
     dateTo?: string;
-    tenantId?: string | null;
-    branchId?: string | null;
 }
 export interface SavingLedgerServiceContract {
-    recordSavingCredit(input: SavingEntryInput): Promise<SavingLedgerContract>;
-    recordSavingDebit(input: SavingEntryInput): Promise<SavingLedgerContract>;
-    recordSavingWithdrawal(input: SavingEntryInput): Promise<SavingLedgerContract>;
-    listSavingEntriesByMember(memberId: string, options?: SavingLedgerQueryOptions): Promise<SavingLedgerContract[]>;
-    getSavingBalanceByMember(memberId: string): Promise<SavingBalance>;
+    recordSavingCredit(input: SavingEntryInput): Promise<ResponseEnvelope<SavingLedgerContract>>;
+    recordSavingDebit(input: SavingEntryInput): Promise<ResponseEnvelope<SavingLedgerContract>>;
+    recordSavingWithdrawal(input: SavingEntryInput): Promise<ResponseEnvelope<SavingLedgerContract>>;
+    listSavingEntriesByMember(memberId: string, options?: SavingLedgerQueryOptions): Promise<ResponseEnvelope<SavingLedgerContract[]>>;
+    getSavingBalanceByMember(memberId: string): Promise<ResponseEnvelope<SavingBalance>>;
 }

package/dist/contracts/SavingPolicyContract.d.ts

@@ -1,9 +1,8 @@
+import type { ScopeRef, ResponseEnvelope, WorklistItem } from 'ofcore';
 export type FineType = 'fixed' | 'percentage';
-export interface SavingPolicyContract {
+export interface SavingPolicyContract extends ScopeRef {
     id: string;
     koperasiId: string;
-    branchId?: string | null;
-    tenantId?: string | null;
     simpananPokokNominalIdr: number;
     monthlyWajibNominalIdr: number;
     gracePeriodMonth: number;
@@ -16,19 +15,17 @@ export interface SavingPolicyContract {
     effectiveDate: string;
     changeReason?: string | null;
     approvalRef?: string | null;
+    /** Ditandai true jika policy ini sudah digantikan versi yang lebih baru. */
+    isSuperseded?: boolean | null;
     version: number;
     lastModified: string;
     deleted: boolean;
 }
-export interface SavingPolicyScope {
+export interface SavingPolicyScope extends ScopeRef {
     koperasiId: string;
-    tenantId: string;
-    branchId?: string | null;
 }
-export interface UpsertSavingPolicyInput {
+export interface UpsertSavingPolicyInput extends ScopeRef {
     koperasiId: string;
-    tenantId: string;
-    branchId?: string | null;
     simpananPokokNominalIdr: number;
     monthlyWajibNominalIdr: number;
     gracePeriodMonth: number;
@@ -46,18 +43,17 @@ export interface SavingComplianceEvaluation {
     summary: Record<string, number>;
     referenceDate: string;
 }
-export interface SavingComplianceWorklistItem {
-    id: string;
+/** Worklist item kepatuhan simpanan — extends WorklistItem dari ofcore. */
+export interface SavingComplianceWorklistItem extends WorklistItem {
+    /** ID anggota yang bersangkutan. */
     memberId: string;
-    priority: 'low' | 'medium' | 'high' | 'critical';
-    reasonCode: string;
-    reasonText: string;
-    recommendedAction: string;
-    metadata?: Record<string, unknown>;
 }
 export interface SavingPolicyServiceContract {
-    getActiveSavingPolicy(scope: SavingPolicyScope): Promise<SavingPolicyContract | null>;
-    upsertSavingPolicy(input: UpsertSavingPolicyInput): Promise<SavingPolicyContract>;
-    evaluateWajibCompliance(scope: SavingPolicyScope): Promise<SavingComplianceEvaluation>;
-    getComplianceWorklist(scope: SavingPolicyScope): Promise<SavingComplianceWorklistItem[]>;
+    getActiveSavingPolicy(scope: SavingPolicyScope): Promise<ResponseEnvelope<SavingPolicyContract | null>>;
+    /** Buat policy baru; tolak jika effectiveDate sama atau lebih awal dari policy aktif terbaru. */
+    upsertSavingPolicy(input: UpsertSavingPolicyInput): Promise<ResponseEnvelope<SavingPolicyContract>>;
+    /** Kembalikan seluruh riwayat policy (termasuk yang sudah superseded), urut terbaru dulu. */
+    getPolicyHistory(scope: SavingPolicyScope): Promise<ResponseEnvelope<SavingPolicyContract[]>>;
+    evaluateWajibCompliance(scope: SavingPolicyScope): Promise<ResponseEnvelope<SavingComplianceEvaluation>>;
+    getComplianceWorklist(scope: SavingPolicyScope): Promise<ResponseEnvelope<SavingComplianceWorklistItem[]>>;
 }

package/dist/contracts/ShuConfigContract.d.ts

@@ -1,39 +1,53 @@
-export interface ShuConfigContract {
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type ShuFormulaModel = 'ksp' | 'konsumen' | 'produsen' | 'pemasaran' | 'serba_usaha' | 'custom';
+/** Bobot distribusi SHU per komponen partisipasi (harus total = 100) */
+export interface ShuParticipationWeights {
+    /** Bobot dari kontribusi simpanan/modal anggota */
+    simpananWeight: number;
+    /** Bobot dari jasa usaha (pinjaman utk KSP; belanja utk konsumen; produksi utk produsen) */
+    jasaUsahaWeight: number;
+    /** Bobot dari transaksi pemasaran (untuk koperasi pemasaran/serba usaha) */
+    pemasaranWeight?: number;
+    /** Bobot dari kontribusi lain (khusus model custom) */
+    otherWeight?: number;
+}
+export interface ShuConfigContract extends ScopeRef {
     id: string;
     koperasiId: string;
-    tenantId?: string | null;
-    branchId?: string | null;
     effectiveDate: string;
     cadanganPercent: number;
     jasaUsahaPercent: number;
     jasaModalPercent: number;
     notes?: string | null;
     approvalRef?: string | null;
+    /** Model formula SHU; default 'ksp' jika tidak diisi */
+    formulaModel?: ShuFormulaModel | null;
+    /** Bobot distribusi komponen partisipasi anggota */
+    participationWeights?: ShuParticipationWeights | null;
     version: number;
     lastModified: string;
     deleted: boolean;
 }
-export interface ShuConfigScope {
+export interface ShuConfigScope extends ScopeRef {
     koperasiId: string;
-    tenantId: string;
-    branchId?: string | null;
 }
-export interface UpsertShuConfigInput {
+export interface UpsertShuConfigInput extends ScopeRef {
     koperasiId: string;
-    tenantId: string;
-    branchId?: string | null;
     effectiveDate: string;
     cadanganPercent: number;
     jasaUsahaPercent: number;
     jasaModalPercent: number;
     notes?: string | null;
     approvalRef?: string | null;
+    formulaModel?: ShuFormulaModel | null;
+    participationWeights?: ShuParticipationWeights | null;
 }
 export interface ShuConfigQueryOptions {
     includeDeleted?: boolean;
 }
 export interface ShuConfigServiceContract {
-    getActiveShuConfig(scope: ShuConfigScope): Promise<ShuConfigContract | null>;
-    upsertShuConfig(input: UpsertShuConfigInput): Promise<ShuConfigContract>;
-    listShuConfigs(scope: ShuConfigScope, options?: ShuConfigQueryOptions): Promise<ShuConfigContract[]>;
+    getActiveShuConfig(scope: ShuConfigScope): Promise<ResponseEnvelope<ShuConfigContract | null>>;
+    upsertShuConfig(input: UpsertShuConfigInput): Promise<ResponseEnvelope<ShuConfigContract>>;
+    listShuConfigs(scope: ShuConfigScope, options?: ShuConfigQueryOptions): Promise<ResponseEnvelope<ShuConfigContract[]>>;
+    getDefaultParticipationWeights(model: ShuFormulaModel): Promise<ResponseEnvelope<ShuParticipationWeights>>;
 }

package/dist/contracts/ShuContract.d.ts

@@ -1,45 +1,38 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
 export type ShuPeriodStatus = 'draft' | 'finalized';
-export interface ShuPeriodContract {
+export interface ShuPeriodContract extends ScopeRef {
     id: string;
     periodCode: string;
     startDate: string;
     endDate: string;
     status: ShuPeriodStatus;
     formulaSnapshot: Record<string, unknown>;
-    branchId?: string | null;
-    tenantId?: string | null;
     version: number;
     lastModified: string;
     deleted: boolean;
 }
-export interface ShuAllocationContract {
+export interface ShuAllocationContract extends ScopeRef {
     id: string;
     shuPeriodId: string;
     memberId: string;
     allocationAmount: number;
     calculationBasis: Record<string, unknown>;
-    branchId?: string | null;
-    tenantId?: string | null;
     version: number;
     lastModified: string;
     deleted: boolean;
 }
-export interface CreateShuPeriodInput {
+export interface CreateShuPeriodInput extends ScopeRef {
     periodCode: string;
     startDate: string;
     endDate: string;
     formulaSnapshot: Record<string, unknown>;
-    branchId?: string | null;
-    tenantId?: string | null;
 }
 export interface ShuAllocationQueryOptions {
     includeDeleted?: boolean;
     memberId?: string;
 }
-export interface ShuPeriodQueryOptions {
+export interface ShuPeriodQueryOptions extends Partial<ScopeRef> {
     includeDeleted?: boolean;
-    tenantId?: string | null;
-    branchId?: string | null;
     status?: ShuPeriodStatus;
     dateContains?: string;
 }
@@ -49,10 +42,10 @@ export interface CsvExportPayload {
     body: string;
 }
 export interface ShuServiceContract {
-    createShuPeriod(input: CreateShuPeriodInput): Promise<ShuPeriodContract>;
-    finalizeShuPeriod(periodId: string): Promise<ShuPeriodContract>;
-    listShuPeriods(options?: ShuPeriodQueryOptions): Promise<ShuPeriodContract[]>;
-    generateShuAllocations(periodId: string): Promise<ShuAllocationContract[]>;
-    listShuAllocations(periodId: string, options?: ShuAllocationQueryOptions): Promise<ShuAllocationContract[]>;
-    exportShuAllocationsCsv(periodId: string): Promise<CsvExportPayload>;
+    createShuPeriod(input: CreateShuPeriodInput): Promise<ResponseEnvelope<ShuPeriodContract>>;
+    finalizeShuPeriod(periodId: string): Promise<ResponseEnvelope<ShuPeriodContract>>;
+    listShuPeriods(options?: ShuPeriodQueryOptions): Promise<ResponseEnvelope<ShuPeriodContract[]>>;
+    generateShuAllocations(periodId: string): Promise<ResponseEnvelope<ShuAllocationContract[]>>;
+    listShuAllocations(periodId: string, options?: ShuAllocationQueryOptions): Promise<ResponseEnvelope<ShuAllocationContract[]>>;
+    exportShuAllocationsCsv(periodId: string): Promise<ResponseEnvelope<CsvExportPayload>>;
 }

package/dist/contracts/ShuParticipationEntryContract.d.ts

@@ -0,0 +1,54 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+/**
+ * Jenis partisipasi anggota untuk perhitungan JUA.
+ * - 'pinjaman'     : volume pinjaman aktif (KSP — proporsi bunga/pokok)
+ * - 'simpanan_aktif': saldo simpanan aktif (KSP — bagian modal aktif)
+ * - 'pembelian'    : nilai pembelian barang/jasa (konsumen)
+ * - 'production'     : nilai produksi/penyerahan hasil (produsen)
+ * - 'pemasaran'    : nilai pemasaran/penjualan kolektif (pemasaran)
+ * - 'jasa'         : nilai jasa yang digunakan/diberikan (jasa)
+ */
+export type ShuParticipationType = 'pinjaman' | 'simpanan_aktif' | 'pembelian' | 'produksi' | 'pemasaran' | 'jasa';
+export interface ShuParticipationEntryContract extends ScopeRef {
+    id: string;
+    shuPeriodId: string;
+    memberId: string;
+    participationType: ShuParticipationType;
+    /** Nilai/volume dalam satuan IDR atau unit usaha yang disepakati */
+    amount: number;
+    /** Keterangan tambahan (referensi transaksi, dll.) */
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface RecordShuParticipationInput extends ScopeRef {
+    shuPeriodId: string;
+    memberId: string;
+    participationType: ShuParticipationType;
+    amount: number;
+    notes?: string | null;
+}
+export interface BulkRecordShuParticipationInput {
+    entries: RecordShuParticipationInput[];
+}
+export interface ShuParticipationQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    memberId?: string;
+    participationType?: ShuParticipationType;
+}
+export interface MemberParticipationSummary {
+    memberId: string;
+    totalByType: Partial<Record<ShuParticipationType, number>>;
+    grandTotal: number;
+}
+export interface ShuParticipationServiceContract {
+    /** Catat satu entri partisipasi anggota untuk periode SHU tertentu */
+    recordParticipation(input: RecordShuParticipationInput): Promise<ResponseEnvelope<ShuParticipationEntryContract>>;
+    /** Bulk record untuk efisiensi saat import dari sistem lain */
+    bulkRecordParticipation(input: BulkRecordShuParticipationInput): Promise<ResponseEnvelope<ShuParticipationEntryContract[]>>;
+    /** List semua entri partisipasi untuk sebuah periode */
+    listParticipationByPeriod(shuPeriodId: string, options?: ShuParticipationQueryOptions): Promise<ResponseEnvelope<ShuParticipationEntryContract[]>>;
+    /** Ringkasan total partisipasi per anggota untuk sebuah periode */
+    summarizeParticipationByPeriod(shuPeriodId: string, options?: ShuParticipationQueryOptions): Promise<ResponseEnvelope<MemberParticipationSummary[]>>;
+}

package/dist/contracts/WhistleReportContract.d.ts

@@ -0,0 +1,72 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type WhistleReportChannel = 'web' | 'email' | 'hotline' | 'other';
+export type WhistleReportStatus = 'submitted' | 'in_review' | 'resolved' | 'dismissed';
+export type WhistleInvestigationStage = 'intake' | 'preliminary' | 'formal' | 'recommendation';
+export interface WhistleReportContract extends ScopeRef {
+    id: string;
+    incidentDate?: string | null;
+    subject: string;
+    description: string;
+    channel: WhistleReportChannel;
+    isAnonymous: boolean;
+    reporterMemberId?: string | null;
+    evidenceRefs?: string[] | null;
+    slaDueAt?: string | null;
+    escalationLevel: number;
+    escalatedAt?: string | null;
+    escalationReason?: string | null;
+    investigationStage?: WhistleInvestigationStage;
+    investigationUpdatedAt?: string | null;
+    investigationNote?: string | null;
+    status: WhistleReportStatus;
+    assignedToMemberId?: string | null;
+    handledByMemberId?: string | null;
+    resolutionSummary?: string | null;
+    resolvedAt?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CreateWhistleReportInput extends ScopeRef {
+    incidentDate?: string | null;
+    subject: string;
+    description: string;
+    channel: WhistleReportChannel;
+    isAnonymous?: boolean;
+    reporterMemberId?: string | null;
+    evidenceRefs?: string[] | null;
+    slaDueAt?: string | null;
+}
+export interface UpdateWhistleReportStatusInput {
+    status: WhistleReportStatus;
+    assignedToMemberId?: string | null;
+    handledByMemberId?: string | null;
+    resolutionSummary?: string | null;
+    resolvedAt?: string | null;
+}
+export interface EscalateWhistleReportInput {
+    reason: string;
+    escalatedAt?: string;
+}
+export interface AddWhistleEvidenceInput {
+    evidenceRef: string;
+}
+export interface AdvanceWhistleInvestigationStageInput {
+    stage: WhistleInvestigationStage;
+    updatedAt?: string;
+    note?: string | null;
+}
+export interface WhistleReportQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    status?: WhistleReportStatus;
+    channel?: WhistleReportChannel;
+}
+export interface WhistleReportServiceContract {
+    createWhistleReport(input: CreateWhistleReportInput): Promise<ResponseEnvelope<WhistleReportContract>>;
+    updateWhistleReportStatus(reportId: string, input: UpdateWhistleReportStatusInput): Promise<ResponseEnvelope<WhistleReportContract>>;
+    escalateWhistleReport(reportId: string, input: EscalateWhistleReportInput): Promise<ResponseEnvelope<WhistleReportContract>>;
+    addWhistleEvidence(reportId: string, input: AddWhistleEvidenceInput): Promise<ResponseEnvelope<WhistleReportContract>>;
+    advanceWhistleInvestigationStage(reportId: string, input: AdvanceWhistleInvestigationStageInput): Promise<ResponseEnvelope<WhistleReportContract>>;
+    getWhistleReportById(reportId: string): Promise<ResponseEnvelope<WhistleReportContract | null>>;
+    listWhistleReports(options?: WhistleReportQueryOptions): Promise<ResponseEnvelope<WhistleReportContract[]>>;
+}