@fast-simon/shopify-hydrogen 1.0.7-beta.0 → 1.0.8-beta.1

package/dist/esnext/@types/editor.d.ts

@@ -327,6 +327,8 @@ export interface ShowHideFiltersButtonSettings {
     border: string;
     borderRadius: string;
     text: string;
+    textShow?: string;
+    textHide?: string;
     color: string;
     dimensions: DimensionsSettings;
     backgroundColor: string;

package/dist/esnext/services/__tests__/categories_navigation.test.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/esnext/services/__tests__/categories_navigation.test.js

@@ -0,0 +1,90 @@
+import { describe, it, expect, beforeEach, vi } from 'vitest';
+vi.mock('@shopify/hydrogen', () => ({
+    CacheShort: () => ({ cacheStrategy: 'short' }),
+    fetchSync: (url) => {
+        lastRequestedUrl = url;
+        return { json: () => ({ facets: [], facets_completed: true, items: [] }) };
+    },
+}));
+let lastRequestedUrl = '';
+import { CategoriesNavigation } from '../categories_navigation';
+const baseProps = {
+    categoryID: '42',
+    storeID: 1,
+    UUID: 'abc',
+};
+describe('legacy hydrogen categories_navigation — personalization', () => {
+    beforeEach(() => {
+        lastRequestedUrl = '';
+    });
+    it('omits personalization keys when the prop is absent (backwards-compat)', () => {
+        CategoriesNavigation.get({ ...baseProps });
+        expect(lastRequestedUrl).not.toMatch(/[?&]ps=/);
+        expect(lastRequestedUrl).not.toMatch(/[?&]st=/);
+        expect(lastRequestedUrl).not.toMatch(/[?&]sp=/);
+        expect(lastRequestedUrl).not.toMatch(/[?&]spv=/);
+    });
+    it('emits full personalization context', () => {
+        CategoriesNavigation.get({
+            ...baseProps,
+            personalization: { st: 'tok', sp: '1,2', spv: 'vec', ps: 'new' },
+        });
+        expect(lastRequestedUrl).toMatch(/[?&]ps=new(&|$)/);
+        expect(lastRequestedUrl).toMatch(/[?&]st=tok(&|$)/);
+        expect(lastRequestedUrl).toMatch(/[?&]sp=1,2(&|$)/);
+        expect(lastRequestedUrl).toMatch(/[?&]spv=vec(&|$)/);
+    });
+    it('emits only provided partial context keys', () => {
+        CategoriesNavigation.get({
+            ...baseProps,
+            personalization: { ps: 'returning' },
+        });
+        expect(lastRequestedUrl).toMatch(/[?&]ps=returning(&|$)/);
+        expect(lastRequestedUrl).not.toMatch(/[?&]st=/);
+        expect(lastRequestedUrl).not.toMatch(/[?&]sp=/);
+        expect(lastRequestedUrl).not.toMatch(/[?&]spv=/);
+    });
+    it('empty personalization object emits no personalization keys', () => {
+        CategoriesNavigation.get({
+            ...baseProps,
+            personalization: {},
+        });
+        expect(lastRequestedUrl).not.toMatch(/[?&]ps=/);
+    });
+    it('getFacetsOnly emits personalization keys too', () => {
+        CategoriesNavigation.getFacetsOnly({
+            ...baseProps,
+            personalization: { ps: 'returning' },
+        });
+        expect(lastRequestedUrl).toMatch(/[?&]ps=returning(&|$)/);
+        expect(lastRequestedUrl).toMatch(/\/categories_navigation\?/);
+    });
+});
+describe('legacy hydrogen categories_navigation — regression (byte-identical without opt-in)', () => {
+    beforeEach(() => {
+        lastRequestedUrl = '';
+    });
+    it('URL is unchanged when personalization is omitted vs undefined', () => {
+        CategoriesNavigation.get({ ...baseProps });
+        const urlA = lastRequestedUrl;
+        lastRequestedUrl = '';
+        CategoriesNavigation.get({ ...baseProps, personalization: undefined });
+        expect(lastRequestedUrl).toBe(urlA);
+    });
+    it('preserves the historical narrow=undefined quirk when narrow is not provided', () => {
+        CategoriesNavigation.get({ ...baseProps });
+        expect(lastRequestedUrl).toMatch(/[?&]narrow=undefined/);
+    });
+    it('appends personalization keys after core params', () => {
+        CategoriesNavigation.get({
+            ...baseProps,
+            personalization: { ps: 'new' },
+        });
+        const params = new URL(lastRequestedUrl).searchParams;
+        const keys = [...params.keys()];
+        const idxCategory = keys.indexOf('category_id');
+        const idxPs = keys.indexOf('ps');
+        expect(idxCategory).toBeGreaterThanOrEqual(0);
+        expect(idxPs).toBeGreaterThan(idxCategory);
+    });
+});

package/dist/esnext/services/categories_navigation.d.ts

@@ -25,6 +25,22 @@ export interface CategoryNavigationServerResponseAll {
     personalization_recency_limit?: number;
     personalized_products?: number[];
 }
+/**
+ * Optional personalization context for category navigation requests. When provided, the
+ * present keys are forwarded to the API. When omitted, the request URL is byte-identical
+ * to prior versions of this SDK.
+ *
+ * - `st` — session token
+ * - `sp` — recent-products (comma-joined IDs)
+ * - `spv` — personalization vector
+ * - `ps` — personalization segment (`"new"` | `"returning"`)
+ */
+export interface PersonalizationContext {
+    st?: string;
+    sp?: string;
+    spv?: string;
+    ps?: 'new' | 'returning';
+}
 interface CategoryNavigationProps {
     categoryID: string;
     page?: number;
@@ -36,13 +52,18 @@ interface CategoryNavigationProps {
     searchWithinResultsQuery?: string;
     storeID: number;
     UUID: string;
+    /**
+     * Optional personalization context for this request. When omitted, the emitted URL is
+     * unchanged from earlier SDK versions.
+     */
+    personalization?: PersonalizationContext;
 }
 interface CategoryNavigationResponse {
     data: CategoryNavigationServerResponseAll;
     getFacetsOnly?: () => ServerFacet[];
 }
 export declare const CategoriesNavigation: {
-    get: ({ categoryID, page, sortBy, facets, narrow, productsPerPage, withProductAttributes, searchWithinResultsQuery, storeID, UUID, }: CategoryNavigationProps) => CategoryNavigationResponse;
-    getFacetsOnly: ({ categoryID, page, sortBy, narrow, productsPerPage, searchWithinResultsQuery, storeID, UUID }: CategoryNavigationProps) => ServerFacet[];
+    get: ({ categoryID, page, sortBy, facets, narrow, productsPerPage, withProductAttributes, searchWithinResultsQuery, storeID, UUID, personalization, }: CategoryNavigationProps) => CategoryNavigationResponse;
+    getFacetsOnly: ({ categoryID, page, sortBy, narrow, productsPerPage, searchWithinResultsQuery, storeID, UUID, personalization, }: CategoryNavigationProps) => ServerFacet[];
 };
 export {};

package/dist/esnext/services/categories_navigation.js

@@ -2,7 +2,7 @@ import { CacheShort, fetchSync } from "@shopify/hydrogen";
 import { Narrow as NarrowUtil } from "@fast-simon/utilities";
 const ENDPOINT = "https://api.fastsimon.com";
 export const CategoriesNavigation = {
-    get: ({ categoryID, page = 1, sortBy = "relevency", facets = true, narrow, productsPerPage, withProductAttributes = true, searchWithinResultsQuery, storeID, UUID, }) => {
+    get: ({ categoryID, page = 1, sortBy = "relevency", facets = true, narrow, productsPerPage, withProductAttributes = true, searchWithinResultsQuery, storeID, UUID, personalization, }) => {
         const narrowParm = narrow ? NarrowUtil.toServerNarrow(narrow) : undefined;
         const params = {
             category_id: categoryID,
@@ -14,7 +14,8 @@ export const CategoriesNavigation = {
             with_product_attributes: withProductAttributes ? withProductAttributes : undefined,
             search_within_search: searchWithinResultsQuery ? searchWithinResultsQuery : undefined,
             UUID: UUID,
-            store_id: storeID
+            store_id: storeID,
+            ...(personalization ?? {})
         };
         const url = `${ENDPOINT}/categories_navigation?${Object.keys(params).filter(key => params[key] !== undefined).map(key => key + '=' + params[key]).join('&')}`;
         const data = fetchSync(url, {
@@ -24,11 +25,11 @@ export const CategoriesNavigation = {
         return {
             data: data,
             getFacetsOnly: (facets && !data.facets_completed) ? () => {
-                return CategoriesNavigation.getFacetsOnly({ categoryID, page, sortBy, narrow, productsPerPage, searchWithinResultsQuery, UUID, storeID });
+                return CategoriesNavigation.getFacetsOnly({ categoryID, page, sortBy, narrow, productsPerPage, searchWithinResultsQuery, UUID, storeID, personalization });
             } : undefined
         };
     },
-    getFacetsOnly: ({ categoryID, page = 1, sortBy = "relevency", narrow, productsPerPage, searchWithinResultsQuery, storeID, UUID }) => {
+    getFacetsOnly: ({ categoryID, page = 1, sortBy = "relevency", narrow, productsPerPage, searchWithinResultsQuery, storeID, UUID, personalization, }) => {
         const narrowParm = narrow ? NarrowUtil.toServerNarrow(narrow) : undefined;
         const params = {
             category_id: categoryID,
@@ -39,7 +40,8 @@ export const CategoriesNavigation = {
             narrow: JSON.stringify(narrowParm),
             search_within_search: searchWithinResultsQuery ? searchWithinResultsQuery : undefined,
             UUID: UUID,
-            store_id: storeID
+            store_id: storeID,
+            ...(personalization ?? {})
         };
         const url = `${ENDPOINT}/categories_navigation?${Object.keys(params).filter(key => params[key] !== undefined).map(key => key + '=' + params[key]).join('&')}`;
         const data = fetchSync(url, {

package/package.json

@@ -1,11 +1,13 @@
 {
   "name": "@fast-simon/shopify-hydrogen",
-  "version": "1.0.7-beta.0",
+  "version": "1.0.8-beta.1",
   "description": "",
   "scripts": {
     "build": "npm run build:plugin:cjs && npm run build:esm",
     "build:plugin:cjs": "tsc --p tsconfig.plugin.cjs.json",
-    "build:esm": "tsc --p tsconfig.esm.json"
+    "build:esm": "tsc --p tsconfig.esm.json",
+    "test": "vitest run",
+    "test:watch": "vitest"
   },
   "author": "",
   "license": "ISC",
@@ -15,7 +17,7 @@
   "devDependencies": {
     "@shopify/hydrogen": "^1.2.0",
     "@types/react": "^18.0.16",
-    "@types/node": "17.0.35",
+    "@types/node": "^20.0.0",
     "@types/react-dom": "^18.0.5",
     "rollup": "^2.77.2",
     "rollup-plugin-dts": "^4.2.2",
@@ -23,7 +25,9 @@
     "vite": "^2.9.14",
     "type-fest": "^2.13.0",
     "@vitejs/plugin-react": "^1.3.0",
-    "copyfiles": "2.4.1"
+    "copyfiles": "2.4.1",
+    "vitest": "^3.0.0",
+    "jsdom": "^26.0.0"
   },
   "main": "dist/esnext/index.js",
   "files": [