@reactionary/hcl 0.9.8 → 0.9.11

package/capabilities/price.capability.js

@@ -0,0 +1,122 @@
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __decorateClass = (decorators, target, key, kind) => {
+  var result = kind > 1 ? void 0 : kind ? __getOwnPropDesc(target, key) : target;
+  for (var i = decorators.length - 1, decorator; i >= 0; i--)
+    if (decorator = decorators[i])
+      result = (kind ? decorator(target, key, result) : decorator(result)) || result;
+  if (kind && result)
+    __defProp(target, key, result);
+  return result;
+};
+import {
+  CustomerPriceQuerySchema,
+  ListPriceQuerySchema,
+  PriceCapability,
+  PriceSchema,
+  Reactionary,
+  success
+} from "@reactionary/core";
+import { SESSION_KEY_PRICE_RULE_ID } from "../core/session-keys.js";
+class HclPriceCapability extends PriceCapability {
+  constructor(cache, context, config, client, factory) {
+    super(cache, context);
+    this.config = config;
+    this.client = client;
+    this.factory = factory;
+  }
+  async getListPrice(payload) {
+    const sku = payload.variant.sku;
+    const priceRuleId = this.context.session[SESSION_KEY_PRICE_RULE_ID];
+    if (!priceRuleId) {
+      const response2 = await this.client.callGet(
+        this.getCustomerPriceUrl(),
+        this.getCustomerPricePayload(sku)
+      );
+      const rawItem2 = response2.EntitledPrice?.find((i) => i.partNumber === sku);
+      if (!rawItem2) {
+        return success(
+          this.factory.parsePrice(this.context, {
+            item: { partNumber: sku }
+          })
+        );
+      }
+      return success(
+        this.factory.parsePrice(this.context, {
+          item: rawItem2
+        })
+      );
+    }
+    const response = await this.client.callGet(
+      this.getListPriceUrl(),
+      this.getListPricePayload(sku, priceRuleId)
+    );
+    const rawItem = response.resultList?.find((i) => i.partNumber === sku);
+    if (!rawItem) {
+      return success(
+        this.factory.parsePrice(this.context, {
+          item: { partNumber: sku }
+        })
+      );
+    }
+    return success(
+      this.factory.parsePrice(this.context, {
+        item: rawItem
+      })
+    );
+  }
+  async getCustomerPrice(payload) {
+    const sku = payload.variant.sku;
+    const response = await this.client.callGet(
+      this.getCustomerPriceUrl(),
+      this.getCustomerPricePayload(sku)
+    );
+    const rawItem = response.EntitledPrice?.find((i) => i.partNumber === sku);
+    if (!rawItem) {
+      return success(
+        this.factory.parsePrice(this.context, {
+          item: { partNumber: sku }
+        })
+      );
+    }
+    return success(
+      this.factory.parsePrice(this.context, {
+        item: rawItem
+      })
+    );
+  }
+  getListPriceUrl() {
+    return `${this.client.transactionBaseUrl}/display_price`;
+  }
+  getListPricePayload(sku, priceRuleId) {
+    const params = new URLSearchParams();
+    params.set("q", "byPartNumbersAndPriceRuleId");
+    params.set("priceRuleId", priceRuleId);
+    params.append("partNumber", sku);
+    return params;
+  }
+  getCustomerPriceUrl() {
+    return `${this.client.transactionBaseUrl}/price`;
+  }
+  getCustomerPricePayload(sku) {
+    const params = new URLSearchParams();
+    params.set("q", "byPartNumbers");
+    params.append("partNumber", sku);
+    return params;
+  }
+}
+__decorateClass([
+  Reactionary({
+    inputSchema: ListPriceQuerySchema,
+    outputSchema: PriceSchema
+  })
+], HclPriceCapability.prototype, "getListPrice", 1);
+__decorateClass([
+  Reactionary({
+    inputSchema: CustomerPriceQuerySchema,
+    outputSchema: PriceSchema
+  })
+], HclPriceCapability.prototype, "getCustomerPrice", 1);
+export {
+  HclPriceCapability
+};

package/capabilities/product-search.capability.js

@@ -18,7 +18,6 @@ import {
   Reactionary,
   success
 } from "@reactionary/core";
-import { getLocaleParams } from "../core/locale-params.js";
 class HclProductSearchCapability extends ProductSearchCapability {
   constructor(cache, context, config, client, factory) {
     super(cache, context);
@@ -29,21 +28,19 @@ class HclProductSearchCapability extends ProductSearchCapability {
   queryByTermPayload(payload) {
     const { term, paginationOptions, categoryFilter, facets } = payload.search;
     const { pageNumber, pageSize } = paginationOptions;
-    const { langId, currency } = getLocaleParams(this.config, this.context);
     const categoryId = categoryFilter?.key || void 0;
-    return {
+    return this.productsParams({
       searchTerm: term || void 0,
       categoryId,
       limit: pageSize,
       offset: (pageNumber - 1) * pageSize,
       profileName: categoryId ? this.config.profiles.categoryBrowse : this.config.profiles.productSearch,
-      facets: facets.length > 0 ? facets.map((f) => f.key) : void 0,
-      langId,
-      currency
-    };
+      facets: facets.length > 0 ? facets.map((f) => f.key) : void 0
+    });
   }
   async queryByTerm(payload) {
-    const response = await this.client.findProducts(
+    const response = await this.client.callGet(
+      this.queryByTermUrl(payload),
       this.queryByTermPayload(payload)
     );
     const value = this.factory.parseSearchResult(
@@ -58,11 +55,10 @@ class HclProductSearchCapability extends ProductSearchCapability {
     const externalKey = leaf?.identifier.key ?? "";
     let uniqueId = leaf?.uniqueId;
     if (!uniqueId) {
-      const { langId } = getLocaleParams(this.config, this.context);
-      const catResp = await this.client.findCategories({
-        identifier: [externalKey],
-        langId
-      });
+      const catResp = await this.client.callGet(
+        this.categoriesUrl(),
+        this.categoriesParams({ identifier: [externalKey] })
+      );
       uniqueId = catResp.contents?.[0]?.uniqueID ?? externalKey;
     }
     const filter = {
@@ -71,6 +67,61 @@ class HclProductSearchCapability extends ProductSearchCapability {
     };
     return success(filter);
   }
+  queryByTermUrl(_payload) {
+    return this.productsUrl();
+  }
+  productsUrl() {
+    return `${this.client.catalogBaseUrl}/api/v2/products`;
+  }
+  productsParams(query) {
+    const params = new URLSearchParams();
+    params.set("storeId", query.storeId ?? this.config.storeId);
+    const catalogId = query.catalogId ?? this.config.catalogId;
+    if (catalogId)
+      params.set("catalogId", catalogId);
+    if (query.categoryId)
+      params.set("categoryId", query.categoryId);
+    if (query.searchTerm)
+      params.set("searchTerm", query.searchTerm);
+    if (query.contractId)
+      params.set("contractId", query.contractId);
+    if (query.profileName)
+      params.set("profileName", query.profileName);
+    if (query.limit !== void 0)
+      params.set("limit", String(query.limit));
+    if (query.offset !== void 0)
+      params.set("offset", String(query.offset));
+    if (query.checkEntitlement !== void 0)
+      params.set("checkEntitlement", String(query.checkEntitlement));
+    for (const id of query.id ?? [])
+      params.append("id", id);
+    for (const pn of query.partNumber ?? [])
+      params.append("partNumber", pn);
+    for (const facet of query.facets ?? [])
+      params.append("facet", facet);
+    return params;
+  }
+  categoriesUrl() {
+    return `${this.client.catalogBaseUrl}/api/v2/categories`;
+  }
+  categoriesParams(query) {
+    const params = new URLSearchParams();
+    params.set("storeId", query.storeId ?? this.config.storeId);
+    const catalogId = query.catalogId ?? this.config.catalogId;
+    if (catalogId)
+      params.set("catalogId", catalogId);
+    if (query.parentCategoryId)
+      params.set("parentCategoryId", query.parentCategoryId);
+    if (query.depthAndLimit)
+      params.set("depthAndLimit", query.depthAndLimit);
+    if (query.profileName)
+      params.set("profileName", query.profileName);
+    for (const id of query.id ?? [])
+      params.append("id", id);
+    for (const identifier of query.identifier ?? [])
+      params.append("identifier", identifier);
+    return params;
+  }
 }
 __decorateClass([
   Reactionary({

package/capabilities/product.capability.js

@@ -19,7 +19,6 @@ import {
   error,
   success
 } from "@reactionary/core";
-import { getLocaleParams } from "../core/locale-params.js";
 class HclProductCapability extends ProductCapability {
   constructor(cache, context, config, client, factory) {
     super(cache, context);
@@ -28,13 +27,10 @@ class HclProductCapability extends ProductCapability {
     this.factory = factory;
   }
   async getById(payload) {
-    const { langId, currency } = getLocaleParams(this.config, this.context);
-    const response = await this.client.findProducts({
-      partNumber: [payload.identifier.key],
-      profileName: this.config.profiles.product,
-      langId,
-      currency
-    });
+    const response = await this.client.callGet(
+      this.getByIdUrl(payload),
+      this.getByIdPayload(payload)
+    );
     const products = response.contents ?? response.catalogEntryView ?? [];
     const data = products[0];
     if (!data) {
@@ -45,25 +41,27 @@ class HclProductCapability extends ProductCapability {
     }
     const value = this.factory.parseProduct(
       this.context,
-      await this.withResolvedParentCategories(data, langId)
+      await this.withResolvedParentCategories(data)
     );
     return success(value);
   }
   async getBySlug(payload) {
-    const { langId, currency } = getLocaleParams(this.config, this.context);
-    const token = await this.client.resolveSlug(payload.slug, langId);
+    const urlResponse = await this.client.callGet(
+      this.urlsUrl(),
+      this.urlsParams(payload.slug),
+      { allowUndefined: true }
+    );
+    const token = urlResponse?.contents?.[0];
     if (!token || token.tokenName !== "ProductToken" || !token.tokenExternalValue) {
       return error({
         type: "NotFound",
         identifier: payload.slug
       });
     }
-    const response = await this.client.findProducts({
-      partNumber: [token.tokenExternalValue],
-      profileName: this.config.profiles.product,
-      langId,
-      currency
-    });
+    const response = await this.client.callGet(
+      this.getBySlugUrl(token),
+      this.getBySlugPayload(token)
+    );
     const products = response.contents ?? response.catalogEntryView ?? [];
     const data = products[0];
     if (!data) {
@@ -74,18 +72,15 @@ class HclProductCapability extends ProductCapability {
     }
     const value = this.factory.parseProduct(
       this.context,
-      await this.withResolvedParentCategories(data, langId)
+      await this.withResolvedParentCategories(data)
     );
     return success(value);
   }
   async getBySKU(payload) {
-    const { langId, currency } = getLocaleParams(this.config, this.context);
-    const response = await this.client.findProducts({
-      partNumber: [payload.variant.sku],
-      profileName: this.config.profiles.product,
-      langId,
-      currency
-    });
+    const response = await this.client.callGet(
+      this.getBySKUUrl(payload),
+      this.getBySKUPayload(payload)
+    );
     const products = response.contents ?? response.catalogEntryView ?? [];
     const data = products[0];
     if (!data) {
@@ -96,7 +91,7 @@ class HclProductCapability extends ProductCapability {
     }
     const value = this.factory.parseProduct(
       this.context,
-      await this.withResolvedParentCategories(data, langId)
+      await this.withResolvedParentCategories(data)
     );
     return success(value);
   }
@@ -105,7 +100,7 @@ class HclProductCapability extends ProductCapability {
    * category identifiers (e.g. "LivingRoomFurniture") so the factory receives
    * human-readable keys rather than internal uniqueIDs.
    */
-  async withResolvedParentCategories(data, langId) {
+  async withResolvedParentCategories(data) {
     const rawIds = Array.isArray(data.parentCatalogGroupID) ? data.parentCatalogGroupID : data.parentCatalogGroupID ? [data.parentCatalogGroupID] : [];
     const uniqueIds = [
       ...new Set(
@@ -114,13 +109,104 @@ class HclProductCapability extends ProductCapability {
     ];
     if (uniqueIds.length === 0)
       return data;
-    const catResp = await this.client.findCategories({ id: uniqueIds, langId });
+    const catResp = await this.client.callGet(
+      this.categoriesUrl(),
+      this.categoriesParams({ id: uniqueIds })
+    );
     const idToIdentifier = new Map(
       (catResp.contents ?? []).map((c) => [c.uniqueID, c.identifier])
     );
     const resolvedIds = uniqueIds.map((id) => idToIdentifier.get(id) ?? id);
     return { ...data, parentCatalogGroupID: resolvedIds };
   }
+  getByIdUrl(_payload) {
+    return this.productsUrl();
+  }
+  getBySlugUrl(_token) {
+    return this.productsUrl();
+  }
+  getBySKUUrl(_payload) {
+    return this.productsUrl();
+  }
+  getByIdPayload(payload) {
+    return this.productsParams({
+      partNumber: [payload.identifier.key],
+      profileName: this.config.profiles.product
+    });
+  }
+  getBySlugPayload(token) {
+    return this.productsParams({
+      partNumber: [token.tokenExternalValue],
+      profileName: this.config.profiles.product
+    });
+  }
+  getBySKUPayload(payload) {
+    return this.productsParams({
+      partNumber: [payload.variant.sku],
+      profileName: this.config.profiles.product
+    });
+  }
+  productsUrl() {
+    return `${this.client.catalogBaseUrl}/api/v2/products`;
+  }
+  productsParams(query) {
+    const params = new URLSearchParams();
+    params.set("storeId", query.storeId ?? this.config.storeId);
+    const catalogId = query.catalogId ?? this.config.catalogId;
+    if (catalogId)
+      params.set("catalogId", catalogId);
+    if (query.categoryId)
+      params.set("categoryId", query.categoryId);
+    if (query.searchTerm)
+      params.set("searchTerm", query.searchTerm);
+    if (query.contractId)
+      params.set("contractId", query.contractId);
+    if (query.profileName)
+      params.set("profileName", query.profileName);
+    if (query.limit !== void 0)
+      params.set("limit", String(query.limit));
+    if (query.offset !== void 0)
+      params.set("offset", String(query.offset));
+    if (query.checkEntitlement !== void 0)
+      params.set("checkEntitlement", String(query.checkEntitlement));
+    for (const id of query.id ?? [])
+      params.append("id", id);
+    for (const pn of query.partNumber ?? [])
+      params.append("partNumber", pn);
+    for (const facet of query.facets ?? [])
+      params.append("facet", facet);
+    return params;
+  }
+  categoriesUrl() {
+    return `${this.client.catalogBaseUrl}/api/v2/categories`;
+  }
+  categoriesParams(query) {
+    const params = new URLSearchParams();
+    params.set("storeId", query.storeId ?? this.config.storeId);
+    const catalogId = query.catalogId ?? this.config.catalogId;
+    if (catalogId)
+      params.set("catalogId", catalogId);
+    if (query.parentCategoryId)
+      params.set("parentCategoryId", query.parentCategoryId);
+    if (query.depthAndLimit)
+      params.set("depthAndLimit", query.depthAndLimit);
+    if (query.profileName)
+      params.set("profileName", query.profileName);
+    for (const id of query.id ?? [])
+      params.append("id", id);
+    for (const identifier of query.identifier ?? [])
+      params.append("identifier", identifier);
+    return params;
+  }
+  urlsUrl() {
+    return `${this.client.catalogBaseUrl}/api/v2/urls`;
+  }
+  urlsParams(slug) {
+    const params = new URLSearchParams();
+    params.set("storeId", this.config.storeId);
+    params.append("identifier", slug);
+    return params;
+  }
 }
 __decorateClass([
   Reactionary({

package/core/client.js

@@ -1,120 +1,111 @@
+import { getLocaleParams } from "./locale-params.js";
+import {
+  SESSION_KEY_PERSONALIZATION_ID,
+  SESSION_KEY_WC_TOKEN,
+  SESSION_KEY_WC_TRUSTED_TOKEN
+} from "./session-keys.js";
+class HclCartNotFoundError extends Error {
+  constructor() {
+    super("No active cart found");
+    this.name = "HclCartNotFoundError";
+  }
+}
 class HclClient {
-  constructor(config) {
+  constructor(config, context) {
     this.config = config;
-    const origin = (config.searchApiUrl ?? config.apiUrl).replace(/\/+$/, "");
-    const apiPath = "/search/resources/api/v2";
-    this.baseUrl = `${origin}${apiPath}`;
+    this.context = context;
+    const origin = config.apiUrl.replace(/\/+$/, "");
+    const searchOrigin = (config.searchApiUrl ?? config.apiUrl).replace(/\/+$/, "");
+    this.catalogBaseUrl = `${searchOrigin}/search/resources`;
+    this.transactionBaseUrl = `${origin}/wcs/resources/store/${config.storeId}`;
   }
-  baseUrl;
-  async findProducts(query) {
-    const params = new URLSearchParams();
-    params.set("storeId", query.storeId ?? this.config.storeId);
-    const catalogId = query.catalogId ?? this.config.catalogId;
-    if (catalogId)
-      params.set("catalogId", catalogId);
-    if (query.langId)
-      params.set("langId", query.langId);
-    if (query.currency)
-      params.set("currency", query.currency);
-    if (query.categoryId)
-      params.set("categoryId", query.categoryId);
-    if (query.searchTerm)
-      params.set("searchTerm", query.searchTerm);
-    if (query.contractId)
-      params.set("contractId", query.contractId);
-    if (query.profileName)
-      params.set("profileName", query.profileName);
-    if (query.limit !== void 0)
-      params.set("limit", String(query.limit));
-    if (query.offset !== void 0)
-      params.set("offset", String(query.offset));
-    if (query.checkEntitlement !== void 0) {
-      params.set("checkEntitlement", String(query.checkEntitlement));
-    }
-    for (const id of query.id ?? []) {
-      params.append("id", id);
-    }
-    for (const partNumber of query.partNumber ?? []) {
-      params.append("partNumber", partNumber);
-    }
-    for (const facet of query.facets ?? []) {
-      params.append("facet", facet);
-    }
-    const url = `${this.baseUrl}/products?${params.toString()}`;
-    const response = await fetch(url, {
+  /** Base URL for the Query Service (catalog / search). */
+  catalogBaseUrl;
+  /** Base URL for the Transaction Service (WCS REST). */
+  transactionBaseUrl;
+  async callGet(url, params, opts) {
+    const merged = this.buildParams(params);
+    const query = merged.toString() ? `?${merged.toString()}` : "";
+    const response = await fetch(`${url}${query}`, {
       method: "GET",
-      headers: { Accept: "application/json" }
+      headers: this.buildHeaders()
     });
+    if (opts?.allowUndefined && response.status === 404)
+      return void 0;
     if (!response.ok) {
       throw new Error(
-        `HCL API error ${response.status} ${response.statusText} for URL: ${url}`
+        `HCL GET ${url} error ${response.status} ${response.statusText}`
       );
     }
     return response.json();
   }
-  /**
-   * Resolve a URL slug to an HCL token (product partNumber, category ID, etc.).
-   * Calls GET /api/v2/urls?storeId=X&identifier=<slug>
-   * Returns undefined when the slug is not found (404).
-   */
-  async resolveSlug(slug, langId) {
-    const params = new URLSearchParams();
-    params.set("storeId", this.config.storeId);
-    params.append("identifier", slug);
-    if (langId)
-      params.set("langId", langId);
-    const url = `${this.baseUrl}/urls?${params.toString()}`;
+  async callPost(url, body = {}) {
     const response = await fetch(url, {
-      method: "GET",
-      headers: { Accept: "application/json" }
+      method: "POST",
+      headers: { ...this.buildHeaders(), "Content-Type": "application/json" },
+      body: JSON.stringify(body)
     });
-    if (response.status === 404)
-      return void 0;
     if (!response.ok) {
+      const text = await response.text();
       throw new Error(
-        `HCL URL resolve error ${response.status} ${response.statusText} for URL: ${url}`
+        `HCL POST ${url} error ${response.status} ${response.statusText}: ${text}`
       );
     }
-    const data = await response.json();
-    return data.contents?.[0];
+    return response.json();
   }
-  /**
-   * Query categories from the HCL Commerce Query Service.
-   * Calls GET /api/v2/categories with the given query parameters.
-   */
-  async findCategories(query) {
-    const params = new URLSearchParams();
-    params.set("storeId", query.storeId ?? this.config.storeId);
-    const catalogId = query.catalogId ?? this.config.catalogId;
-    if (catalogId)
-      params.set("catalogId", catalogId);
-    if (query.langId)
-      params.set("langId", query.langId);
-    if (query.parentCategoryId)
-      params.set("parentCategoryId", query.parentCategoryId);
-    if (query.depthAndLimit)
-      params.set("depthAndLimit", query.depthAndLimit);
-    if (query.profileName)
-      params.set("profileName", query.profileName);
-    for (const id of query.id ?? []) {
-      params.append("id", id);
-    }
-    for (const identifier of query.identifier ?? []) {
-      params.append("identifier", identifier);
-    }
-    const url = `${this.baseUrl}/categories?${params.toString()}`;
+  async callPut(url, body) {
     const response = await fetch(url, {
-      method: "GET",
-      headers: { Accept: "application/json" }
+      method: "PUT",
+      headers: { ...this.buildHeaders(), "Content-Type": "application/json" },
+      body: JSON.stringify(body)
     });
     if (!response.ok) {
+      const text = await response.text();
       throw new Error(
-        `HCL API error ${response.status} ${response.statusText} for URL: ${url}`
+        `HCL PUT ${url} error ${response.status} ${response.statusText}: ${text}`
       );
     }
     return response.json();
   }
+  async callDelete(url, opts) {
+    const response = await fetch(url, {
+      method: "DELETE",
+      headers: this.buildHeaders()
+    });
+    if (!response.ok && !(opts?.ignore404 && response.status === 404)) {
+      throw new Error(
+        `HCL DELETE ${url} error ${response.status} ${response.statusText}`
+      );
+    }
+  }
+  /**
+   * Merges caller-supplied params with locale defaults (langId, currency)
+   * derived from the request context. Caller-supplied values always win.
+   */
+  buildParams(params) {
+    const merged = new URLSearchParams(params);
+    const { langId, currency } = getLocaleParams(this.config, this.context);
+    if (langId && !merged.has("langId"))
+      merged.set("langId", langId);
+    if (currency && !merged.has("currency"))
+      merged.set("currency", currency);
+    return merged;
+  }
+  buildHeaders() {
+    const headers = { Accept: "application/json" };
+    const token = this.context.session[SESSION_KEY_WC_TOKEN];
+    const trustedToken = this.context.session[SESSION_KEY_WC_TRUSTED_TOKEN];
+    const personalizationId = this.context.session[SESSION_KEY_PERSONALIZATION_ID];
+    if (token)
+      headers["WCToken"] = token;
+    if (trustedToken)
+      headers["WCTrustedToken"] = trustedToken;
+    if (personalizationId)
+      headers["WCPersonalization"] = personalizationId;
+    return headers;
+  }
 }
 export {
+  HclCartNotFoundError,
   HclClient
 };