@doswiftly/storefront-sdk 14.0.0 → 16.0.0

package/dist/react/hooks/use-format.js

@@ -0,0 +1,141 @@
+/**
+ * Convenience hooks that pull the active language from `<StorefrontProvider>`
+ * and forward it to the core format utilities. Use these inside the provider
+ * tree for boilerplate-free locale-aware formatting; outside the provider,
+ * fall back to the vanilla `formatPrice` / `formatDate` / etc. from
+ * `@doswiftly/storefront-sdk` with an explicit `locale` argument.
+ *
+ * Each hook returns a memoised function so it's safe to use directly in
+ * render. The function accepts an optional final `localeOverride` argument
+ * that wins over the store value — handy for per-call overrides (e.g. a
+ * "show in US format" toggle on one element while the rest of the UI stays
+ * in Polish).
+ *
+ * Resolution order per call:
+ *   1. `localeOverride` argument                                  (highest)
+ *   2. `useLanguageStore().language` from `<StorefrontProvider>`
+ *   3. Runtime default (`Intl.NumberFormat().resolvedOptions().locale`)
+ */
+'use client';
+import { useCallback } from 'react';
+import { useLanguageStore } from '../stores/store-context';
+import { formatPrice as coreFormatPrice, formatAmount as coreFormatAmount, formatPriceRange as coreFormatPriceRange, formatDate as coreFormatDate, formatDateTime as coreFormatDateTime, formatNumber as coreFormatNumber, getCurrencySymbol as coreGetCurrencySymbol, } from '../../core/format';
+// ---------------------------------------------------------------------------
+// Locale resolution
+// ---------------------------------------------------------------------------
+let runtimeLocaleCache;
+function getRuntimeLocale() {
+    if (runtimeLocaleCache === undefined) {
+        runtimeLocaleCache = new Intl.NumberFormat().resolvedOptions().locale;
+    }
+    return runtimeLocaleCache;
+}
+/**
+ * Read the active language from `useLanguageStore` and fall back to the
+ * runtime default when the store hasn't been initialised yet (e.g. before the
+ * first Shop query has resolved). Internal helper for every convenience hook
+ * in this file — the selector-based subscription means consumers only
+ * re-render when the language actually changes.
+ */
+function useResolvedLocale() {
+    const language = useLanguageStore((s) => s.language);
+    return language ?? getRuntimeLocale();
+}
+// ---------------------------------------------------------------------------
+// Price formatters
+// ---------------------------------------------------------------------------
+/**
+ * Memoised `formatPrice` bound to the active language from `<StorefrontProvider>`.
+ * Pass `localeOverride` as the second argument to override the store value for
+ * a single call.
+ *
+ * @example
+ * const formatPrice = useFormatPrice();
+ * return <span>{formatPrice(item.price)}</span>;
+ *
+ * @example
+ * // Per-call override:
+ * const formatPrice = useFormatPrice();
+ * <span>{formatPrice(item.price, 'en-US')}</span>
+ */
+export function useFormatPrice() {
+    const locale = useResolvedLocale();
+    return useCallback((price, localeOverride) => coreFormatPrice(price, localeOverride ?? locale), [locale]);
+}
+/**
+ * Memoised `formatAmount` bound to the active language from `<StorefrontProvider>`.
+ *
+ * @example
+ * const formatAmount = useFormatAmount();
+ * return <span>{formatAmount(item.totalPrice.amount, item.totalPrice.currencyCode)}</span>;
+ */
+export function useFormatAmount() {
+    const locale = useResolvedLocale();
+    return useCallback((amount, currencyCode, localeOverride) => coreFormatAmount(amount, currencyCode, localeOverride ?? locale), [locale]);
+}
+/**
+ * Memoised `formatPriceRange` bound to the active language from `<StorefrontProvider>`.
+ *
+ * @example
+ * const formatPriceRange = useFormatPriceRange();
+ * return <span>{formatPriceRange(min, max)}</span>;
+ */
+export function useFormatPriceRange() {
+    const locale = useResolvedLocale();
+    return useCallback((minPrice, maxPrice, localeOverride) => coreFormatPriceRange(minPrice, maxPrice, localeOverride ?? locale), [locale]);
+}
+// ---------------------------------------------------------------------------
+// Date formatters
+// ---------------------------------------------------------------------------
+/**
+ * Memoised `formatDate` bound to the active language from `<StorefrontProvider>`.
+ *
+ * @example
+ * const formatDate = useFormatDate();
+ * return <span>{formatDate(order.processedAt)}</span>;
+ */
+export function useFormatDate() {
+    const locale = useResolvedLocale();
+    return useCallback((date, localeOverride) => coreFormatDate(date, localeOverride ?? locale), [locale]);
+}
+/**
+ * Memoised `formatDateTime` bound to the active language from `<StorefrontProvider>`.
+ *
+ * @example
+ * const formatDateTime = useFormatDateTime();
+ * return <span>{formatDateTime(event.timestamp)}</span>;
+ */
+export function useFormatDateTime() {
+    const locale = useResolvedLocale();
+    return useCallback((date, localeOverride) => coreFormatDateTime(date, localeOverride ?? locale), [locale]);
+}
+// ---------------------------------------------------------------------------
+// Number formatters
+// ---------------------------------------------------------------------------
+/**
+ * Memoised `formatNumber` bound to the active language from `<StorefrontProvider>`.
+ *
+ * @example
+ * const formatNumber = useFormatNumber();
+ * return <span>{formatNumber(points.balance)}</span>;
+ */
+export function useFormatNumber() {
+    const locale = useResolvedLocale();
+    return useCallback((num, localeOverride) => coreFormatNumber(num, localeOverride ?? locale), [locale]);
+}
+// ---------------------------------------------------------------------------
+// Currency symbol
+// ---------------------------------------------------------------------------
+/**
+ * Memoised `getCurrencySymbol` bound to the active language from
+ * `<StorefrontProvider>`. The returned symbol is locale-dependent — see
+ * `getCurrencySymbol` in core for examples.
+ *
+ * @example
+ * const getCurrencySymbol = useGetCurrencySymbol();
+ * return <span>{getCurrencySymbol(shop.currencyCode)}</span>;
+ */
+export function useGetCurrencySymbol() {
+    const locale = useResolvedLocale();
+    return useCallback((code, localeOverride) => coreGetCurrencySymbol(code, localeOverride ?? locale), [locale]);
+}

package/dist/react/index.d.ts

@@ -20,6 +20,7 @@ export { useLogin, type UseLoginOptions, type UseLoginReturn } from './hooks/use
 export { useLogout, type UseLogoutOptions, type UseLogoutReturn } from './hooks/use-logout';
 export { useRefreshToken, type UseRefreshTokenOptions, type UseRefreshTokenReturn } from './hooks/use-refresh-token';
 export { useCartManager, type CartManagerOperation, type CartManagerStatus, type UseCartManagerResult } from './hooks/use-cart-manager';
+export { useCart, type UseCartOptions, type UseCartResult, type ServerCartOperation } from './hooks/use-cart';
 export { useStorefrontClient } from './hooks/use-storefront-client';
 export { useCurrency } from './hooks/use-currency';
 export { useAuthStore, useAuthStoreApi, useAuthHydrated } from './stores/store-context';
@@ -35,6 +36,7 @@ export { getCookie, setCookie, deleteCookie, getCurrencyFromCookieAsync, getCart
 export { useBotProtection } from './hooks/use-bot-protection';
 export { useHydrated } from './hooks/use-hydrated';
 export { useDebouncedValue } from './hooks/use-debounced-value';
+export { useFormatPrice, useFormatAmount, useFormatPriceRange, useFormatDate, useFormatDateTime, useFormatNumber, useGetCurrencySymbol, } from './hooks/use-format';
 export { createCartStore, selectCartId, selectIsCartOpen, selectCartIsLoading, } from './stores/cart.store';
 export type { CartState, CartStoreConfig, CartActions, CartData, CartMutationAction, CartLineInput, CartLineUpdateInput, } from './stores/cart.store';
 export { CartProvider, useCartStore, useCartStoreApi } from './stores/cart.context';

package/dist/react/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/react/index.ts"],"names":[],"mappings":"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"}

package/dist/react/index.js

@@ -22,6 +22,7 @@ export { useLogin } from './hooks/use-login';
 export { useLogout } from './hooks/use-logout';
 export { useRefreshToken } from './hooks/use-refresh-token';
 export { useCartManager } from './hooks/use-cart-manager';
+export { useCart } from './hooks/use-cart';
 export { useStorefrontClient } from './hooks/use-storefront-client';
 export { useCurrency } from './hooks/use-currency';
 // Store hooks (Context-based)
@@ -38,6 +39,8 @@ export { useBotProtection } from './hooks/use-bot-protection';
 // Generic hooks
 export { useHydrated } from './hooks/use-hydrated';
 export { useDebouncedValue } from './hooks/use-debounced-value';
+// Format hooks (Context-driven — pull locale from `useLanguageStore`)
+export { useFormatPrice, useFormatAmount, useFormatPriceRange, useFormatDate, useFormatDateTime, useFormatNumber, useGetCurrencySymbol, } from './hooks/use-format';
 // Cart store (DI-based)
 export { createCartStore, selectCartId, selectIsCartOpen, selectCartIsLoading, } from './stores/cart.store';
 export { CartProvider, useCartStore, useCartStoreApi } from './stores/cart.context';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "14.0.0",
+  "version": "16.0.0",
   "description": "Storefront runtime SDK for DoSwiftly Commerce — layered transport, middleware pipeline, React providers, Zustand stores, cache strategies. 0 runtime dependencies in core.",
   "type": "module",
   "sideEffects": false,
@@ -41,16 +41,21 @@
   "author": "DoSwiftly Team",
   "license": "MIT",
   "devDependencies": {
+    "@graphql-codegen/cli": "^5.0.0",
+    "@graphql-codegen/typescript": "^4.0.0",
+    "@graphql-codegen/typescript-operations": "^4.0.0",
     "@testing-library/react": "^16.1.0",
     "@types/node": "^22.10.2",
     "@types/react": "^18.3.0 || ^19.0.0",
     "@types/react-dom": "^19.0.0",
     "@vitest/coverage-v8": "^4.1.0",
     "fast-check": "^3.23.2",
+    "graphql": "^16.13.2",
     "jsdom": "^25.0.1",
     "next": "^16.2.3",
     "react": "^19.0.0",
     "react-dom": "^19.0.0",
+    "tsx": "^4.0.0",
     "typescript": "^5.7.2",
     "vitest": "^4.1.0",
     "zustand": "^5.0.2"
@@ -70,6 +75,7 @@
   "scripts": {
     "build": "tsc",
     "build:only": "tsc",
+    "codegen": "tsx scripts/codegen.mts",
     "dev": "tsc --watch",
     "clean": "rm -rf dist",
     "test": "vitest run",