@mitumba/sdk 1.11.0 → 1.12.0

package/dist/index.d.mts

@@ -1,3 +1,29 @@
+interface TokenStore {
+    getAccessToken(): Promise<string | null>;
+    getRefreshToken(): Promise<string | null>;
+    setTokens(access: string, refresh: string): Promise<void>;
+    clear(): Promise<void>;
+}
+declare class MemoryTokenStore implements TokenStore {
+    private accessToken;
+    private refreshToken;
+    getAccessToken(): Promise<string | null>;
+    getRefreshToken(): Promise<string | null>;
+    setTokens(access: string, refresh: string): Promise<void>;
+    clear(): Promise<void>;
+}
+declare class IDBTokenStore implements TokenStore {
+    private dbPromise;
+    private openDB;
+    private get;
+    getAccessToken(): Promise<string | null>;
+    getRefreshToken(): Promise<string | null>;
+    setTokens(access: string, refresh: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/** Creates IDBTokenStore if indexedDB is available, otherwise MemoryTokenStore. */
+declare function createTokenStore(): TokenStore;
+
 interface AuthTokens {
     access_token: string;
     refresh_token: string;
@@ -649,6 +675,16 @@ interface MitumbaClientConfig {
         token: string;
         refreshToken: string;
     }) => void;
+    /**
+     * Callback invoked when the refresh token is invalid/expired and the user
+     * needs to re-authenticate. Only fires when session is truly dead.
+     */
+    onAuthExpired?: () => void;
+    /**
+     * Custom token store for persisting tokens. Defaults to IndexedDB in browsers,
+     * in-memory elsewhere. Pass your own implementation for custom persistence.
+     */
+    tokenStore?: TokenStore;
 }
 interface APIErrorResponse {
     error: string;
@@ -675,13 +711,23 @@ declare class APIError extends Error {
 }
 declare class APIClient {
     private config;
+    private tokenStore;
     private isRefreshing;
     private refreshPromise;
     constructor(config: MitumbaClientConfig);
-    setToken(token: string, refreshToken?: string): void;
+    setToken(token: string, refreshToken?: string): Promise<void>;
     getToken(): string | undefined;
     getBaseUrl(): string;
-    clearToken(): void;
+    clearToken(): Promise<void>;
+    /**
+     * Check if user has a stored session (access or refresh token available).
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Hydrate tokens from the store into memory (call on app boot).
+     */
+    hydrate(): Promise<void>;
+    private ensureFreshToken;
     private request;
     private handleTokenRefresh;
     get<T>(path: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<T>;
@@ -1350,6 +1396,14 @@ declare class MitumbaClient {
      * Clear the current tokens.
      */
     clearToken(): void;
+    /**
+     * Hydrate tokens from persistent store (call on app boot).
+     */
+    hydrate(): Promise<void>;
+    /**
+     * Check if user has a stored session.
+     */
+    isAuthenticated(): Promise<boolean>;
 }
 
-export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AuthModule, type AuthTokens, type BecomeSellerInput, 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, LISTING_STATUSES, type LinkedAccount, type LinkedAccountProvider, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, 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 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 };
+export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AuthModule, type AuthTokens, type BecomeSellerInput, 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 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

@@ -1,3 +1,29 @@
+interface TokenStore {
+    getAccessToken(): Promise<string | null>;
+    getRefreshToken(): Promise<string | null>;
+    setTokens(access: string, refresh: string): Promise<void>;
+    clear(): Promise<void>;
+}
+declare class MemoryTokenStore implements TokenStore {
+    private accessToken;
+    private refreshToken;
+    getAccessToken(): Promise<string | null>;
+    getRefreshToken(): Promise<string | null>;
+    setTokens(access: string, refresh: string): Promise<void>;
+    clear(): Promise<void>;
+}
+declare class IDBTokenStore implements TokenStore {
+    private dbPromise;
+    private openDB;
+    private get;
+    getAccessToken(): Promise<string | null>;
+    getRefreshToken(): Promise<string | null>;
+    setTokens(access: string, refresh: string): Promise<void>;
+    clear(): Promise<void>;
+}
+/** Creates IDBTokenStore if indexedDB is available, otherwise MemoryTokenStore. */
+declare function createTokenStore(): TokenStore;
+
 interface AuthTokens {
     access_token: string;
     refresh_token: string;
@@ -649,6 +675,16 @@ interface MitumbaClientConfig {
         token: string;
         refreshToken: string;
     }) => void;
+    /**
+     * Callback invoked when the refresh token is invalid/expired and the user
+     * needs to re-authenticate. Only fires when session is truly dead.
+     */
+    onAuthExpired?: () => void;
+    /**
+     * Custom token store for persisting tokens. Defaults to IndexedDB in browsers,
+     * in-memory elsewhere. Pass your own implementation for custom persistence.
+     */
+    tokenStore?: TokenStore;
 }
 interface APIErrorResponse {
     error: string;
@@ -675,13 +711,23 @@ declare class APIError extends Error {
 }
 declare class APIClient {
     private config;
+    private tokenStore;
     private isRefreshing;
     private refreshPromise;
     constructor(config: MitumbaClientConfig);
-    setToken(token: string, refreshToken?: string): void;
+    setToken(token: string, refreshToken?: string): Promise<void>;
     getToken(): string | undefined;
     getBaseUrl(): string;
-    clearToken(): void;
+    clearToken(): Promise<void>;
+    /**
+     * Check if user has a stored session (access or refresh token available).
+     */
+    isAuthenticated(): Promise<boolean>;
+    /**
+     * Hydrate tokens from the store into memory (call on app boot).
+     */
+    hydrate(): Promise<void>;
+    private ensureFreshToken;
     private request;
     private handleTokenRefresh;
     get<T>(path: string, params?: Record<string, string | number | boolean | undefined>, options?: RequestOptions): Promise<T>;
@@ -1350,6 +1396,14 @@ declare class MitumbaClient {
      * Clear the current tokens.
      */
     clearToken(): void;
+    /**
+     * Hydrate tokens from persistent store (call on app boot).
+     */
+    hydrate(): Promise<void>;
+    /**
+     * Check if user has a stored session.
+     */
+    isAuthenticated(): Promise<boolean>;
 }
 
-export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AuthModule, type AuthTokens, type BecomeSellerInput, 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, LISTING_STATUSES, type LinkedAccount, type LinkedAccountProvider, type Listing, type ListingImage, type ListingStatus, type ListingsFeedParams, ListingsModule, type LoginInput, MailerModule, type MailerTemplate, 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 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 };
+export { APIClient, APIError, type APIErrorResponse, type AddAddressInput, type AddPaymentMethodInput, type Address, AuthModule, type AuthTokens, type BecomeSellerInput, 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 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

@@ -1,5 +1,84 @@
 'use strict';
 
+// src/token-store.ts
+var MemoryTokenStore = class {
+  accessToken = null;
+  refreshToken = null;
+  async getAccessToken() {
+    return this.accessToken;
+  }
+  async getRefreshToken() {
+    return this.refreshToken;
+  }
+  async setTokens(access, refresh) {
+    this.accessToken = access;
+    this.refreshToken = refresh;
+  }
+  async clear() {
+    this.accessToken = null;
+    this.refreshToken = null;
+  }
+};
+var DB_NAME = "mitumba_sdk";
+var STORE_NAME = "tokens";
+var KEY = "auth";
+var IDBTokenStore = class {
+  dbPromise = null;
+  openDB() {
+    if (this.dbPromise) return this.dbPromise;
+    this.dbPromise = new Promise((resolve, reject) => {
+      const request = indexedDB.open(DB_NAME, 1);
+      request.onupgradeneeded = () => {
+        request.result.createObjectStore(STORE_NAME);
+      };
+      request.onsuccess = () => resolve(request.result);
+      request.onerror = () => reject(request.error);
+    });
+    return this.dbPromise;
+  }
+  async get() {
+    const db = await this.openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, "readonly");
+      const req = tx.objectStore(STORE_NAME).get(KEY);
+      req.onsuccess = () => resolve(req.result || null);
+      req.onerror = () => reject(req.error);
+    });
+  }
+  async getAccessToken() {
+    const data = await this.get();
+    return data?.access ?? null;
+  }
+  async getRefreshToken() {
+    const data = await this.get();
+    return data?.refresh ?? null;
+  }
+  async setTokens(access, refresh) {
+    const db = await this.openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, "readwrite");
+      const req = tx.objectStore(STORE_NAME).put({ access, refresh }, KEY);
+      req.onsuccess = () => resolve();
+      req.onerror = () => reject(req.error);
+    });
+  }
+  async clear() {
+    const db = await this.openDB();
+    return new Promise((resolve, reject) => {
+      const tx = db.transaction(STORE_NAME, "readwrite");
+      const req = tx.objectStore(STORE_NAME).delete(KEY);
+      req.onsuccess = () => resolve();
+      req.onerror = () => reject(req.error);
+    });
+  }
+};
+function createTokenStore() {
+  if (typeof indexedDB !== "undefined") {
+    return new IDBTokenStore();
+  }
+  return new MemoryTokenStore();
+}
+
 // src/client.ts
 var APIError = class extends Error {
   code;
@@ -13,18 +92,33 @@ var APIError = class extends Error {
     this.details = data.details;
   }
 };
+function isExpiringSoon(token, thresholdSeconds) {
+  try {
+    const payload = JSON.parse(atob(token.split(".")[1]));
+    const exp = payload.exp;
+    return exp - Date.now() / 1e3 < thresholdSeconds;
+  } catch {
+    return false;
+  }
+}
 var APIClient = class {
   config;
+  tokenStore;
   isRefreshing = false;
   refreshPromise = null;
   constructor(config) {
     this.config = config;
+    this.tokenStore = config.tokenStore ?? createTokenStore();
+    if (config.token) {
+      this.tokenStore.setTokens(config.token, config.refreshToken ?? "");
+    }
   }
-  setToken(token, refreshToken) {
+  async setToken(token, refreshToken) {
     this.config.token = token;
     if (refreshToken) {
       this.config.refreshToken = refreshToken;
     }
+    await this.tokenStore.setTokens(token, refreshToken ?? this.config.refreshToken ?? "");
   }
   getToken() {
     return this.config.token;
@@ -32,11 +126,44 @@ var APIClient = class {
   getBaseUrl() {
     return this.config.baseUrl;
   }
-  clearToken() {
+  async clearToken() {
     this.config.token = void 0;
     this.config.refreshToken = void 0;
+    await this.tokenStore.clear();
+  }
+  /**
+   * Check if user has a stored session (access or refresh token available).
+   */
+  async isAuthenticated() {
+    const access = this.config.token ?? await this.tokenStore.getAccessToken();
+    if (access) return true;
+    const refresh = await this.tokenStore.getRefreshToken();
+    return !!refresh;
+  }
+  /**
+   * Hydrate tokens from the store into memory (call on app boot).
+   */
+  async hydrate() {
+    const access = await this.tokenStore.getAccessToken();
+    const refresh = await this.tokenStore.getRefreshToken();
+    if (access) this.config.token = access;
+    if (refresh) this.config.refreshToken = refresh;
+  }
+  async ensureFreshToken() {
+    if (!this.config.token) {
+      const stored = await this.tokenStore.getAccessToken();
+      if (stored) this.config.token = stored;
+      const refresh = await this.tokenStore.getRefreshToken();
+      if (refresh) this.config.refreshToken = refresh;
+    }
+    if (this.config.token && isExpiringSoon(this.config.token, 60) && this.config.refreshToken) {
+      await this.handleTokenRefresh();
+    }
   }
   async request(method, path, body, params, options) {
+    if (!path.includes("/auth/refresh") && !path.includes("/auth/login") && !path.includes("/auth/register")) {
+      await this.ensureFreshToken();
+    }
     const url = new URL(path, this.config.baseUrl);
     if (params) {
       for (const [key, value] of Object.entries(params)) {
@@ -96,9 +223,16 @@ var APIClient = class {
       break;
     }
     if (response.status === 401 && this.config.refreshToken && !path.includes("/auth/refresh")) {
-      await this.handleTokenRefresh();
-      headers.set("Authorization", `Bearer ${this.config.token}`);
-      response = await fetch(url.toString(), { ...init, headers });
+      try {
+        await this.handleTokenRefresh();
+        headers.set("Authorization", `Bearer ${this.config.token}`);
+        response = await fetch(url.toString(), { ...init, headers });
+      } catch {
+        if (this.config.onAuthExpired) {
+          this.config.onAuthExpired();
+        }
+        throw new APIError(401, { error: "session_expired", message: "Session expired. Please log in again." });
+      }
     }
     if (!response.ok) {
       let errorData;
@@ -131,13 +265,15 @@ var APIClient = class {
           throw new Error("Refresh failed");
         }
         const data = await response.json();
-        this.setToken(data.access_token, data.refresh_token);
+        this.config.token = data.access_token;
+        this.config.refreshToken = data.refresh_token;
+        await this.tokenStore.setTokens(data.access_token, data.refresh_token);
         if (this.config.onTokenRefresh) {
           this.config.onTokenRefresh({ token: data.access_token, refreshToken: data.refresh_token });
         }
       } catch (err) {
-        this.clearToken();
-        throw new APIError(401, { error: "token_expired", message: "Session expired. Please log in again." });
+        await this.clearToken();
+        throw err;
       } finally {
         this.isRefreshing = false;
         this.refreshPromise = null;
@@ -1008,6 +1144,18 @@ var MitumbaClient = class {
   clearToken() {
     this.api.clearToken();
   }
+  /**
+   * Hydrate tokens from persistent store (call on app boot).
+   */
+  hydrate() {
+    return this.api.hydrate();
+  }
+  /**
+   * Check if user has a stored session.
+   */
+  isAuthenticated() {
+    return this.api.isAuthenticated();
+  }
 };
 
 exports.APIClient = APIClient;
@@ -1016,9 +1164,11 @@ exports.AuthModule = AuthModule;
 exports.BusinessesModule = BusinessesModule;
 exports.CONDITIONS = CONDITIONS;
 exports.CartModule = CartModule;
+exports.IDBTokenStore = IDBTokenStore;
 exports.LISTING_STATUSES = LISTING_STATUSES;
 exports.ListingsModule = ListingsModule;
 exports.MailerModule = MailerModule;
+exports.MemoryTokenStore = MemoryTokenStore;
 exports.MessagesModule = MessagesModule;
 exports.MitumbaClient = MitumbaClient;
 exports.NotificationsModule = NotificationsModule;
@@ -1032,5 +1182,6 @@ exports.SettingsModule = SettingsModule;
 exports.StoresModule = StoresModule;
 exports.VaziModule = VaziModule;
 exports.WishlistsModule = WishlistsModule;
+exports.createTokenStore = createTokenStore;
 //# sourceMappingURL=index.js.map
 //# sourceMappingURL=index.js.map