@coveo/shopify 1.6.1-pre.fda43fc695 → 1.7.0-pre.153636d7cb

package/README.md

@@ -20,6 +20,52 @@ yarn add @coveo/shopify
 
 ## Features
 
+### `init`
+
+Initializes the Coveo Shopify integration to ensure that web pixels work correctly. This function should be called on every page of your Shopify store to maintain consistent tracking and personalization.
+
+The `init` function publishes a custom event with the configuration data that the web pixels need to function properly.
+
+#### Parameters
+
+- `options` (required): A `CoveoShopifyOptions` object containing:
+  - `accessToken` (required): The access token for the Coveo API.
+  - `organizationId` (required): The organization ID.
+  - `environment` (required): The environment configuration ('dev', 'stg', 'prod', etc.).
+  - `trackingId` (required): The tracking ID for analytics.
+
+#### Returns
+
+This function doesn't return a value but publishes a custom event that web pixels can listen to.
+
+#### Example
+
+```typescript
+import {init} from '@coveo/shopify/utilities';
+
+// Initialize on every page
+init({
+  accessToken: 'your-access-token',
+  organizationId: 'your-org-id',
+  environment: 'prod',
+  trackingId: 'your-tracking-id',
+});
+```
+
+#### Usage with App Proxy Configuration
+
+You can combine the `init` function with `fetchAppProxyConfig` to initialize the integration:
+
+```typescript
+import {init, fetchAppProxyConfig} from '@coveo/shopify/utilities';
+
+const config = await fetchAppProxyConfig({
+  marketId: 'market_123432',
+});
+
+init(config);
+```
+
 ### `fetchAppProxyConfig`
 
 Fetches the app proxy configuration for a given Shopify market.

package/dist/constants.esm.js

@@ -0,0 +1,23 @@
+/**
+ * @license
+ *
+ * Copyright 2025 Coveo Solutions Inc.
+ *
+ * Licensed under the Apache License, Version 2.0 (the "License");
+ * you may not use this file except in compliance with the License.
+ * You may obtain a copy of the License at
+ * 
+ *       http://www.apache.org/licenses/LICENSE-2.0
+ * 
+ * Unless required by applicable law or agreed to in writing, software
+ * distributed under the License is distributed on an "AS IS" BASIS,
+ * WITHOUT WARRANTIES OR CONDITIONS OF ANY KIND, either express or implied.
+ * See the License for the specific language governing permissions and
+ * limitations under the License.
+ */
+
+// src/constants.ts
+var COVEO_SHOPIFY_CONFIG_KEY = "coveo_shopify_config";
+export {
+  COVEO_SHOPIFY_CONFIG_KEY
+};

package/dist/headless/commerce.d.ts

@@ -1,8 +1,8 @@
 import { CommerceEngineOptions } from '@coveo/headless/commerce';
-export { COVEO_SHOPIFY_CONFIG_KEY } from '../constants';
+export type * from '../types';
 export * from '@coveo/headless/commerce';
+export * from '../constants';
 export * from '../utilities';
-export type { AppProxyConfig, AppProxyResponse } from '../types';
 export interface BuildShopifyCommerceEngineOptions {
     commerceEngineOptions: CommerceEngineOptions;
 }

package/dist/headless/commerce.esm.js

@@ -34,20 +34,82 @@ function publishCustomShopifyEvent(key, customData) {
 // src/headless/commerce.ts
 export * from "@coveo/headless/commerce";
 
+// src/utilities/memoize.ts
+function memoize(fn, getCacheKey) {
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    fn: async (...args) => {
+      const key = getCacheKey(...args);
+      if (cache.has(key)) {
+        return cache.get(key);
+      }
+      const promise = fn(...args);
+      cache.set(key, promise);
+      try {
+        const result = await promise;
+        return result;
+      } catch (error) {
+        cache.delete(key);
+        throw error;
+      }
+    },
+    clearCache: () => {
+      cache.clear();
+    },
+    clearCacheEntry: (...args) => {
+      const key = getCacheKey(...args);
+      cache.delete(key);
+    }
+  };
+}
+
 // src/utilities/app-proxy.ts
+var memoizedFetch = memoize(
+  (...args) => global.fetch(...args),
+  (url) => url
+);
 async function fetchAppProxyConfig({
   appProxyUrl = "/apps/coveo",
   marketId
 }) {
-  const response = await fetch(`${appProxyUrl}?marketId=${marketId}]`);
+  const url = `${appProxyUrl}?marketId=${marketId}`;
+  const response = await memoizedFetch.fn(url);
+  if (!response.ok) {
+    memoizedFetch.clearCacheEntry(url);
+    throw new Error(
+      `Failed to fetch app proxy configuration from ${appProxyUrl} for marketId ${marketId}. Status: ${response.status}`
+    );
+  }
   return response.json();
 }
+function clearAppProxyCache() {
+  memoizedFetch.clearCache();
+}
+
+// src/utilities/init.ts
+import { getAnalyticsNextApiBaseUrl } from "@coveo/headless";
+import { createRelay } from "@coveo/relay";
+function init(options) {
+  const relay = createRelay({
+    url: getAnalyticsNextApiBaseUrl(
+      options.organizationId,
+      options.environment
+    ),
+    token: options.accessToken,
+    trackingId: options.trackingId
+  });
+  const clientId = relay.getMeta("").clientId;
+  publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
+    ...options,
+    clientId
+  });
+}
 
 // src/headless/commerce.ts
 function buildShopifyCommerceEngine({
   commerceEngineOptions
 }) {
-  const appProxyResponse = {
+  const options = {
     accessToken: commerceEngineOptions.configuration.accessToken,
     organizationId: commerceEngineOptions.configuration.organizationId,
     environment: commerceEngineOptions.configuration.environment,
@@ -56,7 +118,7 @@ function buildShopifyCommerceEngine({
   const engine = buildCommerceEngine(commerceEngineOptions);
   const clientId = engine.relay.getMeta("").clientId;
   publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
-    ...appProxyResponse,
+    ...options,
     clientId
   });
   return engine;
@@ -64,6 +126,8 @@ function buildShopifyCommerceEngine({
 export {
   COVEO_SHOPIFY_CONFIG_KEY,
   buildShopifyCommerceEngine,
+  clearAppProxyCache,
   fetchAppProxyConfig,
+  init,
   publishCustomShopifyEvent
 };

package/dist/headless/commerce.js

@@ -1,8 +1,8 @@
 import { buildCommerceEngine, } from '@coveo/headless/commerce';
 import { COVEO_SHOPIFY_CONFIG_KEY } from '../constants';
 import { publishCustomShopifyEvent } from '../utilities/shopify';
-export { COVEO_SHOPIFY_CONFIG_KEY } from '../constants';
 export * from '@coveo/headless/commerce';
+export * from '../constants';
 export * from '../utilities';
 /**
  * Builds the commerce engine for a Shopify store.
@@ -15,7 +15,7 @@ export * from '../utilities';
  * @returns The constructed commerce engine instance.
  */
 export function buildShopifyCommerceEngine({ commerceEngineOptions, }) {
-    const appProxyResponse = {
+    const options = {
         accessToken: commerceEngineOptions.configuration.accessToken,
         organizationId: commerceEngineOptions.configuration.organizationId,
         environment: commerceEngineOptions.configuration.environment,
@@ -24,7 +24,7 @@ export function buildShopifyCommerceEngine({ commerceEngineOptions, }) {
     const engine = buildCommerceEngine(commerceEngineOptions);
     const clientId = engine.relay.getMeta('').clientId;
     publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
-        ...appProxyResponse,
+        ...options,
         clientId,
     });
     return engine;

package/dist/headless/search.d.ts

@@ -1,7 +1,8 @@
 import { SearchEngineOptions } from '@coveo/headless';
 export { COVEO_SHOPIFY_CONFIG_KEY } from '../constants';
-export type { AppProxyConfig, AppProxyResponse } from '../types';
+export type * from '../types';
 export * from '@coveo/headless';
+export * from '../constants';
 export * from '../utilities';
 export interface BuildShopifySearchEngineOptions {
     searchEngineOptions: SearchEngineOptions;

package/dist/headless/search.esm.js

@@ -32,14 +32,76 @@ function publishCustomShopifyEvent(key, customData) {
 // src/headless/search.ts
 export * from "@coveo/headless";
 
+// src/utilities/memoize.ts
+function memoize(fn, getCacheKey) {
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    fn: async (...args) => {
+      const key = getCacheKey(...args);
+      if (cache.has(key)) {
+        return cache.get(key);
+      }
+      const promise = fn(...args);
+      cache.set(key, promise);
+      try {
+        const result = await promise;
+        return result;
+      } catch (error) {
+        cache.delete(key);
+        throw error;
+      }
+    },
+    clearCache: () => {
+      cache.clear();
+    },
+    clearCacheEntry: (...args) => {
+      const key = getCacheKey(...args);
+      cache.delete(key);
+    }
+  };
+}
+
 // src/utilities/app-proxy.ts
+var memoizedFetch = memoize(
+  (...args) => global.fetch(...args),
+  (url) => url
+);
 async function fetchAppProxyConfig({
   appProxyUrl = "/apps/coveo",
   marketId
 }) {
-  const response = await fetch(`${appProxyUrl}?marketId=${marketId}]`);
+  const url = `${appProxyUrl}?marketId=${marketId}`;
+  const response = await memoizedFetch.fn(url);
+  if (!response.ok) {
+    memoizedFetch.clearCacheEntry(url);
+    throw new Error(
+      `Failed to fetch app proxy configuration from ${appProxyUrl} for marketId ${marketId}. Status: ${response.status}`
+    );
+  }
   return response.json();
 }
+function clearAppProxyCache() {
+  memoizedFetch.clearCache();
+}
+
+// src/utilities/init.ts
+import { getAnalyticsNextApiBaseUrl } from "@coveo/headless";
+import { createRelay } from "@coveo/relay";
+function init(options) {
+  const relay = createRelay({
+    url: getAnalyticsNextApiBaseUrl(
+      options.organizationId,
+      options.environment
+    ),
+    token: options.accessToken,
+    trackingId: options.trackingId
+  });
+  const clientId = relay.getMeta("").clientId;
+  publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
+    ...options,
+    clientId
+  });
+}
 
 // src/headless/search.ts
 function buildShopifySearchEngine({
@@ -50,7 +112,7 @@ function buildShopifySearchEngine({
       "The configuration for the search engine must include an analytics tracking ID."
     );
   }
-  const appProxyResponse = {
+  const options = {
     accessToken: searchEngineOptions.configuration.accessToken,
     organizationId: searchEngineOptions.configuration.organizationId,
     environment: searchEngineOptions.configuration.environment,
@@ -59,7 +121,7 @@ function buildShopifySearchEngine({
   const engine = buildSearchEngine(searchEngineOptions);
   const clientId = engine.relay.getMeta("").clientId;
   publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
-    ...appProxyResponse,
+    ...options,
     clientId
   });
   return engine;
@@ -67,6 +129,8 @@ function buildShopifySearchEngine({
 export {
   COVEO_SHOPIFY_CONFIG_KEY,
   buildShopifySearchEngine,
+  clearAppProxyCache,
   fetchAppProxyConfig,
+  init,
   publishCustomShopifyEvent
 };

package/dist/headless/search.js

@@ -3,6 +3,7 @@ import { COVEO_SHOPIFY_CONFIG_KEY } from '../constants';
 import { publishCustomShopifyEvent } from '../utilities/shopify';
 export { COVEO_SHOPIFY_CONFIG_KEY } from '../constants';
 export * from '@coveo/headless';
+export * from '../constants';
 export * from '../utilities';
 /**
  * Builds the search engine for a Shopify store.
@@ -19,7 +20,7 @@ export function buildShopifySearchEngine({ searchEngineOptions, }) {
     if (!searchEngineOptions.configuration.analytics?.trackingId) {
         throw new Error('The configuration for the search engine must include an analytics tracking ID.');
     }
-    const appProxyResponse = {
+    const options = {
         accessToken: searchEngineOptions.configuration.accessToken,
         organizationId: searchEngineOptions.configuration.organizationId,
         environment: searchEngineOptions.configuration.environment,
@@ -28,7 +29,7 @@ export function buildShopifySearchEngine({ searchEngineOptions, }) {
     const engine = buildSearchEngine(searchEngineOptions);
     const clientId = engine.relay.getMeta('').clientId;
     publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
-        ...appProxyResponse,
+        ...options,
         clientId,
     });
     return engine;

package/dist/headless.esm.js

@@ -38,7 +38,9 @@ var index_exports = {};
 __export(index_exports, {
   COVEO_SHOPIFY_CONFIG_KEY: () => COVEO_SHOPIFY_CONFIG_KEY,
   buildShopifyCommerceEngine: () => buildShopifyCommerceEngine,
+  clearAppProxyCache: () => clearAppProxyCache,
   fetchAppProxyConfig: () => fetchAppProxyConfig,
+  init: () => init,
   publishCustomShopifyEvent: () => publishCustomShopifyEvent
 });
 
@@ -47,7 +49,9 @@ var commerce_exports = {};
 __export(commerce_exports, {
   COVEO_SHOPIFY_CONFIG_KEY: () => COVEO_SHOPIFY_CONFIG_KEY,
   buildShopifyCommerceEngine: () => buildShopifyCommerceEngine,
+  clearAppProxyCache: () => clearAppProxyCache,
   fetchAppProxyConfig: () => fetchAppProxyConfig,
+  init: () => init,
   publishCustomShopifyEvent: () => publishCustomShopifyEvent
 });
 import {
@@ -68,20 +72,82 @@ function publishCustomShopifyEvent(key, customData) {
 __reExport(commerce_exports, commerce_star);
 import * as commerce_star from "@coveo/headless/commerce";
 
+// src/utilities/memoize.ts
+function memoize(fn, getCacheKey) {
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    fn: async (...args) => {
+      const key = getCacheKey(...args);
+      if (cache.has(key)) {
+        return cache.get(key);
+      }
+      const promise = fn(...args);
+      cache.set(key, promise);
+      try {
+        const result = await promise;
+        return result;
+      } catch (error) {
+        cache.delete(key);
+        throw error;
+      }
+    },
+    clearCache: () => {
+      cache.clear();
+    },
+    clearCacheEntry: (...args) => {
+      const key = getCacheKey(...args);
+      cache.delete(key);
+    }
+  };
+}
+
 // src/utilities/app-proxy.ts
+var memoizedFetch = memoize(
+  (...args) => global.fetch(...args),
+  (url) => url
+);
 async function fetchAppProxyConfig({
   appProxyUrl = "/apps/coveo",
   marketId
 }) {
-  const response = await fetch(`${appProxyUrl}?marketId=${marketId}]`);
+  const url = `${appProxyUrl}?marketId=${marketId}`;
+  const response = await memoizedFetch.fn(url);
+  if (!response.ok) {
+    memoizedFetch.clearCacheEntry(url);
+    throw new Error(
+      `Failed to fetch app proxy configuration from ${appProxyUrl} for marketId ${marketId}. Status: ${response.status}`
+    );
+  }
   return response.json();
 }
+function clearAppProxyCache() {
+  memoizedFetch.clearCache();
+}
+
+// src/utilities/init.ts
+import { getAnalyticsNextApiBaseUrl } from "@coveo/headless";
+import { createRelay } from "@coveo/relay";
+function init(options) {
+  const relay = createRelay({
+    url: getAnalyticsNextApiBaseUrl(
+      options.organizationId,
+      options.environment
+    ),
+    token: options.accessToken,
+    trackingId: options.trackingId
+  });
+  const clientId = relay.getMeta("").clientId;
+  publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
+    ...options,
+    clientId
+  });
+}
 
 // src/headless/commerce.ts
 function buildShopifyCommerceEngine({
   commerceEngineOptions
 }) {
-  const appProxyResponse = {
+  const options = {
     accessToken: commerceEngineOptions.configuration.accessToken,
     organizationId: commerceEngineOptions.configuration.organizationId,
     environment: commerceEngineOptions.configuration.environment,
@@ -90,7 +156,7 @@ function buildShopifyCommerceEngine({
   const engine = buildCommerceEngine(commerceEngineOptions);
   const clientId = engine.relay.getMeta("").clientId;
   publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
-    ...appProxyResponse,
+    ...options,
     clientId
   });
   return engine;
@@ -101,6 +167,8 @@ __reExport(index_exports, commerce_exports);
 export {
   COVEO_SHOPIFY_CONFIG_KEY,
   buildShopifyCommerceEngine,
+  clearAppProxyCache,
   fetchAppProxyConfig,
+  init,
   publishCustomShopifyEvent
 };

package/dist/types.d.ts

@@ -1,14 +1,14 @@
 import { CommerceEngineOptions } from '@coveo/headless/commerce';
-export interface AppProxyConfig {
+export interface AppProxyOptions {
     appProxyUrl?: string;
     marketId: string;
 }
-export interface AppProxyResponse {
+export interface CoveoShopifyOptions {
     accessToken: string;
     organizationId: string;
     environment: CommerceEngineOptions['configuration']['environment'];
     trackingId: string;
 }
-export type CoveoShopifyCustomEvent = AppProxyResponse & {
+export interface CoveoShopifyCustomEvent extends CoveoShopifyOptions {
     clientId: string;
-};
+}

package/dist/utilities/app-proxy.d.ts

@@ -1,13 +1,14 @@
-import { AppProxyConfig, AppProxyResponse } from '../types';
+import { AppProxyOptions, CoveoShopifyOptions } from '../types';
 /**
  * Fetches configuration from the app proxy.
  *
  * Performs an HTTP GET request to retrieve the app proxy configuration using the provided marketId.
- * The fetched response is parsed as JSON and returned.
+ * The fetched response is parsed as JSON and returned. Results are automatically memoized by URL.
  *
  * @param appProxyUrl - The URL template for the app proxy endpoint. Defaults to '/apps/coveo'.
  * @param marketId - The unique market identifier used as a query parameter.
  * @returns A promise that resolves to an object containing the access token, organization ID,
  *          environment, and tracking ID.
  */
-export declare function fetchAppProxyConfig({ appProxyUrl, marketId, }: AppProxyConfig): Promise<AppProxyResponse>;
+export declare function fetchAppProxyConfig({ appProxyUrl, marketId, }: AppProxyOptions): Promise<CoveoShopifyOptions>;
+export declare function clearAppProxyCache(): void;

package/dist/utilities/app-proxy.js

@@ -1,8 +1,10 @@
+import { memoize } from './memoize';
+const memoizedFetch = memoize((...args) => global.fetch(...args), (url) => url);
 /**
  * Fetches configuration from the app proxy.
  *
  * Performs an HTTP GET request to retrieve the app proxy configuration using the provided marketId.
- * The fetched response is parsed as JSON and returned.
+ * The fetched response is parsed as JSON and returned. Results are automatically memoized by URL.
  *
  * @param appProxyUrl - The URL template for the app proxy endpoint. Defaults to '/apps/coveo'.
  * @param marketId - The unique market identifier used as a query parameter.
@@ -10,6 +12,14 @@
  *          environment, and tracking ID.
  */
 export async function fetchAppProxyConfig({ appProxyUrl = '/apps/coveo', marketId, }) {
-    const response = await fetch(`${appProxyUrl}?marketId=${marketId}]`);
+    const url = `${appProxyUrl}?marketId=${marketId}`;
+    const response = await memoizedFetch.fn(url);
+    if (!response.ok) {
+        memoizedFetch.clearCacheEntry(url);
+        throw new Error(`Failed to fetch app proxy configuration from ${appProxyUrl} for marketId ${marketId}. Status: ${response.status}`);
+    }
     return response.json();
 }
+export function clearAppProxyCache() {
+    memoizedFetch.clearCache();
+}

package/dist/utilities/index.d.ts

@@ -1,4 +1,5 @@
-export type { CoveoShopifyCustomEvent } from '../types';
+export type * from '../types';
 export { publishCustomShopifyEvent } from './shopify';
-export { fetchAppProxyConfig } from './app-proxy';
+export * from './app-proxy';
+export * from './init';
 export * from '../constants';

package/dist/utilities/index.js

@@ -1,3 +1,4 @@
 export { publishCustomShopifyEvent } from './shopify';
-export { fetchAppProxyConfig } from './app-proxy';
+export * from './app-proxy';
+export * from './init';
 export * from '../constants';

package/dist/utilities/init.d.ts

@@ -0,0 +1,2 @@
+import { CoveoShopifyOptions } from '../types';
+export declare function init(options: CoveoShopifyOptions): void;

package/dist/utilities/init.js

@@ -0,0 +1,16 @@
+import { getAnalyticsNextApiBaseUrl } from '@coveo/headless';
+import { createRelay } from '@coveo/relay';
+import { COVEO_SHOPIFY_CONFIG_KEY } from '../constants';
+import { publishCustomShopifyEvent } from './shopify';
+export function init(options) {
+    const relay = createRelay({
+        url: getAnalyticsNextApiBaseUrl(options.organizationId, options.environment),
+        token: options.accessToken,
+        trackingId: options.trackingId,
+    });
+    const clientId = relay.getMeta('').clientId;
+    publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
+        ...options,
+        clientId,
+    });
+}

package/dist/utilities/memoize.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Creates a memoized version of an async function with a custom cache key generator.
+ * Only successful results are cached - rejected promises are not remembered.
+ *
+ * @param fn - The async function to memoize
+ * @param getCacheKey - Function that generates a cache key from the function arguments
+ * @returns Object with the memoized function and cache clearing capability
+ */
+export declare function memoize<TArgs extends unknown[], TReturn>(fn: (...args: TArgs) => Promise<TReturn>, getCacheKey: (...args: TArgs) => string): {
+    fn: (...args: TArgs) => Promise<TReturn>;
+    clearCache: () => void;
+    clearCacheEntry: (...args: TArgs) => void;
+};

package/dist/utilities/memoize.js

@@ -0,0 +1,37 @@
+/**
+ * Creates a memoized version of an async function with a custom cache key generator.
+ * Only successful results are cached - rejected promises are not remembered.
+ *
+ * @param fn - The async function to memoize
+ * @param getCacheKey - Function that generates a cache key from the function arguments
+ * @returns Object with the memoized function and cache clearing capability
+ */
+export function memoize(fn, getCacheKey) {
+    const cache = new Map();
+    return {
+        fn: async (...args) => {
+            const key = getCacheKey(...args);
+            if (cache.has(key)) {
+                return cache.get(key);
+            }
+            const promise = fn(...args);
+            cache.set(key, promise);
+            try {
+                const result = await promise;
+                return result;
+            }
+            catch (error) {
+                // Remove failed promises from cache so they can be retried
+                cache.delete(key);
+                throw error;
+            }
+        },
+        clearCache: () => {
+            cache.clear();
+        },
+        clearCacheEntry: (...args) => {
+            const key = getCacheKey(...args);
+            cache.delete(key);
+        },
+    };
+}

package/dist/utilities.esm.js

@@ -23,19 +23,85 @@ function publishCustomShopifyEvent(key, customData) {
   }
 }
 
+// src/utilities/memoize.ts
+function memoize(fn, getCacheKey) {
+  const cache = /* @__PURE__ */ new Map();
+  return {
+    fn: async (...args) => {
+      const key = getCacheKey(...args);
+      if (cache.has(key)) {
+        return cache.get(key);
+      }
+      const promise = fn(...args);
+      cache.set(key, promise);
+      try {
+        const result = await promise;
+        return result;
+      } catch (error) {
+        cache.delete(key);
+        throw error;
+      }
+    },
+    clearCache: () => {
+      cache.clear();
+    },
+    clearCacheEntry: (...args) => {
+      const key = getCacheKey(...args);
+      cache.delete(key);
+    }
+  };
+}
+
 // src/utilities/app-proxy.ts
+var memoizedFetch = memoize(
+  (...args) => global.fetch(...args),
+  (url) => url
+);
 async function fetchAppProxyConfig({
   appProxyUrl = "/apps/coveo",
   marketId
 }) {
-  const response = await fetch(`${appProxyUrl}?marketId=${marketId}]`);
+  const url = `${appProxyUrl}?marketId=${marketId}`;
+  const response = await memoizedFetch.fn(url);
+  if (!response.ok) {
+    memoizedFetch.clearCacheEntry(url);
+    throw new Error(
+      `Failed to fetch app proxy configuration from ${appProxyUrl} for marketId ${marketId}. Status: ${response.status}`
+    );
+  }
   return response.json();
 }
+function clearAppProxyCache() {
+  memoizedFetch.clearCache();
+}
+
+// src/utilities/init.ts
+import { getAnalyticsNextApiBaseUrl } from "@coveo/headless";
+import { createRelay } from "@coveo/relay";
 
 // src/constants.ts
 var COVEO_SHOPIFY_CONFIG_KEY = "coveo_shopify_config";
+
+// src/utilities/init.ts
+function init(options) {
+  const relay = createRelay({
+    url: getAnalyticsNextApiBaseUrl(
+      options.organizationId,
+      options.environment
+    ),
+    token: options.accessToken,
+    trackingId: options.trackingId
+  });
+  const clientId = relay.getMeta("").clientId;
+  publishCustomShopifyEvent(COVEO_SHOPIFY_CONFIG_KEY, {
+    ...options,
+    clientId
+  });
+}
 export {
   COVEO_SHOPIFY_CONFIG_KEY,
+  clearAppProxyCache,
   fetchAppProxyConfig,
+  init,
   publishCustomShopifyEvent
 };

package/package.json

@@ -8,7 +8,7 @@
   "main": "./dist/headless.esm.js",
   "module": "./dist/headless.esm.js",
   "license": "Apache-2.0",
-  "version": "1.6.1-pre.fda43fc695",
+  "version": "1.7.0-pre.153636d7cb",
   "files": [
     "dist/"
   ],
@@ -38,6 +38,11 @@
       "types": "./dist/utilities/index.d.ts",
       "import": "./dist/utilities.esm.js",
       "default": "./dist/utilities.esm.js"
+    },
+    "./constants": {
+      "types": "./dist/constants.d.ts",
+      "import": "./dist/constants.esm.js",
+      "default": "./dist/constants.esm.js"
     }
   },
   "scripts": {
@@ -56,7 +61,8 @@
     "vitest": "3.2.3"
   },
   "dependencies": {
-    "@coveo/headless": "3.26.2-pre.fda43fc695",
+    "@coveo/relay": "1.2.1",
+    "@coveo/headless": "3.27.0-pre.153636d7cb",
     "uuid": "^11.0.0"
   },
   "engines": {