@optizio/merchant-identity 0.7.1 → 0.9.0

package/dist/index.d.ts

@@ -702,12 +702,37 @@ export interface AffiliateImportBatchInput {
     idempotencyKey: string;
     actorId: string;
 }
+/** Validate a staged import without resolving or activating it. */
+export interface AffiliateImportValidationInput {
+    batchId: string;
+    idempotencyKey: string;
+    actorId: string;
+}
 /** Activate a validated import; partial data must not leak into balances. */
 export interface AffiliateImportActivateInput {
     batchId: string;
     idempotencyKey: string;
     actorId: string;
 }
+/** Activate the one reviewed Shoffi production opening-balance batch. */
+export interface AffiliateOpeningBalanceActivationInput {
+    batchId: string;
+    idempotencyKey: string;
+    actorId: string;
+}
+export interface AffiliateOpeningBalanceActivationResult {
+    records: number;
+    amountMinor: number;
+}
+/** Move only active referrals to the approved post-revocation accrual boundary. */
+export interface AffiliateAccrualBoundaryMoveInput {
+    idempotencyKey: string;
+    actorId: string;
+}
+export interface AffiliateAccrualBoundaryMoveResult {
+    moved: number;
+    accrualFrom: string;
+}
 /** Explicitly map one source record to a canonical entity. */
 export interface AffiliateImportResolveInput {
     sourceRecordId: string;
@@ -916,6 +941,7 @@ export interface AffiliateAdminClient {
     seedRelationship(input: AffiliateRelationshipSeedInput): Promise<AffiliateRelationshipSeedResult>;
     stageImportBatch(input: AffiliateImportBatchInput): Promise<{
         batchId: string;
+        sourceRecords: number;
     }>;
     validateImport(id: string): Promise<{
         valid: boolean;
@@ -940,8 +966,26 @@ export interface AffiliateAdminClient {
 export interface AffiliateImportStagingClient {
     stageImportBatch(input: AffiliateImportBatchInput): Promise<{
         batchId: string;
+        sourceRecords: number;
+    }>;
+}
+/**
+ * Deliberately narrow import-validation surface. It can validate one staged
+ * batch, but cannot resolve source records or activate any import.
+ */
+export interface AffiliateImportValidationClient {
+    validateImport(input: AffiliateImportValidationInput): Promise<{
+        valid: boolean;
+        errorCount: number;
     }>;
 }
+/**
+ * Deliberately narrow import-activation surface. It can activate one
+ * validated, non-financial batch, but cannot stage, validate, or resolve one.
+ */
+export interface AffiliateImportActivationClient {
+    activateImport(input: AffiliateImportActivateInput): Promise<void>;
+}
 /**
  * Deliberately narrow relationship-seed surface for a separately protected
  * operator Worker. It cannot stage imports, activate them, or touch payouts.
@@ -949,6 +993,58 @@ export interface AffiliateImportStagingClient {
 export interface AffiliateRelationshipSeedClient {
     seedRelationship(input: AffiliateRelationshipSeedInput): Promise<AffiliateRelationshipSeedResult>;
 }
+/**
+ * A single reviewed pass over commissions earned from the approved
+ * relationship cutover. This cannot create payouts or modify payout policy.
+ */
+export interface AffiliatePostCutoverBackfillInput {
+    idempotencyKey: string;
+    actorId: string;
+}
+export interface AffiliatePostCutoverBackfillResult {
+    processed: number;
+    created: number;
+    completed: boolean;
+    errorCount: number;
+}
+/** Narrow Access-operator surface for the one-time post-cutover backfill. */
+export interface AffiliatePostCutoverBackfillClient {
+    runPostCutoverCommissionBackfill(input: AffiliatePostCutoverBackfillInput): Promise<AffiliatePostCutoverBackfillResult>;
+}
+/** Separate explicit rescan of late arrivals inside the original backfill cutoff. */
+export interface AffiliatePostCutoverCatchupClient {
+    runPostCutoverCommissionCatchup(input: AffiliatePostCutoverBackfillInput): Promise<AffiliatePostCutoverBackfillResult>;
+}
+/** A reviewed accounting decision, not an automatic clawback or ledger write. */
+export interface AffiliatePartnerAdjustmentReviewInput {
+    transactionGid: string;
+    disposition: 'prior_period_no_local_reversal' | 'manual_adjustment_recorded';
+    /** Reference to privately retained evidence supporting this exact decision. */
+    evidenceReference: string;
+    reason: string;
+    /** Existing negative USD manual adjustment for the affected affiliate, or null. */
+    ledgerEntryId: string | null;
+    /** Explicit reviewed amount of that existing ledger entry, or null. */
+    ledgerAmountMinor: number | null;
+    idempotencyKey: string;
+    actorId: string;
+}
+export interface AffiliatePartnerAdjustmentReviewResult {
+    transactionGid: string;
+    disposition: AffiliatePartnerAdjustmentReviewInput['disposition'];
+}
+/** Narrow, audit-only Access operator capability. It never writes ledger money. */
+export interface AffiliatePartnerAdjustmentReviewClient {
+    reviewShoffiPartnerAdjustment(input: AffiliatePartnerAdjustmentReviewInput): Promise<AffiliatePartnerAdjustmentReviewResult>;
+}
+/** Narrow operator surface for opening liabilities only. */
+export interface AffiliateOpeningBalanceActivationClient {
+    activateShoffiOpeningBalanceImport(input: AffiliateOpeningBalanceActivationInput): Promise<AffiliateOpeningBalanceActivationResult>;
+}
+/** Narrow operator surface for the one reviewed referral-boundary move. */
+export interface AffiliateAccrualBoundaryMoveClient {
+    moveShoffiAccrualBoundary(input: AffiliateAccrualBoundaryMoveInput): Promise<AffiliateAccrualBoundaryMoveResult>;
+}
 /**
  * The one rejection every `UNAVAILABLE_AFFILIATE_ADMIN` method throws: an
  * unavailable affiliate write client must fail, never pretend an import,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@optizio/merchant-identity",
-  "version": "0.7.1",
+  "version": "0.9.0",
   "description": "Shared merchant/user identity + revenue types and RPC client contracts for the merchant-hub portfolio.",
   "repository": {
     "type": "git",