@evenicanpm/storefront-core 1.0.1 → 1.0.3

package/src/api-manager/datasources/e4/{e4-order.datasource.ts → order/e4-order.datasource.ts}

@@ -3,10 +3,10 @@ import {
   GetSalesOrderDetailsInput,
   SalesOrder,
 } from "@/api-manager/schemas/order.schema";
-import getGraphqlClient from "../../lib/get-graphql-client";
-import { orderDetailsMap, orderMap } from "./e4.remaps";
+import getGraphqlClient from "../../../lib/get-graphql-client";
+import { orderDetailsMap, orderMap } from "./e4-order.remaps";
 import { merge } from "object-mapper";
-import { OrderApi } from "../../types/Datasource";
+import { OrderApi } from "../../../types/Datasource";
 
 const order: OrderApi = {
   async getSalesOrders(input: SalesOrderInput): Promise<SalesOrder[]> {

package/src/api-manager/datasources/e4/order/e4-order.remaps.ts

@@ -0,0 +1,101 @@
+/**
+ * Maps E4 API responses to the D365 data structure.
+ *
+ * This file uses the `object-mapper` library to transform
+ * API responses into a format compatible with D365.
+ *
+ * https://github.com/wankdanker/node-object-mapper
+ *
+ */
+import { merge } from "object-mapper";
+import { Address } from "@msdyn365-commerce/retail-proxy";
+import {
+  Image,
+  OrderLine,
+  SelectedDimension,
+  Address as E4Address,
+} from "../graphqlRequestSdk";
+import { addressMap } from "../address/e4-address.remaps";
+
+const STATUSES = ["Open", "Processing", "Complete", "On Hold", "Cancelled"];
+
+export const orderMap = {
+  id: "Id",
+  orderNumber: "ChannelReferenceId",
+  orderStatus: {
+    key: "StatusValue",
+    transform: (orderStatus: string) => {
+      return STATUSES.indexOf(orderStatus) + 1;
+    },
+  },
+  orderDate: "TransactionDate",
+  freightTotal: "ShippingChargeAmount",
+  promotionTotal: "DiscountAmount",
+  subTotal: "SubtotalAmount",
+  taxTotal: "TaxAmount",
+  itemCount: "NumberOfItems",
+  total: "TotalAmount",
+};
+
+const salesLinesProduct = {
+  productId: "RecordId",
+  productCode: "ItemId",
+  productName: "Name",
+  amount: "TotalAmount",
+  img: {
+    key: "PrimaryImageUrl",
+    transform: (img: Image[]) => {
+      if (Array.isArray(img) && img.length > 0) {
+        return img[0].cdnURL ?? null;
+      }
+      return null;
+    },
+  },
+  selectedDimensions: {
+    key: "Dimensions",
+    transform: (dimensions: SelectedDimension[]) => {
+      if (!(dimensions && dimensions.length)) return [];
+
+      const typeMap: Record<string, number> = {
+        Color: 1,
+        Size: 3,
+        // extend as needed
+        // map to import { ProductDimensionType } from "@msdyn365-commerce/retail-proxy";
+      };
+
+      return dimensions.map((d) => ({
+        DimensionTypeValue: typeMap[d.name ?? ""] ?? 0,
+        DimensionValue: {
+          RecordId: Number(d.id),
+          Value: d.value,
+          DimensionId: d.name,
+        },
+      }));
+    },
+  },
+};
+
+export const orderDetailsMap = {
+  ...orderMap,
+  lines: {
+    key: "SalesLines",
+    transform: (lines: OrderLine[]) => {
+      if (!(lines && lines.length)) return [];
+      return lines.map((line) => {
+        return {
+          Product: merge(line, salesLinesProduct),
+          Price: line?.price,
+          Quantity: line?.quantity,
+        };
+      });
+    },
+  },
+  addresses: {
+    key: "ShippingAddress",
+    transform: (addresses: E4Address[]) => {
+      if (addresses.length === 0) return undefined;
+      const translated = merge(addresses, addressMap) as Address[];
+      return translated[addresses.length - 1];
+    },
+  },
+};

package/src/api-manager/datasources/e4/{e4-organization.datasource.ts → organization/e4-organization.datasource.ts}

@@ -1,5 +1,5 @@
 /* eslint-disable */
-import { OrganizationApi } from "../../types/Datasource";
+import { OrganizationApi } from "../../../types/Datasource";
 import { ChannelConfiguration } from "@/api-manager/schemas/organization.schema";
 
 // Todo: implement these stubs

package/src/api-manager/datasources/e4/{e4-product.datasource.ts → product/e4-product.datasource.ts}

@@ -8,10 +8,10 @@ import {
   Product,
   ProductLookupType,
   CategoriesQuery,
-} from "./graphqlRequestSdk";
-import * as translator from "./e4.translator";
-import getGraphqlClient from "../../lib/get-graphql-client";
-import { ProductApi } from "../../types/Datasource";
+} from "../graphqlRequestSdk";
+import * as productTranslator from "./e4-product.translator";
+import getGraphqlClient from "../../../lib/get-graphql-client";
+import { ProductApi } from "../../../types/Datasource";
 // See TODO below
 //import { generateCategoryFilterString } from "./e4.translator";
 
@@ -31,7 +31,7 @@ const product: ProductApi = {
       throw new Error("Error getting product");
     }
 
-    const transformedData = translator.productTransformValidate(
+    const transformedData = productTranslator.productTransformValidate(
       data.product as Product,
     );
     return transformedData;
@@ -50,7 +50,7 @@ const product: ProductApi = {
     }
     return (
       data?.getProductsByIds?.map((productData) =>
-        translator.productTransformValidate(productData as Product),
+        productTranslator.productTransformValidate(productData as Product),
       ) || []
     );
   },
@@ -76,7 +76,9 @@ const product: ProductApi = {
     const products = data?.productsTypeAhead
       ?.map((product) => {
         const transformedProduct =
-          translator.productWithCategoryTransformValidate(product as Product);
+          productTranslator.productWithCategoryTransformValidate(
+            product as Product,
+          );
 
         // Ensure Price is always a number (not undefined)
         if (transformedProduct) {
@@ -98,7 +100,7 @@ const product: ProductApi = {
     const e4Api = await getGraphqlClient();
 
     const { data, errors } = await e4Api.e4ProductListMD(
-      await translator.productListInputTransform(input),
+      await productTranslator.productListInputTransform(input),
     );
     if (errors) {
       throw new Error("Error getting products");
@@ -111,10 +113,10 @@ const product: ProductApi = {
       (filter): filter is Attribute => filter !== null,
     );
     const transformedProducts = rawProducts.map((prod) =>
-      translator.productTransformValidate(prod),
+      productTranslator.productTransformValidate(prod),
     );
     const transformedRefiners =
-      translator.refinersTransformValidate(rawFilters);
+      productTranslator.refinersTransformValidate(rawFilters);
 
     return {
       products: transformedProducts,
@@ -167,7 +169,7 @@ const product: ProductApi = {
       throw new Error("Error getting products");
     }
 
-    const translatedData = translator.productPricesTransformValidate(
+    const translatedData = productTranslator.productPricesTransformValidate(
       data?.getProductsByIds as Product[],
     );
     return translatedData;

package/src/api-manager/datasources/e4/product/e4-product.remaps.ts

@@ -0,0 +1,88 @@
+/**
+ * Maps E4 API responses to the D365 data structure.
+ *
+ * This file uses the `object-mapper` library to transform
+ * API responses into a format compatible with D365.
+ *
+ * https://github.com/wankdanker/node-object-mapper
+ *
+ */
+import { Image } from "../graphqlRequestSdk";
+import unwrapE4Variants from "../utils/unwrap-e4-variants";
+
+/* PRODUCT REMAPS */
+export const dimensionMap = {
+  AttributeId: "DimensionTypeValue",
+  Value: "DimensionValue.Value",
+  ValueId: "DimensionValue.RecordId",
+  _: {
+    key: "TotalAvailableInventoryLevelCode",
+    default: "AVAIL",
+  },
+};
+
+export const productMap = {
+  sku: "ItemId",
+  name: "Name",
+  MasterProductId: "MasterProductId",
+  price: [
+    { key: "Price", default: 0 },
+    { key: "BasePrice", default: 0 },
+    { key: "AdjustedPrice", default: 0 },
+  ],
+  id: [
+    {
+      key: "RecordId",
+      transform: (id: string) => {
+        if (id !== null) return parseInt(id);
+      },
+    },
+  ],
+  img: {
+    key: "PrimaryImageUrl",
+    transform: (img: Image[]) => {
+      if (Array.isArray(img) && img.length > 0) {
+        return img[0].cdnURL ?? null;
+      }
+      return null;
+    },
+  },
+};
+
+export const productPricesMap = {
+  id: [
+    {
+      key: "ProductId",
+      transform: (id: string) => {
+        if (id !== null) return parseInt(id);
+      },
+    },
+    {
+      key: "ListingId",
+      transform: (id: string) => {
+        if (id !== null) return parseInt(id);
+      },
+    },
+  ],
+  price: [
+    { key: "Price", default: 0 },
+    { key: "BasePrice", default: 0 },
+    { key: "AdjustedPrice", default: 0 },
+    { key: "CustomerContextualPrice", default: 0 },
+  ],
+  sku: "ItemId",
+};
+
+export const productDetailsMap = {
+  ...productMap,
+  MasterProductId: "MasterProductId",
+  "img[].cdnURL": "Images[]",
+  description: "Description",
+  "Dimensions[].AttributeId": "Dimensions[].DimensionTypeValue",
+  Variants: {
+    key: "DimensionValues",
+    transform: unwrapE4Variants,
+  },
+  "attributes[].Name": "Attributes[].Name",
+  "attributes[].Value": "Attributes[].TextValue",
+};

package/src/api-manager/datasources/e4/{e4.translator.ts → product/e4-product.translator.ts}

@@ -1,45 +1,26 @@
-// Schemas
-import { extendedCartSchema, Cart } from "@/api-manager/schemas/cart.schema";
+import getGraphqlClient from "../../../lib/get-graphql-client";
 import {
   productSchema,
   ProductDetails,
   SearchByCriteriaInput,
   ProductPrice,
 } from "@/api-manager/schemas/product.schema";
-import { Address } from "@/api-manager/schemas/address.schema";
-import { User } from "@/api-manager/schemas/user.schema";
-import { Session } from "@/api-manager/schemas/session.schema";
-import { merge } from "object-mapper";
-import getGraphqlClient from "../../lib/get-graphql-client";
-// Interfaces
-import {
-  UserInput,
-  AddressInput,
-  Attribute,
-  Category as E4Category,
-  Country,
-  Shipping,
-  Cart as E4Cart,
-  Product,
-  Session as E4Session,
-} from "./graphqlRequestSdk";
+import { productPriceSchema } from "@/api-manager/schemas/d365.schema";
 import {
-  Category,
   ProductRefinerValue,
   ProductSearchResult,
 } from "@msdyn365-commerce/retail-proxy";
 import {
-  cartMap,
+  Attribute,
+  Category as E4Category,
+  Product,
+} from "../graphqlRequestSdk";
+import { merge } from "object-mapper";
+import {
   productDetailsMap,
   productMap,
   productPricesMap,
-  addressReverseMap,
-  countriesMap,
-  countryMap,
-  deliveryOptionsMap,
-} from "./e4.remaps";
-import { CategoryHierarchy } from "@/lib/category-helpers";
-import { productPriceSchema } from "@/api-manager/schemas/d365.schema";
+} from "./e4-product.remaps";
 
 interface TransformedRefinerValue {
   RefinerRecordId: number;
@@ -302,25 +283,6 @@ export const refinersTransformValidate = (
  * required fields, create a custom schema with only frontend required fields
  */
 
-/**
- * Transforms the E4 AddToCart response to a Cart retail-proxy object
- * Add parameters to transform model as needed
- *
- * @param data the E4 Cart object
- * @returns the transformed cart object
- */
-export const cartTransformValidate = (cart: E4Cart): Cart => {
-  if (!(cart && cart?.id)) throw new Error("Not a valid cart");
-  const transformedData = merge(cart, cartMap);
-  try {
-    extendedCartSchema.parse(transformedData);
-  } catch (e) {
-    console.warn("Cart data does not match retail-proxy schema", e);
-  }
-
-  return transformedData as Cart;
-};
-
 /**
  * Transforms the E4 Product response to a Product retail-proxy object
  * @param productData the E4 Product object
@@ -382,285 +344,3 @@ export const productWithCategoryTransformValidate = (
 
   return productTransform;
 };
-
-export const userTransformInput = (user: User): UserInput => {
-  let formattedUser = {};
-
-  if (user.FirstName && user.LastName) {
-    formattedUser = {
-      firstName: user?.FirstName,
-      lastName: user?.LastName,
-    };
-  }
-
-  if (user?.DefaultShippingAddressId) {
-    const shippingInfo = {
-      defaultShippingAddressId: user?.DefaultShippingAddressId,
-    };
-    formattedUser = { ...formattedUser, ...shippingInfo };
-  }
-
-  return formattedUser;
-};
-
-/**
- * Transforms the e4 API session data to Session schema.
- */
-export const sessionTransformValidate = (data: E4Session): Session => {
-  const formattedSession: Session = {
-    Id: data?.id,
-    User: {
-      AccountNumber: data?.user?.accountId ?? "",
-      FirstName: data?.user?.firstName ?? "",
-      LastName: data?.user?.lastName ?? "",
-      Email: data?.user?.email ?? "",
-      // Add other required fields with defaults if needed
-    },
-  };
-  return formattedSession;
-};
-
-/**
- * Transforms the Address schema to e4 API address
- */
-export const addressTransform = async (address: Address) => {
-  const countryId = await getCountryId(address?.ThreeLetterISORegionName ?? "");
-  const stateId = await getStateId(address?.State ?? "", countryId ?? "");
-
-  const formattedAddress: AddressInput = merge(address, addressReverseMap);
-  formattedAddress.firstName = "";
-  formattedAddress.lastName = "";
-  formattedAddress.address2 = "";
-  formattedAddress.stateId = stateId;
-  formattedAddress.countryId = countryId;
-  formattedAddress.addressTypeId = 1; // We only create and update shipping addresses.
-
-  return formattedAddress;
-};
-
-export const countriesTransformValidate = (countries: Country[]) => {
-  if (Array.isArray(countries) && countries.length) {
-    return countries.map((country) => merge(country, countriesMap));
-  }
-  return [];
-};
-
-export const countryTransformValidate = (country: Country) => {
-  if (country?.state && country?.state.length) {
-    return merge(country, countryMap);
-  }
-  return [];
-};
-
-const countriesCache = new Map<string, Country[]>();
-const countryCache = new Map<string, Country>();
-
-/**
- * For d365 country id and value are 'USA' but for e4 it is '80175021088166' and 'USA'.
- * So use countryId, to map the codes back to ids before API calls.
- */
-export const getCountryId = async (code: string) => {
-  const cacheKey = "countries";
-  let countries: Country[] = [];
-
-  if (countriesCache.has(cacheKey)) {
-    countries = countriesCache.get(cacheKey) ?? countries;
-  } else {
-    const e4Api = await getGraphqlClient();
-    const { data } = await e4Api.e4CountryList();
-    countriesCache.set(cacheKey, data?.countries as Country[]);
-    countries = data?.countries as Country[];
-  }
-  const country = countries.find(
-    (c: { isoAlpha3Code: string }) => c?.isoAlpha3Code === code,
-  );
-
-  return country?.id;
-};
-
-const getStateId = async (stateCode: string, countryId: string) => {
-  const cacheKey = `states-${countryId}`;
-  let country: Country = {
-    id: "",
-    isoAlpha2Code: "",
-    isoAlpha3Code: "",
-    name: "",
-  };
-
-  if (countryCache.has(cacheKey)) {
-    country = countryCache.get(cacheKey) ?? country;
-  } else {
-    const e4Api = await getGraphqlClient();
-    const { data } = await e4Api.e4Country({ id: countryId });
-    country = data?.country as Country;
-    countryCache.set(cacheKey, country);
-  }
-
-  const state = country?.state?.find((s) => s?.code === stateCode);
-
-  return state?.id;
-};
-
-export const deliveryOptionsTransformValidate = (options: Shipping[]) => {
-  if (Array.isArray(options) && options.length) {
-    return options.map((option) => merge(option, deliveryOptionsMap));
-  }
-  return [];
-};
-
-interface TransformedCategoryNode extends Category {
-  Slug: string;
-  Url: string;
-  NeutralizedName: string;
-  Children?: TransformedCategoryNode[];
-  ParentCategory?: number;
-}
-
-export const categoryTransformValidate = (
-  rawCategories: E4Category[],
-  rootParentId = 1,
-  urlPrefix = "e4",
-): CategoryHierarchy[] => {
-  function generateSlug(name: string): string {
-    if (!name) return "";
-    return name
-      .toLowerCase()
-      .replace(/\s+/g, "-")
-      .replace(/[^\w-]+/g, "")
-      .replace(/--+/g, "-")
-      .replace(/^-+/, "")
-      .replace(/-+$/, "");
-  }
-
-  function createTransformedNode(
-    rawCategory: E4Category,
-  ): TransformedCategoryNode | null {
-    let recordIdNum: number;
-    try {
-      recordIdNum = parseInt(String(rawCategory.id), 10);
-      if (isNaN(recordIdNum)) throw new Error("Invalid RecordId");
-    } catch (e) {
-      console.warn(`Skipping category due to invalid id:`, rawCategory);
-      return null;
-    }
-
-    const categoryName = rawCategory.name || "Unnamed Category";
-    const slug = generateSlug(categoryName);
-    let parentIdNum: number | undefined = undefined;
-    if (rawCategory.parentId != null) {
-      const parsedParentId = parseInt(String(rawCategory.parentId), 10);
-      if (!isNaN(parsedParentId)) parentIdNum = parsedParentId;
-      else
-        console.warn(
-          `Invalid parentId format for id ${recordIdNum}:`,
-          rawCategory.parentId,
-        );
-    }
-
-    const node: TransformedCategoryNode = {
-      RecordId: recordIdNum,
-      Name: categoryName,
-      ParentCategory: parentIdNum,
-      DisplayOrder: 0,
-      LocalizedDescription: categoryName,
-      Images: [
-        {
-          Uri: `Categories/${categoryName}.png`,
-          IsDefault: false,
-          IsSelfHosted: false,
-          Priority: 0,
-          IsAdditionalMedia: false,
-          MediaTypeValue: 0,
-          DisplayOrder: 0,
-          IsApplicableForChildEntities: false,
-          ExtensionProperties: [],
-        },
-      ],
-      NameTranslations: [
-        { Language: "en-us", Text: categoryName, ExtensionProperties: [] },
-      ],
-      ExtensionProperties: [],
-      NeutralizedName: categoryName,
-      Slug: slug,
-      Url: "",
-      Children: [],
-    };
-    return node;
-  }
-
-  function calculateUrls(
-    categoryNode: TransformedCategoryNode,
-    basePath: string,
-    prefix: string,
-  ): void {
-    const currentPath = basePath
-      ? `${basePath}/${categoryNode.Slug}`
-      : `${prefix}/${categoryNode.Slug}`;
-    categoryNode.Url = `${currentPath}/${categoryNode.RecordId}`;
-    // Check if Children exists before iterating
-    if (categoryNode?.Children && categoryNode?.Children?.length > 0) {
-      categoryNode.Children.forEach((child: TransformedCategoryNode) =>
-        calculateUrls(child, currentPath, prefix),
-      );
-    }
-  }
-
-  function removeEmptyChildren(node: TransformedCategoryNode): void {
-    if (node.Children) {
-      if (node.Children.length === 0) {
-        delete node.Children;
-      } else {
-        node.Children.forEach(removeEmptyChildren);
-      }
-    }
-  }
-
-  if (!rawCategories || !Array.isArray(rawCategories)) {
-    console.error(
-      "Invalid input received by categoryTransformValidate: must be an array.",
-      rawCategories,
-    );
-    return [];
-  }
-
-  const categoryMap = new Map<number, TransformedCategoryNode>();
-  const rootNodes: TransformedCategoryNode[] = [];
-
-  rawCategories.forEach((rawCat: E4Category) => {
-    const transformedNode = createTransformedNode(rawCat);
-    if (transformedNode)
-      categoryMap.set(transformedNode.RecordId, transformedNode);
-  });
-
-  categoryMap.forEach((node: TransformedCategoryNode) => {
-    const parentId = node.ParentCategory;
-    if (parentId === rootParentId) rootNodes.push(node);
-    else if (parentId !== undefined && categoryMap.has(parentId)) {
-      const parentNode = categoryMap.get(parentId);
-      if (parentNode) {
-        if (!parentNode.Children) {
-          parentNode.Children = [];
-        }
-        parentNode.Children.push(node);
-        parentNode.Children.sort(
-          (a, b) =>
-            (a.DisplayOrder ?? 0) - (b.DisplayOrder ?? 0) ||
-            (a.Name ?? "").localeCompare(b.Name ?? ""),
-        );
-      }
-    }
-  });
-
-  rootNodes.forEach((rootNode: TransformedCategoryNode) =>
-    calculateUrls(rootNode, "", urlPrefix),
-  );
-  rootNodes.sort(
-    (a, b) =>
-      (a.DisplayOrder ?? 0) - (b.DisplayOrder ?? 0) ||
-      (a.Name ?? "").localeCompare(b.Name ?? ""),
-  );
-
-  rootNodes.forEach(removeEmptyChildren);
-
-  return rootNodes as CategoryHierarchy[];
-};

package/src/api-manager/datasources/e4/{e4-session.datasource.ts → session/e4-session.datasource.ts}

@@ -1,9 +1,9 @@
-import getGraphqlClient from "../../lib/get-graphql-client";
+import getGraphqlClient from "../../../lib/get-graphql-client";
 import {
   Session,
   SessionInitInput,
 } from "@/api-manager/schemas/session.schema";
-import * as translator from "./e4.translator";
+import * as sessionTranslator from "./e4-session.translator";
 
 const session = {
   async sessionInit(input: SessionInitInput): Promise<Session> {
@@ -19,7 +19,7 @@ const session = {
       throw new Error("Error adding user to e4 session");
     }
 
-    return translator.sessionTransformValidate(
+    return sessionTranslator.sessionTransformValidate(
       data?.customerInitSession ?? { id: "" },
     );
   },

package/src/api-manager/datasources/e4/session/e4-session.translator.ts

@@ -0,0 +1,18 @@
+import { Session } from "@/api-manager/schemas/session.schema";
+import { Session as E4Session } from "../graphqlRequestSdk";
+/**
+ * Transforms the e4 API session data to Session schema.
+ */
+export const sessionTransformValidate = (data: E4Session): Session => {
+  const formattedSession: Session = {
+    Id: data?.id,
+    User: {
+      AccountNumber: data?.user?.accountId ?? "",
+      FirstName: data?.user?.firstName ?? "",
+      LastName: data?.user?.lastName ?? "",
+      Email: data?.user?.email ?? "",
+      // Add other required fields with defaults if needed
+    },
+  };
+  return formattedSession;
+};