@trackunit/iris-app-build-utilities 1.12.72 → 1.12.73

package/CHANGELOG.md

@@ -1,3 +1,10 @@
+## 1.12.73 (2026-03-12)
+
+### 🧱 Updated Dependencies
+
+- Updated iris-app-api to 1.14.67
+- Updated shared-utils to 1.13.64
+
 ## 1.12.72 (2026-03-11)
 
 ### 🧱 Updated Dependencies

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@trackunit/iris-app-build-utilities",
-  "version": "1.12.72",
+  "version": "1.12.73",
   "license": "SEE LICENSE IN LICENSE.txt",
   "repository": "https://github.com/Trackunit/manager",
   "engines": {
@@ -15,9 +15,9 @@
     "tslib": "^2.6.2",
     "csp-header": "^5.2.1",
     "@rspack/core": "1.6.7",
-    "@trackunit/iris-app-api": "1.14.66",
+    "@trackunit/iris-app-api": "1.14.67",
     "@nx/devkit": "22.4.4",
-    "@trackunit/shared-utils": "1.13.63",
+    "@trackunit/shared-utils": "1.13.64",
     "http-proxy-middleware": "3.0.5",
     "pacote": "^21.0.4",
     "semver": "7.5.4"

package/src/createInvokeProxyMiddleware.d.ts

@@ -1,5 +1,5 @@
 import type { IncomingMessage, ServerResponse } from "node:http";
-import type { ServerlessPortMap } from "./spawnServerlessExtensions";
+import type { ServersidePortMap } from "./spawnServersideExtensions";
 type MiddlewareRequest = IncomingMessage & {
     originalUrl?: string;
 };
@@ -7,7 +7,7 @@ type MiddlewareResponse = ServerResponse<IncomingMessage>;
 type MiddlewareNext = () => void;
 type ProxyHandler = (req: MiddlewareRequest, res: MiddlewareResponse, next: MiddlewareNext) => void;
 /**
- * Creates /invoke middleware that routes to local serverless processes when available.
+ * Creates /invoke middleware that routes to local serverside processes when available.
  */
-export declare const createInvokeProxyMiddleware: (serverlessPortMap: ServerlessPortMap | undefined) => ProxyHandler;
+export declare const createInvokeProxyMiddleware: (serversidePortMap: ServersidePortMap | undefined) => ProxyHandler;
 export {};

package/src/createInvokeProxyMiddleware.js

@@ -24,7 +24,7 @@ const createLocalExtensionProxy = (target, extensionId) => {
                 (0, consoleUtils_1.logError)(`[Proxy] Error proxying to ${extensionId}: ${err.message}`);
                 if ("writeHead" in proxyRes && "end" in proxyRes) {
                     proxyRes.writeHead(502, { "Content-Type": "application/json" });
-                    proxyRes.end(JSON.stringify({ error: `Serverless extension ${extensionId} unavailable` }));
+                    proxyRes.end(JSON.stringify({ error: `Serverside extension ${extensionId} unavailable` }));
                 }
             },
         },
@@ -44,15 +44,15 @@ const getOrCreateLocalProxy = (cache, extensionId, port) => {
     return newProxy;
 };
 /**
- * Creates /invoke middleware that routes to local serverless processes when available.
+ * Creates /invoke middleware that routes to local serverside processes when available.
  */
-const createInvokeProxyMiddleware = (serverlessPortMap) => {
+const createInvokeProxyMiddleware = (serversidePortMap) => {
     const localProxyCache = new Map();
     const remoteProxy = createRemoteIrisProxy();
     return (req, res, next) => {
         const fullPath = req.originalUrl ?? `/invoke${req.url ?? ""}`;
         const extensionId = (0, devServerUtils_1.parseExtensionIdFromPath)(fullPath);
-        const localPort = (0, devServerUtils_1.getLocalPort)(extensionId, serverlessPortMap);
+        const localPort = (0, devServerUtils_1.getLocalPort)(extensionId, serversidePortMap);
         if (localPort !== undefined && extensionId !== undefined) {
             const endpointPath = (0, devServerUtils_1.extractEndpointPath)(fullPath);
             (0, consoleUtils_1.logInfo)(`[Proxy] ${fullPath} -> ${(0, devServerUtils_1.buildLocalTarget)(localPort)}${endpointPath}`);

package/src/devServerUtils.d.ts

@@ -50,10 +50,10 @@ export declare const getOrigin: (headers: {
  * Determines if a request should be routed to a local extension.
  *
  * @param extensionId - The parsed extension ID
- * @param serverlessPortMap - Map of extension IDs to local ports
+ * @param serversidePortMap - Map of extension IDs to local ports
  * @returns {number | undefined} The local port if available, undefined otherwise
  */
-export declare const getLocalPort: (extensionId: string | undefined, serverlessPortMap: Map<string, number> | undefined) => number | undefined;
+export declare const getLocalPort: (extensionId: string | undefined, serversidePortMap: Map<string, number> | undefined) => number | undefined;
 /**
  * Builds the local proxy target URL.
  *

package/src/devServerUtils.js

@@ -66,14 +66,14 @@ exports.getOrigin = getOrigin;
  * Determines if a request should be routed to a local extension.
  *
  * @param extensionId - The parsed extension ID
- * @param serverlessPortMap - Map of extension IDs to local ports
+ * @param serversidePortMap - Map of extension IDs to local ports
  * @returns {number | undefined} The local port if available, undefined otherwise
  */
-const getLocalPort = (extensionId, serverlessPortMap) => {
+const getLocalPort = (extensionId, serversidePortMap) => {
     if (extensionId === undefined) {
         return undefined;
     }
-    return serverlessPortMap?.get(extensionId);
+    return serversidePortMap?.get(extensionId);
 };
 exports.getLocalPort = getLocalPort;
 /**

package/src/getIrisAppDevServer.d.ts

@@ -1,8 +1,8 @@
 import type { DevServer as RspackDevServer } from "@rspack/core";
 import type { Configuration as WebpackDevServerConfiguration } from "webpack-dev-server";
-import type { ServerlessPortMap } from "./spawnServerlessExtensions";
+import type { ServersidePortMap } from "./spawnServersideExtensions";
 export interface DevServerOptions {
-    serverlessPortMap?: ServerlessPortMap;
+    serversidePortMap?: ServersidePortMap;
 }
 /** Generates a dev server configuration for webpack. */
 export declare const getIrisAppWebpackDevServer: (webpackDevServerConfiguration?: WebpackDevServerConfiguration, options?: DevServerOptions) => Promise<WebpackDevServerConfiguration>;

package/src/getIrisAppDevServer.js

@@ -65,7 +65,7 @@ const createExtensionLoaderHandler = () => {
 /** Registers all middlewares on the dev server app. */
 const registerMiddlewares = (app, middlewares, port, options) => {
     // Register /invoke proxy
-    app.use("/invoke", (0, createInvokeProxyMiddleware_1.createInvokeProxyMiddleware)(options.serverlessPortMap));
+    app.use("/invoke", (0, createInvokeProxyMiddleware_1.createInvokeProxyMiddleware)(options.serversidePortMap));
     // Register CORS origin handler on all routes
     app.use("/", createCorsOriginHandler());
     // Register endpoint handlers

package/src/index.d.ts

@@ -13,4 +13,4 @@ export * from "./plugin-shared/consoleUtils";
 export * from "./plugin-shared/customFieldUtil";
 export * from "./plugin-shared/extensionUtil";
 export * from "./plugin-shared/indexHtmlUtil";
-export * from "./spawnServerlessExtensions";
+export * from "./spawnServersideExtensions";

package/src/index.js

@@ -16,5 +16,5 @@ tslib_1.__exportStar(require("./plugin-shared/consoleUtils"), exports);
 tslib_1.__exportStar(require("./plugin-shared/customFieldUtil"), exports);
 tslib_1.__exportStar(require("./plugin-shared/extensionUtil"), exports);
 tslib_1.__exportStar(require("./plugin-shared/indexHtmlUtil"), exports);
-tslib_1.__exportStar(require("./spawnServerlessExtensions"), exports);
+tslib_1.__exportStar(require("./spawnServersideExtensions"), exports);
 //# sourceMappingURL=index.js.map

package/src/{serverlessUtils.d.ts → serversideUtils.d.ts}

@@ -1,12 +1,12 @@
 /**
- * Pure utility functions for serverless extension spawning.
+ * Pure utility functions for serverside extension spawning.
  * These functions are side-effect free and easily testable.
  */
-/** Port range for serverless extension dev servers */
-export declare const SERVERLESS_PORT_MIN = 22230;
-export declare const SERVERLESS_PORT_MAX = 22239;
-/** Serverless extension type constant */
-export declare const SERVERLESS_EXTENSION_TYPE: "SERVERSIDE_API_EXTENSION";
+/** Port range for serverside extension dev servers */
+export declare const SERVERSIDE_PORT_MIN = 22230;
+export declare const SERVERSIDE_PORT_MAX = 22239;
+/** Serverside extension type constant */
+export declare const SERVERSIDE_EXTENSION_TYPE: "SERVERSIDE_API_EXTENSION";
 /**
  * Creates the spawn command arguments for an extension.
  *
@@ -18,7 +18,7 @@ export declare const createSpawnCommand: (extensionId: string) => {
     args: Array<string>;
 };
 /**
- * Creates spawn options for a serverless extension process.
+ * Creates spawn options for a serverside extension process.
  *
  * @param workspaceRoot - The NX workspace root directory
  * @param port - The port to run the extension on

package/src/{serverlessUtils.js → serversideUtils.js}

@@ -1,15 +1,15 @@
 "use strict";
 /**
- * Pure utility functions for serverless extension spawning.
+ * Pure utility functions for serverside extension spawning.
  * These functions are side-effect free and easily testable.
  */
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.analyzeProcessExit = exports.splitBufferToLines = exports.formatLogLine = exports.createSpawnOptions = exports.createSpawnCommand = exports.SERVERLESS_EXTENSION_TYPE = exports.SERVERLESS_PORT_MAX = exports.SERVERLESS_PORT_MIN = void 0;
-/** Port range for serverless extension dev servers */
-exports.SERVERLESS_PORT_MIN = 22230;
-exports.SERVERLESS_PORT_MAX = 22239;
-/** Serverless extension type constant */
-exports.SERVERLESS_EXTENSION_TYPE = "SERVERSIDE_API_EXTENSION";
+exports.analyzeProcessExit = exports.splitBufferToLines = exports.formatLogLine = exports.createSpawnOptions = exports.createSpawnCommand = exports.SERVERSIDE_EXTENSION_TYPE = exports.SERVERSIDE_PORT_MAX = exports.SERVERSIDE_PORT_MIN = void 0;
+/** Port range for serverside extension dev servers */
+exports.SERVERSIDE_PORT_MIN = 22230;
+exports.SERVERSIDE_PORT_MAX = 22239;
+/** Serverside extension type constant */
+exports.SERVERSIDE_EXTENSION_TYPE = "SERVERSIDE_API_EXTENSION";
 /**
  * Creates the spawn command arguments for an extension.
  *
@@ -22,7 +22,7 @@ const createSpawnCommand = (extensionId) => ({
 });
 exports.createSpawnCommand = createSpawnCommand;
 /**
- * Creates spawn options for a serverless extension process.
+ * Creates spawn options for a serverside extension process.
  *
  * @param workspaceRoot - The NX workspace root directory
  * @param port - The port to run the extension on
@@ -70,12 +70,12 @@ exports.splitBufferToLines = splitBufferToLines;
  */
 const analyzeProcessExit = (extensionId, code, signal) => {
     if (code !== null && code !== 0) {
-        return { isError: true, message: `[Serverless] ${extensionId} exited with code ${code}` };
+        return { isError: true, message: `[Serverside] ${extensionId} exited with code ${code}` };
     }
     if (signal) {
-        return { isError: false, message: `[Serverless] ${extensionId} terminated by signal ${signal}` };
+        return { isError: false, message: `[Serverside] ${extensionId} terminated by signal ${signal}` };
     }
     return { isError: false, message: null };
 };
 exports.analyzeProcessExit = analyzeProcessExit;
-//# sourceMappingURL=serverlessUtils.js.map
+//# sourceMappingURL=serversideUtils.js.map

package/src/{spawnServerlessExtensions.d.ts → spawnServersideExtensions.d.ts}

@@ -1,16 +1,16 @@
 import type { IrisAppManifest } from "@trackunit/iris-app-api";
 import { ChildProcess } from "child_process";
-export type ServerlessPortMap = Map<string, number>;
-export interface SpawnedServerlessExtensions {
-    portMap: ServerlessPortMap;
+export type ServersidePortMap = Map<string, number>;
+export interface SpawnedServersideExtensions {
+    portMap: ServersidePortMap;
     processes: Array<ChildProcess>;
     cleanup: () => void;
 }
 /**
- * Spawns serve processes for all serverless function extensions in the manifest.
+ * Spawns serve processes for all serverside function extensions in the manifest.
  *
  * @param manifest The Iris App manifest containing extensions
  * @param workspaceRoot The root directory of the NX workspace
- * @returns {Promise<SpawnedServerlessExtensions>} Object containing port map, spawned processes, and cleanup function
+ * @returns {Promise<SpawnedServersideExtensions>} Object containing port map, spawned processes, and cleanup function
  */
-export declare const spawnServerlessExtensions: (manifest: IrisAppManifest, workspaceRoot: string) => Promise<SpawnedServerlessExtensions>;
+export declare const spawnServersideExtensions: (manifest: IrisAppManifest, workspaceRoot: string) => Promise<SpawnedServersideExtensions>;

package/src/{spawnServerlessExtensions.js → spawnServersideExtensions.js}

@@ -1,21 +1,21 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
-exports.spawnServerlessExtensions = void 0;
+exports.spawnServersideExtensions = void 0;
 const child_process_1 = require("child_process");
 const getAvailablePort_1 = require("./getAvailablePort");
-const serverlessUtils_1 = require("./serverlessUtils");
+const serversideUtils_1 = require("./serversideUtils");
 /**
- * Spawns serve processes for all serverless function extensions in the manifest.
+ * Spawns serve processes for all serverside function extensions in the manifest.
  *
  * @param manifest The Iris App manifest containing extensions
  * @param workspaceRoot The root directory of the NX workspace
- * @returns {Promise<SpawnedServerlessExtensions>} Object containing port map, spawned processes, and cleanup function
+ * @returns {Promise<SpawnedServersideExtensions>} Object containing port map, spawned processes, and cleanup function
  */
-const spawnServerlessExtensions = async (manifest, workspaceRoot) => {
+const spawnServersideExtensions = async (manifest, workspaceRoot) => {
     const portMap = new Map();
     const processes = [];
-    const serverlessExtensions = manifest.extensions.filter(ext => ext.type === serverlessUtils_1.SERVERLESS_EXTENSION_TYPE);
-    if (serverlessExtensions.length === 0) {
+    const serversideExtensions = manifest.extensions.filter(ext => ext.type === serversideUtils_1.SERVERSIDE_EXTENSION_TYPE);
+    if (serversideExtensions.length === 0) {
         return {
             portMap,
             processes,
@@ -23,47 +23,47 @@ const spawnServerlessExtensions = async (manifest, workspaceRoot) => {
         };
     }
     // eslint-disable-next-line no-console
-    console.log(`\n[Serverless] Found ${serverlessExtensions.length} serverless extension(s)`);
-    let nextPort = serverlessUtils_1.SERVERLESS_PORT_MIN;
-    for (const extension of serverlessExtensions) {
+    console.log(`\n[Serverside] Found ${serversideExtensions.length} serverside extension(s)`);
+    let nextPort = serversideUtils_1.SERVERSIDE_PORT_MIN;
+    for (const extension of serversideExtensions) {
         const extensionId = extension.id;
         // Find available port
         let port;
         try {
-            port = await (0, getAvailablePort_1.getAvailablePort)(nextPort, serverlessUtils_1.SERVERLESS_PORT_MAX);
+            port = await (0, getAvailablePort_1.getAvailablePort)(nextPort, serversideUtils_1.SERVERSIDE_PORT_MAX);
             nextPort = port + 1;
         }
         catch {
             // eslint-disable-next-line no-console
-            console.error(`[Serverless] No available ports for ${extensionId}, skipping`);
+            console.error(`[Serverside] No available ports for ${extensionId}, skipping`);
             continue;
         }
         // eslint-disable-next-line no-console
-        console.log(`[Serverless] Starting ${extensionId} on port ${port}`);
-        const { command, args } = (0, serverlessUtils_1.createSpawnCommand)(extensionId);
-        const spawnOptions = (0, serverlessUtils_1.createSpawnOptions)(workspaceRoot, port, process.env);
+        console.log(`[Serverside] Starting ${extensionId} on port ${port}`);
+        const { command, args } = (0, serversideUtils_1.createSpawnCommand)(extensionId);
+        const spawnOptions = (0, serversideUtils_1.createSpawnOptions)(workspaceRoot, port, process.env);
         const child = (0, child_process_1.spawn)(command, args, spawnOptions);
         // Prefix output with extension name
         child.stdout.on("data", (data) => {
-            const lines = (0, serverlessUtils_1.splitBufferToLines)(data);
+            const lines = (0, serversideUtils_1.splitBufferToLines)(data);
             for (const line of lines) {
                 // eslint-disable-next-line no-console
-                console.log((0, serverlessUtils_1.formatLogLine)(extensionId, line));
+                console.log((0, serversideUtils_1.formatLogLine)(extensionId, line));
             }
         });
         child.stderr.on("data", (data) => {
-            const lines = (0, serverlessUtils_1.splitBufferToLines)(data);
+            const lines = (0, serversideUtils_1.splitBufferToLines)(data);
             for (const line of lines) {
                 // eslint-disable-next-line no-console
-                console.error((0, serverlessUtils_1.formatLogLine)(extensionId, line));
+                console.error((0, serversideUtils_1.formatLogLine)(extensionId, line));
             }
         });
         child.on("error", err => {
             // eslint-disable-next-line no-console
-            console.error(`[Serverless] Failed to start ${extensionId}: ${err.message}`);
+            console.error(`[Serverside] Failed to start ${extensionId}: ${err.message}`);
         });
         child.on("exit", (code, signal) => {
-            const { isError, message } = (0, serverlessUtils_1.analyzeProcessExit)(extensionId, code, signal);
+            const { isError, message } = (0, serversideUtils_1.analyzeProcessExit)(extensionId, code, signal);
             if (message !== null) {
                 if (isError) {
                     // eslint-disable-next-line no-console
@@ -95,5 +95,5 @@ const spawnServerlessExtensions = async (manifest, workspaceRoot) => {
     process.on("SIGTERM", cleanup);
     return { portMap, processes, cleanup };
 };
-exports.spawnServerlessExtensions = spawnServerlessExtensions;
-//# sourceMappingURL=spawnServerlessExtensions.js.map
+exports.spawnServersideExtensions = spawnServersideExtensions;
+//# sourceMappingURL=spawnServersideExtensions.js.map