@cimplify/sdk 0.3.4 → 0.3.6

package/dist/index.mjs

@@ -153,9 +153,6 @@ var CatalogueQueries = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // PRODUCTS
-  // --------------------------------------------------------------------------
   async getProducts(options) {
     let query2 = "products";
     const filters = [];
@@ -204,9 +201,6 @@ var CatalogueQueries = class {
     }
     return ok(result.value[0]);
   }
-  // --------------------------------------------------------------------------
-  // VARIANTS
-  // --------------------------------------------------------------------------
   async getVariants(productId) {
     return safe(this.client.query(`products.${productId}.variants`));
   }
@@ -230,15 +224,9 @@ var CatalogueQueries = class {
   async getVariantById(productId, variantId) {
     return safe(this.client.query(`products.${productId}.variant.${variantId}`));
   }
-  // --------------------------------------------------------------------------
-  // ADD-ONS
-  // --------------------------------------------------------------------------
   async getAddOns(productId) {
     return safe(this.client.query(`products.${productId}.add_ons`));
   }
-  // --------------------------------------------------------------------------
-  // CATEGORIES
-  // --------------------------------------------------------------------------
   async getCategories() {
     return safe(this.client.query("categories"));
   }
@@ -258,9 +246,6 @@ var CatalogueQueries = class {
   async getCategoryProducts(categoryId) {
     return safe(this.client.query(`products[?(@.category_id=='${categoryId}')]`));
   }
-  // --------------------------------------------------------------------------
-  // COLLECTIONS
-  // --------------------------------------------------------------------------
   async getCollections() {
     return safe(this.client.query("collections"));
   }
@@ -285,9 +270,6 @@ var CatalogueQueries = class {
       this.client.query(`collections[?(@.name contains '${query2}')]#limit(${limit})`)
     );
   }
-  // --------------------------------------------------------------------------
-  // BUNDLES
-  // --------------------------------------------------------------------------
   async getBundles() {
     return safe(this.client.query("bundles"));
   }
@@ -309,9 +291,6 @@ var CatalogueQueries = class {
       this.client.query(`bundles[?(@.name contains '${query2}')]#limit(${limit})`)
     );
   }
-  // --------------------------------------------------------------------------
-  // COMPOSITES (Build-Your-Own)
-  // --------------------------------------------------------------------------
   async getComposites(options) {
     let query2 = "composites";
     if (options?.limit) {
@@ -334,9 +313,6 @@ var CatalogueQueries = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // SEARCH
-  // --------------------------------------------------------------------------
   async search(query2, options) {
     const limit = options?.limit ?? 20;
     let searchQuery = `products[?(@.name contains '${query2}')]`;
@@ -355,9 +331,6 @@ var CatalogueQueries = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MENU (Restaurant-specific)
-  // --------------------------------------------------------------------------
   async getMenu(options) {
     let query2 = "menu";
     if (options?.category) {
@@ -395,13 +368,6 @@ var CartOperations = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // CART QUERIES
-  // --------------------------------------------------------------------------
-  /**
-   * Get the enriched cart with product names, images, and details.
-   * This is the main method for storefront display.
-   */
   async get() {
     return safe2(this.client.query("cart#enriched"));
   }
@@ -431,33 +397,6 @@ var CartOperations = class {
       currency: cart.pricing.currency
     });
   }
-  // --------------------------------------------------------------------------
-  // CART MUTATIONS
-  // --------------------------------------------------------------------------
-  /**
-   * Add an item to the cart.
-   *
-   * @example
-   * ```typescript
-   * const result = await client.cart.addItem({
-   *   item_id: "prod_burger",
-   *   quantity: 2,
-   *   variant_id: "var_large",
-   *   add_on_options: ["addon_cheese", "addon_bacon"],
-   * });
-   *
-   * if (!result.ok) {
-   *   switch (result.error.code) {
-   *     case ErrorCode.ITEM_UNAVAILABLE:
-   *       toast.error("Item no longer available");
-   *       break;
-   *     case ErrorCode.VARIANT_OUT_OF_STOCK:
-   *       toast.error("Selected option is out of stock");
-   *       break;
-   *   }
-   * }
-   * ```
-   */
   async addItem(input) {
     return safe2(this.client.call("cart.addItem", input));
   }
@@ -487,9 +426,6 @@ var CartOperations = class {
   async clear() {
     return safe2(this.client.call("cart.clearCart"));
   }
-  // --------------------------------------------------------------------------
-  // COUPONS & DISCOUNTS
-  // --------------------------------------------------------------------------
   async applyCoupon(code) {
     return safe2(
       this.client.call("cart.applyCoupon", {
@@ -500,9 +436,6 @@ var CartOperations = class {
   async removeCoupon() {
     return safe2(this.client.call("cart.removeCoupon"));
   }
-  // --------------------------------------------------------------------------
-  // CONVENIENCE METHODS
-  // --------------------------------------------------------------------------
   async isEmpty() {
     const countResult = await this.getCount();
     if (!countResult.ok) return countResult;
@@ -655,35 +588,6 @@ var CheckoutService = class {
   constructor(client) {
     this.client = client;
   }
-  /**
-   * Process checkout with cart data.
-   *
-   * Automatically generates an idempotency key if not provided to ensure
-   * payment safety. The same key is used across retries, preventing
-   * duplicate charges if a network error occurs after payment processing.
-   *
-   * @example
-   * ```typescript
-   * const result = await client.checkout.process({
-   *   cart_id: cart.id,
-   *   customer: { name, email, phone, save_details: true },
-   *   order_type: "pickup",
-   *   payment_method: "mobile_money",
-   *   mobile_money_details: { phone_number, provider: "mtn" },
-   * });
-   *
-   * if (!result.ok) {
-   *   switch (result.error.code) {
-   *     case ErrorCode.CART_EMPTY:
-   *       toast.error("Your cart is empty");
-   *       break;
-   *     case ErrorCode.PAYMENT_FAILED:
-   *       toast.error("Payment failed. Please try again.");
-   *       break;
-   *   }
-   * }
-   * ```
-   */
   async process(data) {
     const checkoutData = {
       ...data,
@@ -801,9 +705,6 @@ var LinkService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // AUTHENTICATION
-  // --------------------------------------------------------------------------
   async requestOtp(input) {
     return safe5(this.client.linkPost("/v1/link/auth/request-otp", input));
   }
@@ -823,9 +724,6 @@ var LinkService = class {
     }
     return result;
   }
-  // --------------------------------------------------------------------------
-  // STATUS & DATA
-  // --------------------------------------------------------------------------
   async checkStatus(contact) {
     return safe5(
       this.client.call(LINK_MUTATION.CHECK_STATUS, {
@@ -845,9 +743,6 @@ var LinkService = class {
   async getPreferences() {
     return safe5(this.client.query(LINK_QUERY.PREFERENCES));
   }
-  // --------------------------------------------------------------------------
-  // ENROLLMENT
-  // --------------------------------------------------------------------------
   async enroll(data) {
     return safe5(this.client.call(LINK_MUTATION.ENROLL, data));
   }
@@ -856,15 +751,9 @@ var LinkService = class {
       this.client.call(LINK_MUTATION.ENROLL_AND_LINK_ORDER, data)
     );
   }
-  // --------------------------------------------------------------------------
-  // PREFERENCES
-  // --------------------------------------------------------------------------
   async updatePreferences(preferences) {
     return safe5(this.client.call(LINK_MUTATION.UPDATE_PREFERENCES, preferences));
   }
-  // --------------------------------------------------------------------------
-  // ADDRESSES
-  // --------------------------------------------------------------------------
   async createAddress(input) {
     return safe5(this.client.call(LINK_MUTATION.CREATE_ADDRESS, input));
   }
@@ -884,9 +773,6 @@ var LinkService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MOBILE MONEY
-  // --------------------------------------------------------------------------
   async createMobileMoney(input) {
     return safe5(this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input));
   }
@@ -910,9 +796,6 @@ var LinkService = class {
       this.client.call(LINK_MUTATION.VERIFY_MOBILE_MONEY, mobileMoneyId)
     );
   }
-  // --------------------------------------------------------------------------
-  // SESSIONS
-  // --------------------------------------------------------------------------
   async getSessions() {
     return safe5(this.client.linkGet("/v1/link/sessions"));
   }
@@ -922,9 +805,6 @@ var LinkService = class {
   async revokeAllSessions() {
     return safe5(this.client.linkDelete("/v1/link/sessions"));
   }
-  // --------------------------------------------------------------------------
-  // REST ALTERNATIVES (for direct API access)
-  // --------------------------------------------------------------------------
   async getAddressesRest() {
     return safe5(this.client.linkGet("/v1/link/addresses"));
   }
@@ -972,9 +852,6 @@ var AuthService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // STATUS & USER
-  // --------------------------------------------------------------------------
   async getStatus() {
     return safe6(this.client.query("auth"));
   }
@@ -988,9 +865,6 @@ var AuthService = class {
     if (!result.ok) return result;
     return ok(result.value.is_authenticated);
   }
-  // --------------------------------------------------------------------------
-  // OTP AUTHENTICATION
-  // --------------------------------------------------------------------------
   async requestOtp(contact, contactType) {
     return safe6(
       this.client.call(AUTH_MUTATION.REQUEST_OTP, {
@@ -1007,15 +881,9 @@ var AuthService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // SESSION MANAGEMENT
-  // --------------------------------------------------------------------------
   async logout() {
     return safe6(this.client.call("auth.logout"));
   }
-  // --------------------------------------------------------------------------
-  // PROFILE MANAGEMENT
-  // --------------------------------------------------------------------------
   async updateProfile(input) {
     return safe6(this.client.call("auth.update_profile", input));
   }
@@ -1046,9 +914,6 @@ var BusinessService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // BUSINESS INFO
-  // --------------------------------------------------------------------------
   async getInfo() {
     return safe7(this.client.query("business.info"));
   }
@@ -1064,27 +929,18 @@ var BusinessService = class {
   async getTheme() {
     return safe7(this.client.query("business.theme"));
   }
-  // --------------------------------------------------------------------------
-  // LOCATIONS
-  // --------------------------------------------------------------------------
   async getLocations() {
     return safe7(this.client.query("business.locations"));
   }
   async getLocation(locationId) {
     return safe7(this.client.query(`business.locations.${locationId}`));
   }
-  // --------------------------------------------------------------------------
-  // HOURS
-  // --------------------------------------------------------------------------
   async getHours() {
     return safe7(this.client.query("business.hours"));
   }
   async getLocationHours(locationId) {
     return safe7(this.client.query(`business.locations.${locationId}.hours`));
   }
-  // --------------------------------------------------------------------------
-  // BOOTSTRAP (for storefront initialization)
-  // --------------------------------------------------------------------------
   async getBootstrap() {
     const [businessResult, locationsResult, categoriesResult] = await Promise.all([
       this.getInfo(),
@@ -1129,9 +985,6 @@ var InventoryService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // STOCK QUERIES
-  // --------------------------------------------------------------------------
   async getStockLevels() {
     return safe8(this.client.query("inventory.stock_levels"));
   }
@@ -1158,9 +1011,6 @@ var InventoryService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // AVAILABILITY CHECKS
-  // --------------------------------------------------------------------------
   async checkProductAvailability(productId, quantity, locationId) {
     return safe8(
       this.client.query("inventory.check_availability", {
@@ -1190,15 +1040,9 @@ var InventoryService = class {
     }
     return ok(results.map((r) => r.value));
   }
-  // --------------------------------------------------------------------------
-  // SUMMARY
-  // --------------------------------------------------------------------------
   async getSummary() {
     return safe8(this.client.query("inventory.summary"));
   }
-  // --------------------------------------------------------------------------
-  // CONVENIENCE METHODS
-  // --------------------------------------------------------------------------
   async isInStock(productId, locationId) {
     const result = await this.checkProductAvailability(productId, 1, locationId);
     if (!result.ok) return result;
@@ -1230,9 +1074,6 @@ var SchedulingService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // SERVICES
-  // --------------------------------------------------------------------------
   async getServices() {
     return safe9(this.client.query("scheduling.services"));
   }
@@ -1245,9 +1086,6 @@ var SchedulingService = class {
     if (!result.ok) return result;
     return ok(result.value.find((s) => s.id === serviceId) || null);
   }
-  // --------------------------------------------------------------------------
-  // AVAILABILITY
-  // --------------------------------------------------------------------------
   async getAvailableSlots(input) {
     return safe9(
       this.client.query(
@@ -1272,9 +1110,6 @@ var SchedulingService = class {
       )
     );
   }
-  // --------------------------------------------------------------------------
-  // BOOKINGS
-  // --------------------------------------------------------------------------
   async getBooking(bookingId) {
     return safe9(this.client.query(`scheduling.${bookingId}`));
   }
@@ -1295,18 +1130,12 @@ var SchedulingService = class {
       )
     );
   }
-  // --------------------------------------------------------------------------
-  // BOOKING MANAGEMENT
-  // --------------------------------------------------------------------------
   async cancelBooking(input) {
     return safe9(this.client.call("scheduling.cancel_booking", input));
   }
   async rescheduleBooking(input) {
     return safe9(this.client.call("scheduling.reschedule_booking", input));
   }
-  // --------------------------------------------------------------------------
-  // CONVENIENCE METHODS
-  // --------------------------------------------------------------------------
   async getNextAvailableSlot(serviceId, fromDate) {
     const date = fromDate || (/* @__PURE__ */ new Date()).toISOString().split("T")[0];
     const result = await this.getAvailableSlots({
@@ -1345,15 +1174,9 @@ var LiteService = class {
   constructor(client) {
     this.client = client;
   }
-  // --------------------------------------------------------------------------
-  // BOOTSTRAP
-  // --------------------------------------------------------------------------
   async getBootstrap() {
     return safe10(this.client.query("lite.bootstrap"));
   }
-  // --------------------------------------------------------------------------
-  // TABLE MANAGEMENT
-  // --------------------------------------------------------------------------
   async getTable(tableId) {
     return safe10(this.client.query(`lite.table.${tableId}`));
   }
@@ -1365,9 +1188,6 @@ var LiteService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // KITCHEN ORDERS
-  // --------------------------------------------------------------------------
   async sendToKitchen(tableId, items) {
     return safe10(
       this.client.call("lite.send_to_kitchen", {
@@ -1391,9 +1211,6 @@ var LiteService = class {
       })
     );
   }
-  // --------------------------------------------------------------------------
-  // MENU (optimized for lite/QR experience)
-  // --------------------------------------------------------------------------
   async getMenu() {
     return safe10(this.client.query("lite.menu"));
   }
@@ -1467,7 +1284,6 @@ function deriveUrls() {
 var CimplifyClient = class {
   constructor(config = {}) {
     this.sessionToken = null;
-    /** In-flight request deduplication map */
     this.inflightRequests = /* @__PURE__ */ new Map();
     this.publicKey = config.publicKey || "";
     const urls = deriveUrls();
@@ -1477,18 +1293,31 @@ var CimplifyClient = class {
     this.timeout = config.timeout ?? DEFAULT_TIMEOUT_MS;
     this.maxRetries = config.maxRetries ?? DEFAULT_MAX_RETRIES;
     this.retryDelay = config.retryDelay ?? DEFAULT_RETRY_DELAY_MS;
+    this.hooks = config.hooks ?? {};
     this.sessionToken = this.loadSessionToken();
   }
   getSessionToken() {
     return this.sessionToken;
   }
   setSessionToken(token) {
+    const previous = this.sessionToken;
     this.sessionToken = token;
     this.saveSessionToken(token);
+    this.hooks.onSessionChange?.({
+      previousToken: previous,
+      newToken: token,
+      source: "manual"
+    });
   }
   clearSession() {
+    const previous = this.sessionToken;
     this.sessionToken = null;
     this.saveSessionToken(null);
+    this.hooks.onSessionChange?.({
+      previousToken: previous,
+      newToken: null,
+      source: "clear"
+    });
   }
   loadSessionToken() {
     if (typeof window !== "undefined" && window.localStorage) {
@@ -1518,15 +1347,29 @@ var CimplifyClient = class {
   updateSessionFromResponse(response) {
     const newToken = response.headers.get(SESSION_TOKEN_HEADER);
     if (newToken && newToken !== this.sessionToken) {
+      const previous = this.sessionToken;
       this.sessionToken = newToken;
       this.saveSessionToken(newToken);
+      this.hooks.onSessionChange?.({
+        previousToken: previous,
+        newToken,
+        source: "response"
+      });
     }
   }
-  /**
-   * Resilient fetch with timeout and automatic retries for network errors.
-   * Uses exponential backoff: 1s, 2s, 4s between retries.
-   */
   async resilientFetch(url, options) {
+    const method = options.method || "GET";
+    const path = url.replace(this.baseUrl, "").replace(this.linkApiUrl, "");
+    const startTime = Date.now();
+    let retryCount = 0;
+    const context = {
+      method,
+      path,
+      url,
+      body: options.body ? JSON.parse(options.body) : void 0,
+      startTime
+    };
+    this.hooks.onRequestStart?.(context);
     let lastError;
     for (let attempt = 0; attempt <= this.maxRetries; attempt++) {
       try {
@@ -1538,37 +1381,69 @@ var CimplifyClient = class {
         });
         clearTimeout(timeoutId);
         if (response.ok || response.status >= 400 && response.status < 500) {
+          this.hooks.onRequestSuccess?.({
+            ...context,
+            status: response.status,
+            durationMs: Date.now() - startTime
+          });
           return response;
         }
         if (response.status >= 500 && attempt < this.maxRetries) {
+          retryCount++;
           const delay = this.retryDelay * Math.pow(2, attempt);
+          this.hooks.onRetry?.({
+            ...context,
+            attempt: retryCount,
+            delayMs: delay,
+            error: new Error(`Server error: ${response.status}`)
+          });
           await sleep(delay);
           continue;
         }
+        this.hooks.onRequestSuccess?.({
+          ...context,
+          status: response.status,
+          durationMs: Date.now() - startTime
+        });
         return response;
       } catch (error) {
         lastError = error;
-        if (!isRetryable(error) || attempt >= this.maxRetries) {
-          throw toNetworkError(error);
+        const networkError = toNetworkError(error);
+        const errorRetryable = isRetryable(error);
+        if (!errorRetryable || attempt >= this.maxRetries) {
+          this.hooks.onRequestError?.({
+            ...context,
+            error: networkError,
+            durationMs: Date.now() - startTime,
+            retryCount,
+            retryable: errorRetryable
+          });
+          throw networkError;
         }
+        retryCount++;
         const delay = this.retryDelay * Math.pow(2, attempt);
+        this.hooks.onRetry?.({
+          ...context,
+          attempt: retryCount,
+          delayMs: delay,
+          error: networkError
+        });
         await sleep(delay);
       }
     }
-    throw toNetworkError(lastError);
+    const finalError = toNetworkError(lastError);
+    this.hooks.onRequestError?.({
+      ...context,
+      error: finalError,
+      durationMs: Date.now() - startTime,
+      retryCount,
+      retryable: false
+    });
+    throw finalError;
   }
-  /**
-   * Generate a deduplication key for a request.
-   * Same query + variables = same key = deduplicated.
-   */
   getDedupeKey(type, payload) {
     return `${type}:${JSON.stringify(payload)}`;
   }
-  /**
-   * Execute a request with deduplication.
-   * If an identical request is already in-flight, return the same promise.
-   * This prevents redundant network calls when multiple components request the same data.
-   */
   async deduplicatedRequest(key, requestFn) {
     const existing = this.inflightRequests.get(key);
     if (existing) {
@@ -1580,10 +1455,6 @@ var CimplifyClient = class {
     this.inflightRequests.set(key, request);
     return request;
   }
-  /**
-   * Execute a query with deduplication.
-   * Multiple identical queries made simultaneously will share a single network request.
-   */
   async query(query2, variables) {
     const body = { query: query2 };
     if (variables) {
@@ -1601,9 +1472,6 @@ var CimplifyClient = class {
       return this.handleResponse(response);
     });
   }
-  /**
-   * Execute a mutation. NOT deduplicated - mutations have side effects.
-   */
   async call(method, args) {
     const body = {
       method,

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.3.4",
+  "version": "0.3.6",
   "description": "Cimplify Commerce SDK for storefronts",
   "keywords": [
     "cimplify",