@optizio/merchant-identity 0.6.0 → 0.7.0

package/dist/index.d.ts

@@ -716,6 +716,85 @@ export interface AffiliateImportResolveInput {
     reason: string;
     actorId: string;
 }
+/**
+ * One approved program in the first canonical relationship seed. The app
+ * must already exist in Partner data; this operation does not create apps.
+ */
+export interface AffiliateRelationshipSeedProgramInput {
+    id: string;
+    /** The app-local Shoffi identifier explicitly mapped to this Partner app. */
+    sourceAppId: string;
+    appGid: string;
+    name: string;
+    defaultRateBps: number;
+    status: 'active' | 'inactive';
+    /** Approved UTC commission cutover for this app's referrals. */
+    cutoverAt: string;
+}
+/**
+ * An approved canonical affiliate. Relationship migration keeps every
+ * affiliate on payout hold until payout policy and historical balances have
+ * separately been approved.
+ */
+export interface AffiliateRelationshipSeedAffiliateInput {
+    id: string;
+    name: string;
+    email: string | null;
+    payoutHoldReason: string;
+}
+/**
+ * Maps one app-scoped Shoffi relation identity to an approved canonical
+ * affiliate/program membership. The source identity is retained in the seed
+ * audit record and must not be inferred from display names or emails.
+ */
+export interface AffiliateRelationshipSeedMembershipInput {
+    id: string;
+    affiliateId: string;
+    programId: string;
+    sourceAppId: string;
+    sourceRelationId: string;
+    joinedAt: string | null;
+    status: 'active' | 'inactive';
+    legacyCodes: {
+        source: string;
+        code: string;
+    }[];
+}
+/** An approved continuing or ended Shoffi referral relationship. */
+export interface AffiliateRelationshipSeedReferralInput {
+    id: string;
+    membershipId: string;
+    appGid: string;
+    shopDomain: string;
+    shopGid: string | null;
+    referredAt: string | null;
+    rateBps: number;
+    accrualFrom: string;
+    status: 'active' | 'ended';
+    endedAt: string | null;
+    endReason: string | null;
+}
+/**
+ * The complete operator-reviewed canonical relationship seed. It deliberately
+ * excludes historical commissions, payouts, and payout items.
+ */
+export interface AffiliateRelationshipSeedInput {
+    /** The reviewed Shoffi account scope that supplied the relation IDs. */
+    sourceAccount: string;
+    programs: AffiliateRelationshipSeedProgramInput[];
+    affiliates: AffiliateRelationshipSeedAffiliateInput[];
+    memberships: AffiliateRelationshipSeedMembershipInput[];
+    referrals: AffiliateRelationshipSeedReferralInput[];
+    idempotencyKey: string;
+    reason: string;
+    actorId: string;
+}
+export interface AffiliateRelationshipSeedResult {
+    programIds: string[];
+    affiliateIds: string[];
+    membershipIds: string[];
+    referralIds: string[];
+}
 /** Ask for a (catch-up) commission sweep pass; returns immediately. */
 export interface AffiliateSweepInput {
     /** Restrict the pass to one app, null = all. */
@@ -834,6 +913,7 @@ export interface AffiliateDomainStatus {
 export interface AffiliateAdminClient {
     updateAffiliate(input: AffiliateUpdateInput): Promise<Affiliate>;
     setPayoutPolicy(input: AffiliatePayoutPolicyInput): Promise<void>;
+    seedRelationship(input: AffiliateRelationshipSeedInput): Promise<AffiliateRelationshipSeedResult>;
     stageImportBatch(input: AffiliateImportBatchInput): Promise<{
         batchId: string;
     }>;

package/dist/index.js

@@ -230,6 +230,9 @@ export const UNAVAILABLE_AFFILIATE_ADMIN = {
     async setPayoutPolicy() {
         unavailable();
     },
+    async seedRelationship() {
+        unavailable();
+    },
     async stageImportBatch() {
         unavailable();
     },

package/package.json

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