quidproquo-cli 0.1.5

package/lib/commonjs/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/commonjs/platforms/docker/go.js

@@ -0,0 +1,160 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerGo = void 0;
+// 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/<svc>), mirroring the AWS website/views layout.
+//   3. Assemble an image context under dist/qpq/docker-image/<app>/ — server
+//      bundle, web root, a workspaces-stripped package.json for runtime deps,
+//      and the locally-built quidproquo packages as a vendor overlay.
+//   4. docker build, then print the run command.
+//
+// Not production-grade (single process, sqlite, in-memory queues) — it's the
+// whole product on one box with one command.
+const quidproquo_deploy_rspack_1 = require("quidproquo-deploy-rspack");
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const devServerEntry_1 = require("../../lib/devServerEntry");
+const discovery_1 = require("../../lib/discovery");
+const hooks_1 = require("../../lib/hooks");
+const packageRoot_1 = require("../../lib/packageRoot");
+const rspackRun_1 = require("../../lib/rspackRun");
+const runCommand_1 = require("../../lib/runCommand");
+const timing_1 = require("../../lib/timing");
+const views_1 = require("../../lib/views");
+const getImageContextDir = (root, appName) => path_1.default.join(root, 'dist', 'qpq', 'docker-image', appName);
+// 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) => {
+    var _a, _b;
+    const rootPackageJson = JSON.parse(fs_1.default.readFileSync(path_1.default.join(root, 'package.json'), 'utf8'));
+    const dependencies = Object.assign({}, ((_a = rootPackageJson.dependencies) !== null && _a !== void 0 ? _a : {}));
+    for (const [name, version] of Object.entries(dependencies)) {
+        if (name.startsWith('quidproquo') && version.startsWith('file:')) {
+            dependencies[name] = `file:./vendor/${name}`;
+        }
+    }
+    const imagePackageJson = {
+        name: `${rootPackageJson.name}-qpq-docker`,
+        version: (_b = rootPackageJson.version) !== null && _b !== void 0 ? _b : '0.0.0',
+        private: true,
+        dependencies,
+        overrides: rootPackageJson.overrides,
+    };
+    fs_1.default.writeFileSync(path_1.default.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_1.default.join(root, 'node_modules');
+    const vendorDir = path_1.default.join(contextDir, 'vendor');
+    let vendored = 0;
+    for (const name of fs_1.default.readdirSync(nodeModules)) {
+        if (!name.startsWith('quidproquo'))
+            continue;
+        const packageDir = fs_1.default.realpathSync(path_1.default.join(nodeModules, name));
+        const targetDir = path_1.default.join(vendorDir, name);
+        fs_1.default.mkdirSync(targetDir, { recursive: true });
+        fs_1.default.copyFileSync(path_1.default.join(packageDir, 'package.json'), path_1.default.join(targetDir, 'package.json'));
+        for (const sub of ['lib', 'config']) {
+            const subDir = path_1.default.join(packageDir, sub);
+            if (fs_1.default.existsSync(subDir)) {
+                fs_1.default.cpSync(subDir, path_1.default.join(targetDir, sub), { recursive: true, dereference: true });
+            }
+        }
+        vendored += 1;
+    }
+    return vendored;
+};
+const dockerGo = (appName, plan) => __awaiter(void 0, void 0, void 0, function* () {
+    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 = (0, discovery_1.getRoot)();
+    const imageTag = `qpq-${appName}:${process.env.ENVIRONMENT}`;
+    // 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 [${imageTag}] — the whole app deploys as one image\n\n`);
+    (0, timing_1.logTimeStart)('totalTime');
+    yield (0, hooks_1.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');
+    yield (0, runCommand_1.runCommand)('npm', ['run', 'build', '--workspaces', '--if-present']);
+    // ---- Server bundle: the dev server + every service, one main.js ----
+    console.log('Bundling server (dev server + all services)');
+    const qpqConfigs = (0, quidproquo_deploy_rspack_1.getAppServiceQpqConfigs)(root, appName);
+    const entry = (0, devServerEntry_1.writeDevServerEntry)(root, appName);
+    yield (0, rspackRun_1.runRspack)((0, quidproquo_deploy_rspack_1.getDevServerRspackConfig)({ root, entry, qpqConfigs }));
+    // ---- Views: production builds with same-origin federation remotes ----
+    process.env.QPQ_VIEWS_REMOTE_BASE = '/views';
+    const viewServices = (0, discovery_1.getServiceNamesWithViews)(appName);
+    for (const serviceName of viewServices) {
+        console.log(`Bundling views: [${serviceName}]`);
+        yield (0, views_1.bundleViews)(appName, serviceName);
+    }
+    delete process.env.QPQ_VIEWS_REMOTE_BASE;
+    // ---- Assemble the image context ----
+    console.log('Assembling image context');
+    const contextDir = getImageContextDir(root, appName);
+    fs_1.default.rmSync(contextDir, { recursive: true, force: true });
+    fs_1.default.mkdirSync(contextDir, { recursive: true });
+    fs_1.default.copyFileSync(path_1.default.join((0, packageRoot_1.getOwnPackageRoot)(), 'docker', 'dev-server', 'Dockerfile'), path_1.default.join(contextDir, 'Dockerfile'));
+    writeImagePackageJson(root, contextDir);
+    const vendored = vendorQuidproquoPackages(root, contextDir);
+    console.log(`Vendored ${vendored} quidproquo packages`);
+    fs_1.default.cpSync(path_1.default.join(root, 'dist', 'qpq', 'dev-server'), path_1.default.join(contextDir, 'server'), { recursive: true });
+    // Web root mirrors the AWS buckets: shell at website/, every views build
+    // (shell included) under views/<svc>/.
+    for (const serviceName of viewServices) {
+        const viewsDist = (0, views_1.getViewsDistDir)(appName, serviceName);
+        fs_1.default.cpSync(viewsDist, path_1.default.join(contextDir, 'web', 'views', serviceName), { recursive: true });
+        if (serviceName === 'shell') {
+            fs_1.default.cpSync(viewsDist, path_1.default.join(contextDir, 'web', 'website'), { recursive: true });
+        }
+    }
+    // ---- Build the image ----
+    console.log('Building docker image');
+    yield (0, runCommand_1.runCommand)('docker', ['build', '-t', imageTag, contextDir]);
+    (0, timing_1.logTimeEnd)('totalTime');
+    console.log(`
+Done. Run it with:
+
+  docker run --rm -p 80:8080 -p 8080:8080 -p 8888:8888 -p 3001:3001 \\
+    -v qpq-${appName}-data:/app/.qpq-runtime \\
+    ${imageTag}
+
+Then open http://localhost
+(80 serves the shell; 8080 stays mapped because the app's url resolvers call localhost:8080 for apis)
+`);
+});
+exports.dockerGo = dockerGo;
+//# sourceMappingURL=go.js.map

package/lib/commonjs/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/<svc>), mirroring the AWS website/views layout.\n//   3. Assemble an image context under dist/qpq/docker-image/<app>/ — server\n//      bundle, web root, a workspaces-stripped package.json for runtime deps,\n//      and the locally-built quidproquo packages as a vendor overlay.\n//   4. docker build, then print the run command.\n//\n// Not production-grade (single process, sqlite, in-memory queues) — it's the\n// whole product on one box with one command.\nimport { getAppServiceQpqConfigs, getDevServerRspackConfig } from 'quidproquo-deploy-rspack';\n\nimport fs from 'fs';\nimport path from 'path';\n\nimport { DeployPlan } from '../../lib/deployPrompts';\nimport { writeDevServerEntry } from '../../lib/devServerEntry';\nimport { getRoot, getServiceNamesWithViews } from '../../lib/discovery';\nimport { runAppHook } from '../../lib/hooks';\nimport { getOwnPackageRoot } from '../../lib/packageRoot';\nimport { runRspack } from '../../lib/rspackRun';\nimport { runCommand } from '../../lib/runCommand';\nimport { logTimeEnd, logTimeStart } from '../../lib/timing';\nimport { bundleViews, getViewsDistDir } from '../../lib/views';\n\nconst getImageContextDir = (root: string, appName: string): string => path.join(root, 'dist', 'qpq', 'docker-image', appName);\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 (name.startsWith('quidproquo') && 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 fs.readdirSync(nodeModules)) {\n    if (!name.startsWith('quidproquo')) continue;\n\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 imageTag = `qpq-${appName}:${process.env.ENVIRONMENT}`;\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 [${imageTag}] — 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  await runCommand('npm', ['run', 'build', '--workspaces', '--if-present']);\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  const entry = writeDevServerEntry(root, appName);\n  await runRspack(getDevServerRspackConfig({ root, entry, qpqConfigs }));\n\n  // ---- Views: production builds with same-origin federation remotes ----\n  process.env.QPQ_VIEWS_REMOTE_BASE = '/views';\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\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  fs.copyFileSync(path.join(getOwnPackageRoot(), 'docker', 'dev-server', 'Dockerfile'), path.join(contextDir, 'Dockerfile'));\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  // Web root mirrors the AWS buckets: shell at website/, every views build\n  // (shell included) under views/<svc>/.\n  for (const serviceName of viewServices) {\n    const viewsDist = getViewsDistDir(appName, serviceName);\n    fs.cpSync(viewsDist, path.join(contextDir, 'web', 'views', serviceName), { recursive: true });\n    if (serviceName === 'shell') {\n      fs.cpSync(viewsDist, path.join(contextDir, 'web', 'website'), { recursive: true });\n    }\n  }\n\n  // ---- Build the image ----\n  console.log('Building docker image');\n  await runCommand('docker', ['build', '-t', imageTag, contextDir]);\n\n  logTimeEnd('totalTime');\n\n  console.log(`\nDone. Run it with:\n\n  docker run --rm -p 80:8080 -p 8080:8080 -p 8888:8888 -p 3001:3001 \\\\\n    -v qpq-${appName}-data:/app/.qpq-runtime \\\\\n    ${imageTag}\n\nThen open http://localhost\n(80 serves the shell; 8080 stays mapped because the app's url resolvers call localhost:8080 for apis)\n`);\n};\n"]}

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

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

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

@@ -0,0 +1,27 @@
+"use strict";
+var __awaiter = (this && this.__awaiter) || function (thisArg, _arguments, P, generator) {
+    function adopt(value) { return value instanceof P ? value : new P(function (resolve) { resolve(value); }); }
+    return new (P || (P = Promise))(function (resolve, reject) {
+        function fulfilled(value) { try { step(generator.next(value)); } catch (e) { reject(e); } }
+        function rejected(value) { try { step(generator["throw"](value)); } catch (e) { reject(e); } }
+        function step(result) { result.done ? resolve(result.value) : adopt(result.value).then(fulfilled, rejected); }
+        step((generator = generator.apply(thisArg, _arguments || [])).next());
+    });
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.dockerPlatformDriver = void 0;
+const go_1 = require("./go");
+const publishNotSupported = () => __awaiter(void 0, void 0, void 0, function* () {
+    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);
+});
+exports.dockerPlatformDriver = {
+    // The docker platform needs no deploy identity — everything runs in-image.
+    primeDeployIdentity: () => [],
+    go: go_1.dockerGo,
+    publish: publishNotSupported,
+    publishBuild: publishNotSupported,
+    publishUpload: publishNotSupported,
+    publishDeploy: publishNotSupported,
+};
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/platforms/docker/index.ts"],"names":[],"mappings":";;;;;;;;;;;;AACA,6BAAgC;AAEhC,MAAM,mBAAmB,GAAG,GAAwB,EAAE;IACpD,OAAO,CAAC,KAAK,CAAC,oHAAoH,CAAC,CAAC;IACpI,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AAClB,CAAC,CAAA,CAAC;AAEW,QAAA,oBAAoB,GAAsB;IACrD,2EAA2E;IAC3E,mBAAmB,EAAE,GAAG,EAAE,CAAC,EAAE;IAE7B,EAAE,EAAE,aAAQ;IAEZ,OAAO,EAAE,mBAAmB;IAC5B,YAAY,EAAE,mBAAmB;IACjC,aAAa,EAAE,mBAAmB;IAClC,aAAa,EAAE,mBAAmB;CACnC,CAAC","sourcesContent":["import { QpqPlatformDriver } from '../types';\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\nexport const dockerPlatformDriver: QpqPlatformDriver = {\n  // The docker platform needs no deploy identity — everything runs in-image.\n  primeDeployIdentity: () => [],\n\n  go: dockerGo,\n\n  publish: publishNotSupported,\n  publishBuild: publishNotSupported,\n  publishUpload: publishNotSupported,\n  publishDeploy: publishNotSupported,\n};\n"]}

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

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

package/lib/commonjs/platforms/index.js

@@ -0,0 +1,39 @@
+"use strict";
+var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    var desc = Object.getOwnPropertyDescriptor(m, k);
+    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
+      desc = { enumerable: true, get: function() { return m[k]; } };
+    }
+    Object.defineProperty(o, k2, desc);
+}) : (function(o, m, k, k2) {
+    if (k2 === undefined) k2 = k;
+    o[k2] = m[k];
+}));
+var __exportStar = (this && this.__exportStar) || function(m, exports) {
+    for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getPlatformDriver = exports.findPlatformDriver = void 0;
+const aws_1 = require("./aws");
+const docker_1 = require("./docker");
+const types_1 = require("./types");
+const platformDrivers = {
+    [types_1.QpqDeployPlatform.aws]: aws_1.awsPlatformDriver,
+    [types_1.QpqDeployPlatform.docker]: docker_1.dockerPlatformDriver,
+};
+// Lenient lookup for best-effort paths (local dev priming) — undefined when
+// the platform isn't known, never exits.
+const findPlatformDriver = (platform) => platformDrivers[platform];
+exports.findPlatformDriver = findPlatformDriver;
+const getPlatformDriver = (platform) => {
+    const driver = (0, exports.findPlatformDriver)(platform);
+    if (!driver) {
+        console.error(`Unknown deploy platform '${platform}'. Supported platforms: ${Object.keys(platformDrivers).join(', ')}`);
+        process.exit(1);
+    }
+    return driver;
+};
+exports.getPlatformDriver = getPlatformDriver;
+__exportStar(require("./types"), exports);
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/platforms/index.ts"],"names":[],"mappings":";;;;;;;;;;;;;;;;;AAAA,+BAA0C;AAC1C,qCAAgD;AAChD,mCAA+D;AAE/D,MAAM,eAAe,GAAsC;IACzD,CAAC,yBAAiB,CAAC,GAAG,CAAC,EAAE,uBAAiB;IAC1C,CAAC,yBAAiB,CAAC,MAAM,CAAC,EAAE,6BAAoB;CACjD,CAAC;AAEF,4EAA4E;AAC5E,yCAAyC;AAClC,MAAM,kBAAkB,GAAG,CAAC,QAAgB,EAAiC,EAAE,CAAC,eAAe,CAAC,QAAQ,CAAC,CAAC;AAApG,QAAA,kBAAkB,sBAAkF;AAE1G,MAAM,iBAAiB,GAAG,CAAC,QAAgB,EAAqB,EAAE;IACvE,MAAM,MAAM,GAAG,IAAA,0BAAkB,EAAC,QAAQ,CAAC,CAAC;IAE5C,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;AATW,QAAA,iBAAiB,qBAS5B;AAEF,0CAAwB","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\n// Lenient lookup for best-effort paths (local dev priming) — undefined when\n// the platform isn't known, never exits.\nexport const findPlatformDriver = (platform: string): QpqPlatformDriver | undefined => platformDrivers[platform];\n\nexport const getPlatformDriver = (platform: string): QpqPlatformDriver => {\n  const driver = findPlatformDriver(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/commonjs/platforms/types.d.ts

@@ -0,0 +1,16 @@
+import { QpqAppDeployEnvironment } from 'quidproquo-deploy-awscdk';
+import { DeployPlan, TeardownPlan } from '../lib/deployPrompts';
+export declare enum QpqDeployPlatform {
+    aws = "aws",
+    docker = "docker"
+}
+export interface QpqPlatformDriver {
+    primeDeployIdentity: (target: QpqAppDeployEnvironment | undefined) => string[];
+    go: (appName: string, plan: DeployPlan) => Promise<void>;
+    goDocker?: (appName: string, plan: DeployPlan) => Promise<void>;
+    teardown?: (appName: string, plan: TeardownPlan) => Promise<void>;
+    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>;
+}

package/lib/commonjs/platforms/types.js

@@ -0,0 +1,9 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.QpqDeployPlatform = void 0;
+var QpqDeployPlatform;
+(function (QpqDeployPlatform) {
+    QpqDeployPlatform["aws"] = "aws";
+    QpqDeployPlatform["docker"] = "docker";
+})(QpqDeployPlatform || (exports.QpqDeployPlatform = QpqDeployPlatform = {}));
+//# sourceMappingURL=types.js.map

package/lib/commonjs/platforms/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/platforms/types.ts"],"names":[],"mappings":";;;AAIA,IAAY,iBAGX;AAHD,WAAY,iBAAiB;IAC3B,gCAAW,CAAA;IACX,sCAAiB,CAAA;AACnB,CAAC,EAHW,iBAAiB,iCAAjB,iBAAiB,QAG5B","sourcesContent":["import { QpqAppDeployEnvironment } from 'quidproquo-deploy-awscdk';\n\nimport { DeployPlan, TeardownPlan } from '../lib/deployPrompts';\n\nexport enum QpqDeployPlatform {\n  aws = 'aws',\n  docker = 'docker',\n}\n\n// A deploy platform driver — everything that happens after \"what to deploy\"\n// has been decided. `qpq go` resolves the app + environment, prompts the plan,\n// then hands off here; the platform comes from the environment's entry in\n// apps/<app>/deploy.config.json (default aws), so an app can move platforms\n// with a config change instead of a different command.\nexport interface QpqPlatformDriver {\n  // Prime process.env with this platform's deploy identity from the resolved\n  // environment target (already-set env vars win). Service configs read these\n  // vars at load time, so this runs before any infrastructure.ts is required.\n  // Returns human-readable descriptions of anything still missing — deploys\n  // treat that as fatal, local dev commands ignore it.\n  primeDeployIdentity: (target: QpqAppDeployEnvironment | undefined) => string[];\n\n  // Sequential deploy (`qpq go`).\n  go: (appName: string, plan: DeployPlan) => Promise<void>;\n\n  // Parallel containerized deploy (`qpq go:docker`) — optional; drivers that\n  // have no docker strategy simply omit it.\n  goDocker?: (appName: string, plan: DeployPlan) => Promise<void>;\n\n  // Destroy the web/api/inf stacks for selected services (`qpq teardown`) —\n  // optional; drivers with no teardown strategy simply omit it.\n  teardown?: (appName: string, plan: TeardownPlan) => Promise<void>;\n\n  // Federated remote publishing (`qpq publish[:build|:upload|:deploy]`).\n  publish: (appName: string, serviceNames: string[]) => Promise<void>;\n  publishBuild: (appName: string, serviceNames: string[]) => Promise<void>;\n  publishUpload: (appName: string, serviceNames: string[]) => Promise<void>;\n  publishDeploy: (appName: string, serviceNames: string[]) => Promise<void>;\n}\n"]}

package/lib/esm/bin/qpq.d.ts

@@ -0,0 +1,2 @@
+#!/usr/bin/env node
+export {};

package/lib/esm/bin/qpq.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { runCli } from '../cli';
+runCli(process.argv.slice(2));
+//# sourceMappingURL=qpq.js.map

package/lib/esm/bin/qpq.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qpq.js","sourceRoot":"","sources":["../../../src/bin/qpq.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,MAAM,EAAE,MAAM,QAAQ,CAAC;AAEhC,MAAM,CAAC,OAAO,CAAC,IAAI,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC","sourcesContent":["#!/usr/bin/env node\nimport { runCli } from '../cli';\n\nrunCli(process.argv.slice(2));\n"]}

package/lib/esm/bin/qpqCdkApp.d.ts

@@ -0,0 +1 @@
+export {};

package/lib/esm/bin/qpqCdkApp.js

@@ -0,0 +1,6 @@
+// The CDK app command (`cdk ... --app "node -r ts-node/register/transpile-only <this file>"`).
+// Runs under ts-node hooks so per-app TS config fragments and service
+// infrastructure.ts files can be required directly.
+import { createWorkspaceQpqCdkApp } from 'quidproquo-deploy-awscdk';
+createWorkspaceQpqCdkApp();
+//# sourceMappingURL=qpqCdkApp.js.map

package/lib/esm/bin/qpqCdkApp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"qpqCdkApp.js","sourceRoot":"","sources":["../../../src/bin/qpqCdkApp.ts"],"names":[],"mappings":"AAAA,+FAA+F;AAC/F,sEAAsE;AACtE,oDAAoD;AACpD,OAAO,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAC;AAEpE,wBAAwB,EAAE,CAAC","sourcesContent":["// The CDK app command (`cdk ... --app \"node -r ts-node/register/transpile-only <this file>\"`).\n// Runs under ts-node hooks so per-app TS config fragments and service\n// infrastructure.ts files can be required directly.\nimport { createWorkspaceQpqCdkApp } from 'quidproquo-deploy-awscdk';\n\ncreateWorkspaceQpqCdkApp();\n"]}

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

@@ -0,0 +1 @@
+export * from './runCli';

package/lib/esm/cli/index.js

@@ -0,0 +1,2 @@
+export * from './runCli';
+//# sourceMappingURL=index.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/cli/index.ts"],"names":[],"mappings":"AAAA,cAAc,UAAU,CAAC","sourcesContent":["export * from './runCli';\n"]}

package/lib/esm/cli/runCli.d.ts

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

package/lib/esm/cli/runCli.js

@@ -0,0 +1,67 @@
+const usage = `qpq — build, dev and deploy orchestration for QPQ apps
+
+Usage: qpq <command> [--app <name>] [--env <name>] [--platform <name>]
+
+Commands:
+  go               Deploy services (interactive; platform from deploy.config.json, default aws)
+  go:docker        Same as go, but deploys in parallel via docker
+  go:dev           Run the local dev server (hot reload)
+  go:dev:web       Run every views microfrontend dev server
+  teardown         Destroy web/api/inf stacks for selected services (interactive)
+  synth [service]  Synth QPQ configs to dist/apps/<app>/infrastructure
+  prep             Regenerate apps/<app>/tsconfig.federated.json
+  publish          Build + upload + deploy federated remotes
+  publish:build    Build federated remotes locally
+  publish:upload   Upload built version dirs (nothing goes live)
+  publish:deploy   Flip manifests to the uploaded versions
+  hooks <name>     Run qpq:<name> in every app that defines it
+`;
+// Service infrastructure.ts files (and app config fragments) are TypeScript —
+// register ts-node's transpile-only require hook so the CLI can require them
+// directly, using the consumer root's tsconfig.json ts-node settings.
+const registerTsNode = () => {
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    require('ts-node').register({ transpileOnly: true });
+};
+export const runCli = async (argv) => {
+    const [command, ...commandArgv] = argv;
+    if (!command || command === 'help' || command === '--help') {
+        console.log(usage);
+        return;
+    }
+    registerTsNode();
+    // Commands are required lazily so a simple `qpq help` doesn't pay for the
+    // whole toolchain, and so ts-node is registered before any command module
+    // (or anything it requires) loads.
+    /* eslint-disable @typescript-eslint/no-require-imports */
+    const commands = {
+        go: (a) => require('../commands/go').goCommand(a),
+        'go:docker': (a) => require('../commands/goDocker').goDockerCommand(a),
+        'go:dev': (a) => require('../commands/goDev').goDevCommand(a),
+        'go:dev:web': (a) => require('../commands/goDevWeb').goDevWebCommand(a),
+        teardown: (a) => require('../commands/teardown').teardownCommand(a),
+        synth: (a) => require('../commands/synth').synthCommand(a),
+        prep: (a) => require('../commands/prep').prepCommand(a),
+        publish: (a) => require('../commands/publish').publishCommand(a),
+        'publish:build': (a) => require('../commands/publish').publishBuildCommand(a),
+        'publish:upload': (a) => require('../commands/publish').publishUploadCommand(a),
+        'publish:deploy': (a) => require('../commands/publish').publishDeployCommand(a),
+        hooks: (a) => require('../commands/hooks').hooksCommand(a),
+    };
+    /* eslint-enable @typescript-eslint/no-require-imports */
+    const run = commands[command];
+    if (!run) {
+        console.error(`Unknown command: ${command}`);
+        console.log(usage);
+        process.exitCode = 1;
+        return;
+    }
+    try {
+        await run(commandArgv);
+    }
+    catch (error) {
+        console.error(`qpq ${command} failed:`, error);
+        process.exitCode = 1;
+    }
+};
+//# sourceMappingURL=runCli.js.map

package/lib/esm/cli/runCli.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCli.js","sourceRoot":"","sources":["../../../src/cli/runCli.ts"],"names":[],"mappings":"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","sourcesContent":["const usage = `qpq — build, dev and deploy orchestration for QPQ apps\n\nUsage: qpq <command> [--app <name>] [--env <name>] [--platform <name>]\n\nCommands:\n  go               Deploy services (interactive; platform from deploy.config.json, default aws)\n  go:docker        Same as go, but deploys in parallel via docker\n  go:dev           Run the local dev server (hot reload)\n  go:dev:web       Run every views microfrontend dev server\n  teardown         Destroy web/api/inf stacks for selected services (interactive)\n  synth [service]  Synth QPQ configs to dist/apps/<app>/infrastructure\n  prep             Regenerate apps/<app>/tsconfig.federated.json\n  publish          Build + upload + deploy federated remotes\n  publish:build    Build federated remotes locally\n  publish:upload   Upload built version dirs (nothing goes live)\n  publish:deploy   Flip manifests to the uploaded versions\n  hooks <name>     Run qpq:<name> in every app that defines it\n`;\n\n// Service infrastructure.ts files (and app config fragments) are TypeScript —\n// register ts-node's transpile-only require hook so the CLI can require them\n// directly, using the consumer root's tsconfig.json ts-node settings.\nconst registerTsNode = (): void => {\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  require('ts-node').register({ transpileOnly: true });\n};\n\nexport const runCli = async (argv: string[]): Promise<void> => {\n  const [command, ...commandArgv] = argv;\n\n  if (!command || command === 'help' || command === '--help') {\n    console.log(usage);\n    return;\n  }\n\n  registerTsNode();\n\n  // Commands are required lazily so a simple `qpq help` doesn't pay for the\n  // whole toolchain, and so ts-node is registered before any command module\n  // (or anything it requires) loads.\n  /* eslint-disable @typescript-eslint/no-require-imports */\n  const commands: Record<string, (commandArgv: string[]) => Promise<void>> = {\n    go: (a) => require('../commands/go').goCommand(a),\n    'go:docker': (a) => require('../commands/goDocker').goDockerCommand(a),\n    'go:dev': (a) => require('../commands/goDev').goDevCommand(a),\n    'go:dev:web': (a) => require('../commands/goDevWeb').goDevWebCommand(a),\n    teardown: (a) => require('../commands/teardown').teardownCommand(a),\n    synth: (a) => require('../commands/synth').synthCommand(a),\n    prep: (a) => require('../commands/prep').prepCommand(a),\n    publish: (a) => require('../commands/publish').publishCommand(a),\n    'publish:build': (a) => require('../commands/publish').publishBuildCommand(a),\n    'publish:upload': (a) => require('../commands/publish').publishUploadCommand(a),\n    'publish:deploy': (a) => require('../commands/publish').publishDeployCommand(a),\n    hooks: (a) => require('../commands/hooks').hooksCommand(a),\n  };\n  /* eslint-enable @typescript-eslint/no-require-imports */\n\n  const run = commands[command];\n\n  if (!run) {\n    console.error(`Unknown command: ${command}`);\n    console.log(usage);\n    process.exitCode = 1;\n    return;\n  }\n\n  try {\n    await run(commandArgv);\n  } catch (error) {\n    console.error(`qpq ${command} failed:`, error);\n    process.exitCode = 1;\n  }\n};\n"]}

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

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

package/lib/esm/commands/go.js

@@ -0,0 +1,15 @@
+// `qpq go` — interactive deploy. Resolves the app + environment (which names
+// the deploy platform in apps/<app>/deploy.config.json, default aws), asks the
+// deploy plan, then hands off to the platform driver.
+import { resolveDeployEnvironment } from '../lib/deployEnv';
+import { promptDeployPlan } from '../lib/deployPrompts';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+import { getPlatformDriver } from '../platforms';
+export const goCommand = async (argv) => {
+    const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });
+    const { platform } = await resolveDeployEnvironment(argv, appName);
+    const driver = getPlatformDriver(platform);
+    const plan = await promptDeployPlan(appName);
+    await driver.go(appName, plan);
+};
+//# sourceMappingURL=go.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"go.js","sourceRoot":"","sources":["../../../src/commands/go.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+EAA+E;AAC/E,sDAAsD;AACtD,OAAO,EAAE,wBAAwB,EAAE,MAAM,kBAAkB,CAAC;AAC5D,OAAO,EAAE,gBAAgB,EAAE,MAAM,sBAAsB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,4BAA4B,CAAC;AACjE,OAAO,EAAE,iBAAiB,EAAE,MAAM,cAAc,CAAC;AAEjD,MAAM,CAAC,MAAM,SAAS,GAAG,KAAK,EAAE,IAAc,EAAiB,EAAE;IAC/D,MAAM,OAAO,GAAG,MAAM,mBAAmB,CAAC,EAAE,IAAI,EAAE,MAAM,EAAE,iBAAiB,EAAE,CAAC,CAAC;IAC/E,MAAM,EAAE,QAAQ,EAAE,GAAG,MAAM,wBAAwB,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;IACnE,MAAM,MAAM,GAAG,iBAAiB,CAAC,QAAQ,CAAC,CAAC;IAE3C,MAAM,IAAI,GAAG,MAAM,gBAAgB,CAAC,OAAO,CAAC,CAAC;IAE7C,MAAM,MAAM,CAAC,EAAE,CAAC,OAAO,EAAE,IAAI,CAAC,CAAC;AACjC,CAAC,CAAC","sourcesContent":["// `qpq go` — interactive deploy. Resolves the app + environment (which names\n// the deploy platform in apps/<app>/deploy.config.json, default aws), asks the\n// deploy plan, then hands off to the platform driver.\nimport { resolveDeployEnvironment } from '../lib/deployEnv';\nimport { promptDeployPlan } from '../lib/deployPrompts';\nimport { resolveAppSelection } from '../lib/resolveAppSelection';\nimport { getPlatformDriver } from '../platforms';\n\nexport const goCommand = async (argv: string[]): Promise<void> => {\n  const appName = await resolveAppSelection({ argv, envVar: 'DEPLOY_APP_NAME' });\n  const { platform } = await resolveDeployEnvironment(argv, appName);\n  const driver = getPlatformDriver(platform);\n\n  const plan = await promptDeployPlan(appName);\n\n  await driver.go(appName, plan);\n};\n"]}

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

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

package/lib/esm/commands/goDev.js

@@ -0,0 +1,127 @@
+// `qpq go:dev` — boots the QPQ local dev server. Resolves the app, generates
+// the dev-server entry, builds the rspack config, then runs rspack in watch
+// mode, restarting the server process on every successful rebuild.
+//
+// The one thing NOT hot-reloaded is the qpq configs themselves: each service's
+// infrastructure.ts is evaluated once at launch and baked into the
+// `quidproquo-dynamic-loader` virtual module — config changes need a full
+// `go:dev` restart.
+import { getAppServiceQpqConfigs, getDevServerRspackConfig } from 'quidproquo-deploy-rspack';
+import { execSync, spawn } from 'child_process';
+import path from 'path';
+import { rspack } from '@rspack/core';
+import { primeDeployEnvFromConfig } from '../lib/deployEnv';
+import { writeDevServerEntry } from '../lib/devServerEntry';
+import { getRoot } from '../lib/discovery';
+import { resolveAppSelection } from '../lib/resolveAppSelection';
+// 8080/8888 are set in the generated entry; 3001 is the quidproquo-dev-server
+// file-storage (secure URL) default port.
+const DEV_SERVER_PORTS = [8080, 8888, 3001];
+const DEV_SERVER_BUNDLE_PATH = path.join('dist', 'qpq', 'dev-server', 'main.js');
+// Pre-start sweep: a previous `go:dev` whose wrapper died without killing its
+// child (closed terminal, SIGKILL) leaves an orphaned server process holding
+// the dev ports, and the next launch dies with EADDRINUSE. Before starting,
+// kill any listener on those ports that is running the dev-server bundle.
+// Anything else on the ports is left alone and reported — it's not ours.
+const killStaleDevServers = () => {
+    for (const port of DEV_SERVER_PORTS) {
+        let pids = [];
+        try {
+            pids = execSync(`lsof -t -iTCP:${port} -sTCP:LISTEN`, {
+                stdio: ['ignore', 'pipe', 'ignore'],
+            })
+                .toString()
+                .split('\n')
+                .map((line) => Number(line.trim()))
+                .filter(Boolean);
+        }
+        catch {
+            continue; // lsof exits non-zero when nothing is listening
+        }
+        for (const pid of pids) {
+            let command = '';
+            try {
+                command = execSync(`ps -p ${pid} -o command=`).toString().trim();
+            }
+            catch {
+                continue; // already gone
+            }
+            if (command.includes(DEV_SERVER_BUNDLE_PATH)) {
+                console.log(`Killing stale dev server on port ${port} (pid ${pid})`);
+                process.kill(pid);
+            }
+            else {
+                console.warn(`Port ${port} is in use by an unrelated process (pid ${pid}: ${command}) — not killing it.`);
+            }
+        }
+    }
+};
+export const goDevCommand = async (argv) => {
+    const root = getRoot();
+    const appName = await resolveAppSelection({ argv, envVar: 'QPQ_DEV_APP' });
+    process.env.QPQ_DEV_APP = appName;
+    primeDeployEnvFromConfig(appName);
+    console.log(`Dev server for app [${appName}]`);
+    killStaleDevServers();
+    const qpqConfigs = getAppServiceQpqConfigs(root, appName);
+    const entry = writeDevServerEntry(root, appName);
+    const rspackConfig = getDevServerRspackConfig({ root, entry, qpqConfigs });
+    const bundlePath = path.join(root, DEV_SERVER_BUNDLE_PATH);
+    const env = { ...process.env, QPQ_DEV_APP: appName };
+    // The long-lived server process (HTTP 8080 / WS 8888), restarted per rebuild.
+    let child = null;
+    let restartQueued = false;
+    const startServer = () => {
+        child = spawn('node', [bundlePath], { stdio: 'inherit', env });
+        child.on('exit', (code) => {
+            child = null;
+            if (!restartQueued) {
+                // Crashed (or exited) on its own — leave it down; the next successful
+                // rebuild (i.e. the next file save) brings it back up.
+                console.log(`Dev server exited with code ${code}. Save a file to restart it.`);
+            }
+        });
+    };
+    const restartServer = () => {
+        if (restartQueued)
+            return;
+        if (!child) {
+            startServer();
+            return;
+        }
+        restartQueued = true;
+        child.once('exit', () => {
+            restartQueued = false;
+            startServer();
+        });
+        child.kill();
+    };
+    console.log('Bundling dev server (watch mode)...');
+    let lastHash;
+    const compiler = rspack(rspackConfig);
+    compiler.watch({ aggregateTimeout: 200 }, (err, stats) => {
+        if (err) {
+            console.error(err);
+            return;
+        }
+        if (stats?.hasErrors()) {
+            console.error(stats.toString({ colors: true, chunks: false, modules: false }));
+            console.log('Build failed — dev server not restarted. Fix the error and save again.');
+            return;
+        }
+        // Skip no-op rebuilds (e.g. the virtual-module-triggered second compile at
+        // startup): only restart when the output actually changed.
+        if (stats?.hash === lastHash && child) {
+            return;
+        }
+        lastHash = stats?.hash;
+        console.log(child ? 'Rebuilt. Restarting dev server...' : 'Dev server bundled. Starting...');
+        restartServer();
+    });
+    process.on('SIGINT', () => {
+        restartQueued = true; // suppress the crash log / rebuild-restart on our own kill
+        child?.kill();
+        compiler.close(() => process.exit(0));
+    });
+};
+//# sourceMappingURL=goDev.js.map