@qpqjs/cli 0.0.0-stage → 0.2.1

package/lib/esm/platforms/docker/getImageName.d.ts

@@ -0,0 +1,6 @@
+import { ParsedDockerPlatformSettings } from './getDockerPlatformSettings';
+/**
+ * `[<registry>/]qpq-<application>:<tag>`. Named by the deployment's application, not the app
+ * folder, so two products built from one codebase get separate images and data volumes.
+ */
+export declare const getImageName: (applicationName: string, settings: ParsedDockerPlatformSettings) => string;

package/lib/esm/platforms/docker/getImageName.js

@@ -0,0 +1,6 @@
+/**
+ * `[<registry>/]qpq-<application>:<tag>`. Named by the deployment's application, not the app
+ * folder, so two products built from one codebase get separate images and data volumes.
+ */
+export const getImageName = (applicationName, settings) => `${settings.registry ? `${settings.registry}/` : ''}qpq-${applicationName}:${settings.tag}`;
+//# sourceMappingURL=getImageName.js.map

package/lib/esm/platforms/docker/getImageName.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getImageName.js","sourceRoot":"","sources":["../../../../src/platforms/docker/getImageName.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,eAAuB,EAAE,QAAsC,EAAU,EAAE,CACtG,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,GAAG,QAAQ,CAAC,QAAQ,GAAG,CAAC,CAAC,CAAC,EAAE,OAAO,eAAe,IAAI,QAAQ,CAAC,GAAG,EAAE,CAAC","sourcesContent":["import { ParsedDockerPlatformSettings } from './getDockerPlatformSettings';\n\n/**\n * `[<registry>/]qpq-<application>:<tag>`. Named by the deployment's application, not the app\n * folder, so two products built from one codebase get separate images and data volumes.\n */\nexport const getImageName = (applicationName: string, settings: ParsedDockerPlatformSettings): string =>\n  `${settings.registry ? `${settings.registry}/` : ''}qpq-${applicationName}:${settings.tag}`;\n"]}

package/lib/esm/platforms/docker/go.d.ts

@@ -0,0 +1,2 @@
+import { DeployPlan } from '../../lib/deployPrompts';
+export declare const dockerGo: (appName: string, plan: DeployPlan) => Promise<void>;

package/lib/esm/platforms/docker/go.js

@@ -0,0 +1,242 @@
+// Docker platform deploy (`qpq go` with platform 'docker') — proof-of-concept
+// self-hosting: bakes the QPQ dev server (a full local platform emulation)
+// plus every service of the app and its pre-built views into one docker image.
+//
+//   1. Build workspace packages, then the dev-server bundle (all services).
+//   2. Build every views microfrontend with a same-origin module-federation
+//      remote base (/<views subdomain>/<svc>), mirroring the AWS layout.
+//   3. Assemble an image context under dist/qpq/docker-image/<app>/ — server
+//      bundle, web root (every web entry, placed by its port or its domain),
+//      a workspaces-stripped package.json for runtime deps, and the
+//      locally-built quidproquo packages as a vendor overlay.
+//   4. docker build (buildx with a push when the deployment names a registry or
+//      a target platform), write a docker-compose.yml, print how to run it.
+//
+// Not production-grade (single process, sqlite KVS, in-memory queues) —
+// it's the whole product on one box with one command.
+import { getQpqAppDeployment } from '@qpqjs/config-aws';
+import { isQpqPackageName, QpqDeployEnvVar } from '@qpqjs/core';
+import { getAppServiceQpqConfigs, getDevServerRspackConfig, listInstalledQpqPackageNames, runRspack } from '@qpqjs/deploy-rspack';
+import { getWebEntryDir, getWebEntryPlacements } from '@qpqjs/dev-server';
+import { FEDERATED_VIEWS_SUBDOMAIN } from '@qpqjs/webserver';
+import fs from 'fs';
+import path from 'path';
+import { writeDevServerEntry, writeUserScriptChildEntry } from '../../lib/devServerEntry';
+import { readDevServerPorts } from '../../lib/devServerPorts';
+import { getRoot, getServiceNamesWithViews } from '../../lib/discovery';
+import { getDefaultHookJobs } from '../../lib/getDefaultHookJobs';
+import { runAppHook, runHookForAppPackages } from '../../lib/hooks';
+import { getOwnPackageRoot } from '../../lib/packageRoot';
+import { runCommand } from '../../lib/runCommand';
+import { assertNoFailures } from '../../lib/runTasks';
+import { logTimeEnd, logTimeStart } from '../../lib/timing';
+import { bundleViews, getViewsDistDir } from '../../lib/views';
+import { clearWebAddressingEnv, setWebAddressingEnv } from '../../lib/webAddressingEnv';
+import { getContainerPorts } from './getContainerPorts';
+import { getDockerPlatformSettings } from './getDockerPlatformSettings';
+import { getImageName } from './getImageName';
+import { resolvePortMappings } from './resolvePortMappings';
+import { writeComposeFile } from './writeComposeFile';
+const getImageContextDir = (root, appName) => path.join(root, 'dist', 'qpq', 'docker-image', appName);
+// Every web entry's files go where the runtime looks for them. The federated views entry
+// is assembled from every service's views build (one folder per service, as on AWS);
+// anything else is its own buildPath. A missing build fails here rather than serving an
+// empty site later.
+const copyWebEntryContent = (appName, contextDir, entry, viewServices) => {
+    const label = `${entry.service}/${entry.entryName}`;
+    const targetDir = getWebEntryDir(path.join(contextDir, 'web'), entry);
+    if (entry.webEntry.domain.subDomainName === FEDERATED_VIEWS_SUBDOMAIN) {
+        for (const serviceName of viewServices) {
+            fs.cpSync(getViewsDistDir(appName, serviceName), path.join(targetDir, serviceName), { recursive: true });
+        }
+        return;
+    }
+    // A standalone host entry serves its own service's views build, as on AWS.
+    if (entry.webEntry.storageDrive.syncServiceViews) {
+        fs.cpSync(getViewsDistDir(appName, entry.service), targetDir, { recursive: true });
+        return;
+    }
+    if (!entry.webEntry.buildPath) {
+        throw new Error(`Web entry ${label} has no buildPath, so there is nothing to serve`);
+    }
+    const buildDir = path.resolve(entry.configRoot, entry.webEntry.buildPath);
+    if (!fs.existsSync(path.join(buildDir, entry.webEntry.indexRoot))) {
+        throw new Error(`Web entry ${label} has no ${entry.webEntry.indexRoot} under ${buildDir}; build it before qpq go`);
+    }
+    fs.cpSync(buildDir, targetDir, { recursive: true });
+};
+// Plain `docker build` into the local store unless the deployment asks for a registry or a
+// target platform, which need buildx: `--push` sends a cross-platform image straight to the
+// registry, `--load` keeps a same-machine one local.
+const buildImage = async (imageName, contextDir, settings) => {
+    if (!settings.registry && !settings.arch) {
+        await runCommand('docker', ['build', '-t', imageName, contextDir]);
+        return;
+    }
+    const platformArgs = settings.arch ? ['--platform', settings.arch] : [];
+    await runCommand('docker', ['buildx', 'build', ...platformArgs, '-t', imageName, settings.registry ? '--push' : '--load', contextDir]);
+};
+// The Dockerfile is shared; only its EXPOSE line depends on the app.
+const writeDockerfile = (contextDir, containerPorts) => {
+    const template = fs.readFileSync(path.join(getOwnPackageRoot(), 'docker', 'dev-server', 'Dockerfile'), 'utf8');
+    const dockerfile = template.replace(/^EXPOSE .*$/m, `EXPOSE ${containerPorts.join(' ')}`);
+    fs.writeFileSync(path.join(contextDir, 'Dockerfile'), dockerfile);
+};
+// The consumer root package.json, stripped to what the image's npm install
+// needs: runtime dependencies (+ overrides). Workspaces/scripts/devDeps are
+// host-only concerns — the workspace packages themselves are bundled into the
+// server bundle from source.
+//
+// quidproquo deps declared as file: refs (a consumer living beside the qpq
+// monorepo) point outside the image context, where npm install would leave
+// dangling symlinks — rewrite them to the vendored copies inside the context.
+const writeImagePackageJson = (root, contextDir) => {
+    const rootPackageJson = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));
+    const dependencies = { ...(rootPackageJson.dependencies ?? {}) };
+    for (const [name, version] of Object.entries(dependencies)) {
+        if (isQpqPackageName(name) && version.startsWith('file:')) {
+            dependencies[name] = `file:./vendor/${name}`;
+        }
+    }
+    const imagePackageJson = {
+        name: `${rootPackageJson.name}-qpq-docker`,
+        version: rootPackageJson.version ?? '0.0.0',
+        private: true,
+        dependencies,
+        overrides: rootPackageJson.overrides,
+    };
+    fs.writeFileSync(path.join(contextDir, 'package.json'), JSON.stringify(imagePackageJson, null, 2) + '\n');
+};
+// Copy the locally-built quidproquo packages (which may be npm-linked
+// checkouts newer than the registry) into vendor/ so the image runs the same
+// qpq code the bundle was built against. Follows the node_modules symlinks;
+// lib/config only — no node_modules, no src.
+const vendorQuidproquoPackages = (root, contextDir) => {
+    const nodeModules = path.join(root, 'node_modules');
+    const vendorDir = path.join(contextDir, 'vendor');
+    let vendored = 0;
+    for (const name of listInstalledQpqPackageNames(nodeModules)) {
+        const packageDir = fs.realpathSync(path.join(nodeModules, name));
+        const targetDir = path.join(vendorDir, name);
+        fs.mkdirSync(targetDir, { recursive: true });
+        fs.copyFileSync(path.join(packageDir, 'package.json'), path.join(targetDir, 'package.json'));
+        for (const sub of ['lib', 'config']) {
+            const subDir = path.join(packageDir, sub);
+            if (fs.existsSync(subDir)) {
+                fs.cpSync(subDir, path.join(targetDir, sub), { recursive: true, dereference: true });
+            }
+        }
+        vendored += 1;
+    }
+    return vendored;
+};
+export const dockerGo = async (appName, plan) => {
+    if (plan.kind === 'cancelled') {
+        return;
+    }
+    if (plan.kind === 'account' || plan.kind === 'bootstrap') {
+        console.log(`Nothing to do — the docker platform has no ${plan.kind} stacks.`);
+        return;
+    }
+    const root = getRoot();
+    const deploymentName = process.env[QpqDeployEnvVar.deployName];
+    const dockerSettings = getDockerPlatformSettings(deploymentName, getQpqAppDeployment(root, appName, deploymentName));
+    const applicationName = process.env[QpqDeployEnvVar.applicationName];
+    const imageName = getImageName(applicationName, dockerSettings);
+    const containerName = `qpq-${applicationName}`;
+    const volumeName = `${containerName}-data`;
+    // The dev server hosts every service of the app, so per-service/stack
+    // selections don't apply — the image is always the whole app.
+    console.log(`\n\nBuilding docker image [${imageName}] — the whole app deploys as one image\n\n`);
+    logTimeStart('totalTime');
+    await runAppHook(appName, 'predeploy');
+    // Workspace packages resolve through their built dist/ (package.json main),
+    // so bundles would ship stale code unless every lib is tsc'd first.
+    console.log('Building workspace packages');
+    assertNoFailures('Workspace build', await runHookForAppPackages('build', appName, getDefaultHookJobs()));
+    // ---- Server bundle: the dev server + every service, one main.js ----
+    console.log('Bundling server (dev server + all services)');
+    const qpqConfigs = getAppServiceQpqConfigs(root, appName);
+    // Resolved before anything slow runs, so a bad port or domain fails the build up front.
+    const devServerPorts = readDevServerPorts(appName);
+    const { hosts: webEntryHosts, routes: webEntryRoutes } = getWebEntryPlacements(qpqConfigs, Object.values(devServerPorts));
+    const containerPorts = getContainerPorts(devServerPorts, webEntryHosts);
+    const portMappings = resolvePortMappings(deploymentName, dockerSettings, devServerPorts.api, containerPorts);
+    const mapHostPort = (containerPort) => portMappings.find((mapping) => mapping.container === containerPort)?.host ?? containerPort;
+    // Nothing deploys into the container, so the image runs its own pending migrations on start.
+    const entry = writeDevServerEntry(root, appName, 'migrate-then-serve');
+    const userScriptChildEntry = writeUserScriptChildEntry(root);
+    // The image installs its own node_modules next to the bundle, so externals
+    // must stay bare; host-resolved absolute paths do not exist in the container.
+    await runRspack(getDevServerRspackConfig({ root, entry, userScriptChildEntry, qpqConfigs, portableExternals: true }));
+    // ---- Views: production builds with same-origin federation remotes ----
+    // The browser reaches everything on the page's own host, on the HOST side of the port
+    // mappings; an unmapped port stays as is (nothing outside the container can reach it anyway).
+    setWebAddressingEnv(qpqConfigs, { api: devServerPorts.api, webSocket: devServerPorts.webSocket, mapHostPort });
+    process.env.QPQ_VIEWS_REMOTE_BASE = `/${FEDERATED_VIEWS_SUBDOMAIN}`;
+    const viewServices = getServiceNamesWithViews(appName);
+    for (const serviceName of viewServices) {
+        console.log(`Bundling views: [${serviceName}]`);
+        await bundleViews(appName, serviceName);
+    }
+    delete process.env.QPQ_VIEWS_REMOTE_BASE;
+    clearWebAddressingEnv();
+    // ---- Assemble the image context ----
+    console.log('Assembling image context');
+    const contextDir = getImageContextDir(root, appName);
+    fs.rmSync(contextDir, { recursive: true, force: true });
+    fs.mkdirSync(contextDir, { recursive: true });
+    writeDockerfile(contextDir, containerPorts);
+    writeImagePackageJson(root, contextDir);
+    const vendored = vendorQuidproquoPackages(root, contextDir);
+    console.log(`Vendored ${vendored} quidproquo packages`);
+    fs.cpSync(path.join(root, 'dist', 'qpq', 'dev-server'), path.join(contextDir, 'server'), { recursive: true });
+    for (const entry of [...webEntryRoutes, ...webEntryHosts]) {
+        copyWebEntryContent(appName, contextDir, entry, viewServices);
+    }
+    const composePath = writeComposeFile({
+        contextDir,
+        imageName,
+        serviceName: containerName,
+        volumeName,
+        portMappings,
+        dataPath: dockerSettings.dataPath ?? null,
+        mounts: dockerSettings.mounts ?? [],
+        publicHost: dockerSettings.publicHost ?? null,
+        publicFileStoragePort: mapHostPort(devServerPorts.fileStorage),
+    });
+    // ---- Build the image ----
+    console.log(`Building docker image${dockerSettings.arch ? ` for ${dockerSettings.arch}` : ''}${dockerSettings.registry ? `, pushing to ${dockerSettings.registry}` : ''}`);
+    await buildImage(imageName, contextDir, dockerSettings);
+    logTimeEnd('totalTime');
+    const hostUrl = (containerPort) => {
+        const hostPort = portMappings.find((mapping) => mapping.container === containerPort)?.host;
+        return hostPort === undefined ? `(container port ${containerPort} is not mapped)` : `http://localhost${hostPort === 80 ? '' : `:${hostPort}`}`;
+    };
+    const siteUrl = hostUrl(devServerPorts.api);
+    const entryLines = [
+        ...webEntryRoutes.map((route) => `  ${route.service}/${route.entryName}: ${siteUrl}${route.path === '/' ? '' : route.path}`),
+        ...webEntryHosts.map((host) => `  ${host.service}/${host.entryName}: ${hostUrl(host.port)}`),
+    ].join('\n');
+    const where = dockerSettings.registry ? `pushed to [${imageName}]` : `[${imageName}] in the local docker store`;
+    const onHost = dockerSettings.registry
+        ? `On the host (Unraid: Compose Manager, or any docker host), copy the compose file there and run:`
+        : `Run it here:`;
+    console.log(`
+Done. The image is ${where}.
+
+${onHost}
+
+  docker compose -f ${composePath} up -d
+
+Then open ${siteUrl} (replace localhost with the host's address)
+${entryLines ? `\nWeb entries:\n${entryLines}\n` : ''}
+Ports come from the deployment's platformSettings.portMappings (${portMappings.map((m) => `${m.host}:${m.container}`).join(', ')})
+and are baked into the frontend, so a host must map the same ones. App state lives in ${dockerSettings.dataPath ?? `the ${volumeName} volume`}.${dockerSettings.mounts?.length
+        ? `\nAlso mounted: ${dockerSettings.mounts.map((mount) => `${mount.host} at ${mount.container}${mount.readOnly ? ' (read-only)' : ''}`).join(', ')}.`
+        : ''}${dockerSettings.publicHost
+        ? ''
+        : `\nSecure file urls point at localhost; set platformSettings.publicHost to the address browsers use for this host.`}
+`);
+};
+//# sourceMappingURL=go.js.map

package/lib/esm/platforms/docker/go.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"go.js","sourceRoot":"","sources":["../../../../src/platforms/docker/go.ts"],"names":[],"mappings":"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","sourcesContent":["// Docker platform deploy (`qpq go` with platform 'docker') — proof-of-concept\n// self-hosting: bakes the QPQ dev server (a full local platform emulation)\n// plus every service of the app and its pre-built views into one docker image.\n//\n//   1. Build workspace packages, then the dev-server bundle (all services).\n//   2. Build every views microfrontend with a same-origin module-federation\n//      remote base (/<views subdomain>/<svc>), mirroring the AWS layout.\n//   3. Assemble an image context under dist/qpq/docker-image/<app>/ — server\n//      bundle, web root (every web entry, placed by its port or its domain),\n//      a workspaces-stripped package.json for runtime deps, and the\n//      locally-built quidproquo packages as a vendor overlay.\n//   4. docker build (buildx with a push when the deployment names a registry or\n//      a target platform), write a docker-compose.yml, print how to run it.\n//\n// Not production-grade (single process, sqlite KVS, in-memory queues) —\n// it's the whole product on one box with one command.\nimport { getQpqAppDeployment } from '@qpqjs/config-aws';\nimport { isQpqPackageName, QpqDeployEnvVar } from '@qpqjs/core';\nimport { getAppServiceQpqConfigs, getDevServerRspackConfig, listInstalledQpqPackageNames, runRspack } from '@qpqjs/deploy-rspack';\nimport { getWebEntryDir, getWebEntryPlacements, WebEntryHost, WebEntryRoute } from '@qpqjs/dev-server';\nimport { FEDERATED_VIEWS_SUBDOMAIN } from '@qpqjs/webserver';\n\nimport fs from 'fs';\nimport path from 'path';\n\nimport { DeployPlan } from '../../lib/deployPrompts';\nimport { writeDevServerEntry, writeUserScriptChildEntry } from '../../lib/devServerEntry';\nimport { readDevServerPorts } from '../../lib/devServerPorts';\nimport { getRoot, getServiceNamesWithViews } from '../../lib/discovery';\nimport { getDefaultHookJobs } from '../../lib/getDefaultHookJobs';\nimport { runAppHook, runHookForAppPackages } from '../../lib/hooks';\nimport { getOwnPackageRoot } from '../../lib/packageRoot';\nimport { runCommand } from '../../lib/runCommand';\nimport { assertNoFailures } from '../../lib/runTasks';\nimport { logTimeEnd, logTimeStart } from '../../lib/timing';\nimport { bundleViews, getViewsDistDir } from '../../lib/views';\nimport { clearWebAddressingEnv, setWebAddressingEnv } from '../../lib/webAddressingEnv';\nimport { getContainerPorts } from './getContainerPorts';\nimport { getDockerPlatformSettings, ParsedDockerPlatformSettings } from './getDockerPlatformSettings';\nimport { getImageName } from './getImageName';\nimport { resolvePortMappings } from './resolvePortMappings';\nimport { writeComposeFile } from './writeComposeFile';\n\nconst getImageContextDir = (root: string, appName: string): string => path.join(root, 'dist', 'qpq', 'docker-image', appName);\n\n// Every web entry's files go where the runtime looks for them. The federated views entry\n// is assembled from every service's views build (one folder per service, as on AWS);\n// anything else is its own buildPath. A missing build fails here rather than serving an\n// empty site later.\nconst copyWebEntryContent = (appName: string, contextDir: string, entry: WebEntryHost | WebEntryRoute, viewServices: string[]): void => {\n  const label = `${entry.service}/${entry.entryName}`;\n  const targetDir = getWebEntryDir(path.join(contextDir, 'web'), entry);\n\n  if (entry.webEntry.domain.subDomainName === FEDERATED_VIEWS_SUBDOMAIN) {\n    for (const serviceName of viewServices) {\n      fs.cpSync(getViewsDistDir(appName, serviceName), path.join(targetDir, serviceName), { recursive: true });\n    }\n    return;\n  }\n\n  // A standalone host entry serves its own service's views build, as on AWS.\n  if (entry.webEntry.storageDrive.syncServiceViews) {\n    fs.cpSync(getViewsDistDir(appName, entry.service), targetDir, { recursive: true });\n    return;\n  }\n\n  if (!entry.webEntry.buildPath) {\n    throw new Error(`Web entry ${label} has no buildPath, so there is nothing to serve`);\n  }\n  const buildDir = path.resolve(entry.configRoot, entry.webEntry.buildPath);\n  if (!fs.existsSync(path.join(buildDir, entry.webEntry.indexRoot))) {\n    throw new Error(`Web entry ${label} has no ${entry.webEntry.indexRoot} under ${buildDir}; build it before qpq go`);\n  }\n  fs.cpSync(buildDir, targetDir, { recursive: true });\n};\n\n// Plain `docker build` into the local store unless the deployment asks for a registry or a\n// target platform, which need buildx: `--push` sends a cross-platform image straight to the\n// registry, `--load` keeps a same-machine one local.\nconst buildImage = async (imageName: string, contextDir: string, settings: ParsedDockerPlatformSettings): Promise<void> => {\n  if (!settings.registry && !settings.arch) {\n    await runCommand('docker', ['build', '-t', imageName, contextDir]);\n    return;\n  }\n\n  const platformArgs = settings.arch ? ['--platform', settings.arch] : [];\n  await runCommand('docker', ['buildx', 'build', ...platformArgs, '-t', imageName, settings.registry ? '--push' : '--load', contextDir]);\n};\n\n// The Dockerfile is shared; only its EXPOSE line depends on the app.\nconst writeDockerfile = (contextDir: string, containerPorts: number[]): void => {\n  const template = fs.readFileSync(path.join(getOwnPackageRoot(), 'docker', 'dev-server', 'Dockerfile'), 'utf8');\n  const dockerfile = template.replace(/^EXPOSE .*$/m, `EXPOSE ${containerPorts.join(' ')}`);\n  fs.writeFileSync(path.join(contextDir, 'Dockerfile'), dockerfile);\n};\n\n// The consumer root package.json, stripped to what the image's npm install\n// needs: runtime dependencies (+ overrides). Workspaces/scripts/devDeps are\n// host-only concerns — the workspace packages themselves are bundled into the\n// server bundle from source.\n//\n// quidproquo deps declared as file: refs (a consumer living beside the qpq\n// monorepo) point outside the image context, where npm install would leave\n// dangling symlinks — rewrite them to the vendored copies inside the context.\nconst writeImagePackageJson = (root: string, contextDir: string): void => {\n  const rootPackageJson = JSON.parse(fs.readFileSync(path.join(root, 'package.json'), 'utf8'));\n\n  const dependencies: Record<string, string> = { ...(rootPackageJson.dependencies ?? {}) };\n  for (const [name, version] of Object.entries(dependencies)) {\n    if (isQpqPackageName(name) && version.startsWith('file:')) {\n      dependencies[name] = `file:./vendor/${name}`;\n    }\n  }\n\n  const imagePackageJson = {\n    name: `${rootPackageJson.name}-qpq-docker`,\n    version: rootPackageJson.version ?? '0.0.0',\n    private: true,\n    dependencies,\n    overrides: rootPackageJson.overrides,\n  };\n\n  fs.writeFileSync(path.join(contextDir, 'package.json'), JSON.stringify(imagePackageJson, null, 2) + '\\n');\n};\n\n// Copy the locally-built quidproquo packages (which may be npm-linked\n// checkouts newer than the registry) into vendor/ so the image runs the same\n// qpq code the bundle was built against. Follows the node_modules symlinks;\n// lib/config only — no node_modules, no src.\nconst vendorQuidproquoPackages = (root: string, contextDir: string): number => {\n  const nodeModules = path.join(root, 'node_modules');\n  const vendorDir = path.join(contextDir, 'vendor');\n  let vendored = 0;\n\n  for (const name of listInstalledQpqPackageNames(nodeModules)) {\n    const packageDir = fs.realpathSync(path.join(nodeModules, name));\n    const targetDir = path.join(vendorDir, name);\n    fs.mkdirSync(targetDir, { recursive: true });\n\n    fs.copyFileSync(path.join(packageDir, 'package.json'), path.join(targetDir, 'package.json'));\n    for (const sub of ['lib', 'config']) {\n      const subDir = path.join(packageDir, sub);\n      if (fs.existsSync(subDir)) {\n        fs.cpSync(subDir, path.join(targetDir, sub), { recursive: true, dereference: true });\n      }\n    }\n    vendored += 1;\n  }\n\n  return vendored;\n};\n\nexport const dockerGo = async (appName: string, plan: DeployPlan): Promise<void> => {\n  if (plan.kind === 'cancelled') {\n    return;\n  }\n\n  if (plan.kind === 'account' || plan.kind === 'bootstrap') {\n    console.log(`Nothing to do — the docker platform has no ${plan.kind} stacks.`);\n    return;\n  }\n\n  const root = getRoot();\n  const deploymentName = process.env[QpqDeployEnvVar.deployName]!;\n  const dockerSettings = getDockerPlatformSettings(deploymentName, getQpqAppDeployment(root, appName, deploymentName));\n\n  const applicationName = process.env[QpqDeployEnvVar.applicationName]!;\n  const imageName = getImageName(applicationName, dockerSettings);\n  const containerName = `qpq-${applicationName}`;\n  const volumeName = `${containerName}-data`;\n\n  // The dev server hosts every service of the app, so per-service/stack\n  // selections don't apply — the image is always the whole app.\n  console.log(`\\n\\nBuilding docker image [${imageName}] — the whole app deploys as one image\\n\\n`);\n\n  logTimeStart('totalTime');\n\n  await runAppHook(appName, 'predeploy');\n\n  // Workspace packages resolve through their built dist/ (package.json main),\n  // so bundles would ship stale code unless every lib is tsc'd first.\n  console.log('Building workspace packages');\n  assertNoFailures('Workspace build', await runHookForAppPackages('build', appName, getDefaultHookJobs()));\n\n  // ---- Server bundle: the dev server + every service, one main.js ----\n  console.log('Bundling server (dev server + all services)');\n  const qpqConfigs = getAppServiceQpqConfigs(root, appName);\n\n  // Resolved before anything slow runs, so a bad port or domain fails the build up front.\n  const devServerPorts = readDevServerPorts(appName);\n  const { hosts: webEntryHosts, routes: webEntryRoutes } = getWebEntryPlacements(qpqConfigs, Object.values(devServerPorts));\n  const containerPorts = getContainerPorts(devServerPorts, webEntryHosts);\n  const portMappings = resolvePortMappings(deploymentName, dockerSettings, devServerPorts.api, containerPorts);\n  const mapHostPort = (containerPort: number): number => portMappings.find((mapping) => mapping.container === containerPort)?.host ?? containerPort;\n\n  // Nothing deploys into the container, so the image runs its own pending migrations on start.\n  const entry = writeDevServerEntry(root, appName, 'migrate-then-serve');\n  const userScriptChildEntry = writeUserScriptChildEntry(root);\n  // The image installs its own node_modules next to the bundle, so externals\n  // must stay bare; host-resolved absolute paths do not exist in the container.\n  await runRspack(getDevServerRspackConfig({ root, entry, userScriptChildEntry, qpqConfigs, portableExternals: true }));\n\n  // ---- Views: production builds with same-origin federation remotes ----\n  // The browser reaches everything on the page's own host, on the HOST side of the port\n  // mappings; an unmapped port stays as is (nothing outside the container can reach it anyway).\n  setWebAddressingEnv(qpqConfigs, { api: devServerPorts.api, webSocket: devServerPorts.webSocket, mapHostPort });\n  process.env.QPQ_VIEWS_REMOTE_BASE = `/${FEDERATED_VIEWS_SUBDOMAIN}`;\n  const viewServices = getServiceNamesWithViews(appName);\n  for (const serviceName of viewServices) {\n    console.log(`Bundling views: [${serviceName}]`);\n    await bundleViews(appName, serviceName);\n  }\n  delete process.env.QPQ_VIEWS_REMOTE_BASE;\n  clearWebAddressingEnv();\n\n  // ---- Assemble the image context ----\n  console.log('Assembling image context');\n  const contextDir = getImageContextDir(root, appName);\n  fs.rmSync(contextDir, { recursive: true, force: true });\n  fs.mkdirSync(contextDir, { recursive: true });\n\n  writeDockerfile(contextDir, containerPorts);\n  writeImagePackageJson(root, contextDir);\n\n  const vendored = vendorQuidproquoPackages(root, contextDir);\n  console.log(`Vendored ${vendored} quidproquo packages`);\n\n  fs.cpSync(path.join(root, 'dist', 'qpq', 'dev-server'), path.join(contextDir, 'server'), { recursive: true });\n\n  for (const entry of [...webEntryRoutes, ...webEntryHosts]) {\n    copyWebEntryContent(appName, contextDir, entry, viewServices);\n  }\n\n  const composePath = writeComposeFile({\n    contextDir,\n    imageName,\n    serviceName: containerName,\n    volumeName,\n    portMappings,\n    dataPath: dockerSettings.dataPath ?? null,\n    mounts: dockerSettings.mounts ?? [],\n    publicHost: dockerSettings.publicHost ?? null,\n    publicFileStoragePort: mapHostPort(devServerPorts.fileStorage),\n  });\n\n  // ---- Build the image ----\n  console.log(\n    `Building docker image${dockerSettings.arch ? ` for ${dockerSettings.arch}` : ''}${dockerSettings.registry ? `, pushing to ${dockerSettings.registry}` : ''}`,\n  );\n  await buildImage(imageName, contextDir, dockerSettings);\n\n  logTimeEnd('totalTime');\n\n  const hostUrl = (containerPort: number): string => {\n    const hostPort = portMappings.find((mapping) => mapping.container === containerPort)?.host;\n    return hostPort === undefined ? `(container port ${containerPort} is not mapped)` : `http://localhost${hostPort === 80 ? '' : `:${hostPort}`}`;\n  };\n  const siteUrl = hostUrl(devServerPorts.api);\n  const entryLines = [\n    ...webEntryRoutes.map((route) => `  ${route.service}/${route.entryName}: ${siteUrl}${route.path === '/' ? '' : route.path}`),\n    ...webEntryHosts.map((host) => `  ${host.service}/${host.entryName}: ${hostUrl(host.port)}`),\n  ].join('\\n');\n  const where = dockerSettings.registry ? `pushed to [${imageName}]` : `[${imageName}] in the local docker store`;\n  const onHost = dockerSettings.registry\n    ? `On the host (Unraid: Compose Manager, or any docker host), copy the compose file there and run:`\n    : `Run it here:`;\n  console.log(`\nDone. The image is ${where}.\n\n${onHost}\n\n  docker compose -f ${composePath} up -d\n\nThen open ${siteUrl} (replace localhost with the host's address)\n${entryLines ? `\\nWeb entries:\\n${entryLines}\\n` : ''}\nPorts come from the deployment's platformSettings.portMappings (${portMappings.map((m) => `${m.host}:${m.container}`).join(', ')})\nand are baked into the frontend, so a host must map the same ones. App state lives in ${dockerSettings.dataPath ?? `the ${volumeName} volume`}.${\n    dockerSettings.mounts?.length\n      ? `\\nAlso mounted: ${dockerSettings.mounts.map((mount) => `${mount.host} at ${mount.container}${mount.readOnly ? ' (read-only)' : ''}`).join(', ')}.`\n      : ''\n  }${\n    dockerSettings.publicHost\n      ? ''\n      : `\\nSecure file urls point at localhost; set platformSettings.publicHost to the address browsers use for this host.`\n  }\n`);\n};\n"]}

package/lib/esm/platforms/docker/index.d.ts

@@ -0,0 +1,2 @@
+import { QpqPlatformDriver } from '../types';
+export declare const dockerPlatformDriver: QpqPlatformDriver;

package/lib/esm/platforms/docker/index.js

@@ -0,0 +1,31 @@
+import { BUILD_ONLY_FLAG, FROM_BUILD_FLAG } from '../../lib/goDockerMode';
+import { getDockerPlatformSettings } from './getDockerPlatformSettings';
+import { dockerGo } from './go';
+const publishNotSupported = async () => {
+    console.error('The docker platform has no federated code store — story code is baked into the image. Rebuild with qpq go instead.');
+    process.exit(1);
+};
+// A docker platform's deploy already is the containerised one, so `qpq go:docker`
+// (what a scaffolded app's `npm run deploy` runs) is the same build. The image is
+// the deploy, so there is no saved build to split across two runs.
+const dockerGoDocker = async (appName, plan, mode) => {
+    if (mode !== 'full') {
+        console.error(`The docker platform builds and deploys in one step; ${BUILD_ONLY_FLAG} and ${FROM_BUILD_FLAG} do not apply. Run qpq go:docker without them.`);
+        process.exit(1);
+    }
+    await dockerGo(appName, plan);
+};
+export const dockerPlatformDriver = {
+    // No identity to prime. Mappings are only parsed here; which container ports exist depends
+    // on the app's config, which is not loaded yet, so that check happens in the build.
+    prepareDeployment: (deploymentName, deployment) => {
+        getDockerPlatformSettings(deploymentName, deployment);
+    },
+    go: dockerGo,
+    goDocker: dockerGoDocker,
+    publish: publishNotSupported,
+    publishBuild: publishNotSupported,
+    publishUpload: publishNotSupported,
+    publishDeploy: publishNotSupported,
+};
+//# sourceMappingURL=index.js.map

package/lib/esm/platforms/docker/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/platforms/docker/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,eAAe,EAAE,eAAe,EAAgB,MAAM,wBAAwB,CAAC;AAExF,OAAO,EAAE,yBAAyB,EAAE,MAAM,6BAA6B,CAAC;AACxE,OAAO,EAAE,QAAQ,EAAE,MAAM,MAAM,CAAC;AAEhC,MAAM,mBAAmB,GAAG,KAAK,IAAmB,EAAE;IACpD,OAAO,CAAC,KAAK,CAAC,oHAAoH,CAAC,CAAC;IACpI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAC;AAEF,kFAAkF;AAClF,kFAAkF;AAClF,mEAAmE;AACnE,MAAM,cAAc,GAAG,KAAK,EAAE,OAAe,EAAE,IAAgB,EAAE,IAAkB,EAAiB,EAAE;IACpG,IAAI,IAAI,KAAK,MAAM,EAAE,CAAC;QACpB,OAAO,CAAC,KAAK,CACX,uDAAuD,eAAe,QAAQ,eAAe,gDAAgD,CAC9I,CAAC;QACF,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,MAAM,QAAQ,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AAChC,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,oBAAoB,GAAsB;IACrD,2FAA2F;IAC3F,oFAAoF;IACpF,iBAAiB,EAAE,CAAC,cAAc,EAAE,UAAU,EAAE,EAAE;QAChD,yBAAyB,CAAC,cAAc,EAAE,UAAU,CAAC,CAAC;IACxD,CAAC;IAED,EAAE,EAAE,QAAQ;IACZ,QAAQ,EAAE,cAAc;IAExB,OAAO,EAAE,mBAAmB;IAC5B,YAAY,EAAE,mBAAmB;IACjC,aAAa,EAAE,mBAAmB;IAClC,aAAa,EAAE,mBAAmB;CACnC,CAAC","sourcesContent":["import { DeployPlan } from '../../lib/deployPrompts';\nimport { BUILD_ONLY_FLAG, FROM_BUILD_FLAG, GoDockerMode } from '../../lib/goDockerMode';\nimport { QpqPlatformDriver } from '../types';\nimport { getDockerPlatformSettings } from './getDockerPlatformSettings';\nimport { dockerGo } from './go';\n\nconst publishNotSupported = async (): Promise<void> => {\n  console.error('The docker platform has no federated code store — story code is baked into the image. Rebuild with qpq go instead.');\n  process.exit(1);\n};\n\n// A docker platform's deploy already is the containerised one, so `qpq go:docker`\n// (what a scaffolded app's `npm run deploy` runs) is the same build. The image is\n// the deploy, so there is no saved build to split across two runs.\nconst dockerGoDocker = async (appName: string, plan: DeployPlan, mode: GoDockerMode): Promise<void> => {\n  if (mode !== 'full') {\n    console.error(\n      `The docker platform builds and deploys in one step; ${BUILD_ONLY_FLAG} and ${FROM_BUILD_FLAG} do not apply. Run qpq go:docker without them.`,\n    );\n    process.exit(1);\n  }\n\n  await dockerGo(appName, plan);\n};\n\nexport const dockerPlatformDriver: QpqPlatformDriver = {\n  // No identity to prime. Mappings are only parsed here; which container ports exist depends\n  // on the app's config, which is not loaded yet, so that check happens in the build.\n  prepareDeployment: (deploymentName, deployment) => {\n    getDockerPlatformSettings(deploymentName, deployment);\n  },\n\n  go: dockerGo,\n  goDocker: dockerGoDocker,\n\n  publish: publishNotSupported,\n  publishBuild: publishNotSupported,\n  publishUpload: publishNotSupported,\n  publishDeploy: publishNotSupported,\n};\n"]}

package/lib/esm/platforms/docker/parseMounts.d.ts

@@ -0,0 +1,7 @@
+export type Mount = {
+    host: string;
+    container: string;
+    readOnly: boolean;
+};
+/** Parses "host:container[:ro], ..." into mounts, throwing naming the first malformed item. */
+export declare const parseMounts: (value: string) => Mount[];

package/lib/esm/platforms/docker/parseMounts.js

@@ -0,0 +1,23 @@
+// host:container, both absolute, optionally ending :ro or :rw.
+const MOUNT_PATTERN = /^(\/[^:]*):(\/[^:]*?)(?::(ro|rw))?$/;
+// The image's own files live under /app (including the state directory), so a mount there would
+// hide them.
+const IMAGE_ROOT = '/app';
+const trimTrailingSlashes = (folder) => folder.replace(/\/+$/, '') || '/';
+/** Parses "host:container[:ro], ..." into mounts, throwing naming the first malformed item. */
+export const parseMounts = (value) => value
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean)
+    .map((item) => {
+    const match = MOUNT_PATTERN.exec(item);
+    if (!match) {
+        throw new Error(`Mount '${item}' must be host:container with both absolute, optionally ending :ro, e.g. /mnt/user/media:/media`);
+    }
+    const container = trimTrailingSlashes(match[2]);
+    if (container === IMAGE_ROOT || container.startsWith(`${IMAGE_ROOT}/`) || container === '/') {
+        throw new Error(`Mount '${item}' would cover the image's own files: mount it somewhere other than / or ${IMAGE_ROOT}`);
+    }
+    return { host: trimTrailingSlashes(match[1]), container, readOnly: match[3] === 'ro' };
+});
+//# sourceMappingURL=parseMounts.js.map

package/lib/esm/platforms/docker/parseMounts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parseMounts.js","sourceRoot":"","sources":["../../../../src/platforms/docker/parseMounts.ts"],"names":[],"mappings":"AAQA,+DAA+D;AAC/D,MAAM,aAAa,GAAG,qCAAqC,CAAC;AAE5D,gGAAgG;AAChG,aAAa;AACb,MAAM,UAAU,GAAG,MAAM,CAAC;AAE1B,MAAM,mBAAmB,GAAG,CAAC,MAAc,EAAU,EAAE,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,IAAI,GAAG,CAAC;AAE1F,+FAA+F;AAC/F,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,KAAa,EAAW,EAAE,CACpD,KAAK;KACF,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,MAAM,CAAC,OAAO,CAAC;KACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACZ,MAAM,KAAK,GAAG,aAAa,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACvC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,iGAAiG,CAAC,CAAC;IACnI,CAAC;IAED,MAAM,SAAS,GAAG,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;IAChD,IAAI,SAAS,KAAK,UAAU,IAAI,SAAS,CAAC,UAAU,CAAC,GAAG,UAAU,GAAG,CAAC,IAAI,SAAS,KAAK,GAAG,EAAE,CAAC;QAC5F,MAAM,IAAI,KAAK,CAAC,UAAU,IAAI,2EAA2E,UAAU,EAAE,CAAC,CAAC;IACzH,CAAC;IAED,OAAO,EAAE,IAAI,EAAE,mBAAmB,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,QAAQ,EAAE,KAAK,CAAC,CAAC,CAAC,KAAK,IAAI,EAAE,CAAC;AACzF,CAAC,CAAC,CAAC","sourcesContent":["export type Mount = {\n  // Absolute folder on the docker host, e.g. /mnt/user/media/downloads.\n  host: string;\n  // Where it appears inside the container.\n  container: string;\n  readOnly: boolean;\n};\n\n// host:container, both absolute, optionally ending :ro or :rw.\nconst MOUNT_PATTERN = /^(\\/[^:]*):(\\/[^:]*?)(?::(ro|rw))?$/;\n\n// The image's own files live under /app (including the state directory), so a mount there would\n// hide them.\nconst IMAGE_ROOT = '/app';\n\nconst trimTrailingSlashes = (folder: string): string => folder.replace(/\\/+$/, '') || '/';\n\n/** Parses \"host:container[:ro], ...\" into mounts, throwing naming the first malformed item. */\nexport const parseMounts = (value: string): Mount[] =>\n  value\n    .split(',')\n    .map((item) => item.trim())\n    .filter(Boolean)\n    .map((item) => {\n      const match = MOUNT_PATTERN.exec(item);\n      if (!match) {\n        throw new Error(`Mount '${item}' must be host:container with both absolute, optionally ending :ro, e.g. /mnt/user/media:/media`);\n      }\n\n      const container = trimTrailingSlashes(match[2]);\n      if (container === IMAGE_ROOT || container.startsWith(`${IMAGE_ROOT}/`) || container === '/') {\n        throw new Error(`Mount '${item}' would cover the image's own files: mount it somewhere other than / or ${IMAGE_ROOT}`);\n      }\n\n      return { host: trimTrailingSlashes(match[1]), container, readOnly: match[3] === 'ro' };\n    });\n"]}

package/lib/esm/platforms/docker/parsePortMappings.d.ts

@@ -0,0 +1,8 @@
+export type PortMapping = {
+    host: number;
+    container: number;
+};
+/** Parses "host:container, ..." into pairs, throwing naming the first malformed item. */
+export declare const parsePortMappings: (value: string) => PortMapping[];
+/** Throws when a mapping targets a port the image does not listen on. */
+export declare const assertContainerPorts: (mappings: PortMapping[], containerPorts: number[]) => void;

package/lib/esm/platforms/docker/parsePortMappings.js

@@ -0,0 +1,21 @@
+const PAIR_PATTERN = /^(\d{1,5}):(\d{1,5})$/;
+/** Parses "host:container, ..." into pairs, throwing naming the first malformed item. */
+export const parsePortMappings = (value) => value
+    .split(',')
+    .map((item) => item.trim())
+    .filter(Boolean)
+    .map((item) => {
+    const match = PAIR_PATTERN.exec(item);
+    if (!match) {
+        throw new Error(`Port mapping '${item}' must be host:container, e.g. 80:8080`);
+    }
+    return { host: Number(match[1]), container: Number(match[2]) };
+});
+/** Throws when a mapping targets a port the image does not listen on. */
+export const assertContainerPorts = (mappings, containerPorts) => {
+    const unknown = mappings.filter((mapping) => !containerPorts.includes(mapping.container));
+    if (unknown.length > 0) {
+        throw new Error(`Port mapping(s) ${unknown.map((m) => `'${m.host}:${m.container}'`).join(', ')} target ports the image does not listen on (${containerPorts.join(', ')})`);
+    }
+};
+//# sourceMappingURL=parsePortMappings.js.map

package/lib/esm/platforms/docker/parsePortMappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parsePortMappings.js","sourceRoot":"","sources":["../../../../src/platforms/docker/parsePortMappings.ts"],"names":[],"mappings":"AAKA,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C,yFAAyF;AACzF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,KAAa,EAAiB,EAAE,CAChE,KAAK;KACF,KAAK,CAAC,GAAG,CAAC;KACV,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,IAAI,EAAE,CAAC;KAC1B,MAAM,CAAC,OAAO,CAAC;KACf,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE;IACZ,MAAM,KAAK,GAAG,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IACtC,IAAI,CAAC,KAAK,EAAE,CAAC;QACX,MAAM,IAAI,KAAK,CAAC,iBAAiB,IAAI,wCAAwC,CAAC,CAAC;IACjF,CAAC;IACD,OAAO,EAAE,IAAI,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,SAAS,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;AACjE,CAAC,CAAC,CAAC;AAEP,yEAAyE;AACzE,MAAM,CAAC,MAAM,oBAAoB,GAAG,CAAC,QAAuB,EAAE,cAAwB,EAAQ,EAAE;IAC9F,MAAM,OAAO,GAAG,QAAQ,CAAC,MAAM,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,cAAc,CAAC,QAAQ,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC,CAAC;IAC1F,IAAI,OAAO,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QACvB,MAAM,IAAI,KAAK,CACb,mBAAmB,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,IAAI,CAAC,CAAC,IAAI,IAAI,CAAC,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,+CAA+C,cAAc,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAC1J,CAAC;IACJ,CAAC;AACH,CAAC,CAAC","sourcesContent":["export type PortMapping = {\n  host: number;\n  container: number;\n};\n\nconst PAIR_PATTERN = /^(\\d{1,5}):(\\d{1,5})$/;\n\n/** Parses \"host:container, ...\" into pairs, throwing naming the first malformed item. */\nexport const parsePortMappings = (value: string): PortMapping[] =>\n  value\n    .split(',')\n    .map((item) => item.trim())\n    .filter(Boolean)\n    .map((item) => {\n      const match = PAIR_PATTERN.exec(item);\n      if (!match) {\n        throw new Error(`Port mapping '${item}' must be host:container, e.g. 80:8080`);\n      }\n      return { host: Number(match[1]), container: Number(match[2]) };\n    });\n\n/** Throws when a mapping targets a port the image does not listen on. */\nexport const assertContainerPorts = (mappings: PortMapping[], containerPorts: number[]): void => {\n  const unknown = mappings.filter((mapping) => !containerPorts.includes(mapping.container));\n  if (unknown.length > 0) {\n    throw new Error(\n      `Port mapping(s) ${unknown.map((m) => `'${m.host}:${m.container}'`).join(', ')} target ports the image does not listen on (${containerPorts.join(', ')})`,\n    );\n  }\n};\n"]}

package/lib/esm/platforms/docker/resolvePortMappings.d.ts

@@ -0,0 +1,8 @@
+import { ParsedDockerPlatformSettings } from './getDockerPlatformSettings';
+import { PortMapping } from './parsePortMappings';
+/**
+ * The host:container pairs to run the image with: the deployment's own, or one per container
+ * port plus 80 for the site. Throws, naming the deployment, when a mapping targets a port the
+ * image does not listen on.
+ */
+export declare const resolvePortMappings: (deploymentName: string, settings: ParsedDockerPlatformSettings, apiPort: number, containerPorts: number[]) => PortMapping[];

package/lib/esm/platforms/docker/resolvePortMappings.js

@@ -0,0 +1,18 @@
+import { getDefaultPortMappings } from './getDefaultPortMappings';
+import { assertContainerPorts } from './parsePortMappings';
+/**
+ * The host:container pairs to run the image with: the deployment's own, or one per container
+ * port plus 80 for the site. Throws, naming the deployment, when a mapping targets a port the
+ * image does not listen on.
+ */
+export const resolvePortMappings = (deploymentName, settings, apiPort, containerPorts) => {
+    const portMappings = settings.portMappings ?? getDefaultPortMappings(apiPort, containerPorts);
+    try {
+        assertContainerPorts(portMappings, containerPorts);
+    }
+    catch (error) {
+        throw new Error(`Invalid docker deployment '${deploymentName}': ${error instanceof Error ? error.message : String(error)}`);
+    }
+    return portMappings;
+};
+//# sourceMappingURL=resolvePortMappings.js.map

package/lib/esm/platforms/docker/resolvePortMappings.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"resolvePortMappings.js","sourceRoot":"","sources":["../../../../src/platforms/docker/resolvePortMappings.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,sBAAsB,EAAE,MAAM,0BAA0B,CAAC;AAElE,OAAO,EAAE,oBAAoB,EAAe,MAAM,qBAAqB,CAAC;AAExE;;;;GAIG;AACH,MAAM,CAAC,MAAM,mBAAmB,GAAG,CACjC,cAAsB,EACtB,QAAsC,EACtC,OAAe,EACf,cAAwB,EACT,EAAE;IACjB,MAAM,YAAY,GAAG,QAAQ,CAAC,YAAY,IAAI,sBAAsB,CAAC,OAAO,EAAE,cAAc,CAAC,CAAC;IAC9F,IAAI,CAAC;QACH,oBAAoB,CAAC,YAAY,EAAE,cAAc,CAAC,CAAC;IACrD,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,MAAM,IAAI,KAAK,CAAC,8BAA8B,cAAc,MAAM,KAAK,YAAY,KAAK,CAAC,CAAC,CAAC,KAAK,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,CAAC;IAC9H,CAAC;IACD,OAAO,YAAY,CAAC;AACtB,CAAC,CAAC","sourcesContent":["import { getDefaultPortMappings } from './getDefaultPortMappings';\nimport { ParsedDockerPlatformSettings } from './getDockerPlatformSettings';\nimport { assertContainerPorts, PortMapping } from './parsePortMappings';\n\n/**\n * The host:container pairs to run the image with: the deployment's own, or one per container\n * port plus 80 for the site. Throws, naming the deployment, when a mapping targets a port the\n * image does not listen on.\n */\nexport const resolvePortMappings = (\n  deploymentName: string,\n  settings: ParsedDockerPlatformSettings,\n  apiPort: number,\n  containerPorts: number[],\n): PortMapping[] => {\n  const portMappings = settings.portMappings ?? getDefaultPortMappings(apiPort, containerPorts);\n  try {\n    assertContainerPorts(portMappings, containerPorts);\n  } catch (error) {\n    throw new Error(`Invalid docker deployment '${deploymentName}': ${error instanceof Error ? error.message : String(error)}`);\n  }\n  return portMappings;\n};\n"]}

package/lib/esm/platforms/docker/writeComposeFile.d.ts

@@ -0,0 +1,20 @@
+import { Nullable } from '@qpqjs/core';
+import { Mount } from './parseMounts';
+import { PortMapping } from './parsePortMappings';
+export type ComposeFileOptions = {
+    contextDir: string;
+    imageName: string;
+    serviceName: string;
+    volumeName: string;
+    portMappings: PortMapping[];
+    dataPath: Nullable<string>;
+    mounts: Mount[];
+    publicHost: Nullable<string>;
+    publicFileStoragePort: number;
+};
+/**
+ * A docker-compose.yml for running the image on any docker host: the image, the port mappings
+ * the frontend was built for, the public host, where the app's state lives, and any other host
+ * folders mounted into it. Returns its path.
+ */
+export declare const writeComposeFile: ({ contextDir, imageName, serviceName, volumeName, portMappings, dataPath, mounts, publicHost, publicFileStoragePort, }: ComposeFileOptions) => string;

package/lib/esm/platforms/docker/writeComposeFile.js

@@ -0,0 +1,37 @@
+import fs from 'fs';
+import path from 'path';
+import { DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV, DEV_SERVER_PUBLIC_HOST_ENV } from '../../lib/devServerEntry';
+/**
+ * A docker-compose.yml for running the image on any docker host: the image, the port mappings
+ * the frontend was built for, the public host, where the app's state lives, and any other host
+ * folders mounted into it. Returns its path.
+ */
+export const writeComposeFile = ({ contextDir, imageName, serviceName, volumeName, portMappings, dataPath, mounts, publicHost, publicFileStoragePort, }) => {
+    const ports = portMappings.map((mapping) => `      - "${mapping.host}:${mapping.container}"`).join('\n');
+    const environmentLines = [
+        ...(publicHost ? [`${DEV_SERVER_PUBLIC_HOST_ENV}=${publicHost}`] : []),
+        `${DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV}=${publicFileStoragePort}`,
+    ];
+    const environment = `    environment:\n${environmentLines.map((line) => `      - ${line}`).join('\n')}\n`;
+    // All app state (key-value stores, file storage) is this one directory.
+    const stateSource = dataPath ?? volumeName;
+    const namedVolume = dataPath ? '' : `\nvolumes:\n  ${volumeName}:\n`;
+    // Quoted (a JSON string is a valid YAML one), since host folders can hold spaces.
+    const mountLines = mounts.map((mount) => `\n      - ${JSON.stringify(`${mount.host}:${mount.container}${mount.readOnly ? ':ro' : ''}`)}`).join('');
+    const compose = `# Generated by qpq go from deploy.config.json. Host ports are baked into the frontend, so
+# change them there and rebuild rather than here.
+services:
+  ${serviceName}:
+    image: ${imageName}
+    container_name: ${serviceName}
+    restart: unless-stopped
+${environment}    ports:
+${ports}
+    volumes:
+      - ${stateSource}:/app/.qpq-runtime${mountLines}
+${namedVolume}`;
+    const composePath = path.join(contextDir, 'docker-compose.yml');
+    fs.writeFileSync(composePath, compose);
+    return composePath;
+};
+//# sourceMappingURL=writeComposeFile.js.map

package/lib/esm/platforms/docker/writeComposeFile.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"writeComposeFile.js","sourceRoot":"","sources":["../../../../src/platforms/docker/writeComposeFile.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,uCAAuC,EAAE,0BAA0B,EAAE,MAAM,0BAA0B,CAAC;AAoB/G;;;;GAIG;AACH,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,EAC/B,UAAU,EACV,SAAS,EACT,WAAW,EACX,UAAU,EACV,YAAY,EACZ,QAAQ,EACR,MAAM,EACN,UAAU,EACV,qBAAqB,GACF,EAAU,EAAE;IAC/B,MAAM,KAAK,GAAG,YAAY,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,YAAY,OAAO,CAAC,IAAI,IAAI,OAAO,CAAC,SAAS,GAAG,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;IAEzG,MAAM,gBAAgB,GAAG;QACvB,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,CAAC,GAAG,0BAA0B,IAAI,UAAU,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,GAAG,uCAAuC,IAAI,qBAAqB,EAAE;KACtE,CAAC;IACF,MAAM,WAAW,GAAG,qBAAqB,gBAAgB,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;IAE1G,wEAAwE;IACxE,MAAM,WAAW,GAAG,QAAQ,IAAI,UAAU,CAAC;IAC3C,MAAM,WAAW,GAAG,QAAQ,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,iBAAiB,UAAU,KAAK,CAAC;IACrE,kFAAkF;IAClF,MAAM,UAAU,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,aAAa,IAAI,CAAC,SAAS,CAAC,GAAG,KAAK,CAAC,IAAI,IAAI,KAAK,CAAC,SAAS,GAAG,KAAK,CAAC,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,EAAE,CAAC,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;IAEnJ,MAAM,OAAO,GAAG;;;IAGd,WAAW;aACF,SAAS;sBACA,WAAW;;EAE/B,WAAW;EACX,KAAK;;UAEG,WAAW,qBAAqB,UAAU;EAClD,WAAW,EAAE,CAAC;IAEd,MAAM,WAAW,GAAG,IAAI,CAAC,IAAI,CAAC,UAAU,EAAE,oBAAoB,CAAC,CAAC;IAChE,EAAE,CAAC,aAAa,CAAC,WAAW,EAAE,OAAO,CAAC,CAAC;IACvC,OAAO,WAAW,CAAC;AACrB,CAAC,CAAC","sourcesContent":["import { Nullable } from '@qpqjs/core';\n\nimport fs from 'fs';\nimport path from 'path';\n\nimport { DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV, DEV_SERVER_PUBLIC_HOST_ENV } from '../../lib/devServerEntry';\nimport { Mount } from './parseMounts';\nimport { PortMapping } from './parsePortMappings';\n\nexport type ComposeFileOptions = {\n  contextDir: string;\n  imageName: string;\n  serviceName: string;\n  volumeName: string;\n  portMappings: PortMapping[];\n  // Host directory for the app's state; null keeps it in the named volume.\n  dataPath: Nullable<string>;\n  // Host folders the app reads or writes beyond its state.\n  mounts: Mount[];\n  // The address browsers use for the host; null leaves secure file urls on localhost.\n  publicHost: Nullable<string>;\n  // Host-side port of the file storage listener, for the secure urls it hands out.\n  publicFileStoragePort: number;\n};\n\n/**\n * A docker-compose.yml for running the image on any docker host: the image, the port mappings\n * the frontend was built for, the public host, where the app's state lives, and any other host\n * folders mounted into it. Returns its path.\n */\nexport const writeComposeFile = ({\n  contextDir,\n  imageName,\n  serviceName,\n  volumeName,\n  portMappings,\n  dataPath,\n  mounts,\n  publicHost,\n  publicFileStoragePort,\n}: ComposeFileOptions): string => {\n  const ports = portMappings.map((mapping) => `      - \"${mapping.host}:${mapping.container}\"`).join('\\n');\n\n  const environmentLines = [\n    ...(publicHost ? [`${DEV_SERVER_PUBLIC_HOST_ENV}=${publicHost}`] : []),\n    `${DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV}=${publicFileStoragePort}`,\n  ];\n  const environment = `    environment:\\n${environmentLines.map((line) => `      - ${line}`).join('\\n')}\\n`;\n\n  // All app state (key-value stores, file storage) is this one directory.\n  const stateSource = dataPath ?? volumeName;\n  const namedVolume = dataPath ? '' : `\\nvolumes:\\n  ${volumeName}:\\n`;\n  // Quoted (a JSON string is a valid YAML one), since host folders can hold spaces.\n  const mountLines = mounts.map((mount) => `\\n      - ${JSON.stringify(`${mount.host}:${mount.container}${mount.readOnly ? ':ro' : ''}`)}`).join('');\n\n  const compose = `# Generated by qpq go from deploy.config.json. Host ports are baked into the frontend, so\n# change them there and rebuild rather than here.\nservices:\n  ${serviceName}:\n    image: ${imageName}\n    container_name: ${serviceName}\n    restart: unless-stopped\n${environment}    ports:\n${ports}\n    volumes:\n      - ${stateSource}:/app/.qpq-runtime${mountLines}\n${namedVolume}`;\n\n  const composePath = path.join(contextDir, 'docker-compose.yml');\n  fs.writeFileSync(composePath, compose);\n  return composePath;\n};\n"]}

package/lib/esm/platforms/index.d.ts

@@ -0,0 +1,3 @@
+import { QpqPlatformDriver } from './types';
+export declare const getPlatformDriver: (platform: string) => QpqPlatformDriver;
+export * from './types';

package/lib/esm/platforms/index.js

@@ -0,0 +1,17 @@
+import { awsPlatformDriver } from './aws';
+import { dockerPlatformDriver } from './docker';
+import { QpqDeployPlatform } from './types';
+const platformDrivers = {
+    [QpqDeployPlatform.aws]: awsPlatformDriver,
+    [QpqDeployPlatform.docker]: dockerPlatformDriver,
+};
+export const getPlatformDriver = (platform) => {
+    const driver = platformDrivers[platform];
+    if (!driver) {
+        console.error(`Unknown deploy platform '${platform}'. Supported platforms: ${Object.keys(platformDrivers).join(', ')}`);
+        process.exit(1);
+    }
+    return driver;
+};
+export * from './types';
+//# sourceMappingURL=index.js.map

package/lib/esm/platforms/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platforms/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,iBAAiB,EAAE,MAAM,OAAO,CAAC;AAC1C,OAAO,EAAE,oBAAoB,EAAE,MAAM,UAAU,CAAC;AAChD,OAAO,EAAE,iBAAiB,EAAqB,MAAM,SAAS,CAAC;AAE/D,MAAM,eAAe,GAAsC;IACzD,CAAC,iBAAiB,CAAC,GAAG,CAAC,EAAE,iBAAiB;IAC1C,CAAC,iBAAiB,CAAC,MAAM,CAAC,EAAE,oBAAoB;CACjD,CAAC;AAEF,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAqB,EAAE;IACvE,MAAM,MAAM,GAAG,eAAe,CAAC,QAAQ,CAAC,CAAC;IAEzC,IAAI,CAAC,MAAM,EAAE,CAAC;QACZ,OAAO,CAAC,KAAK,CAAC,4BAA4B,QAAQ,2BAA2B,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC,CAAC;QACxH,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;IAClB,CAAC;IAED,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAEF,cAAc,SAAS,CAAC","sourcesContent":["import { awsPlatformDriver } from './aws';\nimport { dockerPlatformDriver } from './docker';\nimport { QpqDeployPlatform, QpqPlatformDriver } from './types';\n\nconst platformDrivers: Record<string, QpqPlatformDriver> = {\n  [QpqDeployPlatform.aws]: awsPlatformDriver,\n  [QpqDeployPlatform.docker]: dockerPlatformDriver,\n};\n\nexport const getPlatformDriver = (platform: string): QpqPlatformDriver => {\n  const driver = platformDrivers[platform];\n\n  if (!driver) {\n    console.error(`Unknown deploy platform '${platform}'. Supported platforms: ${Object.keys(platformDrivers).join(', ')}`);\n    process.exit(1);\n  }\n\n  return driver;\n};\n\nexport * from './types';\n"]}

package/lib/esm/platforms/types.d.ts

@@ -0,0 +1,21 @@
+import { QpqAppDeployment } from '@qpqjs/core';
+import { ClearResourcesPlan } from '../lib/clearResourcesPlan';
+import { DeployPlan, TeardownPlan } from '../lib/deployPrompts';
+import { GoDockerMode } from '../lib/goDockerMode';
+import { SetupStep } from '../lib/setupStep';
+export declare enum QpqDeployPlatform {
+    aws = "aws",
+    docker = "docker"
+}
+export interface QpqPlatformDriver {
+    prepareDeployment: (deploymentName: string, deployment: QpqAppDeployment) => void;
+    go: (appName: string, plan: DeployPlan) => Promise<void>;
+    goDocker?: (appName: string, plan: DeployPlan, mode: GoDockerMode) => Promise<void>;
+    teardown?: (appName: string, plan: TeardownPlan) => Promise<void>;
+    clearResources?: (appName: string, plan: ClearResourcesPlan) => Promise<void>;
+    setupSteps?: (appName: string, deploymentName: string) => Promise<SetupStep[]>;
+    publish: (appName: string, serviceNames: string[]) => Promise<void>;
+    publishBuild: (appName: string, serviceNames: string[]) => Promise<void>;
+    publishUpload: (appName: string, serviceNames: string[]) => Promise<void>;
+    publishDeploy: (appName: string, serviceNames: string[]) => Promise<void>;
+}