@salesforce/pwa-kit-react-sdk 3.8.0-preview.0-basepath → 3.8.0-preview.0

package/ssr/universal/utils.client.test.js

@@ -0,0 +1,46 @@
+"use strict";
+
+var utils = _interopRequireWildcard(require("./utils"));
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+describe('getProxyConfigs (client-side)', () => {
+  const configs = [{
+    foo: 'bar'
+  }];
+  beforeEach(() => {
+    global.Progressive = {
+      ssrOptions: {
+        proxyConfigs: configs
+      }
+    };
+  });
+  afterEach(() => {
+    delete global.Progressive;
+  });
+  test('should return proxy configs set on window.Progressive', () => {
+    expect(utils.getProxyConfigs()).toEqual(configs);
+  });
+});
+describe('getAssetUrl (client-side)', () => {
+  beforeEach(() => {
+    global.Progressive = {
+      buildOrigin: 'test.com'
+    };
+  });
+  afterEach(() => {
+    delete global.Progressive;
+  });
+  test('should return build origin when path is undefined', () => {
+    expect(utils.getAssetUrl()).toBe('test.com');
+  });
+  test('should return origin + path', () => {
+    expect(utils.getAssetUrl('/path')).toBe('test.com/path');
+  });
+});

package/ssr/universal/utils.js

@@ -0,0 +1,61 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getProxyConfigs = exports.getAssetUrl = void 0;
+var _ssrShared = require("@salesforce/pwa-kit-runtime/utils/ssr-shared");
+var _ssrNamespacePaths = require("@salesforce/pwa-kit-runtime/utils/ssr-namespace-paths");
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */ /**
+ * @module progressive-web-sdk/ssr/universal/utils
+ */
+const onClient = typeof window !== 'undefined';
+
+/**
+ * Get the URL that should be used to load an asset from the bundle.
+ *
+ * @param {string} path - relative path from the build directory to the asset
+ * @function
+ * @returns {string}
+ */
+const getAssetUrl = path => {
+  /* istanbul ignore next */
+  const publicPath = onClient ? `${window.Progressive.buildOrigin}` : `${_ssrNamespacePaths.bundleBasePath}/${process.env.BUNDLE_ID || 'development'}/`;
+  return path ? `${publicPath}${path}` : publicPath;
+};
+
+/**
+ * @typedef {Object} ProxyConfig
+ * @property {String} protocol - http or https
+ * @property {String} host - the hostname
+ * @property {String} path - the path element that follows "mobify/proxy"
+ */
+
+/**
+ * Return the set of proxies configured for the app.
+ *
+ * The result is an array of objects, each of which has 'protocol'
+ * (either 'http' or 'https'), 'host' (the hostname) and 'path' (the
+ * path element that follows "/mobify/proxy/", defaulting to 'base' for
+ * the first proxy, and 'base2' for the next).
+ *
+ * @function
+ * @returns {Array<ProxyConfig>}
+ */
+exports.getAssetUrl = getAssetUrl;
+const getProxyConfigs = () => {
+  const configs = onClient ? (window.Progressive.ssrOptions || {}).proxyConfigs || [] : _ssrShared.proxyConfigs;
+
+  // Clone to avoid accidental mutation of important configuration variables.
+  return configs.map(config => _objectSpread({}, config));
+};
+exports.getProxyConfigs = getProxyConfigs;

package/ssr/universal/utils.server.test.js

@@ -0,0 +1,24 @@
+"use strict";
+
+var utils = _interopRequireWildcard(require("./utils"));
+var _ssrShared = require("@salesforce/pwa-kit-runtime/utils/ssr-shared");
+function _getRequireWildcardCache(e) { if ("function" != typeof WeakMap) return null; var r = new WeakMap(), t = new WeakMap(); return (_getRequireWildcardCache = function (e) { return e ? t : r; })(e); }
+function _interopRequireWildcard(e, r) { if (!r && e && e.__esModule) return e; if (null === e || "object" != typeof e && "function" != typeof e) return { default: e }; var t = _getRequireWildcardCache(r); if (t && t.has(e)) return t.get(e); var n = { __proto__: null }, a = Object.defineProperty && Object.getOwnPropertyDescriptor; for (var u in e) if ("default" !== u && {}.hasOwnProperty.call(e, u)) { var i = a ? Object.getOwnPropertyDescriptor(e, u) : null; i && (i.get || i.set) ? Object.defineProperty(n, u, i) : n[u] = e[u]; } return n.default = e, t && t.set(e, n), n; }
+/**
+ * @jest-environment node
+ */
+/*
+ * Copyright (c) 2022, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+// Jest requires the @jest-environment comment at the start of file, which
+// conflicts with the eslint header rule.
+/* eslint-disable header/header */
+
+describe('getProxyConfigs (server-side)', () => {
+  test('should return the currently used proxy configs', () => {
+    expect(utils.getProxyConfigs()).toEqual(_ssrShared.proxyConfigs);
+  });
+});

package/utils/assets.js

@@ -0,0 +1,120 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.loadScript = void 0;
+function _extends() { return _extends = Object.assign ? Object.assign.bind() : function (n) { for (var e = 1; e < arguments.length; e++) { var t = arguments[e]; for (var r in t) ({}).hasOwnProperty.call(t, r) && (n[r] = t[r]); } return n; }, _extends.apply(null, arguments); }
+/*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+/**
+ * loadScriptCounter is used as a key to the window.Mobify object handlers. We
+ * Want this outside the loadScript function so that it can be updated every
+ * loadScript is called with a new script to be embedded to the head tag.
+ * @private
+ */
+let loadScriptCounter = 0;
+
+/**
+ * Writes script tag to the document, head tag
+ * @function
+ * @param {string} id - The id for script
+ * @param {string} src - The path to script
+ * @param {boolean} isAsync=true - Writes an asynchronous function
+ * @param {boolean} docwrite=false - Writes a string of text to a document
+ * @param {function} onload - The onload callback function
+ * @param {boolean} onerror - Rejects the function
+ * @example
+ * import {loadScript} from '@salesforce/pwa-kit-react-sdk/utils/utils'
+ *
+ * loadScript({
+ *     id: 'loadScriptTest1',
+ *     src: 'loadScriptTest1src'
+ * })
+ */
+const loadScript = ({
+  id,
+  src,
+  isAsync = true,
+  docwrite = false,
+  onload,
+  onerror
+}) => {
+  const hasTriedLoadScript = ({
+    id,
+    src,
+    method
+  }) => {
+    const idQuery = id ? `[id="${id}"]` : '';
+    return document.querySelectorAll(`script${idQuery}` + `[src="${src}"]` + `[data-load-method="${method}"]`).length > 0;
+  };
+  const loadMethod = docwrite ? 'document.write()' : 'DOM';
+  if (hasTriedLoadScript({
+    id,
+    src,
+    method: loadMethod
+  })) {
+    console.warn(`[mobify.progressive] loadScript() already called for this script. Ignoring call. (method='${loadMethod}' id='${id}' src='${src}')`);
+    return;
+  }
+  if (onload && typeof onload !== 'function') {
+    throw new Error(`loadScript()'s 'onload' parameter must be a function but was passed a ${typeof onload}!`);
+  }
+  if (onerror && typeof onerror !== 'function') {
+    throw new Error(`loadScript()'s 'onerror' parameter must be a function but was passed a ${typeof onerror}!`);
+  }
+
+  // TODO: Check for navigator.connection. Need Android for this.
+  /* istanbul ignore next */
+  if (docwrite && document.readyState === 'loading') {
+    window.Mobify = window.Mobify || {};
+    let onLoadString = '';
+    let onErrorString = '';
+    if (typeof onload === 'function') {
+      window.Mobify.scriptOnLoads = _extends({}, window.Mobify.scriptOnLoads, {
+        [loadScriptCounter]: onload
+      });
+      // Space prefix is important for valid rendered HTML
+      onLoadString = ` onload="window.Mobify.scriptOnLoads['${loadScriptCounter}'] && window.Mobify.scriptOnLoads['${loadScriptCounter}']()"`;
+    }
+    if (typeof onerror === 'function') {
+      window.Mobify.scriptOnErrors = _extends({}, window.Mobify.scriptOnErrors, {
+        [loadScriptCounter]: onerror
+      });
+      // Space prefix is important for valid rendered HTML
+      onErrorString = ` onerror="window.Mobify.scriptOnErrors['${loadScriptCounter}'] && window.Mobify.scriptOnErrors['${loadScriptCounter}']()"`;
+    }
+    document.write(`<script id='${id}' src='${src}' data-load-method='${loadMethod}' charset='utf-8'${onLoadString}${onErrorString}></script>`);
+    loadScriptCounter++;
+  } else {
+    const script = document.createElement('script');
+
+    // Setting UTF-8 as our encoding ensures that certain strings (i.e.
+    // Japanese text) are not improperly converted to something else. We
+    // do this on the vendor scripts also just in case any libs we
+    // import have localized strings in them.
+    script.charset = 'utf-8';
+    script.async = isAsync;
+    if (id) {
+      script.id = id;
+    }
+    script.src = src;
+    script.dataset.loadMethod = loadMethod;
+
+    /* istanbul ignore next */
+    if (typeof onload === 'function') {
+      script.onload = onload;
+    }
+    /* istanbul ignore next */
+    if (typeof onerror === 'function') {
+      script.onerror = onerror;
+    }
+    document.getElementsByTagName('head')[0].appendChild(script);
+  }
+};
+exports.loadScript = loadScript;

package/utils/assets.test.js

@@ -0,0 +1,106 @@
+"use strict";
+
+var _assets = require("./assets");
+var _sinon = _interopRequireDefault(require("sinon"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+const sandbox = _sinon.default.createSandbox();
+
+// Silence the error messages, they're on purpose here
+let consoleError;
+beforeEach(() => {
+  consoleError = console.error;
+  console.error = jest.fn();
+});
+afterEach(() => {
+  console.error = consoleError;
+  sandbox.restore();
+});
+describe('loadScript', () => {
+  let fakeScriptElement;
+  const headElement = document.getElementsByTagName('head')[0];
+  const originalReadyState = document.readyState;
+  beforeEach(() => {
+    fakeScriptElement = {
+      id: null,
+      src: null,
+      async: null,
+      charset: null,
+      onload: null,
+      onerror: null,
+      dataset: {}
+    };
+
+    // Mock out createElement and body.appendChild so that we don't have
+    // to fetch an actual script
+    sandbox.stub(document, 'createElement').returns(fakeScriptElement);
+    sandbox.stub(headElement, 'appendChild');
+    sandbox.stub(document, 'write');
+    Object.defineProperty(document, 'readyState', {
+      value: 'loading',
+      writable: true
+    });
+
+    // If you need to actually see the logging from these modules,
+    // change these `.stub()` calls to `.spy()`. Tests won't be affected.
+    sandbox.stub(console, 'log');
+    sandbox.stub(console, 'warn');
+  });
+  afterAll(() => {
+    sandbox.restore();
+    document.readyState = originalReadyState;
+  });
+  test('loadScript defaults to using the DOM to load the script', () => {
+    (0, _assets.loadScript)({
+      id: 'loadScriptTest1',
+      src: 'loadScriptTest1src'
+    });
+    expect(document.createElement.called).toBe(true);
+    expect(headElement.appendChild.called).toBe(true);
+    const element = headElement.appendChild.getCall(0).args[0];
+    expect(element.id).toBe('loadScriptTest1');
+    expect(element.src).toBe('loadScriptTest1src');
+  });
+  test('loadScript uses document.write when the flag is enabled', () => {
+    (0, _assets.loadScript)({
+      id: 'loadScriptTest1',
+      src: 'loadScriptTest1src',
+      docwrite: true
+    });
+    expect(document.write.called).toBe(true);
+  });
+  test('loadScript aborts if it finds the requested script has already been attempted', () => {
+    sandbox.stub(document, 'querySelectorAll').returns([1]);
+    (0, _assets.loadScript)({
+      id: 'loadScriptTest1',
+      src: 'loadScriptTest1src'
+    });
+
+    // Shouldn't have tried either method of inserting the script
+    expect(document.createElement.called).toBe(false);
+    expect(headElement.appendChild.called).toBe(false);
+    expect(document.write.called).toBe(false);
+  });
+  test('loadScript throws if `onload` is provided but is not a function', () => {
+    expect(() => {
+      (0, _assets.loadScript)({
+        src: 'loadScriptTest2src',
+        onload: 'onload expects this to be a function'
+      });
+    }).toThrow();
+  });
+  test('loadScript throws if `onerror` is provided but is not a function', () => {
+    expect(() => {
+      (0, _assets.loadScript)({
+        src: 'loadScriptTest2src',
+        onerror: 'onerror expects this to be a function'
+      });
+    }).toThrow();
+  });
+});

package/utils/logger-instance.js

@@ -0,0 +1,19 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = void 0;
+var _loggerFactory = _interopRequireDefault(require("@salesforce/pwa-kit-runtime/utils/logger-factory"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+const logger = Object.freeze((0, _loggerFactory.default)({
+  packageName: 'pwa-kit-react-sdk'
+}));
+var _default = exports.default = logger;

package/utils/performance.js

@@ -0,0 +1,126 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.default = exports.PERFORMANCE_MARKS = void 0;
+var _loggerInstance = _interopRequireDefault(require("./logger-instance"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+const PERFORMANCE_MARKS = exports.PERFORMANCE_MARKS = {
+  total: 'ssr:total',
+  renderToString: 'ssr:render-to-string',
+  routeMatching: 'ssr:route-matching',
+  loadComponent: 'ssr:load-component',
+  fetchStrategies: 'ssr:fetch-strategies',
+  reactQueryPrerender: 'ssr:fetch-strategies:react-query:pre-render',
+  reactQueryUseQuery: 'ssr:fetch-strategies:react-query:use-query',
+  getProps: 'ssr:fetch-strategies:get-prop'
+};
+
+/**
+ * This is an SDK internal class that is responsible for measuring server side performance.
+ *
+ * This class manages two types of performance marks: start and end.
+ *
+ * By default, this timer is disabled. Only certain environment variables and feature flags turns it on.
+ *
+ * @private
+ */
+class PerformanceTimer {
+  MARKER_TYPES = {
+    START: 'start',
+    END: 'end'
+  };
+  constructor(options = {}) {
+    this.enabled = options.enabled || false;
+    this.marks = {
+      start: new Map(),
+      end: new Map()
+    };
+    this.metrics = [];
+  }
+
+  /**
+   * This is a utility function to build the Server-Timing header.
+   * The function receives an array of performance metrics and returns a string that represents the Server-Timing header.
+   *
+   * see https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/Server-Timing
+   *
+   * @function
+   * @private
+   *
+   * @return {String}
+   */
+  buildServerTimingHeader() {
+    const header = this.metrics.map(metric => {
+      return `${metric.name};dur=${metric.duration}`;
+    }).join(', ');
+    return header;
+  }
+
+  /**
+   * A utility function to format and log the performance metrics.
+   *
+   * @function
+   * @private
+   */
+  log() {
+    this.metrics.forEach(metric => {
+      _loggerInstance.default.info(`${metric.name} - ${metric.duration}ms ${metric.detail || ''}`, {
+        namespace: 'performance'
+      });
+    });
+  }
+
+  /**
+   * This is a utility function to create performance marks.
+   * The data will be used in console logs and the http response header `server-timing`.
+   *
+   * @function
+   * @private
+   */
+  mark(name, type, options = {}) {
+    if (!this.enabled) {
+      return;
+    }
+    if (!name) {
+      _loggerInstance.default.warn('Performance mark cannot be created because the name is undefined.', {
+        namespace: 'performance'
+      });
+      return;
+    }
+    if (type !== this.MARKER_TYPES.START && type !== this.MARKER_TYPES.END) {
+      _loggerInstance.default.warn('Performance mark cannot be created because the type must be either "start" or "end".', {
+        namespace: 'performance'
+      });
+      return;
+    }
+    const timestamp = performance.now();
+    const isEnd = type === this.MARKER_TYPES.END;
+    const storage = isEnd ? this.marks.end : this.marks.start;
+    storage.set(name, {
+      name,
+      timestamp,
+      detail: options.detail
+    });
+    if (isEnd) {
+      const startMark = this.marks.start.get(name);
+      if (startMark) {
+        const measurement = {
+          name,
+          duration: (timestamp - startMark.timestamp).toFixed(2),
+          detail: options.detail
+        };
+        this.metrics.push(measurement);
+      }
+    }
+  }
+}
+exports.default = PerformanceTimer;

package/utils/performance.test.js

@@ -0,0 +1,50 @@
+"use strict";
+
+var _performance = _interopRequireDefault(require("./performance"));
+function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
+/**
+ * @jest-environment node
+ */
+/*
+ * Copyright (c) 2024, Salesforce, Inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+// The @jest-environment comment block *MUST* be the first line of the file for the tests to pass.
+// That conflicts with the monorepo header rule, so we must disable the rule!
+/* eslint-disable header/header */
+
+describe('PerformanceTimer', () => {
+  test('is disabled by default', () => {
+    const timer = new _performance.default();
+    timer.mark('test', 'start');
+    expect(timer.marks.start.size).toBe(0);
+  });
+  test('can be enabled', () => {
+    const timer = new _performance.default({
+      enabled: true
+    });
+    timer.mark('test', 'start');
+    expect(timer.marks.start.size).toBe(1);
+  });
+  test('marks can be added for both types', () => {
+    const timer = new _performance.default({
+      enabled: true
+    });
+    timer.mark('test', 'start');
+    timer.mark('test', 'end');
+    expect(timer.marks.start.size).toBe(1);
+    expect(timer.marks.end.size).toBe(1);
+  });
+  test('measurements are created when a pair of marks is added', () => {
+    const timer = new _performance.default({
+      enabled: true
+    });
+    timer.mark('test', 'start');
+    timer.mark('test', 'end');
+    expect(timer.metrics).toHaveLength(1);
+    expect(timer.metrics[0].name).toBe('test');
+    expect(parseFloat(timer.metrics[0].duration)).toBeGreaterThan(0);
+  });
+});

package/utils/url.js

@@ -0,0 +1,41 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.getAppOrigin = void 0;
+/*
+ * Copyright (c) 2024, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+/**
+ * Returns the application's origin.
+ *
+ * NOTE: This utility can only be used server-side after your application has been
+ * initialized using the `_createApp` method (This happens in your /app/ssr.js file).
+ *
+ * @function
+ * @deprecated use `useOrigin()` instead.
+ * This function will be removed in version 4.0.0.
+ * @returns {string} Returns the ORIGIN under which we are serving the page.
+ * @example
+ * import {getAppOrigin} from '@salesforce/pwa-kit-react-sdk/utils/url'
+ *
+ * const url = `${getAppOrigin()}/path`
+ */
+const getAppOrigin = () => {
+  if (typeof window !== 'undefined') {
+    return window.location.origin;
+  }
+  const {
+    APP_ORIGIN
+  } = process.env;
+  if (!APP_ORIGIN) {
+    throw new Error(`Application is not initialized. Please ensure '_createApp' has been invoked before using this method.`);
+  }
+  return process.env.APP_ORIGIN;
+};
+exports.getAppOrigin = getAppOrigin;

package/utils/url.test.js

@@ -0,0 +1,47 @@
+"use strict";
+
+var _url = require("./url");
+function ownKeys(e, r) { var t = Object.keys(e); if (Object.getOwnPropertySymbols) { var o = Object.getOwnPropertySymbols(e); r && (o = o.filter(function (r) { return Object.getOwnPropertyDescriptor(e, r).enumerable; })), t.push.apply(t, o); } return t; }
+function _objectSpread(e) { for (var r = 1; r < arguments.length; r++) { var t = null != arguments[r] ? arguments[r] : {}; r % 2 ? ownKeys(Object(t), !0).forEach(function (r) { _defineProperty(e, r, t[r]); }) : Object.getOwnPropertyDescriptors ? Object.defineProperties(e, Object.getOwnPropertyDescriptors(t)) : ownKeys(Object(t)).forEach(function (r) { Object.defineProperty(e, r, Object.getOwnPropertyDescriptor(t, r)); }); } return e; }
+function _defineProperty(e, r, t) { return (r = _toPropertyKey(r)) in e ? Object.defineProperty(e, r, { value: t, enumerable: !0, configurable: !0, writable: !0 }) : e[r] = t, e; }
+function _toPropertyKey(t) { var i = _toPrimitive(t, "string"); return "symbol" == typeof i ? i : i + ""; }
+function _toPrimitive(t, r) { if ("object" != typeof t || !t) return t; var e = t[Symbol.toPrimitive]; if (void 0 !== e) { var i = e.call(t, r || "default"); if ("object" != typeof i) return i; throw new TypeError("@@toPrimitive must return a primitive value."); } return ("string" === r ? String : Number)(t); } /*
+ * Copyright (c) 2021, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+describe('getAppOrigin', () => {
+  const OLD_ENV = process.env;
+  const OLD_WINDOW = global.window;
+  const TEST_ORIGIN = 'https://www.example.com';
+  beforeEach(() => {
+    jest.resetModules();
+    process.env = _objectSpread({}, OLD_ENV);
+  });
+  afterEach(() => {
+    process.env = OLD_ENV;
+    global.window = OLD_WINDOW;
+  });
+  test('returns `process.env.APP_ORIGIN` when on server', () => {
+    // Simulate being on the server by deleting the window.
+    delete global.window;
+
+    // Simulate starting the app server by simply setting the `APP_ORIGIN`
+    process.env.APP_ORIGIN = TEST_ORIGIN;
+    expect((0, _url.getAppOrigin)()).toBe(TEST_ORIGIN);
+  });
+  test('returns `window.location.origin` when on client', () => {
+    expect((0, _url.getAppOrigin)()).toBe('http://localhost');
+  });
+  test('throws error when APP_ORIGIN is not defined on server.', () => {
+    // Simulate being on the server by deleting the window.
+    delete global.window;
+
+    // Simulate app server not being initialized.
+    process.env.APP_ORIGIN = undefined;
+    expect(() => {
+      (0, _url.getAppOrigin)();
+    }).toThrow();
+  });
+});

package/utils/uuidv4.client.js

@@ -0,0 +1,21 @@
+"use strict";
+
+Object.defineProperty(exports, "__esModule", {
+  value: true
+});
+exports.uuidv4 = uuidv4;
+/*
+ * Copyright (c) 2022, salesforce.com, inc.
+ * All rights reserved.
+ * SPDX-License-Identifier: BSD-3-Clause
+ * For full license text, see the LICENSE file in the repo root or https://opensource.org/licenses/BSD-3-Clause
+ */
+
+/**
+ * Simple implementation to create a uuid using crypto
+ * See: https://stackoverflow.com/questions/105034/how-do-i-create-a-guid-uuid
+ * @returns {*}
+ */
+function uuidv4() {
+  return ([1e7] + -1e3 + -4e3 + -8e3 + -1e11).replace(/[018]/g, c => (c ^ crypto.getRandomValues(new Uint8Array(1))[0] & 15 >> c / 4).toString(16));
+}