@salesforce/pwa-kit-react-sdk 3.9.0-nightly-20241209080219 → 4.0.0-extensibility-preview.1

package/CHANGELOG.md

@@ -1,9 +1,9 @@
-## v3.9.0-nightly-20241209080219 (Dec 09, 2024)
-## v3.9.0-dev (Oct 29, 2024)
-
-## v3.8.0 (Oct 28, 2024)
-- [Server Affinity] - Attach dwsid to SCAPI request headers [#2090](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2090)
-- Create useOrigin hook to return an app origin that takes x-forwarded-host header into consideration. [#2050](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2050)
+## v4.0.0-extensibility-preview.1 (Dec 09, 2024)
+## v4.0.0-extensibility-preview.0 (Nov 28, 2024)
+- Integrate Application Extensions Project. (#2099)[https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2099]
+- Add new `getStaticAssetUrl` utility to access assets specifically in the `/static` folder. (#2040)[https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2040]
+- Update Application Extensions import in `react-rendering.js` and `main.js` (#2004)[https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2004]
+- Define interface of the app extension's config [#2010](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/2010)
 
 ## v3.7.0 (Aug 07, 2024)
 - Add `beforeHydrate` option to withReactQuery component [#1912](https://github.com/SalesforceCommerceCloud/pwa-kit/pull/1912)

package/package.json

@@ -1,7 +1,8 @@
 {
   "name": "@salesforce/pwa-kit-react-sdk",
-  "version": "3.9.0-nightly-20241209080219",
+  "version": "4.0.0-extensibility-preview.1",
   "description": "A library that supports the isomorphic React rendering pipeline for Commerce Cloud Managed Runtime apps",
+  "types": "dist/index.d.ts",
   "homepage": "https://github.com/SalesforceCommerceCloud/pwa-kit/tree/develop/packages/pwa-kit-react-sdk#readme",
   "bugs": {
     "url": "https://github.com/SalesforceCommerceCloud/pwa-kit/issues"
@@ -21,12 +22,12 @@
     "storefront-preview"
   ],
   "scripts": {
-    "build": "cross-env NODE_ENV=production internal-lib-build build",
-    "build:watch": "nodemon --watch 'src/**' --exec 'npm run build'",
-    "format": "internal-lib-build format \"**/*.{js,jsx}\"",
+    "build": "cross-env NODE_ENV=production internal-lib-build build && tsc",
+    "build:watch": "nodemon --watch 'src/**' --ext 'js,jsx,ts,tsx' --exec 'npm run build'",
+    "format": "internal-lib-build format \"**/*.{js,jsx,ts,tsx}\"",
     "lint": "npm run lint:js",
     "lint:fix": "npm run lint:js -- --fix",
-    "lint:js": "pwa-kit-dev lint \"**/*.{js,jsx}\"",
+    "lint:js": "pwa-kit-dev lint \"**/*.{js,jsx,ts,tsx}\"",
     "prepare": "npm run build",
     "test": "pwa-kit-dev test",
     "test:inspect": "node --inspect-brk jest --runInBand",
@@ -37,7 +38,8 @@
     "@loadable/babel-plugin": "^5.15.3",
     "@loadable/server": "^5.15.3",
     "@loadable/webpack-plugin": "^5.15.2",
-    "@salesforce/pwa-kit-runtime": "3.9.0-nightly-20241209080219",
+    "@salesforce/pwa-kit-extension-sdk": "4.0.0-extensibility-preview.1",
+    "@salesforce/pwa-kit-runtime": "4.0.0-extensibility-preview.1",
     "@tanstack/react-query": "^4.28.0",
     "cross-env": "^5.2.1",
     "event-emitter": "^0.3.5",
@@ -50,11 +52,14 @@
   },
   "devDependencies": {
     "@loadable/component": "^5.15.3",
-    "@salesforce/pwa-kit-dev": "3.9.0-nightly-20241209080219",
+    "@salesforce/pwa-kit-dev": "4.0.0-extensibility-preview.1",
     "@testing-library/jest-dom": "^5.16.5",
     "@testing-library/react": "^14.0.0",
     "@testing-library/user-event": "^14.4.3",
-    "internal-lib-build": "3.9.0-nightly-20241209080219",
+    "@types/hoist-non-react-statics": "~3.3.5",
+    "@types/react": "~18.2.0",
+    "@types/react-dom": "~18.2.1",
+    "internal-lib-build": "4.0.0-extensibility-preview.1",
     "node-html-parser": "^3.3.6",
     "nodemon": "^2.0.22",
     "react": "^18.2.0",
@@ -79,5 +84,5 @@
   "publishConfig": {
     "directory": "dist"
   },
-  "gitHead": "776e93dade65ec265428830940734a7714687fbf"
+  "gitHead": "5728f89cb53ab1b0c89418578f3e90c755efb0f8"
 }

package/ssr/browser/main.d.ts

@@ -0,0 +1,22 @@
+export function registerServiceWorker(url: any): Promise<void | undefined>;
+export function OuterApp({ routes, error, extensions, WrappedApp, locals, onHydrate }: {
+    routes: any;
+    error: any;
+    extensions: any;
+    WrappedApp: any;
+    locals: any;
+    onHydrate: any;
+}): import("react/jsx-runtime").JSX.Element;
+export namespace OuterApp {
+    namespace propTypes {
+        const routes: PropTypes.Validator<any[]>;
+        const error: PropTypes.Requireable<object>;
+        const extensions: PropTypes.Requireable<any[]>;
+        const WrappedApp: PropTypes.Validator<(...args: any[]) => any>;
+        const locals: PropTypes.Requireable<object>;
+        const onHydrate: PropTypes.Requireable<(...args: any[]) => any>;
+    }
+}
+export function start(): Promise<void>;
+import PropTypes from "prop-types";
+//# sourceMappingURL=main.d.ts.map

package/ssr/browser/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../src/ssr/browser/main.jsx"],"names":[],"mappings":"AA0BO,2EAoBN;AAEM;;;;;;;4CAmCN;;;;;;;;;;;AAWM,uCA6DN"}

package/ssr/browser/main.js

@@ -6,20 +6,23 @@ Object.defineProperty(exports, "__esModule", {
 exports.start = exports.registerServiceWorker = exports.OuterApp = void 0;
 var _react = _interopRequireWildcard(require("react"));
 var _client = require("react-dom/client");
+var _propTypes = _interopRequireDefault(require("prop-types"));
 var _reactRouterDom = require("react-router-dom");
+var _component = require("@loadable/component");
+var _react2 = require("@salesforce/pwa-kit-extension-sdk/react");
 var _contexts = require("../universal/contexts");
 var _app = _interopRequireDefault(require("../universal/components/_app"));
 var _compatibility = require("../universal/compatibility");
 var _switch = _interopRequireDefault(require("../universal/components/switch"));
 var _routeComponent = require("../universal/components/route-component");
-var _component = require("@loadable/component");
 var _uuidv = require("../../utils/uuidv4.client");
-var _propTypes = _interopRequireDefault(require("prop-types"));
 var _loggerInstance = _interopRequireDefault(require("../../utils/logger-instance"));
 function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
 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; }
-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); } /*
+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); }
+function asyncGeneratorStep(n, t, e, r, o, a, c) { try { var i = n[a](c), u = i.value; } catch (n) { return void e(n); } i.done ? t(u) : Promise.resolve(u).then(r, o); }
+function _asyncToGenerator(n) { return function () { var t = this, e = arguments; return new Promise(function (r, o) { var a = n.apply(t, e); function _next(n) { asyncGeneratorStep(a, r, o, _next, _throw, "next", n); } function _throw(n) { asyncGeneratorStep(a, r, o, _next, _throw, "throw", n); } _next(void 0); }); }; } /*
  * Copyright (c) 2021, salesforce.com, inc.
  * All rights reserved.
  * SPDX-License-Identifier: BSD-3-Clause
@@ -44,12 +47,19 @@ exports.registerServiceWorker = registerServiceWorker;
 const OuterApp = ({
   routes,
   error,
+  extensions,
   WrappedApp,
   locals,
   onHydrate
 }) => {
   const AppConfig = (0, _compatibility.getAppConfig)();
   const isInitialPageRef = (0, _react.useRef)(true);
+
+  // Invoke the Application Extensions 'beforeRouteMatch' hook. This hook accepts ALL the routes for the current
+  // application including all routes added from the configured extensions.
+  extensions.forEach(applicationExtension => {
+    routes = applicationExtension.beforeRouteMatch(routes);
+  });
   return /*#__PURE__*/_react.default.createElement(_contexts.ServerContext.Provider, {
     value: {}
   }, /*#__PURE__*/_react.default.createElement(_reactRouterDom.BrowserRouter, {
@@ -76,55 +86,68 @@ exports.OuterApp = OuterApp;
 OuterApp.propTypes = {
   routes: _propTypes.default.array.isRequired,
   error: _propTypes.default.object,
+  extensions: _propTypes.default.array,
   WrappedApp: _propTypes.default.func.isRequired,
   locals: _propTypes.default.object,
   onHydrate: _propTypes.default.func
 };
 /* istanbul ignore next */
-const start = () => {
-  const AppConfig = (0, _compatibility.getAppConfig)();
-  const rootEl = document.getElementsByClassName('react-target')[0];
-  const data = JSON.parse(document.getElementById('mobify-data').innerHTML);
+const start = exports.start = /*#__PURE__*/function () {
+  var _ref = _asyncToGenerator(function* () {
+    const AppConfig = (0, _compatibility.getAppConfig)();
+    const rootEl = document.getElementsByClassName('react-target')[0];
+    const data = JSON.parse(document.getElementById('mobify-data').innerHTML);
 
-  // Set all globals sent from the server on the window object.
-  Object.entries(data).forEach(([key, value]) => {
-    window[key] = value;
-  });
+    // Set all globals sent from the server on the window object.
+    Object.entries(data).forEach(([key, value]) => {
+      window[key] = value;
+    });
 
-  // Tell webpack how to find javascript files
-  Object.defineProperty(__webpack_require__, 'p', {
-    get: () => window.Progressive.buildOrigin
-  });
+    // Tell webpack how to find javascript files
+    Object.defineProperty(__webpack_require__, 'p', {
+      get: () => window.Progressive.buildOrigin
+    });
 
-  // On the browser we don't have request.locals, so we just provide an empty
-  // object that exists for the lifetime of the app. AppConfig components can use
-  // this to set up, eg. Redux stores.
-  const locals = {};
+    // On the browser we don't have request.locals, so we just provide an empty
+    // object that exists for the lifetime of the app. AppConfig components can use
+    // this to set up, eg. Redux stores.
+    const locals = {};
 
-  // AppConfig.restore *must* come before getRoutes()
-  AppConfig.restore(locals, window.__PRELOADED_STATE__.__STATE_MANAGEMENT_LIBRARY);
+    // AppConfig.restore *must* come before getRoutes()
+    AppConfig.restore(locals, window.__PRELOADED_STATE__.__STATE_MANAGEMENT_LIBRARY);
 
-  // We need to tell the routeComponent HOC when the app is hydrating in order to
-  // prevent pages from re-fetching data on the first client-side render. The
-  // reason we do this is that we expect a render to have taken place
-  // on the server already. That server-side render already called getProps()
-  // and froze the application state as a JSON blob on the page.
-  //
-  // This is VERY fiddly – don't go crazy with window.__HYDRATING__. You have
-  // been warned.
-  window.__HYDRATING__ = true;
-  const props = {
-    error: window.__ERROR__,
-    locals: locals,
-    routes: (0, _routeComponent.getRoutes)(locals),
-    WrappedApp: (0, _routeComponent.routeComponent)(_app.default, false, locals)
-  };
-  return Promise.resolve().then(() => new Promise(resolve => (0, _component.loadableReady)(resolve))).then(() => {
-    (0, _client.hydrateRoot)(rootEl, /*#__PURE__*/_react.default.createElement(OuterApp, _extends({}, props, {
-      onHydrate: () => {
-        window.__HYDRATING__ = false;
-      }
-    })));
+    // We need to tell the routeComponent HOC when the app is hydrating in order to
+    // prevent pages from re-fetching data on the first client-side render. The
+    // reason we do this is that we expect a render to have taken place
+    // on the server already. That server-side render already called getProps()
+    // and froze the application state as a JSON blob on the page.
+    //
+    // This is VERY fiddly – don't go crazy with window.__HYDRATING__. You have
+    // been warned.
+    window.__HYDRATING__ = true;
+
+    // Load all the configured Application Extensions and provide them to the
+    const applicationExtensions = yield (0, _react2.getApplicationExtensions)();
+    const WrappedApp = (0, _react2.withApplicationExtensions)((0, _routeComponent.routeComponent)(_app.default, false, locals), {
+      applicationExtensions,
+      locals
+    });
+    const props = {
+      error: window.__ERROR__,
+      locals: locals,
+      routes: (0, _routeComponent.getRoutes)(locals),
+      extensions: applicationExtensions,
+      WrappedApp
+    };
+    return Promise.resolve().then(() => new Promise(resolve => (0, _component.loadableReady)(resolve))).then(() => {
+      (0, _client.hydrateRoot)(rootEl, /*#__PURE__*/_react.default.createElement(OuterApp, _extends({}, props, {
+        onHydrate: () => {
+          window.__HYDRATING__ = false;
+        }
+      })));
+    });
   });
-};
-exports.start = start;
+  return function start() {
+    return _ref.apply(this, arguments);
+  };
+}();

package/ssr/browser/main.test.js

@@ -30,9 +30,10 @@ describe('main', function () {
       error: undefined,
       locals,
       routes: (0, _routeComponent.getRoutes)(locals),
-      WrappedApp: (0, _routeComponent.routeComponent)(App, false, locals)
+      WrappedApp: (0, _routeComponent.routeComponent)(App, false, locals),
+      extensions: []
     };
-    (0, _react2.render)( /*#__PURE__*/_react.default.createElement(_main.OuterApp, props));
+    (0, _react2.render)(/*#__PURE__*/_react.default.createElement(_main.OuterApp, props));
     expect(_react2.screen.getByText('App')).toBeInTheDocument();
     window.__PRELOADED_STATE__ = oldPreloadedState;
   });
@@ -45,9 +46,10 @@ describe('main', function () {
       error: window.__ERROR__,
       locals,
       routes: (0, _routeComponent.getRoutes)(locals),
-      WrappedApp: (0, _routeComponent.routeComponent)(App, false, locals)
+      WrappedApp: (0, _routeComponent.routeComponent)(App, false, locals),
+      extensions: []
     };
-    (0, _react2.render)( /*#__PURE__*/_react.default.createElement(_main.OuterApp, props));
+    (0, _react2.render)(/*#__PURE__*/_react.default.createElement(_main.OuterApp, props));
     expect(_react2.screen.getByText('Error Status: 404')).toBeInTheDocument();
     window.__ERROR__ = oldWindowError;
   });

package/ssr/server/react-rendering.d.ts

@@ -0,0 +1,9 @@
+export const ALLOWLISTED_INLINE_SCRIPTS: any[];
+export function getLocationSearch(req: any, opts?: {}): string;
+export function render(req: any, res: any, next: any): Promise<any>;
+export default serverRenderer;
+declare function serverRenderer({ clientStats, serverStats }: {
+    clientStats: any;
+    serverStats: any;
+}): (req: any, res: any, next: any) => Promise<any>;
+//# sourceMappingURL=react-rendering.d.ts.map

package/ssr/server/react-rendering.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"react-rendering.d.ts","sourceRoot":"","sources":["../../../src/ssr/server/react-rendering.js"],"names":[],"mappings":"AAyDA,+CAA4C;AAyBrC,+DA4BN;AAYM,oEA0IN;;AAiKD;;;oDAIK"}

package/ssr/server/react-rendering.js

@@ -16,10 +16,11 @@ var _sprite = _interopRequireDefault(require("svg-sprite-loader/runtime/sprite.b
 var _ssrServer = require("@salesforce/pwa-kit-runtime/utils/ssr-server");
 var _ssrShared = require("@salesforce/pwa-kit-runtime/utils/ssr-shared");
 var _ssrConfig = require("@salesforce/pwa-kit-runtime/utils/ssr-config");
+var _react2 = require("@salesforce/pwa-kit-extension-sdk/react");
 var _utils = require("../universal/utils");
 var _contexts = require("../universal/contexts");
-var _document = _interopRequireDefault(require("../universal/components/_document"));
 var _app = _interopRequireDefault(require("../universal/components/_app"));
+var _document = _interopRequireDefault(require("../universal/components/_document"));
 var _throw2 = _interopRequireDefault(require("../universal/components/throw-404"));
 var _compatibility = require("../universal/compatibility");
 var _switch = _interopRequireDefault(require("../universal/components/switch"));
@@ -86,7 +87,7 @@ const getLocationSearch = (req, opts = {}) => {
   const {
     interpretPlusSignAsSpace = false
   } = opts;
-  const [_, search] = req.originalUrl.split('?');
+  const [, search] = req.originalUrl.split('?');
   const params = new URLSearchParams(search);
   const newParams = new URLSearchParams();
   const orderedKeys = [...new Set(params.keys())];
@@ -122,7 +123,7 @@ exports.getLocationSearch = getLocationSearch;
 const render = exports.render = /*#__PURE__*/function () {
   var _ref = _asyncToGenerator(function* (req, res, next) {
     var _config$app, _config$app$url;
-    const includeServerTimingHeader = ('__server_timing' in req.query);
+    const includeServerTimingHeader = '__server_timing' in req.query;
     const shouldTrackPerformance = includeServerTimingHeader || process.env.SERVER_TIMING;
     res.__performanceTimer = new _performance.default({
       enabled: shouldTrackPerformance
@@ -132,8 +133,14 @@ const render = exports.render = /*#__PURE__*/function () {
     // Get the application config which should have been stored at this point.
     const config = (0, _ssrConfig.getConfig)();
     AppConfig.restore(res.locals);
-    const routes = (0, _routeComponent.getRoutes)(res.locals);
-    const WrappedApp = (0, _routeComponent.routeComponent)(_app.default, false, res.locals);
+
+    // Use locals to thread the application extensions through the rendering pipeline.
+    const applicationExtensions = yield (0, _react2.getApplicationExtensions)();
+    const WrappedApp = (0, _react2.withApplicationExtensions)((0, _routeComponent.routeComponent)(_app.default, false, res.locals), {
+      applicationExtensions,
+      locals: res.locals
+    });
+    let routes = (0, _routeComponent.getRoutes)(res.locals);
     const [pathname] = req.originalUrl.split('?');
     const location = {
       pathname,
@@ -143,6 +150,11 @@ const render = exports.render = /*#__PURE__*/function () {
     };
 
     // Step 1 - Find the match.
+
+    // Call `beforeRouteMatch` application extension hook.
+    applicationExtensions.forEach(applicationExtension => {
+      routes = applicationExtension.beforeRouteMatch(routes);
+    });
     res.__performanceTimer.mark(_performance.PERFORMANCE_MARKS.routeMatching, 'start');
     let route;
     let match;
@@ -315,7 +327,7 @@ const renderApp = args => {
 
   try {
     routerContext = {};
-    appHtml = renderToString( /*#__PURE__*/_react.default.cloneElement(appJSX, {
+    appHtml = renderToString(/*#__PURE__*/_react.default.cloneElement(appJSX, {
       routerContext
     }), extractor);
   } catch (e) {
@@ -323,7 +335,7 @@ const renderApp = args => {
     // to the AppErrorBoundary component, and renders the error page.
     routerContext = {};
     renderError = logAndFormatError(e);
-    appHtml = renderToString( /*#__PURE__*/_react.default.cloneElement(appJSX, {
+    appHtml = renderToString(/*#__PURE__*/_react.default.cloneElement(appJSX, {
       routerContext,
       error: renderError
     }), extractor);
@@ -384,7 +396,7 @@ const renderApp = args => {
     }
   })];
   const helmetHeadTags = VALID_TAG_NAMES.map(tag => helmet[tag] && helmet[tag].toComponent()).filter(tag => tag);
-  const html = _server.default.renderToString( /*#__PURE__*/_react.default.createElement(_document.default, {
+  const html = _server.default.renderToString(/*#__PURE__*/_react.default.createElement(_document.default, {
     head: [...helmetHeadTags],
     html: appHtml,
     afterBodyStart: svgs,

package/ssr/universal/compatibility.d.ts

@@ -0,0 +1,3 @@
+export function getAppConfig(): typeof AppConfig;
+import AppConfig from "./components/_app-config";
+//# sourceMappingURL=compatibility.d.ts.map

package/ssr/universal/compatibility.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"compatibility.d.ts","sourceRoot":"","sources":["../../../src/ssr/universal/compatibility.js"],"names":[],"mappings":"AAiBO,iDAKN"}

package/ssr/universal/components/_app/index.d.ts

@@ -0,0 +1,20 @@
+export default App;
+/**
+ * @module progressive-web-sdk/ssr/universal/components/_app
+ */
+/**
+ * The PWAApp is a special component that will be overridden in your project. Its
+ * main purpose is to provide the layout for your application as well as set up any
+ * global actions and data fetching via the `getProps` method. Typically this is
+ * where you will set up components like your application header, footer and
+ * navigation. The contents of this component are project specific, but the rule
+ * of thumb is that anything outside of your pages will be added here.
+ */
+declare function App(props: any): import("react/jsx-runtime").JSX.Element;
+declare namespace App {
+    namespace propTypes {
+        const children: PropTypes.Validator<PropTypes.ReactElementLike>;
+    }
+}
+import PropTypes from "prop-types";
+//# sourceMappingURL=index.d.ts.map

package/ssr/universal/components/_app/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ssr/universal/components/_app/index.jsx"],"names":[],"mappings":";AASA;;GAEG;AAEH;;;;;;;GAOG;AACH,0EAA2D"}

package/ssr/universal/components/_app/index.test.js

@@ -14,7 +14,7 @@ function _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e
 describe('App', () => {
   test('Renders correctly', () => {
     const body = /*#__PURE__*/_react.default.createElement("p", null, "Hello world");
-    (0, _react2.render)( /*#__PURE__*/_react.default.createElement(_index.default, null, body));
+    (0, _react2.render)(/*#__PURE__*/_react.default.createElement(_index.default, null, body));
     expect(_react2.screen.getByText(/hello world/i)).toBeInTheDocument();
   });
 });

package/ssr/universal/components/_app-config/index.d.ts

@@ -0,0 +1,60 @@
+export default AppConfig;
+/**
+ * This is a special component that can be overridden in a project. It supports
+ * two things:
+ *
+ *   1) Working with state management libraries such as Redux that need to set
+ *      up <Provider> instances at the root of an application.
+ *
+ *   2) Injecting properties (such as Redux stores, API clients) into getProps()
+ *      methods across an application. We can't use React's context to do this
+ *      because getProps() and co. need to be static methods.
+ */
+declare class AppConfig extends React.Component<any, any, any> {
+    /**
+     * Restore a state management backend from frozen state that was embedded
+     * into the page HTML.
+     *
+     * You can also use this to initialize a state-management library, and should
+     * save the instance onto `locals`.
+     *
+     * @param locals - res.locals on the server, an empty object as a substitute on
+     *    the client.
+     * @param frozen - the application state, restored from JSON in the HTML.
+     */
+    static restore(locals: any, frozen?: {}): void;
+    /**
+     * Freeze a state management backend for embedding into the page HTML.
+     *
+     * @param locals - res.locals on the server, an empty object as a substitute on
+     *    the client.
+     * @return {Object} - the application state as an object, which will be
+     *    serialized into JSON and embedded in the page HTML.
+     */
+    static freeze(locals: any): Object;
+    /**
+     * Return any extra arguments to be injected into `getProps` methods across
+     * the entire app, such as a Redux store.
+     *
+     * @param locals - res.locals on the server, an empty object as a substitute on
+     *    the client.
+     * @return {Object}
+     */
+    static extraGetPropsArgs(locals: any): Object;
+    constructor(props: any);
+    constructor(props: any, context: any);
+    /**
+     * This class is a React Component in order to provide this hook, which lets
+     * you set up context Providers for a state-management library such as Redux.
+     */
+    render(): import("react/jsx-runtime").JSX.Element;
+}
+declare namespace AppConfig {
+    namespace propTypes {
+        const children: PropTypes.Requireable<PropTypes.ReactNodeLike>;
+        const locals: PropTypes.Requireable<object>;
+    }
+}
+import React from "react";
+import PropTypes from "prop-types";
+//# sourceMappingURL=index.d.ts.map

package/ssr/universal/components/_app-config/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ssr/universal/components/_app-config/index.jsx"],"names":[],"mappings":";AAcA;;;;;;;;;;GAUG;AACH;IACI;;;;;;;;;;OAUG;IAEH,+CAEC;IAED;;;;;;;OAOG;IAEH,4BAJY,MAAM,CAMjB;IAED;;;;;;;OAOG;IAEH,uCAHY,MAAM,CAKjB;IAiBi88B,wBAAgC;IAAA,sCAAmL;IAfrp9B;;;OAGG;IACH,kDAEC;CACJ"}

package/ssr/universal/components/_document/index.d.ts

@@ -0,0 +1,55 @@
+export default Document;
+/**
+ * The Document is a special component that can be overridden in a project, it
+ * provides the default document foundation for your PWA. This includes
+ * defaults for lang, charset, viewport, theme-color, script locations, etc.
+ * We do not recommend overriding this component, but if you do require fine grained control of
+ * your application we recommend using this implementation as a starting point to ensure
+ * the correct functionality of your PWA.
+ *
+ * The properties for this component will be set in the server-side rendering pipeline.
+ * Failure to use all these properties will most likely result in a non-functioning
+ * PWA.
+ *
+ * @param {Array.<Object>} props.beforeBodyEnd - The renderable elements to be placed directly before
+ *      the end of the body tag.
+ * @param {object} [props.bodyAttributes] - The attributes to be applied to the documents body tag.
+ *      <br/>
+ *      <br/>
+ *      <i>These are set by using `react-helmet`. Please refer to their {@link https://github.com/nfl/react-helmet/tree/5.2.0#readme|docs}
+ *      for its usage.</i>
+ * @param {Array.<Object>} props.head - The elements to be placed inside the documents head tag.
+ * @param {string} [props.html] - The HTML to be rendered in your documents html tag.
+ * @param {object} [props.htmlAttributes] - The attributes to be applied to the documents html tag.
+ *      <br/>
+ *      <br/>
+ *      <i>These are set by using `react-helmet`. Please refer to their {@link https://github.com/nfl/react-helmet/tree/5.2.0#readme|docs}
+ *      for its usage.</i>
+ */
+declare function Document(props: any): import("react/jsx-runtime").JSX.Element;
+declare namespace Document {
+    namespace propTypes {
+        const afterBodyStart: PropTypes.Validator<PropTypes.ReactNodeLike[]>;
+        const beforeBodyEnd: PropTypes.Validator<PropTypes.ReactNodeLike[]>;
+        const head: PropTypes.Validator<PropTypes.ReactNodeLike[]>;
+        const html: PropTypes.Validator<string>;
+        const htmlAttributes: PropTypes.Requireable<object>;
+        const bodyAttributes: PropTypes.Requireable<object>;
+    }
+    namespace defaultProps {
+        const afterBodyStart_1: never[];
+        export { afterBodyStart_1 as afterBodyStart };
+        const beforeBodyEnd_1: never[];
+        export { beforeBodyEnd_1 as beforeBodyEnd };
+        const head_1: never[];
+        export { head_1 as head };
+        const html_1: string;
+        export { html_1 as html };
+        const htmlAttributes_1: {};
+        export { htmlAttributes_1 as htmlAttributes };
+        const bodyAttributes_1: {};
+        export { bodyAttributes_1 as bodyAttributes };
+    }
+}
+import PropTypes from "prop-types";
+//# sourceMappingURL=index.d.ts.map

package/ssr/universal/components/_document/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ssr/universal/components/_document/index.jsx"],"names":[],"mappings":";AAcA;;;;;;;;;;;;;;;;;;;;;;;;;;GA0BG;AACH,+EAwBC"}

package/ssr/universal/components/_document/index.test.js

@@ -32,7 +32,7 @@ describe('Document', () => {
     const htmlAttributes = {
       lang: 'en'
     };
-    (0, _react2.render)( /*#__PURE__*/_react.default.createElement(_index.default, {
+    (0, _react2.render)(/*#__PURE__*/_react.default.createElement(_index.default, {
       head: [style],
       html: html,
       afterBodyStart: [sprite],

package/ssr/universal/components/_error/index.d.ts

@@ -0,0 +1,32 @@
+export default Error;
+/**
+ * This is a special component that can be overridden in a project. We recommend
+ * doing this in your project in order to cutomize its behaviour. You can accomplish
+ * things such as, making the error page brand specific, redirecting when errors
+ * occur, or adding reporting.
+ *
+ * The default Error component provides a basic layout for displaying errors
+ * that have occured during server-side rendering or client-side execution.
+ *
+ * @param {string} props.message - The errors message.
+ * @param {string} props.stack - The errors stack trace.
+ *      <br/>
+ *      <br/>
+ *      <i>This property is only defined in non-production environments.</i>
+ * @param {number} props.status - The errors HTTP status code.
+ *      <br/>
+ *      <br/>
+ *      <i>This property is typically used to distinguish 404 errors from other types.</i>
+ * @param {string} props.correlationId
+ */
+declare function Error({ message, stack, status, correlationId }: string): import("react/jsx-runtime").JSX.Element;
+declare namespace Error {
+    namespace propTypes {
+        const message: PropTypes.Validator<string>;
+        const status: PropTypes.Validator<number>;
+        const stack: PropTypes.Requireable<string>;
+        const correlationId: PropTypes.Requireable<string>;
+    }
+}
+import PropTypes from "prop-types";
+//# sourceMappingURL=index.d.ts.map

package/ssr/universal/components/_error/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../../src/ssr/universal/components/_error/index.jsx"],"names":[],"mappings":";AAcA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,kEAXW,MAAM,2CAoBhB"}

package/ssr/universal/components/_error/index.test.js

@@ -16,7 +16,7 @@ describe('Error Page', () => {
   const status = 500;
   const message = 'Error message';
   test('Renders correctly', () => {
-    (0, _react2.render)( /*#__PURE__*/_react.default.createElement(_index.default, {
+    (0, _react2.render)(/*#__PURE__*/_react.default.createElement(_index.default, {
       message: message,
       stack: stack,
       status: status