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

package/dist/OfcoopCore.d.ts

@@ -7,8 +7,8 @@ import type { PlatformAdapter } from 'ofcore';
 import type { SocketAdapter } from 'ofcore';
 import type { ActivitySink } from 'ofcore';
 import type { ReadonlyStore, Store } from 'ofcore';
-import type { OfcoopDomainEvent } from './services/createDbAdapterOfcoopServices';
-import type { OfcoopDomainServices } from './services/createDbAdapterOfcoopServices';
+import type { OfcoopDomainEvent, OfcoopDomainServices, ServiceRuntimeOptions } from './services/createDbAdapterOfcoopServices.js';
+import { IUserService } from './services/userService.js';
 export type OfcoopDomainServicesOverride = Partial<OfcoopDomainServices>;
 export type OfcoopDomainServicesFactory = () => Promise<OfcoopDomainServices> | OfcoopDomainServices;
 export type OfcoopRuntimeHooks = Pick<CoreRuntimeHooks<OfcoopDomainServices, never>, 'runMigrations' | 'runSeed' | 'onInit' | 'onStop'>;
@@ -24,6 +24,7 @@ export declare class OfcoopCore {
     private readonly runtime;
     private readonly runtimeStateStore;
     domainServices?: OfcoopDomainServices;
+    userService?: IUserService;
     readonly runtimeStore: ReadonlyStore<OfcoopRuntimeState>;
     constructor(runtime: CoreRuntime<OfcoopDomainServices, never>, runtimeStateStore: Store<OfcoopRuntimeState>);
     static builder(): OfcoopCoreBuilder;
@@ -42,6 +43,8 @@ export declare class OfcoopCoreBuilder {
     private domainServiceOverrides;
     private runtimeHooks;
     private domainEventSink?;
+    private extraServiceOptions;
+    private coreInstance?;
     constructor();
     withPlatformAdapter(factory: (core: CoreRuntime<any, any>) => PlatformAdapter): this;
     withDbAdapter(factory: (core: CoreRuntime<any, any>) => DbAdapter): this;
@@ -54,7 +57,11 @@ export declare class OfcoopCoreBuilder {
     overrideDomainServices(overrides: OfcoopDomainServicesOverride): this;
     withRuntimeHooks(hooks: Partial<OfcoopRuntimeHooks>): this;
     withMigrationRunner(runner: NonNullable<OfcoopRuntimeHooks['runMigrations']>): this;
-    withSeedRunner(runner: NonNullable<OfcoopRuntimeHooks['runSeed']>): this;
     withDomainEventSink(sink: (event: OfcoopDomainEvent) => Promise<void> | void): this;
+    /**
+     * Injeksikan opsi tambahan untuk ServiceRuntimeOptions, misalnya `hasActiveLoan`
+     * untuk guard cross-domain di settleMemberExit.
+     */
+    withServiceRuntimeOptions(options: Partial<ServiceRuntimeOptions>): this;
     build(): OfcoopCore;
 }

package/dist/contracts/ComplianceReadinessContract.d.ts

@@ -0,0 +1,31 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type ComplianceReadinessRegulator = 'dinas_koperasi' | 'ojk';
+export type ComplianceReadinessCheckStatus = 'pass' | 'warn' | 'fail';
+export type ComplianceReadinessStatus = 'ready' | 'partial' | 'not_ready';
+export interface ComplianceReadinessScope extends ScopeRef {
+    periodCode?: string | null;
+}
+export interface ComplianceReadinessCheck {
+    id: string;
+    label: string;
+    status: ComplianceReadinessCheckStatus;
+    detail: string;
+    meta?: Record<string, unknown>;
+}
+export interface ComplianceReadinessSummary {
+    score: number;
+    status: ComplianceReadinessStatus;
+    regulator: ComplianceReadinessRegulator;
+}
+export interface ComplianceReadinessSnapshot {
+    generatedAt: string;
+    scope: ComplianceReadinessScope;
+    summary: ComplianceReadinessSummary;
+    checks: ComplianceReadinessCheck[];
+}
+export interface GetComplianceReadinessInput extends ComplianceReadinessScope {
+    regulator: ComplianceReadinessRegulator;
+}
+export interface ComplianceReadinessServiceContract {
+    getComplianceReadinessSnapshot(input: GetComplianceReadinessInput): Promise<ResponseEnvelope<ComplianceReadinessSnapshot>>;
+}

package/dist/contracts/CoopCommunityProfileContract.d.ts

@@ -0,0 +1,87 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type CommunityProfileType = 'kud' | 'kpri' | 'kopkar' | 'kopontren' | 'kospin' | 'koperasi_merah_putih' | 'custom';
+export interface SavingRequirementPolicy {
+    /** Simpanan pokok minimal (IDR) */
+    minSimpananPokok: number;
+    /** Simpanan wajib per periode */
+    minSimpananWajib: number;
+    /** Frekuensi bayar simpanan wajib: 'monthly' | 'quarterly' | 'annual' */
+    savingFrequency: 'monthly' | 'quarterly' | 'annual';
+}
+export interface ShuRulePolicy {
+    /** % dana cadangan minimal per AD/ART */
+    minCadanganPercent: number;
+    /** % jasa modal (JMA) dari shuDibagikan */
+    jasaModalPercent: number;
+    /** % jasa usaha (JUA) dari shuDibagikan */
+    jasaUsahaPercent: number;
+}
+export interface MembershipRequirementPolicy {
+    /** Usia minimum anggota */
+    minAgeYears?: number | null;
+    /** Apakah keanggotaan terikat domisili/wilayah */
+    residencyRequired: boolean;
+    /** Apakah keanggotaan terikat status kepegawaian */
+    employmentLinked: boolean;
+    /** Kriteria komunitas lain (teks bebas) */
+    communityCriteria?: string | null;
+}
+export interface GovernanceRulePolicy {
+    /** Lama masa jabatan pengurus (tahun) */
+    boardTermYears: number;
+    /** Frekuensi RAT: 'annual' | 'biennial' */
+    ratFrequency: 'annual' | 'biennial';
+    /** Apakah wajib audit eksternal */
+    externalAuditRequired: boolean;
+}
+export interface CoopCommunityProfileContract extends ScopeRef {
+    id: string;
+    profileType: CommunityProfileType;
+    displayName: string;
+    description?: string | null;
+    savingRequirements?: SavingRequirementPolicy | null;
+    shuRules?: ShuRulePolicy | null;
+    membershipRequirements?: MembershipRequirementPolicy | null;
+    governanceRules?: GovernanceRulePolicy | null;
+    /** Field kustom tambahan per jenis komunitas */
+    customFields?: Record<string, unknown> | null;
+    isActive: boolean;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CreateCommunityProfileInput extends ScopeRef {
+    profileType: CommunityProfileType;
+    displayName: string;
+    description?: string | null;
+    savingRequirements?: SavingRequirementPolicy | null;
+    shuRules?: ShuRulePolicy | null;
+    membershipRequirements?: MembershipRequirementPolicy | null;
+    governanceRules?: GovernanceRulePolicy | null;
+    customFields?: Record<string, unknown> | null;
+    notes?: string | null;
+}
+export interface UpdateCommunityProfileInput {
+    displayName?: string;
+    description?: string | null;
+    savingRequirements?: SavingRequirementPolicy | null;
+    shuRules?: ShuRulePolicy | null;
+    membershipRequirements?: MembershipRequirementPolicy | null;
+    governanceRules?: GovernanceRulePolicy | null;
+    customFields?: Record<string, unknown> | null;
+    isActive?: boolean;
+    notes?: string | null;
+}
+export interface CommunityProfileQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    profileType?: CommunityProfileType;
+    isActive?: boolean;
+}
+export interface CoopCommunityProfileServiceContract {
+    createCommunityProfile(input: CreateCommunityProfileInput): Promise<ResponseEnvelope<CoopCommunityProfileContract>>;
+    updateCommunityProfile(profileId: string, input: UpdateCommunityProfileInput): Promise<ResponseEnvelope<CoopCommunityProfileContract>>;
+    getCommunityProfileById(profileId: string): Promise<ResponseEnvelope<CoopCommunityProfileContract | null>>;
+    getActiveCommunityProfile(tenantId: string, branchId?: string | null): Promise<ResponseEnvelope<CoopCommunityProfileContract | null>>;
+    listCommunityProfiles(options?: CommunityProfileQueryOptions): Promise<ResponseEnvelope<CoopCommunityProfileContract[]>>;
+}

package/dist/contracts/GovernanceContract.d.ts

@@ -0,0 +1,157 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type GovernanceMeetingStatus = 'draft' | 'voting' | 'closed';
+export type GovernanceAgendaStatus = 'open' | 'approved' | 'rejected' | 'deferred';
+export type GovernanceVoteChoice = 'yes' | 'no' | 'abstain';
+export interface GovernanceMeetingContract extends ScopeRef {
+    id: string;
+    title: string;
+    meetingDate: string;
+    status: GovernanceMeetingStatus;
+    quorumPercent: number;
+    eligibleMemberIds?: string[] | null;
+    notes?: string | null;
+    minutes?: string | null;
+    decisionSummary?: string | null;
+    minutesArtifactRef?: string | null;
+    attendanceArtifactRef?: string | null;
+    ratDecisionBundleRef?: string | null;
+    chairpersonMemberId?: string | null;
+    secretaryMemberId?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface GovernanceAgendaItemContract extends ScopeRef {
+    id: string;
+    meetingId: string;
+    title: string;
+    description?: string | null;
+    orderNo: number;
+    status: GovernanceAgendaStatus;
+    decisionArtifactRef?: string | null;
+    decisionNumber?: string | null;
+    decidedAt?: string | null;
+    decidedByMemberId?: string | null;
+    decisionNote?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface GovernanceVoteContract extends ScopeRef {
+    id: string;
+    meetingId: string;
+    agendaItemId: string;
+    memberId: string;
+    choice: GovernanceVoteChoice;
+    votedAt: string;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CreateGovernanceMeetingInput extends ScopeRef {
+    title: string;
+    meetingDate: string;
+    quorumPercent: number;
+    eligibleMemberIds?: string[] | null;
+    notes?: string | null;
+}
+export interface GovernanceMeetingQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    status?: GovernanceMeetingStatus;
+}
+export interface AddGovernanceAgendaItemInput {
+    title: string;
+    description?: string | null;
+    orderNo: number;
+}
+export interface CloseGovernanceAgendaInput {
+    status: Extract<GovernanceAgendaStatus, 'approved' | 'rejected' | 'deferred'>;
+    decisionArtifactRef?: string | null;
+    decisionNumber?: string | null;
+    decidedAt?: string | null;
+    decidedByMemberId?: string | null;
+    decisionNote?: string | null;
+}
+export interface RecordGovernanceVoteInput {
+    agendaItemId: string;
+    memberId: string;
+    choice: GovernanceVoteChoice;
+    notes?: string | null;
+    votedAt: string;
+}
+export interface RecordGovernanceMeetingMinutesInput {
+    minutes: string;
+    decisionSummary?: string | null;
+}
+export interface RecordGovernanceMeetingArtifactsInput {
+    minutesArtifactRef?: string | null;
+    attendanceArtifactRef?: string | null;
+    ratDecisionBundleRef?: string | null;
+    chairpersonMemberId?: string | null;
+    secretaryMemberId?: string | null;
+}
+export interface GovernanceVoteSummary {
+    agendaItemId: string;
+    totalVotes: number;
+    eligibleVoters: number;
+    eligibleVotersSource: 'active-members' | 'meeting-eligible-members';
+    quorumPercent: number;
+    quorumReached: boolean;
+    yes: number;
+    no: number;
+    abstain: number;
+}
+export interface GovernanceDecisionArchiveItem {
+    agendaItemId: string;
+    title: string;
+    orderNo: number;
+    status: Extract<GovernanceAgendaStatus, 'approved' | 'rejected' | 'deferred'>;
+    decisionNumber?: string | null;
+    decisionArtifactRef?: string | null;
+    decidedAt?: string | null;
+    decidedByMemberId?: string | null;
+    decisionNote?: string | null;
+}
+export interface GovernanceDecisionArchive extends ScopeRef {
+    id: string;
+    meetingId: string;
+    meetingTitle: string;
+    meetingDate: string;
+    archivedAt: string;
+    archivedBy?: string | null;
+    totalItems: number;
+    approvedCount: number;
+    rejectedCount: number;
+    deferredCount: number;
+    /** Snapshot of all decided agenda items at archive time. */
+    items: GovernanceDecisionArchiveItem[];
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface ArchiveDecisionsInput {
+    archivedBy?: string | null;
+}
+export interface GovernanceMeetingServiceContract {
+    createMeeting(input: CreateGovernanceMeetingInput): Promise<ResponseEnvelope<GovernanceMeetingContract>>;
+    getMeetingById(id: string): Promise<ResponseEnvelope<GovernanceMeetingContract | null>>;
+    listMeetings(options?: GovernanceMeetingQueryOptions): Promise<ResponseEnvelope<GovernanceMeetingContract[]>>;
+    addAgendaItem(meetingId: string, input: AddGovernanceAgendaItemInput): Promise<ResponseEnvelope<GovernanceAgendaItemContract>>;
+    listAgendaItems(meetingId: string): Promise<ResponseEnvelope<GovernanceAgendaItemContract[]>>;
+    startVoting(meetingId: string): Promise<ResponseEnvelope<GovernanceMeetingContract>>;
+    recordVote(meetingId: string, input: RecordGovernanceVoteInput): Promise<ResponseEnvelope<GovernanceVoteContract>>;
+    getAgendaVoteSummary(agendaItemId: string): Promise<ResponseEnvelope<GovernanceVoteSummary>>;
+    closeAgendaItem(agendaItemId: string, input: CloseGovernanceAgendaInput): Promise<ResponseEnvelope<GovernanceAgendaItemContract>>;
+    closeMeeting(meetingId: string): Promise<ResponseEnvelope<GovernanceMeetingContract>>;
+    recordMeetingMinutes(meetingId: string, input: RecordGovernanceMeetingMinutesInput): Promise<ResponseEnvelope<GovernanceMeetingContract>>;
+    recordMeetingArtifacts(meetingId: string, input: RecordGovernanceMeetingArtifactsInput): Promise<ResponseEnvelope<GovernanceMeetingContract>>;
+    /**
+     * Creates a formal snapshot archive of all decided (approved/rejected/deferred)
+     * agenda items for a closed meeting. Idempotent: returns existing archive if
+     * already archived.
+     */
+    archiveDecisions(meetingId: string, input?: ArchiveDecisionsInput): Promise<ResponseEnvelope<GovernanceDecisionArchive>>;
+    /** Returns the decision archive for a meeting, or null if not yet archived. */
+    getDecisionArchive(meetingId: string): Promise<ResponseEnvelope<GovernanceDecisionArchive | null>>;
+}

package/dist/contracts/LeadershipAppointmentContract.d.ts

@@ -0,0 +1,91 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+import type { LeadershipRoleType } from './LeadershipTermContract.js';
+export type AppointmentType = 'election' | 'replacement' | 'interim' | 'cooptation';
+export type AppointmentStatus = 'proposed' | 'endorsed' | 'approved' | 'rejected' | 'installed';
+export interface LeadershipAppointmentContract extends ScopeRef {
+    id: string;
+    proposedMemberId: string;
+    roleType: LeadershipRoleType;
+    positionTitle: string;
+    appointmentType: AppointmentType;
+    /** ID of the LeadershipTerm being replaced (if applicable) */
+    replacesTermId?: string | null;
+    /** Meeting ID where this appointment was endorsed/voted */
+    governanceMeetingRef?: string | null;
+    status: AppointmentStatus;
+    effectiveDate: string;
+    endDate?: string | null;
+    proposedAt: string;
+    endorsedAt?: string | null;
+    endorsedBy?: string | null;
+    approvedAt?: string | null;
+    approvalRef?: string | null;
+    installedAt?: string | null;
+    /** Term ID created when installed */
+    installedTermId?: string | null;
+    rejectedAt?: string | null;
+    rejectionReason?: string | null;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface ProposeAppointmentInput extends ScopeRef {
+    proposedMemberId: string;
+    roleType: LeadershipRoleType;
+    positionTitle: string;
+    appointmentType: AppointmentType;
+    effectiveDate: string;
+    endDate?: string | null;
+    replacesTermId?: string | null;
+    governanceMeetingRef?: string | null;
+    notes?: string | null;
+}
+export interface EndorseAppointmentInput {
+    endorsedBy: string;
+    endorsedAt?: string;
+    governanceMeetingRef?: string | null;
+}
+export interface ApproveAppointmentInput {
+    approvalRef?: string | null;
+    approvedAt?: string;
+}
+export interface InstallAppointmentInput {
+    installedAt?: string;
+}
+export interface RejectAppointmentInput {
+    rejectionReason: string;
+    rejectedAt?: string;
+}
+export interface LeadershipAppointmentQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    status?: AppointmentStatus;
+    roleType?: LeadershipRoleType;
+}
+export interface LeadershipAppointmentServiceContract {
+    /**
+     * Propose a new appointment (status = proposed).
+     * Can be called by any initiator (pengurus/secretary).
+     */
+    proposeAppointment(input: ProposeAppointmentInput): Promise<ResponseEnvelope<LeadershipAppointmentContract>>;
+    /**
+     * Endorse the appointment (status proposed → endorsed).
+     * Typically triggered when the governance meeting votes in favour.
+     */
+    endorseAppointment(appointmentId: string, input: EndorseAppointmentInput): Promise<ResponseEnvelope<LeadershipAppointmentContract>>;
+    /**
+     * Final approval (status endorsed → approved).
+     * E.g. notarial/dinas koperasi approval or RAT formal resolution.
+     */
+    approveAppointment(appointmentId: string, input: ApproveAppointmentInput): Promise<ResponseEnvelope<LeadershipAppointmentContract>>;
+    /**
+     * Install the appointment (status approved → installed).
+     * Creates a new LeadershipTerm record and links installedTermId.
+     * If replacesTermId provided, ends the old term.
+     */
+    installAppointment(appointmentId: string, input?: InstallAppointmentInput): Promise<ResponseEnvelope<LeadershipAppointmentContract>>;
+    /** Reject at any stage before installed. */
+    rejectAppointment(appointmentId: string, input: RejectAppointmentInput): Promise<ResponseEnvelope<LeadershipAppointmentContract>>;
+    getAppointmentById(appointmentId: string): Promise<ResponseEnvelope<LeadershipAppointmentContract | null>>;
+    listAppointments(options?: LeadershipAppointmentQueryOptions): Promise<ResponseEnvelope<LeadershipAppointmentContract[]>>;
+}

package/dist/contracts/LeadershipTermContract.d.ts

@@ -0,0 +1,53 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type LeadershipRoleType = 'pengurus' | 'pengawas';
+export type LeadershipTermStatus = 'active' | 'ended';
+export interface LeadershipTermContract extends ScopeRef {
+    id: string;
+    memberId: string;
+    roleType: LeadershipRoleType;
+    positionTitle: string;
+    startDate: string;
+    endDate?: string | null;
+    handoverFromTermId?: string | null;
+    status: LeadershipTermStatus;
+    notes?: string | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CreateLeadershipTermInput extends ScopeRef {
+    memberId: string;
+    roleType: LeadershipRoleType;
+    positionTitle: string;
+    startDate: string;
+    endDate?: string | null;
+    handoverFromTermId?: string | null;
+    notes?: string | null;
+}
+export interface EndLeadershipTermInput {
+    endDate: string;
+    notes?: string | null;
+}
+export interface HandoverLeadershipTermInput {
+    successorMemberId: string;
+    effectiveDate: string;
+    positionTitle?: string;
+    notes?: string | null;
+}
+export interface LeadershipTermHandoverResult {
+    endedTerm: LeadershipTermContract;
+    successorTerm: LeadershipTermContract;
+}
+export interface LeadershipTermQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    status?: LeadershipTermStatus;
+    roleType?: LeadershipRoleType;
+    memberId?: string;
+}
+export interface LeadershipTermServiceContract {
+    createLeadershipTerm(input: CreateLeadershipTermInput): Promise<ResponseEnvelope<LeadershipTermContract>>;
+    endLeadershipTerm(termId: string, input: EndLeadershipTermInput): Promise<ResponseEnvelope<LeadershipTermContract>>;
+    handoverLeadershipTerm(termId: string, input: HandoverLeadershipTermInput): Promise<ResponseEnvelope<LeadershipTermHandoverResult>>;
+    getLeadershipTermById(termId: string): Promise<ResponseEnvelope<LeadershipTermContract | null>>;
+    listLeadershipTerms(options?: LeadershipTermQueryOptions): Promise<ResponseEnvelope<LeadershipTermContract[]>>;
+}

package/dist/contracts/ManagementReportContract.d.ts

@@ -0,0 +1,99 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
+export type ManagementReportType = 'lpj_pengurus' | 'lpj_pengawas';
+export type ManagementReportStatus = 'draft' | 'submitted' | 'approved' | 'rejected';
+export type ManagementReportAudience = 'rapat_anggota' | 'dinas_koperasi' | 'ojk' | 'pajak';
+export type ManagementReportPayload = Record<string, unknown>;
+export interface ManagementReportContract extends ScopeRef {
+    id: string;
+    reportType: ManagementReportType;
+    periodCode: string;
+    title: string;
+    summary: string;
+    preparedByMemberId: string;
+    preparedByLeadershipTermId?: string | null;
+    status: ManagementReportStatus;
+    submittedAt?: string | null;
+    reviewedAt?: string | null;
+    reviewerMemberId?: string | null;
+    reviewNotes?: string | null;
+    payload?: ManagementReportPayload | null;
+    version: number;
+    lastModified: string;
+    deleted: boolean;
+}
+export interface CreateManagementReportInput extends ScopeRef {
+    reportType: ManagementReportType;
+    periodCode: string;
+    title: string;
+    summary: string;
+    preparedByMemberId: string;
+    preparedByLeadershipTermId?: string | null;
+}
+export interface SubmitManagementReportInput {
+    submittedAt: string;
+}
+export interface ReviewManagementReportInput {
+    reviewerMemberId: string;
+    reviewedAt: string;
+    reviewNotes?: string | null;
+}
+export interface UpsertManagementReportPayloadInput {
+    payload: ManagementReportPayload;
+}
+export interface ManagementReportQueryOptions extends Partial<ScopeRef> {
+    includeDeleted?: boolean;
+    status?: ManagementReportStatus;
+    reportType?: ManagementReportType;
+    periodCode?: string;
+}
+export interface ManagementReportPackageSection {
+    id: string;
+    title: string;
+    content: string;
+}
+export interface ManagementReportTemplateField {
+    key: string;
+    label: string;
+    required: boolean;
+}
+export interface ManagementReportTemplateSection {
+    id: string;
+    title: string;
+    fields: ManagementReportTemplateField[];
+}
+export interface ManagementReportCompletenessContract {
+    audience: ManagementReportAudience;
+    totalRequired: number;
+    filledRequired: number;
+    missingKeys: string[];
+    isComplete: boolean;
+    template: ManagementReportTemplateSection[];
+}
+export interface ManagementReportPackageContract {
+    reportId: string;
+    reportType: ManagementReportType;
+    audience: ManagementReportAudience;
+    title: string;
+    periodCode: string;
+    generatedAt: string;
+    sections: ManagementReportPackageSection[];
+    metadata: {
+        tenantId?: string | null;
+        branchId?: string | null;
+        submittedAt?: string | null;
+        reviewedAt?: string | null;
+        status: ManagementReportStatus;
+        completeness: ManagementReportCompletenessContract;
+    };
+}
+export interface ManagementReportServiceContract {
+    createManagementReport(input: CreateManagementReportInput): Promise<ResponseEnvelope<ManagementReportContract>>;
+    upsertManagementReportPayload(reportId: string, input: UpsertManagementReportPayloadInput): Promise<ResponseEnvelope<ManagementReportContract>>;
+    submitManagementReport(reportId: string, input: SubmitManagementReportInput): Promise<ResponseEnvelope<ManagementReportContract>>;
+    approveManagementReport(reportId: string, input: ReviewManagementReportInput): Promise<ResponseEnvelope<ManagementReportContract>>;
+    rejectManagementReport(reportId: string, input: ReviewManagementReportInput): Promise<ResponseEnvelope<ManagementReportContract>>;
+    getManagementReportById(reportId: string): Promise<ResponseEnvelope<ManagementReportContract | null>>;
+    listManagementReports(options?: ManagementReportQueryOptions): Promise<ResponseEnvelope<ManagementReportContract[]>>;
+    evaluateManagementReportCompleteness(reportId: string, audience: ManagementReportAudience): Promise<ResponseEnvelope<ManagementReportCompletenessContract>>;
+    buildManagementReportPackage(reportId: string, audience: ManagementReportAudience): Promise<ResponseEnvelope<ManagementReportPackageContract>>;
+}

package/dist/contracts/MemberContract.d.ts

@@ -1,33 +1,28 @@
+import type { ScopeRef, ResponseEnvelope } from 'ofcore';
 export type MemberStatus = 'active' | 'inactive' | 'exited';
-export interface MemberContract {
+export interface MemberContract extends ScopeRef {
     id: string;
     memberNumber: string;
     fullName: string;
     status: MemberStatus;
     joinDate: string;
     exitDate?: string | null;
-    branchId?: string | null;
-    tenantId?: string | null;
     version: number;
     lastModified: string;
     deleted: boolean;
 }
-export interface CreateMemberInput {
+export interface CreateMemberInput extends ScopeRef {
     memberNumber: string;
     fullName: string;
     joinDate: string;
-    branchId?: string | null;
-    tenantId?: string | null;
 }
 export interface UpdateMemberInput {
     fullName?: string;
     memberNumber?: string;
 }
-export interface MemberQueryOptions {
+export interface MemberQueryOptions extends Partial<ScopeRef> {
     includeDeleted?: boolean;
     status?: MemberStatus;
-    tenantId?: string | null;
-    branchId?: string | null;
 }
 export interface MemberWaConsentInput {
     granted: boolean;
@@ -38,15 +33,63 @@ export interface MemberExitInput {
     reason?: string | null;
     requestedBy?: string | null;
     referenceId?: string | null;
+    note?: string | null;
+    actionAt?: string | null;
+}
+/**
+ * Rincian finansial penyelesaian anggota keluar.
+ * Semua nilai dalam satuan IDR. Field yang tidak relevan diisi 0.
+ */
+export interface MemberExitSettlementDetail {
+    /** Simpanan pokok yang dikembalikan. */
+    simpananPokokReturned: number;
+    /** Simpanan wajib yang dikembalikan. */
+    simpananWajibReturned: number;
+    /** Simpanan sukarela yang dikembalikan. */
+    simpananSukarelaReturned: number;
+    /** Alokasi SHU yang diterimakan (jika periode belum tutup, bisa 0). */
+    shuAllocated: number;
+    /** Potongan/kewajiban lain yang belum diselesaikan (misal denda, biaya administrasi). */
+    deductions: number;
+    /** Net yang diterima anggota: sum returns + shuAllocated - deductions. */
+    netSettlementAmount: number;
+    /** Siapa yang mengesahkan settlement. */
+    settledBy: string;
+    /** Tanggal settlement dikonfirmasi (ISO). */
+    settledAt: string;
+    /** Catatan tambahan. */
+    notes?: string | null;
+}
+export type MemberExitStage = 'requested' | 'settled' | 'canceled';
+/**
+ * State exit anggota yang lengkap — berisi tahap saat ini beserta rincian
+ * request dan (jika sudah settle) rincian finansial settlement.
+ */
+export interface MemberExitState {
+    memberId: string;
+    stage: MemberExitStage;
+    reason?: string | null;
+    requestedBy?: string | null;
+    referenceId?: string | null;
+    settlement?: MemberExitSettlementDetail | null;
+    version: number;
+    lastModified: string;
+}
+/** Input untuk settle — mengharuskan rincian finansial. */
+export interface MemberSettleExitInput extends MemberExitInput {
+    settlement: MemberExitSettlementDetail;
 }
 export interface MemberServiceContract {
-    createMember(input: CreateMemberInput): Promise<MemberContract>;
-    updateMember(id: string, updates: UpdateMemberInput): Promise<MemberContract>;
-    getMemberById(id: string): Promise<MemberContract | null>;
-    listMembers(options?: MemberQueryOptions): Promise<MemberContract[]>;
-    changeMemberStatus(id: string, status: MemberStatus): Promise<MemberContract>;
-    setMemberWaConsent(id: string, consent: MemberWaConsentInput): Promise<MemberContract>;
-    requestMemberExit(id: string, payload: MemberExitInput): Promise<MemberContract>;
-    settleMemberExit(id: string, payload: MemberExitInput): Promise<MemberContract>;
-    cancelMemberExit(id: string, payload: MemberExitInput): Promise<MemberContract>;
+    createMember(input: CreateMemberInput): Promise<ResponseEnvelope<MemberContract>>;
+    updateMember(id: string, updates: UpdateMemberInput): Promise<ResponseEnvelope<MemberContract>>;
+    getMemberById(id: string): Promise<ResponseEnvelope<MemberContract | null>>;
+    listMembers(options?: MemberQueryOptions): Promise<ResponseEnvelope<MemberContract[]>>;
+    changeMemberStatus(id: string, status: MemberStatus): Promise<ResponseEnvelope<MemberContract>>;
+    setMemberWaConsent(id: string, consent: MemberWaConsentInput): Promise<ResponseEnvelope<MemberContract>>;
+    requestMemberExit(id: string, payload: MemberExitInput): Promise<ResponseEnvelope<MemberContract>>;
+    /** Settle memerlukan rincian finansial dan gagal jika anggota masih punya pinjaman aktif. */
+    settleMemberExit(id: string, payload: MemberSettleExitInput): Promise<ResponseEnvelope<MemberContract>>;
+    cancelMemberExit(id: string, payload: MemberExitInput): Promise<ResponseEnvelope<MemberContract>>;
+    /** Kembalikan state exit terkini beserta rincian settlement jika sudah ada. */
+    getMemberExitState(id: string): Promise<ResponseEnvelope<MemberExitState | null>>;
 }