@mitumba/sdk 1.32.1 → 2.0.0

package/dist/index.d.mts

@@ -818,6 +818,28 @@ interface LegacyMessagePage {
     /** Whether older history remains. */
     has_older: boolean;
 }
+/**
+ * Create a bilateral block from a v2 inbox perspective. A buyer blocks a store by `store_id`;
+ * a store blocks a buyer by `buyer_id`.
+ */
+type MessagingBlockInput = {
+    store_id: string;
+    reason?: string;
+} | {
+    buyer_id: string;
+    reason?: string;
+};
+/** Idempotent block result. */
+interface MessagingBlockResult {
+    id: string;
+    active: boolean;
+    deduplicated: boolean;
+}
+/** Result of removing a block. */
+interface MessagingBlockRemovedResult {
+    ok: true;
+    active: false;
+}
 
 interface BlockedIp {
     ip: string;
@@ -1642,6 +1664,43 @@ interface CreateBaleOrderInput {
     qty?: number;
     fulfillment: BaleFulfillment;
 }
+/**
+ * Result of uploading a bale image directly via multipart/form-data. Mirrors the listing image
+ * upload result; the presign step reuses `PresignImageResponse` from the listings types.
+ */
+interface BaleImageUploadResult {
+    r2_key: string;
+    image_id: string;
+    url: string;
+}
+/**
+ * Performance analytics for a wholesale store. Mirrors the retail `StoreAnalytics` shape where it
+ * applies (revenue series, order breakdown) and adapts the rest to bales (top bales, bale totals).
+ */
+interface WholesaleAnalytics {
+    revenue: {
+        date: string;
+        revenue: number;
+        orders: number;
+    }[];
+    orders_breakdown: {
+        date: string;
+        completed: number;
+        pending: number;
+        cancelled: number;
+    }[];
+    top_bales: {
+        bale_id: string;
+        title: string;
+        orders: number;
+        revenue: number;
+    }[];
+    totals: {
+        bales: number;
+        orders: number;
+        revenue: number;
+    };
+}
 
 interface StkPushInput {
     order_id: string;
@@ -2745,37 +2804,15 @@ declare class VaziModule {
 declare class MessagesModule {
     private readonly client;
     constructor(client: APIClient);
-    /** @deprecated Use listConversations or listStoreConversations. Context fields are non-authoritative server-validated hints. */
-    list(storeId?: string, options?: RequestOptions): Promise<{
-        data: Conversation[];
-    }>;
-    /** @deprecated Resolve a v2 thread and call listThreadMessages. */
-    getThread(partnerId: string, storeId?: string, options?: RequestOptions): Promise<{
-        data: Message[];
-    }>;
-    /** @deprecated Use sendThreadMessage. Receiver and context fields are hints validated by the server. */
-    send(input: SendMessageInput, options?: RequestOptions): Promise<{
-        id: string;
-    }>;
-    /** @deprecated Use advanceThreadReadCursor for precise monotonic state. */
-    markRead(partnerId: string, storeId?: string, options?: RequestOptions): Promise<{
-        ok: true;
-    }>;
-    /** @deprecated Use managed messaging realtime. */
-    connectTyping(partnerId: string): WebSocket;
-    /** @deprecated Use managed messaging realtime. */
-    connectInbox(): WebSocket;
-    /** Create a legacy inbox socket only after hydrating/refreshing the access token. */
-    connectInboxFresh(options?: RequestOptions): Promise<WebSocketLike>;
-    /** Create a report for a message or conversation. */
-    createReport(input: CreateMessageReportInput, options?: RequestOptions): Promise<CreateMessageReportResult>;
-    /** Create an idempotent bilateral buyer/store relationship block. */
-    createBlock(input: CreateMessageBlockInput, options?: RequestOptions): Promise<CreateMessageBlockResult>;
-    /** Remove a block created by the current perspective. */
-    removeBlock(blockId: string, options?: RequestOptions): Promise<{
-        ok: true;
-        active: false;
-    }>;
+    /**
+     * Create a bilateral block from a v2 inbox perspective. A buyer blocks a store (`{ store_id }`);
+     * a store blocks a buyer (`{ buyer_id }`). Idempotent.
+     */
+    createMessagingBlock(perspective: MessagingPerspective, input: MessagingBlockInput, options?: RequestOptions): Promise<MessagingBlockResult>;
+    /** Remove a block the current perspective created. */
+    removeMessagingBlock(perspective: MessagingPerspective, blockId: string, options?: RequestOptions): Promise<MessagingBlockRemovedResult>;
+    /** File a message or conversation report from a v2 inbox perspective. Idempotent on open reports. */
+    createMessagingReport(perspective: MessagingPerspective, input: CreateMessageReportInput, options?: RequestOptions): Promise<CreateMessageReportResult>;
     /** Discover server messaging capabilities. */
     getMessagingCapabilities(options?: RequestOptions): Promise<MessagingCapabilities>;
     /** List buyer and represented-store inbox perspectives. */
@@ -3541,6 +3578,25 @@ declare class WholesaleModule {
     myBales(options?: RequestOptions): Promise<{
         data: Bale[];
     }>;
+    /**
+     * Presign a bale image upload slot (requires the owning wholesale store).
+     *
+     * @param baleId - The bale to attach the image to
+     * @param index - The slot index; slot 0 is the cover
+     * @returns The storage key and image id for the slot
+     * @throws {APIError} On network or server errors
+     */
+    presignBaleImage(baleId: string, index: number, options?: RequestOptions): Promise<PresignImageResponse>;
+    /**
+     * Upload a bale image file directly. Uses multipart/form-data. Slot 0 is the cover.
+     *
+     * @param baleId - The bale to attach the image to
+     * @param file - The image file as a `Blob` (React Native passes a `{ uri, name, type }` part)
+     * @param index - The slot index; slot 0 is the cover
+     * @returns The storage key, image id, and public URL
+     * @throws {APIError} On network or server errors
+     */
+    uploadBaleImage(baleId: string, file: Blob, index: number, options?: RequestOptions): Promise<BaleImageUploadResult>;
     /** Browse the wholesale bale feed (public). */
     wholesaleFeed(params?: WholesaleFeedParams, options?: RequestOptions): Promise<{
         data: BaleFeedItem[];
@@ -3569,6 +3625,22 @@ declare class WholesaleModule {
         ok: true;
         status: BaleOrderStatus;
     }>;
+    /**
+     * Get performance analytics for the current user's wholesale store (bale_seller only).
+     *
+     * The wholesale store is resolved server-side from the session, so no store id is passed — the
+     * same way `getWholesaleStore`, `myBales`, and `incomingBaleOrders` work.
+     *
+     * @param period - Optional granularity; defaults to the server's default window
+     * @returns Revenue series, order breakdown, top bales, and totals
+     * @throws {APIError} On network or server errors
+     *
+     * @example
+     * ```typescript
+     * const analytics = await sdk.wholesale.getAnalytics('weekly')
+     * ```
+     */
+    getAnalytics(period?: 'daily' | 'weekly' | 'monthly', options?: RequestOptions): Promise<WholesaleAnalytics>;
 }
 
 /**
@@ -3646,4 +3718,4 @@ declare class MitumbaClient {
     isAuthenticated(): Promise<boolean>;
 }
 
-export { APIClient, APIError, type APIErrorResponse, type Add2FAMethodInput, type Add2FAMethodResult, type AddAddressInput, type AddDepotInput, type AddPaymentMethodInput, type Address, type AdminAuditEntry, type AdminAuthStrength, type AdminListingItem, AdminModule, type AdminOperator, type AdminOrderDetail, type AdminOrderListItem, type AdminPayoutItem, type AdminPermission, type AdminPermissionDescription, type AdminRecoveryEvent, type AdminRecoveryRequest, type AdminReport, type AdminRolePreset, type AdminStoreDetail, type AdminStoreListItem, type AdminUserDetail, type AdminUserListItem, type AdminVaziOutfit, type AdminVerificationItem, type AdminWholesalePendingStore, type ApiResponse, type AttachmentDownloadAuthorization, type AttachmentUploadAuthorization, type AttachmentUploadBody, type AttachmentUploadState, type AttachmentUploadStatus, type AuthCapabilities, AuthModule, type AuthTokens, type AuthenticationResponseJSON, BALE_ORDER_STATUSES, type Bale, type BaleDetail, type BaleFeedItem, type BaleFulfillment, type BaleGrade, type BaleOrder, type BaleOrderEvent, type BaleOrderStatus, type BaleType, type BecomeBaleSellerInput, type BecomeSellerInput, type BlockedIp, type Business, type BusinessType, BusinessesModule, type BuyerResolveThreadInput, type BuyerSummary, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type CheckoutNextAction, type CheckoutOrder, type CheckoutPaymentMethod, type CheckoutStatus, type CheckoutStatusResponse, type City, type CompleteOnboardingInput, type CompleteRecoveryResult, type Condition, type Conversation, type ConversationId, type ConversationSummary, type CreateAttachmentUploadInput, type CreateBaleInput, type CreateBaleOrderInput, type CreateListingInput, type CreateMessageBlockInput, type CreateMessageBlockResult, type CreateMessageReportInput, type CreateMessageReportResult, type CreateOrderInput, type CreateReportInput, type CreateReviewInput, type CreateStoreInput, type CursorPage, DEFAULT_SHARE_ORIGIN, 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 FollowedStore, type ForgotPasswordInput, IDBTokenStore, type InboxRealtimeEvent, type InitiateCheckoutInput, type InitiateCheckoutResponse, type KnownPaymentProvider, LISTING_STATUSES, type LegacyLinkResolution, type LegacyMessageArchiveSummary, type LegacyMessagePage, type LegacyMessageRecord, type LinkedAccount, type LinkedAccountProvider, type ListConversationsParams, type ListThreadMessagesParams, type ListThreadsParams, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageAttachment, type MessageAuthor, type MessageId, type MessagePage, type MessageReportReason, type MessageResponse, MessagesModule, type MessagesRealtimeConnection, type MessagesRealtimeEnvelope, type MessagesRealtimeEvent, type MessagesRealtimeOptions, type MessagesRealtimeState, type MessagesRealtimeTicket, type MessagingCapabilities, type MessagingCursor, type MessagingErrorCode, type MessagingIdempotentRequestOptions, type MessagingInboxes, type MessagingPerspective, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type OperatorPermissionGrant, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentAttemptStatus, type PaymentMethod, type PaymentMethodType, type PaymentProvider, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PendingPayoutApproval, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type ProviderId, type PublicKeyCredentialCreationOptionsJSON, type PublicKeyCredentialRequestOptionsJSON, type RaiseDisputeInput, type ReadCursorResult, RealtimeProtocolError, RealtimeUnavailableError, type RecoveryStatus, type RecoveryStatusResult, type RegenerateBackupCodesResult, type RegisterInput, type RegistrationResponseJSON, ReportsModule, type RequestOptions, type RequestRecoveryInput, type RequestRecoveryResult, type ResetPasswordInput, type ResolveDisputeInput, type ResolveThreadResult, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type RootSetupInput, type RootSetupResult, type SaveSearchInput, type SaveWholesaleStoreInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SellerType, type SendEmailInput, type SendMessageInput, type SendOtpInput, type SendThreadMessageInput, type SendThreadMessageResult, type Session, SettingsModule, type ShareUrlOptions, type SimilarListing, type StiEvent, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreResolveThreadInput, type StoreSettings, type StoreStats, type StoreSummary, StoresModule, type SubscriptionTier, type SystemStats, TWO_FACTOR_METHOD_TYPES, type ThreadCard, type ThreadId, type ThreadMessage, type ThreadSubject, type ThreadSystemEvent, type ThreadTimelineItem, type ThreadTimelineItemId, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorMethod, type TwoFactorMethodType, type TwoFactorRequired, type UpdateBusinessInput, type UpdateConversationPreferencesInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UpdateThreadPreferencesInput, UploadsModule, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WebSocketCloseEventLike, type WebSocketFactory, type WebSocketLike, type WebSocketMessageEventLike, type WholesaleDepot, type WholesaleFeedParams, WholesaleModule, type WholesaleStore, type WishlistListing, WishlistsModule, baleShareUrl, createTokenStore, isMessagingAPIError, listingShareUrl, storeShareUrl };
+export { APIClient, APIError, type APIErrorResponse, type Add2FAMethodInput, type Add2FAMethodResult, type AddAddressInput, type AddDepotInput, type AddPaymentMethodInput, type Address, type AdminAuditEntry, type AdminAuthStrength, type AdminListingItem, AdminModule, type AdminOperator, type AdminOrderDetail, type AdminOrderListItem, type AdminPayoutItem, type AdminPermission, type AdminPermissionDescription, type AdminRecoveryEvent, type AdminRecoveryRequest, type AdminReport, type AdminRolePreset, type AdminStoreDetail, type AdminStoreListItem, type AdminUserDetail, type AdminUserListItem, type AdminVaziOutfit, type AdminVerificationItem, type AdminWholesalePendingStore, type ApiResponse, type AttachmentDownloadAuthorization, type AttachmentUploadAuthorization, type AttachmentUploadBody, type AttachmentUploadState, type AttachmentUploadStatus, type AuthCapabilities, AuthModule, type AuthTokens, type AuthenticationResponseJSON, BALE_ORDER_STATUSES, type Bale, type BaleDetail, type BaleFeedItem, type BaleFulfillment, type BaleGrade, type BaleImageUploadResult, type BaleOrder, type BaleOrderEvent, type BaleOrderStatus, type BaleType, type BecomeBaleSellerInput, type BecomeSellerInput, type BlockedIp, type Business, type BusinessType, BusinessesModule, type BuyerResolveThreadInput, type BuyerSummary, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type CheckoutNextAction, type CheckoutOrder, type CheckoutPaymentMethod, type CheckoutStatus, type CheckoutStatusResponse, type City, type CompleteOnboardingInput, type CompleteRecoveryResult, type Condition, type Conversation, type ConversationId, type ConversationSummary, type CreateAttachmentUploadInput, type CreateBaleInput, type CreateBaleOrderInput, type CreateListingInput, type CreateMessageBlockInput, type CreateMessageBlockResult, type CreateMessageReportInput, type CreateMessageReportResult, type CreateOrderInput, type CreateReportInput, type CreateReviewInput, type CreateStoreInput, type CursorPage, DEFAULT_SHARE_ORIGIN, 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 FollowedStore, type ForgotPasswordInput, IDBTokenStore, type InboxRealtimeEvent, type InitiateCheckoutInput, type InitiateCheckoutResponse, type KnownPaymentProvider, LISTING_STATUSES, type LegacyLinkResolution, type LegacyMessageArchiveSummary, type LegacyMessagePage, type LegacyMessageRecord, type LinkedAccount, type LinkedAccountProvider, type ListConversationsParams, type ListThreadMessagesParams, type ListThreadsParams, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageAttachment, type MessageAuthor, type MessageId, type MessagePage, type MessageReportReason, type MessageResponse, MessagesModule, type MessagesRealtimeConnection, type MessagesRealtimeEnvelope, type MessagesRealtimeEvent, type MessagesRealtimeOptions, type MessagesRealtimeState, type MessagesRealtimeTicket, type MessagingBlockInput, type MessagingBlockRemovedResult, type MessagingBlockResult, type MessagingCapabilities, type MessagingCursor, type MessagingErrorCode, type MessagingIdempotentRequestOptions, type MessagingInboxes, type MessagingPerspective, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type OperatorPermissionGrant, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentAttemptStatus, type PaymentMethod, type PaymentMethodType, type PaymentProvider, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PendingPayoutApproval, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type ProviderId, type PublicKeyCredentialCreationOptionsJSON, type PublicKeyCredentialRequestOptionsJSON, type RaiseDisputeInput, type ReadCursorResult, RealtimeProtocolError, RealtimeUnavailableError, type RecoveryStatus, type RecoveryStatusResult, type RegenerateBackupCodesResult, type RegisterInput, type RegistrationResponseJSON, ReportsModule, type RequestOptions, type RequestRecoveryInput, type RequestRecoveryResult, type ResetPasswordInput, type ResolveDisputeInput, type ResolveThreadResult, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type RootSetupInput, type RootSetupResult, type SaveSearchInput, type SaveWholesaleStoreInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SellerType, type SendEmailInput, type SendMessageInput, type SendOtpInput, type SendThreadMessageInput, type SendThreadMessageResult, type Session, SettingsModule, type ShareUrlOptions, type SimilarListing, type StiEvent, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreResolveThreadInput, type StoreSettings, type StoreStats, type StoreSummary, StoresModule, type SubscriptionTier, type SystemStats, TWO_FACTOR_METHOD_TYPES, type ThreadCard, type ThreadId, type ThreadMessage, type ThreadSubject, type ThreadSystemEvent, type ThreadTimelineItem, type ThreadTimelineItemId, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorMethod, type TwoFactorMethodType, type TwoFactorRequired, type UpdateBusinessInput, type UpdateConversationPreferencesInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UpdateThreadPreferencesInput, UploadsModule, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WebSocketCloseEventLike, type WebSocketFactory, type WebSocketLike, type WebSocketMessageEventLike, type WholesaleAnalytics, type WholesaleDepot, type WholesaleFeedParams, WholesaleModule, type WholesaleStore, type WishlistListing, WishlistsModule, baleShareUrl, createTokenStore, isMessagingAPIError, listingShareUrl, storeShareUrl };

package/dist/index.d.ts

@@ -818,6 +818,28 @@ interface LegacyMessagePage {
     /** Whether older history remains. */
     has_older: boolean;
 }
+/**
+ * Create a bilateral block from a v2 inbox perspective. A buyer blocks a store by `store_id`;
+ * a store blocks a buyer by `buyer_id`.
+ */
+type MessagingBlockInput = {
+    store_id: string;
+    reason?: string;
+} | {
+    buyer_id: string;
+    reason?: string;
+};
+/** Idempotent block result. */
+interface MessagingBlockResult {
+    id: string;
+    active: boolean;
+    deduplicated: boolean;
+}
+/** Result of removing a block. */
+interface MessagingBlockRemovedResult {
+    ok: true;
+    active: false;
+}
 
 interface BlockedIp {
     ip: string;
@@ -1642,6 +1664,43 @@ interface CreateBaleOrderInput {
     qty?: number;
     fulfillment: BaleFulfillment;
 }
+/**
+ * Result of uploading a bale image directly via multipart/form-data. Mirrors the listing image
+ * upload result; the presign step reuses `PresignImageResponse` from the listings types.
+ */
+interface BaleImageUploadResult {
+    r2_key: string;
+    image_id: string;
+    url: string;
+}
+/**
+ * Performance analytics for a wholesale store. Mirrors the retail `StoreAnalytics` shape where it
+ * applies (revenue series, order breakdown) and adapts the rest to bales (top bales, bale totals).
+ */
+interface WholesaleAnalytics {
+    revenue: {
+        date: string;
+        revenue: number;
+        orders: number;
+    }[];
+    orders_breakdown: {
+        date: string;
+        completed: number;
+        pending: number;
+        cancelled: number;
+    }[];
+    top_bales: {
+        bale_id: string;
+        title: string;
+        orders: number;
+        revenue: number;
+    }[];
+    totals: {
+        bales: number;
+        orders: number;
+        revenue: number;
+    };
+}
 
 interface StkPushInput {
     order_id: string;
@@ -2745,37 +2804,15 @@ declare class VaziModule {
 declare class MessagesModule {
     private readonly client;
     constructor(client: APIClient);
-    /** @deprecated Use listConversations or listStoreConversations. Context fields are non-authoritative server-validated hints. */
-    list(storeId?: string, options?: RequestOptions): Promise<{
-        data: Conversation[];
-    }>;
-    /** @deprecated Resolve a v2 thread and call listThreadMessages. */
-    getThread(partnerId: string, storeId?: string, options?: RequestOptions): Promise<{
-        data: Message[];
-    }>;
-    /** @deprecated Use sendThreadMessage. Receiver and context fields are hints validated by the server. */
-    send(input: SendMessageInput, options?: RequestOptions): Promise<{
-        id: string;
-    }>;
-    /** @deprecated Use advanceThreadReadCursor for precise monotonic state. */
-    markRead(partnerId: string, storeId?: string, options?: RequestOptions): Promise<{
-        ok: true;
-    }>;
-    /** @deprecated Use managed messaging realtime. */
-    connectTyping(partnerId: string): WebSocket;
-    /** @deprecated Use managed messaging realtime. */
-    connectInbox(): WebSocket;
-    /** Create a legacy inbox socket only after hydrating/refreshing the access token. */
-    connectInboxFresh(options?: RequestOptions): Promise<WebSocketLike>;
-    /** Create a report for a message or conversation. */
-    createReport(input: CreateMessageReportInput, options?: RequestOptions): Promise<CreateMessageReportResult>;
-    /** Create an idempotent bilateral buyer/store relationship block. */
-    createBlock(input: CreateMessageBlockInput, options?: RequestOptions): Promise<CreateMessageBlockResult>;
-    /** Remove a block created by the current perspective. */
-    removeBlock(blockId: string, options?: RequestOptions): Promise<{
-        ok: true;
-        active: false;
-    }>;
+    /**
+     * Create a bilateral block from a v2 inbox perspective. A buyer blocks a store (`{ store_id }`);
+     * a store blocks a buyer (`{ buyer_id }`). Idempotent.
+     */
+    createMessagingBlock(perspective: MessagingPerspective, input: MessagingBlockInput, options?: RequestOptions): Promise<MessagingBlockResult>;
+    /** Remove a block the current perspective created. */
+    removeMessagingBlock(perspective: MessagingPerspective, blockId: string, options?: RequestOptions): Promise<MessagingBlockRemovedResult>;
+    /** File a message or conversation report from a v2 inbox perspective. Idempotent on open reports. */
+    createMessagingReport(perspective: MessagingPerspective, input: CreateMessageReportInput, options?: RequestOptions): Promise<CreateMessageReportResult>;
     /** Discover server messaging capabilities. */
     getMessagingCapabilities(options?: RequestOptions): Promise<MessagingCapabilities>;
     /** List buyer and represented-store inbox perspectives. */
@@ -3541,6 +3578,25 @@ declare class WholesaleModule {
     myBales(options?: RequestOptions): Promise<{
         data: Bale[];
     }>;
+    /**
+     * Presign a bale image upload slot (requires the owning wholesale store).
+     *
+     * @param baleId - The bale to attach the image to
+     * @param index - The slot index; slot 0 is the cover
+     * @returns The storage key and image id for the slot
+     * @throws {APIError} On network or server errors
+     */
+    presignBaleImage(baleId: string, index: number, options?: RequestOptions): Promise<PresignImageResponse>;
+    /**
+     * Upload a bale image file directly. Uses multipart/form-data. Slot 0 is the cover.
+     *
+     * @param baleId - The bale to attach the image to
+     * @param file - The image file as a `Blob` (React Native passes a `{ uri, name, type }` part)
+     * @param index - The slot index; slot 0 is the cover
+     * @returns The storage key, image id, and public URL
+     * @throws {APIError} On network or server errors
+     */
+    uploadBaleImage(baleId: string, file: Blob, index: number, options?: RequestOptions): Promise<BaleImageUploadResult>;
     /** Browse the wholesale bale feed (public). */
     wholesaleFeed(params?: WholesaleFeedParams, options?: RequestOptions): Promise<{
         data: BaleFeedItem[];
@@ -3569,6 +3625,22 @@ declare class WholesaleModule {
         ok: true;
         status: BaleOrderStatus;
     }>;
+    /**
+     * Get performance analytics for the current user's wholesale store (bale_seller only).
+     *
+     * The wholesale store is resolved server-side from the session, so no store id is passed — the
+     * same way `getWholesaleStore`, `myBales`, and `incomingBaleOrders` work.
+     *
+     * @param period - Optional granularity; defaults to the server's default window
+     * @returns Revenue series, order breakdown, top bales, and totals
+     * @throws {APIError} On network or server errors
+     *
+     * @example
+     * ```typescript
+     * const analytics = await sdk.wholesale.getAnalytics('weekly')
+     * ```
+     */
+    getAnalytics(period?: 'daily' | 'weekly' | 'monthly', options?: RequestOptions): Promise<WholesaleAnalytics>;
 }
 
 /**
@@ -3646,4 +3718,4 @@ declare class MitumbaClient {
     isAuthenticated(): Promise<boolean>;
 }
 
-export { APIClient, APIError, type APIErrorResponse, type Add2FAMethodInput, type Add2FAMethodResult, type AddAddressInput, type AddDepotInput, type AddPaymentMethodInput, type Address, type AdminAuditEntry, type AdminAuthStrength, type AdminListingItem, AdminModule, type AdminOperator, type AdminOrderDetail, type AdminOrderListItem, type AdminPayoutItem, type AdminPermission, type AdminPermissionDescription, type AdminRecoveryEvent, type AdminRecoveryRequest, type AdminReport, type AdminRolePreset, type AdminStoreDetail, type AdminStoreListItem, type AdminUserDetail, type AdminUserListItem, type AdminVaziOutfit, type AdminVerificationItem, type AdminWholesalePendingStore, type ApiResponse, type AttachmentDownloadAuthorization, type AttachmentUploadAuthorization, type AttachmentUploadBody, type AttachmentUploadState, type AttachmentUploadStatus, type AuthCapabilities, AuthModule, type AuthTokens, type AuthenticationResponseJSON, BALE_ORDER_STATUSES, type Bale, type BaleDetail, type BaleFeedItem, type BaleFulfillment, type BaleGrade, type BaleOrder, type BaleOrderEvent, type BaleOrderStatus, type BaleType, type BecomeBaleSellerInput, type BecomeSellerInput, type BlockedIp, type Business, type BusinessType, BusinessesModule, type BuyerResolveThreadInput, type BuyerSummary, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type CheckoutNextAction, type CheckoutOrder, type CheckoutPaymentMethod, type CheckoutStatus, type CheckoutStatusResponse, type City, type CompleteOnboardingInput, type CompleteRecoveryResult, type Condition, type Conversation, type ConversationId, type ConversationSummary, type CreateAttachmentUploadInput, type CreateBaleInput, type CreateBaleOrderInput, type CreateListingInput, type CreateMessageBlockInput, type CreateMessageBlockResult, type CreateMessageReportInput, type CreateMessageReportResult, type CreateOrderInput, type CreateReportInput, type CreateReviewInput, type CreateStoreInput, type CursorPage, DEFAULT_SHARE_ORIGIN, 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 FollowedStore, type ForgotPasswordInput, IDBTokenStore, type InboxRealtimeEvent, type InitiateCheckoutInput, type InitiateCheckoutResponse, type KnownPaymentProvider, LISTING_STATUSES, type LegacyLinkResolution, type LegacyMessageArchiveSummary, type LegacyMessagePage, type LegacyMessageRecord, type LinkedAccount, type LinkedAccountProvider, type ListConversationsParams, type ListThreadMessagesParams, type ListThreadsParams, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageAttachment, type MessageAuthor, type MessageId, type MessagePage, type MessageReportReason, type MessageResponse, MessagesModule, type MessagesRealtimeConnection, type MessagesRealtimeEnvelope, type MessagesRealtimeEvent, type MessagesRealtimeOptions, type MessagesRealtimeState, type MessagesRealtimeTicket, type MessagingCapabilities, type MessagingCursor, type MessagingErrorCode, type MessagingIdempotentRequestOptions, type MessagingInboxes, type MessagingPerspective, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type OperatorPermissionGrant, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentAttemptStatus, type PaymentMethod, type PaymentMethodType, type PaymentProvider, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PendingPayoutApproval, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type ProviderId, type PublicKeyCredentialCreationOptionsJSON, type PublicKeyCredentialRequestOptionsJSON, type RaiseDisputeInput, type ReadCursorResult, RealtimeProtocolError, RealtimeUnavailableError, type RecoveryStatus, type RecoveryStatusResult, type RegenerateBackupCodesResult, type RegisterInput, type RegistrationResponseJSON, ReportsModule, type RequestOptions, type RequestRecoveryInput, type RequestRecoveryResult, type ResetPasswordInput, type ResolveDisputeInput, type ResolveThreadResult, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type RootSetupInput, type RootSetupResult, type SaveSearchInput, type SaveWholesaleStoreInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SellerType, type SendEmailInput, type SendMessageInput, type SendOtpInput, type SendThreadMessageInput, type SendThreadMessageResult, type Session, SettingsModule, type ShareUrlOptions, type SimilarListing, type StiEvent, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreResolveThreadInput, type StoreSettings, type StoreStats, type StoreSummary, StoresModule, type SubscriptionTier, type SystemStats, TWO_FACTOR_METHOD_TYPES, type ThreadCard, type ThreadId, type ThreadMessage, type ThreadSubject, type ThreadSystemEvent, type ThreadTimelineItem, type ThreadTimelineItemId, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorMethod, type TwoFactorMethodType, type TwoFactorRequired, type UpdateBusinessInput, type UpdateConversationPreferencesInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UpdateThreadPreferencesInput, UploadsModule, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WebSocketCloseEventLike, type WebSocketFactory, type WebSocketLike, type WebSocketMessageEventLike, type WholesaleDepot, type WholesaleFeedParams, WholesaleModule, type WholesaleStore, type WishlistListing, WishlistsModule, baleShareUrl, createTokenStore, isMessagingAPIError, listingShareUrl, storeShareUrl };
+export { APIClient, APIError, type APIErrorResponse, type Add2FAMethodInput, type Add2FAMethodResult, type AddAddressInput, type AddDepotInput, type AddPaymentMethodInput, type Address, type AdminAuditEntry, type AdminAuthStrength, type AdminListingItem, AdminModule, type AdminOperator, type AdminOrderDetail, type AdminOrderListItem, type AdminPayoutItem, type AdminPermission, type AdminPermissionDescription, type AdminRecoveryEvent, type AdminRecoveryRequest, type AdminReport, type AdminRolePreset, type AdminStoreDetail, type AdminStoreListItem, type AdminUserDetail, type AdminUserListItem, type AdminVaziOutfit, type AdminVerificationItem, type AdminWholesalePendingStore, type ApiResponse, type AttachmentDownloadAuthorization, type AttachmentUploadAuthorization, type AttachmentUploadBody, type AttachmentUploadState, type AttachmentUploadStatus, type AuthCapabilities, AuthModule, type AuthTokens, type AuthenticationResponseJSON, BALE_ORDER_STATUSES, type Bale, type BaleDetail, type BaleFeedItem, type BaleFulfillment, type BaleGrade, type BaleImageUploadResult, type BaleOrder, type BaleOrderEvent, type BaleOrderStatus, type BaleType, type BecomeBaleSellerInput, type BecomeSellerInput, type BlockedIp, type Business, type BusinessType, BusinessesModule, type BuyerResolveThreadInput, type BuyerSummary, CONDITIONS, type CartItem, CartModule, type Category, type ChangePasswordInput, type CheckoutNextAction, type CheckoutOrder, type CheckoutPaymentMethod, type CheckoutStatus, type CheckoutStatusResponse, type City, type CompleteOnboardingInput, type CompleteRecoveryResult, type Condition, type Conversation, type ConversationId, type ConversationSummary, type CreateAttachmentUploadInput, type CreateBaleInput, type CreateBaleOrderInput, type CreateListingInput, type CreateMessageBlockInput, type CreateMessageBlockResult, type CreateMessageReportInput, type CreateMessageReportResult, type CreateOrderInput, type CreateReportInput, type CreateReviewInput, type CreateStoreInput, type CursorPage, DEFAULT_SHARE_ORIGIN, 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 FollowedStore, type ForgotPasswordInput, IDBTokenStore, type InboxRealtimeEvent, type InitiateCheckoutInput, type InitiateCheckoutResponse, type KnownPaymentProvider, LISTING_STATUSES, type LegacyLinkResolution, type LegacyMessageArchiveSummary, type LegacyMessagePage, type LegacyMessageRecord, type LinkedAccount, type LinkedAccountProvider, type ListConversationsParams, type ListThreadMessagesParams, type ListThreadsParams, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, MemoryTokenStore, type Message, type MessageAttachment, type MessageAuthor, type MessageId, type MessagePage, type MessageReportReason, type MessageResponse, MessagesModule, type MessagesRealtimeConnection, type MessagesRealtimeEnvelope, type MessagesRealtimeEvent, type MessagesRealtimeOptions, type MessagesRealtimeState, type MessagesRealtimeTicket, type MessagingBlockInput, type MessagingBlockRemovedResult, type MessagingBlockResult, type MessagingCapabilities, type MessagingCursor, type MessagingErrorCode, type MessagingIdempotentRequestOptions, type MessagingInboxes, type MessagingPerspective, MitumbaClient, type MitumbaClientConfig, type MpesaInput, type Notification, type NotificationPref, type NotificationType, NotificationsModule, ORDER_STATUSES, type OperatorPermissionGrant, type Order, type OrderEvent, type OrderHistoryParams, type OrderStatus, OrdersModule, PAYMENT_STATUSES, type PaginatedResponse, PayModule, type PaymentAttemptStatus, type PaymentMethod, type PaymentMethodType, type PaymentProvider, type PaymentStatus, type PaymentStatusResponse, type PaystackInitResponse, type PaystackInput, type PendingPayoutApproval, type PhoneLoginInput, type PhoneRegisterInput, type PresignImageResponse, type ProviderId, type PublicKeyCredentialCreationOptionsJSON, type PublicKeyCredentialRequestOptionsJSON, type RaiseDisputeInput, type ReadCursorResult, RealtimeProtocolError, RealtimeUnavailableError, type RecoveryStatus, type RecoveryStatusResult, type RegenerateBackupCodesResult, type RegisterInput, type RegistrationResponseJSON, ReportsModule, type RequestOptions, type RequestRecoveryInput, type RequestRecoveryResult, type ResetPasswordInput, type ResolveDisputeInput, type ResolveThreadResult, type RespondDisputeInput, type Review, type ReviewableOrder, ReviewsModule, type RootSetupInput, type RootSetupResult, type SaveSearchInput, type SaveWholesaleStoreInput, type SearchHistoryItem, SearchModule, type SearchParams, type SearchResult, type SellerProfile, type SellerStorefront, type SellerType, type SendEmailInput, type SendMessageInput, type SendOtpInput, type SendThreadMessageInput, type SendThreadMessageResult, type Session, SettingsModule, type ShareUrlOptions, type SimilarListing, type StiEvent, type StkPushInput, type StkPushResponse, type Store, type StoreAnalytics, type StoreResolveThreadInput, type StoreSettings, type StoreStats, type StoreSummary, StoresModule, type SubscriptionTier, type SystemStats, TWO_FACTOR_METHOD_TYPES, type ThreadCard, type ThreadId, type ThreadMessage, type ThreadSubject, type ThreadSystemEvent, type ThreadTimelineItem, type ThreadTimelineItemId, type TokenStore, type TransitionOrderInput, type TrendingTerm, type TwoFactorMethod, type TwoFactorMethodType, type TwoFactorRequired, type UpdateBusinessInput, type UpdateConversationPreferencesInput, type UpdateListingInput, type UpdateProfileInput, type UpdateStoreInput, type UpdateThreadPreferencesInput, UploadsModule, type UserProfile, type VAZIOutfit, type VAZIOutfitDetail, type VAZIOutfitDetailItem, type VAZIOutfitItem, type VaziFeedParams, type VaziFeedResponse, VaziModule, type Verify2FAInput, type VerifyOtpInput, type WebSocketCloseEventLike, type WebSocketFactory, type WebSocketLike, type WebSocketMessageEventLike, type WholesaleAnalytics, type WholesaleDepot, type WholesaleFeedParams, WholesaleModule, type WholesaleStore, type WishlistListing, WishlistsModule, baleShareUrl, createTokenStore, isMessagingAPIError, listingShareUrl, storeShareUrl };

package/dist/index.js

@@ -1402,61 +1402,23 @@ var MessagesModule = class {
     this.client = client;
   }
   client;
-  /** @deprecated Use listConversations or listStoreConversations. Context fields are non-authoritative server-validated hints. */
-  async list(storeId, options) {
-    return this.client.get(
-      "/notify/messages",
-      storeId ? { store_id: storeId } : void 0,
-      options
-    );
+  /**
+   * Create a bilateral block from a v2 inbox perspective. A buyer blocks a store (`{ store_id }`);
+   * a store blocks a buyer (`{ buyer_id }`). Idempotent.
+   */
+  async createMessagingBlock(perspective, input, options) {
+    const value = await this.client.post(`${perspectiveBase(perspective)}/blocks`, input, options);
+    return unwrap(value, isIdentified);
   }
-  /** @deprecated Resolve a v2 thread and call listThreadMessages. */
-  async getThread(partnerId, storeId, options) {
-    return this.client.get(
-      `/notify/messages/${partnerId}`,
-      storeId ? { store_id: storeId } : void 0,
-      options
-    );
+  /** Remove a block the current perspective created. */
+  async removeMessagingBlock(perspective, blockId, options) {
+    const value = await this.client.delete(`${perspectiveBase(perspective)}/blocks/${encode(blockId)}`, void 0, options);
+    return unwrap(value, isRecord2);
   }
-  /** @deprecated Use sendThreadMessage. Receiver and context fields are hints validated by the server. */
-  async send(input, options) {
-    return this.client.post("/notify/messages", input, options);
-  }
-  /** @deprecated Use advanceThreadReadCursor for precise monotonic state. */
-  async markRead(partnerId, storeId, options) {
-    const path = storeId ? `/notify/messages/${partnerId}/read?store_id=${storeId}` : `/notify/messages/${partnerId}/read`;
-    return this.client.post(path, void 0, options);
-  }
-  /** @deprecated Use managed messaging realtime. */
-  connectTyping(partnerId) {
-    const token = this.client.getToken();
-    const wsUrl = this.client.getBaseUrl().replace(/^http/, "ws") + `/notify/messages/${partnerId}/ws?token=${token}`;
-    return new WebSocket(wsUrl);
-  }
-  /** @deprecated Use managed messaging realtime. */
-  connectInbox() {
-    const token = this.client.getToken();
-    const wsUrl = this.client.getBaseUrl().replace(/^http/, "ws") + `/notify/messages/inbox?token=${token}`;
-    return new WebSocket(wsUrl);
-  }
-  /** Create a legacy inbox socket only after hydrating/refreshing the access token. */
-  async connectInboxFresh(options) {
-    await this.client.ensureFreshToken(options);
-    const token = this.client.getToken() ?? "";
-    const wsUrl = this.client.getBaseUrl().replace(/^http/, "ws") + `/notify/messages/inbox?token=${encode(token)}`;
-    return this.client.createWebSocket(wsUrl, []);
-  }
-  /** Create a report for a message or conversation. */
-  async createReport(input, options) {
-    return this.client.post("/notify/messages/reports", input, options);
-  }
-  /** Create an idempotent bilateral buyer/store relationship block. */
-  async createBlock(input, options) {
-    return this.client.post("/notify/messages/blocks", input, options);
-  }
-  /** Remove a block created by the current perspective. */
-  async removeBlock(blockId, options) {
-    return this.client.delete(`/notify/messages/blocks/${encode(blockId)}`, void 0, options);
+  /** File a message or conversation report from a v2 inbox perspective. Idempotent on open reports. */
+  async createMessagingReport(perspective, input, options) {
+    const value = await this.client.post(`${perspectiveBase(perspective)}/reports`, input, options);
+    return unwrap(value, isIdentified);
   }
   /** Discover server messaging capabilities. */
   async getMessagingCapabilities(options) {
@@ -2315,6 +2277,33 @@ var WholesaleModule = class {
   async myBales(options) {
     return this.client.get("/listings/wholesale/mine/bales", void 0, options);
   }
+  // ── Bale Images ──
+  /**
+   * Presign a bale image upload slot (requires the owning wholesale store).
+   *
+   * @param baleId - The bale to attach the image to
+   * @param index - The slot index; slot 0 is the cover
+   * @returns The storage key and image id for the slot
+   * @throws {APIError} On network or server errors
+   */
+  async presignBaleImage(baleId, index, options) {
+    return this.client.post(`/listings/bales/${baleId}/images/presign`, { index }, options);
+  }
+  /**
+   * Upload a bale image file directly. Uses multipart/form-data. Slot 0 is the cover.
+   *
+   * @param baleId - The bale to attach the image to
+   * @param file - The image file as a `Blob` (React Native passes a `{ uri, name, type }` part)
+   * @param index - The slot index; slot 0 is the cover
+   * @returns The storage key, image id, and public URL
+   * @throws {APIError} On network or server errors
+   */
+  async uploadBaleImage(baleId, file, index, options) {
+    const formData = new FormData();
+    formData.append("file", file);
+    formData.append("index", String(index));
+    return this.client.post(`/listings/bales/${baleId}/images/upload`, formData, options);
+  }
   // ── Feed ──
   /** Browse the wholesale bale feed (public). */
   async wholesaleFeed(params, options) {
@@ -2345,6 +2334,25 @@ var WholesaleModule = class {
   async transitionBaleOrder(id, action, options) {
     return this.client.post(`/listings/bale-orders/${id}/transition`, { action }, options);
   }
+  // ── Analytics ──
+  /**
+   * Get performance analytics for the current user's wholesale store (bale_seller only).
+   *
+   * The wholesale store is resolved server-side from the session, so no store id is passed — the
+   * same way `getWholesaleStore`, `myBales`, and `incomingBaleOrders` work.
+   *
+   * @param period - Optional granularity; defaults to the server's default window
+   * @returns Revenue series, order breakdown, top bales, and totals
+   * @throws {APIError} On network or server errors
+   *
+   * @example
+   * ```typescript
+   * const analytics = await sdk.wholesale.getAnalytics('weekly')
+   * ```
+   */
+  async getAnalytics(period, options) {
+    return this.client.get("/listings/wholesale/analytics", period ? { period } : void 0, options);
+  }
 };
 
 // src/types/auth.ts