@salesforce/webapp-experimental 1.8.1 → 1.10.0

package/dist/app/manifest.d.ts

@@ -4,6 +4,7 @@
  * For full license text, see the LICENSE.txt file
  */
 export interface WebAppManifest {
+    name?: string;
     outputDir: string;
     routing?: RoutingConfig;
 }

package/dist/app/manifest.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/app/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,cAAc;IAE9B,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB;AAGD,MAAM,WAAW,aAAa;IAE7B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAE3B,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAE5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,WAAW;IAE3B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,YAAY;IAE5B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,UAAU,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAClC;AAsBD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAchF"}
+{"version":3,"file":"manifest.d.ts","sourceRoot":"","sources":["../../src/app/manifest.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAKH,MAAM,WAAW,cAAc;IAE9B,IAAI,CAAC,EAAE,MAAM,CAAC;IAEd,SAAS,EAAE,MAAM,CAAC;IAElB,OAAO,CAAC,EAAE,aAAa,CAAC;CACxB;AAGD,MAAM,WAAW,aAAa;IAE7B,QAAQ,CAAC,EAAE,WAAW,EAAE,CAAC;IAEzB,SAAS,CAAC,EAAE,YAAY,EAAE,CAAC;IAE3B,aAAa,CAAC,EAAE,QAAQ,GAAG,OAAO,GAAG,MAAM,CAAC;IAE5C,QAAQ,CAAC,EAAE,MAAM,CAAC;CAClB;AAGD,MAAM,WAAW,WAAW;IAE3B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;CACf;AAGD,MAAM,WAAW,YAAY;IAE5B,KAAK,EAAE,MAAM,CAAC;IAEd,MAAM,EAAE,MAAM,CAAC;IAEf,UAAU,EAAE,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,GAAG,CAAC;CAClC;AAsBD;;;;;;GAMG;AACH,wBAAsB,YAAY,CAAC,YAAY,EAAE,MAAM,GAAG,OAAO,CAAC,cAAc,CAAC,CAchF"}

package/dist/proxy/handler.d.ts

@@ -5,6 +5,14 @@
  */
 import type { IncomingMessage, ServerResponse } from "node:http";
 import type { OrgInfo, WebAppManifest } from "../app/index.js";
+/**
+ * URL parameter to trigger health check response
+ */
+export declare const WEBAPP_HEALTH_CHECK_PARAM = "sfProxyHealthCheck";
+/**
+ * Response header indicating the proxy is active
+ */
+export declare const WEBAPP_PROXY_HEADER = "X-Salesforce-WebApp-Proxy";
 /**
  * Configuration options for the WebApp proxy handler
  */

package/dist/proxy/handler.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/proxy/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAEjE,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAG/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAE5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAC1B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,CAAC,EAAE,MAAM,IAAI,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;AA+SnB;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,GACpB,YAAY,CAGd"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/proxy/handler.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,OAAO,KAAK,EAAE,eAAe,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC;AAGjE,OAAO,KAAK,EAAE,OAAO,EAAE,cAAc,EAAE,MAAM,iBAAiB,CAAC;AAM/D;;GAEG;AACH,eAAO,MAAM,yBAAyB,uBAAuB,CAAC;AAE9D;;GAEG;AACH,eAAO,MAAM,mBAAmB,8BAA8B,CAAC;AAE/D;;GAEG;AACH,MAAM,WAAW,YAAY;IAE5B,KAAK,CAAC,EAAE,OAAO,CAAC;IAEhB,cAAc,CAAC,EAAE,CAAC,cAAc,EAAE,OAAO,KAAK,IAAI,CAAC;CACnD;AAED;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,CAC1B,GAAG,EAAE,eAAe,EACpB,GAAG,EAAE,cAAc,EACnB,IAAI,CAAC,EAAE,MAAM,IAAI,KACb,OAAO,CAAC,IAAI,CAAC,CAAC;AA6UnB;;;;;;;;GAQG;AACH,wBAAgB,kBAAkB,CACjC,QAAQ,EAAE,cAAc,EACxB,OAAO,CAAC,EAAE,OAAO,EACjB,MAAM,CAAC,EAAE,MAAM,EACf,QAAQ,CAAC,EAAE,MAAM,EACjB,OAAO,CAAC,EAAE,YAAY,GACpB,YAAY,CAGd"}

package/dist/proxy/handler.js

@@ -3,8 +3,19 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
+import { createRequire } from "node:module";
 import { applyTrailingSlash, matchRoute } from "./routing.js";
 import { refreshOrgAuth } from "../app/index.js";
+const require = createRequire(import.meta.url);
+const { version: proxyVersion } = require("../../package.json");
+/**
+ * URL parameter to trigger health check response
+ */
+export const WEBAPP_HEALTH_CHECK_PARAM = "sfProxyHealthCheck";
+/**
+ * Response header indicating the proxy is active
+ */
+export const WEBAPP_PROXY_HEADER = "X-Salesforce-WebApp-Proxy";
 /**
  * Handles all proxy routing and forwarding for WebApps
  */
@@ -14,6 +25,7 @@ class WebAppProxyHandler {
     target;
     basePath;
     options;
+    startTime = Date.now();
     constructor(manifest, orgInfo, target, basePath, options) {
         this.manifest = manifest;
         this.orgInfo = orgInfo;
@@ -23,6 +35,11 @@ class WebAppProxyHandler {
     }
     async handle(req, res, next) {
         const url = new URL(req.url ?? "/", `http://${req.headers.host}`);
+        // Health check via URL parameter - respond immediately
+        if (url.searchParams.get(WEBAPP_HEALTH_CHECK_PARAM) === "true") {
+            this.handleHealthCheck(res);
+            return;
+        }
         let pathname = url.pathname;
         if (this.options?.debug) {
             console.log(`[webapps-proxy] ${req.method} ${pathname}`);
@@ -61,6 +78,25 @@ class WebAppProxyHandler {
         res.writeHead(statusCode, { Location: location });
         res.end();
     }
+    handleHealthCheck(res) {
+        const response = {
+            proxyName: "@salesforce/webapp-experimental",
+            proxyVersion,
+            port: this.target ? new URL(this.target).port : undefined,
+            org: this.orgInfo?.orgAlias ?? this.orgInfo?.username,
+            apiVersion: this.orgInfo?.apiVersion,
+            webappName: this.manifest.name,
+            webappFolderPath: this.basePath,
+            uptime: Date.now() - this.startTime,
+            timestamp: new Date().toISOString(),
+            debugMode: this.options?.debug ?? false,
+        };
+        res.writeHead(200, {
+            "Content-Type": "application/json",
+            [WEBAPP_PROXY_HEADER]: "true",
+        });
+        res.end(JSON.stringify(response, null, 2));
+    }
     sendNoOrgError(res) {
         res.writeHead(401, { "Content-Type": "application/json" });
         res.end(JSON.stringify({

package/dist/proxy/index.d.ts

@@ -4,5 +4,5 @@
  * For full license text, see the LICENSE.txt file
  */
 export type { ProxyOptions, ProxyHandler } from "./handler.js";
-export { createProxyHandler } from "./handler.js";
+export { createProxyHandler, WEBAPP_HEALTH_CHECK_PARAM, WEBAPP_PROXY_HEADER } from "./handler.js";
 //# sourceMappingURL=index.d.ts.map

package/dist/proxy/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,MAAM,cAAc,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/proxy/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAEH,YAAY,EAAE,YAAY,EAAE,YAAY,EAAE,MAAM,cAAc,CAAC;AAC/D,OAAO,EAAE,kBAAkB,EAAE,yBAAyB,EAAE,mBAAmB,EAAE,MAAM,cAAc,CAAC"}

package/dist/proxy/index.js

@@ -3,4 +3,4 @@
  * All rights reserved.
  * For full license text, see the LICENSE.txt file
  */
-export { createProxyHandler } from "./handler.js";
+export { createProxyHandler, WEBAPP_HEALTH_CHECK_PARAM, WEBAPP_PROXY_HEADER } from "./handler.js";

package/package.json

@@ -1,7 +1,7 @@
 {
   "name": "@salesforce/webapp-experimental",
   "description": "[experimental] Core package for Salesforce Web Applications",
-  "version": "1.8.1",
+  "version": "1.10.0",
   "license": "SEE LICENSE IN LICENSE.txt",
   "type": "module",
   "main": "./dist/index.js",
@@ -54,5 +54,5 @@
   "publishConfig": {
     "access": "public"
   },
-  "gitHead": "b5c1d465570de3857bf4036ec055e1d8556c4612"
+  "gitHead": "841b3229286b09a45f6f98af1674dc6edaab6807"
 }