@cimplify/sdk 0.1.0 → 0.2.0

package/dist/index.mjs

@@ -1302,23 +1302,354 @@ function query(entity) {
   return new QueryBuilder(entity);
 }
 
-// src/utils/payment.ts
+// src/utils/price.ts
 var CURRENCY_SYMBOLS = {
-  GHS: "GH\u20B5",
+  // Major world currencies
   USD: "$",
   EUR: "\u20AC",
   GBP: "\xA3",
+  JPY: "\xA5",
+  CNY: "\xA5",
+  CHF: "CHF",
+  CAD: "C$",
+  AUD: "A$",
+  NZD: "NZ$",
+  HKD: "HK$",
+  SGD: "S$",
+  INR: "\u20B9",
+  BRL: "R$",
+  MXN: "MX$",
+  KRW: "\u20A9",
+  RUB: "\u20BD",
+  TRY: "\u20BA",
+  THB: "\u0E3F",
+  PLN: "z\u0142",
+  SEK: "kr",
+  NOK: "kr",
+  DKK: "kr",
+  CZK: "K\u010D",
+  HUF: "Ft",
+  ILS: "\u20AA",
+  AED: "\u062F.\u0625",
+  SAR: "\uFDFC",
+  MYR: "RM",
+  PHP: "\u20B1",
+  IDR: "Rp",
+  VND: "\u20AB",
+  TWD: "NT$",
+  // African currencies
+  GHS: "GH\u20B5",
   NGN: "\u20A6",
   KES: "KSh",
   ZAR: "R",
   XOF: "CFA",
-  XAF: "FCFA"
+  XAF: "FCFA",
+  EGP: "E\xA3",
+  MAD: "MAD",
+  TZS: "TSh",
+  UGX: "USh",
+  RWF: "FRw",
+  ETB: "Br",
+  ZMW: "ZK",
+  BWP: "P",
+  MUR: "\u20A8",
+  SCR: "\u20A8",
+  NAD: "N$",
+  SZL: "E",
+  LSL: "L",
+  MWK: "MK",
+  AOA: "Kz",
+  CDF: "FC",
+  GMD: "D",
+  GNF: "FG",
+  LRD: "L$",
+  SLL: "Le",
+  MZN: "MT",
+  SDG: "SDG",
+  SSP: "SSP",
+  SOS: "Sh.So.",
+  DJF: "Fdj",
+  ERN: "Nfk",
+  CVE: "$",
+  STN: "Db",
+  KMF: "CF",
+  BIF: "FBu"
 };
+function getCurrencySymbol(currencyCode) {
+  return CURRENCY_SYMBOLS[currencyCode.toUpperCase()] || currencyCode;
+}
+function formatNumberCompact(value, decimals = 1) {
+  const absValue = Math.abs(value);
+  const sign = value < 0 ? "-" : "";
+  if (absValue >= 1e9) {
+    return `${sign}${(absValue / 1e9).toFixed(decimals)}B`;
+  }
+  if (absValue >= 1e6) {
+    return `${sign}${(absValue / 1e6).toFixed(decimals)}M`;
+  }
+  if (absValue >= 1e3) {
+    return `${sign}${(absValue / 1e3).toFixed(decimals)}K`;
+  }
+  return `${sign}${absValue.toFixed(decimals)}`;
+}
+function formatPrice(amount, currency = "GHS", locale = "en-US") {
+  const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
+  if (isNaN(numAmount)) {
+    return `${getCurrencySymbol(currency)}0.00`;
+  }
+  try {
+    return new Intl.NumberFormat(locale, {
+      style: "currency",
+      currency: currency.toUpperCase(),
+      minimumFractionDigits: 2,
+      maximumFractionDigits: 2
+    }).format(numAmount);
+  } catch {
+    return `${getCurrencySymbol(currency)}${numAmount.toFixed(2)}`;
+  }
+}
+function formatPriceAdjustment(amount, currency = "GHS", locale = "en-US") {
+  const formatted = formatPrice(Math.abs(amount), currency, locale);
+  if (amount > 0) {
+    return `+${formatted}`;
+  } else if (amount < 0) {
+    return `-${formatted}`;
+  }
+  return formatted;
+}
+function formatPriceCompact(amount, currency = "GHS", decimals = 1) {
+  const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
+  if (isNaN(numAmount)) {
+    return `${getCurrencySymbol(currency)}0`;
+  }
+  const symbol = getCurrencySymbol(currency);
+  if (Math.abs(numAmount) < 1e3) {
+    return `${symbol}${numAmount.toFixed(2)}`;
+  }
+  return `${symbol}${formatNumberCompact(numAmount, decimals)}`;
+}
 function formatMoney(amount, currency = "GHS") {
-  const symbol = CURRENCY_SYMBOLS[currency.toUpperCase()] || currency;
+  const symbol = getCurrencySymbol(currency);
   const numAmount = typeof amount === "string" ? parseFloat(amount) : amount;
+  if (isNaN(numAmount)) {
+    return `${symbol}0.00`;
+  }
   return `${symbol}${numAmount.toFixed(2)}`;
 }
+function parsePrice(value) {
+  if (value === void 0 || value === null) {
+    return 0;
+  }
+  if (typeof value === "number") {
+    return isNaN(value) ? 0 : value;
+  }
+  const cleaned = value.replace(/[^\d.-]/g, "");
+  const parsed = parseFloat(cleaned);
+  return isNaN(parsed) ? 0 : parsed;
+}
+function parseTaxInfo(taxInfoStr) {
+  try {
+    const parts = taxInfoStr.split(":");
+    if (parts.length < 4 || parts[0] !== "T") {
+      return void 0;
+    }
+    const taxRate = parseFloat(parts[1]);
+    const taxAmount = parseFloat(parts[2]);
+    const isInclusive = parts[3] === "I";
+    const components = [];
+    if (parts.length > 4 && parts[4]) {
+      const componentPairs = parts[4].split(",");
+      for (const pair of componentPairs) {
+        const [name, rateStr] = pair.split(":");
+        if (name && rateStr) {
+          components.push({
+            name: name.trim(),
+            rate: parseFloat(rateStr)
+          });
+        }
+      }
+    }
+    return {
+      taxRate,
+      taxAmount,
+      isInclusive,
+      components
+    };
+  } catch {
+    return void 0;
+  }
+}
+function parsePricePath(signedPricePath) {
+  if (!signedPricePath) {
+    return {
+      basePrice: 0,
+      finalPrice: 0,
+      currency: "GHS",
+      decisionPath: "",
+      isValid: false,
+      isExpired: false
+    };
+  }
+  try {
+    const parts = signedPricePath.split("\xA7");
+    if (parts.length !== 3) {
+      return {
+        basePrice: 0,
+        finalPrice: 0,
+        currency: "GHS",
+        decisionPath: "",
+        isValid: false,
+        isExpired: false
+      };
+    }
+    const [pricePath, expiryStr, signature] = parts;
+    const expiryTimestamp = parseInt(expiryStr, 10);
+    const now = Math.floor(Date.now() / 1e3);
+    const isExpired = now > expiryTimestamp;
+    const priceComponents = pricePath.split("|");
+    if (priceComponents.length < 5) {
+      return {
+        basePrice: 0,
+        finalPrice: 0,
+        currency: "GHS",
+        decisionPath: "",
+        isValid: false,
+        isExpired
+      };
+    }
+    const basePrice = parseFloat(priceComponents[0]);
+    const finalPrice = parseFloat(priceComponents[1]);
+    const currency = priceComponents[2];
+    const taxInfoStr = priceComponents[3];
+    const decisionPath = priceComponents.slice(4).join("|");
+    let taxInfo;
+    if (taxInfoStr && taxInfoStr.startsWith("T:")) {
+      taxInfo = parseTaxInfo(taxInfoStr);
+    } else if (taxInfoStr === "0" || !taxInfoStr) {
+      taxInfo = {
+        taxRate: 0,
+        taxAmount: 0,
+        isInclusive: false,
+        components: []
+      };
+    }
+    let markupPercentage;
+    let markupAmount;
+    let discountPercentage;
+    if (decisionPath) {
+      const pathParts = decisionPath.split(":");
+      if (pathParts.length > 1 && pathParts[1]) {
+        const adjustments = pathParts[1].split(",");
+        for (const adj of adjustments) {
+          const adjParts = adj.split("|");
+          if (adjParts[0] && adjParts[0].startsWith("ch")) {
+            markupAmount = parseFloat(adjParts[1]) || 0;
+            markupPercentage = parseFloat(adjParts[2]) || 0;
+            break;
+          }
+        }
+      }
+    }
+    if (markupAmount === void 0 && finalPrice > basePrice) {
+      markupAmount = finalPrice - basePrice;
+      markupPercentage = basePrice > 0 ? markupAmount / basePrice * 100 : 0;
+    } else if (basePrice > finalPrice) {
+      discountPercentage = basePrice > 0 ? (basePrice - finalPrice) / basePrice * 100 : 0;
+    }
+    return {
+      basePrice,
+      finalPrice,
+      currency,
+      decisionPath,
+      discountPercentage,
+      markupPercentage,
+      markupAmount,
+      taxInfo,
+      isValid: !isExpired && signature.length > 0,
+      isExpired,
+      expiryTimestamp
+    };
+  } catch {
+    return {
+      basePrice: 0,
+      finalPrice: 0,
+      currency: "GHS",
+      decisionPath: "",
+      isValid: false,
+      isExpired: false
+    };
+  }
+}
+function parsedPriceToPriceInfo(parsedPrice) {
+  return {
+    base_price: parsedPrice.basePrice,
+    final_price: parsedPrice.finalPrice,
+    markup_percentage: parsedPrice.markupPercentage,
+    markup_amount: parsedPrice.markupAmount,
+    currency: parsedPrice.currency,
+    tax_info: parsedPrice.taxInfo,
+    decision_path: parsedPrice.decisionPath
+  };
+}
+function extractPriceInfo(signedPricePath) {
+  const parsed = parsePricePath(signedPricePath);
+  return parsedPriceToPriceInfo(parsed);
+}
+function getDisplayPrice(product) {
+  if (product.price_path) {
+    const priceInfo = extractPriceInfo(product.price_path);
+    return priceInfo.final_price;
+  } else if (product.price_info) {
+    return product.price_info.final_price;
+  }
+  return 0;
+}
+function getBasePrice(product) {
+  if (product.price_path) {
+    const priceInfo = extractPriceInfo(product.price_path);
+    return priceInfo.base_price;
+  } else if (product.price_info) {
+    return product.price_info.base_price;
+  }
+  return 0;
+}
+function isOnSale(product) {
+  const basePrice = getBasePrice(product);
+  const finalPrice = getDisplayPrice(product);
+  return basePrice > finalPrice && basePrice > 0;
+}
+function getDiscountPercentage(product) {
+  const basePrice = getBasePrice(product);
+  const finalPrice = getDisplayPrice(product);
+  if (basePrice > finalPrice && basePrice > 0) {
+    return Math.round((basePrice - finalPrice) / basePrice * 100);
+  }
+  return 0;
+}
+function getMarkupPercentage(product) {
+  const basePrice = getBasePrice(product);
+  const finalPrice = getDisplayPrice(product);
+  if (finalPrice > basePrice && basePrice > 0) {
+    return Math.round((finalPrice - basePrice) / basePrice * 100);
+  }
+  return 0;
+}
+function getProductCurrency(product) {
+  if (product.price_path) {
+    const parsed = parsePricePath(product.price_path);
+    return parsed.currency || "GHS";
+  } else if (product.price_info?.currency) {
+    return product.price_info.currency;
+  }
+  return "GHS";
+}
+function formatProductPrice(product, locale = "en-US") {
+  const price = getDisplayPrice(product);
+  const currency = getProductCurrency(product);
+  return formatPrice(price, currency, locale);
+}
+
+// src/utils/payment.ts
 function categorizePaymentError(error, errorCode) {
   let message = "An unexpected error occurred during payment processing. Please try again or contact support.";
   let recoverable = true;
@@ -1457,4 +1788,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, 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, formatMoney, normalizePaymentResponse, normalizeStatusResponse, 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, 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, isOnSale, normalizePaymentResponse, normalizeStatusResponse, parsePrice, parsePricePath, parsedPriceToPriceInfo, query };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@cimplify/sdk",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Cimplify Commerce SDK for storefronts",
   "main": "./dist/index.js",
   "module": "./dist/index.mjs",