@commercengine/storefront-sdk 0.4.8 → 0.6.0

package/README.md

@@ -170,6 +170,18 @@ import { MemoryTokenStorage } from "@commercengine/storefront-sdk";
 const tokenStorage = new MemoryTokenStorage();
 ```
 
+#### Next.js Universal (recommended for Next.js apps)
+```typescript
+import { NextJSTokenStorage } from "@commercengine/storefront-sdk";
+
+const tokenStorage = new NextJSTokenStorage({
+  prefix: "myapp_",
+  maxAge: 30 * 24 * 60 * 60, // 30 days
+  secure: true, // Auto-detects HTTPS in browser
+  sameSite: "Lax",
+});
+```
+
 #### Custom Storage
 ```typescript
 class CustomTokenStorage implements TokenStorage {
@@ -391,7 +403,8 @@ The SDK works seamlessly across all JavaScript environments:
 - **Background jobs**: Reliable token management for long-running processes
 
 ### Hybrid Rendering (SSR/SSG)
-- **Next.js, Nuxt, SvelteKit**: Seamless client/server token handoff
+- **Next.js**: Use `NextJSTokenStorage` for universal client/server token access
+- **Nuxt, SvelteKit**: Use `CookieTokenStorage` for seamless client/server token handoff
 - **Cookie-based storage**: Maintains sessions across server/client boundaries
 - **Hydration-safe**: No client/server state mismatches
 
@@ -407,6 +420,57 @@ The SDK implements CommerceEngine API best practices automatically:
 - ✅ **Timeout handling** with configurable limits
 - ✅ **Memory leak prevention** with proper cleanup
 
+## Contributing
+
+### Version Management with Changeset
+
+This project uses [Changeset](https://github.com/changesets/changesets) for version management and publishing. Here's how to contribute:
+
+#### Creating Changes
+
+When you make changes to the SDK, create a changeset to document them:
+
+```bash
+pnpm changeset
+```
+
+This will prompt you to:
+- Select the type of change (patch/minor/major)
+- Write a summary of what changed
+- Create a markdown file in the `.changeset/` folder
+
+#### Version Types
+
+- **Patch** (0.0.x): Bug fixes, documentation updates, internal refactoring
+- **Minor** (0.x.0): New features, new API endpoints, backwards-compatible changes  
+- **Major** (x.0.0): Breaking changes, API modifications that affect existing code
+
+#### Release Process
+
+1. **During Development**: Create changesets for your changes
+   ```bash
+   pnpm changeset
+   ```
+
+2. **Before Release**: Consume changesets and update versions
+   ```bash
+   pnpm version
+   ```
+   This updates `package.json`, generates/updates `CHANGELOG.md`, and removes consumed changesets.
+
+3. **Publishing**: Build and publish to npm
+   ```bash
+   pnpm release
+   ```
+
+#### Available Scripts
+
+- `pnpm changeset` - Create a new changeset
+- `pnpm version` - Consume changesets and bump version  
+- `pnpm release` - Build and publish to npm
+
+The changeset workflow ensures proper semantic versioning, comprehensive changelogs, and coordinated releases.
+
 ## License
 
-This project is licensed under the MIT License.
+All Rights Reserved

package/dist/index.cjs

@@ -39,6 +39,7 @@ __export(index_exports, {
   Environment: () => Environment,
   HelpersClient: () => HelpersClient,
   MemoryTokenStorage: () => MemoryTokenStorage,
+  NextJSTokenStorage: () => NextJSTokenStorage,
   OrderClient: () => OrderClient,
   ResponseUtils: () => ResponseUtils,
   ShippingClient: () => ShippingClient,
@@ -260,6 +261,115 @@ var CookieTokenStorage = class {
     document.cookie = cookieString;
   }
 };
+var NextJSTokenStorage = class {
+  accessTokenKey;
+  refreshTokenKey;
+  options;
+  constructor(options = {}) {
+    const prefix = options.prefix || "storefront_";
+    this.accessTokenKey = `${prefix}access_token`;
+    this.refreshTokenKey = `${prefix}refresh_token`;
+    this.options = {
+      maxAge: options.maxAge || 30 * 24 * 60 * 60,
+      // 30 days default
+      path: options.path || "/",
+      domain: options.domain,
+      secure: options.secure ?? (typeof window !== "undefined" && window.location?.protocol === "https:"),
+      sameSite: options.sameSite || "Lax"
+    };
+  }
+  async getAccessToken() {
+    return this.getCookie(this.accessTokenKey);
+  }
+  async setAccessToken(token) {
+    this.setCookie(this.accessTokenKey, token);
+  }
+  async getRefreshToken() {
+    return this.getCookie(this.refreshTokenKey);
+  }
+  async setRefreshToken(token) {
+    this.setCookie(this.refreshTokenKey, token);
+  }
+  async clearTokens() {
+    this.deleteCookie(this.accessTokenKey);
+    this.deleteCookie(this.refreshTokenKey);
+  }
+  getCookie(name) {
+    if (typeof window !== "undefined") {
+      const value = `; ${document.cookie}`;
+      const parts = value.split(`; ${name}=`);
+      if (parts.length === 2) {
+        const cookieValue = parts.pop()?.split(";").shift();
+        return cookieValue ? decodeURIComponent(cookieValue) : null;
+      }
+      return null;
+    } else {
+      try {
+        const { cookies } = require("next/headers");
+        const cookieStore = cookies();
+        return cookieStore.get(name)?.value || null;
+      } catch {
+        return null;
+      }
+    }
+  }
+  setCookie(name, value) {
+    if (typeof window !== "undefined") {
+      const encodedValue = encodeURIComponent(value);
+      let cookieString = `${name}=${encodedValue}`;
+      if (this.options.maxAge) {
+        cookieString += `; Max-Age=${this.options.maxAge}`;
+      }
+      if (this.options.path) {
+        cookieString += `; Path=${this.options.path}`;
+      }
+      if (this.options.domain) {
+        cookieString += `; Domain=${this.options.domain}`;
+      }
+      if (this.options.secure) {
+        cookieString += `; Secure`;
+      }
+      if (this.options.sameSite) {
+        cookieString += `; SameSite=${this.options.sameSite}`;
+      }
+      document.cookie = cookieString;
+    } else {
+      try {
+        const { cookies } = require("next/headers");
+        const cookieStore = cookies();
+        cookieStore.set(name, value, {
+          maxAge: this.options.maxAge,
+          path: this.options.path,
+          domain: this.options.domain,
+          secure: this.options.secure,
+          sameSite: this.options.sameSite?.toLowerCase()
+        });
+      } catch {
+        console.warn(`Could not set cookie ${name} on server side`);
+      }
+    }
+  }
+  deleteCookie(name) {
+    if (typeof window !== "undefined") {
+      let cookieString = `${name}=; Max-Age=0`;
+      if (this.options.path) {
+        cookieString += `; Path=${this.options.path}`;
+      }
+      if (this.options.domain) {
+        cookieString += `; Domain=${this.options.domain}`;
+      }
+      document.cookie = cookieString;
+    } else {
+      try {
+        const { cookies } = require("next/headers");
+        const cookieStore = cookies();
+        cookieStore.delete(name);
+      } catch {
+        console.warn(`Could not remove cookie ${name} on server side`);
+      }
+    }
+  }
+};
 function createAuthMiddleware(config) {
   let isRefreshing = false;
   let refreshPromise = null;
@@ -1495,23 +1605,6 @@ var CartClient = class extends StorefrontAPIClient {
       })
     );
   }
-  /**
-   * Update cart customer
-   *
-   * @param cartId - The ID of the cart
-   * @param body - The body of the request
-   * @returns Promise with updated cart
-   */
-  async updateCartCustomer(cartId, body) {
-    return this.executeRequest(
-      () => this.client.POST("/carts/{id}/update-customer", {
-        params: {
-          path: cartId
-        },
-        body
-      })
-    );
-  }
 };
 
 // src/lib/auth.ts
@@ -2518,6 +2611,7 @@ var index_default = StorefrontSDK;
   Environment,
   HelpersClient,
   MemoryTokenStorage,
+  NextJSTokenStorage,
   OrderClient,
   ResponseUtils,
   ShippingClient,