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

package/dist/contracts/CoopCapabilityProfileContract.d.ts

@@ -0,0 +1,44 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export interface CoopCapabilityProfileFlags {
+    supportsCredit: boolean;
+    supportsConsumerOps: boolean;
+    supportsMultiunit: boolean;
+    supportsMemberSelfService: boolean;
+    supportsGovernanceDigital: boolean;
+}
+export interface CoopCapabilityProfileContract extends ScopeRef, CoopCapabilityProfileFlags {
+    id: string;
+    tenantId: string;
+    branchId?: string;
+    profileName: string;
+    isActive: boolean;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface UpsertCoopCapabilityProfileInput extends ScopeRef, CoopCapabilityProfileFlags {
+    tenantId: string;
+    branchId?: string;
+    profileName: string;
+    notes?: string | null;
+}
+export interface CoopCapabilityProfileQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    isActive?: boolean;
+}
+export interface GetEffectiveCoopCapabilityProfileInput extends ScopeRef {
+}
+export interface EffectiveCoopCapabilityProfileResult extends CoopCapabilityProfileFlags {
+    source: 'branch' | 'tenant' | 'default';
+    profileId?: string | null;
+    profileName: string;
+    tenantId: string;
+    branchId?: string | null;
+}
+export interface CoopCapabilityProfileServiceContract {
+    upsertCapabilityProfile(input: UpsertCoopCapabilityProfileInput): Promise<ResponseEnvelope<CoopCapabilityProfileContract>>;
+    getCapabilityProfileById(profileId: string): Promise<ResponseEnvelope<CoopCapabilityProfileContract | null>>;
+    listCapabilityProfiles(options?: CoopCapabilityProfileQueryOptions): Promise<ResponseEnvelope<CoopCapabilityProfileContract[]>>;
+    getEffectiveCapabilityProfile(input: GetEffectiveCoopCapabilityProfileInput): Promise<ResponseEnvelope<EffectiveCoopCapabilityProfileResult>>;
+}

package/dist/contracts/MemberPosCustomerLinkContract.d.ts

@@ -0,0 +1,27 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export interface MemberPosCustomerLinkContract extends ScopeRef {
+    id: string;
+    sourceDomain: 'ofpos';
+    customerId: string;
+    memberId: string;
+    linkedAt: string;
+    linkedBy?: string | null;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface UpsertMemberPosCustomerLinkInput extends ScopeRef {
+    customerId: string;
+    memberId: string;
+    linkedBy?: string | null;
+    notes?: string | null;
+}
+export interface ResolveMemberPosCustomerLinkInput extends ScopeRef {
+    customerId: string;
+}
+export interface MemberPosCustomerLinkServiceContract {
+    upsertPosCustomerLink(input: UpsertMemberPosCustomerLinkInput): Promise<ResponseEnvelope<MemberPosCustomerLinkContract>>;
+    getPosCustomerLinkByCustomerId(input: ResolveMemberPosCustomerLinkInput): Promise<ResponseEnvelope<MemberPosCustomerLinkContract | null>>;
+    resolveMemberIdByPosCustomerId(input: ResolveMemberPosCustomerLinkInput): Promise<ResponseEnvelope<string | null>>;
+}

package/dist/contracts/ParticipationAssuranceContract.d.ts

@@ -0,0 +1,47 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+import type { ShuParticipationAssuranceLevel, ShuParticipationSourceType } from './ShuParticipationEntryContract.js';
+export type ParticipationAssuranceCheckStatus = 'pass' | 'warn' | 'fail';
+export type ParticipationAssuranceReadiness = 'strong' | 'mixed' | 'weak';
+export interface ParticipationAssuranceScope extends ScopeRef {
+    shuPeriodId: string;
+}
+export interface ParticipationAssuranceBreakdownItem {
+    sourceType: ShuParticipationSourceType;
+    assuranceLevel: ShuParticipationAssuranceLevel;
+    entryCount: number;
+    amountTotal: number;
+    withEvidenceCount: number;
+    evidenceCoveragePercent: number;
+}
+export interface ParticipationAssuranceCheck {
+    id: string;
+    label: string;
+    status: ParticipationAssuranceCheckStatus;
+    detail: string;
+    meta?: Record<string, unknown>;
+}
+export interface ParticipationAssuranceSummary {
+    score: number;
+    readiness: ParticipationAssuranceReadiness;
+    totalEntries: number;
+    totalAmount: number;
+    evidenceCoveragePercent: number;
+    dominantSourceType: ShuParticipationSourceType | null;
+    approvedFormalAmountPercent: number;
+    pendingApprovalEntryCount: number;
+    lowAssuranceEntryCount: number;
+    lowAssuranceAmount: number;
+    formalAmountPercent: number;
+}
+export interface ParticipationAssuranceSnapshot {
+    generatedAt: string;
+    scope: ParticipationAssuranceScope;
+    summary: ParticipationAssuranceSummary;
+    breakdown: ParticipationAssuranceBreakdownItem[];
+    checks: ParticipationAssuranceCheck[];
+}
+export interface GetParticipationAssuranceInput extends ParticipationAssuranceScope {
+}
+export interface ParticipationAssuranceServiceContract {
+    getParticipationAssuranceSnapshot(input: GetParticipationAssuranceInput): Promise<ResponseEnvelope<ParticipationAssuranceSnapshot>>;
+}

package/dist/contracts/ShuParticipationEntryContract.d.ts

@@ -1,4 +1,5 @@
 import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+import type { FinanceJournalEntry } from 'offinance-shared-core';
 /**
  * Jenis partisipasi anggota untuk perhitungan JUA.
  * - 'pinjaman'     : volume pinjaman aktif (KSP — proporsi bunga/pokok)
@@ -9,11 +10,34 @@ import type { ScopeRef, ResponseEnvelope } from 'ofcore';
  * - 'jasa'         : nilai jasa yang digunakan/diberikan (jasa)
  */
 export type ShuParticipationType = 'pinjaman' | 'simpanan_aktif' | 'pembelian' | 'produksi' | 'pemasaran' | 'jasa';
+export type ShuParticipationSourceType = 'bridge' | 'manual_via_offinance' | 'manual_direct' | 'import';
+export type ShuParticipationAssuranceLevel = 'high' | 'medium' | 'low';
+export type ShuParticipationApprovalStatus = 'not_required' | 'pending_approval' | 'approved' | 'rejected';
 export interface ShuParticipationEntryContract extends ScopeRef {
     id: string;
     shuPeriodId: string;
     memberId: string;
     participationType: ShuParticipationType;
+    sourceType: ShuParticipationSourceType;
+    assuranceLevel: ShuParticipationAssuranceLevel;
+    approvalStatus: ShuParticipationApprovalStatus;
+    /** Unit usaha/kelompok usaha asal partisipasi bila relevan. */
+    unitBusinessId?: string | null;
+    /** Referensi canonical ke dokumen/artefak bukti minimum. */
+    evidenceRef?: string | null;
+    /** Tipe referensi sumber formal, mis. offinance_manual_recap atau pos_sale_summary. */
+    sourceReferenceType?: string | null;
+    /** Id referensi sumber formal dari domain/rekap asal. */
+    sourceReferenceId?: string | null;
+    /** Aktor/operator yang mencatat entry ini bila tersedia. */
+    recordedBy?: string | null;
+    /** Waktu pencatatan canonical entry. */
+    recordedAt: string;
+    approvedAt?: string | null;
+    approvedBy?: string | null;
+    approvalRef?: string | null;
+    rejectedAt?: string | null;
+    rejectionReason?: string | null;
     /** Nilai/volume dalam satuan IDR atau unit usaha yang disepakati */
     amount: number;
     /** Keterangan tambahan (referensi transaksi, dll.) */
@@ -26,16 +50,72 @@ export interface RecordShuParticipationInput extends ScopeRef {
     shuPeriodId: string;
     memberId: string;
     participationType: ShuParticipationType;
+    sourceType: ShuParticipationSourceType;
+    unitBusinessId?: string | null;
+    evidenceRef?: string | null;
+    sourceReferenceType?: string | null;
+    sourceReferenceId?: string | null;
+    recordedBy?: string | null;
     amount: number;
     notes?: string | null;
 }
 export interface BulkRecordShuParticipationInput {
     entries: RecordShuParticipationInput[];
 }
+export interface RecordShuParticipationFromOffinanceJournalInput extends ScopeRef {
+    shuPeriodId: string;
+    memberId: string;
+    participationType: ShuParticipationType;
+    amount: number;
+    unitBusinessId?: string | null;
+    recordedBy?: string | null;
+    notes?: string | null;
+    journal: Pick<FinanceJournalEntry, 'id' | 'tenantId' | 'branchId' | 'status' | 'reference' | 'evidenceRef' | 'occurredAt' | 'postedAt'>;
+}
+export interface PosSaleParticipationSummary {
+    saleId: string;
+    saleDate: string;
+    customerId?: string | null;
+    total: number;
+    finalTotal: number;
+    transactionCurrencyCode?: string | null;
+    totalInBaseCurrency?: number | null;
+    finalTotalInBaseCurrency?: number | null;
+    note?: string | null;
+}
+export interface RecordShuParticipationFromPosSaleSummaryInput extends ScopeRef {
+    shuPeriodId: string;
+    memberId: string;
+    amount?: number | null;
+    unitBusinessId?: string | null;
+    recordedBy?: string | null;
+    notes?: string | null;
+    saleSummary: PosSaleParticipationSummary;
+}
+export interface RecordShuParticipationFromPosSaleSummaryByCustomerLinkInput extends ScopeRef {
+    shuPeriodId: string;
+    amount?: number | null;
+    unitBusinessId?: string | null;
+    recordedBy?: string | null;
+    notes?: string | null;
+    saleSummary: PosSaleParticipationSummary & {
+        customerId: string;
+    };
+}
+export interface ApproveShuParticipationInput {
+    approvedBy: string;
+    approvedAt?: string;
+    approvalRef?: string | null;
+}
+export interface RejectShuParticipationInput {
+    rejectionReason: string;
+    rejectedAt?: string;
+}
 export interface ShuParticipationQueryOptions extends Partial<ScopeRef> {
     includeDeleted?: boolean;
     memberId?: string;
     participationType?: ShuParticipationType;
+    approvalStatus?: ShuParticipationApprovalStatus;
 }
 export interface MemberParticipationSummary {
     memberId: string;
@@ -45,6 +125,16 @@ export interface MemberParticipationSummary {
 export interface ShuParticipationServiceContract {
     /** Catat satu entri partisipasi anggota untuk periode SHU tertentu */
     recordParticipation(input: RecordShuParticipationInput): Promise<ResponseEnvelope<ShuParticipationEntryContract>>;
+    /** Catat partisipasi anggota dari jurnal finance posted yang sah dari offinance. */
+    recordParticipationFromOffinanceJournal(input: RecordShuParticipationFromOffinanceJournalInput): Promise<ResponseEnvelope<ShuParticipationEntryContract>>;
+    /** Catat partisipasi anggota dari ringkasan sale POS dengan member yang sudah ditentukan secara eksplisit. */
+    recordParticipationFromPosSaleSummary(input: RecordShuParticipationFromPosSaleSummaryInput): Promise<ResponseEnvelope<ShuParticipationEntryContract>>;
+    /** Catat partisipasi dari sale POS dengan member yang di-resolve dari linkage customer POS -> member coop. */
+    recordParticipationFromPosSaleSummaryByCustomerLink(input: RecordShuParticipationFromPosSaleSummaryByCustomerLinkInput): Promise<ResponseEnvelope<ShuParticipationEntryContract>>;
+    /** Approval formal minimum untuk entry yang memang melalui jalur pending formal. */
+    approveParticipationEntry(entryId: string, input: ApproveShuParticipationInput): Promise<ResponseEnvelope<ShuParticipationEntryContract>>;
+    rejectParticipationEntry(entryId: string, input: RejectShuParticipationInput): Promise<ResponseEnvelope<ShuParticipationEntryContract>>;
+    getParticipationEntryById(entryId: string): Promise<ResponseEnvelope<ShuParticipationEntryContract | null>>;
     /** Bulk record untuk efisiensi saat import dari sistem lain */
     bulkRecordParticipation(input: BulkRecordShuParticipationInput): Promise<ResponseEnvelope<ShuParticipationEntryContract[]>>;
     /** List semua entri partisipasi untuk sebuah periode */

package/dist/data/repositories.d.ts

@@ -13,8 +13,10 @@ import type { ShuConfigContract, ShuConfigQueryOptions, ShuConfigScope } from '.
 import type { GovernanceAgendaItemContract, GovernanceDecisionArchive, GovernanceMeetingContract, GovernanceMeetingQueryOptions, GovernanceVoteContract } from '../contracts/GovernanceContract.js';
 import type { LeadershipAppointmentContract, LeadershipAppointmentQueryOptions } from '../contracts/LeadershipAppointmentContract.js';
 import type { ShuParticipationEntryContract, ShuParticipationQueryOptions } from '../contracts/ShuParticipationEntryContract.js';
+import type { CoopCapabilityProfileContract, CoopCapabilityProfileQueryOptions } from '../contracts/CoopCapabilityProfileContract.js';
 import type { CoopCommunityProfileContract, CommunityProfileQueryOptions } from '../contracts/CoopCommunityProfileContract.js';
 import type { MemberDependentContract, MemberDependentQueryOptions } from '../contracts/MemberDependentContract.js';
+import type { MemberPosCustomerLinkContract } from '../contracts/MemberPosCustomerLinkContract.js';
 interface MemberExitStateRow {
     id: string;
     stage: 'requested' | 'settled' | 'canceled';
@@ -58,6 +60,17 @@ export declare class MemberWaConsentRepository {
     set(memberId: string, consent: MemberWaConsentInput): Promise<MemberWaConsentRow>;
     get(memberId: string): Promise<MemberWaConsentRow | null>;
 }
+export declare class MemberPosCustomerLinkRepository {
+    private readonly db;
+    constructor(db: DbAdapter);
+    create(row: MemberPosCustomerLinkContract): Promise<MemberPosCustomerLinkContract>;
+    update(id: string, row: MemberPosCustomerLinkContract): Promise<MemberPosCustomerLinkContract>;
+    findByCustomerId(input: {
+        customerId: string;
+        tenantId?: string | null;
+        branchId?: string | null;
+    }): Promise<MemberPosCustomerLinkContract | null>;
+}
 export declare class MemberExitStateRepository {
     private readonly db;
     constructor(db: DbAdapter);
@@ -213,6 +226,8 @@ export declare class ShuParticipationEntryRepository {
     constructor(db: DbAdapter);
     create(row: ShuParticipationEntryContract): Promise<ShuParticipationEntryContract>;
     createMany(rows: ShuParticipationEntryContract[]): Promise<ShuParticipationEntryContract[]>;
+    getById(id: string): Promise<ShuParticipationEntryContract | null>;
+    update(id: string, updates: Partial<ShuParticipationEntryContract>): Promise<ShuParticipationEntryContract>;
     listByPeriod(shuPeriodId: string, options?: ShuParticipationQueryOptions): Promise<ShuParticipationEntryContract[]>;
 }
 export declare class CommunityProfileRepository {
@@ -223,6 +238,14 @@ export declare class CommunityProfileRepository {
     getById(id: string): Promise<CoopCommunityProfileContract | null>;
     list(options?: CommunityProfileQueryOptions): Promise<CoopCommunityProfileContract[]>;
 }
+export declare class CapabilityProfileRepository {
+    private readonly db;
+    constructor(db: DbAdapter);
+    create(row: CoopCapabilityProfileContract): Promise<CoopCapabilityProfileContract>;
+    update(id: string, updates: Partial<CoopCapabilityProfileContract>): Promise<CoopCapabilityProfileContract>;
+    getById(id: string): Promise<CoopCapabilityProfileContract | null>;
+    list(options?: CoopCapabilityProfileQueryOptions): Promise<CoopCapabilityProfileContract[]>;
+}
 export declare class MemberDependentRepository {
     private readonly db;
     constructor(db: DbAdapter);
@@ -234,6 +257,7 @@ export declare class MemberDependentRepository {
 export interface OfcoopRepositories {
     memberRepository: MemberRepository;
     memberWaConsentRepository: MemberWaConsentRepository;
+    memberPosCustomerLinkRepository: MemberPosCustomerLinkRepository;
     memberExitStateRepository: MemberExitStateRepository;
     memberNumberPolicyRepository: MemberNumberPolicyRepository;
     governanceMeetingRepository: GovernanceMeetingRepository;
@@ -252,6 +276,7 @@ export interface OfcoopRepositories {
     shuAllocationRepository: ShuAllocationRepository;
     leadershipAppointmentRepository: LeadershipAppointmentRepository;
     shuParticipationEntryRepository: ShuParticipationEntryRepository;
+    capabilityProfileRepository: CapabilityProfileRepository;
     communityProfileRepository: CommunityProfileRepository;
     memberDependentRepository: MemberDependentRepository;
 }

package/dist/data/schemas.d.ts

@@ -21,8 +21,10 @@ export declare const OFCOOP_TABLES: {
     readonly governanceDecisionArchives: "ofcoop_governance_decision_archives";
     readonly leadershipAppointments: "ofcoop_leadership_appointments";
     readonly shuParticipationEntries: "ofcoop_shu_participation_entries";
+    readonly capabilityProfiles: "ofcoop_capability_profiles";
     readonly communityProfiles: "ofcoop_community_profiles";
     readonly memberDependents: "ofcoop_member_dependents";
+    readonly memberPosCustomerLinks: "ofcoop_member_pos_customer_links";
     readonly users: "ofcoop_users";
     readonly roles: "ofcoop_roles";
 };

package/dist/finance/offinanceProjection.d.ts

@@ -1,4 +1,6 @@
 import type { SavingLedgerContract } from '../contracts/SavingLedgerContract.js';
+import { type FinanceAccount, type FinanceDbAdapterLike, type FinanceProjectionServicesRef, type FinanceSyncEnqueuer, type JournalDraftInput } from 'offinance-shared-core';
+import type { ServiceRuntimeOptions } from '../services/impl/runtimeSupport.js';
 export interface ScopedAccountMapping<TMapping> {
     default: TMapping;
     byTenant?: Record<string, Partial<TMapping>>;
@@ -30,4 +32,21 @@ export interface ProjectCoopSavingFinanceInput {
     journalId?: string;
     referencePrefix?: string;
 }
+export interface BuildCoopSavingJournalDraftOptions {
+    ledgerProfileId: string;
+    financeDomainId?: string;
+}
+export interface CreateCoopSavingFinanceRuntimeOptions {
+    dbAdapter: FinanceDbAdapterLike;
+    resolveFinanceServices: () => FinanceProjectionServicesRef | null;
+    resolveLedgerProfileId: () => string;
+    resolveSyncEnqueuer?: () => FinanceSyncEnqueuer | null;
+    requiredAccounts: FinanceAccount[];
+    savingAccountMapping: ScopedAccountMapping<CoopSavingAccountMapping>;
+    financeDomainId?: string;
+    missingServicesErrorCode?: string;
+    missingLedgerProfileErrorCode?: string;
+}
 export declare function projectSavingLedgerToScopedFinance(input: ProjectCoopSavingFinanceInput): CoopSavingFinanceProjection;
+export declare function buildJournalDraftFromCoopSavingFinanceProjection(projection: CoopSavingFinanceProjection, options: BuildCoopSavingJournalDraftOptions): JournalDraftInput;
+export declare function createCoopSavingFinanceRuntimeOptions(options: CreateCoopSavingFinanceRuntimeOptions): Partial<ServiceRuntimeOptions>;

package/dist/index.d.ts

@@ -1,11 +1,14 @@
 export * from './contracts/ShuParticipationEntryContract.js';
+export * from './contracts/CoopCapabilityProfileContract.js';
 export * from './contracts/CoopCommunityProfileContract.js';
 export * from './contracts/MemberDependentContract.js';
+export * from './contracts/MemberPosCustomerLinkContract.js';
 export * from './contracts/MemberContract.js';
 export * from './contracts/SavingLedgerContract.js';
 export * from './contracts/ShuContract.js';
 export * from './contracts/MemberNumberPolicyContract.js';
 export * from './contracts/ComplianceReadinessContract.js';
+export * from './contracts/ParticipationAssuranceContract.js';
 export * from './contracts/SavingPolicyContract.js';
 export * from './contracts/SavingComplianceSnapshotContract.js';
 export * from './contracts/ShuConfigContract.js';
@@ -22,6 +25,7 @@ export * from './services/SavingLedgerService.js';
 export * from './services/ShuService.js';
 export * from './services/MemberNumberPolicyService.js';
 export * from './services/ComplianceReadinessService.js';
+export * from './services/ParticipationAssuranceService.js';
 export * from './services/SavingPolicyService.js';
 export * from './services/SavingComplianceSnapshotService.js';
 export * from './services/ShuConfigService.js';
@@ -54,8 +58,10 @@ export * from './services/createOfcoopDomainAuditCompositionProviders.js';
 export * from './services/createOfauthCompositionProviders.js';
 export * from './services/errors.js';
 export * from './services/ShuParticipationEntryService.js';
+export * from './services/CoopCapabilityProfileService.js';
 export * from './services/CoopCommunityProfileService.js';
 export * from './services/MemberDependentService.js';
+export * from './services/MemberPosCustomerLinkService.js';
 export * from './services/createDbAdapterOfcoopServices.js';
 export * from './finance/offinanceProjection.js';
 export * from './data/schemas.js';