@web-ts-toolkit/express-runtime 0.27.0 → 0.29.0

package/cli-api.d.mts

@@ -16,6 +16,8 @@ type Subcommand = 'dev' | 'build' | 'start' | 'build-serverless' | 'start-server
 interface DevArgs {
     appPath: string;
     options: Omit<LocalServerOptions, 'init' | 'onShutdown'>;
+    /** Optional tsconfig path for consumers that need TS path resolution. */
+    tsconfigPath?: string;
     /** Modules to preload before loading the app (repeatable `--require`). */
     require: string[];
     /** Env files to load before loading the app (repeatable `--env`). */
@@ -30,6 +32,7 @@ interface DevArgs {
 interface BuildArgs {
     appPath: string;
     initPath?: string;
+    tsconfigPath?: string;
     outDir: string;
     outName: string;
     format: 'cjs' | 'esm';
@@ -40,6 +43,7 @@ interface BuildArgs {
 interface BuildEntryContentArgs {
     entryContent: string;
     tempEntryFilename: string;
+    tsconfigPath?: string;
     outDir: string;
     outName: string;
     format: 'cjs' | 'esm';

package/cli-api.d.ts

@@ -16,6 +16,8 @@ type Subcommand = 'dev' | 'build' | 'start' | 'build-serverless' | 'start-server
 interface DevArgs {
     appPath: string;
     options: Omit<LocalServerOptions, 'init' | 'onShutdown'>;
+    /** Optional tsconfig path for consumers that need TS path resolution. */
+    tsconfigPath?: string;
     /** Modules to preload before loading the app (repeatable `--require`). */
     require: string[];
     /** Env files to load before loading the app (repeatable `--env`). */
@@ -30,6 +32,7 @@ interface DevArgs {
 interface BuildArgs {
     appPath: string;
     initPath?: string;
+    tsconfigPath?: string;
     outDir: string;
     outName: string;
     format: 'cjs' | 'esm';
@@ -40,6 +43,7 @@ interface BuildArgs {
 interface BuildEntryContentArgs {
     entryContent: string;
     tempEntryFilename: string;
+    tsconfigPath?: string;
     outDir: string;
     outName: string;
     format: 'cjs' | 'esm';

package/cli-api.js

@@ -232,12 +232,14 @@ Dev options:
   --shutdown-timeout <ms>       Max ms to wait for in-flight requests (default: 5000)
   --require <module>            Module(s) to preload before app load (repeatable)
   --env <path>                  Env file(s) to load (repeatable; existing env vars are not overridden)
+  --tsconfig <path>             Tsconfig used by config-aware consumers for TS path resolution
   --watch <paths>               Comma-separated paths to watch for restart (repeatable; dev only)
   --ext <extensions>            Comma-separated extensions to watch (default: ts,js,mjs,cjs,json)
   --delay <ms>                  Debounce ms before restarting on change (default: 500)
 
 Build options:
   --init <path>                 Init hook module (default export, async function)
+  --tsconfig <path>             Use a custom tsconfig for bundling
   --out-dir <path>              Output directory (default: dist)
   --out-name <name>             Output filename without extension (default: app)
   --format <cjs|esm>            Output format (default: cjs)
@@ -255,6 +257,7 @@ Start options:
 
 Build-serverless options:
   --init <path>                 Init hook module (default export, async function)
+  --tsconfig <path>             Use a custom tsconfig for bundling
   --out-dir <path>              Output directory (default: dist)
   --out-name <name>             Output filename without extension (default: handler)
   --format <cjs|esm>            Output format (default: cjs)
@@ -326,6 +329,7 @@ function parseDevArgs(argv) {
   const watchPaths = [];
   let watchExt;
   let watchDelay;
+  let tsconfigPath;
   let appPath;
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
@@ -392,6 +396,15 @@ function parseDevArgs(argv) {
       }
       continue;
     }
+    if (arg === "--tsconfig") {
+      tsconfigPath = readValue(argv, index, arg);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--tsconfig=")) {
+      tsconfigPath = arg.slice("--tsconfig=".length);
+      continue;
+    }
     if (arg === "--watch") {
       index = parseRepeatable(argv, index, arg, watchPaths);
       continue;
@@ -441,6 +454,7 @@ function parseDevArgs(argv) {
   return {
     appPath,
     options,
+    tsconfigPath,
     require: requireModules,
     env: envFiles,
     watch: watchPaths,
@@ -450,8 +464,8 @@ function parseDevArgs(argv) {
 }
 function parseStartLikeArgs(argv, subcommandName) {
   for (const arg of argv) {
-    if (arg === "--watch" || arg.startsWith("--watch=") || arg === "--ext" || arg.startsWith("--ext=") || arg === "--delay" || arg.startsWith("--delay=")) {
-      throw new Error(`--watch/--ext/--delay are not supported with the ${subcommandName} subcommand`);
+    if (arg === "--watch" || arg.startsWith("--watch=") || arg === "--tsconfig" || arg.startsWith("--tsconfig=") || arg === "--ext" || arg.startsWith("--ext=") || arg === "--delay" || arg.startsWith("--delay=")) {
+      throw new Error(`--watch/--tsconfig/--ext/--delay are not supported with the ${subcommandName} subcommand`);
     }
   }
   return parseDevArgs(argv);
@@ -479,6 +493,7 @@ function parseBuildArgs(argv, outNameDefault) {
   const external = [];
   const result = {
     initPath: void 0,
+    tsconfigPath: void 0,
     outDir: "dist",
     outName: outNameDefault,
     format: "cjs",
@@ -503,6 +518,15 @@ function parseBuildArgs(argv, outNameDefault) {
       result.initPath = arg.slice("--init=".length);
       continue;
     }
+    if (arg === "--tsconfig") {
+      result.tsconfigPath = readValue(argv, index, arg);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--tsconfig=")) {
+      result.tsconfigPath = arg.slice("--tsconfig=".length);
+      continue;
+    }
     if (arg === "--out-dir") {
       result.outDir = readValue(argv, index, arg);
       index += 1;
@@ -695,6 +719,7 @@ function buildChildArgs(args) {
   if (args.options.signals === false) result.push("--no-signals");
   if (args.options.shutdownTimeout !== void 0)
     result.push("--shutdown-timeout", String(args.options.shutdownTimeout));
+  if (args.tsconfigPath !== void 0) result.push("--tsconfig", args.tsconfigPath);
   for (const r of args.require) result.push("--require", r);
   for (const e of args.env) result.push("--env", e);
   return result;
@@ -802,6 +827,7 @@ async function buildBundleFromEntryContent(args) {
     await build({
       config: false,
       entry: { [args.outName]: tempEntryPath },
+      tsconfig: args.tsconfigPath,
       format: [args.format],
       target: args.target,
       outDir: args.outDir,
@@ -857,7 +883,11 @@ function applyServerlessResult(result, res) {
   if (r.headers && typeof r.headers === "object") {
     for (const [key, value] of Object.entries(r.headers)) {
       if (value !== void 0) {
-        res.setHeader(key, Array.isArray(value) ? value.join(",") : value);
+        if (Array.isArray(value) && key.toLowerCase() === "set-cookie") {
+          res.setHeader(key, value);
+        } else {
+          res.setHeader(key, Array.isArray(value) ? value.join(",") : value);
+        }
       }
     }
   }
@@ -918,7 +948,7 @@ async function loadHandler(handlerPath) {
   }
   return exported;
 }
-var import_node_url, import_node_path, import_node_fs, import_node_module, import_node_child_process, import_meta, CLI_VERSION, DEFAULT_WATCH_EXTENSIONS, DEFAULT_WATCH_DELAY, moduleRequire, TEMP_BUILD_ENTRY_FILENAME, TEMP_SERVERLESS_ENTRY_FILENAME;
+var import_node_url, import_node_path, import_node_fs, import_node_module, import_node_child_process, CLI_VERSION, DEFAULT_WATCH_EXTENSIONS, DEFAULT_WATCH_DELAY, moduleRequire, TEMP_BUILD_ENTRY_FILENAME, TEMP_SERVERLESS_ENTRY_FILENAME;
 var init_cli_utils = __esm({
   "src/cli-utils.ts"() {
     "use strict";
@@ -928,12 +958,11 @@ var init_cli_utils = __esm({
     import_node_module = require("module");
     import_node_child_process = require("child_process");
     init_index();
-    import_meta = {};
     CLI_VERSION = "0.0.0-PLACEHOLDER";
     DEFAULT_WATCH_EXTENSIONS = ["ts", "js", "mjs", "cjs", "json"];
     DEFAULT_WATCH_DELAY = 500;
     moduleRequire = (0, import_node_module.createRequire)(
-      typeof import_meta !== "undefined" && import_meta.url || (0, import_node_path.resolve)(process.cwd(), "x").replace(/x$/, "")
+      (0, import_node_url.pathToFileURL)((0, import_node_path.resolve)(process.cwd(), "__wtt_runtime_preload__.js"))
     );
     TEMP_BUILD_ENTRY_FILENAME = ".express-runtime-build-entry.ts";
     TEMP_SERVERLESS_ENTRY_FILENAME = ".express-runtime-build-serverless-entry.ts";
@@ -999,6 +1028,7 @@ async function runBuildEntryCommand(args, options) {
   await buildBundleFromEntryContent({
     entryContent: options.generateEntry(args.appPath, args.initPath),
     tempEntryFilename: options.tempEntryFilename,
+    tsconfigPath: args.tsconfigPath,
     outDir: args.outDir,
     outName: args.outName,
     format: args.format,

package/cli-api.mjs

@@ -40,12 +40,14 @@ Dev options:
   --shutdown-timeout <ms>       Max ms to wait for in-flight requests (default: 5000)
   --require <module>            Module(s) to preload before app load (repeatable)
   --env <path>                  Env file(s) to load (repeatable; existing env vars are not overridden)
+  --tsconfig <path>             Tsconfig used by config-aware consumers for TS path resolution
   --watch <paths>               Comma-separated paths to watch for restart (repeatable; dev only)
   --ext <extensions>            Comma-separated extensions to watch (default: ts,js,mjs,cjs,json)
   --delay <ms>                  Debounce ms before restarting on change (default: 500)
 
 Build options:
   --init <path>                 Init hook module (default export, async function)
+  --tsconfig <path>             Use a custom tsconfig for bundling
   --out-dir <path>              Output directory (default: dist)
   --out-name <name>             Output filename without extension (default: app)
   --format <cjs|esm>            Output format (default: cjs)
@@ -63,6 +65,7 @@ Start options:
 
 Build-serverless options:
   --init <path>                 Init hook module (default export, async function)
+  --tsconfig <path>             Use a custom tsconfig for bundling
   --out-dir <path>              Output directory (default: dist)
   --out-name <name>             Output filename without extension (default: handler)
   --format <cjs|esm>            Output format (default: cjs)
@@ -136,6 +139,7 @@ function parseDevArgs(argv) {
   const watchPaths = [];
   let watchExt;
   let watchDelay;
+  let tsconfigPath;
   let appPath;
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
@@ -202,6 +206,15 @@ function parseDevArgs(argv) {
       }
       continue;
     }
+    if (arg === "--tsconfig") {
+      tsconfigPath = readValue(argv, index, arg);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--tsconfig=")) {
+      tsconfigPath = arg.slice("--tsconfig=".length);
+      continue;
+    }
     if (arg === "--watch") {
       index = parseRepeatable(argv, index, arg, watchPaths);
       continue;
@@ -251,6 +264,7 @@ function parseDevArgs(argv) {
   return {
     appPath,
     options,
+    tsconfigPath,
     require: requireModules,
     env: envFiles,
     watch: watchPaths,
@@ -260,8 +274,8 @@ function parseDevArgs(argv) {
 }
 function parseStartLikeArgs(argv, subcommandName) {
   for (const arg of argv) {
-    if (arg === "--watch" || arg.startsWith("--watch=") || arg === "--ext" || arg.startsWith("--ext=") || arg === "--delay" || arg.startsWith("--delay=")) {
-      throw new Error(`--watch/--ext/--delay are not supported with the ${subcommandName} subcommand`);
+    if (arg === "--watch" || arg.startsWith("--watch=") || arg === "--tsconfig" || arg.startsWith("--tsconfig=") || arg === "--ext" || arg.startsWith("--ext=") || arg === "--delay" || arg.startsWith("--delay=")) {
+      throw new Error(`--watch/--tsconfig/--ext/--delay are not supported with the ${subcommandName} subcommand`);
     }
   }
   return parseDevArgs(argv);
@@ -289,6 +303,7 @@ function parseBuildArgs(argv, outNameDefault) {
   const external = [];
   const result = {
     initPath: void 0,
+    tsconfigPath: void 0,
     outDir: "dist",
     outName: outNameDefault,
     format: "cjs",
@@ -313,6 +328,15 @@ function parseBuildArgs(argv, outNameDefault) {
       result.initPath = arg.slice("--init=".length);
       continue;
     }
+    if (arg === "--tsconfig") {
+      result.tsconfigPath = readValue(argv, index, arg);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--tsconfig=")) {
+      result.tsconfigPath = arg.slice("--tsconfig=".length);
+      continue;
+    }
     if (arg === "--out-dir") {
       result.outDir = readValue(argv, index, arg);
       index += 1;
@@ -494,7 +518,7 @@ function loadEnvFiles(paths) {
   }
 }
 var moduleRequire = createRequire(
-  typeof import.meta !== "undefined" && import.meta.url || pathResolve(process.cwd(), "x").replace(/x$/, "")
+  pathToFileURL(pathResolve(process.cwd(), "__wtt_runtime_preload__.js"))
 );
 async function preloadModules(modules) {
   for (const mod of modules) {
@@ -508,6 +532,7 @@ function buildChildArgs(args) {
   if (args.options.signals === false) result.push("--no-signals");
   if (args.options.shutdownTimeout !== void 0)
     result.push("--shutdown-timeout", String(args.options.shutdownTimeout));
+  if (args.tsconfigPath !== void 0) result.push("--tsconfig", args.tsconfigPath);
   for (const r of args.require) result.push("--require", r);
   for (const e of args.env) result.push("--env", e);
   return result;
@@ -617,6 +642,7 @@ async function buildBundleFromEntryContent(args) {
     await build({
       config: false,
       entry: { [args.outName]: tempEntryPath },
+      tsconfig: args.tsconfigPath,
       format: [args.format],
       target: args.target,
       outDir: args.outDir,
@@ -672,7 +698,11 @@ function applyServerlessResult(result, res) {
   if (r.headers && typeof r.headers === "object") {
     for (const [key, value] of Object.entries(r.headers)) {
       if (value !== void 0) {
-        res.setHeader(key, Array.isArray(value) ? value.join(",") : value);
+        if (Array.isArray(value) && key.toLowerCase() === "set-cookie") {
+          res.setHeader(key, value);
+        } else {
+          res.setHeader(key, Array.isArray(value) ? value.join(",") : value);
+        }
       }
     }
   }
@@ -762,6 +792,7 @@ async function runBuildEntryCommand(args, options) {
   await buildBundleFromEntryContent({
     entryContent: options.generateEntry(args.appPath, args.initPath),
     tempEntryFilename: options.tempEntryFilename,
+    tsconfigPath: args.tsconfigPath,
     outDir: args.outDir,
     outName: args.outName,
     format: args.format,

package/cli.js

@@ -232,12 +232,14 @@ Dev options:
   --shutdown-timeout <ms>       Max ms to wait for in-flight requests (default: 5000)
   --require <module>            Module(s) to preload before app load (repeatable)
   --env <path>                  Env file(s) to load (repeatable; existing env vars are not overridden)
+  --tsconfig <path>             Tsconfig used by config-aware consumers for TS path resolution
   --watch <paths>               Comma-separated paths to watch for restart (repeatable; dev only)
   --ext <extensions>            Comma-separated extensions to watch (default: ts,js,mjs,cjs,json)
   --delay <ms>                  Debounce ms before restarting on change (default: 500)
 
 Build options:
   --init <path>                 Init hook module (default export, async function)
+  --tsconfig <path>             Use a custom tsconfig for bundling
   --out-dir <path>              Output directory (default: dist)
   --out-name <name>             Output filename without extension (default: app)
   --format <cjs|esm>            Output format (default: cjs)
@@ -255,6 +257,7 @@ Start options:
 
 Build-serverless options:
   --init <path>                 Init hook module (default export, async function)
+  --tsconfig <path>             Use a custom tsconfig for bundling
   --out-dir <path>              Output directory (default: dist)
   --out-name <name>             Output filename without extension (default: handler)
   --format <cjs|esm>            Output format (default: cjs)
@@ -326,6 +329,7 @@ function parseDevArgs(argv) {
   const watchPaths = [];
   let watchExt;
   let watchDelay;
+  let tsconfigPath;
   let appPath;
   for (let index = 0; index < argv.length; index += 1) {
     const arg = argv[index];
@@ -392,6 +396,15 @@ function parseDevArgs(argv) {
       }
       continue;
     }
+    if (arg === "--tsconfig") {
+      tsconfigPath = readValue(argv, index, arg);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--tsconfig=")) {
+      tsconfigPath = arg.slice("--tsconfig=".length);
+      continue;
+    }
     if (arg === "--watch") {
       index = parseRepeatable(argv, index, arg, watchPaths);
       continue;
@@ -441,6 +454,7 @@ function parseDevArgs(argv) {
   return {
     appPath,
     options,
+    tsconfigPath,
     require: requireModules,
     env: envFiles,
     watch: watchPaths,
@@ -450,8 +464,8 @@ function parseDevArgs(argv) {
 }
 function parseStartLikeArgs(argv, subcommandName) {
   for (const arg of argv) {
-    if (arg === "--watch" || arg.startsWith("--watch=") || arg === "--ext" || arg.startsWith("--ext=") || arg === "--delay" || arg.startsWith("--delay=")) {
-      throw new Error(`--watch/--ext/--delay are not supported with the ${subcommandName} subcommand`);
+    if (arg === "--watch" || arg.startsWith("--watch=") || arg === "--tsconfig" || arg.startsWith("--tsconfig=") || arg === "--ext" || arg.startsWith("--ext=") || arg === "--delay" || arg.startsWith("--delay=")) {
+      throw new Error(`--watch/--tsconfig/--ext/--delay are not supported with the ${subcommandName} subcommand`);
     }
   }
   return parseDevArgs(argv);
@@ -479,6 +493,7 @@ function parseBuildArgs(argv, outNameDefault) {
   const external = [];
   const result = {
     initPath: void 0,
+    tsconfigPath: void 0,
     outDir: "dist",
     outName: outNameDefault,
     format: "cjs",
@@ -503,6 +518,15 @@ function parseBuildArgs(argv, outNameDefault) {
       result.initPath = arg.slice("--init=".length);
       continue;
     }
+    if (arg === "--tsconfig") {
+      result.tsconfigPath = readValue(argv, index, arg);
+      index += 1;
+      continue;
+    }
+    if (arg.startsWith("--tsconfig=")) {
+      result.tsconfigPath = arg.slice("--tsconfig=".length);
+      continue;
+    }
     if (arg === "--out-dir") {
       result.outDir = readValue(argv, index, arg);
       index += 1;
@@ -695,6 +719,7 @@ function buildChildArgs(args) {
   if (args.options.signals === false) result.push("--no-signals");
   if (args.options.shutdownTimeout !== void 0)
     result.push("--shutdown-timeout", String(args.options.shutdownTimeout));
+  if (args.tsconfigPath !== void 0) result.push("--tsconfig", args.tsconfigPath);
   for (const r of args.require) result.push("--require", r);
   for (const e of args.env) result.push("--env", e);
   return result;
@@ -802,6 +827,7 @@ async function buildBundleFromEntryContent(args) {
     await build({
       config: false,
       entry: { [args.outName]: tempEntryPath },
+      tsconfig: args.tsconfigPath,
       format: [args.format],
       target: args.target,
       outDir: args.outDir,
@@ -857,7 +883,11 @@ function applyServerlessResult(result, res) {
   if (r.headers && typeof r.headers === "object") {
     for (const [key, value] of Object.entries(r.headers)) {
       if (value !== void 0) {
-        res.setHeader(key, Array.isArray(value) ? value.join(",") : value);
+        if (Array.isArray(value) && key.toLowerCase() === "set-cookie") {
+          res.setHeader(key, value);
+        } else {
+          res.setHeader(key, Array.isArray(value) ? value.join(",") : value);
+        }
       }
     }
   }
@@ -918,7 +948,7 @@ async function loadHandler(handlerPath) {
   }
   return exported;
 }
-var import_node_url, import_node_path, import_node_fs, import_node_module, import_node_child_process, import_meta, CLI_VERSION, DEFAULT_WATCH_EXTENSIONS, DEFAULT_WATCH_DELAY, moduleRequire, TEMP_BUILD_ENTRY_FILENAME, TEMP_SERVERLESS_ENTRY_FILENAME;
+var import_node_url, import_node_path, import_node_fs, import_node_module, import_node_child_process, CLI_VERSION, DEFAULT_WATCH_EXTENSIONS, DEFAULT_WATCH_DELAY, moduleRequire, TEMP_BUILD_ENTRY_FILENAME, TEMP_SERVERLESS_ENTRY_FILENAME;
 var init_cli_utils = __esm({
   "src/cli-utils.ts"() {
     "use strict";
@@ -928,12 +958,11 @@ var init_cli_utils = __esm({
     import_node_module = require("module");
     import_node_child_process = require("child_process");
     init_src();
-    import_meta = {};
     CLI_VERSION = "0.0.0-PLACEHOLDER";
     DEFAULT_WATCH_EXTENSIONS = ["ts", "js", "mjs", "cjs", "json"];
     DEFAULT_WATCH_DELAY = 500;
     moduleRequire = (0, import_node_module.createRequire)(
-      typeof import_meta !== "undefined" && import_meta.url || (0, import_node_path.resolve)(process.cwd(), "x").replace(/x$/, "")
+      (0, import_node_url.pathToFileURL)((0, import_node_path.resolve)(process.cwd(), "__wtt_runtime_preload__.js"))
     );
     TEMP_BUILD_ENTRY_FILENAME = ".express-runtime-build-entry.ts";
     TEMP_SERVERLESS_ENTRY_FILENAME = ".express-runtime-build-serverless-entry.ts";
@@ -998,6 +1027,7 @@ async function runBuildEntryCommand(args, options) {
   await buildBundleFromEntryContent({
     entryContent: options.generateEntry(args.appPath, args.initPath),
     tempEntryFilename: options.tempEntryFilename,
+    tsconfigPath: args.tsconfigPath,
     outDir: args.outDir,
     outName: args.outName,
     format: args.format,

package/package.json

@@ -2,7 +2,7 @@
   "name": "@web-ts-toolkit/express-runtime",
   "description": "Express app factory plus serverless handler and local dev server helpers",
   "homepage": "https://web-ts-toolkit.pages.dev/docs/packages/express-runtime",
-  "version": "0.27.0",
+  "version": "0.29.0",
   "sideEffects": false,
   "keywords": [
     "express",