feat(headless): enforce organization endpoints usage for headless commerce

packages/atomic/src/components.d.ts

@@ -331,12 +331,6 @@ export namespace Components {
           * Executes the first search after initializing connection to the headless search engine.
          */
         "executeFirstSearch": () => Promise<void>;
-        /**
-          * Returns the unique, organization-specific endpoint(s).
-          * @param organizationId
-          * @param env
-         */
-        "getOrganizationEndpoints": (organizationId: string, env?: PlatformEnvironment) => Promise<{ platform: string; analytics: string; search: string; admin: string; }>;
         /**
           * the commerce interface i18next instance.
          */

packages/atomic/src/components/commerce/atomic-commerce-interface/atomic-commerce-interface.tsx

@@ -1,11 +1,9 @@
 import {
-  PlatformEnvironment,
   LogLevel,
   Search,
   Unsubscribe,
   UrlManager,
   buildSearch,
-  getOrganizationEndpoints as getOrganizationEndpointsHeadless,
   updateQuery,
   CommerceEngine,
   CommerceEngineConfiguration,
@@ -284,18 +282,6 @@ export class AtomicCommerceInterface
     this.engine.executeFirstSearch();
   }
 
-  /**
-   * Returns the unique, organization-specific endpoint(s).
-   * @param {string} organizationId
-   * @param {'prod'|'hipaa'|'staging'|'dev'} [env=Prod]
-   */
-  @Method() public async getOrganizationEndpoints(
-    organizationId: string,
-    env: PlatformEnvironment = 'prod'
-  ) {
-    return getOrganizationEndpointsHeadless(organizationId, env);
-  }
-
   public get bindings(): CommerceBindings {
     return {
       engine: this.engine!,

packages/atomic/src/pages/examples/commerce-website/engine.mjs

@@ -1,8 +1,5 @@
 import {navContent} from './commerce-nav.mjs';
-import {
-  getOrganizationEndpoints,
-  buildCommerceEngine,
-} from '/build/headless/commerce/headless.esm.js';
+import {buildCommerceEngine} from '/build/headless/commerce/headless.esm.js';
 
 export const commerceEngine = buildCommerceEngine({
   configuration: {
@@ -17,6 +14,7 @@ export const commerceEngine = buildCommerceEngine({
       },
     },
     organizationId: 'barcasportsmcy01fvu',
+    environment: 'dev',
     analytics: {
       trackingId: 'sports',
     },
@@ -52,9 +50,5 @@ export const commerceEngine = buildCommerceEngine({
         },
       ],
     },
-    organizationEndpoints: await getOrganizationEndpoints(
-      'barcasportsmcy01fvu',
-      'dev'
-    ),
   },
 });

packages/headless/src/app/commerce-engine/commerce-engine-configuration.ts

@@ -1,9 +1,9 @@
-import {RecordValue, Schema} from '@coveo/bueno';
-import {getOrganizationEndpoints} from '../../api/platform-client';
+import {RecordValue, Schema, StringValue} from '@coveo/bueno';
 import {CartInitialState} from '../../controllers/commerce/context/cart/headless-cart';
 import {ContextOptions} from '../../controllers/commerce/context/headless-context';
 import {cartDefinition} from '../../features/commerce/context/cart/cart-validation';
 import {contextDefinition} from '../../features/commerce/context/context-validation';
+import {PlatformEnvironment} from '../../utils/url-utils';
 import {
   EngineConfiguration,
   engineConfigurationDefinitions,
@@ -17,6 +17,7 @@ import {
 export interface CommerceEngineConfiguration extends EngineConfiguration {
   context: ContextOptions;
   cart?: CartInitialState;
+  environment?: PlatformEnvironment;
 }
 
 export const commerceEngineConfigurationSchema =
@@ -29,16 +30,19 @@ export const commerceEngineConfigurationSchema =
     cart: new RecordValue({
       values: cartDefinition,
     }),
+    environment: new StringValue<PlatformEnvironment>({
+      required: false,
+      constrainTo: ['prod', 'hipaa', 'stg', 'dev'],
+      emptyAllowed: false,
+      default: 'prod',
+    }),
   });
 
 export function getSampleCommerceEngineConfiguration(): CommerceEngineConfiguration {
   return {
     organizationId: 'fashioncoveodemocomgzh7iep8',
     // deepcode ignore HardcodedNonCryptoSecret: Public key freely available for our documentation
     accessToken: 'xx149e3ec9-786f-4c6c-b64f-49a403b930de',
-    organizationEndpoints: getOrganizationEndpoints(
-      'fashioncoveodemocomgzh7iep8'
-    ),
     context: {
       language: 'en',
       country: 'CA',

packages/headless/src/app/commerce-engine/commerce-engine.test.ts

@@ -1,3 +1,4 @@
+import {getOrganizationEndpoints} from '../../api/platform-client';
 import {createCartKey} from '../../controllers/commerce/context/cart/headless-cart';
 import {stateKey} from '../state-key';
 import {
@@ -64,4 +65,37 @@ describe('buildCommerceEngine', () => {
       [createCartKey(items[1])]: items[1],
     });
   });
+
+  it('uses organization endpoints when manually configured', () => {
+    options.configuration.organizationEndpoints = getOrganizationEndpoints(
+      'my-org-id',
+      'hipaa'
+    );
+    initEngine();
+
+    expect(engine.configuration.platformUrl).toBe(
+      'https://my-org-id.orghipaa.coveo.com'
+    );
+  });
+
+  it('uses organization endpoints when not manually specified', () => {
+    options.configuration.organizationEndpoints = undefined;
+    options.configuration.environment = 'hipaa';
+    options.configuration.organizationId = 'my-org-id';
+    initEngine();
+
+    expect(engine.configuration.platformUrl).toBe(
+      'https://my-org-id.orghipaa.coveo.com'
+    );
+  });
+
+  it('uses organization endpoints defaulting to prod when not manually specified', () => {
+    options.configuration.organizationEndpoints = undefined;
+    options.configuration.organizationId = 'my-org-id';
+    initEngine();
+
+    expect(engine.configuration.platformUrl).toBe(
+      'https://my-org-id.org.coveo.com'
+    );
+  });
 });

packages/headless/src/app/commerce-engine/commerce-engine.ts

@@ -1,6 +1,7 @@
 import {StateFromReducersMapObject} from '@reduxjs/toolkit';
 import {Logger} from 'pino';
 import {CommerceAPIClient} from '../../api/commerce/commerce-api-client';
+import {getOrganizationEndpoints} from '../../api/platform-client';
 import {NoopPreprocessRequest} from '../../api/preprocess-request';
 import {setItems} from '../../features/commerce/context/cart/cart-actions';
 import {cartReducer} from '../../features/commerce/context/cart/cart-slice';
@@ -114,6 +115,16 @@ export function buildCommerceEngine(
 
   const augmentedOptions: EngineOptions<CommerceEngineReducers> = {
     ...options,
+    configuration: {
+      ...options.configuration,
+      organizationEndpoints: {
+        ...getOrganizationEndpoints(
+          options.configuration.organizationId,
+          options.configuration.environment
+        ),
+        ...options.configuration.organizationEndpoints,
+      },
+    },
     reducers: commerceEngineReducers,
   };
 

packages/samples/atomic-react/src/pages/CommerceSearchPage.tsx

@@ -5,7 +5,6 @@ import {
   AtomicProductText,
   AtomicProductPrice,
   AtomicProductDescription,
-  getOrganizationEndpoints,
   buildCommerceEngine,
   AtomicCommerceSearchBox,
   AtomicCommerceSearchBoxInstantProducts,
@@ -32,10 +31,7 @@ export const CommerceSearchPage = () => {
         configuration: {
           accessToken: 'xxc481d5de-16cb-4290-bd78-45345319d94c',
           organizationId: 'barcasportsmcy01fvu',
-          organizationEndpoints: getOrganizationEndpoints(
-            'barcasportsmcy01fvu',
-            'dev'
-          ),
+          environment: 'dev',
           analytics: {
             trackingId: 'sports',
           },