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

package/ssr/server/constants.d.ts

@@ -0,0 +1,18 @@
+export const APPLICATION_OCTET_STREAM: "application/octet-stream";
+export const BUILD: "build";
+export const STATIC_ASSETS: "static_assets";
+/**  * @deprecated Use ssr-namespace-paths proxyBasePath instead  */
+export const PROXY_PATH_PREFIX: "/mobify/proxy";
+export const CONTENT_TYPE: "content-type";
+export const CONTENT_ENCODING: "content-encoding";
+export const X_ORIGINAL_CONTENT_TYPE: "x-original-content-type";
+export const X_MOBIFY_QUERYSTRING: "x-mobify-querystring";
+export const X_MOBIFY_FROM_CACHE: "x-mobify-from-cache";
+export const SET_COOKIE: "set-cookie";
+export const CACHE_CONTROL: "cache-control";
+export const NO_CACHE: "max-age=0, nocache, nostore, must-revalidate";
+export const CONTENT_SECURITY_POLICY: "content-security-policy";
+export const STRICT_TRANSPORT_SECURITY: "strict-transport-security";
+/**  * @deprecated Use ssr-namespace-paths.slasPrivateProxyPath instead  */
+export const SLAS_CUSTOM_PROXY_PATH: "/mobify/slas/private";
+//# sourceMappingURL=constants.d.ts.map

package/ssr/server/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/ssr/server/constants.js"],"names":[],"mappings":"AAMA,kEAAkE;AAClE,4BAA4B;AAC5B,4CAA4C;AAE5C,oEAAoE;AACpE,gDAAgD;AAGhD,0CAA0C;AAC1C,kDAAkD;AAClD,gEAAgE;AAChE,0DAA0D;AAC1D,wDAAwD;AACxD,sCAAsC;AACtC,4CAA4C;AAC5C,sEAAsE;AACtE,gEAAgE;AAChE,oEAAoE;AAEpE,2EAA2E;AAC3E,4DAA4D"}

package/ssr/server/constants.js

@@ -3,7 +3,7 @@
 Object.defineProperty(exports, "__esModule", {
   value: true
 });
-exports.X_ORIGINAL_CONTENT_TYPE = exports.X_MOBIFY_QUERYSTRING = exports.X_MOBIFY_FROM_CACHE = exports.X_ENCODED_HEADERS = exports.STRICT_TRANSPORT_SECURITY = exports.STATIC_ASSETS = exports.SLAS_CUSTOM_PROXY_PATH = exports.SET_COOKIE = exports.PROXY_PATH_PREFIX = exports.NO_CACHE = exports.CONTENT_TYPE = exports.CONTENT_SECURITY_POLICY = exports.CONTENT_ENCODING = exports.CACHE_CONTROL = exports.BUILD = exports.APPLICATION_OCTET_STREAM = void 0;
+exports.X_ORIGINAL_CONTENT_TYPE = exports.X_MOBIFY_QUERYSTRING = exports.X_MOBIFY_FROM_CACHE = exports.STRICT_TRANSPORT_SECURITY = exports.STATIC_ASSETS = exports.SLAS_CUSTOM_PROXY_PATH = exports.SET_COOKIE = exports.PROXY_PATH_PREFIX = exports.NO_CACHE = exports.CONTENT_TYPE = exports.CONTENT_SECURITY_POLICY = exports.CONTENT_ENCODING = exports.CACHE_CONTROL = exports.BUILD = exports.APPLICATION_OCTET_STREAM = void 0;
 /*
  * Copyright (c) 2021, salesforce.com, inc.
  * All rights reserved.
@@ -23,7 +23,6 @@ const CONTENT_ENCODING = exports.CONTENT_ENCODING = 'content-encoding';
 const X_ORIGINAL_CONTENT_TYPE = exports.X_ORIGINAL_CONTENT_TYPE = 'x-original-content-type';
 const X_MOBIFY_QUERYSTRING = exports.X_MOBIFY_QUERYSTRING = 'x-mobify-querystring';
 const X_MOBIFY_FROM_CACHE = exports.X_MOBIFY_FROM_CACHE = 'x-mobify-from-cache';
-const X_ENCODED_HEADERS = exports.X_ENCODED_HEADERS = 'x-encoded-headers';
 const SET_COOKIE = exports.SET_COOKIE = 'set-cookie';
 const CACHE_CONTROL = exports.CACHE_CONTROL = 'cache-control';
 const NO_CACHE = exports.NO_CACHE = 'max-age=0, nocache, nostore, must-revalidate';

package/ssr/server/express.d.ts

@@ -0,0 +1,17 @@
+export const RESOLVED_PROMISE: Promise<void>;
+export function generateCacheKey(req: IncomingMessage, options?: {
+    extras?: (string | undefined)[] | undefined;
+    ignoreRequestClass?: boolean | undefined;
+} | undefined): string;
+export function cacheResponseWhenDone({ req, res, expiration, key, namespace, shouldCacheResponse }: express.request): void;
+export function sendCachedResponse(cached: CachedResponse): void;
+export function getResponseFromCache({ req, res, namespace, key }: express.request): Promise<CachedResponse>;
+export function respondFromBundle({ req, res, path, redirect }: {
+    req: Request;
+    res: Response;
+    path?: string | undefined;
+    redirect?: number | undefined;
+}): void;
+export function getRuntime(): any;
+import { CachedResponse } from "../../utils/ssr-server/cached-response";
+//# sourceMappingURL=express.d.ts.map

package/ssr/server/express.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"express.d.ts","sourceRoot":"","sources":["../../../src/ssr/server/express.js"],"names":[],"mappings":"AA0BA,6CAAiD;AA4C1C;;;uBA6BN;AA+GM,4HA2FN;AAYM,2CAHW,cAAc,QAS/B;AA4CM,qFAJM,QAAQ,cAAc,CAAC,CA8BnC;AAwBM;IAVqB,GAAG,EAApB,OAAO;IACW,GAAG,EAArB,QAAQ;IACS,IAAI;IAIJ,QAAQ;SA2BnC;AAMM,kCAsBN"}

package/ssr/server/express.test.js

@@ -19,8 +19,6 @@ var _crypto = require("crypto");
 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 _interopRequireDefault(e) { return e && e.__esModule ? e : { default: e }; }
-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); }); }; }
 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 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; }
@@ -479,40 +477,6 @@ describe('SSRServer operation', () => {
       expect(response.headers['set-cookie']).toBeUndefined();
     });
   });
-  test('should set xForwardedOrigin based on defined x-forwarded-host and x-forwarded-proto headers', () => {
-    process.env = {
-      MRT_ALLOW_COOKIES: 'true'
-    };
-    const forwardedHost = 'www.example.com';
-    const forwardedProto = 'https';
-    const app = _buildRemoteServer.RemoteServerFactory._createApp(opts());
-    const route = (req, res) => {
-      expect(req.headers['x-forwarded-host']).toBe(forwardedHost);
-      expect(res.locals.xForwardedOrigin).toBe(`${forwardedProto}://${forwardedHost}`);
-      res.sendStatus(200);
-    };
-    app.get('/*', route);
-    return (0, _supertest.default)(app).get('/').set('x-forwarded-host', forwardedHost).set('x-forwarded-proto', 'https').then(response => {
-      expect(response.status).toBe(200);
-    });
-  });
-  test('should set xForwardedOrigin based on defined x-forwarded-host and undefined x-forwarded-proto headers', () => {
-    process.env = {
-      MRT_ALLOW_COOKIES: 'true'
-    };
-    const options = opts();
-    const forwardedHost = 'www.example.com';
-    const app = _buildRemoteServer.RemoteServerFactory._createApp(options);
-    const route = (req, res) => {
-      expect(req.headers['x-forwarded-host']).toBe(forwardedHost);
-      expect(res.locals.xForwardedOrigin).toBe(`${options.protocol}://${forwardedHost}`);
-      res.sendStatus(200);
-    };
-    app.get('/*', route);
-    return (0, _supertest.default)(app).get('/').set('x-forwarded-host', forwardedHost).then(response => {
-      expect(response.status).toBe(200);
-    });
-  });
   test(`should reject POST requests to /`, () => {
     const app = _buildRemoteServer.RemoteServerFactory._createApp(opts());
     const route = (req, res) => {
@@ -909,7 +873,7 @@ describe('DevServer middleware', () => {
     _buildRemoteServer.RemoteServerFactory._validateConfiguration(opts({
       strictSSL: false
     }));
-    expect(warn.mock.calls).toEqual([['The SSR Server has _strictSSL turned off for https requests']]);
+    expect(warn.mock.calls).toEqual([['pwa-kit-runtime WARN The SSR Server has _strictSSL turned off for https requests']]);
   });
 });
 describe('SLAS private client proxy', () => {
@@ -930,9 +894,6 @@ describe('SLAS private client proxy', () => {
   afterEach(() => {
     process.env = savedEnvironment;
   });
-  afterAll(() => {
-    proxyApp.close();
-  });
   test('should not create proxy by default', () => {
     const app = _buildRemoteServer.RemoteServerFactory._createApp(opts());
     return (0, _supertest.default)(app).get('/mobify/slas/private').expect(404);
@@ -943,7 +904,7 @@ describe('SLAS private client proxy', () => {
     }));
     return (0, _supertest.default)(app).get('/mobify/slas/private').expect(501);
   });
-  test('does not insert client secret if request not for /oauth2/token', /*#__PURE__*/_asyncToGenerator(function* () {
+  test('does not insert client secret if request not for /oauth2/token', () => {
     process.env.PWA_KIT_SLAS_CLIENT_SECRET = 'a secret';
     const app = _buildRemoteServer.RemoteServerFactory._createApp(opts({
       mobify: {
@@ -959,13 +920,13 @@ describe('SLAS private client proxy', () => {
       useSLASPrivateClient: true,
       slasTarget: slasTarget
     }));
-    return yield (0, _supertest.default)(app).get('/mobify/slas/private/somePath').then(response => {
+    return (0, _supertest.default)(app).get('/mobify/slas/private/somePath').then(response => {
       expect(response.body.authorization).toBeUndefined();
       expect(response.body.host).toBe('shortCode.api.commercecloud.salesforce.com');
       expect(response.body['x-mobify']).toBe('true');
     });
-  }), 15000);
-  test('inserts client secret if request is for /oauth2/token', /*#__PURE__*/_asyncToGenerator(function* () {
+  });
+  test('inserts client secret if request is for /oauth2/token', () => {
     process.env.PWA_KIT_SLAS_CLIENT_SECRET = 'a secret';
     const encodedCredentials = Buffer.from('clientId:a secret').toString('base64');
     const app = _buildRemoteServer.RemoteServerFactory._createApp(opts({
@@ -982,55 +943,10 @@ describe('SLAS private client proxy', () => {
       useSLASPrivateClient: true,
       slasTarget: slasTarget
     }));
-    return yield (0, _supertest.default)(app).get('/mobify/slas/private/oauth2/token').then(response => {
+    return (0, _supertest.default)(app).get('/mobify/slas/private/oauth2/token').then(response => {
       expect(response.body.authorization).toBe(`Basic ${encodedCredentials}`);
       expect(response.body.host).toBe('shortCode.api.commercecloud.salesforce.com');
       expect(response.body['x-mobify']).toBe('true');
     });
-  }), 15000);
-  test('does not add _sfdc_client_auth header if request not for /oauth2/trusted-agent/token', /*#__PURE__*/_asyncToGenerator(function* () {
-    process.env.PWA_KIT_SLAS_CLIENT_SECRET = 'a secret';
-    const encodedCredentials = Buffer.from('clientId:a secret').toString('base64');
-    const app = _buildRemoteServer.RemoteServerFactory._createApp(opts({
-      mobify: {
-        app: {
-          commerceAPI: {
-            parameters: {
-              clientId: 'clientId',
-              shortCode: 'shortCode'
-            }
-          }
-        }
-      },
-      useSLASPrivateClient: true,
-      slasTarget: slasTarget
-    }));
-    return yield (0, _supertest.default)(app).get('/mobify/slas/oauth2/other-path').then(response => {
-      expect(response.body._sfdc_client_auth).toBeUndefined();
-    });
-  }), 15000);
-  test('adds _sfdc_client_auth header if request is for /oauth2/trusted-agent/token', /*#__PURE__*/_asyncToGenerator(function* () {
-    process.env.PWA_KIT_SLAS_CLIENT_SECRET = 'a secret';
-    const encodedCredentials = Buffer.from('clientId:a secret').toString('base64');
-    const app = _buildRemoteServer.RemoteServerFactory._createApp(opts({
-      mobify: {
-        app: {
-          commerceAPI: {
-            parameters: {
-              clientId: 'clientId',
-              shortCode: 'shortCode'
-            }
-          }
-        }
-      },
-      useSLASPrivateClient: true,
-      slasTarget: slasTarget,
-      trustedAgentAuthPathMatch: /\/oauth2\/trusted-agent\/token/
-    }));
-    return yield (0, _supertest.default)(app).get('/mobify/slas/private/oauth2/trusted-agent/token').then(response => {
-      expect(response.body['_sfdc_client_auth']).toBe(encodedCredentials);
-      expect(response.body.host).toBe('shortCode.api.commercecloud.salesforce.com');
-      expect(response.body['x-mobify']).toBe('true');
-    });
-  }), 15000);
+  });
 });

package/ssr/server/test_fixtures/extensions/another-extension/setup-server.d.ts

@@ -0,0 +1,5 @@
+export default AnotherExtension;
+declare class AnotherExtension {
+    extendApp(app: any): any;
+}
+//# sourceMappingURL=setup-server.d.ts.map

package/ssr/server/test_fixtures/extensions/another-extension/setup-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-server.d.ts","sourceRoot":"","sources":["../../../../../../src/ssr/server/test_fixtures/extensions/another-extension/setup-server.js"],"names":[],"mappings":";AAQA;IACI,yBAMC;CACJ"}

package/ssr/server/test_fixtures/extensions/another-extension/setup-server.js

@@ -0,0 +1,19 @@
+/*
+ * 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
+ */
+import {ApplicationExtension} from '../../../extensibility'
+
+class AnotherExtension extends ApplicationExtension {
+    extendApp(app) {
+        app.get('/another-extension', (req, res) => {
+            res.send('test')
+        })
+
+        return app
+    }
+}
+
+export default AnotherExtension

package/ssr/server/test_fixtures/extensions/extension-with-bad-setup-server/setup-server.d.ts

@@ -0,0 +1,5 @@
+export default Extension;
+declare class Extension {
+    extendApp(app: any): void;
+}
+//# sourceMappingURL=setup-server.d.ts.map

package/ssr/server/test_fixtures/extensions/extension-with-bad-setup-server/setup-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-server.d.ts","sourceRoot":"","sources":["../../../../../../src/ssr/server/test_fixtures/extensions/extension-with-bad-setup-server/setup-server.js"],"names":[],"mappings":";AASA;IACI,0BAEC;CACJ"}

package/ssr/server/test_fixtures/extensions/extension-with-bad-setup-server/setup-server.js

@@ -0,0 +1,16 @@
+/*
+ * 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
+ */
+
+import {ApplicationExtension} from '../../../extensibility'
+
+class Extension extends ApplicationExtension {
+    extendApp(app) {
+        throw new Error('extension will fail to initialize because of me')
+    }
+}
+
+export default Extension

package/ssr/server/test_fixtures/extensions/extension-with-setup-server-no-default-export/setup-server.d.ts

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setup-server.d.ts.map

package/ssr/server/test_fixtures/extensions/extension-with-setup-server-no-default-export/setup-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-server.d.ts","sourceRoot":"","sources":["../../../../../../src/ssr/server/test_fixtures/extensions/extension-with-setup-server-no-default-export/setup-server.js"],"names":[],"mappings":""}

package/ssr/server/test_fixtures/extensions/extension-with-setup-server-no-default-export/setup-server.js

@@ -0,0 +1,17 @@
+/*
+ * 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
+ */
+
+import {ApplicationExtension} from '../../../extensibility'
+class AnotherExtension extends ApplicationExtension {
+    extendApp(app) {
+        app.get('/another-extension', (req, res) => {
+            res.send('test')
+        })
+
+        return app
+    }
+}

package/ssr/server/test_fixtures/extensions/extension-without-setup-server/random-file.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=random-file.d.ts.map

package/ssr/server/test_fixtures/extensions/extension-without-setup-server/random-file.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-file.d.ts","sourceRoot":"","sources":["../../../../../../src/ssr/server/test_fixtures/extensions/extension-without-setup-server/random-file.js"],"names":[],"mappings":""}

package/ssr/server/test_fixtures/extensions/extension-without-setup-server/random-file.js

@@ -0,0 +1,7 @@
+/*
+ * 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
+ */
+// intentionally empty

package/ssr/server/test_fixtures/extensions/test-extension/setup-server.d.ts

@@ -0,0 +1,5 @@
+export default TestExtension;
+declare class TestExtension {
+    extendApp(app: any): any;
+}
+//# sourceMappingURL=setup-server.d.ts.map

package/ssr/server/test_fixtures/extensions/test-extension/setup-server.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"setup-server.d.ts","sourceRoot":"","sources":["../../../../../../src/ssr/server/test_fixtures/extensions/test-extension/setup-server.js"],"names":[],"mappings":";AAQA;IACI,yBAeC;CACJ"}

package/ssr/server/test_fixtures/extensions/test-extension/setup-server.js

@@ -0,0 +1,28 @@
+/*
+ * 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
+ */
+
+import {ApplicationExtension} from '../../../extensibility'
+class TestExtension extends ApplicationExtension {
+    extendApp(app) {
+        console.log(
+            'ApplicationExtensionApplicationExtensionApplicationExtensionApplicationExtensionApplicationExtensionApplicationExtension: ',
+            ApplicationExtension
+        )
+
+        app.get('/test-extension', (req, res) => {
+            res.send('test')
+        })
+        app.get('/test-extension-config', (req, res) => {
+            const config = JSON.stringify(this.getConfig())
+            res.send(config)
+        })
+
+        return app
+    }
+}
+
+export default TestExtension

package/ssr/server/test_fixtures/main.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=main.d.ts.map

package/ssr/server/test_fixtures/main.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"main.d.ts","sourceRoot":"","sources":["../../../../src/ssr/server/test_fixtures/main.js"],"names":[],"mappings":""}

package/ssr/server/test_fixtures/server-renderer.d.ts

@@ -0,0 +1,6 @@
+declare function _default({ clientStats, serverStats }: {
+    clientStats: any;
+    serverStats: any;
+}): (req: any, res: any, next: any) => any;
+export default _default;
+//# sourceMappingURL=server-renderer.d.ts.map

package/ssr/server/test_fixtures/server-renderer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"server-renderer.d.ts","sourceRoot":"","sources":["../../../../src/ssr/server/test_fixtures/server-renderer.js"],"names":[],"mappings":"AAQkB;;;2CAGjB"}

package/ssr/server/test_fixtures/worker.d.ts

@@ -0,0 +1 @@
+//# sourceMappingURL=worker.d.ts.map

package/ssr/server/test_fixtures/worker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"worker.d.ts","sourceRoot":"","sources":["../../../../src/ssr/server/test_fixtures/worker.js"],"names":[],"mappings":""}

package/utils/logger-factory.d.ts

@@ -0,0 +1,58 @@
+/**
+ * The PWAKitLogger provides structured logging with different log levels.
+ * @private
+ */
+export class PWAKitLogger {
+    /**
+     * Creates an instance of PWAKitLogger.
+     * @param {Object} options - Configuration options for the logger.
+     * @param {string} options.packageName - The name of the package where the logger is used.
+     */
+    constructor(options?: {
+        packageName: string;
+    });
+    packageName: string;
+    /**
+     * Logs a debug message.
+     * @param {string} message - The debug message.
+     * @param {Object} [details={}] - Optional message details.
+     */
+    debug(message: string, details?: Object | undefined): void;
+    /**
+     * Logs an info message.
+     * @param {string} message - The info message.
+     * @param {Object} [details={}] - Optional message details.
+     */
+    log(message: string, details?: Object | undefined): void;
+    /**
+     * Logs an info message.
+     * @param {string} message - The info message.
+     * @param {Object} [details={}] - Optional message details.
+     */
+    info(message: string, details?: Object | undefined): void;
+    /**
+     * Logs a warning message.
+     * @param {string} message - The warning message.
+     * @param {Object} [details={}] - Optional message details.
+     */
+    warn(message: string, details?: Object | undefined): void;
+    /**
+     * Logs an error message.
+     * @param {string} message - The error message.
+     * @param {Object} [details={}] - Optional message details.
+     */
+    error(message: string, details?: Object | undefined): void;
+    #private;
+}
+export default createLogger;
+/**
+ * Create a logger instance for each package.
+ *
+ * @param {Object} config - Configuration object for the logger.
+ * @param {string} config.packageName - The name of the package where the logger is used.
+ * @returns {PWAKitLogger} - An instance of PWAKitLogger configured for the specified package.
+ */
+declare function createLogger(config?: {
+    packageName: string;
+}): PWAKitLogger;
+//# sourceMappingURL=logger-factory.d.ts.map

package/utils/logger-factory.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-factory.d.ts","sourceRoot":"","sources":["../../src/utils/logger-factory.js"],"names":[],"mappings":"AAOA;;;GAGG;AACH;IACI;;;;OAIG;IACH;QAF2B,WAAW,EAA3B,MAAM;OAIhB;IADG,oBAA4C;IAwDhD;;;;OAIG;IACH,eAHW,MAAM,sCAKhB;IAED;;;;OAIG;IACH,aAHW,MAAM,sCAKhB;IAED;;;;OAIG;IACH,cAHW,MAAM,sCAKhB;IAED;;;;OAIG;IACH,cAHW,MAAM,sCAKhB;IAED;;;;OAIG;IACH,eAHW,MAAM,sCAKhB;;CACJ;;AAED;;;;;;GAMG;AACH;IAH0B,WAAW,EAA1B,MAAM;IACJ,YAAY,CAIxB"}

package/utils/logger-instance.d.ts

@@ -0,0 +1,3 @@
+export default logger;
+declare const logger: Readonly<import("./logger-factory").PWAKitLogger>;
+//# sourceMappingURL=logger-instance.d.ts.map

package/utils/logger-instance.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger-instance.d.ts","sourceRoot":"","sources":["../../src/utils/logger-instance.js"],"names":[],"mappings":";AAQA,wEAA4E"}

package/utils/middleware/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./security";
+//# sourceMappingURL=index.d.ts.map

package/utils/middleware/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/middleware/index.js"],"names":[],"mappings":""}

package/utils/middleware/security.d.ts

@@ -0,0 +1,2 @@
+export function defaultPwaKitSecurityHeaders(req: express.Request, res: express.Response, next: express.NextFunction): void;
+//# sourceMappingURL=security.d.ts.map

package/utils/middleware/security.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"security.d.ts","sourceRoot":"","sources":["../../../src/utils/middleware/security.js"],"names":[],"mappings":"AAkBO,4HAkDN"}

package/utils/morgan-stream.d.ts

@@ -0,0 +1,11 @@
+export let morganStream: ConsoleLogStream;
+/**
+ * @private
+ * A stream that uses logger to write log lines
+ */
+declare class ConsoleLogStream extends Writable {
+    write(line: any): void;
+}
+import { Writable } from "stream";
+export {};
+//# sourceMappingURL=morgan-stream.d.ts.map

package/utils/morgan-stream.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"morgan-stream.d.ts","sourceRoot":"","sources":["../../src/utils/morgan-stream.js"],"names":[],"mappings":"AAoBA,0CAAyC;AAVzC;;;GAGG;AACH;IACI,uBAEC;CACJ"}

package/utils/ssr-cache.d.ts

@@ -0,0 +1,112 @@
+/**
+ * @module progressive-web-sdk/utils/ssr-cache
+ */
+/**
+ * A cache implementation.
+ *
+ * See the get, put and delete methods for more details.
+ */
+export class PersistentCache {
+    _cacheDeletePromise: Promise<void>;
+    /**
+     * Provided for testing purposes. Calling close() will
+     * clean up any locally cached data.
+     * @private
+     */
+    private close;
+    /**
+     * Return an object that represents an entry not found in the cache
+     * @param key
+     * @param namespace {String|string[]}
+     * @returns {Object}
+     * @private
+     */
+    private _notFound;
+    /**
+     * Get a JavaScript object from the cache.
+     *
+     * The returned Promise will resolve either to null if there is no
+     * match in the cache, or to an object with the following
+     * properties: 'found' is a boolean that is true if the item was found
+     * in the cache, 'false' if not, 'data' is the data for the object
+     * (or undefined if the object was not found), 'metadata' is the metadata
+     * object passed to put() (or undefined if the object was not found),
+     * 'expiration' is a JS date/timestamp representing the time at which the
+     * item will expire from the cache, 'key' is the item's cache
+     * key, and 'namespace' is the item's cache namespace.
+     *
+     * If the value passed to 'put' was a Buffer, then 'data' will
+     * be a Buffer. If the value passed to 'put' was anything else,
+     * it will have been deserialized from JSON, and will be whatever
+     * type was originally passed in.
+     *
+     * If an object is in the cache under the given key, each call to this
+     * method will return a separate copy of the object.
+     *
+     * If the object is NOT in the cache, this method will return an object
+     * with 'found' set to false. This allows a then() handler to use object
+     * deconstruction on the result.
+     *
+     * Within the cache, items under the same key but in different namespaces
+     * are distinct. The default namespace is undefined.
+     *
+     * @param [namespace] {String|string[]} the cache namespace
+     * @param key {String} the cache key
+     * @returns {Promise<*>} A Promise that will resolve to the
+     * cache result, or null if there is no match in the cache.
+     */
+    get({ key, namespace }?: string | string[] | undefined): Promise<any>;
+    /**
+     * Store a JavaScript object in the cache.
+     *
+     * If the data to be stored is a Buffer, it's stored as-is. If
+     * it's any other type, it's serialized to JSON and the JSON is
+     * stored. If the data is not JSON-serializable, then this method
+     * will throw an error.
+     *
+     * A primary use-case for this cache is storing HTTP responses,
+     * which include a status code, headers and a body. The body is
+     * typically most efficiently stored as a Buffer. Passing an object
+     * to 'data' that has a Buffer value will result in the Buffer being
+     * JSON-encoded, which is slow and takes up much more space than the
+     * origin data. The recommended way to store a response is to include
+     * the status and headers in the item's metadata, and to pass the body
+     * as a Buffer.
+     *
+     * If an expiration date/timestamp is given, the data will expire
+     * from the cache at that time. If no date/timestamp is given,
+     * the default expiration is one year from the time that the data is
+     * stored.
+     *
+     * Within the cache, items under the same key but in different namespaces
+     * are distinct. The default namespace is undefined.
+     *
+     * If put() is called to store metdata but no data, you should pass
+     * undefined for 'data'.
+     *
+     * @param key {String} the cache key.
+     * @param [namespace] {String|string[]} the cache namespace
+     * @param data {Buffer|*} the data to be stored.
+     * @param [metadata] {Object} a simple JS object with keys and values
+     * for metadata. This object MUST be JSON-seralizable.
+     * @param [expiration] {Number} the expiration date/time for the data,
+     * as a JS date/timestamp (the result of Date.getTime). If the expiration
+     * is less than PersistentCache.DELTA_THRESHOLD (midnight on January 1st, 1980)
+     * it is interpreted as a delta number of mS to be added to the current time.
+     * This allows for deltas up to ten years.
+     * @returns {Promise<*>} resolves when data has been stored, or rejects
+     * on an error
+     */
+    put(): Promise<any>;
+    /**
+     * Remove a single entry from the cache.
+     * @param key {String} the cache key
+     * @param [namespace] {String|string[]} the cache namespace
+     * @returns {Promise.<*>} resolves when delete is complete
+     */
+    delete(): Promise<any>;
+}
+export namespace PersistentCache {
+    const DELTA_THRESHOLD: number;
+}
+//# sourceMappingURL=ssr-cache.d.ts.map

package/utils/ssr-cache.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-cache.d.ts","sourceRoot":"","sources":["../../src/utils/ssr-cache.js"],"names":[],"mappings":"AAMA;;GAEG;AAEH;;;;GAIG;AACH;IA4BQ,mCAA4C;IAGhD;;;;OAIG;IACH,cAEC;IAED;;;;;;OAMG;IACH,kBAQC;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAgCG;IACH,yDAHa,YAAU,CAKtB;IAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;OAwCG;IACH,OAHa,YAAU,CAKtB;IAED;;;;;OAKG;IACH,UAFa,YAAW,CAIvB;CACJ"}

package/utils/ssr-config.client.d.ts

@@ -0,0 +1,2 @@
+export function getConfig(): any;
+//# sourceMappingURL=ssr-config.client.d.ts.map

package/utils/ssr-config.client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"ssr-config.client.d.ts","sourceRoot":"","sources":["../../src/utils/ssr-config.client.js"],"names":[],"mappings":"AAaO,iCAEN"}

package/utils/ssr-config.client.test.js

@@ -1,12 +1,16 @@
 "use strict";
 
 var _ssrConfig = require("./ssr-config.client");
+/**
+ * @jest-environment jsdom
+ */
 /*
  * Copyright (c) 2023, 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
  */
+/* eslint-disable header/header */
 
 let windowSpy;
 beforeEach(() => {

package/utils/ssr-config.d.ts

@@ -0,0 +1,3 @@
+declare const _exports: typeof import("./ssr-config.client.js") | typeof import("./ssr-config.server.js");
+export = _exports;
+//# sourceMappingURL=ssr-config.d.ts.map

package/utils/ssr-config.d.ts.map

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