@behio/storefront-sdk 0.1.0 → 0.1.2

package/README.md

@@ -1,6 +1,26 @@
 # @behio/storefront-sdk
 
-TypeScript SDK for **Behio Headless E-Shop** — Storefront API client + React/Next.js hooks.
+**Build your own e-shop. Keep 100% control over the frontend.**
+
+Behio is a headless e-commerce platform that gives you a complete backend — products, inventory, orders, customers, discounts, multi-currency, multi-language, payments — and lets *you* design the storefront however you want. No themes, no templates, no vendor lock-in.
+
+This SDK is the fastest way to connect your Next.js, React, or any JavaScript app to the Behio Storefront API.
+
+## Why Behio?
+
+- **You own the frontend.** Build it in Next.js, Astro, Nuxt, SvelteKit, React Native — or use plain HTML. The backend doesn't care.
+- **Production-ready e-commerce backend in minutes.** Product catalog, cart, checkout, customer accounts, orders, tracking, CMS pages, discount codes, volume pricing, multi-warehouse inventory — all included.
+- **Built for developers.** Type-safe, auto-completing, fully documented. Modern React hooks with TanStack Query under the hood. Automatic token refresh, optimistic cart updates, SSR prefetch support.
+- **Scale-ready.** Redis caching, rate limiting, webhooks, API keys with scoped permissions. From MVP to millions of orders on the same stack.
+- **Admin UI you don't have to build.** Behio comes with a full admin dashboard for managing products, orders, customers, CMS content, and analytics. You focus on the customer experience.
+
+**Perfect for:**
+- Agencies building custom e-shops for clients
+- Brands that want their storefront to look and feel unique
+- SaaS apps that need built-in commerce
+- Headless migrations from Shopify, WooCommerce, PrestaShop
+
+## Get started
 
 ```bash
 npm install @behio/storefront-sdk

package/dist/{chunk-3OJEEMLI.mjs → chunk-DBZPF3IR.mjs}

@@ -91,7 +91,7 @@ var BehioStorefront = class {
     this.apiKey = config.apiKey;
     this.defaultLocale = config.locale;
     this.defaultCurrency = config.currency;
-    this.fetchFn = config.fetch || globalThis.fetch;
+    this.fetchFn = config.fetch || globalThis.fetch.bind(globalThis);
     this.timeout = config.timeout ?? 3e4;
     this.retries = config.retries ?? 1;
     this.retryDelay = config.retryDelay ?? 1e3;
@@ -201,20 +201,22 @@ var BehioStorefront = class {
   // --- Internal fetch ---
   /** @internal */
   async request(method, path, options) {
-    const url = new URL(`${this.baseUrl}/storefront/v1${path}`);
+    const params = new URLSearchParams();
     if (options?.query) {
       for (const [key, value] of Object.entries(options.query)) {
         if (value !== void 0 && value !== null && value !== "") {
-          url.searchParams.set(key, String(value));
+          params.set(key, String(value));
         }
       }
     }
-    if (this.defaultLocale && !url.searchParams.has("locale")) {
-      url.searchParams.set("locale", this.defaultLocale);
+    if (this.defaultLocale && !params.has("locale")) {
+      params.set("locale", this.defaultLocale);
     }
-    if (this.defaultCurrency && !url.searchParams.has("currency")) {
-      url.searchParams.set("currency", this.defaultCurrency);
+    if (this.defaultCurrency && !params.has("currency")) {
+      params.set("currency", this.defaultCurrency);
     }
+    const qs = params.toString();
+    const url = `${this.baseUrl}/storefront/v1${path}${qs ? `?${qs}` : ""}`;
     const headers = {
       "X-Api-Key": this.apiKey,
       "Content-Type": "application/json"
@@ -227,7 +229,7 @@ var BehioStorefront = class {
     }
     const bodyStr = options?.body ? JSON.stringify(options.body) : void 0;
     let interceptedConfig = {
-      url: url.toString(),
+      url,
       method,
       headers,
       body: bodyStr

package/dist/{chunk-26WZOAWP.js → chunk-SNODOM7L.js}

@@ -91,7 +91,7 @@ var BehioStorefront = class {
     this.apiKey = config.apiKey;
     this.defaultLocale = config.locale;
     this.defaultCurrency = config.currency;
-    this.fetchFn = config.fetch || globalThis.fetch;
+    this.fetchFn = config.fetch || globalThis.fetch.bind(globalThis);
     this.timeout = _nullishCoalesce(config.timeout, () => ( 3e4));
     this.retries = _nullishCoalesce(config.retries, () => ( 1));
     this.retryDelay = _nullishCoalesce(config.retryDelay, () => ( 1e3));
@@ -201,20 +201,22 @@ var BehioStorefront = class {
   // --- Internal fetch ---
   /** @internal */
   async request(method, path, options) {
-    const url = new URL(`${this.baseUrl}/storefront/v1${path}`);
+    const params = new URLSearchParams();
     if (_optionalChain([options, 'optionalAccess', _12 => _12.query])) {
       for (const [key, value] of Object.entries(options.query)) {
         if (value !== void 0 && value !== null && value !== "") {
-          url.searchParams.set(key, String(value));
+          params.set(key, String(value));
         }
       }
     }
-    if (this.defaultLocale && !url.searchParams.has("locale")) {
-      url.searchParams.set("locale", this.defaultLocale);
+    if (this.defaultLocale && !params.has("locale")) {
+      params.set("locale", this.defaultLocale);
     }
-    if (this.defaultCurrency && !url.searchParams.has("currency")) {
-      url.searchParams.set("currency", this.defaultCurrency);
+    if (this.defaultCurrency && !params.has("currency")) {
+      params.set("currency", this.defaultCurrency);
     }
+    const qs = params.toString();
+    const url = `${this.baseUrl}/storefront/v1${path}${qs ? `?${qs}` : ""}`;
     const headers = {
       "X-Api-Key": this.apiKey,
       "Content-Type": "application/json"
@@ -227,7 +229,7 @@ var BehioStorefront = class {
     }
     const bodyStr = _optionalChain([options, 'optionalAccess', _14 => _14.body]) ? JSON.stringify(options.body) : void 0;
     let interceptedConfig = {
-      url: url.toString(),
+      url,
       method,
       headers,
       body: bodyStr

package/dist/index.js

@@ -7,7 +7,7 @@
 
 
 
-var _chunk26WZOAWPjs = require('./chunk-26WZOAWP.js');
+var _chunkSNODOM7Ljs = require('./chunk-SNODOM7L.js');
 
 
 
@@ -17,4 +17,4 @@ var _chunk26WZOAWPjs = require('./chunk-26WZOAWP.js');
 
 
 
-exports.AddressTypes = _chunk26WZOAWPjs.AddressTypes; exports.BehioApiError = _chunk26WZOAWPjs.BehioApiError; exports.BehioNetworkError = _chunk26WZOAWPjs.BehioNetworkError; exports.BehioStorefront = _chunk26WZOAWPjs.BehioStorefront; exports.FulfillmentStatuses = _chunk26WZOAWPjs.FulfillmentStatuses; exports.OrderStatuses = _chunk26WZOAWPjs.OrderStatuses; exports.PaymentStatuses = _chunk26WZOAWPjs.PaymentStatuses; exports.ProductSort = _chunk26WZOAWPjs.ProductSort;
+exports.AddressTypes = _chunkSNODOM7Ljs.AddressTypes; exports.BehioApiError = _chunkSNODOM7Ljs.BehioApiError; exports.BehioNetworkError = _chunkSNODOM7Ljs.BehioNetworkError; exports.BehioStorefront = _chunkSNODOM7Ljs.BehioStorefront; exports.FulfillmentStatuses = _chunkSNODOM7Ljs.FulfillmentStatuses; exports.OrderStatuses = _chunkSNODOM7Ljs.OrderStatuses; exports.PaymentStatuses = _chunkSNODOM7Ljs.PaymentStatuses; exports.ProductSort = _chunkSNODOM7Ljs.ProductSort;

package/dist/index.mjs

@@ -7,7 +7,7 @@ import {
   OrderStatuses,
   PaymentStatuses,
   ProductSort
-} from "./chunk-3OJEEMLI.mjs";
+} from "./chunk-DBZPF3IR.mjs";
 export {
   AddressTypes,
   BehioApiError,

package/dist/react.js

@@ -1,6 +1,6 @@
 "use strict";Object.defineProperty(exports, "__esModule", {value: true}); function _nullishCoalesce(lhs, rhsFn) { if (lhs != null) { return lhs; } else { return rhsFn(); } } function _optionalChain(ops) { let lastAccessLHS = undefined; let value = ops[0]; let i = 1; while (i < ops.length) { const op = ops[i]; const fn = ops[i + 1]; i += 2; if ((op === 'optionalAccess' || op === 'optionalCall') && value == null) { return undefined; } if (op === 'access' || op === 'optionalAccess') { lastAccessLHS = value; value = fn(value); } else if (op === 'call' || op === 'optionalCall') { value = fn((...args) => value.call(lastAccessLHS, ...args)); lastAccessLHS = undefined; } } return value; }
 
-var _chunk26WZOAWPjs = require('./chunk-26WZOAWP.js');
+var _chunkSNODOM7Ljs = require('./chunk-SNODOM7L.js');
 
 // src/react/provider.tsx
 var _react = require('react');
@@ -114,7 +114,7 @@ function BehioProvider({
   const storageAdapter = _react.useMemo.call(void 0, () => resolveStorage(storageOption), [storageOption]);
   const clientRef = _react.useRef.call(void 0, null);
   if (!clientRef.current) {
-    clientRef.current = new (0, _chunk26WZOAWPjs.BehioStorefront)({
+    clientRef.current = new (0, _chunkSNODOM7Ljs.BehioStorefront)({
       apiKey,
       baseUrl,
       locale,

package/dist/react.mjs

@@ -1,6 +1,6 @@
 import {
   BehioStorefront
-} from "./chunk-3OJEEMLI.mjs";
+} from "./chunk-DBZPF3IR.mjs";
 
 // src/react/provider.tsx
 import { useRef, useEffect, useMemo } from "react";

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@behio/storefront-sdk",
-  "version": "0.1.0",
+  "version": "0.1.2",
   "description": "TypeScript SDK for Behio Headless E-Shop — core client + React hooks",
   "author": "Behio",
   "license": "MIT",