@openhi/constructs 0.0.115 → 0.0.116

package/lib/static-hosting.viewer-request-handler.d.mts

@@ -0,0 +1,54 @@
+import { CloudFrontRequest, CloudFrontRequestEvent } from 'aws-lambda';
+
+/**
+ * @see sites/www-docs/content/packages/@openhi/constructs/components/static-hosting/static-hosting.viewer-request-handler.md
+ */
+/**
+ * Hosting mode controls how path-like URIs get a default document.
+ *
+ * - `spa`: path-like URIs (e.g. `/dashboard`, `/patients/123`) rewrite to
+ *   `/index.html` so the single-page app's root index is served and the
+ *   client-side router handles the path.
+ * - `static`: path-like URIs append `/index.html` (e.g. `/docs` becomes
+ *   `/docs/index.html`) so multi-page static sites can serve distinct
+ *   HTML per path.
+ */
+type HostingMode = "spa" | "static";
+/**
+ * Viewer Request Handler for SPA mode.
+ *
+ * - Logs the request
+ * - Rewrites path-like URIs to `/index.html`
+ * - Prepends the Host header as a folder for multi-tenant routing
+ */
+declare const spaHandler: (event: CloudFrontRequestEvent) => Promise<CloudFrontRequest>;
+/**
+ * Viewer Request Handler for static (non-SPA) mode.
+ *
+ * - Logs the request
+ * - Rewrites path-like URIs to `<path>/index.html`
+ * - Prepends the Host header as a folder for multi-tenant routing
+ */
+declare const staticHandler: (event: CloudFrontRequestEvent) => Promise<CloudFrontRequest>;
+/**
+ * Adds a default document to the request URI based on the hosting mode.
+ *
+ * In both modes:
+ * - `/` and `/index.html` become `/index.html`
+ * - URIs whose last segment contains a dot are treated as static files and
+ *   left unchanged.
+ *
+ * In `spa` mode, all other path-like URIs rewrite to `/index.html`.
+ * In `static` mode, path-like URIs append `/index.html` (trailing slash
+ * preserved as a single slash): `/docs` and `/docs/` both become
+ * `/docs/index.html`.
+ */
+declare const addDefaultDocument: (request: CloudFrontRequest, mode: HostingMode) => CloudFrontRequest;
+/**
+ * Prepends the Host header as a folder to the request URI. Used for
+ * multi-tenant routing where each domain maps to a folder in the S3
+ * bucket (e.g. `example.com/foo` -> `/example.com/foo`).
+ */
+declare const addDomainFolder: (request: CloudFrontRequest) => CloudFrontRequest;
+
+export { type HostingMode, addDefaultDocument, addDomainFolder, spaHandler, staticHandler };

package/lib/static-hosting.viewer-request-handler.d.ts

@@ -0,0 +1,54 @@
+import { CloudFrontRequest, CloudFrontRequestEvent } from 'aws-lambda';
+
+/**
+ * @see sites/www-docs/content/packages/@openhi/constructs/components/static-hosting/static-hosting.viewer-request-handler.md
+ */
+/**
+ * Hosting mode controls how path-like URIs get a default document.
+ *
+ * - `spa`: path-like URIs (e.g. `/dashboard`, `/patients/123`) rewrite to
+ *   `/index.html` so the single-page app's root index is served and the
+ *   client-side router handles the path.
+ * - `static`: path-like URIs append `/index.html` (e.g. `/docs` becomes
+ *   `/docs/index.html`) so multi-page static sites can serve distinct
+ *   HTML per path.
+ */
+type HostingMode = "spa" | "static";
+/**
+ * Viewer Request Handler for SPA mode.
+ *
+ * - Logs the request
+ * - Rewrites path-like URIs to `/index.html`
+ * - Prepends the Host header as a folder for multi-tenant routing
+ */
+declare const spaHandler: (event: CloudFrontRequestEvent) => Promise<CloudFrontRequest>;
+/**
+ * Viewer Request Handler for static (non-SPA) mode.
+ *
+ * - Logs the request
+ * - Rewrites path-like URIs to `<path>/index.html`
+ * - Prepends the Host header as a folder for multi-tenant routing
+ */
+declare const staticHandler: (event: CloudFrontRequestEvent) => Promise<CloudFrontRequest>;
+/**
+ * Adds a default document to the request URI based on the hosting mode.
+ *
+ * In both modes:
+ * - `/` and `/index.html` become `/index.html`
+ * - URIs whose last segment contains a dot are treated as static files and
+ *   left unchanged.
+ *
+ * In `spa` mode, all other path-like URIs rewrite to `/index.html`.
+ * In `static` mode, path-like URIs append `/index.html` (trailing slash
+ * preserved as a single slash): `/docs` and `/docs/` both become
+ * `/docs/index.html`.
+ */
+declare const addDefaultDocument: (request: CloudFrontRequest, mode: HostingMode) => CloudFrontRequest;
+/**
+ * Prepends the Host header as a folder to the request URI. Used for
+ * multi-tenant routing where each domain maps to a folder in the S3
+ * bucket (e.g. `example.com/foo` -> `/example.com/foo`).
+ */
+declare const addDomainFolder: (request: CloudFrontRequest) => CloudFrontRequest;
+
+export { type HostingMode, addDefaultDocument, addDomainFolder, spaHandler, staticHandler };

package/lib/static-hosting.viewer-request-handler.js

@@ -0,0 +1,79 @@
+"use strict";
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __export = (target, all) => {
+  for (var name in all)
+    __defProp(target, name, { get: all[name], enumerable: true });
+};
+var __copyProps = (to, from, except, desc) => {
+  if (from && typeof from === "object" || typeof from === "function") {
+    for (let key of __getOwnPropNames(from))
+      if (!__hasOwnProp.call(to, key) && key !== except)
+        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
+  }
+  return to;
+};
+var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+
+// src/components/static-hosting/static-hosting.viewer-request-handler.ts
+var static_hosting_viewer_request_handler_exports = {};
+__export(static_hosting_viewer_request_handler_exports, {
+  addDefaultDocument: () => addDefaultDocument,
+  addDomainFolder: () => addDomainFolder,
+  spaHandler: () => spaHandler,
+  staticHandler: () => staticHandler
+});
+module.exports = __toCommonJS(static_hosting_viewer_request_handler_exports);
+var isTestEnv = process.env.JEST_WORKER_ID !== void 0;
+var spaHandler = async (event) => {
+  return runHandler(event, "spa");
+};
+var staticHandler = async (event) => {
+  return runHandler(event, "static");
+};
+var runHandler = async (event, mode) => {
+  if (!isTestEnv) {
+    console.log("Request Event: ", JSON.stringify(event, null, 2));
+  }
+  let request = event.Records[0].cf.request;
+  request = addDefaultDocument(request, mode);
+  request = addDomainFolder(request);
+  if (!isTestEnv) {
+    console.log("Resulting Request: ", JSON.stringify(request, null, 2));
+  }
+  return request;
+};
+var addDefaultDocument = (request, mode) => {
+  if (request.uri === "/" || request.uri === "/index.html") {
+    request.uri = "/index.html";
+    return request;
+  }
+  const segments = request.uri.split("/").filter(Boolean);
+  const lastSegment = segments[segments.length - 1] ?? "";
+  const looksLikeStaticFile = lastSegment.includes(".");
+  if (looksLikeStaticFile) {
+    return request;
+  }
+  if (mode === "spa") {
+    request.uri = "/index.html";
+    return request;
+  }
+  const normalized = request.uri.endsWith("/") ? request.uri.slice(0, -1) : request.uri;
+  request.uri = `${normalized}/index.html`;
+  return request;
+};
+var addDomainFolder = (request) => {
+  const hostHeader = request.headers.host[0].value;
+  request.uri = `/${hostHeader}${request.uri}`;
+  return request;
+};
+// Annotate the CommonJS export names for ESM import in node:
+0 && (module.exports = {
+  addDefaultDocument,
+  addDomainFolder,
+  spaHandler,
+  staticHandler
+});
+//# sourceMappingURL=static-hosting.viewer-request-handler.js.map

package/lib/static-hosting.viewer-request-handler.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/static-hosting/static-hosting.viewer-request-handler.ts"],"sourcesContent":["import { CloudFrontRequest, CloudFrontRequestEvent } from \"aws-lambda\";\n\n/**\n * @see sites/www-docs/content/packages/@openhi/constructs/components/static-hosting/static-hosting.viewer-request-handler.md\n */\n\n/**\n * Hosting mode controls how path-like URIs get a default document.\n *\n * - `spa`: path-like URIs (e.g. `/dashboard`, `/patients/123`) rewrite to\n *   `/index.html` so the single-page app's root index is served and the\n *   client-side router handles the path.\n * - `static`: path-like URIs append `/index.html` (e.g. `/docs` becomes\n *   `/docs/index.html`) so multi-page static sites can serve distinct\n *   HTML per path.\n */\nexport type HostingMode = \"spa\" | \"static\";\n\nconst isTestEnv = process.env.JEST_WORKER_ID !== undefined;\n\n/**\n * Viewer Request Handler for SPA mode.\n *\n * - Logs the request\n * - Rewrites path-like URIs to `/index.html`\n * - Prepends the Host header as a folder for multi-tenant routing\n */\nexport const spaHandler = async (\n  event: CloudFrontRequestEvent,\n): Promise<CloudFrontRequest> => {\n  return runHandler(event, \"spa\");\n};\n\n/**\n * Viewer Request Handler for static (non-SPA) mode.\n *\n * - Logs the request\n * - Rewrites path-like URIs to `<path>/index.html`\n * - Prepends the Host header as a folder for multi-tenant routing\n */\nexport const staticHandler = async (\n  event: CloudFrontRequestEvent,\n): Promise<CloudFrontRequest> => {\n  return runHandler(event, \"static\");\n};\n\nconst runHandler = async (\n  event: CloudFrontRequestEvent,\n  mode: HostingMode,\n): Promise<CloudFrontRequest> => {\n  if (!isTestEnv) {\n    console.log(\"Request Event: \", JSON.stringify(event, null, 2));\n  }\n\n  let request = event.Records[0].cf.request;\n\n  // add index if needed\n  request = addDefaultDocument(request, mode);\n\n  // prepend folder with domain\n  request = addDomainFolder(request);\n\n  if (!isTestEnv) {\n    console.log(\"Resulting Request: \", JSON.stringify(request, null, 2));\n  }\n\n  return request;\n};\n\n/**\n * Adds a default document to the request URI based on the hosting mode.\n *\n * In both modes:\n * - `/` and `/index.html` become `/index.html`\n * - URIs whose last segment contains a dot are treated as static files and\n *   left unchanged.\n *\n * In `spa` mode, all other path-like URIs rewrite to `/index.html`.\n * In `static` mode, path-like URIs append `/index.html` (trailing slash\n * preserved as a single slash): `/docs` and `/docs/` both become\n * `/docs/index.html`.\n */\nexport const addDefaultDocument = (\n  request: CloudFrontRequest,\n  mode: HostingMode,\n) => {\n  if (request.uri === \"/\" || request.uri === \"/index.html\") {\n    request.uri = \"/index.html\";\n    return request;\n  }\n\n  const segments = request.uri.split(\"/\").filter(Boolean);\n  const lastSegment = segments[segments.length - 1] ?? \"\";\n  const looksLikeStaticFile = lastSegment.includes(\".\");\n\n  if (looksLikeStaticFile) {\n    return request;\n  }\n\n  if (mode === \"spa\") {\n    request.uri = \"/index.html\";\n    return request;\n  }\n\n  // static mode: append /index.html to the path, collapsing any trailing slash\n  const normalized = request.uri.endsWith(\"/\")\n    ? request.uri.slice(0, -1)\n    : request.uri;\n  request.uri = `${normalized}/index.html`;\n  return request;\n};\n\n/**\n * Prepends the Host header as a folder to the request URI. Used for\n * multi-tenant routing where each domain maps to a folder in the S3\n * bucket (e.g. `example.com/foo` -> `/example.com/foo`).\n */\nexport const addDomainFolder = (request: CloudFrontRequest) => {\n  const hostHeader = request.headers.host[0].value;\n  request.uri = `/${hostHeader}${request.uri}`;\n  return request;\n};\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAkBA,IAAM,YAAY,QAAQ,IAAI,mBAAmB;AAS1C,IAAM,aAAa,OACxB,UAC+B;AAC/B,SAAO,WAAW,OAAO,KAAK;AAChC;AASO,IAAM,gBAAgB,OAC3B,UAC+B;AAC/B,SAAO,WAAW,OAAO,QAAQ;AACnC;AAEA,IAAM,aAAa,OACjB,OACA,SAC+B;AAC/B,MAAI,CAAC,WAAW;AACd,YAAQ,IAAI,mBAAmB,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AAAA,EAC/D;AAEA,MAAI,UAAU,MAAM,QAAQ,CAAC,EAAE,GAAG;AAGlC,YAAU,mBAAmB,SAAS,IAAI;AAG1C,YAAU,gBAAgB,OAAO;AAEjC,MAAI,CAAC,WAAW;AACd,YAAQ,IAAI,uBAAuB,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAAA,EACrE;AAEA,SAAO;AACT;AAeO,IAAM,qBAAqB,CAChC,SACA,SACG;AACH,MAAI,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,eAAe;AACxD,YAAQ,MAAM;AACd,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,QAAQ,IAAI,MAAM,GAAG,EAAE,OAAO,OAAO;AACtD,QAAM,cAAc,SAAS,SAAS,SAAS,CAAC,KAAK;AACrD,QAAM,sBAAsB,YAAY,SAAS,GAAG;AAEpD,MAAI,qBAAqB;AACvB,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,OAAO;AAClB,YAAQ,MAAM;AACd,WAAO;AAAA,EACT;AAGA,QAAM,aAAa,QAAQ,IAAI,SAAS,GAAG,IACvC,QAAQ,IAAI,MAAM,GAAG,EAAE,IACvB,QAAQ;AACZ,UAAQ,MAAM,GAAG,UAAU;AAC3B,SAAO;AACT;AAOO,IAAM,kBAAkB,CAAC,YAA+B;AAC7D,QAAM,aAAa,QAAQ,QAAQ,KAAK,CAAC,EAAE;AAC3C,UAAQ,MAAM,IAAI,UAAU,GAAG,QAAQ,GAAG;AAC1C,SAAO;AACT;","names":[]}

package/lib/static-hosting.viewer-request-handler.mjs

@@ -0,0 +1,53 @@
+import "./chunk-LZOMFHX3.mjs";
+
+// src/components/static-hosting/static-hosting.viewer-request-handler.ts
+var isTestEnv = process.env.JEST_WORKER_ID !== void 0;
+var spaHandler = async (event) => {
+  return runHandler(event, "spa");
+};
+var staticHandler = async (event) => {
+  return runHandler(event, "static");
+};
+var runHandler = async (event, mode) => {
+  if (!isTestEnv) {
+    console.log("Request Event: ", JSON.stringify(event, null, 2));
+  }
+  let request = event.Records[0].cf.request;
+  request = addDefaultDocument(request, mode);
+  request = addDomainFolder(request);
+  if (!isTestEnv) {
+    console.log("Resulting Request: ", JSON.stringify(request, null, 2));
+  }
+  return request;
+};
+var addDefaultDocument = (request, mode) => {
+  if (request.uri === "/" || request.uri === "/index.html") {
+    request.uri = "/index.html";
+    return request;
+  }
+  const segments = request.uri.split("/").filter(Boolean);
+  const lastSegment = segments[segments.length - 1] ?? "";
+  const looksLikeStaticFile = lastSegment.includes(".");
+  if (looksLikeStaticFile) {
+    return request;
+  }
+  if (mode === "spa") {
+    request.uri = "/index.html";
+    return request;
+  }
+  const normalized = request.uri.endsWith("/") ? request.uri.slice(0, -1) : request.uri;
+  request.uri = `${normalized}/index.html`;
+  return request;
+};
+var addDomainFolder = (request) => {
+  const hostHeader = request.headers.host[0].value;
+  request.uri = `/${hostHeader}${request.uri}`;
+  return request;
+};
+export {
+  addDefaultDocument,
+  addDomainFolder,
+  spaHandler,
+  staticHandler
+};
+//# sourceMappingURL=static-hosting.viewer-request-handler.mjs.map

package/lib/static-hosting.viewer-request-handler.mjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/components/static-hosting/static-hosting.viewer-request-handler.ts"],"sourcesContent":["import { CloudFrontRequest, CloudFrontRequestEvent } from \"aws-lambda\";\n\n/**\n * @see sites/www-docs/content/packages/@openhi/constructs/components/static-hosting/static-hosting.viewer-request-handler.md\n */\n\n/**\n * Hosting mode controls how path-like URIs get a default document.\n *\n * - `spa`: path-like URIs (e.g. `/dashboard`, `/patients/123`) rewrite to\n *   `/index.html` so the single-page app's root index is served and the\n *   client-side router handles the path.\n * - `static`: path-like URIs append `/index.html` (e.g. `/docs` becomes\n *   `/docs/index.html`) so multi-page static sites can serve distinct\n *   HTML per path.\n */\nexport type HostingMode = \"spa\" | \"static\";\n\nconst isTestEnv = process.env.JEST_WORKER_ID !== undefined;\n\n/**\n * Viewer Request Handler for SPA mode.\n *\n * - Logs the request\n * - Rewrites path-like URIs to `/index.html`\n * - Prepends the Host header as a folder for multi-tenant routing\n */\nexport const spaHandler = async (\n  event: CloudFrontRequestEvent,\n): Promise<CloudFrontRequest> => {\n  return runHandler(event, \"spa\");\n};\n\n/**\n * Viewer Request Handler for static (non-SPA) mode.\n *\n * - Logs the request\n * - Rewrites path-like URIs to `<path>/index.html`\n * - Prepends the Host header as a folder for multi-tenant routing\n */\nexport const staticHandler = async (\n  event: CloudFrontRequestEvent,\n): Promise<CloudFrontRequest> => {\n  return runHandler(event, \"static\");\n};\n\nconst runHandler = async (\n  event: CloudFrontRequestEvent,\n  mode: HostingMode,\n): Promise<CloudFrontRequest> => {\n  if (!isTestEnv) {\n    console.log(\"Request Event: \", JSON.stringify(event, null, 2));\n  }\n\n  let request = event.Records[0].cf.request;\n\n  // add index if needed\n  request = addDefaultDocument(request, mode);\n\n  // prepend folder with domain\n  request = addDomainFolder(request);\n\n  if (!isTestEnv) {\n    console.log(\"Resulting Request: \", JSON.stringify(request, null, 2));\n  }\n\n  return request;\n};\n\n/**\n * Adds a default document to the request URI based on the hosting mode.\n *\n * In both modes:\n * - `/` and `/index.html` become `/index.html`\n * - URIs whose last segment contains a dot are treated as static files and\n *   left unchanged.\n *\n * In `spa` mode, all other path-like URIs rewrite to `/index.html`.\n * In `static` mode, path-like URIs append `/index.html` (trailing slash\n * preserved as a single slash): `/docs` and `/docs/` both become\n * `/docs/index.html`.\n */\nexport const addDefaultDocument = (\n  request: CloudFrontRequest,\n  mode: HostingMode,\n) => {\n  if (request.uri === \"/\" || request.uri === \"/index.html\") {\n    request.uri = \"/index.html\";\n    return request;\n  }\n\n  const segments = request.uri.split(\"/\").filter(Boolean);\n  const lastSegment = segments[segments.length - 1] ?? \"\";\n  const looksLikeStaticFile = lastSegment.includes(\".\");\n\n  if (looksLikeStaticFile) {\n    return request;\n  }\n\n  if (mode === \"spa\") {\n    request.uri = \"/index.html\";\n    return request;\n  }\n\n  // static mode: append /index.html to the path, collapsing any trailing slash\n  const normalized = request.uri.endsWith(\"/\")\n    ? request.uri.slice(0, -1)\n    : request.uri;\n  request.uri = `${normalized}/index.html`;\n  return request;\n};\n\n/**\n * Prepends the Host header as a folder to the request URI. Used for\n * multi-tenant routing where each domain maps to a folder in the S3\n * bucket (e.g. `example.com/foo` -> `/example.com/foo`).\n */\nexport const addDomainFolder = (request: CloudFrontRequest) => {\n  const hostHeader = request.headers.host[0].value;\n  request.uri = `/${hostHeader}${request.uri}`;\n  return request;\n};\n"],"mappings":";;;AAkBA,IAAM,YAAY,QAAQ,IAAI,mBAAmB;AAS1C,IAAM,aAAa,OACxB,UAC+B;AAC/B,SAAO,WAAW,OAAO,KAAK;AAChC;AASO,IAAM,gBAAgB,OAC3B,UAC+B;AAC/B,SAAO,WAAW,OAAO,QAAQ;AACnC;AAEA,IAAM,aAAa,OACjB,OACA,SAC+B;AAC/B,MAAI,CAAC,WAAW;AACd,YAAQ,IAAI,mBAAmB,KAAK,UAAU,OAAO,MAAM,CAAC,CAAC;AAAA,EAC/D;AAEA,MAAI,UAAU,MAAM,QAAQ,CAAC,EAAE,GAAG;AAGlC,YAAU,mBAAmB,SAAS,IAAI;AAG1C,YAAU,gBAAgB,OAAO;AAEjC,MAAI,CAAC,WAAW;AACd,YAAQ,IAAI,uBAAuB,KAAK,UAAU,SAAS,MAAM,CAAC,CAAC;AAAA,EACrE;AAEA,SAAO;AACT;AAeO,IAAM,qBAAqB,CAChC,SACA,SACG;AACH,MAAI,QAAQ,QAAQ,OAAO,QAAQ,QAAQ,eAAe;AACxD,YAAQ,MAAM;AACd,WAAO;AAAA,EACT;AAEA,QAAM,WAAW,QAAQ,IAAI,MAAM,GAAG,EAAE,OAAO,OAAO;AACtD,QAAM,cAAc,SAAS,SAAS,SAAS,CAAC,KAAK;AACrD,QAAM,sBAAsB,YAAY,SAAS,GAAG;AAEpD,MAAI,qBAAqB;AACvB,WAAO;AAAA,EACT;AAEA,MAAI,SAAS,OAAO;AAClB,YAAQ,MAAM;AACd,WAAO;AAAA,EACT;AAGA,QAAM,aAAa,QAAQ,IAAI,SAAS,GAAG,IACvC,QAAQ,IAAI,MAAM,GAAG,EAAE,IACvB,QAAQ;AACZ,UAAQ,MAAM,GAAG,UAAU;AAC3B,SAAO;AACT;AAOO,IAAM,kBAAkB,CAAC,YAA+B;AAC7D,QAAM,aAAa,QAAQ,QAAQ,KAAK,CAAC,EAAE;AAC3C,UAAQ,MAAM,IAAI,UAAU,GAAG,QAAQ,GAAG;AAC1C,SAAO;AACT;","names":[]}

package/package.json

@@ -55,8 +55,8 @@
     "pg": "^8.20.0",
     "type-fest": "^4",
     "ulid": "^3.0.2",
-    "@openhi/config": "0.0.0",
     "@openhi/workflows": "0.0.0",
+    "@openhi/config": "0.0.0",
     "@openhi/types": "0.0.0"
   },
   "devEngines": {
@@ -71,7 +71,7 @@
   "publishConfig": {
     "access": "public"
   },
-  "version": "0.0.115",
+  "version": "0.0.116",
   "types": "lib/index.d.ts",
   "//": "~~ Generated by projen. To modify, edit .projenrc.js and run \"pnpm exec projen\".",
   "scripts": {