@cimplify/sdk 0.2.5 → 0.3.0

package/dist/index.mjs

@@ -274,7 +274,91 @@ var CatalogueQueries = class {
   }
 };
 
+// src/types/result.ts
+function ok(value) {
+  return { ok: true, value };
+}
+function err(error) {
+  return { ok: false, error };
+}
+function isOk(result) {
+  return result.ok === true;
+}
+function isErr(result) {
+  return result.ok === false;
+}
+function mapResult(result, fn) {
+  return result.ok ? ok(fn(result.value)) : result;
+}
+function mapError(result, fn) {
+  return result.ok ? result : err(fn(result.error));
+}
+function flatMap(result, fn) {
+  return result.ok ? fn(result.value) : result;
+}
+function getOrElse(result, defaultFn) {
+  return result.ok ? result.value : defaultFn();
+}
+function unwrap(result) {
+  if (result.ok) {
+    return result.value;
+  }
+  throw result.error;
+}
+function toNullable(result) {
+  return result.ok ? result.value : void 0;
+}
+async function fromPromise(promise, mapError2) {
+  try {
+    const value = await promise;
+    return ok(value);
+  } catch (error) {
+    return err(mapError2(error));
+  }
+}
+function tryCatch(fn, mapError2) {
+  try {
+    return ok(fn());
+  } catch (error) {
+    return err(mapError2(error));
+  }
+}
+function combine(results) {
+  const values = [];
+  for (const result of results) {
+    if (!result.ok) {
+      return result;
+    }
+    values.push(result.value);
+  }
+  return ok(values);
+}
+function combineObject(results) {
+  const values = {};
+  for (const [key, result] of Object.entries(results)) {
+    if (!result.ok) {
+      return result;
+    }
+    values[key] = result.value;
+  }
+  return ok(values);
+}
+
 // src/cart.ts
+function toCimplifyError(error) {
+  if (error instanceof CimplifyError) return error;
+  if (error instanceof Error) {
+    return new CimplifyError("UNKNOWN_ERROR", error.message, false);
+  }
+  return new CimplifyError("UNKNOWN_ERROR", String(error), false);
+}
+async function safe(promise) {
+  try {
+    return ok(await promise);
+  } catch (error) {
+    return err(toCimplifyError(error));
+  }
+}
 var CartOperations = class {
   constructor(client) {
     this.client = client;
@@ -287,23 +371,25 @@ var CartOperations = class {
    * This is the main method for storefront display.
    */
   async get() {
-    return this.client.query("cart#enriched");
+    return safe(this.client.query("cart#enriched"));
   }
   async getRaw() {
-    return this.client.query("cart");
+    return safe(this.client.query("cart"));
   }
   async getItems() {
-    return this.client.query("cart_items");
+    return safe(this.client.query("cart_items"));
   }
   async getCount() {
-    return this.client.query("cart#count");
+    return safe(this.client.query("cart#count"));
   }
   async getTotal() {
-    return this.client.query("cart#total");
+    return safe(this.client.query("cart#total"));
   }
   async getSummary() {
-    const cart = await this.get();
-    return {
+    const cartResult = await this.get();
+    if (!cartResult.ok) return cartResult;
+    const cart = cartResult.value;
+    return ok({
       item_count: cart.items.length,
       total_items: cart.items.reduce((sum, item) => sum + item.quantity, 0),
       subtotal: cart.pricing.subtotal,
@@ -311,55 +397,89 @@ var CartOperations = class {
       tax_amount: cart.pricing.tax_amount,
       total: cart.pricing.total_price,
       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 this.client.call("cart.addItem", input);
+    return safe(this.client.call("cart.addItem", input));
   }
   async updateItem(cartItemId, updates) {
-    return this.client.call("cart.updateItem", {
-      cart_item_id: cartItemId,
-      ...updates
-    });
+    return safe(
+      this.client.call("cart.updateItem", {
+        cart_item_id: cartItemId,
+        ...updates
+      })
+    );
   }
   async updateQuantity(cartItemId, quantity) {
-    return this.client.call("cart.updateItemQuantity", {
-      cart_item_id: cartItemId,
-      quantity
-    });
+    return safe(
+      this.client.call("cart.updateItemQuantity", {
+        cart_item_id: cartItemId,
+        quantity
+      })
+    );
   }
   async removeItem(cartItemId) {
-    return this.client.call("cart.removeItem", {
-      cart_item_id: cartItemId
-    });
+    return safe(
+      this.client.call("cart.removeItem", {
+        cart_item_id: cartItemId
+      })
+    );
   }
   async clear() {
-    return this.client.call("cart.clearCart");
+    return safe(this.client.call("cart.clearCart"));
   }
   // --------------------------------------------------------------------------
   // COUPONS & DISCOUNTS
   // --------------------------------------------------------------------------
   async applyCoupon(code) {
-    return this.client.call("cart.applyCoupon", {
-      coupon_code: code
-    });
+    return safe(
+      this.client.call("cart.applyCoupon", {
+        coupon_code: code
+      })
+    );
   }
   async removeCoupon() {
-    return this.client.call("cart.removeCoupon");
+    return safe(this.client.call("cart.removeCoupon"));
   }
   // --------------------------------------------------------------------------
   // CONVENIENCE METHODS
   // --------------------------------------------------------------------------
   async isEmpty() {
-    const count = await this.getCount();
-    return count === 0;
+    const countResult = await this.getCount();
+    if (!countResult.ok) return countResult;
+    return ok(countResult.value === 0);
   }
   async hasItem(productId, variantId) {
-    const items = await this.getItems();
-    return items.some((item) => {
+    const itemsResult = await this.getItems();
+    if (!itemsResult.ok) return itemsResult;
+    const found = itemsResult.value.some((item) => {
       const matchesProduct = item.item_id === productId;
       if (!variantId) return matchesProduct;
       const config = item.configuration;
@@ -368,10 +488,12 @@ var CartOperations = class {
       }
       return matchesProduct;
     });
+    return ok(found);
   }
   async findItem(productId, variantId) {
-    const items = await this.getItems();
-    return items.find((item) => {
+    const itemsResult = await this.getItems();
+    if (!itemsResult.ok) return itemsResult;
+    const found = itemsResult.value.find((item) => {
       const matchesProduct = item.item_id === productId;
       if (!variantId) return matchesProduct;
       const config = item.configuration;
@@ -380,6 +502,7 @@ var CartOperations = class {
       }
       return matchesProduct;
     });
+    return ok(found);
   }
 };
 
@@ -474,37 +597,88 @@ var DEFAULT_CURRENCY = "GHS";
 var DEFAULT_COUNTRY = "GHA";
 
 // src/checkout.ts
+function toCimplifyError2(error) {
+  if (error instanceof CimplifyError) return error;
+  if (error instanceof Error) {
+    return new CimplifyError("UNKNOWN_ERROR", error.message, false);
+  }
+  return new CimplifyError("UNKNOWN_ERROR", String(error), false);
+}
+async function safe2(promise) {
+  try {
+    return ok(await promise);
+  } catch (error) {
+    return err(toCimplifyError2(error));
+  }
+}
 var CheckoutService = class {
   constructor(client) {
     this.client = client;
   }
+  /**
+   * Process checkout with cart data.
+   *
+   * @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) {
-    return this.client.call(CHECKOUT_MUTATION.PROCESS, {
-      checkout_data: data
-    });
+    return safe2(
+      this.client.call(CHECKOUT_MUTATION.PROCESS, {
+        checkout_data: data
+      })
+    );
   }
   async initializePayment(orderId, method) {
-    return this.client.call("order.initializePayment", {
-      order_id: orderId,
-      payment_method: method
-    });
+    return safe2(
+      this.client.call("order.initializePayment", {
+        order_id: orderId,
+        payment_method: method
+      })
+    );
   }
   async submitAuthorization(input) {
-    return this.client.call(PAYMENT_MUTATION.SUBMIT_AUTHORIZATION, input);
+    return safe2(
+      this.client.call(PAYMENT_MUTATION.SUBMIT_AUTHORIZATION, input)
+    );
   }
   async pollPaymentStatus(orderId) {
-    return this.client.call(PAYMENT_MUTATION.CHECK_STATUS, orderId);
+    return safe2(
+      this.client.call(PAYMENT_MUTATION.CHECK_STATUS, orderId)
+    );
   }
   async updateOrderCustomer(orderId, customer) {
-    return this.client.call(ORDER_MUTATION.UPDATE_CUSTOMER, {
-      order_id: orderId,
-      ...customer
-    });
+    return safe2(
+      this.client.call(ORDER_MUTATION.UPDATE_CUSTOMER, {
+        order_id: orderId,
+        ...customer
+      })
+    );
   }
   async verifyPayment(orderId) {
-    return this.client.call("order.verifyPayment", {
-      order_id: orderId
-    });
+    return safe2(
+      this.client.call("order.verifyPayment", {
+        order_id: orderId
+      })
+    );
   }
 };
 
@@ -545,117 +719,173 @@ var OrderQueries = class {
 };
 
 // src/link.ts
+function toCimplifyError3(error) {
+  if (error instanceof CimplifyError) return error;
+  if (error instanceof Error) {
+    return new CimplifyError("UNKNOWN_ERROR", error.message, false);
+  }
+  return new CimplifyError("UNKNOWN_ERROR", String(error), false);
+}
+async function safe3(promise) {
+  try {
+    return ok(await promise);
+  } catch (error) {
+    return err(toCimplifyError3(error));
+  }
+}
 var LinkService = class {
   constructor(client) {
     this.client = client;
   }
+  // --------------------------------------------------------------------------
+  // AUTHENTICATION
+  // --------------------------------------------------------------------------
   async requestOtp(input) {
-    return this.client.linkPost("/v1/link/auth/request-otp", input);
+    return safe3(this.client.linkPost("/v1/link/auth/request-otp", input));
   }
   async verifyOtp(input) {
-    const response = await this.client.linkPost("/v1/link/auth/verify-otp", input);
-    if (response.session_token) {
-      this.client.setSessionToken(response.session_token);
+    const result = await safe3(
+      this.client.linkPost("/v1/link/auth/verify-otp", input)
+    );
+    if (result.ok && result.value.session_token) {
+      this.client.setSessionToken(result.value.session_token);
     }
-    return response;
+    return result;
   }
   async logout() {
-    const result = await this.client.linkPost("/v1/link/auth/logout");
-    this.client.clearSession();
+    const result = await safe3(this.client.linkPost("/v1/link/auth/logout"));
+    if (result.ok) {
+      this.client.clearSession();
+    }
     return result;
   }
+  // --------------------------------------------------------------------------
+  // STATUS & DATA
+  // --------------------------------------------------------------------------
   async checkStatus(contact) {
-    return this.client.call(LINK_MUTATION.CHECK_STATUS, {
-      contact
-    });
+    return safe3(
+      this.client.call(LINK_MUTATION.CHECK_STATUS, {
+        contact
+      })
+    );
   }
   async getLinkData() {
-    return this.client.query(LINK_QUERY.DATA);
+    return safe3(this.client.query(LINK_QUERY.DATA));
   }
   async getAddresses() {
-    return this.client.query(LINK_QUERY.ADDRESSES);
+    return safe3(this.client.query(LINK_QUERY.ADDRESSES));
   }
   async getMobileMoney() {
-    return this.client.query(LINK_QUERY.MOBILE_MONEY);
+    return safe3(this.client.query(LINK_QUERY.MOBILE_MONEY));
   }
   async getPreferences() {
-    return this.client.query(LINK_QUERY.PREFERENCES);
+    return safe3(this.client.query(LINK_QUERY.PREFERENCES));
   }
+  // --------------------------------------------------------------------------
+  // ENROLLMENT
+  // --------------------------------------------------------------------------
   async enroll(data) {
-    return this.client.call(LINK_MUTATION.ENROLL, data);
+    return safe3(this.client.call(LINK_MUTATION.ENROLL, data));
   }
   async enrollAndLinkOrder(data) {
-    return this.client.call(LINK_MUTATION.ENROLL_AND_LINK_ORDER, data);
+    return safe3(
+      this.client.call(LINK_MUTATION.ENROLL_AND_LINK_ORDER, data)
+    );
   }
+  // --------------------------------------------------------------------------
+  // PREFERENCES
+  // --------------------------------------------------------------------------
   async updatePreferences(preferences) {
-    return this.client.call(LINK_MUTATION.UPDATE_PREFERENCES, preferences);
+    return safe3(this.client.call(LINK_MUTATION.UPDATE_PREFERENCES, preferences));
   }
+  // --------------------------------------------------------------------------
+  // ADDRESSES
+  // --------------------------------------------------------------------------
   async createAddress(input) {
-    return this.client.call(LINK_MUTATION.CREATE_ADDRESS, input);
+    return safe3(this.client.call(LINK_MUTATION.CREATE_ADDRESS, input));
   }
   async updateAddress(input) {
-    return this.client.call(LINK_MUTATION.UPDATE_ADDRESS, input);
+    return safe3(this.client.call(LINK_MUTATION.UPDATE_ADDRESS, input));
   }
   async deleteAddress(addressId) {
-    return this.client.call(LINK_MUTATION.DELETE_ADDRESS, addressId);
+    return safe3(this.client.call(LINK_MUTATION.DELETE_ADDRESS, addressId));
   }
   async setDefaultAddress(addressId) {
-    return this.client.call(LINK_MUTATION.SET_DEFAULT_ADDRESS, addressId);
+    return safe3(this.client.call(LINK_MUTATION.SET_DEFAULT_ADDRESS, addressId));
   }
   async trackAddressUsage(addressId) {
-    return this.client.call(LINK_MUTATION.TRACK_ADDRESS_USAGE, {
-      address_id: addressId
-    });
+    return safe3(
+      this.client.call(LINK_MUTATION.TRACK_ADDRESS_USAGE, {
+        address_id: addressId
+      })
+    );
   }
+  // --------------------------------------------------------------------------
+  // MOBILE MONEY
+  // --------------------------------------------------------------------------
   async createMobileMoney(input) {
-    return this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input);
+    return safe3(this.client.call(LINK_MUTATION.CREATE_MOBILE_MONEY, input));
   }
   async deleteMobileMoney(mobileMoneyId) {
-    return this.client.call(LINK_MUTATION.DELETE_MOBILE_MONEY, mobileMoneyId);
+    return safe3(this.client.call(LINK_MUTATION.DELETE_MOBILE_MONEY, mobileMoneyId));
   }
   async setDefaultMobileMoney(mobileMoneyId) {
-    return this.client.call(LINK_MUTATION.SET_DEFAULT_MOBILE_MONEY, mobileMoneyId);
+    return safe3(
+      this.client.call(LINK_MUTATION.SET_DEFAULT_MOBILE_MONEY, mobileMoneyId)
+    );
   }
   async trackMobileMoneyUsage(mobileMoneyId) {
-    return this.client.call(LINK_MUTATION.TRACK_MOBILE_MONEY_USAGE, {
-      mobile_money_id: mobileMoneyId
-    });
+    return safe3(
+      this.client.call(LINK_MUTATION.TRACK_MOBILE_MONEY_USAGE, {
+        mobile_money_id: mobileMoneyId
+      })
+    );
   }
   async verifyMobileMoney(mobileMoneyId) {
-    return this.client.call(LINK_MUTATION.VERIFY_MOBILE_MONEY, mobileMoneyId);
+    return safe3(
+      this.client.call(LINK_MUTATION.VERIFY_MOBILE_MONEY, mobileMoneyId)
+    );
   }
+  // --------------------------------------------------------------------------
+  // SESSIONS
+  // --------------------------------------------------------------------------
   async getSessions() {
-    return this.client.linkGet("/v1/link/sessions");
+    return safe3(this.client.linkGet("/v1/link/sessions"));
   }
   async revokeSession(sessionId) {
-    return this.client.linkDelete(`/v1/link/sessions/${sessionId}`);
+    return safe3(this.client.linkDelete(`/v1/link/sessions/${sessionId}`));
   }
   async revokeAllSessions() {
-    return this.client.linkDelete("/v1/link/sessions");
+    return safe3(this.client.linkDelete("/v1/link/sessions"));
   }
+  // --------------------------------------------------------------------------
+  // REST ALTERNATIVES (for direct API access)
+  // --------------------------------------------------------------------------
   async getAddressesRest() {
-    return this.client.linkGet("/v1/link/addresses");
+    return safe3(this.client.linkGet("/v1/link/addresses"));
   }
   async createAddressRest(input) {
-    return this.client.linkPost("/v1/link/addresses", input);
+    return safe3(this.client.linkPost("/v1/link/addresses", input));
   }
   async deleteAddressRest(addressId) {
-    return this.client.linkDelete(`/v1/link/addresses/${addressId}`);
+    return safe3(this.client.linkDelete(`/v1/link/addresses/${addressId}`));
   }
   async setDefaultAddressRest(addressId) {
-    return this.client.linkPost(`/v1/link/addresses/${addressId}/default`);
+    return safe3(this.client.linkPost(`/v1/link/addresses/${addressId}/default`));
   }
   async getMobileMoneyRest() {
-    return this.client.linkGet("/v1/link/mobile-money");
+    return safe3(this.client.linkGet("/v1/link/mobile-money"));
   }
   async createMobileMoneyRest(input) {
-    return this.client.linkPost("/v1/link/mobile-money", input);
+    return safe3(this.client.linkPost("/v1/link/mobile-money", input));
   }
   async deleteMobileMoneyRest(mobileMoneyId) {
-    return this.client.linkDelete(`/v1/link/mobile-money/${mobileMoneyId}`);
+    return safe3(this.client.linkDelete(`/v1/link/mobile-money/${mobileMoneyId}`));
   }
   async setDefaultMobileMoneyRest(mobileMoneyId) {
-    return this.client.linkPost(`/v1/link/mobile-money/${mobileMoneyId}/default`);
+    return safe3(
+      this.client.linkPost(`/v1/link/mobile-money/${mobileMoneyId}/default`)
+    );
   }
 };
 
@@ -1782,4 +2012,4 @@ function detectMobileMoneyProvider(phoneNumber) {
   return null;
 }
 
-export { AUTHORIZATION_TYPE, AUTH_MUTATION, AuthService, BusinessService, CHECKOUT_MODE, CHECKOUT_MUTATION, CHECKOUT_STEP, CURRENCY_SYMBOLS, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyClient, CimplifyError, DEFAULT_COUNTRY, DEFAULT_CURRENCY, ErrorCode, InventoryService, LINK_MUTATION, LINK_QUERY, LinkService, LiteService, MOBILE_MONEY_PROVIDER, MOBILE_MONEY_PROVIDERS, ORDER_MUTATION, ORDER_TYPE, OrderQueries, PAYMENT_METHOD, PAYMENT_MUTATION, PAYMENT_STATE, PICKUP_TIME_TYPE, QueryBuilder, SchedulingService, categorizePaymentError, createCimplifyClient, detectMobileMoneyProvider, extractPriceInfo, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getMarkupPercentage, getProductCurrency, isCimplifyError, isOnSale, isRetryableError, normalizePaymentResponse, normalizeStatusResponse, parsePrice, parsePricePath, parsedPriceToPriceInfo, query };
+export { AUTHORIZATION_TYPE, AUTH_MUTATION, AuthService, BusinessService, CHECKOUT_MODE, CHECKOUT_MUTATION, CHECKOUT_STEP, CURRENCY_SYMBOLS, CartOperations, CatalogueQueries, CheckoutService as CheckoutOperations, CheckoutService, CimplifyClient, CimplifyError, DEFAULT_COUNTRY, DEFAULT_CURRENCY, ErrorCode, InventoryService, LINK_MUTATION, LINK_QUERY, LinkService, LiteService, MOBILE_MONEY_PROVIDER, MOBILE_MONEY_PROVIDERS, ORDER_MUTATION, ORDER_TYPE, OrderQueries, PAYMENT_METHOD, PAYMENT_MUTATION, PAYMENT_STATE, PICKUP_TIME_TYPE, QueryBuilder, SchedulingService, categorizePaymentError, combine, combineObject, createCimplifyClient, detectMobileMoneyProvider, err, extractPriceInfo, flatMap, formatMoney, formatNumberCompact, formatPrice, formatPriceAdjustment, formatPriceCompact, formatProductPrice, fromPromise, getBasePrice, getCurrencySymbol, getDiscountPercentage, getDisplayPrice, getMarkupPercentage, getOrElse, getProductCurrency, isCimplifyError, isErr, isOk, isOnSale, isRetryableError, mapError, mapResult, normalizePaymentResponse, normalizeStatusResponse, ok, parsePrice, parsePricePath, parsedPriceToPriceInfo, query, toNullable, tryCatch, unwrap };

package/package.json

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