@doswiftly/storefront-sdk 4.7.1 → 4.7.2

package/CHANGELOG.md

@@ -0,0 +1,149 @@
+# Changelog
+
+## 4.7.2
+
+### Patch Changes
+
+- 7846bdb: Fix `doswiftly dev` port pre-flight on Windows (and any host where another
+  process binds the port on IPv6 `::` only): the probe now checks IPv4 and
+  IPv6 in parallel and requires BOTH free before marking a port as available.
+  Previously an IPv6-only conflict (common on Windows, where Next.js binds
+  `::` by default) slipped past the IPv4-only probe — the banner advertised
+  `http://localhost:3000` and the framework immediately crashed with
+  `EADDRINUSE :::3000`. With this fix `doswiftly dev` falls back to the next
+  free port (3001, 3002, …) as documented.
+
+  Also ship `CHANGELOG.md` inside the npm tarball. Previous releases packed
+  only `dist`/`bin`/`templates` (and `schema.graphql`/operations for
+  `storefront-operations`, `dist` for `storefront-sdk`), so consumers who
+  `npm install @doswiftly/cli` got a version number with no user-visible
+  release notes.
+
+Wszystkie istotne zmiany w `@doswiftly/storefront-sdk` sa dokumentowane w tym pliku.
+Format oparty na [Keep a Changelog](https://keepachangelog.com/pl/1.1.0/).
+Wersjonowanie zgodne z [Semantic Versioning](https://semver.org/).
+
+## [4.7.1] - 2026-04-17
+
+### Security
+
+- Bump `next` devDependency range to `^16.2.3` (GHSA-q4gf-8mx6-v5v3 — Next.js DoS via Server Components). Brak zmian API SDK.
+
+## [4.7.0] - 2026-04-14
+
+### Added
+
+- **`CartAttributeSelectionInput`** — nowy typ mirrorujący GraphQL `AttributeSelectionInput` dla konfiguratorów produktu (Faza 1 Unified Product Configurator).
+- **`CartLineInput.attributeSelections`** — opcjonalne customer-filled atrybuty (Finiszer, nr telefonu serwisu itp.). Backend waliduje i snapshotuje pole `surcharge_amount` / `tax_rate`.
+- **`CartLineUpdateInput.attributeSelections`** — update selekcji po stronie koszyka (`null` = preserve, `[]` = clear, tablica = replace).
+
+### Changed
+
+- Mutacje `cartLinesAdd` / `cartLinesUpdate` przekazują teraz `attributeSelections` przez GraphQL variables (bez zmian w treści mutacji — typ po stronie schematu backendu).
+
+## [4.6.0] - 2026-04-11
+
+### Breaking Changes
+
+- **Image fragment**: `url` field now includes `transform: { maxWidth: 300 }` argument — cart images return CDN-resized thumbnails instead of full-size originals
+- **ImageData interface**: added `thumbhash?: string | null` field
+- **CartLineMerchandise.image**: added `thumbhash` field to image shape
+
+### Added
+
+- **Image transforms in cart operations**: CDN serves correctly-sized thumbnails (300px) instead of full originals. Reduces bandwidth ~10x for cart page.
+- **ThumbHash support**: `Image` fragment now requests `thumbhash` field — base64-encoded perceptual placeholder (~40 chars). Decode with `thumbHashToDataURL()` for instant blur previews.
+- **`thumbHashToDataURL(base64Hash)`**: New export from core — decodes ThumbHash to `data:image/bmp;base64,...` URL for Next.js `blurDataURL` prop. Pure math, zero deps, framework-agnostic.
+- **AVIF auto-negotiation**: No `preferredContentType` hardcoded — imgproxy auto-serves AVIF/WEBP based on browser `Accept` header.
+
+## [4.5.0] - 2026-04-11
+
+### Breaking Changes
+
+- **CartClient types**: `CartCost` and `CartLineCost` price fields changed from `Money` to `PriceMoney` (adds `baseAmount`, `baseCurrencyCode`, `exchangeRate`, `marginApplied`, `rateTimestamp`, `isConverted`)
+- **Cart.lines**: changed from `{ edges: Array<{ node: CartLine }> }` to `CartLine[]` (flat array — matches backend schema)
+- **CartDiscountAllocation**: field `discountedAmount` renamed to `amount`, added `discountCode` field
+
+### Fixed
+
+- CartClient GraphQL operations now match SSOT (backend `storefront-graphql/operations/`)
+- Cart fragment no longer uses `edges`/`nodes` connection pattern for `lines` — backend returns flat array
+- `CartDiscountAllocation` uses correct field name `amount` (was `discountedAmount`) and includes `discountCode`
+- `CartCost` and `CartLineCost` use `PriceMoney` fragment (was `Money`) — enables currency conversion transparency
+- `CartLineCost` includes `subtotalAmount` field (was missing)
+- `CartLine` includes `productType` field (was missing)
+- `CartLineMerchandise` now uses full `ProductVariant` fragment (was inline subset) — includes `originalPrice`, `originalCompareAtPrice`, `available`, `quantityAvailable`, `selectedOptions`, `barcode`, `weight`, `position`
+
+### Added
+
+- `PriceMoney` interface in cart types — full currency conversion metadata
+- `SelectedOption` interface in cart types
+- `scripts/validate-cart-operations.cjs` — validates SDK cart fragments match SSOT
+- `pnpm validate:cart` script — runs validation in strict mode
+- Contract test `cart-operations-drift.test.ts` — 40 tests verifying fragment fields, spreads, and structural invariants
+
+## [4.4.0] - 2026-03-29
+
+### Removed
+
+- **Image loader usuniety**: `storefrontImageLoader`, `createImageLoader`, `ImageLoaderParams`, `ImageFormat`, `PRESET_WIDTHS` — GraphQL API zwraca gotowe CDN URL-e z `url(transform: { maxWidth: 800 })`. Client-side loader zbedny.
+- Zachowany: `ImageData` type (uzywany przez template do typowania danych z GraphQL)
+
+## [4.3.0] - 2026-03-29
+
+### Changed
+
+- **Image loader**: imgproxy path-based URLs zamiast query params
+- `createImageLoader()` przyjmuje konfigurowalny `format` (webp/avif/jpeg/auto)
+- `storefrontImageLoader` uzywa nowego path-based schematu
+
+## [4.2.0] - 2026-03-28
+
+### Added
+
+- `storefrontImageLoader` jako globalny image loader dla Next.js (`next.config.ts loaderFile`)
+- Kwantyzacja szerokosc do presetow [150, 320, 640, 750, 828, 1080, 1200, 1600, 1920, 2048]
+
+## [4.1.0] - 2026-03-27
+
+### Added
+
+- `createImageLoader()` — factory do custom image loaderow z konfiguracja baseUrl/format
+- Usunieto HMAC signing (Shopify pattern — imgproxy nie wymaga podpisu w path-based mode)
+
+## [4.0.0] - 2026-03-20
+
+### Breaking Changes
+
+- **Layered architecture**: split na `core/` (framework-agnostic) + `react/` (adapter)
+- Nowe export paths: `.`, `./react`, `./react/server`, `./cache`
+- ESM-only (usuniete CJS)
+- Usuniety re-export `@tanstack/react-query` — hooki React Query generowane lokalnie w template
+- Store pattern zmieniony na Context-based (zustand/vanilla + React Context)
+- Usuniety module-level singleton pattern
+
+### Added
+
+- `createStorefrontClient()` — transport factory z composable middleware pipeline
+- Middleware: `authMiddleware`, `currencyMiddleware`, `languageMiddleware`, `botProtectionMiddleware`, `retryMiddleware`, `timeoutMiddleware`, `errorMiddleware`
+- `CartClient`, `AuthClient` — plain async clients (0 deps, framework-agnostic)
+- `StorefrontError` — zunifikowana klasa bledow z ErrorCodes
+- `StorefrontProvider` — root kompozycji (tworzy store instances via useRef)
+- `createStoreContext()` — generyczny helper Context+Zustand
+- `createCartStore()` z DI pattern (`getActions` getter)
+- `useAuth()`, `useCartManager()`, `useCurrency()`, `useStorefrontClient()`
+- `useHydrated()`, `useAuthHydrated()`, `useDebouncedValue()`
+- `createSetTokenHandler()`, `createClearTokenHandler()` — Web API fabryki
+- `createAuthTokenClient()` — client-side fetch helpers
+- `matchesRoute()` — route protection utility
+- `formatPrice`, `formatPriceRange`, `formatAmount`, `formatDate`, `formatDateTime`, `formatNumber`, `formatPercentage`, `getCurrencySymbol`
+- `sanitizeHtml`, `normalizeConnection`, `assertNoUserErrors`
+- Cache strategies: `cacheNone`, `cacheShort`, `cacheLong`, `cachePrivate`, `cacheCustom`
+- Bot protection: `createBotProtectionManager`, `FallbackBotProtectionManager`, `TurnstileManager`, `EuCaptchaManager`
+- Cookie configs: `AUTH_COOKIE_NAME`, `CURRENCY_COOKIE_NAME`, `LANGUAGE_COOKIE_NAME`, `CART_COOKIE_NAME`
+- `getStorefrontClient()` — server-side factory (react/server)
+
+### Removed
+
+- Runtime deps: `graphql-request`, `graphql`, `graphql-tag`, `@graphql-typed-document-node/core`, `@tanstack/react-query`
+- Module-level store singletons (zastapione Context pattern)

package/package.json

@@ -1,11 +1,12 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "4.7.1",
+  "version": "4.7.2",
   "description": "Storefront runtime SDK for DoSwiftly Commerce — layered transport, middleware pipeline, React providers, Zustand stores, cache strategies. 0 runtime dependencies in core.",
   "type": "module",
   "files": [
     "dist",
-    "README.md"
+    "README.md",
+    "CHANGELOG.md"
   ],
   "types": "dist/core/index.d.ts",
   "exports": {