@qpqjs/cli 0.0.0-stage → 0.2.1

package/lib/esm/commands/goDevApi.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goDevApi.js","sourceRoot":"","sources":["../../../src/commands/goDevApi.ts"],"names":[],"mappings":"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","sourcesContent":["// `qpq go:dev:api` — boots the QPQ local dev server. Resolves the app,\n// generates the dev-server entry, builds the rspack config, then runs rspack\n// in watch mode, restarting the server process on every successful rebuild.\n//\n// A restart is not instant: the server drains in-flight work and checkpoints\n// its stores on the way out (typically tens of ms, 5s worst case), and this\n// command waits for that before starting the replacement.\n//\n// The one thing NOT hot-reloaded is the qpq configs themselves: each service's\n// infrastructure.ts is evaluated once at launch and baked into the\n// `quidproquo-dynamic-loader` virtual module — config changes need a full\n// `go:dev:api` restart.\nimport { getAppServiceQpqConfigs, getDevServerRspackConfig } from '@qpqjs/deploy-rspack';\n\nimport { ChildProcess, spawn } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\nimport { rspack } from '@rspack/core';\n\nimport { hasArgFlag } from '../lib/args';\nimport { writeDevServerEntry, writeUserScriptChildEntry } from '../lib/devServerEntry';\nimport { readDevServerPorts } from '../lib/devServerPorts';\nimport { getRoot } from '../lib/discovery';\nimport { KEEP_OTHER_DEV_SERVERS_FLAG } from '../lib/keepOtherDevServersFlag';\nimport { killChildWithEscalation } from '../lib/killChildWithEscalation';\nimport { killOtherQpqDevProcesses, killStaleListeners, reportPortHolders } from '../lib/killStaleListeners';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\n\n// 8080/8888 are set in the generated entry; 3001 is the @qpqjs/dev-server\n// file-storage (secure URL) default port.\nconst getDevServerPortList = (appName: string): number[] => Object.values(readDevServerPorts(appName));\nconst DEV_SERVER_BUNDLE_PATH = path.join('dist', 'qpq', 'dev-server', 'main.js');\n\nexport const goDevApiCommand = async (argv: string[]): Promise<void> => {\n  const root = getRoot();\n  const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });\n  process.env.QPQ_DEV_APP = appName;\n  await resolveDeployment(argv, appName);\n  console.log(`Dev server for app [${appName}]`);\n\n  // The sweep matches on a RELATIVE bundle path, so every checkout's dev\n  // server looks like ours and a sibling worktree gets taken down with it.\n  // Opting out spares it, at the cost of this one not starting: the ports are\n  // the same either way, so what you get instead is EADDRINUSE. Report who\n  // holds them, or that failure says nothing about the cause.\n  if (hasArgFlag(argv, KEEP_OTHER_DEV_SERVERS_FLAG)) {\n    console.log(`${KEEP_OTHER_DEV_SERVERS_FLAG}: leaving other dev servers alone.`);\n    reportPortHolders(getDevServerPortList(appName));\n  } else {\n    // Catches a lingering watcher from a previous run even if its spawned\n    // child already exited (see killOtherQpqDevProcesses) — then the usual\n    // port-based sweep for anything else still bound to our ports.\n    killOtherQpqDevProcesses(root);\n    killStaleListeners(getDevServerPortList(appName), (command) => command.includes(DEV_SERVER_BUNDLE_PATH));\n  }\n\n  const qpqConfigs = getAppServiceQpqConfigs(root, appName);\n  const entry = writeDevServerEntry(root, appName);\n  const userScriptChildEntry = writeUserScriptChildEntry(root);\n  const rspackConfig = getDevServerRspackConfig({ root, entry, userScriptChildEntry, qpqConfigs });\n  const bundlePath = path.join(root, DEV_SERVER_BUNDLE_PATH);\n  const env = { ...process.env, QPQ_DEV_APP: appName };\n\n  // The long-lived server process (HTTP 8080 / WS 8888), restarted per rebuild.\n  let child: ChildProcess | null = null;\n  let restartQueued = false;\n\n  const startServer = (): void => {\n    child = spawn('node', [bundlePath], { stdio: 'inherit', env });\n    child.on('exit', (code) => {\n      child = null;\n      if (!restartQueued) {\n        // Crashed (or exited) on its own — leave it down; the next successful\n        // rebuild (i.e. the next file save) brings it back up.\n        console.log(`Dev server exited with code ${code}. Save a file to restart it.`);\n      }\n    });\n  };\n\n  const restartServer = (): void => {\n    if (restartQueued) return;\n    if (!child) {\n      startServer();\n      return;\n    }\n    restartQueued = true;\n    child.once('exit', () => {\n      restartQueued = false;\n      startServer();\n    });\n\n    // Not a bare kill: the server drains in-flight work before it exits, so it\n    // needs asking properly and then a hard backstop if it wedges. Waiting for\n    // the exit is what keeps the ports free for the replacement.\n    void killChildWithEscalation(child);\n  };\n\n  console.log('Bundling dev server (watch mode)...');\n  let lastHash: string | null | undefined;\n  const compiler = rspack(rspackConfig);\n  compiler.watch({ aggregateTimeout: 200 }, (err, stats) => {\n    if (err) {\n      console.error(err);\n      return;\n    }\n    if (stats?.hasErrors()) {\n      console.error(stats.toString({ colors: true, chunks: false, modules: false }));\n      console.log('Build failed — dev server not restarted. Fix the error and save again.');\n      return;\n    }\n    // Skip no-op rebuilds (e.g. the virtual-module-triggered second compile at\n    // startup): only restart when the output actually changed.\n    if (stats?.hash === lastHash && child) {\n      return;\n    }\n    lastHash = stats?.hash;\n    console.log(child ? 'Rebuilt. Restarting dev server...' : 'Dev server bundled. Starting...');\n    restartServer();\n  });\n\n  // Wait for the server to finish draining before tearing the watcher down and\n  // exiting: closing the compiler first would exit the parent while the child\n  // is still writing, which is the race this whole path exists to close.\n  //\n  // SIGTERM as well as SIGINT, and it is load-bearing rather than symmetry for\n  // its own sake. This process is a WRAPPER: the dev server that handles\n  // signals and drains its work is the child it spawned. Without a handler\n  // here, SIGTERM (what `docker stop` sends, and what any script stopping this\n  // programmatically sends) kills the wrapper outright on the default\n  // disposition, the child never gets asked to stop, and every guarantee the\n  // dev server's shutdown sequence makes is bypassed. go:dev:web already\n  // handles both.\n  let shuttingDown = false;\n\n  const handleShutdownSignal = async (): Promise<void> => {\n    if (shuttingDown) {\n      return;\n    }\n    shuttingDown = true;\n\n    restartQueued = true; // suppress the crash log / rebuild-restart on our own kill\n\n    if (child) {\n      await killChildWithEscalation(child);\n    }\n\n    compiler.close(() => process.exit(0));\n  };\n\n  process.on('SIGINT', () => {\n    void handleShutdownSignal();\n  });\n\n  process.on('SIGTERM', () => {\n    void handleShutdownSignal();\n  });\n};\n"]}

package/lib/esm/commands/goDevWeb.d.ts

@@ -0,0 +1,4 @@
+export type GoDevWebOptions = {
+    hideStartedStatus?: boolean;
+};
+export declare const goDevWebCommand: (argv: string[], options?: GoDevWebOptions) => Promise<void>;

package/lib/esm/commands/goDevWeb.js

@@ -0,0 +1,129 @@
+// `qpq go:dev:web` — boots every views microfrontend's Rspack dev server
+// in-process (shell is the MF host app, plus all remotes on their own ports).
+// Everything is served dynamically; remotes resolve at runtime via
+// mf-manifest.json on localhost ports. Programmatic — no per-views
+// rspack.config.ts or npm serve script needed.
+//
+// Usage:
+//   qpq go:dev:web
+//   qpq go:dev:web --only shell,design
+//   qpq go:dev:web --app <name>
+import { getAllViews, getAppServiceQpqConfigs, getViewsRspackConfig } from '@qpqjs/deploy-rspack';
+import http from 'http';
+import { rspack } from '@rspack/core';
+import { RspackDevServer } from '@rspack/dev-server';
+import { getArgValue } from '../lib/args';
+import { hasArgFlag } from '../lib/args';
+import { readDevServerPorts } from '../lib/devServerPorts';
+import { getRoot } from '../lib/discovery';
+import { KEEP_OTHER_DEV_SERVERS_FLAG } from '../lib/keepOtherDevServersFlag';
+import { isQpqCliCommand, killStaleListeners, reportPortHolders } from '../lib/killStaleListeners';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../lib/resolveDeployment';
+import { setWebAddressingEnv } from '../lib/webAddressingEnv';
+export const goDevWebCommand = async (argv, options = {}) => {
+    const root = getRoot();
+    const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.LOCAL_DEV_SERVER = 'true';
+    process.env.NODE_ENV = 'development';
+    await resolveDeployment(argv, appName);
+    // Local pages address the api dev server and each other by port on localhost.
+    const devServerPorts = readDevServerPorts(appName);
+    setWebAddressingEnv(getAppServiceQpqConfigs(root, appName), {
+        api: devServerPorts.api,
+        webSocket: devServerPorts.webSocket,
+        mapHostPort: (port) => port,
+    });
+    const only = getArgValue(argv, '--only')
+        ?.split(',')
+        .map((s) => s.trim());
+    let views = getAllViews(root, appName);
+    if (only)
+        views = views.filter((v) => only.includes(v.service));
+    if (views.length === 0) {
+        console.error('No views projects found.');
+        process.exit(1);
+    }
+    // See goDevApi for why this is opt-out rather than always-on.
+    if (hasArgFlag(argv, KEEP_OTHER_DEV_SERVERS_FLAG)) {
+        reportPortHolders(views.map((v) => v.port));
+    }
+    else {
+        killStaleListeners(views.map((v) => v.port), isQpqCliCommand);
+    }
+    // Every RspackDevServer.start() registers its own SIGINT/SIGTERM handler on
+    // process — with a dozen views servers in one process that trips node's
+    // default 10-listener warning. Size the limit to the fleet.
+    process.setMaxListeners(Math.max(process.getMaxListeners(), views.length * 2 + 10));
+    // Service names are padded to a common width so the "(started)" chips align.
+    const serviceColumnWidth = Math.max(...views.map((v) => v.service.length));
+    console.log(`Starting ${views.length} views dev servers for [${appName}]:`);
+    for (const v of views)
+        console.log(`  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}`);
+    const servers = [];
+    let shuttingDown = false;
+    const shutdown = (code) => {
+        if (shuttingDown)
+            return;
+        shuttingDown = true;
+        Promise.allSettled(servers.map((server) => server.stop())).then(() => process.exit(code));
+    };
+    // The URL list above gets a yellow "(started)" chip appended in place as
+    // each dev server begins answering HTTP. The in-place rewrite moves the
+    // cursor up past everything printed since the list, so every line printed
+    // below it MUST go through logBelowList to keep the offset accurate.
+    let linesBelowList = 0;
+    const logBelowList = (line) => {
+        console.log(line);
+        linesBelowList += 1;
+    };
+    const markStarted = (index) => {
+        const v = views[index];
+        if (!process.stdout.isTTY) {
+            logBelowList(`  ${v.service} started`);
+            return;
+        }
+        const line = `  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}  \x1b[33m(started)\x1b[0m`;
+        const up = linesBelowList + (views.length - index);
+        process.stdout.write(`\x1b[${up}F\x1b[2K${line}\x1b[${up}E`);
+    };
+    const pollUntilStarted = (index) => {
+        const attempt = () => {
+            if (shuttingDown)
+                return;
+            const req = http.get({
+                host: 'localhost',
+                port: views[index].port,
+                path: '/',
+                timeout: 1000,
+            }, (res) => {
+                res.resume();
+                markStarted(index);
+            });
+            req.on('error', () => setTimeout(attempt, 500));
+            req.on('timeout', () => req.destroy());
+        };
+        attempt();
+    };
+    for (const [index, view] of views.entries()) {
+        const config = getViewsRspackConfig(view.viewsDir);
+        const compiler = rspack(config);
+        const server = new RspackDevServer(config.devServer || { port: view.port }, compiler);
+        servers.push(server);
+        try {
+            await server.start();
+        }
+        catch (e) {
+            logBelowList(`  [${view.service}] failed to start: ${e.message} — shutting down all views servers.`);
+            shutdown(1);
+            return;
+        }
+        // markStarted is the only consumer of the ready signal, so there is
+        // nothing to poll for when the status is hidden.
+        if (!options.hideStartedStatus)
+            pollUntilStarted(index);
+    }
+    process.on('SIGINT', () => shutdown(0));
+    process.on('SIGTERM', () => shutdown(0));
+};
+//# sourceMappingURL=goDevWeb.js.map

package/lib/esm/commands/goDevWeb.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goDevWeb.js","sourceRoot":"","sources":["../../../src/commands/goDevWeb.ts"],"names":[],"mappings":"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","sourcesContent":["// `qpq go:dev:web` — boots every views microfrontend's Rspack dev server\n// in-process (shell is the MF host app, plus all remotes on their own ports).\n// Everything is served dynamically; remotes resolve at runtime via\n// mf-manifest.json on localhost ports. Programmatic — no per-views\n// rspack.config.ts or npm serve script needed.\n//\n// Usage:\n//   qpq go:dev:web\n//   qpq go:dev:web --only shell,design\n//   qpq go:dev:web --app <name>\nimport { getAllViews, getAppServiceQpqConfigs, getViewsRspackConfig } from '@qpqjs/deploy-rspack';\n\nimport http from 'http';\nimport { rspack } from '@rspack/core';\nimport { RspackDevServer } from '@rspack/dev-server';\n\nimport { getArgValue } from '../lib/args';\nimport { hasArgFlag } from '../lib/args';\nimport { readDevServerPorts } from '../lib/devServerPorts';\nimport { getRoot } from '../lib/discovery';\nimport { KEEP_OTHER_DEV_SERVERS_FLAG } from '../lib/keepOtherDevServersFlag';\nimport { isQpqCliCommand, killStaleListeners, reportPortHolders } from '../lib/killStaleListeners';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\nimport { setWebAddressingEnv } from '../lib/webAddressingEnv';\n\nexport type GoDevWebOptions = {\n  // The in-place \"(started)\" chip rewrite assumes this command owns the\n  // terminal; when stdout is shared with the API dev server (combined\n  // `qpq go:dev`) the cursor math breaks. The plain-line fallback is just a\n  // wall of \"  auth started\" noise interleaved with the API output, so drop\n  // the ready status altogether there.\n  hideStartedStatus?: boolean;\n};\n\nexport const goDevWebCommand = async (argv: string[], options: GoDevWebOptions = {}): Promise<void> => {\n  const root = getRoot();\n  const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });\n\n  process.env.LOCAL_DEV_SERVER = 'true';\n  process.env.NODE_ENV = 'development';\n  await resolveDeployment(argv, appName);\n\n  // Local pages address the api dev server and each other by port on localhost.\n  const devServerPorts = readDevServerPorts(appName);\n  setWebAddressingEnv(getAppServiceQpqConfigs(root, appName), {\n    api: devServerPorts.api,\n    webSocket: devServerPorts.webSocket,\n    mapHostPort: (port) => port,\n  });\n\n  const only = getArgValue(argv, '--only')\n    ?.split(',')\n    .map((s) => s.trim());\n\n  let views = getAllViews(root, appName);\n  if (only) views = views.filter((v) => only.includes(v.service));\n  if (views.length === 0) {\n    console.error('No views projects found.');\n    process.exit(1);\n  }\n\n  // See goDevApi for why this is opt-out rather than always-on.\n  if (hasArgFlag(argv, KEEP_OTHER_DEV_SERVERS_FLAG)) {\n    reportPortHolders(views.map((v) => v.port));\n  } else {\n    killStaleListeners(\n      views.map((v) => v.port),\n      isQpqCliCommand,\n    );\n  }\n\n  // Every RspackDevServer.start() registers its own SIGINT/SIGTERM handler on\n  // process — with a dozen views servers in one process that trips node's\n  // default 10-listener warning. Size the limit to the fleet.\n  process.setMaxListeners(Math.max(process.getMaxListeners(), views.length * 2 + 10));\n\n  // Service names are padded to a common width so the \"(started)\" chips align.\n  const serviceColumnWidth = Math.max(...views.map((v) => v.service.length));\n\n  console.log(`Starting ${views.length} views dev servers for [${appName}]:`);\n  for (const v of views) console.log(`  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}`);\n\n  const servers: RspackDevServer[] = [];\n  let shuttingDown = false;\n\n  const shutdown = (code: number): void => {\n    if (shuttingDown) return;\n    shuttingDown = true;\n    Promise.allSettled(servers.map((server) => server.stop())).then(() => process.exit(code));\n  };\n\n  // The URL list above gets a yellow \"(started)\" chip appended in place as\n  // each dev server begins answering HTTP. The in-place rewrite moves the\n  // cursor up past everything printed since the list, so every line printed\n  // below it MUST go through logBelowList to keep the offset accurate.\n  let linesBelowList = 0;\n\n  const logBelowList = (line: string): void => {\n    console.log(line);\n    linesBelowList += 1;\n  };\n\n  const markStarted = (index: number): void => {\n    const v = views[index];\n    if (!process.stdout.isTTY) {\n      logBelowList(`  ${v.service} started`);\n      return;\n    }\n    const line = `  http://localhost:${v.port}  ${v.service.padEnd(serviceColumnWidth)}  \\x1b[33m(started)\\x1b[0m`;\n    const up = linesBelowList + (views.length - index);\n    process.stdout.write(`\\x1b[${up}F\\x1b[2K${line}\\x1b[${up}E`);\n  };\n\n  const pollUntilStarted = (index: number): void => {\n    const attempt = (): void => {\n      if (shuttingDown) return;\n      const req = http.get(\n        {\n          host: 'localhost',\n          port: views[index].port,\n          path: '/',\n          timeout: 1000,\n        },\n        (res) => {\n          res.resume();\n          markStarted(index);\n        },\n      );\n      req.on('error', () => setTimeout(attempt, 500));\n      req.on('timeout', () => req.destroy());\n    };\n    attempt();\n  };\n\n  for (const [index, view] of views.entries()) {\n    const config = getViewsRspackConfig(view.viewsDir);\n    const compiler = rspack(config);\n    const server = new RspackDevServer(config.devServer || { port: view.port }, compiler);\n    servers.push(server);\n\n    try {\n      await server.start();\n    } catch (e) {\n      logBelowList(`  [${view.service}] failed to start: ${(e as Error).message} — shutting down all views servers.`);\n      shutdown(1);\n      return;\n    }\n\n    // markStarted is the only consumer of the ready signal, so there is\n    // nothing to poll for when the status is hidden.\n    if (!options.hideStartedStatus) pollUntilStarted(index);\n  }\n\n  process.on('SIGINT', () => shutdown(0));\n  process.on('SIGTERM', () => shutdown(0));\n};\n"]}

package/lib/esm/commands/goDocker.d.ts

@@ -0,0 +1 @@
+export declare const goDockerCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/goDocker.js

@@ -0,0 +1,29 @@
+// `qpq go:docker` — asks the same questions as `qpq go`, then runs the
+// platform driver's parallel containerized deploy (drivers without a docker
+// strategy don't offer one). `--build-only` and `--from-build` split that run
+// into a build half and a deploy half that can run on different machines.
+import { buildDeployPlanFromArgs, promptDeployPlan } from '../lib/deployPrompts';
+import { BUILD_ONLY_FLAG, FROM_BUILD_FLAG, resolveGoDockerMode } from '../lib/goDockerMode';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../lib/resolveDeployment';
+import { getPlatformDriver } from '../platforms';
+export const goDockerCommand = async (argv) => {
+    const mode = resolveGoDockerMode(argv);
+    const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { deployment } = await resolveDeployment(argv, appName);
+    const driver = getPlatformDriver(deployment.platform);
+    if (!driver.goDocker) {
+        console.error(`Platform '${deployment.platform}' has no dockerized deploy — use qpq go instead.`);
+        process.exit(1);
+    }
+    // Positional args (`qpq go:docker all all`) run prompt-free; otherwise ask.
+    const plan = buildDeployPlanFromArgs(appName, argv) ?? (await promptDeployPlan(appName));
+    // account, domain and bootstrap stacks deploy host-side through the workspace
+    // CDK app in one step; there is no saved build to split them across.
+    if (mode !== 'full' && (plan.kind === 'account' || plan.kind === 'bootstrap')) {
+        console.error(`${BUILD_ONLY_FLAG} and ${FROM_BUILD_FLAG} apply to service deploys only; account, domain and bootstrap deploy in one step.`);
+        process.exit(1);
+    }
+    await driver.goDocker(appName, plan, mode);
+};
+//# sourceMappingURL=goDocker.js.map

package/lib/esm/commands/goDocker.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goDocker.js","sourceRoot":"","sources":["../../../src/commands/goDocker.ts"],"names":[],"mappings":"AAAA,uEAAuE;AACvE,4EAA4E;AAC5E,8EAA8E;AAC9E,0EAA0E;AAC1E,OAAO,EAAE,uBAAuB,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,eAAe,EAAE,eAAe,EAAE,mBAAmB,EAAE,MAAM,qBAAqB,CAAC;AAC5F,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,eAAe,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IACrE,MAAM,IAAI,GAAG,mBAAmB,CAAC,IAAI,CAAC,CAAC;IACvC,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAC9D,MAAM,MAAM,GAAG,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC,CAAC;IAEtD,IAAI,CAAC,MAAM,CAAC,QAAQ,EAAE,CAAC;QACrB,OAAO,CAAC,KAAK,CAAC,aAAa,UAAU,CAAC,QAAQ,kDAAkD,CAAC,CAAC;QAClG,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,4EAA4E;IAC5E,MAAM,IAAI,GAAG,uBAAuB,CAAC,OAAO,EAAE,IAAI,CAAC,IAAI,CAAC,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC,CAAC;IAEzF,8EAA8E;IAC9E,qEAAqE;IACrE,IAAI,IAAI,KAAK,MAAM,IAAI,CAAC,IAAI,CAAC,IAAI,KAAK,SAAS,IAAI,IAAI,CAAC,IAAI,KAAK,WAAW,CAAC,EAAE,CAAC;QAC9E,OAAO,CAAC,KAAK,CAAC,GAAG,eAAe,QAAQ,eAAe,mFAAmF,CAAC,CAAC;QAC5I,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,CAAC,QAAQ,CAAC,OAAO,EAAE,IAAI,EAAE,IAAI,CAAC,CAAC;AAC7C,CAAC,CAAC","sourcesContent":["// `qpq go:docker` — asks the same questions as `qpq go`, then runs the\n// platform driver's parallel containerized deploy (drivers without a docker\n// strategy don't offer one). `--build-only` and `--from-build` split that run\n// into a build half and a deploy half that can run on different machines.\nimport { buildDeployPlanFromArgs, promptDeployPlan } from '../lib/deployPrompts';\nimport { BUILD_ONLY_FLAG, FROM_BUILD_FLAG, resolveGoDockerMode } from '../lib/goDockerMode';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\nimport { getPlatformDriver } from '../platforms';\n\nexport const goDockerCommand = async (argv: string[]): Promise<void> => {\n  const mode = resolveGoDockerMode(argv);\n  const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });\n  const { deployment } = await resolveDeployment(argv, appName);\n  const driver = getPlatformDriver(deployment.platform);\n\n  if (!driver.goDocker) {\n    console.error(`Platform '${deployment.platform}' has no dockerized deploy — use qpq go instead.`);\n    process.exit(1);\n  }\n\n  // Positional args (`qpq go:docker all all`) run prompt-free; otherwise ask.\n  const plan = buildDeployPlanFromArgs(appName, argv) ?? (await promptDeployPlan(appName));\n\n  // account, domain and bootstrap stacks deploy host-side through the workspace\n  // CDK app in one step; there is no saved build to split them across.\n  if (mode !== 'full' && (plan.kind === 'account' || plan.kind === 'bootstrap')) {\n    console.error(`${BUILD_ONLY_FLAG} and ${FROM_BUILD_FLAG} apply to service deploys only; account, domain and bootstrap deploy in one step.`);\n    process.exit(1);\n  }\n\n  await driver.goDocker(appName, plan, mode);\n};\n"]}

package/lib/esm/commands/hooks.d.ts

@@ -0,0 +1 @@
+export declare const hooksCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/hooks.js

@@ -0,0 +1,26 @@
+// `qpq hooks <name>` — run the `qpq:<name>` script (or the plain `<name>`
+// script when no qpq:-prefixed one exists) of every app and workspace package
+// that defines one, in dependency order with parallel execution.
+// Wire the root package.json's lifecycle to it, e.g.
+// "postinstall": "qpq hooks postinstall". Use --jobs=1 to force serial runs.
+import { getArgValue } from '../lib/args';
+import { getDefaultHookJobs } from '../lib/getDefaultHookJobs';
+import { runHookForAllPackages } from '../lib/hooks';
+import { assertNoFailures } from '../lib/runTasks';
+const getJobs = (argv) => {
+    const parsed = Number(getArgValue(argv, '--jobs'));
+    if (Number.isFinite(parsed) && parsed >= 1) {
+        return Math.floor(parsed);
+    }
+    return getDefaultHookJobs();
+};
+export const hooksCommand = async (argv) => {
+    const [hook] = argv.filter((a) => !a.startsWith('--'));
+    if (!hook) {
+        console.error('Usage: qpq hooks <name> [--jobs=N]   (runs qpq:<name>, or plain <name>, in every app/package that defines it)');
+        process.exit(1);
+    }
+    const failures = await runHookForAllPackages(hook, getJobs(argv));
+    assertNoFailures(`hooks ${hook}`, failures);
+};
+//# sourceMappingURL=hooks.js.map

package/lib/esm/commands/hooks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hooks.js","sourceRoot":"","sources":["../../../src/commands/hooks.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,8EAA8E;AAC9E,iEAAiE;AACjE,qDAAqD;AACrD,6EAA6E;AAC7E,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,kBAAkB,EAAE,MAAM,2BAA2B,CAAC;AAC/D,OAAO,EAAE,qBAAqB,EAAE,MAAM,cAAc,CAAC;AACrD,OAAO,EAAE,gBAAgB,EAAE,MAAM,iBAAiB,CAAC;AAEnD,MAAM,OAAO,GAAG,CAAC,IAAc,EAAU,EAAE;IACzC,MAAM,MAAM,GAAG,MAAM,CAAC,WAAW,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;IACnD,IAAI,MAAM,CAAC,QAAQ,CAAC,MAAM,CAAC,IAAI,MAAM,IAAI,CAAC,EAAE,CAAC;QAC3C,OAAO,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC;IAC5B,CAAC;IACD,OAAO,kBAAkB,EAAE,CAAC;AAC9B,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,YAAY,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAClE,MAAM,CAAC,IAAI,CAAC,GAAG,IAAI,CAAC,MAAM,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,CAAC;IAEvD,IAAI,CAAC,IAAI,EAAE,CAAC;QACV,OAAO,CAAC,KAAK,CAAC,+GAA+G,CAAC,CAAC;QAC/H,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,GAAG,MAAM,qBAAqB,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC;IAClE,gBAAgB,CAAC,SAAS,IAAI,EAAE,EAAE,QAAQ,CAAC,CAAC;AAC9C,CAAC,CAAC","sourcesContent":["// `qpq hooks <name>` — run the `qpq:<name>` script (or the plain `<name>`\n// script when no qpq:-prefixed one exists) of every app and workspace package\n// that defines one, in dependency order with parallel execution.\n// Wire the root package.json's lifecycle to it, e.g.\n// \"postinstall\": \"qpq hooks postinstall\". Use --jobs=1 to force serial runs.\nimport { getArgValue } from '../lib/args';\nimport { getDefaultHookJobs } from '../lib/getDefaultHookJobs';\nimport { runHookForAllPackages } from '../lib/hooks';\nimport { assertNoFailures } from '../lib/runTasks';\n\nconst getJobs = (argv: string[]): number => {\n  const parsed = Number(getArgValue(argv, '--jobs'));\n  if (Number.isFinite(parsed) && parsed >= 1) {\n    return Math.floor(parsed);\n  }\n  return getDefaultHookJobs();\n};\n\nexport const hooksCommand = async (argv: string[]): Promise<void> => {\n  const [hook] = argv.filter((a) => !a.startsWith('--'));\n\n  if (!hook) {\n    console.error('Usage: qpq hooks <name> [--jobs=N]   (runs qpq:<name>, or plain <name>, in every app/package that defines it)');\n    process.exit(1);\n  }\n\n  const failures = await runHookForAllPackages(hook, getJobs(argv));\n  assertNoFailures(`hooks ${hook}`, failures);\n};\n"]}

package/lib/esm/commands/migrate.d.ts

@@ -0,0 +1 @@
+export declare const migrateCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/migrate.js

@@ -0,0 +1,57 @@
+// `qpq migrate` — run every pending migration against the LOCAL dev store, once, then exit.
+//
+// Deployed, migrations are triggered by a stack update. Nothing locally ever deploys, so
+// without this a migration is first executed in a real environment, which is a poor place to
+// discover what it does. This bundles exactly what `go:dev:api` bundles and runs the same
+// queue path, so a local run rehearses the deployed one rather than a convenient lookalike.
+//
+// Migrations are recorded as they run, in the same store the deploy path uses, so running
+// this twice is a no-op the second time.
+import { getAppServiceQpqConfigs, getDevServerRspackConfig } from '@qpqjs/deploy-rspack';
+import { spawn } from 'child_process';
+import path from 'path';
+import { rspack } from '@rspack/core';
+import { writeDevServerEntry } from '../lib/devServerEntry';
+import { getRoot } from '../lib/discovery';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../lib/resolveDeployment';
+const MIGRATE_BUNDLE_PATH = path.join('dist', 'qpq', 'dev-server', 'migrate.js');
+export const migrateCommand = async (argv) => {
+    const root = getRoot();
+    const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.QPQ_DEV_APP = appName;
+    await resolveDeployment(argv, appName);
+    console.log(`Running local migrations for app [${appName}]`);
+    const qpqConfigs = getAppServiceQpqConfigs(root, appName);
+    const entry = writeDevServerEntry(root, appName, 'migrate');
+    const rspackConfig = getDevServerRspackConfig({ root, entry, qpqConfigs });
+    // Same bundle shape as the dev server, different output name so a running `go:dev:api`
+    // watcher does not fight over the file.
+    const bundlePath = path.join(root, MIGRATE_BUNDLE_PATH);
+    const migrateConfig = {
+        ...rspackConfig,
+        output: { ...rspackConfig.output, filename: 'migrate.js' },
+    };
+    await new Promise((resolve, reject) => {
+        rspack(migrateConfig, (error, stats) => {
+            if (error) {
+                return reject(error);
+            }
+            if (stats?.hasErrors()) {
+                console.error(stats.toString({ colors: true, all: false, errors: true }));
+                return reject(new Error('Failed to bundle migrations'));
+            }
+            resolve();
+        });
+    });
+    // The bundle exits non-zero on failure; mirror that so a shell chain or CI notices instead
+    // of carrying on as though the data were migrated.
+    const exitCode = await new Promise((resolve) => {
+        const child = spawn('node', [bundlePath], { stdio: 'inherit', env: { ...process.env, QPQ_DEV_APP: appName } });
+        child.on('exit', (code) => resolve(code ?? 1));
+    });
+    if (exitCode !== 0) {
+        process.exitCode = exitCode;
+    }
+};
+//# sourceMappingURL=migrate.js.map

package/lib/esm/commands/migrate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"migrate.js","sourceRoot":"","sources":["../../../src/commands/migrate.ts"],"names":[],"mappings":"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","sourcesContent":["// `qpq migrate` — run every pending migration against the LOCAL dev store, once, then exit.\n//\n// Deployed, migrations are triggered by a stack update. Nothing locally ever deploys, so\n// without this a migration is first executed in a real environment, which is a poor place to\n// discover what it does. This bundles exactly what `go:dev:api` bundles and runs the same\n// queue path, so a local run rehearses the deployed one rather than a convenient lookalike.\n//\n// Migrations are recorded as they run, in the same store the deploy path uses, so running\n// this twice is a no-op the second time.\nimport { getAppServiceQpqConfigs, getDevServerRspackConfig } from '@qpqjs/deploy-rspack';\n\nimport { spawn } from 'child_process';\nimport path from 'path';\nimport { rspack } from '@rspack/core';\n\nimport { writeDevServerEntry } from '../lib/devServerEntry';\nimport { getRoot } from '../lib/discovery';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\n\nconst MIGRATE_BUNDLE_PATH = path.join('dist', 'qpq', 'dev-server', 'migrate.js');\n\nexport const migrateCommand = async (argv: string[]): Promise<void> => {\n  const root = getRoot();\n  const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });\n  process.env.QPQ_DEV_APP = appName;\n  await resolveDeployment(argv, appName);\n\n  console.log(`Running local migrations for app [${appName}]`);\n\n  const qpqConfigs = getAppServiceQpqConfigs(root, appName);\n  const entry = writeDevServerEntry(root, appName, 'migrate');\n  const rspackConfig = getDevServerRspackConfig({ root, entry, qpqConfigs });\n\n  // Same bundle shape as the dev server, different output name so a running `go:dev:api`\n  // watcher does not fight over the file.\n  const bundlePath = path.join(root, MIGRATE_BUNDLE_PATH);\n  const migrateConfig = {\n    ...rspackConfig,\n    output: { ...rspackConfig.output, filename: 'migrate.js' },\n  };\n\n  await new Promise<void>((resolve, reject) => {\n    rspack(migrateConfig as any, (error, stats) => {\n      if (error) {\n        return reject(error);\n      }\n\n      if (stats?.hasErrors()) {\n        console.error(stats.toString({ colors: true, all: false, errors: true }));\n        return reject(new Error('Failed to bundle migrations'));\n      }\n\n      resolve();\n    });\n  });\n\n  // The bundle exits non-zero on failure; mirror that so a shell chain or CI notices instead\n  // of carrying on as though the data were migrated.\n  const exitCode = await new Promise<number>((resolve) => {\n    const child = spawn('node', [bundlePath], { stdio: 'inherit', env: { ...process.env, QPQ_DEV_APP: appName } });\n    child.on('exit', (code) => resolve(code ?? 1));\n  });\n\n  if (exitCode !== 0) {\n    process.exitCode = exitCode;\n  }\n};\n"]}

package/lib/esm/commands/prep.d.ts

@@ -0,0 +1 @@
+export declare const prepCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/prep.js

@@ -0,0 +1,15 @@
+// `qpq prep` — regenerates apps/<app>/tsconfig.federated.json (the TypeScript
+// path aliases for cross-view federated imports). Run after adding/removing a
+// `// federated.export` marker.
+import { writeFederatedTsconfigForApp } from '@qpqjs/deploy-rspack';
+import { getAvailableApps, getRoot } from '../lib/discovery';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+export const prepCommand = async (argv) => {
+    const selection = await resolveAppSelection({ argv, allowAll: true });
+    const appNames = selection === 'all' ? getAvailableApps() : [selection];
+    for (const appName of appNames) {
+        const exposeCount = writeFederatedTsconfigForApp(getRoot(), appName);
+        console.log(`prep: wrote ${exposeCount} federated aliases to apps/${appName}/tsconfig.federated.json`);
+    }
+};
+//# sourceMappingURL=prep.js.map

package/lib/esm/commands/prep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prep.js","sourceRoot":"","sources":["../../../src/commands/prep.ts"],"names":[],"mappings":"AAAA,8EAA8E;AAC9E,8EAA8E;AAC9E,gCAAgC;AAChC,OAAO,EAAE,4BAA4B,EAAE,MAAM,sBAAsB,CAAC;AAEpE,OAAO,EAAE,gBAAgB,EAAE,OAAO,EAAE,MAAM,kBAAkB,CAAC;AAC7D,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AAEjE,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IACjE,MAAM,SAAS,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,CAAC,CAAC;IACtE,MAAM,QAAQ,GAAG,SAAS,KAAK,KAAK,CAAC,CAAC,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC;IAExE,KAAK,MAAM,OAAO,IAAI,QAAQ,EAAE,CAAC;QAC/B,MAAM,WAAW,GAAG,4BAA4B,CAAC,OAAO,EAAE,EAAE,OAAO,CAAC,CAAC;QACrE,OAAO,CAAC,GAAG,CAAC,eAAe,WAAW,8BAA8B,OAAO,0BAA0B,CAAC,CAAC;IACzG,CAAC;AACH,CAAC,CAAC","sourcesContent":["// `qpq prep` — regenerates apps/<app>/tsconfig.federated.json (the TypeScript\n// path aliases for cross-view federated imports). Run after adding/removing a\n// `// federated.export` marker.\nimport { writeFederatedTsconfigForApp } from '@qpqjs/deploy-rspack';\n\nimport { getAvailableApps, getRoot } from '../lib/discovery';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\n\nexport const prepCommand = async (argv: string[]): Promise<void> => {\n  const selection = await resolveAppSelection({ argv, allowAll: true });\n  const appNames = selection === 'all' ? getAvailableApps() : [selection];\n\n  for (const appName of appNames) {\n    const exposeCount = writeFederatedTsconfigForApp(getRoot(), appName);\n    console.log(`prep: wrote ${exposeCount} federated aliases to apps/${appName}/tsconfig.federated.json`);\n  }\n};\n"]}

package/lib/esm/commands/publish.d.ts

@@ -0,0 +1,4 @@
+export declare const publishCommand: (argv: string[]) => Promise<void>;
+export declare const publishBuildCommand: (argv: string[]) => Promise<void>;
+export declare const publishUploadCommand: (argv: string[]) => Promise<void>;
+export declare const publishDeployCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/publish.js

@@ -0,0 +1,38 @@
+// `qpq publish[:build|:upload|:deploy]` — build each backend service as a
+// module-federation remote and publish it into the platform's federated code
+// store, so the deployed backends federate their story code instead of running
+// the bundled copy. The mechanics live in the platform driver (AWS: S3-backed,
+// see platforms/aws/publish).
+//
+// Usage:
+//   qpq publish --app docgen                    (all services)
+//   qpq publish --app docgen --service template
+import { getArgValue } from '../lib/args';
+import { getServiceNames } from '../lib/discovery';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { resolveDeployment } from '../lib/resolveDeployment';
+import { getPlatformDriver } from '../platforms';
+const resolvePublishSelection = async (argv) => {
+    const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { deployment } = await resolveDeployment(argv, appName);
+    const requestedService = getArgValue(argv, '--service');
+    const serviceNames = requestedService ? [requestedService] : getServiceNames(appName);
+    return { driver: getPlatformDriver(deployment.platform), appName, serviceNames };
+};
+export const publishCommand = async (argv) => {
+    const { driver, appName, serviceNames } = await resolvePublishSelection(argv);
+    await driver.publish(appName, serviceNames);
+};
+export const publishBuildCommand = async (argv) => {
+    const { driver, appName, serviceNames } = await resolvePublishSelection(argv);
+    await driver.publishBuild(appName, serviceNames);
+};
+export const publishUploadCommand = async (argv) => {
+    const { driver, appName, serviceNames } = await resolvePublishSelection(argv);
+    await driver.publishUpload(appName, serviceNames);
+};
+export const publishDeployCommand = async (argv) => {
+    const { driver, appName, serviceNames } = await resolvePublishSelection(argv);
+    await driver.publishDeploy(appName, serviceNames);
+};
+//# sourceMappingURL=publish.js.map

package/lib/esm/commands/publish.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"publish.js","sourceRoot":"","sources":["../../../src/commands/publish.ts"],"names":[],"mappings":"AAAA,0EAA0E;AAC1E,6EAA6E;AAC7E,+EAA+E;AAC/E,+EAA+E;AAC/E,8BAA8B;AAC9B,EAAE;AACF,SAAS;AACT,+DAA+D;AAC/D,gDAAgD;AAChD,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,eAAe,EAAE,MAAM,kBAAkB,CAAC;AACnD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,0BAA0B,CAAC;AAC7D,OAAO,EAAE,iBAAiB,EAAqB,MAAM,cAAc,CAAC;AAQpE,MAAM,uBAAuB,GAAG,KAAK,EAAE,IAAc,EAA6B,EAAE;IAClF,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,UAAU,EAAE,GAAG,MAAM,iBAAiB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IAE9D,MAAM,gBAAgB,GAAG,WAAW,CAAC,IAAI,EAAE,WAAW,CAAC,CAAC;IACxD,MAAM,YAAY,GAAG,gBAAgB,CAAC,CAAC,CAAC,CAAC,gBAAgB,CAAC,CAAC,CAAC,CAAC,eAAe,CAAC,OAAO,CAAC,CAAC;IAEtF,OAAO,EAAE,MAAM,EAAE,iBAAiB,CAAC,UAAU,CAAC,QAAQ,CAAC,EAAE,OAAO,EAAE,YAAY,EAAE,CAAC;AACnF,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IACpE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,MAAM,CAAC,OAAO,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AAC9C,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,mBAAmB,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IACzE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,MAAM,CAAC,YAAY,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACnD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAC1E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAC1E,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,YAAY,EAAE,GAAG,MAAM,uBAAuB,CAAC,IAAI,CAAC,CAAC;IAC9E,MAAM,MAAM,CAAC,aAAa,CAAC,OAAO,EAAE,YAAY,CAAC,CAAC;AACpD,CAAC,CAAC","sourcesContent":["// `qpq publish[:build|:upload|:deploy]` — build each backend service as a\n// module-federation remote and publish it into the platform's federated code\n// store, so the deployed backends federate their story code instead of running\n// the bundled copy. The mechanics live in the platform driver (AWS: S3-backed,\n// see platforms/aws/publish).\n//\n// Usage:\n//   qpq publish --app docgen                    (all services)\n//   qpq publish --app docgen --service template\nimport { getArgValue } from '../lib/args';\nimport { getServiceNames } from '../lib/discovery';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { resolveDeployment } from '../lib/resolveDeployment';\nimport { getPlatformDriver, QpqPlatformDriver } from '../platforms';\n\ntype PublishSelection = {\n  driver: QpqPlatformDriver;\n  appName: string;\n  serviceNames: string[];\n};\n\nconst resolvePublishSelection = async (argv: string[]): Promise<PublishSelection> => {\n  const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });\n  const { deployment } = await resolveDeployment(argv, appName);\n\n  const requestedService = getArgValue(argv, '--service');\n  const serviceNames = requestedService ? [requestedService] : getServiceNames(appName);\n\n  return { driver: getPlatformDriver(deployment.platform), appName, serviceNames };\n};\n\nexport const publishCommand = async (argv: string[]): Promise<void> => {\n  const { driver, appName, serviceNames } = await resolvePublishSelection(argv);\n  await driver.publish(appName, serviceNames);\n};\n\nexport const publishBuildCommand = async (argv: string[]): Promise<void> => {\n  const { driver, appName, serviceNames } = await resolvePublishSelection(argv);\n  await driver.publishBuild(appName, serviceNames);\n};\n\nexport const publishUploadCommand = async (argv: string[]): Promise<void> => {\n  const { driver, appName, serviceNames } = await resolvePublishSelection(argv);\n  await driver.publishUpload(appName, serviceNames);\n};\n\nexport const publishDeployCommand = async (argv: string[]): Promise<void> => {\n  const { driver, appName, serviceNames } = await resolvePublishSelection(argv);\n  await driver.publishDeploy(appName, serviceNames);\n};\n"]}

package/lib/esm/commands/scriptBuild.d.ts

@@ -0,0 +1 @@
+export declare const scriptBuildCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/scriptBuild.js

@@ -0,0 +1,29 @@
+// `qpq script:build <dir> [--out <dir>] [--source-map]` — bundle a user-script project
+// into one main.js that askUserScriptExecute can load from a drive. `--source-map`
+// embeds the map in main.js; no separate .map file is ever written.
+import { buildUserScript, checkUserScriptOutput, UserScriptBuildError } from '@qpqjs/user-script';
+import path from 'path';
+import { getArgValue, getPositionalArgs, hasArgFlag } from '../lib/args';
+export const scriptBuildCommand = async (argv) => {
+    const [projectDir] = getPositionalArgs(argv, ['--out']);
+    if (!projectDir) {
+        console.error('Usage: qpq script:build <dir> [--out <dir>] [--source-map]');
+        process.exit(1);
+    }
+    const outDir = getArgValue(argv, '--out') ?? path.join(projectDir, 'dist');
+    try {
+        const result = await buildUserScript({ projectDir, outDir, sourceMap: hasArgFlag(argv, '--source-map') });
+        // A developer's own build is checked in this process; a platform build asks the sandbox.
+        const exports = checkUserScriptOutput(result.entryPath);
+        console.log(`script:build: wrote ${result.entryPath}`);
+        console.log(`  exports: ${exports.join(', ')}`);
+    }
+    catch (error) {
+        if (error instanceof UserScriptBuildError) {
+            console.error(`script:build: ${error.code}: ${error.message}`);
+            process.exit(1);
+        }
+        throw error;
+    }
+};
+//# sourceMappingURL=scriptBuild.js.map

package/lib/esm/commands/scriptBuild.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptBuild.js","sourceRoot":"","sources":["../../../src/commands/scriptBuild.ts"],"names":[],"mappings":"AAAA,uFAAuF;AACvF,mFAAmF;AACnF,oEAAoE;AACpE,OAAO,EAAE,eAAe,EAAE,qBAAqB,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAElG,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,WAAW,EAAE,iBAAiB,EAAE,UAAU,EAAE,MAAM,aAAa,CAAC;AAEzE,MAAM,CAAC,MAAM,kBAAkB,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IACxE,MAAM,CAAC,UAAU,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,CAAC,OAAO,CAAC,CAAC,CAAC;IACxD,IAAI,CAAC,UAAU,EAAE,CAAC;QAChB,OAAO,CAAC,KAAK,CAAC,4DAA4D,CAAC,CAAC;QAC5E,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,MAAM,GAAG,WAAW,CAAC,IAAI,EAAE,OAAO,CAAC,IAAI,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,MAAM,CAAC,CAAC;IAE3E,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,MAAM,eAAe,CAAC,EAAE,UAAU,EAAE,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,IAAI,EAAE,cAAc,CAAC,EAAE,CAAC,CAAC;QAC1G,yFAAyF;QACzF,MAAM,OAAO,GAAG,qBAAqB,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;QACxD,OAAO,CAAC,GAAG,CAAC,uBAAuB,MAAM,CAAC,SAAS,EAAE,CAAC,CAAC;QACvD,OAAO,CAAC,GAAG,CAAC,cAAc,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAClD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,IAAI,KAAK,YAAY,oBAAoB,EAAE,CAAC;YAC1C,OAAO,CAAC,KAAK,CAAC,iBAAiB,KAAK,CAAC,IAAI,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;YAC/D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;QAClB,CAAC;QACD,MAAM,KAAK,CAAC;IACd,CAAC;AACH,CAAC,CAAC","sourcesContent":["// `qpq script:build <dir> [--out <dir>] [--source-map]` — bundle a user-script project\n// into one main.js that askUserScriptExecute can load from a drive. `--source-map`\n// embeds the map in main.js; no separate .map file is ever written.\nimport { buildUserScript, checkUserScriptOutput, UserScriptBuildError } from '@qpqjs/user-script';\n\nimport path from 'path';\n\nimport { getArgValue, getPositionalArgs, hasArgFlag } from '../lib/args';\n\nexport const scriptBuildCommand = async (argv: string[]): Promise<void> => {\n  const [projectDir] = getPositionalArgs(argv, ['--out']);\n  if (!projectDir) {\n    console.error('Usage: qpq script:build <dir> [--out <dir>] [--source-map]');\n    process.exit(1);\n  }\n\n  const outDir = getArgValue(argv, '--out') ?? path.join(projectDir, 'dist');\n\n  try {\n    const result = await buildUserScript({ projectDir, outDir, sourceMap: hasArgFlag(argv, '--source-map') });\n    // A developer's own build is checked in this process; a platform build asks the sandbox.\n    const exports = checkUserScriptOutput(result.entryPath);\n    console.log(`script:build: wrote ${result.entryPath}`);\n    console.log(`  exports: ${exports.join(', ')}`);\n  } catch (error) {\n    if (error instanceof UserScriptBuildError) {\n      console.error(`script:build: ${error.code}: ${error.message}`);\n      process.exit(1);\n    }\n    throw error;\n  }\n};\n"]}

package/lib/esm/commands/scriptBuilderLayer.d.ts

@@ -0,0 +1 @@
+export declare const scriptBuilderLayerCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/scriptBuilderLayer.js

@@ -0,0 +1,34 @@
+// `qpq script:builder-layer [--arch arm64|x86_64]` — produce the lambda layer that gives
+// a service rspack, for services that registered defineUserScriptBuilder. The directory
+// is the one getUserScriptBuilderApiLayer points at, so nothing is told a path. Run from
+// the app's qpq:predeploy hook, which go:docker fires before the workspace is built, so
+// this command deliberately loads no service config (that would import unbuilt packages)
+// and takes the lambda architecture as a flag instead.
+import { JavascriptRuntimeArchitecture } from '@qpqjs/core';
+import { getUserScriptBuilderLayerDir } from '@qpqjs/user-script';
+import { getArgValue } from '../lib/args';
+import { buildUserScriptBuilderLayer } from '../lib/userScriptBuilderLayer';
+const ARCH_FLAG = '--arch';
+const DEFAULT_ARCHITECTURE = JavascriptRuntimeArchitecture.Arm64;
+/* eslint-disable @typescript-eslint/no-require-imports */
+// The rspack the CLI itself resolves is the one the dev server builds with; the layer
+// pins the same version so a script builds identically on both runtimes.
+const getRspackVersion = () => require('@rspack/core/package.json').version;
+const parseArchitecture = (argv) => {
+    const requested = getArgValue(argv, ARCH_FLAG) ?? DEFAULT_ARCHITECTURE;
+    const known = Object.values(JavascriptRuntimeArchitecture);
+    if (!known.includes(requested)) {
+        console.error(`script:builder-layer: unknown ${ARCH_FLAG} [${requested}]; expected one of ${known.join(', ')}`);
+        process.exit(1);
+    }
+    return requested;
+};
+export const scriptBuilderLayerCommand = async (argv) => {
+    const architecture = parseArchitecture(argv);
+    const rspackVersion = getRspackVersion();
+    const outDir = getUserScriptBuilderLayerDir();
+    console.log(`script:builder-layer: installing @rspack/core@${rspackVersion} for linux ${architecture} into ${outDir}`);
+    const nodeDir = buildUserScriptBuilderLayer({ outDir, architecture, rspackVersion });
+    console.log(`script:builder-layer: wrote ${nodeDir}`);
+};
+//# sourceMappingURL=scriptBuilderLayer.js.map

package/lib/esm/commands/scriptBuilderLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptBuilderLayer.js","sourceRoot":"","sources":["../../../src/commands/scriptBuilderLayer.ts"],"names":[],"mappings":"AAAA,yFAAyF;AACzF,wFAAwF;AACxF,yFAAyF;AACzF,wFAAwF;AACxF,yFAAyF;AACzF,uDAAuD;AACvD,OAAO,EAAE,6BAA6B,EAAE,MAAM,aAAa,CAAC;AAC5D,OAAO,EAAE,4BAA4B,EAAE,MAAM,oBAAoB,CAAC;AAElE,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAC1C,OAAO,EAAE,2BAA2B,EAAE,MAAM,+BAA+B,CAAC;AAE5E,MAAM,SAAS,GAAG,QAAQ,CAAC;AAC3B,MAAM,oBAAoB,GAAG,6BAA6B,CAAC,KAAK,CAAC;AAEjE,0DAA0D;AAC1D,sFAAsF;AACtF,yEAAyE;AACzE,MAAM,gBAAgB,GAAG,GAAW,EAAE,CAAC,OAAO,CAAC,2BAA2B,CAAC,CAAC,OAAiB,CAAC;AAE9F,MAAM,iBAAiB,GAAG,CAAC,IAAc,EAAiC,EAAE;IAC1E,MAAM,SAAS,GAAG,WAAW,CAAC,IAAI,EAAE,SAAS,CAAC,IAAI,oBAAoB,CAAC;IACvE,MAAM,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC,6BAA6B,CAAC,CAAC;IAC3D,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,SAA0C,CAAC,EAAE,CAAC;QAChE,OAAO,CAAC,KAAK,CAAC,iCAAiC,SAAS,KAAK,SAAS,sBAAsB,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QAChH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IACD,OAAO,SAA0C,CAAC;AACpD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,yBAAyB,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAC/E,MAAM,YAAY,GAAG,iBAAiB,CAAC,IAAI,CAAC,CAAC;IAC7C,MAAM,aAAa,GAAG,gBAAgB,EAAE,CAAC;IACzC,MAAM,MAAM,GAAG,4BAA4B,EAAE,CAAC;IAE9C,OAAO,CAAC,GAAG,CAAC,iDAAiD,aAAa,cAAc,YAAY,SAAS,MAAM,EAAE,CAAC,CAAC;IACvH,MAAM,OAAO,GAAG,2BAA2B,CAAC,EAAE,MAAM,EAAE,YAAY,EAAE,aAAa,EAAE,CAAC,CAAC;IACrF,OAAO,CAAC,GAAG,CAAC,+BAA+B,OAAO,EAAE,CAAC,CAAC;AACxD,CAAC,CAAC","sourcesContent":["// `qpq script:builder-layer [--arch arm64|x86_64]` — produce the lambda layer that gives\n// a service rspack, for services that registered defineUserScriptBuilder. The directory\n// is the one getUserScriptBuilderApiLayer points at, so nothing is told a path. Run from\n// the app's qpq:predeploy hook, which go:docker fires before the workspace is built, so\n// this command deliberately loads no service config (that would import unbuilt packages)\n// and takes the lambda architecture as a flag instead.\nimport { JavascriptRuntimeArchitecture } from '@qpqjs/core';\nimport { getUserScriptBuilderLayerDir } from '@qpqjs/user-script';\n\nimport { getArgValue } from '../lib/args';\nimport { buildUserScriptBuilderLayer } from '../lib/userScriptBuilderLayer';\n\nconst ARCH_FLAG = '--arch';\nconst DEFAULT_ARCHITECTURE = JavascriptRuntimeArchitecture.Arm64;\n\n/* eslint-disable @typescript-eslint/no-require-imports */\n// The rspack the CLI itself resolves is the one the dev server builds with; the layer\n// pins the same version so a script builds identically on both runtimes.\nconst getRspackVersion = (): string => require('@rspack/core/package.json').version as string;\n\nconst parseArchitecture = (argv: string[]): JavascriptRuntimeArchitecture => {\n  const requested = getArgValue(argv, ARCH_FLAG) ?? DEFAULT_ARCHITECTURE;\n  const known = Object.values(JavascriptRuntimeArchitecture);\n  if (!known.includes(requested as JavascriptRuntimeArchitecture)) {\n    console.error(`script:builder-layer: unknown ${ARCH_FLAG} [${requested}]; expected one of ${known.join(', ')}`);\n    process.exit(1);\n  }\n  return requested as JavascriptRuntimeArchitecture;\n};\n\nexport const scriptBuilderLayerCommand = async (argv: string[]): Promise<void> => {\n  const architecture = parseArchitecture(argv);\n  const rspackVersion = getRspackVersion();\n  const outDir = getUserScriptBuilderLayerDir();\n\n  console.log(`script:builder-layer: installing @rspack/core@${rspackVersion} for linux ${architecture} into ${outDir}`);\n  const nodeDir = buildUserScriptBuilderLayer({ outDir, architecture, rspackVersion });\n  console.log(`script:builder-layer: wrote ${nodeDir}`);\n};\n"]}

package/lib/esm/commands/scriptNew.d.ts

@@ -0,0 +1 @@
+export declare const scriptNewCommand: (argv: string[]) => Promise<void>;

package/lib/esm/commands/scriptNew.js

@@ -0,0 +1,19 @@
+// `qpq script:new <dir>` — write the user-script template project into a new
+// directory. See templates/user-script/README.md for what a script is.
+import path from 'path';
+import { getPositionalArgs } from '../lib/args';
+import { createUserScriptProject } from '../lib/userScriptTemplate';
+export const scriptNewCommand = async (argv) => {
+    const [targetDir] = getPositionalArgs(argv, []);
+    if (!targetDir) {
+        console.error('Usage: qpq script:new <dir>');
+        process.exit(1);
+    }
+    const written = createUserScriptProject(targetDir);
+    console.log(`script:new: wrote ${written.length} files to ${path.resolve(targetDir)}`);
+    for (const file of written) {
+        console.log(`  ${file}`);
+    }
+    console.log(`Next: cd ${targetDir} && npm run build`);
+};
+//# sourceMappingURL=scriptNew.js.map

package/lib/esm/commands/scriptNew.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scriptNew.js","sourceRoot":"","sources":["../../../src/commands/scriptNew.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,uEAAuE;AACvE,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,aAAa,CAAC;AAChD,OAAO,EAAE,uBAAuB,EAAE,MAAM,2BAA2B,CAAC;AAEpE,MAAM,CAAC,MAAM,gBAAgB,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IACtE,MAAM,CAAC,SAAS,CAAC,GAAG,iBAAiB,CAAC,IAAI,EAAE,EAAE,CAAC,CAAC;IAChD,IAAI,CAAC,SAAS,EAAE,CAAC;QACf,OAAO,CAAC,KAAK,CAAC,6BAA6B,CAAC,CAAC;QAC7C,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,OAAO,GAAG,uBAAuB,CAAC,SAAS,CAAC,CAAC;IAEnD,OAAO,CAAC,GAAG,CAAC,qBAAqB,OAAO,CAAC,MAAM,aAAa,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,EAAE,CAAC,CAAC;IACvF,KAAK,MAAM,IAAI,IAAI,OAAO,EAAE,CAAC;QAC3B,OAAO,CAAC,GAAG,CAAC,KAAK,IAAI,EAAE,CAAC,CAAC;IAC3B,CAAC;IACD,OAAO,CAAC,GAAG,CAAC,YAAY,SAAS,mBAAmB,CAAC,CAAC;AACxD,CAAC,CAAC","sourcesContent":["// `qpq script:new <dir>` — write the user-script template project into a new\n// directory. See templates/user-script/README.md for what a script is.\nimport path from 'path';\n\nimport { getPositionalArgs } from '../lib/args';\nimport { createUserScriptProject } from '../lib/userScriptTemplate';\n\nexport const scriptNewCommand = async (argv: string[]): Promise<void> => {\n  const [targetDir] = getPositionalArgs(argv, []);\n  if (!targetDir) {\n    console.error('Usage: qpq script:new <dir>');\n    process.exit(1);\n  }\n\n  const written = createUserScriptProject(targetDir);\n\n  console.log(`script:new: wrote ${written.length} files to ${path.resolve(targetDir)}`);\n  for (const file of written) {\n    console.log(`  ${file}`);\n  }\n  console.log(`Next: cd ${targetDir} && npm run build`);\n};\n"]}

package/lib/esm/commands/setup.d.ts

@@ -0,0 +1 @@
+export declare const setupCommand: (argv: string[]) => Promise<void>;