@zuplo/cli 6.64.39 → 6.64.41

package/dist/cli.js

@@ -13,6 +13,7 @@ import compile from "./cmds/compile.js";
 import deleteZup from "./cmds/delete.js";
 import deploy from "./cmds/deploy.js";
 import dev from "./cmds/dev.js";
+import docs from "./cmds/docs.js";
 import editor from "./cmds/editor.js";
 import link from "./cmds/link.js";
 import list from "./cmds/list.js";
@@ -81,6 +82,7 @@ if (gte(process.versions.node, MIN_NODE_VERSION)) {
         .command(deleteZup)
         .command(deploy)
         .command(dev)
+        .command(docs)
         .command(editor)
         .command(list)
         .command(link)

package/dist/cli.js.map

@@ -1 +1 @@
-{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import * as dotenv from \"dotenv\";\n\ndotenv.config();\n\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { confirm } from \"@inquirer/prompts\";\nimport * as Sentry from \"@sentry/node\";\nimport { gte } from \"semver\";\n// Undici must be imported first to set the global dispatcher\n// If fetch is used before undici, the process will crash\nimport undici from \"undici\";\nimport { hideBin } from \"yargs/helpers\";\nimport yargs from \"yargs/yargs\";\nimport build from \"./cmds/build.js\";\nimport compile from \"./cmds/compile.js\";\nimport deleteZup from \"./cmds/delete.js\";\nimport deploy from \"./cmds/deploy.js\";\nimport dev from \"./cmds/dev.js\";\nimport editor from \"./cmds/editor.js\";\nimport link from \"./cmds/link.js\";\nimport list from \"./cmds/list.js\";\nimport login from \"./cmds/login.js\";\nimport mtlsCertificates from \"./cmds/mtls-certificates/index.js\";\nimport oas from \"./cmds/open-api/index.js\";\nimport project from \"./cmds/project/index.js\";\nimport proxies from \"./cmds/proxies/index.js\";\nimport source from \"./cmds/source/index.js\";\nimport test from \"./cmds/test.js\";\nimport tunnel from \"./cmds/tunnel/index.js\";\nimport variable from \"./cmds/variable/index.js\";\nimport { shutdownAnalytics } from \"./common/analytics/lib.js\";\nimport { MAX_WAIT_PENDING_TIME_MS, SENTRY_DSN } from \"./common/constants.js\";\nimport { logger } from \"./common/logger.js\";\nimport { logLevel } from \"./common/middleware/logging.js\";\nimport { warnIfOutdatedVersion, warnNodeVersion } from \"./common/outdated.js\";\nimport { printCriticalFailureToConsoleAndExit } from \"./common/output.js\";\n\n// This allows us to stop the CLI from executing so we can connect the profiler\n\n// biome-ignore lint/style/noProcessEnv: Migrated from ESLint\nif (process.env.ZUPLO_CLI_PROFILING) {\n  await confirm({ message: \"Continue executing CLI?\", default: true });\n}\n\n// Note: We cannot set this to be higher than 18.0.0 because of the way\n// our documentation works -- we tell them to use npx @zuplo/cli@latest (even in CI/CD jobs)\n// If we set this to be higher than 18.0.0, then we will break them.\n// Instead we set the value in package.json to be engine.node >= 20.0.0, so it will warn\nconst MIN_NODE_VERSION = \"18.0.0\";\nconst RECOMMENDED_NODE_VERSION = \"20.0.0\";\n\nif (gte(process.versions.node, MIN_NODE_VERSION)) {\n  let cliVersion: string;\n  try {\n    const packageJson = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL(\"../package.json\", import.meta.url)),\n        \"utf-8\"\n      )\n    );\n    cliVersion = packageJson.version;\n  } catch (e) {\n    cliVersion = \"0.0.0\";\n    logger.error(e);\n    await printCriticalFailureToConsoleAndExit(\n      `Unable to load @zuplo/cli. The package.json is missing or malformed.`\n    );\n  }\n\n  await warnNodeVersion(cliVersion, RECOMMENDED_NODE_VERSION);\n\n  undici.setGlobalDispatcher(\n    undici.getGlobalDispatcher().compose((dispatch) => {\n      return (opts, handler) => {\n        opts.headers = {\n          ...opts.headers,\n          \"user-agent\": `ZuploCLI/${cliVersion}`,\n\n          // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n          ...(process.env.ZUPLO_CANARY ? { \"zp-canary\": \"true\" } : {}),\n        };\n        return dispatch(opts, handler);\n      };\n    })\n  );\n\n  Sentry.init({\n    dsn: SENTRY_DSN,\n    release: cliVersion,\n  });\n\n  const cli = yargs(hideBin(process.argv))\n    // This means that all env vars will have to be prefixed with ZUPLO_\n    .env(\"ZUPLO\")\n    .option(\"prompt\", {\n      type: \"boolean\",\n      describe: \"Bypass confirmation prompts\",\n      default: true,\n      hidden: true,\n    })\n    .option(\"verbose\", {\n      alias: \"v\",\n      type: \"count\",\n      describe: \"Increase verbosity level (-v, -vv, -vvv)\",\n      default: 0,\n    })\n    .middleware(logLevel)\n    .command(compile)\n    .command(deleteZup) // delete is a reserved keyword in JavaScript, so we call this function deleteZup\n    .command(deploy)\n    .command(dev)\n    .command(editor)\n    .command(list)\n    .command(link)\n    .command(login)\n    .command(test)\n    .command(oas)\n    .command(mtlsCertificates)\n    .command(project)\n    .command(source)\n    .command(tunnel)\n    .command(variable)\n    .command(build)\n    .command(proxies)\n    .command({\n      command: \"hello\",\n      handler: async () => {\n        await fetch(\"https://393b4699ced44cc2ae87e4ad86184a29.api.mockbin.io/\");\n      },\n    })\n    .demandCommand()\n    .strictCommands()\n    .version(cliVersion)\n    .fail(false)\n    .help();\n\n  try {\n    await cli.argv;\n\n    // Don't block\n    void warnIfOutdatedVersion(cliVersion);\n\n    void Sentry.close(MAX_WAIT_PENDING_TIME_MS).then(() => {\n      process.exit(0);\n    });\n  } catch (err) {\n    if (err instanceof Error) {\n      Sentry.captureException(err);\n    }\n    await printCriticalFailureToConsoleAndExit(err.message ?? err);\n    cli.showHelp();\n  } finally {\n    await shutdownAnalytics();\n  }\n} else {\n  await printCriticalFailureToConsoleAndExit(\n    `The Zuplo CLI requires at least node.js v${MIN_NODE_VERSION}. You are using v${process.versions.node}. Please update your version of node.js.\n\n    Consider using a Node.js version manager such as https://github.com/nvm-sh/nvm.`\n  );\n}\n"]}
+{"version":3,"file":"cli.js","sourceRoot":"","sources":["../src/cli.ts"],"names":[],"mappings":"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","sourcesContent":["import * as dotenv from \"dotenv\";\n\ndotenv.config();\n\nimport { readFileSync } from \"node:fs\";\nimport { fileURLToPath } from \"node:url\";\nimport { confirm } from \"@inquirer/prompts\";\nimport * as Sentry from \"@sentry/node\";\nimport { gte } from \"semver\";\n// Undici must be imported first to set the global dispatcher\n// If fetch is used before undici, the process will crash\nimport undici from \"undici\";\nimport { hideBin } from \"yargs/helpers\";\nimport yargs from \"yargs/yargs\";\nimport build from \"./cmds/build.js\";\nimport compile from \"./cmds/compile.js\";\nimport deleteZup from \"./cmds/delete.js\";\nimport deploy from \"./cmds/deploy.js\";\nimport dev from \"./cmds/dev.js\";\nimport docs from \"./cmds/docs.js\";\nimport editor from \"./cmds/editor.js\";\nimport link from \"./cmds/link.js\";\nimport list from \"./cmds/list.js\";\nimport login from \"./cmds/login.js\";\nimport mtlsCertificates from \"./cmds/mtls-certificates/index.js\";\nimport oas from \"./cmds/open-api/index.js\";\nimport project from \"./cmds/project/index.js\";\nimport proxies from \"./cmds/proxies/index.js\";\nimport source from \"./cmds/source/index.js\";\nimport test from \"./cmds/test.js\";\nimport tunnel from \"./cmds/tunnel/index.js\";\nimport variable from \"./cmds/variable/index.js\";\nimport { shutdownAnalytics } from \"./common/analytics/lib.js\";\nimport { MAX_WAIT_PENDING_TIME_MS, SENTRY_DSN } from \"./common/constants.js\";\nimport { logger } from \"./common/logger.js\";\nimport { logLevel } from \"./common/middleware/logging.js\";\nimport { warnIfOutdatedVersion, warnNodeVersion } from \"./common/outdated.js\";\nimport { printCriticalFailureToConsoleAndExit } from \"./common/output.js\";\n\n// This allows us to stop the CLI from executing so we can connect the profiler\n\n// biome-ignore lint/style/noProcessEnv: Migrated from ESLint\nif (process.env.ZUPLO_CLI_PROFILING) {\n  await confirm({ message: \"Continue executing CLI?\", default: true });\n}\n\n// Note: We cannot set this to be higher than 18.0.0 because of the way\n// our documentation works -- we tell them to use npx @zuplo/cli@latest (even in CI/CD jobs)\n// If we set this to be higher than 18.0.0, then we will break them.\n// Instead we set the value in package.json to be engine.node >= 20.0.0, so it will warn\nconst MIN_NODE_VERSION = \"18.0.0\";\nconst RECOMMENDED_NODE_VERSION = \"20.0.0\";\n\nif (gte(process.versions.node, MIN_NODE_VERSION)) {\n  let cliVersion: string;\n  try {\n    const packageJson = JSON.parse(\n      readFileSync(\n        fileURLToPath(new URL(\"../package.json\", import.meta.url)),\n        \"utf-8\"\n      )\n    );\n    cliVersion = packageJson.version;\n  } catch (e) {\n    cliVersion = \"0.0.0\";\n    logger.error(e);\n    await printCriticalFailureToConsoleAndExit(\n      `Unable to load @zuplo/cli. The package.json is missing or malformed.`\n    );\n  }\n\n  await warnNodeVersion(cliVersion, RECOMMENDED_NODE_VERSION);\n\n  undici.setGlobalDispatcher(\n    undici.getGlobalDispatcher().compose((dispatch) => {\n      return (opts, handler) => {\n        opts.headers = {\n          ...opts.headers,\n          \"user-agent\": `ZuploCLI/${cliVersion}`,\n\n          // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n          ...(process.env.ZUPLO_CANARY ? { \"zp-canary\": \"true\" } : {}),\n        };\n        return dispatch(opts, handler);\n      };\n    })\n  );\n\n  Sentry.init({\n    dsn: SENTRY_DSN,\n    release: cliVersion,\n  });\n\n  const cli = yargs(hideBin(process.argv))\n    // This means that all env vars will have to be prefixed with ZUPLO_\n    .env(\"ZUPLO\")\n    .option(\"prompt\", {\n      type: \"boolean\",\n      describe: \"Bypass confirmation prompts\",\n      default: true,\n      hidden: true,\n    })\n    .option(\"verbose\", {\n      alias: \"v\",\n      type: \"count\",\n      describe: \"Increase verbosity level (-v, -vv, -vvv)\",\n      default: 0,\n    })\n    .middleware(logLevel)\n    .command(compile)\n    .command(deleteZup) // delete is a reserved keyword in JavaScript, so we call this function deleteZup\n    .command(deploy)\n    .command(dev)\n    .command(docs)\n    .command(editor)\n    .command(list)\n    .command(link)\n    .command(login)\n    .command(test)\n    .command(oas)\n    .command(mtlsCertificates)\n    .command(project)\n    .command(source)\n    .command(tunnel)\n    .command(variable)\n    .command(build)\n    .command(proxies)\n    .command({\n      command: \"hello\",\n      handler: async () => {\n        await fetch(\"https://393b4699ced44cc2ae87e4ad86184a29.api.mockbin.io/\");\n      },\n    })\n    .demandCommand()\n    .strictCommands()\n    .version(cliVersion)\n    .fail(false)\n    .help();\n\n  try {\n    await cli.argv;\n\n    // Don't block\n    void warnIfOutdatedVersion(cliVersion);\n\n    void Sentry.close(MAX_WAIT_PENDING_TIME_MS).then(() => {\n      process.exit(0);\n    });\n  } catch (err) {\n    if (err instanceof Error) {\n      Sentry.captureException(err);\n    }\n    await printCriticalFailureToConsoleAndExit(err.message ?? err);\n    cli.showHelp();\n  } finally {\n    await shutdownAnalytics();\n  }\n} else {\n  await printCriticalFailureToConsoleAndExit(\n    `The Zuplo CLI requires at least node.js v${MIN_NODE_VERSION}. You are using v${process.versions.node}. Please update your version of node.js.\n\n    Consider using a Node.js version manager such as https://github.com/nvm-sh/nvm.`\n  );\n}\n"]}

package/dist/cmds/dev.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cmds/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAWV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAwDf,OAAO;;AA3D/B,wBAwEE"}
+{"version":3,"file":"dev.d.ts","sourceRoot":"","sources":["../../src/cmds/dev.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAWV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAsEf,OAAO;;AAzE/B,wBAsFE"}

package/dist/cmds/dev.js

@@ -31,6 +31,16 @@ export default {
             type: "number",
             describe: "The port to run the route designer on",
             default: 9100,
+        })
+            .option("start-docs", {
+            type: "boolean",
+            describe: "Start the docs server with the local development setup",
+            default: true,
+        })
+            .option("docs-port", {
+            type: "number",
+            describe: "The port to run the docs server on",
+            default: 9200,
         })
             .option("debug-port", {
             type: "number",
@@ -44,13 +54,17 @@ export default {
             .example([
             [
                 "$0 dev",
-                "Start the local development server with default settings (port 9000 for API, port 9100 for editor)",
+                "Start the local development server with default settings (port 9000 for API, port 9100 for editor, port 9200 for docs)",
             ],
             ["$0 dev --port 8080", "Start the local server on a custom port"],
             [
                 "$0 dev --no-start-editor",
                 "Start only the API server without opening the editor",
             ],
+            [
+                "$0 dev --no-start-docs",
+                "Start the API server without the docs server",
+            ],
             [
                 "$0 dev --debug-port 9229",
                 "Start with Chrome DevTools inspector enabled on port 9229",

package/dist/cmds/dev.js.map

@@ -1 +1 @@
-{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/cmds/dev.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,WAAW,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAa,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAEnD,eAAe;IACb,IAAI,EAAE,4BAA4B;IAClC,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,kBAAkB,CAAC;aACzB,MAAM,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,yCAAyC;YACnD,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;SACb,CAAC;aACD,MAAM,CAAC,cAAc,EAAE;YACtB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,wCAAwC;YAClD,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,qCAAqC;YAC/C,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,uCAAuC;YACjD,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,YAAY,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,yCAAyC;SACpD,CAAC;aACD,MAAM,CAAC,oCAAoC,EAAE;YAC5C,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,oCAAoC;YAC9C,OAAO,EAAE,KAAK;SACf,CAAC;aACD,OAAO,CAAC;YACP;gBACE,QAAQ;gBACR,oGAAoG;aACrG;YACD,CAAC,oBAAoB,EAAE,yCAAyC,CAAC;YACjE;gBACE,0BAA0B;gBAC1B,sDAAsD;aACvD;YACD;gBACE,0BAA0B;gBAC1B,2DAA2D;aAC5D;SACF,CAAC;aACD,UAAU,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;aACnC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,OAAO,MAAM,IAAI,YAAY,CAC3B,IAAI,qBAAqB,EAAE,CAC5B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,UAAU,EAAE;gBACV,YAAY,EAAG,IAAkB,CAAC,WAAW,CAAC;gBAC9C,oCAAoC,EAAG,IAAkB,CACvD,iCAAiC,CAClC;aACF;YACD,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,IAAiB,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../common/analytics/lib.js\";\nimport { identify } from \"../common/middleware/user-identification.js\";\nimport setBlocking from \"../common/output.js\";\nimport { ZuploProjectValidator } from \"../common/validators/file-system-validator.js\";\nimport { YargsChecker } from \"../common/validators/lib.js\";\nimport { Arguments, dev } from \"../dev/handler.js\";\n\nexport default {\n  desc: \"Runs the Zuplo API locally\",\n  command: \"dev\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 dev [options]\")\n      .option(\"dir\", {\n        type: \"string\",\n        describe: \"The directory containing your Zuplo API\",\n        default: \".\",\n        normalize: true,\n        hidden: true,\n      })\n      .option(\"start-editor\", {\n        type: \"boolean\",\n        describe: \"Start the editor with the local server\",\n        default: true,\n      })\n      .option(\"port\", {\n        type: \"number\",\n        describe: \"The port to run the local server on\",\n        default: 9000,\n      })\n      .option(\"editor-port\", {\n        type: \"number\",\n        describe: \"The port to run the route designer on\",\n        default: 9100,\n      })\n      .option(\"debug-port\", {\n        type: \"number\",\n        describe: \"The port to run the Chrome inspector on\",\n      })\n      .option(\"unsafely-ignore-certificate-errors\", {\n        type: \"boolean\",\n        describe: \"Unsafely ignore certificate errors\",\n        default: false,\n      })\n      .example([\n        [\n          \"$0 dev\",\n          \"Start the local development server with default settings (port 9000 for API, port 9100 for editor)\",\n        ],\n        [\"$0 dev --port 8080\", \"Start the local server on a custom port\"],\n        [\n          \"$0 dev --no-start-editor\",\n          \"Start only the API server without opening the editor\",\n        ],\n        [\n          \"$0 dev --debug-port 9229\",\n          \"Start with Chrome DevTools inspector enabled on port 9229\",\n        ],\n      ])\n      .middleware([setBlocking, identify])\n      .check(async (argv) => {\n        return await new YargsChecker<typeof argv>(\n          new ZuploProjectValidator()\n        ).check(argv);\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      properties: {\n        \"debug-port\": (argv as Arguments)[\"debugPort\"],\n        \"unsafely-ignore-certificate-errors\": (argv as Arguments)[\n          \"unsafelyIgnoreCertificateErrors\"\n        ],\n      },\n      event: \"zuplo dev\",\n    });\n    await dev(argv as Arguments);\n  },\n};\n"]}
+{"version":3,"file":"dev.js","sourceRoot":"","sources":["../../src/cmds/dev.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,WAAW,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAa,GAAG,EAAE,MAAM,mBAAmB,CAAC;AAEnD,eAAe;IACb,IAAI,EAAE,4BAA4B;IAClC,OAAO,EAAE,KAAK;IACd,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,kBAAkB,CAAC;aACzB,MAAM,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,yCAAyC;YACnD,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;SACb,CAAC;aACD,MAAM,CAAC,cAAc,EAAE;YACtB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,wCAAwC;YAClD,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,qCAAqC;YAC/C,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,aAAa,EAAE;YACrB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,uCAAuC;YACjD,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,YAAY,EAAE;YACpB,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,wDAAwD;YAClE,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,WAAW,EAAE;YACnB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,oCAAoC;YAC9C,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,YAAY,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,yCAAyC;SACpD,CAAC;aACD,MAAM,CAAC,oCAAoC,EAAE;YAC5C,IAAI,EAAE,SAAS;YACf,QAAQ,EAAE,oCAAoC;YAC9C,OAAO,EAAE,KAAK;SACf,CAAC;aACD,OAAO,CAAC;YACP;gBACE,QAAQ;gBACR,wHAAwH;aACzH;YACD,CAAC,oBAAoB,EAAE,yCAAyC,CAAC;YACjE;gBACE,0BAA0B;gBAC1B,sDAAsD;aACvD;YACD;gBACE,wBAAwB;gBACxB,8CAA8C;aAC/C;YACD;gBACE,0BAA0B;gBAC1B,2DAA2D;aAC5D;SACF,CAAC;aACD,UAAU,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;aACnC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,OAAO,MAAM,IAAI,YAAY,CAC3B,IAAI,qBAAqB,EAAE,CAC5B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,UAAU,EAAE;gBACV,YAAY,EAAG,IAAkB,CAAC,WAAW,CAAC;gBAC9C,oCAAoC,EAAG,IAAkB,CACvD,iCAAiC,CAClC;aACF;YACD,KAAK,EAAE,WAAW;SACnB,CAAC,CAAC;QACH,MAAM,GAAG,CAAC,IAAiB,CAAC,CAAC;IAC/B,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../common/analytics/lib.js\";\nimport { identify } from \"../common/middleware/user-identification.js\";\nimport setBlocking from \"../common/output.js\";\nimport { ZuploProjectValidator } from \"../common/validators/file-system-validator.js\";\nimport { YargsChecker } from \"../common/validators/lib.js\";\nimport { Arguments, dev } from \"../dev/handler.js\";\n\nexport default {\n  desc: \"Runs the Zuplo API locally\",\n  command: \"dev\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 dev [options]\")\n      .option(\"dir\", {\n        type: \"string\",\n        describe: \"The directory containing your Zuplo API\",\n        default: \".\",\n        normalize: true,\n        hidden: true,\n      })\n      .option(\"start-editor\", {\n        type: \"boolean\",\n        describe: \"Start the editor with the local server\",\n        default: true,\n      })\n      .option(\"port\", {\n        type: \"number\",\n        describe: \"The port to run the local server on\",\n        default: 9000,\n      })\n      .option(\"editor-port\", {\n        type: \"number\",\n        describe: \"The port to run the route designer on\",\n        default: 9100,\n      })\n      .option(\"start-docs\", {\n        type: \"boolean\",\n        describe: \"Start the docs server with the local development setup\",\n        default: true,\n      })\n      .option(\"docs-port\", {\n        type: \"number\",\n        describe: \"The port to run the docs server on\",\n        default: 9200,\n      })\n      .option(\"debug-port\", {\n        type: \"number\",\n        describe: \"The port to run the Chrome inspector on\",\n      })\n      .option(\"unsafely-ignore-certificate-errors\", {\n        type: \"boolean\",\n        describe: \"Unsafely ignore certificate errors\",\n        default: false,\n      })\n      .example([\n        [\n          \"$0 dev\",\n          \"Start the local development server with default settings (port 9000 for API, port 9100 for editor, port 9200 for docs)\",\n        ],\n        [\"$0 dev --port 8080\", \"Start the local server on a custom port\"],\n        [\n          \"$0 dev --no-start-editor\",\n          \"Start only the API server without opening the editor\",\n        ],\n        [\n          \"$0 dev --no-start-docs\",\n          \"Start the API server without the docs server\",\n        ],\n        [\n          \"$0 dev --debug-port 9229\",\n          \"Start with Chrome DevTools inspector enabled on port 9229\",\n        ],\n      ])\n      .middleware([setBlocking, identify])\n      .check(async (argv) => {\n        return await new YargsChecker<typeof argv>(\n          new ZuploProjectValidator()\n        ).check(argv);\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      properties: {\n        \"debug-port\": (argv as Arguments)[\"debugPort\"],\n        \"unsafely-ignore-certificate-errors\": (argv as Arguments)[\n          \"unsafelyIgnoreCertificateErrors\"\n        ],\n      },\n      event: \"zuplo dev\",\n    });\n    await dev(argv as Arguments);\n  },\n};\n"]}

package/dist/cmds/docs.d.ts

@@ -0,0 +1,9 @@
+import { Argv } from "yargs";
+declare const _default: {
+  desc: string;
+  command: string;
+  builder: (yargs: Argv) => Argv<unknown>;
+  handler: (argv: unknown) => Promise<void>;
+};
+export default _default;
+//# sourceMappingURL=docs.d.ts.map

package/dist/cmds/docs.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.d.ts","sourceRoot":"","sources":["../../src/cmds/docs.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAAE,MAAM,OAAO,CAAC;;;;qBAWV,IAAI,KAAG,IAAI,CAAC,OAAO,CAAC;oBAuCf,OAAO;;AA1C/B,wBAqDE"}

package/dist/cmds/docs.js

@@ -0,0 +1,58 @@
+import { captureEvent } from "../common/analytics/lib.js";
+import { identify } from "../common/middleware/user-identification.js";
+import setBlocking from "../common/output.js";
+import { ZuploProjectValidator } from "../common/validators/file-system-validator.js";
+import { YargsChecker } from "../common/validators/lib.js";
+import { docs } from "../docs/handler.js";
+export default {
+    desc: "Runs the Zuplo docs server locally",
+    command: "docs",
+    builder: (yargs) => {
+        return yargs
+            .usage("$0 docs [options]")
+            .option("dir", {
+            type: "string",
+            describe: "The directory containing your Zuplo API",
+            default: ".",
+            normalize: true,
+            hidden: true,
+        })
+            .option("port", {
+            type: "number",
+            describe: "The port to run the docs server on",
+            default: 9200,
+        })
+            .option("server-url", {
+            type: "string",
+            describe: "The URL of the Zuplo API server to use (e.g., https://my-api.zuplo.dev)",
+        })
+            .example([
+            ["$0 docs", "Start the docs server with default settings (port 9200)"],
+            ["$0 docs --port 3000", "Start the docs server on a custom port"],
+            [
+                "$0 docs --server-url https://my-api.zuplo.dev",
+                "Start the docs server pointing to a remote Zuplo API",
+            ],
+            [
+                "$0 docs --server-url http://localhost:9000",
+                "Start the docs server pointing to a local Zuplo API",
+            ],
+        ])
+            .middleware([setBlocking, identify])
+            .check(async (argv) => {
+            return await new YargsChecker(new ZuploProjectValidator()).check(argv);
+        });
+    },
+    handler: async (argv) => {
+        await captureEvent({
+            argv,
+            properties: {
+                port: argv.port,
+                "server-url": argv.serverUrl,
+            },
+            event: "zuplo docs",
+        });
+        await docs(argv);
+    },
+};
+//# sourceMappingURL=docs.js.map

package/dist/cmds/docs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"docs.js","sourceRoot":"","sources":["../../src/cmds/docs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,YAAY,EAAE,MAAM,4BAA4B,CAAC;AAC1D,OAAO,EAAE,QAAQ,EAAE,MAAM,6CAA6C,CAAC;AACvE,OAAO,WAAW,MAAM,qBAAqB,CAAC;AAC9C,OAAO,EAAE,qBAAqB,EAAE,MAAM,+CAA+C,CAAC;AACtF,OAAO,EAAE,YAAY,EAAE,MAAM,6BAA6B,CAAC;AAC3D,OAAO,EAAa,IAAI,EAAE,MAAM,oBAAoB,CAAC;AAErD,eAAe;IACb,IAAI,EAAE,oCAAoC;IAC1C,OAAO,EAAE,MAAM;IACf,OAAO,EAAE,CAAC,KAAW,EAAiB,EAAE;QACtC,OAAO,KAAK;aACT,KAAK,CAAC,mBAAmB,CAAC;aAC1B,MAAM,CAAC,KAAK,EAAE;YACb,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,yCAAyC;YACnD,OAAO,EAAE,GAAG;YACZ,SAAS,EAAE,IAAI;YACf,MAAM,EAAE,IAAI;SACb,CAAC;aACD,MAAM,CAAC,MAAM,EAAE;YACd,IAAI,EAAE,QAAQ;YACd,QAAQ,EAAE,oCAAoC;YAC9C,OAAO,EAAE,IAAI;SACd,CAAC;aACD,MAAM,CAAC,YAAY,EAAE;YACpB,IAAI,EAAE,QAAQ;YACd,QAAQ,EACN,yEAAyE;SAC5E,CAAC;aACD,OAAO,CAAC;YACP,CAAC,SAAS,EAAE,yDAAyD,CAAC;YACtE,CAAC,qBAAqB,EAAE,wCAAwC,CAAC;YACjE;gBACE,+CAA+C;gBAC/C,sDAAsD;aACvD;YACD;gBACE,4CAA4C;gBAC5C,qDAAqD;aACtD;SACF,CAAC;aACD,UAAU,CAAC,CAAC,WAAW,EAAE,QAAQ,CAAC,CAAC;aACnC,KAAK,CAAC,KAAK,EAAE,IAAI,EAAE,EAAE;YACpB,OAAO,MAAM,IAAI,YAAY,CAC3B,IAAI,qBAAqB,EAAE,CAC5B,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;QAChB,CAAC,CAAC,CAAC;IACP,CAAC;IACD,OAAO,EAAE,KAAK,EAAE,IAAa,EAAE,EAAE;QAC/B,MAAM,YAAY,CAAC;YACjB,IAAI;YACJ,UAAU,EAAE;gBACV,IAAI,EAAG,IAAkB,CAAC,IAAI;gBAC9B,YAAY,EAAG,IAAkB,CAAC,SAAS;aAC5C;YACD,KAAK,EAAE,YAAY;SACpB,CAAC,CAAC;QACH,MAAM,IAAI,CAAC,IAAiB,CAAC,CAAC;IAChC,CAAC;CACF,CAAC","sourcesContent":["import { Argv } from \"yargs\";\nimport { captureEvent } from \"../common/analytics/lib.js\";\nimport { identify } from \"../common/middleware/user-identification.js\";\nimport setBlocking from \"../common/output.js\";\nimport { ZuploProjectValidator } from \"../common/validators/file-system-validator.js\";\nimport { YargsChecker } from \"../common/validators/lib.js\";\nimport { Arguments, docs } from \"../docs/handler.js\";\n\nexport default {\n  desc: \"Runs the Zuplo docs server locally\",\n  command: \"docs\",\n  builder: (yargs: Argv): Argv<unknown> => {\n    return yargs\n      .usage(\"$0 docs [options]\")\n      .option(\"dir\", {\n        type: \"string\",\n        describe: \"The directory containing your Zuplo API\",\n        default: \".\",\n        normalize: true,\n        hidden: true,\n      })\n      .option(\"port\", {\n        type: \"number\",\n        describe: \"The port to run the docs server on\",\n        default: 9200,\n      })\n      .option(\"server-url\", {\n        type: \"string\",\n        describe:\n          \"The URL of the Zuplo API server to use (e.g., https://my-api.zuplo.dev)\",\n      })\n      .example([\n        [\"$0 docs\", \"Start the docs server with default settings (port 9200)\"],\n        [\"$0 docs --port 3000\", \"Start the docs server on a custom port\"],\n        [\n          \"$0 docs --server-url https://my-api.zuplo.dev\",\n          \"Start the docs server pointing to a remote Zuplo API\",\n        ],\n        [\n          \"$0 docs --server-url http://localhost:9000\",\n          \"Start the docs server pointing to a local Zuplo API\",\n        ],\n      ])\n      .middleware([setBlocking, identify])\n      .check(async (argv) => {\n        return await new YargsChecker<typeof argv>(\n          new ZuploProjectValidator()\n        ).check(argv);\n      });\n  },\n  handler: async (argv: unknown) => {\n    await captureEvent({\n      argv,\n      properties: {\n        port: (argv as Arguments).port,\n        \"server-url\": (argv as Arguments).serverUrl,\n      },\n      event: \"zuplo docs\",\n    });\n    await docs(argv as Arguments);\n  },\n};\n"]}

package/dist/common/utils/prefixed-output.d.ts

@@ -0,0 +1,11 @@
+import { Transform } from "node:stream";
+import { ChalkInstance } from "chalk";
+export interface PrefixedTransformOutputOptions {
+  name: string;
+  color: ChalkInstance;
+  maxPrefixLength?: number;
+}
+export declare function createPrefixedTransform(
+  options: PrefixedTransformOutputOptions
+): Transform;
+//# sourceMappingURL=prefixed-output.d.ts.map

package/dist/common/utils/prefixed-output.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefixed-output.d.ts","sourceRoot":"","sources":["../../../src/common/utils/prefixed-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,aAAa,CAAC;AAC3D,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAE7C,MAAM,WAAW,8BAA8B;IAC7C,IAAI,EAAE,MAAM,CAAC;IACb,KAAK,EAAE,aAAa,CAAC;IACrB,eAAe,CAAC,EAAE,MAAM,CAAC;CAC1B;AAED,wBAAgB,uBAAuB,CACrC,OAAO,EAAE,8BAA8B,GACtC,SAAS,CAiCX"}

package/dist/common/utils/prefixed-output.js

@@ -0,0 +1,28 @@
+import { Transform } from "node:stream";
+import chalk from "chalk";
+export function createPrefixedTransform(options) {
+    const maxLen = options.maxPrefixLength ?? 10;
+    const paddedName = options.name.padEnd(maxLen);
+    const prefix = options.color(paddedName) + chalk.gray(" | ");
+    let buffer = "";
+    return new Transform({
+        transform(chunk, _encoding, callback) {
+            const data = buffer + chunk.toString();
+            const lines = data.split("\n");
+            buffer = lines.pop() ?? "";
+            for (const line of lines) {
+                if (line.trim()) {
+                    this.push(`${prefix}${line}\n`);
+                }
+            }
+            callback();
+        },
+        flush(callback) {
+            if (buffer.trim()) {
+                this.push(`${prefix}${buffer}\n`);
+            }
+            callback();
+        },
+    });
+}
+//# sourceMappingURL=prefixed-output.js.map

package/dist/common/utils/prefixed-output.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prefixed-output.js","sourceRoot":"","sources":["../../../src/common/utils/prefixed-output.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAqB,MAAM,aAAa,CAAC;AAC3D,OAAO,KAAwB,MAAM,OAAO,CAAC;AAQ7C,MAAM,UAAU,uBAAuB,CACrC,OAAuC;IAEvC,MAAM,MAAM,GAAG,OAAO,CAAC,eAAe,IAAI,EAAE,CAAC;IAC7C,MAAM,UAAU,GAAG,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC;IAC/C,MAAM,MAAM,GAAG,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,KAAK,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC;IAE7D,IAAI,MAAM,GAAG,EAAE,CAAC;IAEhB,OAAO,IAAI,SAAS,CAAC;QACnB,SAAS,CACP,KAAsB,EACtB,SAAyB,EACzB,QAA2B;YAE3B,MAAM,IAAI,GAAG,MAAM,GAAG,KAAK,CAAC,QAAQ,EAAE,CAAC;YACvC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC;YAE/B,MAAM,GAAG,KAAK,CAAC,GAAG,EAAE,IAAI,EAAE,CAAC;YAE3B,KAAK,MAAM,IAAI,IAAI,KAAK,EAAE,CAAC;gBACzB,IAAI,IAAI,CAAC,IAAI,EAAE,EAAE,CAAC;oBAChB,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,IAAI,IAAI,CAAC,CAAC;gBAClC,CAAC;YACH,CAAC;YAED,QAAQ,EAAE,CAAC;QACb,CAAC;QACD,KAAK,CAAC,QAA2B;YAC/B,IAAI,MAAM,CAAC,IAAI,EAAE,EAAE,CAAC;gBAClB,IAAI,CAAC,IAAI,CAAC,GAAG,MAAM,GAAG,MAAM,IAAI,CAAC,CAAC;YACpC,CAAC;YACD,QAAQ,EAAE,CAAC;QACb,CAAC;KACF,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { Transform, TransformCallback } from \"node:stream\";\nimport chalk, { ChalkInstance } from \"chalk\";\n\nexport interface PrefixedTransformOutputOptions {\n  name: string;\n  color: ChalkInstance;\n  maxPrefixLength?: number;\n}\n\nexport function createPrefixedTransform(\n  options: PrefixedTransformOutputOptions\n): Transform {\n  const maxLen = options.maxPrefixLength ?? 10;\n  const paddedName = options.name.padEnd(maxLen);\n  const prefix = options.color(paddedName) + chalk.gray(\" | \");\n\n  let buffer = \"\";\n\n  return new Transform({\n    transform(\n      chunk: Buffer | string,\n      _encoding: BufferEncoding,\n      callback: TransformCallback\n    ) {\n      const data = buffer + chunk.toString();\n      const lines = data.split(\"\\n\");\n\n      buffer = lines.pop() ?? \"\";\n\n      for (const line of lines) {\n        if (line.trim()) {\n          this.push(`${prefix}${line}\\n`);\n        }\n      }\n\n      callback();\n    },\n    flush(callback: TransformCallback) {\n      if (buffer.trim()) {\n        this.push(`${prefix}${buffer}\\n`);\n      }\n      callback();\n    },\n  });\n}\n"]}

package/dist/common/worker-output.d.ts

@@ -1,12 +1,7 @@
 import { Readable } from "node:stream";
-import { LogLevel } from "@zuplo/core/cli";
-export declare function handleRuntimeStdio(
-  stdout: Readable,
-  stderr: Readable
-): void;
-export declare function logConsole(level: LogLevel, data: string): void;
-export declare function logConsoleAsync(
-  level: LogLevel,
-  data: string
-): Promise<void>;
+import { ChalkInstance } from "chalk";
+export declare function createRuntimeStdioHandler(options?: {
+  prefix?: string;
+  prefixColor?: ChalkInstance;
+}): (stdout: Readable, stderr: Readable) => void;
 //# sourceMappingURL=worker-output.d.ts.map

package/dist/common/worker-output.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"worker-output.d.ts","sourceRoot":"","sources":["../../src/common/worker-output.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AACvC,OAAO,EAAiC,QAAQ,EAAE,MAAM,iBAAiB,CAAC;AAM1E,wBAAgB,kBAAkB,CAAC,MAAM,EAAE,QAAQ,EAAE,MAAM,EAAE,QAAQ,QAoMpE;AAED,wBAAgB,UAAU,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,QAEvD;AAKD,wBAAsB,eAAe,CAAC,KAAK,EAAE,QAAQ,EAAE,IAAI,EAAE,MAAM,iBA2ClE"}
+{"version":3,"file":"worker-output.d.ts","sourceRoot":"","sources":["../../src/common/worker-output.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,QAAQ,EAAE,MAAM,aAAa,CAAC;AAEvC,OAAc,EAAE,aAAa,EAAE,MAAM,OAAO,CAAC;AAM7C,wBAAgB,yBAAyB,CAAC,OAAO,CAAC,EAAE;IAClD,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,WAAW,CAAC,EAAE,aAAa,CAAC;CAC7B,IACoC,QAAQ,QAAQ,EAAE,QAAQ,QAAQ,UAwMtE"}

package/dist/common/worker-output.js

@@ -1,140 +1,149 @@
 import { readFile } from "node:fs/promises";
 import { LogFormatter } from "@zuplo/core/cli";
+import chalk from "chalk";
 const logFormatter = new LogFormatter(async (path) => {
     return readFile(path, { encoding: "utf8" });
 });
-export function handleRuntimeStdio(stdout, stderr) {
-    let stdoutAccumulator = "";
-    let stderrAccumulator = "";
-    const classifiers = {
-        isBarf(chunk) {
-            const containsLlvmSymbolizerWarning = chunk.includes("Not symbolizing stack traces because $LLVM_SYMBOLIZER is not set");
-            const containsRecursiveIsolateLockWarning = chunk.includes("took recursive isolate lock");
-            const containsHexStack = /stack:( (0|[a-f\d]{4,})){3,}/.test(chunk);
-            return (containsLlvmSymbolizerWarning ||
-                containsRecursiveIsolateLockWarning ||
-                containsHexStack);
-        },
-        isAddressInUse(chunk) {
-            return chunk.includes("Address already in use; toString() = ");
-        },
-        isWarning(chunk) {
-            return /\.c\+\+:\d+: warning:/.test(chunk);
-        },
-        isCodeMovedWarning(chunk) {
-            return /CODE_MOVED for unknown code block/.test(chunk);
-        },
-        isAccessViolation(chunk) {
-            return chunk.includes("access violation;");
-        },
-        isZenoLog(chunk) {
-            return chunk.startsWith("[ZENO]:");
-        },
-    };
-    stdout.on("data", (chunk) => {
-        const fullStreamOutput = `${stdoutAccumulator}${chunk}`;
-        let currentLogsStr = "";
-        const lastNewlineIdx = fullStreamOutput.lastIndexOf("\n");
-        if (lastNewlineIdx > 0) {
-            currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);
-            stdoutAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);
-        }
-        else {
-            stdoutAccumulator = fullStreamOutput;
-            return;
-        }
-        const lines = currentLogsStr.split("\n");
-        for (let line of lines) {
-            line = line.trim();
-            if (!line)
-                continue;
-            if (classifiers.isBarf(line)) {
-                logConsole("debug", line);
+export function createRuntimeStdioHandler(options) {
+    return function handleRuntimeStdio(stdout, stderr) {
+        const { prefix, prefixColor } = options ?? {};
+        let stdoutAccumulator = "";
+        let stderrAccumulator = "";
+        const classifiers = {
+            isBarf(chunk) {
+                const containsLlvmSymbolizerWarning = chunk.includes("Not symbolizing stack traces because $LLVM_SYMBOLIZER is not set");
+                const containsRecursiveIsolateLockWarning = chunk.includes("took recursive isolate lock");
+                const containsHexStack = /stack:( (0|[a-f\d]{4,})){3,}/.test(chunk);
+                return (containsLlvmSymbolizerWarning ||
+                    containsRecursiveIsolateLockWarning ||
+                    containsHexStack);
+            },
+            isAddressInUse(chunk) {
+                return chunk.includes("Address already in use; toString() = ");
+            },
+            isWarning(chunk) {
+                return /\.c\+\+:\d+: warning:/.test(chunk);
+            },
+            isCodeMovedWarning(chunk) {
+                return /CODE_MOVED for unknown code block/.test(chunk);
+            },
+            isAccessViolation(chunk) {
+                return chunk.includes("access violation;");
+            },
+            isZenoLog(chunk) {
+                return chunk.startsWith("[ZENO]:");
+            },
+        };
+        stdout.on("data", (chunk) => {
+            const fullStreamOutput = `${stdoutAccumulator}${chunk}`;
+            let currentLogsStr = "";
+            const lastNewlineIdx = fullStreamOutput.lastIndexOf("\n");
+            if (lastNewlineIdx > 0) {
+                currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);
+                stdoutAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);
             }
-            else if (classifiers.isWarning(line)) {
-                logConsole("warn", line);
+            else {
+                stdoutAccumulator = fullStreamOutput;
+                return;
             }
-            else if (classifiers.isZenoLog(line)) {
-                const levels = ["debug", "info", "warn", "error"];
-                const level = levels.find((level) => line.includes(`[${level.toUpperCase()}]`));
-                line = line.substring("[ZENO]:".length);
-                line = line.substring(`[${level?.toUpperCase()}]`.length);
-                if (level) {
-                    logConsole(level, line);
+            const lines = currentLogsStr.split("\n");
+            for (let line of lines) {
+                line = line.trim();
+                if (!line)
+                    continue;
+                if (classifiers.isBarf(line)) {
+                    logConsole("debug", line, prefix, prefixColor);
+                }
+                else if (classifiers.isWarning(line)) {
+                    logConsole("warn", line, prefix, prefixColor);
+                }
+                else if (classifiers.isZenoLog(line)) {
+                    const levels = ["debug", "info", "warn", "error"];
+                    const level = levels.find((level) => line.includes(`[${level.toUpperCase()}]`));
+                    line = line.substring("[ZENO]:".length);
+                    line = line.substring(`[${level?.toUpperCase()}]`.length);
+                    if (level) {
+                        logConsole(level, line, prefix, prefixColor);
+                    }
+                    else {
+                        logConsole("info", line, prefix, prefixColor);
+                    }
                 }
                 else {
-                    logConsole("info", line);
+                    logConsole("error", line, prefix, prefixColor);
                 }
             }
+        });
+        stderr.on("data", (chunk) => {
+            const fullStreamOutput = `${stderrAccumulator}${chunk}`;
+            let currentLogsStr = "";
+            const lastNewlineIdx = fullStreamOutput.lastIndexOf("\n");
+            if (lastNewlineIdx > 0) {
+                currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);
+                stderrAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);
+            }
             else {
-                logConsole("error", line);
+                stderrAccumulator = fullStreamOutput;
+                return;
             }
-        }
-    });
-    stderr.on("data", (chunk) => {
-        const fullStreamOutput = `${stderrAccumulator}${chunk}`;
-        let currentLogsStr = "";
-        const lastNewlineIdx = fullStreamOutput.lastIndexOf("\n");
-        if (lastNewlineIdx > 0) {
-            currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);
-            stderrAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);
-        }
-        else {
-            stderrAccumulator = fullStreamOutput;
-            return;
-        }
-        const lines = currentLogsStr.split("\n");
-        for (let line of lines) {
-            line = line.trim();
-            if (!line)
-                continue;
-            if (classifiers.isBarf(line)) {
-                if (classifiers.isAddressInUse(line)) {
-                    const address = line.match(/Address already in use; toString\(\) = (.+)\n/)?.[1];
-                    logConsole("error", `Address already in use (${address}). Please check that you are not already running a server on this address or specify a different port with --port.`);
-                    logConsole("debug", line);
-                }
-                else if (classifiers.isAccessViolation(line)) {
-                    let error = "There was an access violation in the runtime.";
-                    if (process.platform === "win32") {
-                        error +=
-                            "\nOn Windows, this may be caused by an outdated Microsoft Visual C++ Redistributable library.\n" +
-                                "Check that you have the latest version installed.\n" +
-                                "See https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist.";
+            const lines = currentLogsStr.split("\n");
+            for (let line of lines) {
+                line = line.trim();
+                if (!line)
+                    continue;
+                if (classifiers.isBarf(line)) {
+                    if (classifiers.isAddressInUse(line)) {
+                        const address = line.match(/Address already in use; toString\(\) = (.+)\n/)?.[1];
+                        logConsole("error", `Address already in use (${address}). Please check that you are not already running a server on this address or specify a different port with --port.`, prefix, prefixColor);
+                        logConsole("debug", line, prefix, prefixColor);
+                    }
+                    else if (classifiers.isAccessViolation(line)) {
+                        let error = "There was an access violation in the runtime.";
+                        if (process.platform === "win32") {
+                            error +=
+                                "\nOn Windows, this may be caused by an outdated Microsoft Visual C++ Redistributable library.\n" +
+                                    "Check that you have the latest version installed.\n" +
+                                    "See https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist.";
+                        }
+                        logConsole("error", error, prefix, prefixColor);
+                        logConsole("debug", line, prefix, prefixColor);
                     }
-                    logConsole("error", error);
-                    logConsole("debug", line);
+                    else {
+                        logConsole("debug", line, prefix, prefixColor);
+                    }
+                }
+                else if (classifiers.isWarning(line)) {
+                    logConsole("warn", line, prefix, prefixColor);
+                }
+                else if (classifiers.isCodeMovedWarning(line)) {
+                }
+                else if (classifiers.isZenoLog(line)) {
+                    line = line.substring("[ZENO]:".length);
+                    line = line.substring("[ERROR]".length);
+                    logConsole("error", line, prefix, prefixColor);
                 }
                 else {
-                    logConsole("debug", line);
+                    logConsole("error", line, prefix, prefixColor);
                 }
             }
-            else if (classifiers.isWarning(line)) {
-                logConsole("warn", line);
-            }
-            else if (classifiers.isCodeMovedWarning(line)) {
-            }
-            else if (classifiers.isZenoLog(line)) {
-                line = line.substring("[ZENO]:".length);
-                line = line.substring("[ERROR]".length);
-                logConsole("error", line);
-            }
-            else {
-                logConsole("error", line);
-            }
-        }
-    });
+        });
+    };
 }
-export function logConsole(level, data) {
-    void logConsoleAsync(level, data);
+function logConsole(level, data, prefix, prefixColor) {
+    void logConsoleAsync(level, data, prefix, prefixColor);
 }
-export async function logConsoleAsync(level, data) {
+async function logConsoleAsync(level, data, prefix, prefixColor) {
+    let outputPrefix = "";
+    if (prefix && prefixColor) {
+        const paddedName = prefix.padEnd(10);
+        outputPrefix = prefixColor(paddedName) + chalk.gray(" | ");
+    }
     try {
         if (!data) {
             return;
         }
         if (typeof data !== "string") {
-            console[level](data);
+            console[level](outputPrefix + data);
             return;
         }
         let message = data?.trim();
@@ -147,23 +156,23 @@ export async function logConsoleAsync(level, data) {
                 logEntry = JSON.parse(message);
             }
             catch {
-                console[level](data);
+                console[level](outputPrefix + data);
                 return;
             }
             await Promise.all(logEntry.messages.map(async (msg) => {
                 const line = await logFormatter.formatStructured(logEntry, msg);
-                console[level](line);
+                console[level](outputPrefix + line);
             }));
         }
         else {
             message = await logFormatter.formatMessage(message);
             const line = logFormatter.formatLine(level, message);
-            console[level](line);
+            console[level](outputPrefix + line);
         }
     }
     catch {
         const line = logFormatter.formatLine(level, data);
-        console[level](line);
+        console[level](outputPrefix + line);
     }
 }
 //# sourceMappingURL=worker-output.js.map

package/dist/common/worker-output.js.map

@@ -1 +1 @@
-{"version":3,"file":"worker-output.js","sourceRoot":"","sources":["../../src/common/worker-output.ts"],"names":[],"mappings":"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","sourcesContent":["/** biome-ignore-all lint/suspicious/noConsole: Output */\n\nimport { readFile } from \"node:fs/promises\";\nimport { Readable } from \"node:stream\";\nimport { ConsoleLogEntry, LogFormatter, LogLevel } from \"@zuplo/core/cli\";\n\nconst logFormatter = new LogFormatter(async (path: string) => {\n  return readFile(path, { encoding: \"utf8\" });\n});\n\nexport function handleRuntimeStdio(stdout: Readable, stderr: Readable) {\n  let stdoutAccumulator = \"\";\n  let stderrAccumulator = \"\";\n\n  const classifiers = {\n    // Is this chunk a big chonky barf from workerd that we want to hijack to cleanup/ignore?\n    isBarf(chunk: string) {\n      const containsLlvmSymbolizerWarning = chunk.includes(\n        \"Not symbolizing stack traces because $LLVM_SYMBOLIZER is not set\"\n      );\n      const containsRecursiveIsolateLockWarning = chunk.includes(\n        \"took recursive isolate lock\"\n      );\n      // Matches stack traces from workerd\n      //  - on unix: groups of 9 hex digits separated by spaces\n      //  - on windows: groups of 12 hex digits, or a single digit 0, separated by spaces\n      const containsHexStack = /stack:( (0|[a-f\\d]{4,})){3,}/.test(chunk);\n\n      return (\n        containsLlvmSymbolizerWarning ||\n        containsRecursiveIsolateLockWarning ||\n        containsHexStack\n      );\n    },\n    // Is this chunk an Address In Use error?\n    isAddressInUse(chunk: string) {\n      return chunk.includes(\"Address already in use; toString() = \");\n    },\n    isWarning(chunk: string) {\n      return /\\.c\\+\\+:\\d+: warning:/.test(chunk);\n    },\n    isCodeMovedWarning(chunk: string) {\n      return /CODE_MOVED for unknown code block/.test(chunk);\n    },\n    isAccessViolation(chunk: string) {\n      return chunk.includes(\"access violation;\");\n    },\n    isZenoLog(chunk: string) {\n      return chunk.startsWith(\"[ZENO]:\");\n    },\n  };\n\n  stdout.on(\"data\", (chunk: Buffer | string) => {\n    const fullStreamOutput = `${stdoutAccumulator}${chunk}`;\n\n    let currentLogsStr = \"\";\n    const lastNewlineIdx = fullStreamOutput.lastIndexOf(\"\\n\");\n\n    if (lastNewlineIdx > 0) {\n      // Extract complete logs up to the last newline\n      currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);\n      // Save the partial/incomplete log for next iteration\n      stdoutAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);\n    } else {\n      // No complete log found, accumulate entire output\n      stdoutAccumulator = fullStreamOutput;\n      return;\n    }\n\n    const lines = currentLogsStr.split(\"\\n\");\n\n    for (let line of lines) {\n      line = line.trim();\n      if (!line) continue;\n\n      if (classifiers.isBarf(line)) {\n        // this is a big chonky barf from workerd that we want to hijack to cleanup/ignore\n\n        // CLEANABLE:\n        // there are no known cases to cleanup yet\n        // but, as they are identified, we will do that here\n\n        // IGNORABLE:\n        // anything else not handled above is considered ignorable\n        // so send it to the debug logs which are discarded unless\n        // the user explicitly sets a logLevel indicating they care\n        logConsole(\"debug\", line);\n      }\n\n      // known case: warnings are not info, log them as such\n      else if (classifiers.isWarning(line)) {\n        logConsole(\"warn\", line);\n      } else if (classifiers.isZenoLog(line)) {\n        // Route to the specified logging level\n        const levels = [\"debug\", \"info\", \"warn\", \"error\"];\n        const level = levels.find((level) =>\n          line.includes(`[${level.toUpperCase()}]`)\n        );\n        // Strip the prefixes for zeno and the zeno logging level\n        line = line.substring(\"[ZENO]:\".length);\n        line = line.substring(`[${level?.toUpperCase()}]`.length);\n        if (level) {\n          logConsole(level as LogLevel, line);\n        } else {\n          logConsole(\"info\", line);\n        }\n      }\n\n      // anything not explicitly handled above should be logged as info (via stdout)\n      else {\n        logConsole(\"error\", line);\n      }\n    }\n  });\n\n  stderr.on(\"data\", (chunk: Buffer | string) => {\n    const fullStreamOutput = `${stderrAccumulator}${chunk}`;\n\n    let currentLogsStr = \"\";\n    const lastNewlineIdx = fullStreamOutput.lastIndexOf(\"\\n\");\n\n    if (lastNewlineIdx > 0) {\n      // Extract complete logs up to the last newline\n      currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);\n      // Save the partial/incomplete log for next iteration\n      stderrAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);\n    } else {\n      // No complete log found, accumulate entire output\n      stderrAccumulator = fullStreamOutput;\n      return;\n    }\n\n    const lines = currentLogsStr.split(\"\\n\");\n\n    for (let line of lines) {\n      line = line.trim();\n      if (!line) continue;\n\n      if (classifiers.isBarf(line)) {\n        // this is a big chonky barf from workerd that we want to hijack to cleanup/ignore\n\n        // CLEANABLE:\n        // known case to cleanup: Address in use errors\n        if (classifiers.isAddressInUse(line)) {\n          const address = line.match(\n            /Address already in use; toString\\(\\) = (.+)\\n/\n          )?.[1];\n\n          logConsole(\n            \"error\",\n            `Address already in use (${address}). Please check that you are not already running a server on this address or specify a different port with --port.`\n          );\n\n          // Log the original error to the debug logs.\n          logConsole(\"debug\", line);\n        }\n        // In the past we have seen Access Violation errors on Windows, which may be caused by an outdated\n        // version of the Windows OS or the Microsoft Visual C++ Redistributable.\n        // See https://github.com/cloudflare/workers-sdk/issues/6170#issuecomment-2245209918\n        else if (classifiers.isAccessViolation(line)) {\n          let error = \"There was an access violation in the runtime.\";\n          if (process.platform === \"win32\") {\n            error +=\n              \"\\nOn Windows, this may be caused by an outdated Microsoft Visual C++ Redistributable library.\\n\" +\n              \"Check that you have the latest version installed.\\n\" +\n              \"See https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist.\";\n          }\n          logConsole(\"error\", error);\n\n          // Log the original error to the debug logs.\n          logConsole(\"debug\", line);\n        }\n\n        // IGNORABLE:\n        // anything else not handled above is considered ignorable\n        // so send it to the debug logs which are discarded unless\n        // the user explicitly sets a logLevel indicating they care\n        else {\n          logConsole(\"debug\", line);\n        }\n      }\n\n      // known case: warnings are not errors, log them as such\n      else if (classifiers.isWarning(line)) {\n        logConsole(\"warn\", line);\n      }\n\n      // known case: \"error: CODE_MOVED for unknown code block?\", warning for workerd devs, not application devs\n      else if (classifiers.isCodeMovedWarning(line)) {\n        // ignore entirely, don't even send it to the debug log file\n      }\n\n      // Handle Zeno error logs\n      else if (classifiers.isZenoLog(line)) {\n        // Strip the prefixes\n        line = line.substring(\"[ZENO]:\".length);\n        line = line.substring(\"[ERROR]\".length);\n        logConsole(\"error\", line);\n      }\n\n      // anything not explicitly handled above should be logged as an error (via stderr)\n      else {\n        logConsole(\"error\", line);\n      }\n    }\n  });\n}\n\nexport function logConsole(level: LogLevel, data: string) {\n  void logConsoleAsync(level, data);\n}\n\n/**\n * This is what is logged when the runtime calls console.log, etc.\n */\nexport async function logConsoleAsync(level: LogLevel, data: string) {\n  try {\n    if (!data) {\n      return;\n    }\n\n    // This shouldn't happen, but just in case\n    if (typeof data !== \"string\") {\n      console[level](data);\n      return;\n    }\n\n    let message = data?.trim();\n    if (!message || message?.length === 0) {\n      return;\n    }\n\n    // Probably a JSON object\n    if (message.startsWith(`{`) && message.endsWith(`}`)) {\n      let logEntry: ConsoleLogEntry;\n      try {\n        logEntry = JSON.parse(message);\n      } catch {\n        console[level](data);\n        return;\n      }\n      await Promise.all(\n        logEntry.messages.map(async (msg) => {\n          const line = await logFormatter.formatStructured(logEntry, msg);\n          console[level](line);\n        })\n      );\n    } else {\n      message = await logFormatter.formatMessage(message);\n\n      const line = logFormatter.formatLine(level, message);\n      console[level](line);\n    }\n  } catch {\n    const line = logFormatter.formatLine(level, data);\n\n    console[level](line);\n  }\n}\n"]}
+{"version":3,"file":"worker-output.js","sourceRoot":"","sources":["../../src/common/worker-output.ts"],"names":[],"mappings":"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","sourcesContent":["/** biome-ignore-all lint/suspicious/noConsole: Output */\n\nimport { readFile } from \"node:fs/promises\";\nimport { Readable } from \"node:stream\";\nimport { ConsoleLogEntry, LogFormatter, LogLevel } from \"@zuplo/core/cli\";\nimport chalk, { ChalkInstance } from \"chalk\";\n\nconst logFormatter = new LogFormatter(async (path: string) => {\n  return readFile(path, { encoding: \"utf8\" });\n});\n\nexport function createRuntimeStdioHandler(options?: {\n  prefix?: string;\n  prefixColor?: ChalkInstance;\n}) {\n  return function handleRuntimeStdio(stdout: Readable, stderr: Readable) {\n    const { prefix, prefixColor } = options ?? {};\n    let stdoutAccumulator = \"\";\n    let stderrAccumulator = \"\";\n\n    const classifiers = {\n      // Is this chunk a big chonky barf from workerd that we want to hijack to cleanup/ignore?\n      isBarf(chunk: string) {\n        const containsLlvmSymbolizerWarning = chunk.includes(\n          \"Not symbolizing stack traces because $LLVM_SYMBOLIZER is not set\"\n        );\n        const containsRecursiveIsolateLockWarning = chunk.includes(\n          \"took recursive isolate lock\"\n        );\n        // Matches stack traces from workerd\n        //  - on unix: groups of 9 hex digits separated by spaces\n        //  - on windows: groups of 12 hex digits, or a single digit 0, separated by spaces\n        const containsHexStack = /stack:( (0|[a-f\\d]{4,})){3,}/.test(chunk);\n\n        return (\n          containsLlvmSymbolizerWarning ||\n          containsRecursiveIsolateLockWarning ||\n          containsHexStack\n        );\n      },\n      // Is this chunk an Address In Use error?\n      isAddressInUse(chunk: string) {\n        return chunk.includes(\"Address already in use; toString() = \");\n      },\n      isWarning(chunk: string) {\n        return /\\.c\\+\\+:\\d+: warning:/.test(chunk);\n      },\n      isCodeMovedWarning(chunk: string) {\n        return /CODE_MOVED for unknown code block/.test(chunk);\n      },\n      isAccessViolation(chunk: string) {\n        return chunk.includes(\"access violation;\");\n      },\n      isZenoLog(chunk: string) {\n        return chunk.startsWith(\"[ZENO]:\");\n      },\n    };\n\n    stdout.on(\"data\", (chunk: Buffer | string) => {\n      const fullStreamOutput = `${stdoutAccumulator}${chunk}`;\n\n      let currentLogsStr = \"\";\n      const lastNewlineIdx = fullStreamOutput.lastIndexOf(\"\\n\");\n\n      if (lastNewlineIdx > 0) {\n        // Extract complete logs up to the last newline\n        currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);\n        // Save the partial/incomplete log for next iteration\n        stdoutAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);\n      } else {\n        // No complete log found, accumulate entire output\n        stdoutAccumulator = fullStreamOutput;\n        return;\n      }\n\n      const lines = currentLogsStr.split(\"\\n\");\n\n      for (let line of lines) {\n        line = line.trim();\n        if (!line) continue;\n\n        if (classifiers.isBarf(line)) {\n          // this is a big chonky barf from workerd that we want to hijack to cleanup/ignore\n\n          // CLEANABLE:\n          // there are no known cases to cleanup yet\n          // but, as they are identified, we will do that here\n\n          // IGNORABLE:\n          // anything else not handled above is considered ignorable\n          // so send it to the debug logs which are discarded unless\n          // the user explicitly sets a logLevel indicating they care\n          logConsole(\"debug\", line, prefix, prefixColor);\n        }\n\n        // known case: warnings are not info, log them as such\n        else if (classifiers.isWarning(line)) {\n          logConsole(\"warn\", line, prefix, prefixColor);\n        } else if (classifiers.isZenoLog(line)) {\n          // Route to the specified logging level\n          const levels = [\"debug\", \"info\", \"warn\", \"error\"];\n          const level = levels.find((level) =>\n            line.includes(`[${level.toUpperCase()}]`)\n          );\n          // Strip the prefixes for zeno and the zeno logging level\n          line = line.substring(\"[ZENO]:\".length);\n          line = line.substring(`[${level?.toUpperCase()}]`.length);\n          if (level) {\n            logConsole(level as LogLevel, line, prefix, prefixColor);\n          } else {\n            logConsole(\"info\", line, prefix, prefixColor);\n          }\n        }\n\n        // anything not explicitly handled above should be logged as info (via stdout)\n        else {\n          logConsole(\"error\", line, prefix, prefixColor);\n        }\n      }\n    });\n\n    stderr.on(\"data\", (chunk: Buffer | string) => {\n      const fullStreamOutput = `${stderrAccumulator}${chunk}`;\n\n      let currentLogsStr = \"\";\n      const lastNewlineIdx = fullStreamOutput.lastIndexOf(\"\\n\");\n\n      if (lastNewlineIdx > 0) {\n        // Extract complete logs up to the last newline\n        currentLogsStr = fullStreamOutput.slice(0, lastNewlineIdx);\n        // Save the partial/incomplete log for next iteration\n        stderrAccumulator = fullStreamOutput.slice(lastNewlineIdx + 1);\n      } else {\n        // No complete log found, accumulate entire output\n        stderrAccumulator = fullStreamOutput;\n        return;\n      }\n\n      const lines = currentLogsStr.split(\"\\n\");\n\n      for (let line of lines) {\n        line = line.trim();\n        if (!line) continue;\n\n        if (classifiers.isBarf(line)) {\n          // this is a big chonky barf from workerd that we want to hijack to cleanup/ignore\n\n          // CLEANABLE:\n          // known case to cleanup: Address in use errors\n          if (classifiers.isAddressInUse(line)) {\n            const address = line.match(\n              /Address already in use; toString\\(\\) = (.+)\\n/\n            )?.[1];\n\n            logConsole(\n              \"error\",\n              `Address already in use (${address}). Please check that you are not already running a server on this address or specify a different port with --port.`,\n              prefix,\n              prefixColor\n            );\n\n            // Log the original error to the debug logs.\n            logConsole(\"debug\", line, prefix, prefixColor);\n          }\n          // In the past we have seen Access Violation errors on Windows, which may be caused by an outdated\n          // version of the Windows OS or the Microsoft Visual C++ Redistributable.\n          // See https://github.com/cloudflare/workers-sdk/issues/6170#issuecomment-2245209918\n          else if (classifiers.isAccessViolation(line)) {\n            let error = \"There was an access violation in the runtime.\";\n            if (process.platform === \"win32\") {\n              error +=\n                \"\\nOn Windows, this may be caused by an outdated Microsoft Visual C++ Redistributable library.\\n\" +\n                \"Check that you have the latest version installed.\\n\" +\n                \"See https://learn.microsoft.com/en-us/cpp/windows/latest-supported-vc-redist.\";\n            }\n            logConsole(\"error\", error, prefix, prefixColor);\n\n            // Log the original error to the debug logs.\n            logConsole(\"debug\", line, prefix, prefixColor);\n          }\n\n          // IGNORABLE:\n          // anything else not handled above is considered ignorable\n          // so send it to the debug logs which are discarded unless\n          // the user explicitly sets a logLevel indicating they care\n          else {\n            logConsole(\"debug\", line, prefix, prefixColor);\n          }\n        }\n\n        // known case: warnings are not errors, log them as such\n        else if (classifiers.isWarning(line)) {\n          logConsole(\"warn\", line, prefix, prefixColor);\n        }\n\n        // known case: \"error: CODE_MOVED for unknown code block?\", warning for workerd devs, not application devs\n        else if (classifiers.isCodeMovedWarning(line)) {\n          // ignore entirely, don't even send it to the debug log file\n        }\n\n        // Handle Zeno error logs\n        else if (classifiers.isZenoLog(line)) {\n          // Strip the prefixes\n          line = line.substring(\"[ZENO]:\".length);\n          line = line.substring(\"[ERROR]\".length);\n          logConsole(\"error\", line, prefix, prefixColor);\n        }\n\n        // anything not explicitly handled above should be logged as an error (via stderr)\n        else {\n          logConsole(\"error\", line, prefix, prefixColor);\n        }\n      }\n    });\n  };\n}\n\nfunction logConsole(\n  level: LogLevel,\n  data: string,\n  prefix?: string,\n  prefixColor?: ChalkInstance\n) {\n  void logConsoleAsync(level, data, prefix, prefixColor);\n}\n\n/**\n * This is what is logged when the runtime calls console.log, etc.\n */\nasync function logConsoleAsync(\n  level: LogLevel,\n  data: string,\n  prefix?: string,\n  prefixColor?: ChalkInstance\n) {\n  let outputPrefix = \"\";\n  if (prefix && prefixColor) {\n    const paddedName = prefix.padEnd(10);\n    outputPrefix = prefixColor(paddedName) + chalk.gray(\" | \");\n  }\n\n  try {\n    if (!data) {\n      return;\n    }\n\n    // This shouldn't happen, but just in case\n    if (typeof data !== \"string\") {\n      console[level](outputPrefix + data);\n      return;\n    }\n\n    let message = data?.trim();\n    if (!message || message?.length === 0) {\n      return;\n    }\n\n    // Probably a JSON object\n    if (message.startsWith(`{`) && message.endsWith(`}`)) {\n      let logEntry: ConsoleLogEntry;\n      try {\n        logEntry = JSON.parse(message);\n      } catch {\n        console[level](outputPrefix + data);\n        return;\n      }\n      await Promise.all(\n        logEntry.messages.map(async (msg) => {\n          const line = await logFormatter.formatStructured(logEntry, msg);\n          console[level](outputPrefix + line);\n        })\n      );\n    } else {\n      message = await logFormatter.formatMessage(message);\n\n      const line = logFormatter.formatLine(level, message);\n      console[level](outputPrefix + line);\n    }\n  } catch {\n    const line = logFormatter.formatLine(level, data);\n\n    console[level](outputPrefix + line);\n  }\n}\n"]}

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/compile/handler.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,SAAS,iBA+E5C"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/compile/handler.ts"],"names":[],"mappings":"AAcA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,aAAa,EAAE,MAAM,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,aAAa,EAAE,MAAM,CAAC;IACtB,UAAU,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,OAAO,CAAC,IAAI,EAAE,SAAS,iBAgF5C"}

package/dist/compile/handler.js

@@ -5,7 +5,7 @@ import { fileURLToPath } from "node:url";
 import dotenv from "dotenv";
 import { logger } from "../common/logger.js";
 import { ConsoleOutput, printCriticalFailureToConsoleAndExit, printDiagnosticsToConsole, printResultToConsoleAndExitGracefully, } from "../common/output.js";
-import { handleRuntimeStdio } from "../common/worker-output.js";
+import { createRuntimeStdioHandler } from "../common/worker-output.js";
 export async function compile(argv) {
     const sourceDirectory = resolve(argv.dir);
     const zuploRuntimePath = new URL("../../node_modules/@zuplo/runtime", import.meta.url);
@@ -25,6 +25,7 @@ export async function compile(argv) {
     const core = await import("@zuplo/core/cli");
     const zupPort = argv.port;
     const buildId = argv["build-id"] || randomUUID();
+    const handleRuntimeStdio = createRuntimeStdioHandler();
     try {
         await core.compileWorkerdServer({
             buildId,

package/dist/compile/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/compile/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,oCAAoC,EACpC,yBAAyB,EACzB,qCAAqC,GACtC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAUhE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAe;IAC3C,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAM1C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAC9B,mCAAmC,EACnC,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAC;IACF,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjC,MAAM,CACJ,gBAAgB,EAChB,IAAI,CAAC,eAAe,EAAE,6BAA6B,CAAC,EACpD;YACE,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;SAClB,CACF,CAAC;IACJ,CAAC;IAID,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,aAAa,CAChD,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC/C,CAAC;IAGF,IAAI,QAAQ,GAA6B,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QAC5C,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAMD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;IAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,EAAE,CAAC;IAEjD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,oBAAoB,CAAC;YAC9B,OAAO;YACP,MAAM,EAAE,IAAI,aAAa,EAAE;YAC3B,eAAe;YACf,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;YAC/B,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;YAC/B,+BAA+B,EAAE,QAAQ;gBACvC,CAAC,CAAC;oBAEE,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;oBAE/C,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;oBAE/C,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;iBACxD;gBACH,CAAC;oBACC,SAAS;YACb,MAAM;YACN,kBAAkB;SACnB,CAAC,CAAC;QAEH,yBAAyB,CAAC,yCAAyC,CAAC,CAAC;QACrE,MAAM,qCAAqC,CACzC,8BAA8B,eAAe,SAAS,IAAI,CAAC,aAAa,CAAC,EAAE,CAC5E,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,oCAAoC,CACxC,kCAAkC,CACnC,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { cpSync, existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport dotenv from \"dotenv\";\nimport { logger } from \"../common/logger.js\";\nimport {\n  ConsoleOutput,\n  printCriticalFailureToConsoleAndExit,\n  printDiagnosticsToConsole,\n  printResultToConsoleAndExitGracefully,\n} from \"../common/output.js\";\nimport { handleRuntimeStdio } from \"../common/worker-output.js\";\n\nexport interface Arguments {\n  dir: string;\n  \"bundled-dir\": string;\n  port: number;\n  \"binary-name\": string;\n  \"build-id\": string;\n}\n\nexport async function compile(argv: Arguments) {\n  const sourceDirectory = resolve(argv.dir);\n\n  // When we build, we MIGHT need to use the @zuplo/runtime from the node_modules if the user\n  // has installed our packages using https://www.npmjs.com/package/zuplo in a global directory\n\n  // Try to copy the @zuplo/runtime locally\n  const zuploRuntimePath = new URL(\n    \"../../node_modules/@zuplo/runtime\",\n    import.meta.url\n  );\n  if (existsSync(zuploRuntimePath)) {\n    cpSync(\n      zuploRuntimePath,\n      join(sourceDirectory, \"node_modules/@zuplo/runtime\"),\n      {\n        recursive: true,\n        dereference: true,\n      }\n    );\n  }\n\n  // Set GLOBAL_MODULE_LOCATION to the location of the CLIs node_modules\n  // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n  process.env.GLOBAL_MODULE_LOCATION = fileURLToPath(\n    new URL(\"../../node_modules\", import.meta.url)\n  );\n\n  // Check if the user has a .env.zuplo file\n  let envZuplo: dotenv.DotenvParseOutput = {};\n  const envZuploFile = join(sourceDirectory, \".env.zuplo\");\n  if (existsSync(envZuploFile)) {\n    const contents = readFileSync(envZuploFile);\n    envZuplo = dotenv.parse(contents);\n  }\n  // Set other variables using __ZUPLO_CONFIG as necessary\n  // const config = {\n  // };\n  // process.env.__ZUPLO_CONFIG = btoa(JSON.stringify(config));\n  // Use a dynamic import so that setting process.env has effect\n  const core = await import(\"@zuplo/core/cli\");\n\n  const zupPort = argv.port;\n\n  const buildId = argv[\"build-id\"] || randomUUID();\n\n  try {\n    await core.compileWorkerdServer({\n      buildId,\n      output: new ConsoleOutput(),\n      sourceDirectory,\n      bundledDir: argv[\"bundled-dir\"],\n      port: zupPort,\n      binaryName: argv[\"binary-name\"],\n      publicZuploEnvironmentVariables: envZuplo\n        ? {\n            // biome-ignore lint/style/useNamingConvention: External API property\n            ZUPLO_ACCOUNT_NAME: envZuplo.ZUPLO_ACCOUNT_NAME,\n            // biome-ignore lint/style/useNamingConvention: External API property\n            ZUPLO_PROJECT_NAME: envZuplo.ZUPLO_PROJECT_NAME,\n            // biome-ignore lint/style/useNamingConvention: External API property\n            ZUPLO_ENVIRONMENT_TYPE: envZuplo.ZUPLO_ENVIRONMENT_TYPE,\n          }\n        : // Leave this as undefined to simulate the old behavior\n          undefined,\n      logger,\n      handleRuntimeStdio,\n    });\n\n    printDiagnosticsToConsole(\"📦 Compiled a self-contained zup binary\");\n    await printResultToConsoleAndExitGracefully(\n      `The binary is available at ${sourceDirectory}/dist/${argv[\"binary-name\"]}`\n    );\n  } catch (err) {\n    printDiagnosticsToConsole(err.message);\n    await printCriticalFailureToConsoleAndExit(\n      \"Failed to compile the zup binary\"\n    );\n  }\n}\n"]}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/compile/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,oCAAoC,EACpC,yBAAyB,EACzB,qCAAqC,GACtC,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,yBAAyB,EAAE,MAAM,4BAA4B,CAAC;AAUvE,MAAM,CAAC,KAAK,UAAU,OAAO,CAAC,IAAe;IAC3C,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAM1C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAC9B,mCAAmC,EACnC,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAC;IACF,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjC,MAAM,CACJ,gBAAgB,EAChB,IAAI,CAAC,eAAe,EAAE,6BAA6B,CAAC,EACpD;YACE,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;SAClB,CACF,CAAC;IACJ,CAAC;IAID,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,aAAa,CAChD,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC/C,CAAC;IAGF,IAAI,QAAQ,GAA6B,EAAE,CAAC;IAC5C,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QAC5C,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;IACpC,CAAC;IAMD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;IAE1B,MAAM,OAAO,GAAG,IAAI,CAAC,UAAU,CAAC,IAAI,UAAU,EAAE,CAAC;IAEjD,MAAM,kBAAkB,GAAG,yBAAyB,EAAE,CAAC;IACvD,IAAI,CAAC;QACH,MAAM,IAAI,CAAC,oBAAoB,CAAC;YAC9B,OAAO;YACP,MAAM,EAAE,IAAI,aAAa,EAAE;YAC3B,eAAe;YACf,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;YAC/B,IAAI,EAAE,OAAO;YACb,UAAU,EAAE,IAAI,CAAC,aAAa,CAAC;YAC/B,+BAA+B,EAAE,QAAQ;gBACvC,CAAC,CAAC;oBAEE,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;oBAE/C,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;oBAE/C,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;iBACxD;gBACH,CAAC;oBACC,SAAS;YACb,MAAM;YACN,kBAAkB;SACnB,CAAC,CAAC;QAEH,yBAAyB,CAAC,yCAAyC,CAAC,CAAC;QACrE,MAAM,qCAAqC,CACzC,8BAA8B,eAAe,SAAS,IAAI,CAAC,aAAa,CAAC,EAAE,CAC5E,CAAC;IACJ,CAAC;IAAC,OAAO,GAAG,EAAE,CAAC;QACb,yBAAyB,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC;QACvC,MAAM,oCAAoC,CACxC,kCAAkC,CACnC,CAAC;IACJ,CAAC;AACH,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { cpSync, existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport dotenv from \"dotenv\";\nimport { logger } from \"../common/logger.js\";\nimport {\n  ConsoleOutput,\n  printCriticalFailureToConsoleAndExit,\n  printDiagnosticsToConsole,\n  printResultToConsoleAndExitGracefully,\n} from \"../common/output.js\";\nimport { createRuntimeStdioHandler } from \"../common/worker-output.js\";\n\nexport interface Arguments {\n  dir: string;\n  \"bundled-dir\": string;\n  port: number;\n  \"binary-name\": string;\n  \"build-id\": string;\n}\n\nexport async function compile(argv: Arguments) {\n  const sourceDirectory = resolve(argv.dir);\n\n  // When we build, we MIGHT need to use the @zuplo/runtime from the node_modules if the user\n  // has installed our packages using https://www.npmjs.com/package/zuplo in a global directory\n\n  // Try to copy the @zuplo/runtime locally\n  const zuploRuntimePath = new URL(\n    \"../../node_modules/@zuplo/runtime\",\n    import.meta.url\n  );\n  if (existsSync(zuploRuntimePath)) {\n    cpSync(\n      zuploRuntimePath,\n      join(sourceDirectory, \"node_modules/@zuplo/runtime\"),\n      {\n        recursive: true,\n        dereference: true,\n      }\n    );\n  }\n\n  // Set GLOBAL_MODULE_LOCATION to the location of the CLIs node_modules\n  // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n  process.env.GLOBAL_MODULE_LOCATION = fileURLToPath(\n    new URL(\"../../node_modules\", import.meta.url)\n  );\n\n  // Check if the user has a .env.zuplo file\n  let envZuplo: dotenv.DotenvParseOutput = {};\n  const envZuploFile = join(sourceDirectory, \".env.zuplo\");\n  if (existsSync(envZuploFile)) {\n    const contents = readFileSync(envZuploFile);\n    envZuplo = dotenv.parse(contents);\n  }\n  // Set other variables using __ZUPLO_CONFIG as necessary\n  // const config = {\n  // };\n  // process.env.__ZUPLO_CONFIG = btoa(JSON.stringify(config));\n  // Use a dynamic import so that setting process.env has effect\n  const core = await import(\"@zuplo/core/cli\");\n\n  const zupPort = argv.port;\n\n  const buildId = argv[\"build-id\"] || randomUUID();\n\n  const handleRuntimeStdio = createRuntimeStdioHandler();\n  try {\n    await core.compileWorkerdServer({\n      buildId,\n      output: new ConsoleOutput(),\n      sourceDirectory,\n      bundledDir: argv[\"bundled-dir\"],\n      port: zupPort,\n      binaryName: argv[\"binary-name\"],\n      publicZuploEnvironmentVariables: envZuplo\n        ? {\n            // biome-ignore lint/style/useNamingConvention: External API property\n            ZUPLO_ACCOUNT_NAME: envZuplo.ZUPLO_ACCOUNT_NAME,\n            // biome-ignore lint/style/useNamingConvention: External API property\n            ZUPLO_PROJECT_NAME: envZuplo.ZUPLO_PROJECT_NAME,\n            // biome-ignore lint/style/useNamingConvention: External API property\n            ZUPLO_ENVIRONMENT_TYPE: envZuplo.ZUPLO_ENVIRONMENT_TYPE,\n          }\n        : // Leave this as undefined to simulate the old behavior\n          undefined,\n      logger,\n      handleRuntimeStdio,\n    });\n\n    printDiagnosticsToConsole(\"📦 Compiled a self-contained zup binary\");\n    await printResultToConsoleAndExitGracefully(\n      `The binary is available at ${sourceDirectory}/dist/${argv[\"binary-name\"]}`\n    );\n  } catch (err) {\n    printDiagnosticsToConsole(err.message);\n    await printCriticalFailureToConsoleAndExit(\n      \"Failed to compile the zup binary\"\n    );\n  }\n}\n"]}

package/dist/dev/handler.d.ts

@@ -1,8 +1,10 @@
 export interface Arguments {
   dir: string;
   "start-editor": boolean;
+  "start-docs": boolean;
   port: number;
   editorPort: number;
+  docsPort: number;
   debugPort?: number;
   unsafelyIgnoreCertificateErrors?: boolean;
 }

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

@@ -1 +1 @@
-{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/dev/handler.ts"],"names":[],"mappings":"AAeA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,iBAoKxC"}
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/dev/handler.ts"],"names":[],"mappings":"AAmBA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,cAAc,EAAE,OAAO,CAAC;IACxB,YAAY,EAAE,OAAO,CAAC;IACtB,IAAI,EAAE,MAAM,CAAC;IACb,UAAU,EAAE,MAAM,CAAC;IACnB,QAAQ,EAAE,MAAM,CAAC;IACjB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,+BAA+B,CAAC,EAAE,OAAO,CAAC;CAC3C;AAED,wBAAsB,GAAG,CAAC,IAAI,EAAE,SAAS,iBA2PxC"}

package/dist/dev/handler.js

@@ -3,11 +3,14 @@ import { cpSync, existsSync, readFileSync } from "node:fs";
 import { join, resolve } from "node:path";
 import { fileURLToPath } from "node:url";
 import { LocalEditorServer } from "@zuplo/editor";
+import chalk from "chalk";
 import dotenv from "dotenv";
+import { execa } from "execa";
 import { logger } from "../common/logger.js";
-import { ConsoleOutput, printCriticalFailureToConsoleAndExit, printDiagnosticsToConsole, } from "../common/output.js";
+import { ConsoleOutput, printCriticalFailureToConsoleAndExit, printDiagnosticsToConsole, printWarningToConsole, } from "../common/output.js";
 import { isPortAvailable } from "../common/utils/ports.js";
-import { handleRuntimeStdio } from "../common/worker-output.js";
+import { createPrefixedTransform } from "../common/utils/prefixed-output.js";
+import { createRuntimeStdioHandler } from "../common/worker-output.js";
 export async function dev(argv) {
     const sourceDirectory = resolve(argv.dir);
     const zuploRuntimePath = new URL("../../node_modules/@zuplo/runtime", import.meta.url);
@@ -49,14 +52,32 @@ export async function dev(argv) {
             await printCriticalFailureToConsoleAndExit(`Port ${zupDebugPort} is already in use. Please specify a different port using --debug-port.`);
         }
     }
+    const docsDirectory = join(sourceDirectory, "docs");
+    const hasDocsDirectory = existsSync(docsDirectory);
+    if (!hasDocsDirectory) {
+        printWarningToConsole(`Warning: docs/ directory not found at ${docsDirectory}. Skipping docs server.`);
+    }
+    const startDocs = argv["start-docs"] && hasDocsDirectory;
+    const docsPort = argv.docsPort;
+    if (startDocs) {
+        const isDocsPortAvailable = await isPortAvailable("localhost", docsPort);
+        if (!isDocsPortAvailable) {
+            await printCriticalFailureToConsoleAndExit(`Port ${docsPort} is already in use. Please specify a different port using --docs-port.`);
+        }
+    }
     const buildId = randomUUID();
     let firstLoad = true;
+    const handleRuntimeStdio = createRuntimeStdioHandler({
+        prefix: "gateway",
+        prefixColor: chalk.cyan,
+    });
     await core.startDevServer({
         buildId,
         output: new ConsoleOutput(),
         sourceDirectory,
         port: zupPort,
         debugPort: argv.debugPort,
+        devPortalPort: startDocs ? docsPort : undefined,
         unsafelyIgnoreCertificateErrors: argv.unsafelyIgnoreCertificateErrors,
         publicZuploEnvironmentVariables: envZuplo
             ? {
@@ -87,6 +108,28 @@ export async function dev(argv) {
         });
         editor.start().catch((err) => logger.error(err));
     }
+    let docsProcess;
+    if (startDocs) {
+        const npxExecutable = process.platform === "win32" ? "npx.cmd" : "npx";
+        docsProcess = execa(npxExecutable, ["zudoku", "dev", "--zuplo", "--port", String(docsPort)], {
+            cwd: docsDirectory,
+            env: {
+                ...process.env,
+                FORCE_COLOR: "1",
+                ZUPLO_SERVER_URL: `http://localhost:${zupPort}`,
+            },
+        });
+        const docsStdoutTransform = createPrefixedTransform({
+            name: "docs",
+            color: chalk.magenta,
+        });
+        const docsStderrTransform = createPrefixedTransform({
+            name: "docs",
+            color: chalk.magenta,
+        });
+        docsProcess.stdout?.pipe(docsStdoutTransform).pipe(process.stdout);
+        docsProcess.stderr?.pipe(docsStderrTransform).pipe(process.stderr);
+    }
     printDiagnosticsToConsole("Started local development setup");
     printDiagnosticsToConsole("Ctrl+C to exit");
     printDiagnosticsToConsole("");
@@ -94,6 +137,9 @@ export async function dev(argv) {
     if (argv["start-editor"]) {
         printDiagnosticsToConsole(`📘 Route Designer: http://localhost:${argv.editorPort}`);
     }
+    if (startDocs) {
+        printDiagnosticsToConsole(`📄 Docs Server: http://localhost:${docsPort}`);
+    }
     if (loadedEnvFiles.length > 0) {
         printDiagnosticsToConsole(`⚙️  Loaded env files: \n    - ${loadedEnvFiles.join(" \n    - ")}`);
     }
@@ -101,15 +147,33 @@ export async function dev(argv) {
     printDiagnosticsToConsole("");
     return new Promise((resolve) => {
         async function exit() {
+            process.off("SIGTERM", exit);
+            process.off("SIGINT", exit);
             printDiagnosticsToConsole("");
             printDiagnosticsToConsole("Stopping local development server...");
             if (argv["start-editor"]) {
                 await editor.close();
             }
+            if (docsProcess) {
+                docsProcess.kill("SIGTERM");
+            }
             resolve();
         }
         process.on("SIGTERM", exit);
         process.on("SIGINT", exit);
+        if (docsProcess) {
+            docsProcess.on("close", (code, signal) => {
+                if (signal === "SIGTERM" || signal === "SIGINT") {
+                    return;
+                }
+                if (code !== 0) {
+                    printWarningToConsole(`Docs server exited with code ${code}.`);
+                }
+            });
+            docsProcess.on("error", (err) => {
+                printWarningToConsole(`Failed to start docs server: ${err.message}`);
+            });
+        }
     });
 }
 //# sourceMappingURL=handler.js.map

package/dist/dev/handler.js.map

@@ -1 +1 @@
-{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/dev/handler.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AACzC,OAAO,EAAE,MAAM,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,SAAS,CAAC;AAC3D,OAAO,EAAE,IAAI,EAAE,OAAO,EAAE,MAAM,WAAW,CAAC;AAC1C,OAAO,EAAE,aAAa,EAAE,MAAM,UAAU,CAAC;AACzC,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAClD,OAAO,MAAM,MAAM,QAAQ,CAAC;AAC5B,OAAO,EAAE,MAAM,EAAE,MAAM,qBAAqB,CAAC;AAC7C,OAAO,EACL,aAAa,EACb,oCAAoC,EACpC,yBAAyB,GAC1B,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EAAE,eAAe,EAAE,MAAM,0BAA0B,CAAC;AAC3D,OAAO,EAAE,kBAAkB,EAAE,MAAM,4BAA4B,CAAC;AAWhE,MAAM,CAAC,KAAK,UAAU,GAAG,CAAC,IAAe;IACvC,MAAM,eAAe,GAAG,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IAM1C,MAAM,gBAAgB,GAAG,IAAI,GAAG,CAC9B,mCAAmC,EACnC,MAAM,CAAC,IAAI,CAAC,GAAG,CAChB,CAAC;IACF,IAAI,UAAU,CAAC,gBAAgB,CAAC,EAAE,CAAC;QACjC,MAAM,CACJ,gBAAgB,EAChB,IAAI,CAAC,eAAe,EAAE,6BAA6B,CAAC,EACpD;YACE,SAAS,EAAE,IAAI;YACf,WAAW,EAAE,IAAI;SAClB,CACF,CAAC;IACJ,CAAC;IAID,OAAO,CAAC,GAAG,CAAC,sBAAsB,GAAG,aAAa,CAChD,IAAI,GAAG,CAAC,oBAAoB,EAAE,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAC/C,CAAC;IAEF,MAAM,cAAc,GAAa,EAAE,CAAC;IAGpC,MAAM,OAAO,GAAG,IAAI,CAAC,eAAe,EAAE,MAAM,CAAC,CAAC;IAC9C,IAAI,UAAU,CAAC,OAAO,CAAC,EAAE,CAAC;QACxB,cAAc,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC;IAC9B,CAAC;IAGD,IAAI,QAA8C,CAAC;IACnD,MAAM,YAAY,GAAG,IAAI,CAAC,eAAe,EAAE,YAAY,CAAC,CAAC;IACzD,IAAI,UAAU,CAAC,YAAY,CAAC,EAAE,CAAC;QAC7B,MAAM,QAAQ,GAAG,YAAY,CAAC,YAAY,CAAC,CAAC;QAC5C,QAAQ,GAAG,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAC;QAClC,cAAc,CAAC,IAAI,CAAC,YAAY,CAAC,CAAC;IACpC,CAAC;IAOD,OAAO,CAAC,GAAG,CAAC,0BAA0B,GAAG,MAAM,CAAC;IAGhD,MAAM,IAAI,GAAG,MAAM,MAAM,CAAC,iBAAiB,CAAC,CAAC;IAE7C,MAAM,OAAO,GAAG,IAAI,CAAC,IAAI,CAAC;IAC1B,MAAM,aAAa,GAAG,IAAI,CAAC,UAAU,CAAC;IACtC,MAAM,YAAY,GAAG,IAAI,CAAC,SAAS,CAAC;IAEpC,MAAM,kBAAkB,GAAG,MAAM,eAAe,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACvE,IAAI,CAAC,kBAAkB,EAAE,CAAC;QACxB,MAAM,oCAAoC,CACxC,QAAQ,OAAO,mEAAmE,CACnF,CAAC;IACJ,CAAC;IAED,MAAM,wBAAwB,GAAG,MAAM,eAAe,CACpD,WAAW,EACX,aAAa,CACd,CAAC;IACF,IAAI,CAAC,wBAAwB,EAAE,CAAC;QAC9B,MAAM,oCAAoC,CACxC,QAAQ,aAAa,0EAA0E,CAChG,CAAC;IACJ,CAAC;IAED,IAAI,YAAY,EAAE,CAAC;QACjB,MAAM,uBAAuB,GAAG,MAAM,eAAe,CACnD,WAAW,EACX,YAAY,CACb,CAAC;QACF,IAAI,CAAC,uBAAuB,EAAE,CAAC;YAC7B,MAAM,oCAAoC,CACxC,QAAQ,YAAY,yEAAyE,CAC9F,CAAC;QACJ,CAAC;IACH,CAAC;IAED,MAAM,OAAO,GAAG,UAAU,EAAE,CAAC;IAE7B,IAAI,SAAS,GAAG,IAAI,CAAC;IAErB,MAAM,IAAI,CAAC,cAAc,CAAC;QACxB,OAAO;QACP,MAAM,EAAE,IAAI,aAAa,EAAE;QAC3B,eAAe;QACf,IAAI,EAAE,OAAO;QACb,SAAS,EAAE,IAAI,CAAC,SAAS;QACzB,+BAA+B,EAAE,IAAI,CAAC,+BAA+B;QACrE,+BAA+B,EAAE,QAAQ;YACvC,CAAC,CAAC;gBAEE,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;gBAE/C,kBAAkB,EAAE,QAAQ,CAAC,kBAAkB;gBAE/C,sBAAsB,EAAE,QAAQ,CAAC,sBAAsB;aACxD;YACH,CAAC;gBACC,SAAS;QACb,MAAM;QACN,kBAAkB;QAClB,QAAQ,EAAE,GAAG,EAAE;YACb,IAAI,SAAS,EAAE,CAAC;gBACd,SAAS,GAAG,KAAK,CAAC;YACpB,CAAC;iBAAM,CAAC;gBACN,yBAAyB,CAAC,kCAAkC,CAAC,CAAC;YAChE,CAAC;QACH,CAAC;KACF,CAAC,CAAC;IAEH,IAAI,MAAyB,CAAC;IAE9B,IAAI,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACzB,MAAM,GAAG,IAAI,iBAAiB,CAAC;YAC7B,eAAe;YACf,aAAa,EAAE,oBAAoB,OAAO,EAAE;YAC5C,IAAI,EAAE,IAAI,CAAC,UAAU;YACrB,MAAM;SACP,CAAC,CAAC;QACH,MAAM,CAAC,KAAK,EAAE,CAAC,KAAK,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,MAAM,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC;IACnD,CAAC;IAED,yBAAyB,CAAC,iCAAiC,CAAC,CAAC;IAC7D,yBAAyB,CAAC,gBAAgB,CAAC,CAAC;IAC5C,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAC9B,yBAAyB,CAAC,sCAAsC,OAAO,EAAE,CAAC,CAAC;IAC3E,IAAI,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;QACzB,yBAAyB,CACvB,uCAAuC,IAAI,CAAC,UAAU,EAAE,CACzD,CAAC;IACJ,CAAC;IACD,IAAI,cAAc,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC9B,yBAAyB,CACvB,iCAAiC,cAAc,CAAC,IAAI,CAAC,WAAW,CAAC,EAAE,CACpE,CAAC;IACJ,CAAC;IACD,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAC9B,yBAAyB,CAAC,EAAE,CAAC,CAAC;IAE9B,OAAO,IAAI,OAAO,CAAO,CAAC,OAAO,EAAE,EAAE;QACnC,KAAK,UAAU,IAAI;YACjB,yBAAyB,CAAC,EAAE,CAAC,CAAC;YAC9B,yBAAyB,CAAC,sCAAsC,CAAC,CAAC;YAElE,IAAI,IAAI,CAAC,cAAc,CAAC,EAAE,CAAC;gBACzB,MAAM,MAAM,CAAC,KAAK,EAAE,CAAC;YACvB,CAAC;YACD,OAAO,EAAE,CAAC;QACZ,CAAC;QAED,OAAO,CAAC,EAAE,CAAC,SAAS,EAAE,IAAI,CAAC,CAAC;QAC5B,OAAO,CAAC,EAAE,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC;IAC7B,CAAC,CAAC,CAAC;AACL,CAAC","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { cpSync, existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { LocalEditorServer } from \"@zuplo/editor\";\nimport dotenv from \"dotenv\";\nimport { logger } from \"../common/logger.js\";\nimport {\n  ConsoleOutput,\n  printCriticalFailureToConsoleAndExit,\n  printDiagnosticsToConsole,\n} from \"../common/output.js\";\nimport { isPortAvailable } from \"../common/utils/ports.js\";\nimport { handleRuntimeStdio } from \"../common/worker-output.js\";\n\nexport interface Arguments {\n  dir: string;\n  \"start-editor\": boolean;\n  port: number;\n  editorPort: number;\n  debugPort?: number;\n  unsafelyIgnoreCertificateErrors?: boolean;\n}\n\nexport async function dev(argv: Arguments) {\n  const sourceDirectory = resolve(argv.dir);\n\n  // When we build, we MIGHT need to use the @zuplo/runtime from the node_modules if the user\n  // has installed our packages using https://www.npmjs.com/package/zuplo in a global directory\n\n  // Try to copy the @zuplo/runtime locally\n  const zuploRuntimePath = new URL(\n    \"../../node_modules/@zuplo/runtime\",\n    import.meta.url\n  );\n  if (existsSync(zuploRuntimePath)) {\n    cpSync(\n      zuploRuntimePath,\n      join(sourceDirectory, \"node_modules/@zuplo/runtime\"),\n      {\n        recursive: true,\n        dereference: true,\n      }\n    );\n  }\n\n  // Set GLOBAL_MODULE_LOCATION to the location of the CLIs node_modules\n  // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n  process.env.GLOBAL_MODULE_LOCATION = fileURLToPath(\n    new URL(\"../../node_modules\", import.meta.url)\n  );\n\n  const loadedEnvFiles: string[] = [];\n\n  // Check if the user has a .env file\n  const envFile = join(sourceDirectory, \".env\");\n  if (existsSync(envFile)) {\n    loadedEnvFiles.push(\".env\");\n  }\n\n  // Check if the user has a .env.zuplo file\n  let envZuplo: dotenv.DotenvParseOutput | undefined;\n  const envZuploFile = join(sourceDirectory, \".env.zuplo\");\n  if (existsSync(envZuploFile)) {\n    const contents = readFileSync(envZuploFile);\n    envZuplo = dotenv.parse(contents);\n    loadedEnvFiles.push(\".env.zuplo\");\n  }\n\n  // Set other variables using __ZUPLO_CONFIG as necessary\n  // const config = {\n  // };\n  // process.env.__ZUPLO_CONFIG = btoa(JSON.stringify(config));\n  // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n  process.env.ZUPLO_IS_LOCAL_DEVELOPMENT = \"true\";\n\n  // Use a dynamic import so that setting process.env has effect\n  const core = await import(\"@zuplo/core/cli\");\n\n  const zupPort = argv.port;\n  const zupEditorPort = argv.editorPort;\n  const zupDebugPort = argv.debugPort;\n\n  const isZupPortAvailable = await isPortAvailable(\"localhost\", zupPort);\n  if (!isZupPortAvailable) {\n    await printCriticalFailureToConsoleAndExit(\n      `Port ${zupPort} is already in use. Please specify a different port using --port.`\n    );\n  }\n\n  const isZupEditorPortAvailable = await isPortAvailable(\n    \"localhost\",\n    zupEditorPort\n  );\n  if (!isZupEditorPortAvailable) {\n    await printCriticalFailureToConsoleAndExit(\n      `Port ${zupEditorPort} is already in use. Please specify a different port using --editor-port.`\n    );\n  }\n\n  if (zupDebugPort) {\n    const isZupDebugPortAvailable = await isPortAvailable(\n      \"localhost\",\n      zupDebugPort\n    );\n    if (!isZupDebugPortAvailable) {\n      await printCriticalFailureToConsoleAndExit(\n        `Port ${zupDebugPort} is already in use. Please specify a different port using --debug-port.`\n      );\n    }\n  }\n\n  const buildId = randomUUID();\n\n  let firstLoad = true;\n\n  await core.startDevServer({\n    buildId,\n    output: new ConsoleOutput(),\n    sourceDirectory,\n    port: zupPort,\n    debugPort: argv.debugPort,\n    unsafelyIgnoreCertificateErrors: argv.unsafelyIgnoreCertificateErrors,\n    publicZuploEnvironmentVariables: envZuplo\n      ? {\n          // biome-ignore lint/style/useNamingConvention: External API property\n          ZUPLO_ACCOUNT_NAME: envZuplo.ZUPLO_ACCOUNT_NAME,\n          // biome-ignore lint/style/useNamingConvention: External API property\n          ZUPLO_PROJECT_NAME: envZuplo.ZUPLO_PROJECT_NAME,\n          // biome-ignore lint/style/useNamingConvention: External API property\n          ZUPLO_ENVIRONMENT_TYPE: envZuplo.ZUPLO_ENVIRONMENT_TYPE,\n        }\n      : // Leave this as undefined to simulate the old behavior\n        undefined,\n    logger,\n    handleRuntimeStdio,\n    onReload: () => {\n      if (firstLoad) {\n        firstLoad = false;\n      } else {\n        printDiagnosticsToConsole(\"Code changed. Server reloaded...\");\n      }\n    },\n  });\n\n  let editor: LocalEditorServer;\n\n  if (argv[\"start-editor\"]) {\n    editor = new LocalEditorServer({\n      sourceDirectory,\n      deploymentUrl: `http://localhost:${zupPort}`,\n      port: argv.editorPort,\n      logger,\n    });\n    editor.start().catch((err) => logger.error(err));\n  }\n\n  printDiagnosticsToConsole(\"Started local development setup\");\n  printDiagnosticsToConsole(\"Ctrl+C to exit\");\n  printDiagnosticsToConsole(\"\");\n  printDiagnosticsToConsole(`🚀 Zuplo Gateway: http://localhost:${zupPort}`);\n  if (argv[\"start-editor\"]) {\n    printDiagnosticsToConsole(\n      `📘 Route Designer: http://localhost:${argv.editorPort}`\n    );\n  }\n  if (loadedEnvFiles.length > 0) {\n    printDiagnosticsToConsole(\n      `⚙️  Loaded env files: \\n    - ${loadedEnvFiles.join(\" \\n    - \")}`\n    );\n  }\n  printDiagnosticsToConsole(\"\");\n  printDiagnosticsToConsole(\"\");\n\n  return new Promise<void>((resolve) => {\n    async function exit() {\n      printDiagnosticsToConsole(\"\");\n      printDiagnosticsToConsole(\"Stopping local development server...\");\n\n      if (argv[\"start-editor\"]) {\n        await editor.close();\n      }\n      resolve();\n    }\n\n    process.on(\"SIGTERM\", exit);\n    process.on(\"SIGINT\", exit);\n  });\n}\n"]}
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/dev/handler.ts"],"names":[],"mappings":"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","sourcesContent":["import { randomUUID } from \"node:crypto\";\nimport { cpSync, existsSync, readFileSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { fileURLToPath } from \"node:url\";\nimport { LocalEditorServer } from \"@zuplo/editor\";\nimport chalk from \"chalk\";\nimport dotenv from \"dotenv\";\nimport { ExecaChildProcess, execa } from \"execa\";\nimport { logger } from \"../common/logger.js\";\nimport {\n  ConsoleOutput,\n  printCriticalFailureToConsoleAndExit,\n  printDiagnosticsToConsole,\n  printWarningToConsole,\n} from \"../common/output.js\";\nimport { isPortAvailable } from \"../common/utils/ports.js\";\nimport { createPrefixedTransform } from \"../common/utils/prefixed-output.js\";\nimport { createRuntimeStdioHandler } from \"../common/worker-output.js\";\n\nexport interface Arguments {\n  dir: string;\n  \"start-editor\": boolean;\n  \"start-docs\": boolean;\n  port: number;\n  editorPort: number;\n  docsPort: number;\n  debugPort?: number;\n  unsafelyIgnoreCertificateErrors?: boolean;\n}\n\nexport async function dev(argv: Arguments) {\n  const sourceDirectory = resolve(argv.dir);\n\n  // When we build, we MIGHT need to use the @zuplo/runtime from the node_modules if the user\n  // has installed our packages using https://www.npmjs.com/package/zuplo in a global directory\n\n  // Try to copy the @zuplo/runtime locally\n  const zuploRuntimePath = new URL(\n    \"../../node_modules/@zuplo/runtime\",\n    import.meta.url\n  );\n  if (existsSync(zuploRuntimePath)) {\n    cpSync(\n      zuploRuntimePath,\n      join(sourceDirectory, \"node_modules/@zuplo/runtime\"),\n      {\n        recursive: true,\n        dereference: true,\n      }\n    );\n  }\n\n  // Set GLOBAL_MODULE_LOCATION to the location of the CLIs node_modules\n  // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n  process.env.GLOBAL_MODULE_LOCATION = fileURLToPath(\n    new URL(\"../../node_modules\", import.meta.url)\n  );\n\n  const loadedEnvFiles: string[] = [];\n\n  // Check if the user has a .env file\n  const envFile = join(sourceDirectory, \".env\");\n  if (existsSync(envFile)) {\n    loadedEnvFiles.push(\".env\");\n  }\n\n  // Check if the user has a .env.zuplo file\n  let envZuplo: dotenv.DotenvParseOutput | undefined;\n  const envZuploFile = join(sourceDirectory, \".env.zuplo\");\n  if (existsSync(envZuploFile)) {\n    const contents = readFileSync(envZuploFile);\n    envZuplo = dotenv.parse(contents);\n    loadedEnvFiles.push(\".env.zuplo\");\n  }\n\n  // Set other variables using __ZUPLO_CONFIG as necessary\n  // const config = {\n  // };\n  // process.env.__ZUPLO_CONFIG = btoa(JSON.stringify(config));\n  // biome-ignore lint/style/noProcessEnv: Migrated from ESLint\n  process.env.ZUPLO_IS_LOCAL_DEVELOPMENT = \"true\";\n\n  // Use a dynamic import so that setting process.env has effect\n  const core = await import(\"@zuplo/core/cli\");\n\n  const zupPort = argv.port;\n  const zupEditorPort = argv.editorPort;\n  const zupDebugPort = argv.debugPort;\n\n  const isZupPortAvailable = await isPortAvailable(\"localhost\", zupPort);\n  if (!isZupPortAvailable) {\n    await printCriticalFailureToConsoleAndExit(\n      `Port ${zupPort} is already in use. Please specify a different port using --port.`\n    );\n  }\n\n  const isZupEditorPortAvailable = await isPortAvailable(\n    \"localhost\",\n    zupEditorPort\n  );\n  if (!isZupEditorPortAvailable) {\n    await printCriticalFailureToConsoleAndExit(\n      `Port ${zupEditorPort} is already in use. Please specify a different port using --editor-port.`\n    );\n  }\n\n  if (zupDebugPort) {\n    const isZupDebugPortAvailable = await isPortAvailable(\n      \"localhost\",\n      zupDebugPort\n    );\n    if (!isZupDebugPortAvailable) {\n      await printCriticalFailureToConsoleAndExit(\n        `Port ${zupDebugPort} is already in use. Please specify a different port using --debug-port.`\n      );\n    }\n  }\n\n  const docsDirectory = join(sourceDirectory, \"docs\");\n  const hasDocsDirectory = existsSync(docsDirectory);\n  if (!hasDocsDirectory) {\n    printWarningToConsole(\n      `Warning: docs/ directory not found at ${docsDirectory}. Skipping docs server.`\n    );\n  }\n\n  const startDocs = argv[\"start-docs\"] && hasDocsDirectory;\n  const docsPort = argv.docsPort;\n\n  if (startDocs) {\n    const isDocsPortAvailable = await isPortAvailable(\"localhost\", docsPort);\n    if (!isDocsPortAvailable) {\n      await printCriticalFailureToConsoleAndExit(\n        `Port ${docsPort} is already in use. Please specify a different port using --docs-port.`\n      );\n    }\n  }\n\n  const buildId = randomUUID();\n\n  let firstLoad = true;\n\n  const handleRuntimeStdio = createRuntimeStdioHandler({\n    prefix: \"gateway\",\n    prefixColor: chalk.cyan,\n  });\n  await core.startDevServer({\n    buildId,\n    output: new ConsoleOutput(),\n    sourceDirectory,\n    port: zupPort,\n    debugPort: argv.debugPort,\n    devPortalPort: startDocs ? docsPort : undefined,\n    unsafelyIgnoreCertificateErrors: argv.unsafelyIgnoreCertificateErrors,\n    publicZuploEnvironmentVariables: envZuplo\n      ? {\n          // biome-ignore lint/style/useNamingConvention: External API property\n          ZUPLO_ACCOUNT_NAME: envZuplo.ZUPLO_ACCOUNT_NAME,\n          // biome-ignore lint/style/useNamingConvention: External API property\n          ZUPLO_PROJECT_NAME: envZuplo.ZUPLO_PROJECT_NAME,\n          // biome-ignore lint/style/useNamingConvention: External API property\n          ZUPLO_ENVIRONMENT_TYPE: envZuplo.ZUPLO_ENVIRONMENT_TYPE,\n        }\n      : // Leave this as undefined to simulate the old behavior\n        undefined,\n    logger,\n    handleRuntimeStdio,\n    onReload: () => {\n      if (firstLoad) {\n        firstLoad = false;\n      } else {\n        printDiagnosticsToConsole(\"Code changed. Server reloaded...\");\n      }\n    },\n  });\n\n  let editor: LocalEditorServer;\n\n  if (argv[\"start-editor\"]) {\n    editor = new LocalEditorServer({\n      sourceDirectory,\n      deploymentUrl: `http://localhost:${zupPort}`,\n      port: argv.editorPort,\n      logger,\n    });\n    editor.start().catch((err) => logger.error(err));\n  }\n\n  let docsProcess: ExecaChildProcess | undefined;\n\n  if (startDocs) {\n    const npxExecutable = process.platform === \"win32\" ? \"npx.cmd\" : \"npx\";\n    docsProcess = execa(\n      npxExecutable,\n      [\"zudoku\", \"dev\", \"--zuplo\", \"--port\", String(docsPort)],\n      {\n        cwd: docsDirectory,\n        env: {\n          // biome-ignore lint/style/noProcessEnv: Pass through environment\n          ...process.env,\n          // Ensure that the Zudoku server pipes through colored output even if it's\n          // not sending it through a TTY and instead is using the prefixed transform\n          // https://force-color.org/\n          // biome-ignore lint/style/useNamingConvention: Environment variable naming\n          FORCE_COLOR: \"1\",\n          // biome-ignore lint/style/useNamingConvention: Environment variable naming\n          ZUPLO_SERVER_URL: `http://localhost:${zupPort}`,\n        },\n      }\n    );\n    const docsStdoutTransform = createPrefixedTransform({\n      name: \"docs\",\n      color: chalk.magenta,\n    });\n    const docsStderrTransform = createPrefixedTransform({\n      name: \"docs\",\n      color: chalk.magenta,\n    });\n    docsProcess.stdout?.pipe(docsStdoutTransform).pipe(process.stdout);\n    docsProcess.stderr?.pipe(docsStderrTransform).pipe(process.stderr);\n  }\n\n  printDiagnosticsToConsole(\"Started local development setup\");\n  printDiagnosticsToConsole(\"Ctrl+C to exit\");\n  printDiagnosticsToConsole(\"\");\n  printDiagnosticsToConsole(`🚀 Zuplo Gateway: http://localhost:${zupPort}`);\n  if (argv[\"start-editor\"]) {\n    printDiagnosticsToConsole(\n      `📘 Route Designer: http://localhost:${argv.editorPort}`\n    );\n  }\n  if (startDocs) {\n    printDiagnosticsToConsole(`📄 Docs Server: http://localhost:${docsPort}`);\n  }\n  if (loadedEnvFiles.length > 0) {\n    printDiagnosticsToConsole(\n      `⚙️  Loaded env files: \\n    - ${loadedEnvFiles.join(\" \\n    - \")}`\n    );\n  }\n  printDiagnosticsToConsole(\"\");\n  printDiagnosticsToConsole(\"\");\n\n  return new Promise<void>((resolve) => {\n    async function exit() {\n      process.off(\"SIGTERM\", exit);\n      process.off(\"SIGINT\", exit);\n\n      printDiagnosticsToConsole(\"\");\n      printDiagnosticsToConsole(\"Stopping local development server...\");\n\n      if (argv[\"start-editor\"]) {\n        await editor.close();\n      }\n      if (docsProcess) {\n        docsProcess.kill(\"SIGTERM\");\n      }\n\n      resolve();\n    }\n\n    // Handle user-initiated shutdown\n    process.on(\"SIGTERM\", exit);\n    process.on(\"SIGINT\", exit);\n\n    // Handle child process exiting and cleanup\n    if (docsProcess) {\n      docsProcess.on(\"close\", (code, signal) => {\n        if (signal === \"SIGTERM\" || signal === \"SIGINT\") {\n          return;\n        }\n\n        if (code !== 0) {\n          printWarningToConsole(`Docs server exited with code ${code}.`);\n        }\n      });\n\n      docsProcess.on(\"error\", (err) => {\n        printWarningToConsole(`Failed to start docs server: ${err.message}`);\n      });\n    }\n  });\n}\n"]}

package/dist/docs/handler.d.ts

@@ -0,0 +1,7 @@
+export interface Arguments {
+  dir: string;
+  port: number;
+  serverUrl?: string;
+}
+export declare function docs(argv: Arguments): Promise<void>;
+//# sourceMappingURL=handler.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"handler.d.ts","sourceRoot":"","sources":["../../src/docs/handler.ts"],"names":[],"mappings":"AAUA,MAAM,WAAW,SAAS;IACxB,GAAG,EAAE,MAAM,CAAC;IACZ,IAAI,EAAE,MAAM,CAAC;IACb,SAAS,CAAC,EAAE,MAAM,CAAC;CACpB;AAED,wBAAsB,IAAI,CAAC,IAAI,EAAE,SAAS,iBAsFzC"}

package/dist/docs/handler.js

@@ -0,0 +1,67 @@
+import { existsSync } from "node:fs";
+import { join, resolve } from "node:path";
+import { execa } from "execa";
+import { printCriticalFailureToConsoleAndExit, printDiagnosticsToConsole, printWarningToConsole, } from "../common/output.js";
+import { isPortAvailable } from "../common/utils/ports.js";
+export async function docs(argv) {
+    const sourceDirectory = resolve(argv.dir);
+    const docsDirectory = join(sourceDirectory, "docs");
+    if (!existsSync(docsDirectory)) {
+        await printCriticalFailureToConsoleAndExit(`docs/ directory not found at ${docsDirectory}. Please ensure your project has a docs directory.`);
+    }
+    const docsPort = argv.port;
+    const isDocsPortAvailable = await isPortAvailable("localhost", docsPort);
+    if (!isDocsPortAvailable) {
+        await printCriticalFailureToConsoleAndExit(`Port ${docsPort} is already in use. Please specify a different port using --port.`);
+    }
+    const env = {
+        ...process.env,
+        FORCE_COLOR: "1",
+    };
+    if (argv.serverUrl) {
+        env.ZUPLO_SERVER_URL = argv.serverUrl;
+    }
+    const npxExecutable = process.platform === "win32" ? "npx.cmd" : "npx";
+    const docsProcess = execa(npxExecutable, ["zudoku", "dev", "--zuplo", "--port", String(docsPort)], {
+        cwd: docsDirectory,
+        env,
+    });
+    docsProcess.stdout?.pipe(process.stdout);
+    docsProcess.stderr?.pipe(process.stderr);
+    printDiagnosticsToConsole("Started docs server");
+    printDiagnosticsToConsole("Ctrl+C to exit");
+    printDiagnosticsToConsole("");
+    printDiagnosticsToConsole(`📄 Docs Server: http://localhost:${docsPort}`);
+    if (argv.serverUrl) {
+        printDiagnosticsToConsole(`🔗 Using API Server: ${argv.serverUrl}`);
+    }
+    printDiagnosticsToConsole("");
+    return new Promise((resolve) => {
+        function exit() {
+            process.off("SIGTERM", exit);
+            process.off("SIGINT", exit);
+            printDiagnosticsToConsole("");
+            printDiagnosticsToConsole("Stopping docs server...");
+            docsProcess.kill("SIGTERM");
+            resolve();
+        }
+        process.on("SIGTERM", exit);
+        process.on("SIGINT", exit);
+        docsProcess.on("error", (err) => {
+            process.off("SIGTERM", exit);
+            process.off("SIGINT", exit);
+            printWarningToConsole(`Failed to start docs server: ${err.message}`);
+            resolve();
+        });
+        docsProcess.on("close", (code, signal) => {
+            if (signal === "SIGTERM" || signal === "SIGINT") {
+                return;
+            }
+            process.off("SIGTERM", exit);
+            process.off("SIGINT", exit);
+            printWarningToConsole(`Docs server exited with code ${code}.`);
+            resolve();
+        });
+    });
+}
+//# sourceMappingURL=handler.js.map

package/dist/docs/handler.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"handler.js","sourceRoot":"","sources":["../../src/docs/handler.ts"],"names":[],"mappings":"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","sourcesContent":["import { existsSync } from \"node:fs\";\nimport { join, resolve } from \"node:path\";\nimport { execa } from \"execa\";\nimport {\n  printCriticalFailureToConsoleAndExit,\n  printDiagnosticsToConsole,\n  printWarningToConsole,\n} from \"../common/output.js\";\nimport { isPortAvailable } from \"../common/utils/ports.js\";\n\nexport interface Arguments {\n  dir: string;\n  port: number;\n  serverUrl?: string;\n}\n\nexport async function docs(argv: Arguments) {\n  const sourceDirectory = resolve(argv.dir);\n  const docsDirectory = join(sourceDirectory, \"docs\");\n\n  if (!existsSync(docsDirectory)) {\n    await printCriticalFailureToConsoleAndExit(\n      `docs/ directory not found at ${docsDirectory}. Please ensure your project has a docs directory.`\n    );\n  }\n\n  const docsPort = argv.port;\n\n  const isDocsPortAvailable = await isPortAvailable(\"localhost\", docsPort);\n  if (!isDocsPortAvailable) {\n    await printCriticalFailureToConsoleAndExit(\n      `Port ${docsPort} is already in use. Please specify a different port using --port.`\n    );\n  }\n\n  const env: NodeJS.ProcessEnv = {\n    // biome-ignore lint/style/noProcessEnv: Required to pass through environment\n    ...process.env,\n    // Ensure that the Zudoku server pipes through colored output even if it's\n    // not sending it through a TTY.\n    // https://force-color.org/\n    // biome-ignore lint/style/useNamingConvention: Environment variable naming\n    FORCE_COLOR: \"1\",\n  };\n\n  if (argv.serverUrl) {\n    env.ZUPLO_SERVER_URL = argv.serverUrl;\n  }\n\n  const npxExecutable = process.platform === \"win32\" ? \"npx.cmd\" : \"npx\";\n  const docsProcess = execa(\n    npxExecutable,\n    [\"zudoku\", \"dev\", \"--zuplo\", \"--port\", String(docsPort)],\n    {\n      cwd: docsDirectory,\n      env,\n    }\n  );\n  docsProcess.stdout?.pipe(process.stdout);\n  docsProcess.stderr?.pipe(process.stderr);\n\n  printDiagnosticsToConsole(\"Started docs server\");\n  printDiagnosticsToConsole(\"Ctrl+C to exit\");\n  printDiagnosticsToConsole(\"\");\n  printDiagnosticsToConsole(`📄 Docs Server: http://localhost:${docsPort}`);\n  if (argv.serverUrl) {\n    printDiagnosticsToConsole(`🔗 Using API Server: ${argv.serverUrl}`);\n  }\n  printDiagnosticsToConsole(\"\");\n\n  return new Promise<void>((resolve) => {\n    function exit() {\n      process.off(\"SIGTERM\", exit);\n      process.off(\"SIGINT\", exit);\n\n      printDiagnosticsToConsole(\"\");\n      printDiagnosticsToConsole(\"Stopping docs server...\");\n      docsProcess.kill(\"SIGTERM\");\n      resolve();\n    }\n\n    process.on(\"SIGTERM\", exit);\n    process.on(\"SIGINT\", exit);\n\n    docsProcess.on(\"error\", (err) => {\n      process.off(\"SIGTERM\", exit);\n      process.off(\"SIGINT\", exit);\n      printWarningToConsole(`Failed to start docs server: ${err.message}`);\n      resolve();\n    });\n\n    docsProcess.on(\"close\", (code, signal) => {\n      if (signal === \"SIGTERM\" || signal === \"SIGINT\") {\n        return;\n      }\n\n      process.off(\"SIGTERM\", exit);\n      process.off(\"SIGINT\", exit);\n      printWarningToConsole(`Docs server exited with code ${code}.`);\n      resolve();\n    });\n  });\n}\n"]}

package/dist/tsconfig.tsbuildinfo

@@ -1 +1 @@
-{"root":["../src/cli.ts","../src/internal.ts","../src/types.d.ts","../src/__tests__/archive-utils.test.ts","../src/__tests__/import-openapi-utils.test.ts","../src/__tests__/import-openapi.test.ts","../src/__tests__/oas-test-data.ts","../src/__tests__/outdated.test.ts","../src/__tests__/populate.test.ts","../src/__tests__/tsconfig-upgrader.test.ts","../src/__tests__/integration/delete.integration.test.ts","../src/__tests__/integration/deploy.integration.test.ts","../src/__tests__/integration/jest-mocks-setup.ts","../src/__tests__/integration/jest-setup.ts","../src/__tests__/integration/link.integration.test.ts","../src/__tests__/integration/list.integration.test.ts","../src/__tests__/integration/test-utils.ts","../src/__tests__/integration/tunnel.integration.test.ts","../src/__tests__/integration/variable.integration.test.ts","../src/build/handler.ts","../src/cmds/build.ts","../src/cmds/compile.ts","../src/cmds/delete.ts","../src/cmds/deploy.ts","../src/cmds/dev.ts","../src/cmds/editor.ts","../src/cmds/link.ts","../src/cmds/list.ts","../src/cmds/login.ts","../src/cmds/test.ts","../src/cmds/mtls-certificates/create.ts","../src/cmds/mtls-certificates/delete.ts","../src/cmds/mtls-certificates/describe.ts","../src/cmds/mtls-certificates/disable.ts","../src/cmds/mtls-certificates/index.ts","../src/cmds/mtls-certificates/list.ts","../src/cmds/mtls-certificates/update.ts","../src/cmds/open-api/convert.ts","../src/cmds/open-api/index.ts","../src/cmds/open-api/merge.ts","../src/cmds/open-api/overlay.ts","../src/cmds/project/create.ts","../src/cmds/project/index.ts","../src/cmds/proxies/create.ts","../src/cmds/proxies/delete.ts","../src/cmds/proxies/describe.ts","../src/cmds/proxies/index.ts","../src/cmds/proxies/update.ts","../src/cmds/source/import-openapi.ts","../src/cmds/source/index.ts","../src/cmds/source/migrate.ts","../src/cmds/source/upgrade.ts","../src/cmds/tunnel/create.ts","../src/cmds/tunnel/delete.ts","../src/cmds/tunnel/describe.ts","../src/cmds/tunnel/index.ts","../src/cmds/tunnel/list.ts","../src/cmds/tunnel/rotate-token.ts","../src/cmds/tunnel/services/describe.ts","../src/cmds/tunnel/services/index.ts","../src/cmds/tunnel/services/update.ts","../src/cmds/variable/create.ts","../src/cmds/variable/index.ts","../src/cmds/variable/update.ts","../src/common/alias.ts","../src/common/args.ts","../src/common/constants.ts","../src/common/file-format.ts","../src/common/handler.ts","../src/common/logger.ts","../src/common/models.ts","../src/common/outdated.ts","../src/common/output.ts","../src/common/populate.ts","../src/common/runner.ts","../src/common/settings.ts","../src/common/worker-output.ts","../src/common/analytics/lib.ts","../src/common/api/lib.ts","../src/common/machine-id/lib.ts","../src/common/middleware/authentication.ts","../src/common/middleware/get-account-param.ts","../src/common/middleware/get-environment-param.ts","../src/common/middleware/get-project-param.ts","../src/common/middleware/logging.ts","../src/common/middleware/user-configuration.ts","../src/common/middleware/user-identification.ts","../src/common/middleware/validate-fleet.ts","../src/common/open-api/constants.ts","../src/common/open-api/index.ts","../src/common/open-api/validation.ts","../src/common/upgraders/lib.ts","../src/common/upgraders/package-json-upgrader.ts","../src/common/upgraders/tsconfig-upgrader.ts","../src/common/upgraders/vscode-settings-json-upgrader.ts","../src/common/utils/box.ts","../src/common/utils/branch.ts","../src/common/utils/ports.ts","../src/common/utils/pretty-print-environment-prompt.ts","../src/common/utils/stringify-config.test.ts","../src/common/utils/stringify-config.ts","../src/common/utils/types.ts","../src/common/utils/urls.ts","../src/common/validators/file-system-validator.ts","../src/common/validators/lib.ts","../src/common/validators/project-name-validator.ts","../src/common/xdg/lib.ts","../src/compile/handler.ts","../src/delete/handler.ts","../src/delete/poll-deployment.ts","../src/deploy/archive.test.ts","../src/deploy/archive.ts","../src/deploy/environments.ts","../src/deploy/file-upload.ts","../src/deploy/handler.ts","../src/deploy/poll-deployment.ts","../src/dev/handler.ts","../src/editor/handler.ts","../src/link/handler.ts","../src/list/handler.ts","../src/login/login.ts","../src/login/tokens.ts","../src/mtls-certificates/models.ts","../src/mtls-certificates/create/handler.ts","../src/mtls-certificates/delete/handler.ts","../src/mtls-certificates/describe/handler.ts","../src/mtls-certificates/disable/handler.ts","../src/mtls-certificates/list/handler.ts","../src/mtls-certificates/update/handler.ts","../src/open-api/convert/convert-engine.spec.ts","../src/open-api/convert/convert-engine.ts","../src/open-api/convert/handler.spec.ts","../src/open-api/convert/handler.ts","../src/open-api/merge/ajv.ts","../src/open-api/merge/handler.spec.ts","../src/open-api/merge/handler.ts","../src/open-api/merge/interfaces.ts","../src/open-api/merge/merge-engine.spec.ts","../src/open-api/merge/merge-engine.ts","../src/open-api/merge/utils.ts","../src/open-api/overlay/handler.spec.ts","../src/open-api/overlay/handler.ts","../src/open-api/overlay/overlay-engine.spec.ts","../src/open-api/overlay/overlay-engine.ts","../src/project/create/handler.ts","../src/proxies/models.ts","../src/proxies/create/handler.ts","../src/proxies/delete/handler.ts","../src/proxies/describe/handler.ts","../src/proxies/update/handler.ts","../src/source/migrate/dev-portal/handler.ts","../src/source/migrate/dev-portal/types.ts","../src/source/update/handler.ts","../src/test/esbuild-config.ts","../src/test/handler.ts","../src/test/invoke-test.ts","../src/test/test-files.test.ts","../src/test/test-files.ts","../src/test/esbuild-plugins/node-test-prep-plugin.ts","../src/tunnel/models.ts","../src/tunnel/create/handler.ts","../src/tunnel/delete/handler.ts","../src/tunnel/delete/poll-teardown-operation.ts","../src/tunnel/describe/handler.ts","../src/tunnel/list/handler.ts","../src/tunnel/rotate-token/handler.ts","../src/tunnel/services/describe/handler.ts","../src/tunnel/services/update/handler.ts","../src/tunnel/services/update/poll-provisioning-operations.ts","../src/variable/models.ts","../src/variable/create/handler.ts","../src/variable/update/handler.ts"],"version":"5.8.2"}
+{"root":["../src/cli.ts","../src/internal.ts","../src/types.d.ts","../src/__tests__/archive-utils.test.ts","../src/__tests__/import-openapi-utils.test.ts","../src/__tests__/import-openapi.test.ts","../src/__tests__/oas-test-data.ts","../src/__tests__/outdated.test.ts","../src/__tests__/populate.test.ts","../src/__tests__/tsconfig-upgrader.test.ts","../src/__tests__/integration/delete.integration.test.ts","../src/__tests__/integration/deploy.integration.test.ts","../src/__tests__/integration/jest-mocks-setup.ts","../src/__tests__/integration/jest-setup.ts","../src/__tests__/integration/link.integration.test.ts","../src/__tests__/integration/list.integration.test.ts","../src/__tests__/integration/test-utils.ts","../src/__tests__/integration/tunnel.integration.test.ts","../src/__tests__/integration/variable.integration.test.ts","../src/build/handler.ts","../src/cmds/build.ts","../src/cmds/compile.ts","../src/cmds/delete.ts","../src/cmds/deploy.ts","../src/cmds/dev.ts","../src/cmds/docs.ts","../src/cmds/editor.ts","../src/cmds/link.ts","../src/cmds/list.ts","../src/cmds/login.ts","../src/cmds/test.ts","../src/cmds/mtls-certificates/create.ts","../src/cmds/mtls-certificates/delete.ts","../src/cmds/mtls-certificates/describe.ts","../src/cmds/mtls-certificates/disable.ts","../src/cmds/mtls-certificates/index.ts","../src/cmds/mtls-certificates/list.ts","../src/cmds/mtls-certificates/update.ts","../src/cmds/open-api/convert.ts","../src/cmds/open-api/index.ts","../src/cmds/open-api/merge.ts","../src/cmds/open-api/overlay.ts","../src/cmds/project/create.ts","../src/cmds/project/index.ts","../src/cmds/proxies/create.ts","../src/cmds/proxies/delete.ts","../src/cmds/proxies/describe.ts","../src/cmds/proxies/index.ts","../src/cmds/proxies/update.ts","../src/cmds/source/import-openapi.ts","../src/cmds/source/index.ts","../src/cmds/source/migrate.ts","../src/cmds/source/upgrade.ts","../src/cmds/tunnel/create.ts","../src/cmds/tunnel/delete.ts","../src/cmds/tunnel/describe.ts","../src/cmds/tunnel/index.ts","../src/cmds/tunnel/list.ts","../src/cmds/tunnel/rotate-token.ts","../src/cmds/tunnel/services/describe.ts","../src/cmds/tunnel/services/index.ts","../src/cmds/tunnel/services/update.ts","../src/cmds/variable/create.ts","../src/cmds/variable/index.ts","../src/cmds/variable/update.ts","../src/common/alias.ts","../src/common/args.ts","../src/common/constants.ts","../src/common/file-format.ts","../src/common/handler.ts","../src/common/logger.ts","../src/common/models.ts","../src/common/outdated.ts","../src/common/output.ts","../src/common/populate.ts","../src/common/runner.ts","../src/common/settings.ts","../src/common/worker-output.ts","../src/common/analytics/lib.ts","../src/common/api/lib.ts","../src/common/machine-id/lib.ts","../src/common/middleware/authentication.ts","../src/common/middleware/get-account-param.ts","../src/common/middleware/get-environment-param.ts","../src/common/middleware/get-project-param.ts","../src/common/middleware/logging.ts","../src/common/middleware/user-configuration.ts","../src/common/middleware/user-identification.ts","../src/common/middleware/validate-fleet.ts","../src/common/open-api/constants.ts","../src/common/open-api/index.ts","../src/common/open-api/validation.ts","../src/common/upgraders/lib.ts","../src/common/upgraders/package-json-upgrader.ts","../src/common/upgraders/tsconfig-upgrader.ts","../src/common/upgraders/vscode-settings-json-upgrader.ts","../src/common/utils/box.ts","../src/common/utils/branch.ts","../src/common/utils/ports.ts","../src/common/utils/prefixed-output.ts","../src/common/utils/pretty-print-environment-prompt.ts","../src/common/utils/stringify-config.test.ts","../src/common/utils/stringify-config.ts","../src/common/utils/types.ts","../src/common/utils/urls.ts","../src/common/validators/file-system-validator.ts","../src/common/validators/lib.ts","../src/common/validators/project-name-validator.ts","../src/common/xdg/lib.ts","../src/compile/handler.ts","../src/delete/handler.ts","../src/delete/poll-deployment.ts","../src/deploy/archive.test.ts","../src/deploy/archive.ts","../src/deploy/environments.ts","../src/deploy/file-upload.ts","../src/deploy/handler.ts","../src/deploy/poll-deployment.ts","../src/dev/handler.ts","../src/docs/handler.ts","../src/editor/handler.ts","../src/link/handler.ts","../src/list/handler.ts","../src/login/login.ts","../src/login/tokens.ts","../src/mtls-certificates/models.ts","../src/mtls-certificates/create/handler.ts","../src/mtls-certificates/delete/handler.ts","../src/mtls-certificates/describe/handler.ts","../src/mtls-certificates/disable/handler.ts","../src/mtls-certificates/list/handler.ts","../src/mtls-certificates/update/handler.ts","../src/open-api/convert/convert-engine.spec.ts","../src/open-api/convert/convert-engine.ts","../src/open-api/convert/handler.spec.ts","../src/open-api/convert/handler.ts","../src/open-api/merge/ajv.ts","../src/open-api/merge/handler.spec.ts","../src/open-api/merge/handler.ts","../src/open-api/merge/interfaces.ts","../src/open-api/merge/merge-engine.spec.ts","../src/open-api/merge/merge-engine.ts","../src/open-api/merge/utils.ts","../src/open-api/overlay/handler.spec.ts","../src/open-api/overlay/handler.ts","../src/open-api/overlay/overlay-engine.spec.ts","../src/open-api/overlay/overlay-engine.ts","../src/project/create/handler.ts","../src/proxies/models.ts","../src/proxies/create/handler.ts","../src/proxies/delete/handler.ts","../src/proxies/describe/handler.ts","../src/proxies/update/handler.ts","../src/source/migrate/dev-portal/handler.ts","../src/source/migrate/dev-portal/types.ts","../src/source/update/handler.ts","../src/test/esbuild-config.ts","../src/test/handler.ts","../src/test/invoke-test.ts","../src/test/test-files.test.ts","../src/test/test-files.ts","../src/test/esbuild-plugins/node-test-prep-plugin.ts","../src/tunnel/models.ts","../src/tunnel/create/handler.ts","../src/tunnel/delete/handler.ts","../src/tunnel/delete/poll-teardown-operation.ts","../src/tunnel/describe/handler.ts","../src/tunnel/list/handler.ts","../src/tunnel/rotate-token/handler.ts","../src/tunnel/services/describe/handler.ts","../src/tunnel/services/update/handler.ts","../src/tunnel/services/update/poll-provisioning-operations.ts","../src/variable/models.ts","../src/variable/create/handler.ts","../src/variable/update/handler.ts"],"version":"5.8.2"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@zuplo/cli",
-  "version": "6.64.39",
+  "version": "6.64.41",
   "repository": "https://github.com/zuplo/zuplo",
   "author": "Zuplo, Inc.",
   "type": "module",
@@ -29,10 +29,10 @@
     "@opentelemetry/api": "1.9.0",
     "@sentry/node": "9.22.0",
     "@swc/core": "1.10.18",
-    "@zuplo/core": "6.64.39",
+    "@zuplo/core": "6.64.41",
     "@zuplo/editor": "~1.0.0",
-    "@zuplo/openapi-tools": "6.64.39",
-    "@zuplo/runtime": "6.64.39",
+    "@zuplo/openapi-tools": "6.64.41",
+    "@zuplo/runtime": "6.64.41",
     "as-table": "1.0.55",
     "chalk": "5.4.1",
     "chokidar": "3.5.3",