@mitumba/sdk 1.13.0 → 1.14.0

package/dist/index.d.mts

@@ -668,6 +668,70 @@ interface SystemStats {
     active_today: number;
 }
 
+declare const DISPUTE_REASONS: readonly ["not_received", "not_as_described", "damaged", "counterfeit", "wrong_item"];
+type DisputeReason = typeof DISPUTE_REASONS[number];
+declare const DESIRED_RESOLUTIONS: readonly ["refund", "replacement", "partial_refund"];
+type DesiredResolution = typeof DESIRED_RESOLUTIONS[number];
+declare const DISPUTE_STATUSES: readonly ["open", "seller_responded", "under_review", "resolved_refund", "resolved_release", "resolved_partial", "withdrawn"];
+type DisputeStatus = typeof DISPUTE_STATUSES[number];
+interface DisputeEvidence {
+    id: string;
+    uploader_role: 'buyer' | 'seller' | 'admin';
+    type: 'image' | 'text';
+    content: string;
+    created_at: string;
+}
+interface DisputeEvent {
+    actor_role: 'buyer' | 'seller' | 'admin' | 'system';
+    action: string;
+    old_status: string | null;
+    new_status: string | null;
+    note: string | null;
+    created_at: string;
+}
+interface Dispute {
+    id: string;
+    order_id: string;
+    buyer_id: string;
+    seller_id: string;
+    reason: DisputeReason;
+    description: string;
+    desired_resolution: DesiredResolution;
+    status: DisputeStatus;
+    amount_disputed: number;
+    resolution: 'refund' | 'release' | 'partial' | null;
+    resolution_amount: number | null;
+    resolution_note: string | null;
+    sti_impact: number | null;
+    seller_responded_at: string | null;
+    escalated_at: string | null;
+    resolved_at: string | null;
+    created_at: string;
+    updated_at: string;
+    evidence?: DisputeEvidence[];
+    events?: DisputeEvent[];
+}
+interface RaiseDisputeInput {
+    reason: DisputeReason;
+    description: string;
+    desired_resolution: DesiredResolution;
+    evidence_urls?: string[];
+}
+interface RespondDisputeInput {
+    accept: boolean;
+    message?: string;
+    evidence_urls?: string[];
+}
+interface ResolveDisputeInput {
+    resolution: 'refund' | 'release' | 'partial';
+    amount?: number;
+    note?: string;
+}
+interface DisputeListParams {
+    status?: DisputeStatus;
+    page?: number;
+}
+
 interface MitumbaClientConfig {
     baseUrl: string;
     debug?: boolean;
@@ -1417,6 +1481,55 @@ declare class AdminModule {
     }>;
 }
 
+declare class DisputesModule {
+    private readonly client;
+    constructor(client: APIClient);
+    /** Raise a dispute on an order (buyer). */
+    raise(orderId: string, input: RaiseDisputeInput, options?: RequestOptions): Promise<{
+        dispute_id: string;
+        status: 'open';
+    }>;
+    /** Get the dispute for a specific order. */
+    getForOrder(orderId: string, options?: RequestOptions): Promise<Dispute>;
+    /** Get a dispute by ID. */
+    get(disputeId: string, options?: RequestOptions): Promise<Dispute>;
+    /** Add evidence to a dispute. */
+    addEvidence(disputeId: string, input: {
+        type: 'image' | 'text';
+        content: string;
+    }, options?: RequestOptions): Promise<{
+        ok: true;
+    }>;
+    /** Escalate a dispute to admin review (buyer). */
+    escalate(disputeId: string, options?: RequestOptions): Promise<{
+        ok: true;
+        status: 'under_review';
+    }>;
+    /** Withdraw a dispute (buyer). */
+    withdraw(disputeId: string, options?: RequestOptions): Promise<{
+        ok: true;
+        status: 'withdrawn';
+    }>;
+    /** Respond to a dispute (seller). */
+    respond(disputeId: string, input: RespondDisputeInput, options?: RequestOptions): Promise<{
+        ok: true;
+        status?: string;
+        voluntary?: boolean;
+    }>;
+    /** List all disputes (admin). */
+    list(params?: DisputeListParams, options?: RequestOptions): Promise<{
+        data: Dispute[];
+        page: number;
+        page_size: number;
+    }>;
+    /** Resolve a dispute (admin). */
+    resolve(disputeId: string, input: ResolveDisputeInput, options?: RequestOptions): Promise<{
+        ok: true;
+        status: string;
+        sti_impact: number;
+    }>;
+}
+
 declare class MitumbaClient {
     readonly api: APIClient;
     readonly auth: AuthModule;
@@ -1435,6 +1548,7 @@ declare class MitumbaClient {
     readonly mailer: MailerModule;
     readonly businesses: BusinessesModule;
     readonly admin: AdminModule;
+    readonly disputes: DisputesModule;
     constructor(config: MitumbaClientConfig);
     /**
      * Set the access token for authenticated requests.
@@ -1459,4 +1573,4 @@ declare class MitumbaClient {
     isAuthenticated(): Promise<boolean>;
 }
 
-export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AdminModule, AuthModule, type AuthTokens, type BecomeSellerInput, type BlockedIp, type Business, BusinessesModule, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type City, type CompleteOnboardingInput, type Condition, type Conversation, type CreateListingInput, type CreateOrderInput, type CreateReviewInput, type CreateStoreInput, type DeliveryAddress, type EmailLoginInput, type EmailRegisterInput, type ForgotPasswordInput, IDBTokenStore, LISTING_STATUSES, type LinkedAccount, type LinkedAccountProvider, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageResponse, MessagesModule, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentMethod, type PaymentMethodType, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type RegisterInput, type RequestOptions, type ResetPasswordInput, type Review, type ReviewableOrder, ReviewsModule, type SaveSearchInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SendEmailInput, type SendMessageInput, type SendOtpInput, type Session, SettingsModule, type SimilarListing, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreSettings, type StoreStats, StoresModule, type SubscriptionTier, type SystemStats, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorRequired, type UpdateBusinessInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WishlistListing, WishlistsModule, createTokenStore };
+export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AdminModule, AuthModule, type AuthTokens, type BecomeSellerInput, type BlockedIp, type Business, BusinessesModule, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type City, type CompleteOnboardingInput, type Condition, type Conversation, type CreateListingInput, type CreateOrderInput, type CreateReviewInput, type CreateStoreInput, DESIRED_RESOLUTIONS, DISPUTE_REASONS, DISPUTE_STATUSES, type DeliveryAddress, type DesiredResolution, type Dispute, type DisputeEvent, type DisputeEvidence, type DisputeListParams, type DisputeReason, type DisputeStatus, DisputesModule, type EmailLoginInput, type EmailRegisterInput, type ForgotPasswordInput, IDBTokenStore, LISTING_STATUSES, type LinkedAccount, type LinkedAccountProvider, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageResponse, MessagesModule, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentMethod, type PaymentMethodType, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type RaiseDisputeInput, type RegisterInput, type RequestOptions, type ResetPasswordInput, type ResolveDisputeInput, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type SaveSearchInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SendEmailInput, type SendMessageInput, type SendOtpInput, type Session, SettingsModule, type SimilarListing, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreSettings, type StoreStats, StoresModule, type SubscriptionTier, type SystemStats, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorRequired, type UpdateBusinessInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WishlistListing, WishlistsModule, createTokenStore };

package/dist/index.d.ts

@@ -668,6 +668,70 @@ interface SystemStats {
     active_today: number;
 }
 
+declare const DISPUTE_REASONS: readonly ["not_received", "not_as_described", "damaged", "counterfeit", "wrong_item"];
+type DisputeReason = typeof DISPUTE_REASONS[number];
+declare const DESIRED_RESOLUTIONS: readonly ["refund", "replacement", "partial_refund"];
+type DesiredResolution = typeof DESIRED_RESOLUTIONS[number];
+declare const DISPUTE_STATUSES: readonly ["open", "seller_responded", "under_review", "resolved_refund", "resolved_release", "resolved_partial", "withdrawn"];
+type DisputeStatus = typeof DISPUTE_STATUSES[number];
+interface DisputeEvidence {
+    id: string;
+    uploader_role: 'buyer' | 'seller' | 'admin';
+    type: 'image' | 'text';
+    content: string;
+    created_at: string;
+}
+interface DisputeEvent {
+    actor_role: 'buyer' | 'seller' | 'admin' | 'system';
+    action: string;
+    old_status: string | null;
+    new_status: string | null;
+    note: string | null;
+    created_at: string;
+}
+interface Dispute {
+    id: string;
+    order_id: string;
+    buyer_id: string;
+    seller_id: string;
+    reason: DisputeReason;
+    description: string;
+    desired_resolution: DesiredResolution;
+    status: DisputeStatus;
+    amount_disputed: number;
+    resolution: 'refund' | 'release' | 'partial' | null;
+    resolution_amount: number | null;
+    resolution_note: string | null;
+    sti_impact: number | null;
+    seller_responded_at: string | null;
+    escalated_at: string | null;
+    resolved_at: string | null;
+    created_at: string;
+    updated_at: string;
+    evidence?: DisputeEvidence[];
+    events?: DisputeEvent[];
+}
+interface RaiseDisputeInput {
+    reason: DisputeReason;
+    description: string;
+    desired_resolution: DesiredResolution;
+    evidence_urls?: string[];
+}
+interface RespondDisputeInput {
+    accept: boolean;
+    message?: string;
+    evidence_urls?: string[];
+}
+interface ResolveDisputeInput {
+    resolution: 'refund' | 'release' | 'partial';
+    amount?: number;
+    note?: string;
+}
+interface DisputeListParams {
+    status?: DisputeStatus;
+    page?: number;
+}
+
 interface MitumbaClientConfig {
     baseUrl: string;
     debug?: boolean;
@@ -1417,6 +1481,55 @@ declare class AdminModule {
     }>;
 }
 
+declare class DisputesModule {
+    private readonly client;
+    constructor(client: APIClient);
+    /** Raise a dispute on an order (buyer). */
+    raise(orderId: string, input: RaiseDisputeInput, options?: RequestOptions): Promise<{
+        dispute_id: string;
+        status: 'open';
+    }>;
+    /** Get the dispute for a specific order. */
+    getForOrder(orderId: string, options?: RequestOptions): Promise<Dispute>;
+    /** Get a dispute by ID. */
+    get(disputeId: string, options?: RequestOptions): Promise<Dispute>;
+    /** Add evidence to a dispute. */
+    addEvidence(disputeId: string, input: {
+        type: 'image' | 'text';
+        content: string;
+    }, options?: RequestOptions): Promise<{
+        ok: true;
+    }>;
+    /** Escalate a dispute to admin review (buyer). */
+    escalate(disputeId: string, options?: RequestOptions): Promise<{
+        ok: true;
+        status: 'under_review';
+    }>;
+    /** Withdraw a dispute (buyer). */
+    withdraw(disputeId: string, options?: RequestOptions): Promise<{
+        ok: true;
+        status: 'withdrawn';
+    }>;
+    /** Respond to a dispute (seller). */
+    respond(disputeId: string, input: RespondDisputeInput, options?: RequestOptions): Promise<{
+        ok: true;
+        status?: string;
+        voluntary?: boolean;
+    }>;
+    /** List all disputes (admin). */
+    list(params?: DisputeListParams, options?: RequestOptions): Promise<{
+        data: Dispute[];
+        page: number;
+        page_size: number;
+    }>;
+    /** Resolve a dispute (admin). */
+    resolve(disputeId: string, input: ResolveDisputeInput, options?: RequestOptions): Promise<{
+        ok: true;
+        status: string;
+        sti_impact: number;
+    }>;
+}
+
 declare class MitumbaClient {
     readonly api: APIClient;
     readonly auth: AuthModule;
@@ -1435,6 +1548,7 @@ declare class MitumbaClient {
     readonly mailer: MailerModule;
     readonly businesses: BusinessesModule;
     readonly admin: AdminModule;
+    readonly disputes: DisputesModule;
     constructor(config: MitumbaClientConfig);
     /**
      * Set the access token for authenticated requests.
@@ -1459,4 +1573,4 @@ declare class MitumbaClient {
     isAuthenticated(): Promise<boolean>;
 }
 
-export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AdminModule, AuthModule, type AuthTokens, type BecomeSellerInput, type BlockedIp, type Business, BusinessesModule, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type City, type CompleteOnboardingInput, type Condition, type Conversation, type CreateListingInput, type CreateOrderInput, type CreateReviewInput, type CreateStoreInput, type DeliveryAddress, type EmailLoginInput, type EmailRegisterInput, type ForgotPasswordInput, IDBTokenStore, LISTING_STATUSES, type LinkedAccount, type LinkedAccountProvider, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageResponse, MessagesModule, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentMethod, type PaymentMethodType, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type RegisterInput, type RequestOptions, type ResetPasswordInput, type Review, type ReviewableOrder, ReviewsModule, type SaveSearchInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SendEmailInput, type SendMessageInput, type SendOtpInput, type Session, SettingsModule, type SimilarListing, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreSettings, type StoreStats, StoresModule, type SubscriptionTier, type SystemStats, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorRequired, type UpdateBusinessInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WishlistListing, WishlistsModule, createTokenStore };
+export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AdminModule, AuthModule, type AuthTokens, type BecomeSellerInput, type BlockedIp, type Business, BusinessesModule, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type City, type CompleteOnboardingInput, type Condition, type Conversation, type CreateListingInput, type CreateOrderInput, type CreateReviewInput, type CreateStoreInput, DESIRED_RESOLUTIONS, DISPUTE_REASONS, DISPUTE_STATUSES, type DeliveryAddress, type DesiredResolution, type Dispute, type DisputeEvent, type DisputeEvidence, type DisputeListParams, type DisputeReason, type DisputeStatus, DisputesModule, type EmailLoginInput, type EmailRegisterInput, type ForgotPasswordInput, IDBTokenStore, LISTING_STATUSES, type LinkedAccount, type LinkedAccountProvider, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageResponse, MessagesModule, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentMethod, type PaymentMethodType, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type RaiseDisputeInput, type RegisterInput, type RequestOptions, type ResetPasswordInput, type ResolveDisputeInput, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type SaveSearchInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SendEmailInput, type SendMessageInput, type SendOtpInput, type Session, SettingsModule, type SimilarListing, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreSettings, type StoreStats, StoresModule, type SubscriptionTier, type SystemStats, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorRequired, type UpdateBusinessInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WishlistListing, WishlistsModule, createTokenStore };

package/dist/index.js

@@ -1109,6 +1109,54 @@ var AdminModule = class {
   }
 };
 
+// src/modules/disputes.ts
+var DisputesModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  client;
+  /** Raise a dispute on an order (buyer). */
+  async raise(orderId, input, options) {
+    return this.client.post(`/orders/${orderId}/dispute`, input, options);
+  }
+  /** Get the dispute for a specific order. */
+  async getForOrder(orderId, options) {
+    return this.client.get(`/orders/${orderId}/dispute`, void 0, options);
+  }
+  /** Get a dispute by ID. */
+  async get(disputeId, options) {
+    return this.client.get(`/orders/disputes/${disputeId}`, void 0, options);
+  }
+  /** Add evidence to a dispute. */
+  async addEvidence(disputeId, input, options) {
+    return this.client.post(`/orders/disputes/${disputeId}/evidence`, input, options);
+  }
+  /** Escalate a dispute to admin review (buyer). */
+  async escalate(disputeId, options) {
+    return this.client.post(`/orders/disputes/${disputeId}/escalate`, void 0, options);
+  }
+  /** Withdraw a dispute (buyer). */
+  async withdraw(disputeId, options) {
+    return this.client.post(`/orders/disputes/${disputeId}/withdraw`, void 0, options);
+  }
+  /** Respond to a dispute (seller). */
+  async respond(disputeId, input, options) {
+    return this.client.post(`/orders/disputes/${disputeId}/respond`, input, options);
+  }
+  /** List all disputes (admin). */
+  async list(params, options) {
+    return this.client.get(
+      "/orders/disputes",
+      params,
+      options
+    );
+  }
+  /** Resolve a dispute (admin). */
+  async resolve(disputeId, input, options) {
+    return this.client.post(`/orders/disputes/${disputeId}/resolve`, input, options);
+  }
+};
+
 // src/types/listings.ts
 var CONDITIONS = ["new", "like_new", "good", "fair"];
 var LISTING_STATUSES = ["draft", "active", "sold", "removed"];
@@ -1129,6 +1177,11 @@ var ORDER_STATUSES = [
 // src/types/pay.ts
 var PAYMENT_STATUSES = ["initiated", "funded", "failed", "refunded", "cancelled"];
 
+// src/types/disputes.ts
+var DISPUTE_REASONS = ["not_received", "not_as_described", "damaged", "counterfeit", "wrong_item"];
+var DESIRED_RESOLUTIONS = ["refund", "replacement", "partial_refund"];
+var DISPUTE_STATUSES = ["open", "seller_responded", "under_review", "resolved_refund", "resolved_release", "resolved_partial", "withdrawn"];
+
 // src/index.ts
 var MitumbaClient = class {
   api;
@@ -1148,6 +1201,7 @@ var MitumbaClient = class {
   mailer;
   businesses;
   admin;
+  disputes;
   constructor(config) {
     this.api = new APIClient(config);
     this.auth = new AuthModule(this.api);
@@ -1166,6 +1220,7 @@ var MitumbaClient = class {
     this.mailer = new MailerModule(this.api);
     this.businesses = new BusinessesModule(this.api);
     this.admin = new AdminModule(this.api);
+    this.disputes = new DisputesModule(this.api);
   }
   /**
    * Set the access token for authenticated requests.
@@ -1207,6 +1262,10 @@ exports.AuthModule = AuthModule;
 exports.BusinessesModule = BusinessesModule;
 exports.CONDITIONS = CONDITIONS;
 exports.CartModule = CartModule;
+exports.DESIRED_RESOLUTIONS = DESIRED_RESOLUTIONS;
+exports.DISPUTE_REASONS = DISPUTE_REASONS;
+exports.DISPUTE_STATUSES = DISPUTE_STATUSES;
+exports.DisputesModule = DisputesModule;
 exports.IDBTokenStore = IDBTokenStore;
 exports.LISTING_STATUSES = LISTING_STATUSES;
 exports.ListingsModule = ListingsModule;