@doswiftly/storefront-sdk 22.7.0 → 22.8.0

package/CHANGELOG.md

@@ -1,5 +1,37 @@
 # Changelog
 
+## 22.8.0
+
+### Minor Changes
+
+- 9039ba1: Add `getAssetPrefix()` for serving your build's static assets from a CDN domain.
+
+  **Why**: A build's JavaScript, CSS, and font files (`/_next/static/*`) are content-hashed and immutable. Serving them from a CDN domain — rather than your app origin — makes them cache-friendly and keeps them off your storefront server's request path.
+
+  **Additive (backward-compatible)**: a new export from `@doswiftly/storefront-sdk/next`. Nothing changes until you opt in.
+
+  **Usage** — add two lines to `next.config`:
+
+  ```ts
+  // next.config.ts
+  import { getAssetPrefix } from "@doswiftly/storefront-sdk/next";
+
+  const nextConfig = {
+    assetPrefix: getAssetPrefix(),
+    crossOrigin: "anonymous",
+    // ...your existing config
+  };
+  export default nextConfig;
+  ```
+
+  `getAssetPrefix()` returns the CDN base injected by the deploy pipeline (namespaced to your shop), or `undefined` in development and on deploys without a CDN configured — so `next dev` and un-provisioned deploys keep serving assets from the app origin. Pair it with `crossOrigin: 'anonymous'`: the assets then load cross-origin and the CDN sends the matching CORS header (required for fonts).
+
+  **Migration checklist for existing storefronts**:
+  - [ ] Add `assetPrefix: getAssetPrefix()` and `crossOrigin: 'anonymous'` to `next.config`.
+  - [ ] Redeploy — the next build's static assets are served from the CDN.
+
+  (`@doswiftly/storefront-operations` is version-synced with the SDK; no operation changes in this release.)
+
 ## 22.7.0
 
 ### Minor Changes

package/dist/core/image.js

@@ -59,10 +59,10 @@ const LOADER_IMAGE_EXTENSIONS = /\.(png|jpe?g|webp|avif|gif)$/i;
  * Path prefix of Next.js build-output **media** (images imported in code, e.g.
  * `import hero from './hero.webp'` → content-hashed bundle). UNLIKE the rest of `/_next/*`
  * (JS/CSS chunks, left untouched), media images ARE routed through the resize CDN: the deploy
- * mirrors them to `s/{shopId}/_next-media/{suffix}`. The content hash in the filename is the
- * version, so the CDN key is immutable (no `?v=` cache-bust).
+ * mirrors them to `s/{shopId}/_next/static/media/{suffix}` (the path is kept 1:1). The content
+ * hash in the filename is the version, so the CDN key is immutable (no `?v=` cache-bust).
  *
- * @sync-with backend deploy mirror (`_next/static/media/` prefix → `_next-media/` R2 key)
+ * @sync-with backend deploy mirror (`_next/static/media/` path mirrored 1:1 into the R2 key)
  */
 const NEXT_STATIC_MEDIA_PREFIX = '/_next/static/media/';
 /** Suffix after {@link NEXT_STATIC_MEDIA_PREFIX}, or `null` if `pathname` is not a Next media path. */
@@ -97,13 +97,13 @@ export function buildImageLoaderUrl(config, args) {
         if (!LOADER_IMAGE_EXTENSIONS.test(pathname))
             return src;
         // (2a) Next build-output media image. The content hash in the filename IS the version, so
-        // the CDN key is immutable → no `?v=`. The deploy mirrors these to `s/{shopId}/_next-media/`.
+        // the CDN key is immutable → no `?v=`. The deploy mirrors these to `s/{shopId}/_next/static/media/`.
         const mediaSuffix = nextStaticMediaSuffix(pathname);
         if (mediaSuffix !== null) {
             // `encodeURIComponent` keeps `..` (unreserved) — harmless while the image CDN is unsigned +
             // public; if HMAC signing is ever added, strip `..` segments here AND in the public/ branch.
             const encoded = mediaSuffix.split('/').map(encodeURIComponent).join('/');
-            return `${base}/s/${config.shopId}/_next-media/${encoded}?width=${width}`;
+            return `${base}/s/${config.shopId}/_next/static/media/${encoded}?width=${width}`;
         }
         // Any other framework build output (hashed/immutable, NOT mirrored) → untouched.
         const buildPrefixes = config.buildAssetPrefixes ?? FRAMEWORK_BUILD_PREFIXES;

package/dist/next/asset-prefix.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Next.js `assetPrefix` for DoSwiftly storefronts.
+ *
+ * Wire it once:
+ * ```ts
+ * // next.config.ts
+ * import { getAssetPrefix } from '@doswiftly/storefront-sdk/next';
+ * const nextConfig = { assetPrefix: getAssetPrefix(), crossOrigin: 'anonymous' };
+ * ```
+ *
+ * Your static assets (`/_next/static/*` — JavaScript, CSS, and fonts) are then served from your
+ * storefront's own CDN domain instead of the app origin: cache-friendly, immutable, and off the
+ * request path of your storefront server. The CDN base is injected by the DoSwiftly deploy
+ * pipeline — you don't configure it.
+ *
+ * Returns `undefined` in development (so `doswiftly dev` serves assets locally for fast refresh) and
+ * whenever the pipeline hasn't injected a CDN base (so an un-provisioned deploy keeps serving
+ * assets from the app origin). Either way there is no setup and nothing to break.
+ *
+ * Pair it with `crossOrigin: 'anonymous'`: assets then load cross-origin and the CDN sends the
+ * matching CORS header (required for fonts).
+ */
+export declare function getAssetPrefix(): string | undefined;
+//# sourceMappingURL=asset-prefix.d.ts.map

package/dist/next/asset-prefix.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"asset-prefix.d.ts","sourceRoot":"","sources":["../../src/next/asset-prefix.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,cAAc,IAAI,MAAM,GAAG,SAAS,CAKnD"}

package/dist/next/asset-prefix.js

@@ -0,0 +1,29 @@
+/**
+ * Next.js `assetPrefix` for DoSwiftly storefronts.
+ *
+ * Wire it once:
+ * ```ts
+ * // next.config.ts
+ * import { getAssetPrefix } from '@doswiftly/storefront-sdk/next';
+ * const nextConfig = { assetPrefix: getAssetPrefix(), crossOrigin: 'anonymous' };
+ * ```
+ *
+ * Your static assets (`/_next/static/*` — JavaScript, CSS, and fonts) are then served from your
+ * storefront's own CDN domain instead of the app origin: cache-friendly, immutable, and off the
+ * request path of your storefront server. The CDN base is injected by the DoSwiftly deploy
+ * pipeline — you don't configure it.
+ *
+ * Returns `undefined` in development (so `doswiftly dev` serves assets locally for fast refresh) and
+ * whenever the pipeline hasn't injected a CDN base (so an un-provisioned deploy keeps serving
+ * assets from the app origin). Either way there is no setup and nothing to break.
+ *
+ * Pair it with `crossOrigin: 'anonymous'`: assets then load cross-origin and the CDN sends the
+ * matching CORS header (required for fonts).
+ */
+export function getAssetPrefix() {
+    // Development must serve assets from the dev server (fast refresh) — never the CDN.
+    if (process.env.NODE_ENV === "development")
+        return undefined;
+    // Literal member access (read at build time inside next.config). Empty / unset → app origin.
+    return process.env.DOSWIFTLY_ASSET_PREFIX || undefined;
+}

package/dist/next/index.d.ts

@@ -6,4 +6,5 @@
  * core stays portable to Node, Edge, Deno, and Bun.
  */
 export { createImageLoader, type NextImageLoaderArgs } from './image-loader';
+export { getAssetPrefix } from './asset-prefix';
 //# sourceMappingURL=index.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/next/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,iBAAiB,EAAE,KAAK,mBAAmB,EAAE,MAAM,gBAAgB,CAAC;AAC7E,OAAO,EAAE,cAAc,EAAE,MAAM,gBAAgB,CAAC"}

package/dist/next/index.js

@@ -6,6 +6,7 @@
  * core stays portable to Node, Edge, Deno, and Bun.
  */
 export { createImageLoader } from './image-loader';
+export { getAssetPrefix } from './asset-prefix';
 // The pure builder + its config/base (`buildImageLoaderUrl`, `IMAGE_CDN_BASE_URL`,
 // `ImageLoaderConfig`) are framework-agnostic and live on the core entry
 // (`@doswiftly/storefront-sdk`) — import them from there, not from `/next`.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@doswiftly/storefront-sdk",
-  "version": "22.7.0",
+  "version": "22.8.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,