@adobe-commerce/elsie 1.2.2-alpha1 → 1.3.0-alpha02

package/config/vite.mjs

@@ -25,18 +25,11 @@ import banner from 'vite-plugin-banner';
 const env = loadEnv('', process.cwd());
 
 // Load Elsie Config
-const elsieConfig = await import(
-  path.resolve(process.cwd(), './.elsie.js')
-).then((m) => m.default);
-
-const packageJSON = await import(
-  path.resolve(process.cwd(), './package.json'),
-  {
-    assert: {
-      type: 'json',
-    },
-  }
-).then((m) => m.default);
+const elsieConfig = await import(path.resolve(process.cwd(), './.elsie.js')).then((m) => m.default);
+
+// Read package.json using createRequire (compatible with Node 20 and 22)
+const require = createRequire(import.meta.url);
+const packageJSON = require(path.resolve(process.cwd(), './package.json'));
 
 // Paths
 const paths = {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@adobe-commerce/elsie",
-  "version": "1.2.2-alpha1",
+  "version": "1.3.0-alpha02",
   "license": "SEE LICENSE IN LICENSE.md",
   "description": "Domain Package SDK",
   "engines": {

package/src/docs/Utilities/getCookie.mdx

@@ -0,0 +1,29 @@
+import { Meta, Unstyled } from '@storybook/blocks';
+
+<Meta title="Utilities/getCookie" />
+<Unstyled>
+
+# getCookie(cookieName)
+
+This function takes in a cookie name and returns the value of the cookie.
+
+## Params
+
+`cookieName`
+: The name of the cookie to get
+
+## Returns
+
+Returns the value of the cookie.
+
+## Examples
+
+```ts
+import { getCookie } from '@adobe-commerce/elsie/lib';
+
+const result = getCookie('foo');
+
+console.log(result); // "bar"
+```
+
+</Unstyled>

package/src/docs/Utilities/getPathValue.mdx

@@ -0,0 +1,38 @@
+import { Meta, Unstyled } from '@storybook/blocks';
+
+<Meta title="Utilities/getPathValue" />
+<Unstyled>
+
+# getPathValue(obj, key)
+
+This function takes in an object and a key and returns the value of the key.
+
+## Params
+
+`obj`
+: The object to get the value from
+
+`key`
+: The key to get the value from (supports dot notation)
+
+## Returns
+
+Returns the value of the key.
+
+## Examples
+
+```ts
+import { getPathValue } from '@adobe-commerce/elsie/lib';
+
+const obj = {
+  foo: {
+    bar: 'baz',
+  },
+};
+
+const result = getPathValue(obj, 'foo.bar');
+
+console.log(result); // "baz"
+```
+
+</Unstyled>

package/src/lib/aem/configs.ts

@@ -0,0 +1,161 @@
+import { deepmerge } from '../deepmerge';
+import { getPathValue } from '../get-path-value';
+
+interface ConfigHeaders {
+  all?: Record<string, string>;
+  [key: string]: Record<string, string> | undefined;
+}
+
+interface ConfigPublic {
+  default: ConfigRoot;
+  [key: string]: ConfigRoot;
+}
+
+interface ConfigRoot {
+  headers?: ConfigHeaders;
+  [key: string]: any;
+}
+
+interface Config {
+  public: ConfigPublic;
+  [key: string]: any;
+}
+
+// Private state
+let config: Config | null = null;
+let rootPath: string | null = null;
+let rootConfig: ConfigRoot | null = null;
+
+/**
+ * Reset the config state
+ */
+function resetConfig() {
+  config = null;
+  rootPath = null;
+  rootConfig = null;
+}
+
+/**
+ * Get root path
+ * @param {Object} [configObj=config] - The config object.
+ * @returns {string} - The root path.
+ */
+function getRootPath(configObj: Config | null = config): string {
+  if (!configObj) {
+    console.warn('No config found. Please call initializeConfig() first.');
+    return '/';
+  }
+
+  const value = Object.keys(configObj?.public)
+    // Sort by number of non-empty segments to find the deepest path
+    .sort((a, b) => {
+      const aSegments = a.split('/').filter(Boolean).length;
+      const bSegments = b.split('/').filter(Boolean).length;
+      return bSegments - aSegments;
+    })
+    .find(
+      (key) =>
+        window.location.pathname === key ||
+        window.location.pathname.startsWith(key)
+    );
+
+  return value ?? '/';
+}
+
+/**
+ * Get list of root paths from public config
+ * @returns {Array} - The list of root paths.
+ */
+function getListOfRootPaths(): string[] {
+  if (!config) {
+    console.warn('No config found. Please call initializeConfig() first.');
+    return [];
+  }
+
+  return Object.keys(config.public).filter((root) => root !== 'default');
+}
+
+/**
+ * Checks if the public config contains more than "default"
+ * @returns {boolean} - true if public config contains more than "default"
+ */
+function isMultistore(): boolean {
+  return getListOfRootPaths().length >= 1;
+}
+
+/**
+ * Retrieves headers from config entries like commerce.headers.pdp.my-header, etc and
+ * returns as object of all headers like { my-header: value, ... }
+ * @param {string} scope - The scope of the headers to retrieve.
+ * @returns {Object} - The headers.
+ */
+function getHeaders(scope: string): Record<string, string> {
+  if (!rootConfig) {
+    throw new Error(
+      'Configuration not initialized. Call initializeConfig() first.'
+    );
+  }
+  const headers = rootConfig.headers ?? {};
+  return {
+    ...(headers.all ?? {}),
+    ...(headers[scope] ?? {}),
+  };
+}
+
+/**
+ * Applies config overrides from metadata.
+ *
+ * @param {Object} [configObj] - The base config.
+ * @param {string} [root] - The root path.
+ * @returns {Object} - The config with overrides applied.
+ */
+function applyConfigOverrides(
+  configObj: Config | null,
+  root: string | null
+): ConfigRoot {
+  const defaultConfig = configObj!.public?.default;
+
+  if (root === '/' || !configObj!.public[root as keyof ConfigPublic])
+    return defaultConfig;
+
+  return deepmerge(
+    defaultConfig,
+    configObj!.public[root as keyof ConfigPublic]
+  );
+}
+
+/**
+ * Initializes the configuration system.
+ * @returns {Object} The initialized root configuration
+ */
+function initializeConfig(configObj: Config): ConfigRoot {
+  config = configObj;
+  rootPath = getRootPath(config);
+  rootConfig = applyConfigOverrides(config, rootPath);
+  return rootConfig;
+}
+
+/**
+ * Retrieves a configuration value.
+ *
+ * @param {string} configParam - The configuration parameter to retrieve.
+ * @returns {string|undefined} - The value of the configuration parameter, or undefined.
+ */
+function getConfigValue(configParam: string): any {
+  if (!rootConfig) {
+    throw new Error(
+      'Configuration not initialized. Call initializeConfig() first.'
+    );
+  }
+  return getPathValue(rootConfig, configParam);
+}
+
+export {
+  initializeConfig,
+  getRootPath,
+  getListOfRootPaths,
+  isMultistore,
+  getConfigValue,
+  getHeaders,
+  resetConfig,
+};

package/src/lib/get-cookie.ts

@@ -0,0 +1,18 @@
+/**
+ * Get cookie
+ * @param {string} cookieName - The name of the cookie to get
+ * @returns {string} - The value of the cookie
+ */
+export function getCookie(cookieName: string): string | undefined {
+  const cookies = document.cookie.split(';');
+  let foundValue;
+
+  cookies.forEach((cookie) => {
+    const [name, value] = cookie.trim().split('=');
+    if (name === cookieName) {
+      foundValue = decodeURIComponent(value);
+    }
+  });
+
+  return foundValue;
+}

package/src/lib/get-path-value.ts

@@ -0,0 +1,22 @@
+/**
+ * Retrieves a value from a config object using dot notation.
+ *
+ * @param {Object} obj - The config object.
+ * @param {string} key - The key to retrieve (supports dot notation).
+ * @returns {any} - The value of the key.
+ */
+export function getPathValue(obj: Record<string, any>, key: string): any {
+  try {
+    return key
+      .split('.')
+      .reduce((current: Record<string, any>, part: string) => {
+        if (!Object.prototype.hasOwnProperty.call(current, part)) {
+          throw Error();
+        }
+        return current[part];
+      }, obj);
+  } catch {
+    console.warn(`Property ${key} does not exist in the object`);
+    return undefined;
+  }
+}