@doswiftly/storefront-sdk 4.3.0 → 4.4.0

package/README.md

@@ -7,7 +7,7 @@ Layered runtime SDK for DoSwiftly Commerce storefronts. Hydrogen-aligned archite
 ```
 @doswiftly/storefront-sdk
 ├── core (.)              — Framework-agnostic: transport, middleware, CartClient, AuthClient,
-│                           cache, format utilities, image loader, sanitizeHtml,
+│                           cache, format utilities, image types, sanitizeHtml,
 │                           normalizeConnection, auth cookie config/handlers/token client, route matching
 ├── react (./react)       — React adapter: providers, Zustand stores (Context-based), hooks,
 │                           useHydrated, useDebouncedValue, createStoreContext
@@ -93,7 +93,7 @@ const { currency, setCurrency } = useCurrencyStore();
 
 | Path | Description | Dependencies |
 |------|-------------|-------------|
-| `@doswiftly/storefront-sdk` | Core: transport, middleware, clients, errors, format, image loader, sanitize, auth handlers, route matching | **0** |
+| `@doswiftly/storefront-sdk` | Core: transport, middleware, clients, errors, format, image types, sanitize, auth handlers, route matching | **0** |
 | `@doswiftly/storefront-sdk/react` | Providers, hooks, store hooks, useHydrated, useDebouncedValue, createStoreContext | react, zustand |
 | `@doswiftly/storefront-sdk/react/server` | Server-side client factory | react |
 | `@doswiftly/storefront-sdk/cache` | Cache strategy functions | **0** |
@@ -213,19 +213,11 @@ formatDate(new Date());                                // "Dec 9, 2025"
 formatPercentage(0.15);                                // "15%"
 ```
 
-### Image Loader (CDN)
+### Image Types
 
-Template ships with global `loaderFile` in `next.config.ts` — ALL `<Image>` components are optimized automatically. No per-component configuration needed.
+GraphQL API returns ready-to-use CDN URLs via `url(transform: { maxWidth: 800 })`. No client-side loader needed.
 
-```typescript
-// For custom frameworks (Svelte, Astro, etc.) — import the loader function directly:
-import { storefrontImageLoader } from '@doswiftly/storefront-sdk';
-
-const url = storefrontImageLoader({ src: image.url, width: 800, quality: 85 });
-// → image.url + "?width=800&quality=85&format=webp"
-```
-
-Width quantized to Next.js-aligned breakpoints for CDN cache efficiency. `ImageData` type matches GraphQL `Image` fragment: `{ url, altText?, width?, height?, id? }`.
+`ImageData` type matches GraphQL `Image` fragment: `{ url, altText?, width?, height?, id? }`.
 
 ### HTML Sanitizer
 
@@ -456,7 +448,7 @@ SDK provides:                    Template owns:
 ├── Providers + Zustand stores   ├── lib/graphql/fragments/
 ├── Format utilities             ├── hooks/use-cart-di.ts (CartActions DI impl)
 ├── sanitizeHtml                 ├── hooks/use-cart-actions.ts (UX wrapper)
-├── createImageLoader (CDN)      ├── components/product/product-image.tsx
+├── ImageData type               ├── components/product/product-image.tsx
 ├── normalizeConnection          ├── stores/ (checkout, wishlist via createStoreContext)
 ├── Auth handlers + token client ├── lib/auth/routes.ts (route config)
 ├── useHydrated + useDebouncedValue

package/dist/core/image.d.ts

@@ -1,21 +1,14 @@
 /**
- * Image utilities for DoSwiftly storefronts.
+ * Image types for DoSwiftly storefronts.
  *
- * Zero configuration — GraphQL API returns ready-to-use CDN URLs.
- * The loader just appends resize query params. No keys, no env vars.
- *
- * @example
- * ```typescript
- * import { storefrontImageLoader, type ImageData } from '@doswiftly/storefront-sdk';
- *
- * <Image loader={storefrontImageLoader} src={product.featuredImage.url} width={800} alt="..." />
- * ```
+ * GraphQL API returns ready-to-use CDN URLs with transform query params.
+ * No client-side loader needed — use `url(transform: { maxWidth: 800 })` in queries.
  */
 /**
  * Image data from GraphQL API (matches Image type in storefront schema).
  */
 export interface ImageData {
-    /** Image URL from GraphQL (ready-to-use CDN URL) */
+    /** Image URL from GraphQL (ready-to-use CDN URL, optionally with transform query params) */
     url: string;
     /** Alt text for accessibility + SEO */
     altText?: string | null;
@@ -26,39 +19,4 @@ export interface ImageData {
     /** Image ID */
     id?: string | null;
 }
-/**
- * Next.js Image loader function signature.
- */
-export interface ImageLoaderParams {
-    src: string;
-    width: number;
-    quality?: number;
-}
-/**
- * Image format for imgproxy output.
- */
-export type ImageFormat = 'webp' | 'avif' | 'jpeg';
-/**
- * Default image loader — WebP format. Used as global loaderFile in next.config.ts.
- * Zero configuration: works out-of-the-box with GraphQL image URLs.
- * Width quantized to preset breakpoints for optimal CDN cache.
- *
- * @example
- * ```tsx
- * import { storefrontImageLoader } from '@doswiftly/storefront-sdk';
- * <Image loader={storefrontImageLoader} src={image.url} width={800} alt="..." />
- * ```
- */
-export declare function storefrontImageLoader({ src, width, quality }: ImageLoaderParams): string;
-/**
- * Create a custom loader with specific format (avif, jpeg).
- * Use as per-component override when you need a different format than default WebP.
- *
- * @example
- * ```tsx
- * const avifLoader = createImageLoader('avif');
- * <Image loader={avifLoader} src={image.url} width={800} alt="..." />
- * ```
- */
-export declare function createImageLoader(format: ImageFormat): (params: ImageLoaderParams) => string;
 //# sourceMappingURL=image.d.ts.map

package/dist/core/image.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/core/image.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;GAYG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,oDAAoD;IACpD,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB;AAED;;GAEG;AACH,MAAM,WAAW,iBAAiB;IAChC,GAAG,EAAE,MAAM,CAAC;IACZ,KAAK,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;CAClB;AAED;;GAEG;AACH,MAAM,MAAM,WAAW,GAAG,MAAM,GAAG,MAAM,GAAG,MAAM,CAAC;AAenD;;;;;;;;;;GAUG;AACH,wBAAgB,qBAAqB,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,OAAO,EAAE,EAAE,iBAAiB,GAAG,MAAM,CAExF;AAED;;;;;;;;;GASG;AACH,wBAAgB,iBAAiB,CAAC,MAAM,EAAE,WAAW,GAAG,CAAC,MAAM,EAAE,iBAAiB,KAAK,MAAM,CAE5F"}
+{"version":3,"file":"image.d.ts","sourceRoot":"","sources":["../../src/core/image.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAEH;;GAEG;AACH,MAAM,WAAW,SAAS;IACxB,4FAA4F;IAC5F,GAAG,EAAE,MAAM,CAAC;IACZ,uCAAuC;IACvC,OAAO,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACxB,qCAAqC;IACrC,KAAK,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACtB,sCAAsC;IACtC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;IACvB,eAAe;IACf,EAAE,CAAC,EAAE,MAAM,GAAG,IAAI,CAAC;CACpB"}

package/dist/core/image.js

@@ -1,68 +1,7 @@
 /**
- * Image utilities for DoSwiftly storefronts.
+ * Image types for DoSwiftly storefronts.
  *
- * Zero configuration — GraphQL API returns ready-to-use CDN URLs.
- * The loader just appends resize query params. No keys, no env vars.
- *
- * @example
- * ```typescript
- * import { storefrontImageLoader, type ImageData } from '@doswiftly/storefront-sdk';
- *
- * <Image loader={storefrontImageLoader} src={product.featuredImage.url} width={800} alt="..." />
- * ```
- */
-/**
- * Preset widths for CDN cache optimization.
- * Loader quantizes requested width to the nearest preset — limits cache variants.
- */
-const PRESET_WIDTHS = [150, 320, 640, 750, 828, 1080, 1200, 1600, 1920, 2048];
-function nearestPresetWidth(requested) {
-    for (const w of PRESET_WIDTHS) {
-        if (w >= requested)
-            return w;
-    }
-    return PRESET_WIDTHS[PRESET_WIDTHS.length - 1];
-}
-/**
- * Default image loader — WebP format. Used as global loaderFile in next.config.ts.
- * Zero configuration: works out-of-the-box with GraphQL image URLs.
- * Width quantized to preset breakpoints for optimal CDN cache.
- *
- * @example
- * ```tsx
- * import { storefrontImageLoader } from '@doswiftly/storefront-sdk';
- * <Image loader={storefrontImageLoader} src={image.url} width={800} alt="..." />
- * ```
- */
-export function storefrontImageLoader({ src, width, quality }) {
-    return buildImgproxyUrl(src, width, quality);
-}
-/**
- * Create a custom loader with specific format (avif, jpeg).
- * Use as per-component override when you need a different format than default WebP.
- *
- * @example
- * ```tsx
- * const avifLoader = createImageLoader('avif');
- * <Image loader={avifLoader} src={image.url} width={800} alt="..." />
- * ```
+ * GraphQL API returns ready-to-use CDN URLs with transform query params.
+ * No client-side loader needed — use `url(transform: { maxWidth: 800 })` in queries.
  */
-export function createImageLoader(format) {
-    return ({ src, width, quality }) => buildImgproxyUrl(src, width, quality, format);
-}
-function buildImgproxyUrl(src, width, quality, format = 'webp') {
-    const w = nearestPresetWidth(width);
-    const q = quality ?? 85;
-    if (!src.startsWith('http')) {
-        return src;
-    }
-    try {
-        const url = new URL(src);
-        const path = url.pathname.slice(1);
-        return `${url.origin}/rs:fit:${w}:0:0/q:${q}/f:${format}/plain/${path}`;
-    }
-    catch {
-        // Malformed URL — return as-is, let browser handle it
-        return src;
-    }
-}
+export {};

package/dist/core/index.d.ts

@@ -61,7 +61,7 @@ export { CART_COOKIE_NAME, CART_COOKIE_MAX_AGE } from './cart/cookie-config';
 export { matchesRoute, type RouteProtectionConfig } from './auth/routes';
 export { createSetTokenHandler, createClearTokenHandler } from './auth/handlers';
 export { createAuthTokenClient, type AuthTokenClient } from './auth/token-client';
-export { storefrontImageLoader, createImageLoader, type ImageData, type ImageLoaderParams, type ImageFormat, } from './image';
+export { type ImageData } from './image';
 export { getOperationName } from './client/operation-name';
 export { hashQuery } from './client/hash';
 //# sourceMappingURL=index.d.ts.map

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

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

package/dist/core/index.js

@@ -74,8 +74,6 @@ export { matchesRoute } from './auth/routes';
 export { createSetTokenHandler, createClearTokenHandler } from './auth/handlers';
 // Auth token client (client-side fetch helpers)
 export { createAuthTokenClient } from './auth/token-client';
-// Image utilities
-export { storefrontImageLoader, createImageLoader, } from './image';
 // Utilities
 export { getOperationName } from './client/operation-name';
 export { hashQuery } from './client/hash';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "4.3.0",
+  "version": "4.4.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",
   "types": "dist/core/index.d.ts",

package/src/core/image.ts

@@ -1,22 +1,15 @@
 /**
- * Image utilities for DoSwiftly storefronts.
+ * Image types for DoSwiftly storefronts.
  *
- * Zero configuration — GraphQL API returns ready-to-use CDN URLs.
- * The loader just appends resize query params. No keys, no env vars.
- *
- * @example
- * ```typescript
- * import { storefrontImageLoader, type ImageData } from '@doswiftly/storefront-sdk';
- *
- * <Image loader={storefrontImageLoader} src={product.featuredImage.url} width={800} alt="..." />
- * ```
+ * GraphQL API returns ready-to-use CDN URLs with transform query params.
+ * No client-side loader needed — use `url(transform: { maxWidth: 800 })` in queries.
  */
 
 /**
  * Image data from GraphQL API (matches Image type in storefront schema).
  */
 export interface ImageData {
-  /** Image URL from GraphQL (ready-to-use CDN URL) */
+  /** Image URL from GraphQL (ready-to-use CDN URL, optionally with transform query params) */
   url: string;
   /** Alt text for accessibility + SEO */
   altText?: string | null;
@@ -27,77 +20,3 @@ export interface ImageData {
   /** Image ID */
   id?: string | null;
 }
-
-/**
- * Next.js Image loader function signature.
- */
-export interface ImageLoaderParams {
-  src: string;
-  width: number;
-  quality?: number;
-}
-
-/**
- * Image format for imgproxy output.
- */
-export type ImageFormat = 'webp' | 'avif' | 'jpeg';
-
-/**
- * Preset widths for CDN cache optimization.
- * Loader quantizes requested width to the nearest preset — limits cache variants.
- */
-const PRESET_WIDTHS = [150, 320, 640, 750, 828, 1080, 1200, 1600, 1920, 2048] as const;
-
-function nearestPresetWidth(requested: number): number {
-  for (const w of PRESET_WIDTHS) {
-    if (w >= requested) return w;
-  }
-  return PRESET_WIDTHS[PRESET_WIDTHS.length - 1];
-}
-
-/**
- * Default image loader — WebP format. Used as global loaderFile in next.config.ts.
- * Zero configuration: works out-of-the-box with GraphQL image URLs.
- * Width quantized to preset breakpoints for optimal CDN cache.
- *
- * @example
- * ```tsx
- * import { storefrontImageLoader } from '@doswiftly/storefront-sdk';
- * <Image loader={storefrontImageLoader} src={image.url} width={800} alt="..." />
- * ```
- */
-export function storefrontImageLoader({ src, width, quality }: ImageLoaderParams): string {
-  return buildImgproxyUrl(src, width, quality);
-}
-
-/**
- * Create a custom loader with specific format (avif, jpeg).
- * Use as per-component override when you need a different format than default WebP.
- *
- * @example
- * ```tsx
- * const avifLoader = createImageLoader('avif');
- * <Image loader={avifLoader} src={image.url} width={800} alt="..." />
- * ```
- */
-export function createImageLoader(format: ImageFormat): (params: ImageLoaderParams) => string {
-  return ({ src, width, quality }) => buildImgproxyUrl(src, width, quality, format);
-}
-
-function buildImgproxyUrl(src: string, width: number, quality?: number, format: ImageFormat = 'webp'): string {
-  const w = nearestPresetWidth(width);
-  const q = quality ?? 85;
-
-  if (!src.startsWith('http')) {
-    return src;
-  }
-
-  try {
-    const url = new URL(src);
-    const path = url.pathname.slice(1);
-    return `${url.origin}/rs:fit:${w}:0:0/q:${q}/f:${format}/plain/${path}`;
-  } catch {
-    // Malformed URL — return as-is, let browser handle it
-    return src;
-  }
-}

package/src/core/index.ts

@@ -166,14 +166,8 @@ export { createSetTokenHandler, createClearTokenHandler } from './auth/handlers'
 // Auth token client (client-side fetch helpers)
 export { createAuthTokenClient, type AuthTokenClient } from './auth/token-client';
 
-// Image utilities
-export {
-  storefrontImageLoader,
-  createImageLoader,
-  type ImageData,
-  type ImageLoaderParams,
-  type ImageFormat,
-} from './image';
+// Image types (loaders removed — GraphQL returns ready-to-use CDN URLs with transform params)
+export { type ImageData } from './image';
 
 // Utilities
 export { getOperationName } from './client/operation-name';