@scayle/storefront-nuxt 8.61.2 → 8.62.0

package/CHANGELOG.md

@@ -1,5 +1,84 @@
 # @scayle/storefront-nuxt
 
+## 8.62.0
+
+### Minor Changes
+
+- **\[Promotions\]** Enabled promotion segmentation on the client for `usePromotions`, `useCurrentPromotions`, and `usePromotionsByIds`.
+
+  These composables inject `segmentation: true` when `import.meta.client` is true, so logged-in shoppers receive promotions tailored to their customer segment without passing the flag manually. Server-side calls keep `segmentation: false` and continue to use the cached anonymous promotion list so customer-specific promotions are not stored in shared cache responses.
+
+  The public `params` type omits `segmentation` on these composables so storefront code does not set it directly.
+
+  **\[BREAKING\]** `usePromotionsByIds` now accepts `{ ids: string[] }` for `params` instead of `string[]`.
+  - Before:
+
+    ```ts
+    const { data } = usePromotionsByIds({
+      params: ['promo-1', 'promo-2'],
+    })
+    ```
+
+  - After:
+
+    ```ts
+    const { data } = usePromotionsByIds({
+      params: {
+        ids: ['promo-1', 'promo-2'],
+      },
+    })
+    ```
+
+  Segmentation is applied automatically on the client, same as `usePromotions` and `useCurrentPromotions`.
+
+### Patch Changes
+
+**Dependencies**
+
+**@scayle/storefront-core v8.62.0**
+
+- Minor
+  - **\[Promotions\]** Added customer-segmented promotion fetches when a valid session token is present.
+
+  `getPromotions`, `getCurrentPromotions`, and `getPromotionsByIds` accept a `segmentation` flag. When it is `true` and the request has a non-expired access token, the handlers call the Storefront API with `customerToken` and skip the shared cache so results match the logged-in customer. When it is `false`, handlers use the cached anonymous promotion list so customer-specific promotions are not stored in shared cache responses.
+
+  **\[BREAKING\]** `getPromotionsByIds` now expects `{ ids: string[], segmentation: boolean }` instead of a bare `string[]` array.
+  - Before (custom RPC handler via `context.callRpc`):
+
+    ```ts
+    const promotions = await context.callRpc?.('getPromotionsByIds', [
+      'promo-1',
+      'promo-2',
+    ])
+    ```
+
+  - After:
+
+    ```ts
+    const promotions = await context.callRpc?.('getPromotionsByIds', {
+      ids: ['promo-1', 'promo-2'],
+      segmentation: true,
+    })
+    ```
+
+  Promotion list handlers use `POST` instead of `GET` so `segmentation` and `customerToken` are not sent in the URL.
+
+  **\[User\]** Exported `getValidatedAccessToken` to return a JWT only when it is present and not expired. Basket merge and promotion handlers use it when passing `customerToken` to the Storefront API.
+
+## 8.61.3
+
+### Patch Changes
+
+- Updated dependency `@vercel/nft@1.4.0` to `@vercel/nft@1.5.0`
+- Fix `updateTokens` and `updateUser` return type from `void` to `Promise<void>` in `ContextWithSession`. The underlying implementations were already async (`await session.save()`), but the incorrect `void` type prevented call sites from knowing they needed to await the result. All call sites in the RPC methods and customer API now correctly await these calls, ensuring session state is persisted before execution continues.
+
+**Dependencies**
+
+**@scayle/storefront-core v8.61.3**
+
+- Patch
+  - Fix `updateTokens` and `updateUser` return type from `void` to `Promise<void>` in `ContextWithSession`. The underlying implementations were already async (`await session.save()`), but the incorrect `void` type prevented call sites from knowing they needed to await the result. All call sites in the RPC methods and customer API now correctly await these calls, ensuring session state is persisted before execution continues.
+
 ## 8.61.2
 
 ### Patch Changes

package/dist/module.json

@@ -1,6 +1,6 @@
 {
   "name": "@scayle/storefront-nuxt",
-  "version": "8.61.2",
+  "version": "8.62.0",
   "configKey": "storefront",
   "compatibility": {
     "nuxt": ">=3.13"

package/dist/module.mjs

@@ -57,7 +57,7 @@ export default {
 }`;
 }
 const PACKAGE_NAME = "@scayle/storefront-nuxt";
-const PACKAGE_VERSION = "8.61.2";
+const PACKAGE_VERSION = "8.62.0";
 const logger = createConsola({
   fancy: true,
   formatOptions: {
@@ -131,7 +131,9 @@ async function resolveAliasChain(target, resolveOpts) {
     }
     current = next;
   }
-  logger.warn(`Alias chain for ${target} resolved to ${current} but maximum depth of 10 was reached`);
+  logger.warn(
+    `Alias chain for ${target} resolved to ${current} but maximum depth of 10 was reached`
+  );
   return current;
 }
 async function buildResolvedNuxtAliasMap(nuxt) {

package/dist/runtime/composables/storefront/useCurrentPromotions.d.ts

@@ -26,6 +26,6 @@ import type { MaybeRefOrGetter } from 'vue';
  *          loading state, and any error information.
  */
 export declare function useCurrentPromotions<DataT = NormalizedRpcResponse<'getCurrentPromotions'>, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = null>({ params, options, }?: Partial<{
-    params: MaybeRefOrGetter<RpcMethodParameters<'getCurrentPromotions'>>;
+    params: MaybeRefOrGetter<Omit<RpcMethodParameters<'getCurrentPromotions'>, 'segmentation'>>;
     options: UseRpcOptions<'getCurrentPromotions', DataT, PickKeys, DefaultT>;
 }>, key?: UseRpcCacheKey): UseRpcReturn<'getCurrentPromotions', DataT, PickKeys, DefaultT>;

package/dist/runtime/composables/storefront/useCurrentPromotions.js

@@ -1,9 +1,16 @@
 import { useRpc } from "../core/useRpc.js";
+import { toValue } from "vue";
 export function useCurrentPromotions({
   params,
   options
 } = {}, key = "useCurrentPromotions") {
-  return useRpc("getCurrentPromotions", key, params, {
+  const paramsWithSegmentation = () => {
+    return {
+      ...toValue(params),
+      segmentation: import.meta.client
+    };
+  };
+  return useRpc("getCurrentPromotions", key, paramsWithSegmentation, {
     getCachedData(cacheKey, nuxtApp) {
       const hydrationData = nuxtApp.isHydrating ? nuxtApp.payload.data[cacheKey] : nuxtApp.static.data[cacheKey];
       return hydrationData ?? nuxtApp._asyncData[cacheKey]?.data.value;

package/dist/runtime/composables/storefront/usePromotions.d.ts

@@ -23,6 +23,6 @@ import type { MaybeRefOrGetter } from 'vue';
  *          loading state, and any error information.
  */
 export declare function usePromotions<DataT = NormalizedRpcResponse<'getPromotions'>, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = null>({ params, options, }?: Partial<{
-    params: MaybeRefOrGetter<RpcMethodParameters<'getPromotions'>>;
+    params: MaybeRefOrGetter<Omit<RpcMethodParameters<'getPromotions'>, 'segmentation'>>;
     options: UseRpcOptions<'getPromotions', DataT, PickKeys, DefaultT>;
 }>, key?: UseRpcCacheKey): UseRpcReturn<'getPromotions', DataT, PickKeys, DefaultT>;

package/dist/runtime/composables/storefront/usePromotions.js

@@ -1,7 +1,14 @@
 import { useRpc } from "../core/useRpc.js";
+import { toValue } from "vue";
 export function usePromotions({
   params,
   options
 } = {}, key = "usePromotions") {
-  return useRpc("getPromotions", key, params, options);
+  const paramsWithSegmentation = () => {
+    return {
+      ...toValue(params),
+      segmentation: import.meta.client
+    };
+  };
+  return useRpc("getPromotions", key, paramsWithSegmentation, options);
 }

package/dist/runtime/composables/storefront/usePromotionsByIds.d.ts

@@ -23,6 +23,6 @@ import type { MaybeRefOrGetter } from 'vue';
  *          loading state, and any error information.
  */
 export declare function usePromotionsByIds<DataT = NormalizedRpcResponse<'getPromotionsByIds'>, PickKeys extends KeysOf<DataT> = KeysOf<DataT>, DefaultT = null>({ params, options, }?: Partial<{
-    params: MaybeRefOrGetter<RpcMethodParameters<'getPromotionsByIds'>>;
+    params: MaybeRefOrGetter<Omit<RpcMethodParameters<'getPromotionsByIds'>, 'segmentation'>>;
     options: UseRpcOptions<'getPromotionsByIds', DataT, PickKeys, DefaultT>;
 }>, key?: UseRpcCacheKey): UseRpcReturn<'getPromotionsByIds', DataT, PickKeys, DefaultT>;

package/dist/runtime/composables/storefront/usePromotionsByIds.js

@@ -1,7 +1,15 @@
 import { useRpc } from "../core/useRpc.js";
+import { toValue } from "vue";
 export function usePromotionsByIds({
   params,
   options
 } = {}, key = "usePromotionsByIds") {
-  return useRpc("getPromotionsByIds", key, params, options);
+  const paramsWithSegmentation = () => {
+    const base = toValue(params);
+    return {
+      ids: base?.ids ?? [],
+      segmentation: import.meta.client
+    };
+  };
+  return useRpc("getPromotionsByIds", key, paramsWithSegmentation, options);
 }

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@scayle/storefront-nuxt",
   "type": "module",
-  "version": "8.61.2",
+  "version": "8.62.0",
   "description": "Nuxt integration for the SCAYLE Commerce Engine and Storefront API",
   "author": "SCAYLE Commerce Engine",
   "license": "MIT",
@@ -68,7 +68,7 @@
   },
   "peerDependencies": {
     "@nuxt/kit": ">=3.13.0 || >=4.2.0",
-    "@scayle/storefront-api": "^19.0.0",
+    "@scayle/storefront-api": "^19.1.0",
     "fishery": "^2.2.2",
     "h3": "^1.10.0",
     "nitropack": "^2.9.7",
@@ -77,10 +77,10 @@
     "vue": "^3.4.0"
   },
   "dependencies": {
-    "@opentelemetry/api": "^1.9.0",
+    "@opentelemetry/api": "^1.9.1",
     "@scayle/unstorage-compression-driver": "1.5.0",
-    "@vercel/nft": "1.4.0",
-    "@vueuse/core": "14.2.1",
+    "@vercel/nft": "1.5.0",
+    "@vueuse/core": "14.3.0",
     "consola": "^3.4.2",
     "core-js": "^3.37.1",
     "defu": "^6.1.7",
@@ -97,13 +97,13 @@
     "vue-router": "^4.4.0",
     "zod": "^4.0.0",
     "@scayle/h3-session": "0.7.0",
-    "@scayle/storefront-core": "8.61.2"
+    "@scayle/storefront-core": "8.62.0"
   },
   "devDependencies": {
     "@arethetypeswrong/cli": "0.18.2",
     "@nuxt/eslint-config": "1.15.2",
     "@nuxt/kit": "^3.20.2",
-    "@nuxtjs/i18n": "10.2.3",
+    "@nuxtjs/i18n": "10.4.0",
     "@nuxt/module-builder": "1.0.2",
     "@nuxt/schema": "^3.20.2",
     "@nuxt/test-utils": "4.0.0",
@@ -111,8 +111,8 @@
     "@scayle/eslint-plugin-vue-composable": "^1.1.0",
     "@scayle/unstorage-scayle-kv-driver": "^2.1.0",
     "@types/node": "24.12.2",
-    "@vitest/coverage-v8": "4.1.5",
-    "eslint": "10.3.0",
+    "@vitest/coverage-v8": "4.1.7",
+    "eslint": "10.4.0",
     "eslint-formatter-gitlab": "7.1.0",
     "fishery": "2.4.0",
     "h3": "1.15.11",
@@ -121,11 +121,11 @@
     "nitropack": "2.13.4",
     "node-mocks-http": "1.17.2",
     "nuxt": "^3.20.2",
-    "publint": "0.3.18",
+    "publint": "0.3.21",
     "typescript": "6.0.3",
     "unbuild": "3.6.1",
-    "vitest": "4.1.5",
-    "vue-tsc": "3.2.7",
+    "vitest": "4.1.7",
+    "vue-tsc": "3.3.2",
     "@scayle/vitest-config-storefront": "1.0.0"
   },
   "scripts": {