fragment-headless-sdk 2.3.2 → 2.3.3

package/dist/utils/fetch-resource.js

@@ -119,6 +119,9 @@ async function performRequest({ baseUrl, apiKey, type, params = {}, fetchImpl, c
             url.searchParams.set("page", params.pageFilter);
         if (params.search)
             url.searchParams.set("search", params.search);
+        // API key in the URL so Vercel's CDN can cache the response.
+        // Requests with an Authorization header are never cached by the CDN.
+        url.searchParams.set("apiKey", apiKey);
         // Merge default cache config with user-provided options
         const finalCacheOptions = {
             ...getDefaultCacheConfig(type),
@@ -128,7 +131,6 @@ async function performRequest({ baseUrl, apiKey, type, params = {}, fetchImpl, c
         const fetchOptions = {
             method: "GET",
             headers: {
-                Authorization: `Bearer ${apiKey}`,
                 "Content-Type": "application/json",
             },
             cache: finalCacheOptions.cache,

package/docs/CHANGELOG.md

@@ -7,7 +7,15 @@ and this project adheres to [Semantic Versioning](https://semver.org/spec/v2.0.0
 
 ### [Unreleased]
 
-#### Removed
+### [2.3.3] - 2026-03-07
+
+#### Changed
+
+- **`fetchResource` default caching** – Environment-aware defaults for better performance and freshness:
+  - **Next.js production**: Defaults to `force-cache` with 60-second revalidation and resource-type cache tags (`fragment-hero-banners`, `fragment-announcements`) so responses are cached at the edge while staying reasonably fresh.
+  - **Next.js development / non–Next.js**: Defaults to `cache: "default"` with no revalidation.
+- User-provided `cacheOptions` still override these defaults.
+- **Request deduplication**: Cache keys now normalize `status` to `"enabled"` when omitted, so identical requests are deduplicated consistently.
 
 ### [2.3.2] - 2026-02-27
 

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "fragment-headless-sdk",
-  "version": "2.3.2",
-  "description": "Headless SDK for Fragment Shopify storefronts",
+  "version": "2.3.3",
+  "description": "Official SDK for Fragment-Shopify CMS: React components, TypeScript types, and utilities for headless Shopify storefronts.",
   "license": "MIT",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -29,15 +29,19 @@
   },
   "repository": {
     "type": "git",
-    "url": "https://github.com/sevenbrand/fragment-monorepo",
+    "url": "git+https://github.com/sevenbrand/fragment-monorepo.git",
     "directory": "packages/sdk"
   },
+  "homepage": "https://github.com/sevenbrand/fragment-monorepo/tree/main/packages/sdk#readme",
+  "bugs": "https://github.com/sevenbrand/fragment-monorepo/issues",
   "keywords": [
     "shopify",
     "headless",
     "fragment",
     "sdk",
-    "storefront"
+    "storefront",
+    "cms",
+    "react"
   ],
   "dependencies": {
     "@heroicons/react": "^2.2.0"

package/readme.md

@@ -4,7 +4,7 @@ The official SDK for integrating with Fragment-Shopify CMS. Provides React compo
 
 ## ✨ What's New
 
-**v2.3.1** - Enhanced attribution tracking with session storage and global API
+**v2.3.3** – `fetchResource` uses environment-aware default caching: Next.js production defaults to 60s revalidation and resource-type cache tags; development and non–Next.js use `cache: "default"`. Request deduplication normalizes `status` for consistent cache keys.
 
 > See [CHANGELOG.md](./docs/CHANGELOG.md) for full release history
 
@@ -80,7 +80,7 @@ Fragment-Shopify App (CMS) → API Endpoint → fragment-headless-sdk (Consumer)
 - 🛡️ **Graceful Fallback**: Works even if GA4 is not configured (doesn't break functionality)
 - 📦 **Exported Types**: `SectionType` enum available for consumer use
 
-### Attribution Tracking System (v2.4.0+)
+### Attribution Tracking System (v2.3.0+)
 
 - 🎯 **Session-Based Attribution**: Tracks which section was clicked for purchase/add-to-cart attribution
 - 💾 **SessionStorage Integration**: Uses sessionStorage for session-scoped attribution (last-click wins)
@@ -330,10 +330,15 @@ Fetches sections from your Fragment-Shopify app with intelligent request dedupli
 
 **CacheOptions:**
 
-- `cache?: RequestCache` - Request cache mode (defaults to "force-cache")
-- `revalidate?: number | false` - Next.js revalidation time in seconds (defaults to 60)
+- `cache?: RequestCache` - Request cache mode
+- `revalidate?: number | false` - Next.js revalidation time in seconds
 - `tags?: string[]` - Next.js cache tags for selective invalidation
 
+**Default cache behavior:**
+
+- **Next.js production**: `force-cache` with `revalidate: 60` and tags `fragment-{type}`. Override with `cacheOptions` for different behavior.
+- **Next.js development or non–Next.js**: `cache: "default"`; no revalidation or tags unless you pass `cacheOptions`.
+
 **ResourceType Options:**
 
 - `ResourceType.HeroBanners` - Fetch hero banners