@qpqjs/cli 0.0.0-stage → 0.2.0

package/lib/commonjs/lib/devServerEntry.d.ts

@@ -0,0 +1,22 @@
+/**
+ * What the generated bootstrap does: serve forever, run pending migrations once and exit, or
+ * both in turn (the docker image, where nothing else ever deploys and so nothing else would
+ * run the migrations).
+ */
+export type DevServerEntryMode = 'serve' | 'migrate' | 'migrate-then-serve';
+/** Env vars the docker image sets so the running server knows how the outside world reaches it. */
+export declare const DEV_SERVER_PUBLIC_HOST_ENV = "QPQ_PUBLIC_HOST";
+export declare const DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV = "QPQ_PUBLIC_FILE_STORAGE_PORT";
+/**
+ * Writes the dev-server bootstrap for an app and returns its path. Generated per build so it
+ * can import the optional app-owned overrides file (apps/<app>/devServer.config.ts) and the
+ * `quidproquo-dynamic-loader` virtual module QpqPlugin injects at bundle time. Every mode
+ * shares one bundle shape, so a local migration run rehearses exactly the deployed path.
+ */
+export declare const writeDevServerEntry: (root: string, appName: string, mode?: DevServerEntryMode) => string;
+/**
+ * Writes the dev server's user-script child entry and returns its path. The server forks the
+ * bundle this becomes once per script call, with the service name as its argument; the child
+ * serves that one call with the service's config and module loader, then exits.
+ */
+export declare const writeUserScriptChildEntry: (root: string) => string;

package/lib/commonjs/lib/devServerEntry.js

@@ -0,0 +1,135 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.writeUserScriptChildEntry = exports.writeDevServerEntry = exports.DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV = exports.DEV_SERVER_PUBLIC_HOST_ENV = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const deploy_rspack_1 = require("@qpqjs/deploy-rspack");
+const devServerPorts_1 = require("./devServerPorts");
+/** Env vars the docker image sets so the running server knows how the outside world reaches it. */
+exports.DEV_SERVER_PUBLIC_HOST_ENV = 'QPQ_PUBLIC_HOST';
+exports.DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV = 'QPQ_PUBLIC_FILE_STORAGE_PORT';
+const USER_SCRIPT_CHILD_ENTRY_FILE_NAME = 'user-script-child.entry.ts';
+const ENTRY_FILE_NAMES = {
+    serve: 'entry.ts',
+    migrate: 'migrate.entry.ts',
+    'migrate-then-serve': 'entry.ts',
+};
+const reportMigrations = `(ran) => {
+    const total = Object.values(ran).reduce((sum, keys) => sum + keys.length, 0);
+    for (const [service, keys] of Object.entries(ran)) {
+      for (const key of keys) {
+        console.log(\` [\${service}] \${key}\`);
+      }
+    }
+    console.log(total === 0 ? 'No pending migrations.' : \`Ran \${total} migration(s).\`);
+  }`;
+const getRunCall = (mode) => {
+    if (mode === 'serve') {
+        return 'startDevServer(devServerConfig, devServerConfigOverrides);';
+    }
+    const afterMigrations = mode === 'migrate' ? 'process.exit(0);' : 'return startDevServer(devServerConfig, devServerConfigOverrides);';
+    return `runMigrations(devServerConfig, devServerConfigOverrides)
+  .then(${reportMigrations})
+  .then(() => {
+    ${afterMigrations}
+  })
+  .catch((error) => {
+    console.error('Migration failed:', error);
+    // Non-zero so CI, shell chains and a container restart policy actually notice.
+    process.exit(1);
+  });`;
+};
+/**
+ * Writes the dev-server bootstrap for an app and returns its path. Generated per build so it
+ * can import the optional app-owned overrides file (apps/<app>/devServer.config.ts) and the
+ * `quidproquo-dynamic-loader` virtual module QpqPlugin injects at bundle time. Every mode
+ * shares one bundle shape, so a local migration run rehearses exactly the deployed path.
+ */
+const writeDevServerEntry = (root, appName, mode = 'serve') => {
+    const entryDir = path_1.default.join(root, 'dist', 'qpq', 'dev-server');
+    const entryPath = path_1.default.join(entryDir, ENTRY_FILE_NAMES[mode]);
+    const overridesPath = (0, devServerPorts_1.getDevServerConfigPath)(appName);
+    const overridesImport = fs_1.default.existsSync(overridesPath)
+        ? `import devServerConfigOverrides from ${JSON.stringify(overridesPath.replace(/\.ts$/, ''))};`
+        : 'const devServerConfigOverrides = {};';
+    const imports = mode === 'serve' ? 'startDevServer' : mode === 'migrate' ? 'runMigrations' : 'runMigrations, startDevServer';
+    fs_1.default.mkdirSync(entryDir, { recursive: true });
+    fs_1.default.writeFileSync(entryPath, `// GENERATED by qpq — do not edit.
+import { ${imports} } from '@qpqjs/dev-server';
+import path from 'path';
+import {
+  qpqConfigs,
+  qpqDynamicModuleLoaderForService,
+  // @ts-ignore - Special build-time virtual module
+} from 'quidproquo-dynamic-loader';
+
+${overridesImport}
+
+// Ports are defaults here; the app's devServer.config.ts \`ports\` win when the server resolves its config.
+const devServerConfig = {
+  serverDomain: 'localhost',
+  serverPort: ${devServerPorts_1.DEFAULT_DEV_SERVER_PORTS.api},
+  webSocketPort: ${devServerPorts_1.DEFAULT_DEV_SERVER_PORTS.webSocket},
+  // Scoped per app so running the dev server for two apps out of the same
+  // repo root doesn't share kvs/file-storage/config state.
+  runtimePath: ${JSON.stringify(path_1.default.join('.qpq-runtime', appName))},
+  fileStorageConfig: {
+    // Secure file urls are absolute, so a container has to be told the address browsers use.
+    secureUrlHost: process.env.${exports.DEV_SERVER_PUBLIC_HOST_ENV} || 'localhost',
+    secureUrlPort: ${devServerPorts_1.DEFAULT_DEV_SERVER_PORTS.fileStorage},
+    secureUrlPublicPort: Number(process.env.${exports.DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV}) || undefined,
+    // No fixed secret: the server mints a random one per process, so a secure url token
+    // (which names a filesystem path) cannot be forged by anyone who has read this file.
+  },
+  qpqConfigs,
+  dynamicModuleLoader: qpqDynamicModuleLoaderForService,
+  // The user-script child bundle is built beside this one (see writeUserScriptChildEntry).
+  userScriptChildModulePath: path.join(path.dirname(process.argv[1]), ${JSON.stringify(`${deploy_rspack_1.USER_SCRIPT_CHILD_BUNDLE_NAME}.js`)}),
+  // QPQ_WEB_ROOT (set in the docker platform image) turns on static web serving.
+  webRoot: process.env.QPQ_WEB_ROOT,
+  logServiceName: 'admin',
+  delay: { default: 0 },
+};
+
+${getRunCall(mode)}
+`);
+    return entryPath;
+};
+exports.writeDevServerEntry = writeDevServerEntry;
+/**
+ * Writes the dev server's user-script child entry and returns its path. The server forks the
+ * bundle this becomes once per script call, with the service name as its argument; the child
+ * serves that one call with the service's config and module loader, then exits.
+ */
+const writeUserScriptChildEntry = (root) => {
+    const entryDir = path_1.default.join(root, 'dist', 'qpq', 'dev-server');
+    const entryPath = path_1.default.join(entryDir, USER_SCRIPT_CHILD_ENTRY_FILE_NAME);
+    fs_1.default.mkdirSync(entryDir, { recursive: true });
+    fs_1.default.writeFileSync(entryPath, `// GENERATED by qpq — do not edit.
+import { qpqCoreUtils } from '@qpqjs/core';
+import { runUserScriptChildMain } from '@qpqjs/actionprocessor-node';
+import {
+  qpqConfigs,
+  qpqDynamicModuleLoaderForService,
+  // @ts-ignore - Special build-time virtual module
+} from 'quidproquo-dynamic-loader';
+
+export const main = (): void => {
+  const serviceName = process.argv[2];
+  const qpqConfig = qpqConfigs.find((config) => qpqCoreUtils.getApplicationModuleName(config) === serviceName);
+  if (!qpqConfig) {
+    throw new Error(\`User script child: no service named [\${serviceName}]\`);
+  }
+
+  runUserScriptChildMain(qpqConfig, (runtime) => qpqDynamicModuleLoaderForService(serviceName, runtime));
+};
+
+main();
+`);
+    return entryPath;
+};
+exports.writeUserScriptChildEntry = writeUserScriptChildEntry;
+//# sourceMappingURL=devServerEntry.js.map

package/lib/commonjs/lib/devServerEntry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServerEntry.js","sourceRoot":"","sources":["../../../src/lib/devServerEntry.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { USER_SCRIPT_CHILD_BUNDLE_NAME } from '@qpqjs/deploy-rspack';\n\nimport { DEFAULT_DEV_SERVER_PORTS, getDevServerConfigPath } from './devServerPorts';\n\n/**\n * What the generated bootstrap does: serve forever, run pending migrations once and exit, or\n * both in turn (the docker image, where nothing else ever deploys and so nothing else would\n * run the migrations).\n */\nexport type DevServerEntryMode = 'serve' | 'migrate' | 'migrate-then-serve';\n\n/** Env vars the docker image sets so the running server knows how the outside world reaches it. */\nexport const DEV_SERVER_PUBLIC_HOST_ENV = 'QPQ_PUBLIC_HOST';\nexport const DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV = 'QPQ_PUBLIC_FILE_STORAGE_PORT';\n\nconst USER_SCRIPT_CHILD_ENTRY_FILE_NAME = 'user-script-child.entry.ts';\n\nconst ENTRY_FILE_NAMES: Record<DevServerEntryMode, string> = {\n  serve: 'entry.ts',\n  migrate: 'migrate.entry.ts',\n  'migrate-then-serve': 'entry.ts',\n};\n\nconst reportMigrations = `(ran) => {\n    const total = Object.values(ran).reduce((sum, keys) => sum + keys.length, 0);\n    for (const [service, keys] of Object.entries(ran)) {\n      for (const key of keys) {\n        console.log(\\` [\\${service}] \\${key}\\`);\n      }\n    }\n    console.log(total === 0 ? 'No pending migrations.' : \\`Ran \\${total} migration(s).\\`);\n  }`;\n\nconst getRunCall = (mode: DevServerEntryMode): string => {\n  if (mode === 'serve') {\n    return 'startDevServer(devServerConfig, devServerConfigOverrides);';\n  }\n\n  const afterMigrations = mode === 'migrate' ? 'process.exit(0);' : 'return startDevServer(devServerConfig, devServerConfigOverrides);';\n\n  return `runMigrations(devServerConfig, devServerConfigOverrides)\n  .then(${reportMigrations})\n  .then(() => {\n    ${afterMigrations}\n  })\n  .catch((error) => {\n    console.error('Migration failed:', error);\n    // Non-zero so CI, shell chains and a container restart policy actually notice.\n    process.exit(1);\n  });`;\n};\n\n/**\n * Writes the dev-server bootstrap for an app and returns its path. Generated per build so it\n * can import the optional app-owned overrides file (apps/<app>/devServer.config.ts) and the\n * `quidproquo-dynamic-loader` virtual module QpqPlugin injects at bundle time. Every mode\n * shares one bundle shape, so a local migration run rehearses exactly the deployed path.\n */\nexport const writeDevServerEntry = (root: string, appName: string, mode: DevServerEntryMode = 'serve'): string => {\n  const entryDir = path.join(root, 'dist', 'qpq', 'dev-server');\n  const entryPath = path.join(entryDir, ENTRY_FILE_NAMES[mode]);\n\n  const overridesPath = getDevServerConfigPath(appName);\n  const overridesImport = fs.existsSync(overridesPath)\n    ? `import devServerConfigOverrides from ${JSON.stringify(overridesPath.replace(/\\.ts$/, ''))};`\n    : 'const devServerConfigOverrides = {};';\n\n  const imports = mode === 'serve' ? 'startDevServer' : mode === 'migrate' ? 'runMigrations' : 'runMigrations, startDevServer';\n\n  fs.mkdirSync(entryDir, { recursive: true });\n  fs.writeFileSync(\n    entryPath,\n    `// GENERATED by qpq — do not edit.\nimport { ${imports} } from '@qpqjs/dev-server';\nimport path from 'path';\nimport {\n  qpqConfigs,\n  qpqDynamicModuleLoaderForService,\n  // @ts-ignore - Special build-time virtual module\n} from 'quidproquo-dynamic-loader';\n\n${overridesImport}\n\n// Ports are defaults here; the app's devServer.config.ts \\`ports\\` win when the server resolves its config.\nconst devServerConfig = {\n  serverDomain: 'localhost',\n  serverPort: ${DEFAULT_DEV_SERVER_PORTS.api},\n  webSocketPort: ${DEFAULT_DEV_SERVER_PORTS.webSocket},\n  // Scoped per app so running the dev server for two apps out of the same\n  // repo root doesn't share kvs/file-storage/config state.\n  runtimePath: ${JSON.stringify(path.join('.qpq-runtime', appName))},\n  fileStorageConfig: {\n    // Secure file urls are absolute, so a container has to be told the address browsers use.\n    secureUrlHost: process.env.${DEV_SERVER_PUBLIC_HOST_ENV} || 'localhost',\n    secureUrlPort: ${DEFAULT_DEV_SERVER_PORTS.fileStorage},\n    secureUrlPublicPort: Number(process.env.${DEV_SERVER_PUBLIC_FILE_STORAGE_PORT_ENV}) || undefined,\n    // No fixed secret: the server mints a random one per process, so a secure url token\n    // (which names a filesystem path) cannot be forged by anyone who has read this file.\n  },\n  qpqConfigs,\n  dynamicModuleLoader: qpqDynamicModuleLoaderForService,\n  // The user-script child bundle is built beside this one (see writeUserScriptChildEntry).\n  userScriptChildModulePath: path.join(path.dirname(process.argv[1]), ${JSON.stringify(`${USER_SCRIPT_CHILD_BUNDLE_NAME}.js`)}),\n  // QPQ_WEB_ROOT (set in the docker platform image) turns on static web serving.\n  webRoot: process.env.QPQ_WEB_ROOT,\n  logServiceName: 'admin',\n  delay: { default: 0 },\n};\n\n${getRunCall(mode)}\n`,\n  );\n\n  return entryPath;\n};\n\n/**\n * Writes the dev server's user-script child entry and returns its path. The server forks the\n * bundle this becomes once per script call, with the service name as its argument; the child\n * serves that one call with the service's config and module loader, then exits.\n */\nexport const writeUserScriptChildEntry = (root: string): string => {\n  const entryDir = path.join(root, 'dist', 'qpq', 'dev-server');\n  const entryPath = path.join(entryDir, USER_SCRIPT_CHILD_ENTRY_FILE_NAME);\n\n  fs.mkdirSync(entryDir, { recursive: true });\n  fs.writeFileSync(\n    entryPath,\n    `// GENERATED by qpq — do not edit.\nimport { qpqCoreUtils } from '@qpqjs/core';\nimport { runUserScriptChildMain } from '@qpqjs/actionprocessor-node';\nimport {\n  qpqConfigs,\n  qpqDynamicModuleLoaderForService,\n  // @ts-ignore - Special build-time virtual module\n} from 'quidproquo-dynamic-loader';\n\nexport const main = (): void => {\n  const serviceName = process.argv[2];\n  const qpqConfig = qpqConfigs.find((config) => qpqCoreUtils.getApplicationModuleName(config) === serviceName);\n  if (!qpqConfig) {\n    throw new Error(\\`User script child: no service named [\\${serviceName}]\\`);\n  }\n\n  runUserScriptChildMain(qpqConfig, (runtime) => qpqDynamicModuleLoaderForService(serviceName, runtime));\n};\n\nmain();\n`,\n  );\n\n  return entryPath;\n};\n"]}

package/lib/commonjs/lib/devServerPorts.d.ts

@@ -0,0 +1,13 @@
+import { DevServerPorts } from '@qpqjs/dev-server';
+/** Every dev server listener, with the app's overrides applied. */
+export type ResolvedDevServerPorts = Required<DevServerPorts>;
+/** The ports a dev server listens on when the app sets none: api + static web, websockets, file storage secure urls. */
+export declare const DEFAULT_DEV_SERVER_PORTS: ResolvedDevServerPorts;
+/** Path of the app's optional dev server settings module (`apps/<app>/devServer.config.ts`). */
+export declare const getDevServerConfigPath: (appName: string) => string;
+/**
+ * The app's dev server ports: `ports` from apps/<app>/devServer.config.ts over the defaults. The
+ * same numbers the running server resolves, so builds that bake or expose ports agree with it.
+ * Requiring the TS module relies on the caller running with TS require hooks, as every command does.
+ */
+export declare const readDevServerPorts: (appName: string) => ResolvedDevServerPorts;

package/lib/commonjs/lib/devServerPorts.js

@@ -0,0 +1,36 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readDevServerPorts = exports.getDevServerConfigPath = exports.DEFAULT_DEV_SERVER_PORTS = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const discovery_1 = require("./discovery");
+/** The ports a dev server listens on when the app sets none: api + static web, websockets, file storage secure urls. */
+exports.DEFAULT_DEV_SERVER_PORTS = {
+    api: 8080,
+    webSocket: 8888,
+    fileStorage: 3001,
+};
+/** Path of the app's optional dev server settings module (`apps/<app>/devServer.config.ts`). */
+const getDevServerConfigPath = (appName) => path_1.default.join((0, discovery_1.getAppDirectory)(appName), 'devServer.config.ts');
+exports.getDevServerConfigPath = getDevServerConfigPath;
+/**
+ * The app's dev server ports: `ports` from apps/<app>/devServer.config.ts over the defaults. The
+ * same numbers the running server resolves, so builds that bake or expose ports agree with it.
+ * Requiring the TS module relies on the caller running with TS require hooks, as every command does.
+ */
+const readDevServerPorts = (appName) => {
+    var _a;
+    const configPath = (0, exports.getDevServerConfigPath)(appName);
+    if (!fs_1.default.existsSync(configPath)) {
+        return exports.DEFAULT_DEV_SERVER_PORTS;
+    }
+    // eslint-disable-next-line @typescript-eslint/no-require-imports
+    const loaded = require(configPath.replace(/\.ts$/, ''));
+    const overrides = ((_a = loaded.default) !== null && _a !== void 0 ? _a : loaded);
+    return Object.assign(Object.assign({}, exports.DEFAULT_DEV_SERVER_PORTS), overrides.ports);
+};
+exports.readDevServerPorts = readDevServerPorts;
+//# sourceMappingURL=devServerPorts.js.map

package/lib/commonjs/lib/devServerPorts.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"devServerPorts.js","sourceRoot":"","sources":["../../../src/lib/devServerPorts.ts"],"names":[],"mappings":";;;;;;AAEA,4CAAoB;AACpB,gDAAwB;AAExB,2CAA8C;AAK9C,wHAAwH;AAC3G,QAAA,wBAAwB,GAA2B;IAC9D,GAAG,EAAE,IAAI;IACT,SAAS,EAAE,IAAI;IACf,WAAW,EAAE,IAAI;CAClB,CAAC;AAEF,gGAAgG;AACzF,MAAM,sBAAsB,GAAG,CAAC,OAAe,EAAU,EAAE,CAAC,cAAI,CAAC,IAAI,CAAC,IAAA,2BAAe,EAAC,OAAO,CAAC,EAAE,qBAAqB,CAAC,CAAC;AAAjH,QAAA,sBAAsB,0BAA2F;AAE9H;;;;GAIG;AACI,MAAM,kBAAkB,GAAG,CAAC,OAAe,EAA0B,EAAE;;IAC5E,MAAM,UAAU,GAAG,IAAA,8BAAsB,EAAC,OAAO,CAAC,CAAC;IACnD,IAAI,CAAC,YAAE,CAAC,UAAU,CAAC,UAAU,CAAC,EAAE,CAAC;QAC/B,OAAO,gCAAwB,CAAC;IAClC,CAAC;IAED,iEAAiE;IACjE,MAAM,MAAM,GAAG,OAAO,CAAC,UAAU,CAAC,OAAO,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,CAAC;IACxD,MAAM,SAAS,GAAG,CAAC,MAAA,MAAM,CAAC,OAAO,mCAAI,MAAM,CAA6B,CAAC;IAEzE,uCAAY,gCAAwB,GAAK,SAAS,CAAC,KAAK,EAAG;AAC7D,CAAC,CAAC;AAXW,QAAA,kBAAkB,sBAW7B","sourcesContent":["import { DevServerConfigOverrides, DevServerPorts } from '@qpqjs/dev-server';\n\nimport fs from 'fs';\nimport path from 'path';\n\nimport { getAppDirectory } from './discovery';\n\n/** Every dev server listener, with the app's overrides applied. */\nexport type ResolvedDevServerPorts = Required<DevServerPorts>;\n\n/** The ports a dev server listens on when the app sets none: api + static web, websockets, file storage secure urls. */\nexport const DEFAULT_DEV_SERVER_PORTS: ResolvedDevServerPorts = {\n  api: 8080,\n  webSocket: 8888,\n  fileStorage: 3001,\n};\n\n/** Path of the app's optional dev server settings module (`apps/<app>/devServer.config.ts`). */\nexport const getDevServerConfigPath = (appName: string): string => path.join(getAppDirectory(appName), 'devServer.config.ts');\n\n/**\n * The app's dev server ports: `ports` from apps/<app>/devServer.config.ts over the defaults. The\n * same numbers the running server resolves, so builds that bake or expose ports agree with it.\n * Requiring the TS module relies on the caller running with TS require hooks, as every command does.\n */\nexport const readDevServerPorts = (appName: string): ResolvedDevServerPorts => {\n  const configPath = getDevServerConfigPath(appName);\n  if (!fs.existsSync(configPath)) {\n    return DEFAULT_DEV_SERVER_PORTS;\n  }\n\n  // eslint-disable-next-line @typescript-eslint/no-require-imports\n  const loaded = require(configPath.replace(/\\.ts$/, ''));\n  const overrides = (loaded.default ?? loaded) as DevServerConfigOverrides;\n\n  return { ...DEFAULT_DEV_SERVER_PORTS, ...overrides.ports };\n};\n"]}

package/lib/commonjs/lib/discovery.d.ts

@@ -0,0 +1,10 @@
+export declare const getRoot: () => string;
+export declare const getAppsDirectory: () => string;
+export declare const getAppDirectory: (appName: string) => string;
+export declare const getServiceDirectory: (appName: string, service: string) => string;
+export declare const getAvailableApps: () => string[];
+export declare const getAllServiceNames: (appName: string) => string[];
+export declare const serviceHasSubdir: (appName: string, service: string, subdir: string) => boolean;
+export declare const getServiceNamesWithSubdir: (appName: string, subdir: string) => string[];
+export declare const getServiceNames: (appName: string) => string[];
+export declare const getServiceNamesWithViews: (appName: string) => string[];

package/lib/commonjs/lib/discovery.js

@@ -0,0 +1,56 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getServiceNamesWithViews = exports.getServiceNames = exports.getServiceNamesWithSubdir = exports.serviceHasSubdir = exports.getAllServiceNames = exports.getAvailableApps = exports.getServiceDirectory = exports.getAppDirectory = exports.getAppsDirectory = exports.getRoot = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+// The consumer repo root — qpq always runs from the workspace root (npm
+// scripts set cwd there).
+const getRoot = () => process.cwd();
+exports.getRoot = getRoot;
+const getAppsDirectory = () => path_1.default.join((0, exports.getRoot)(), 'apps');
+exports.getAppsDirectory = getAppsDirectory;
+const getAppDirectory = (appName) => path_1.default.join((0, exports.getAppsDirectory)(), appName);
+exports.getAppDirectory = getAppDirectory;
+const getServiceDirectory = (appName, service) => path_1.default.join((0, exports.getAppDirectory)(appName), 'services', service);
+exports.getServiceDirectory = getServiceDirectory;
+// Apps are the directories under apps/ that contain a services/ directory.
+const getAvailableApps = () => {
+    const appsPath = (0, exports.getAppsDirectory)();
+    if (!fs_1.default.existsSync(appsPath)) {
+        return [];
+    }
+    return fs_1.default.readdirSync(appsPath).filter((name) => {
+        const servicesPath = path_1.default.join((0, exports.getAppDirectory)(name), 'services');
+        return fs_1.default.statSync((0, exports.getAppDirectory)(name)).isDirectory() && fs_1.default.existsSync(servicesPath) && fs_1.default.statSync(servicesPath).isDirectory();
+    });
+};
+exports.getAvailableApps = getAvailableApps;
+// Every service directory under an app's services/ folder (no subdir filter).
+const getAllServiceNames = (appName) => {
+    const directoryPath = path_1.default.join((0, exports.getAppDirectory)(appName), 'services');
+    if (!fs_1.default.existsSync(directoryPath)) {
+        return [];
+    }
+    return fs_1.default.readdirSync(directoryPath).filter((name) => fs_1.default.statSync((0, exports.getServiceDirectory)(appName, name)).isDirectory());
+};
+exports.getAllServiceNames = getAllServiceNames;
+// True when a service contains the given child directory (e.g. 'service' for a
+// backend, 'views' for a frontend).
+const serviceHasSubdir = (appName, service, subdir) => {
+    const subdirPath = path_1.default.join((0, exports.getServiceDirectory)(appName, service), subdir);
+    return fs_1.default.existsSync(subdirPath) && fs_1.default.statSync(subdirPath).isDirectory();
+};
+exports.serviceHasSubdir = serviceHasSubdir;
+// Services that contain a given child directory.
+const getServiceNamesWithSubdir = (appName, subdir) => (0, exports.getAllServiceNames)(appName).filter((service) => (0, exports.serviceHasSubdir)(appName, service, subdir));
+exports.getServiceNamesWithSubdir = getServiceNamesWithSubdir;
+// Backend services — those with a service/ subdir.
+const getServiceNames = (appName) => (0, exports.getServiceNamesWithSubdir)(appName, 'service');
+exports.getServiceNames = getServiceNames;
+// Backend services that also ship a frontend (views/ subdir).
+const getServiceNamesWithViews = (appName) => (0, exports.getServiceNames)(appName).filter((service) => (0, exports.serviceHasSubdir)(appName, service, 'views'));
+exports.getServiceNamesWithViews = getServiceNamesWithViews;
+//# sourceMappingURL=discovery.js.map

package/lib/commonjs/lib/discovery.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"discovery.js","sourceRoot":"","sources":["../../../src/lib/discovery.ts"],"names":[],"mappings":"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","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\n// The consumer repo root — qpq always runs from the workspace root (npm\n// scripts set cwd there).\nexport const getRoot = (): string => process.cwd();\n\nexport const getAppsDirectory = (): string => path.join(getRoot(), 'apps');\nexport const getAppDirectory = (appName: string): string => path.join(getAppsDirectory(), appName);\nexport const getServiceDirectory = (appName: string, service: string): string => path.join(getAppDirectory(appName), 'services', service);\n\n// Apps are the directories under apps/ that contain a services/ directory.\nexport const getAvailableApps = (): string[] => {\n  const appsPath = getAppsDirectory();\n\n  if (!fs.existsSync(appsPath)) {\n    return [];\n  }\n\n  return fs.readdirSync(appsPath).filter((name) => {\n    const servicesPath = path.join(getAppDirectory(name), 'services');\n    return fs.statSync(getAppDirectory(name)).isDirectory() && fs.existsSync(servicesPath) && fs.statSync(servicesPath).isDirectory();\n  });\n};\n\n// Every service directory under an app's services/ folder (no subdir filter).\nexport const getAllServiceNames = (appName: string): string[] => {\n  const directoryPath = path.join(getAppDirectory(appName), 'services');\n\n  if (!fs.existsSync(directoryPath)) {\n    return [];\n  }\n\n  return fs.readdirSync(directoryPath).filter((name) => fs.statSync(getServiceDirectory(appName, name)).isDirectory());\n};\n\n// True when a service contains the given child directory (e.g. 'service' for a\n// backend, 'views' for a frontend).\nexport const serviceHasSubdir = (appName: string, service: string, subdir: string): boolean => {\n  const subdirPath = path.join(getServiceDirectory(appName, service), subdir);\n  return fs.existsSync(subdirPath) && fs.statSync(subdirPath).isDirectory();\n};\n\n// Services that contain a given child directory.\nexport const getServiceNamesWithSubdir = (appName: string, subdir: string): string[] =>\n  getAllServiceNames(appName).filter((service) => serviceHasSubdir(appName, service, subdir));\n\n// Backend services — those with a service/ subdir.\nexport const getServiceNames = (appName: string): string[] => getServiceNamesWithSubdir(appName, 'service');\n\n// Backend services that also ship a frontend (views/ subdir).\nexport const getServiceNamesWithViews = (appName: string): string[] =>\n  getServiceNames(appName).filter((service) => serviceHasSubdir(appName, service, 'views'));\n"]}

package/lib/commonjs/lib/getDefaultHookJobs.d.ts

@@ -0,0 +1,2 @@
+/** How many package scripts a hook run starts at once: a core left for the rest of the machine, capped so a wide dependency level doesn't stack up too many npm processes. */
+export declare const getDefaultHookJobs: () => number;

package/lib/commonjs/lib/getDefaultHookJobs.js

@@ -0,0 +1,11 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDefaultHookJobs = void 0;
+const os_1 = __importDefault(require("os"));
+/** How many package scripts a hook run starts at once: a core left for the rest of the machine, capped so a wide dependency level doesn't stack up too many npm processes. */
+const getDefaultHookJobs = () => Math.max(1, Math.min(8, os_1.default.availableParallelism() - 1));
+exports.getDefaultHookJobs = getDefaultHookJobs;
+//# sourceMappingURL=getDefaultHookJobs.js.map

package/lib/commonjs/lib/getDefaultHookJobs.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDefaultHookJobs.js","sourceRoot":"","sources":["../../../src/lib/getDefaultHookJobs.ts"],"names":[],"mappings":";;;;;;AAAA,4CAAoB;AAEpB,8KAA8K;AACvK,MAAM,kBAAkB,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,YAAE,CAAC,oBAAoB,EAAE,GAAG,CAAC,CAAC,CAAC,CAAC;AAA3F,QAAA,kBAAkB,sBAAyE","sourcesContent":["import os from 'os';\n\n/** How many package scripts a hook run starts at once: a core left for the rest of the machine, capped so a wide dependency level doesn't stack up too many npm processes. */\nexport const getDefaultHookJobs = (): number => Math.max(1, Math.min(8, os.availableParallelism() - 1));\n"]}

package/lib/commonjs/lib/getDeployTargetLabel.d.ts

@@ -0,0 +1,2 @@
+/** The resolved deployment as a human label for confirmations, e.g. `production (example-production)`. */
+export declare const getDeployTargetLabel: () => string;

package/lib/commonjs/lib/getDeployTargetLabel.js

@@ -0,0 +1,12 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getDeployTargetLabel = void 0;
+const core_1 = require("@qpqjs/core");
+/** The resolved deployment as a human label for confirmations, e.g. `production (example-production)`. */
+const getDeployTargetLabel = () => {
+    const env = process.env;
+    const identity = [env[core_1.QpqDeployEnvVar.applicationName], env[core_1.QpqDeployEnvVar.environment], env[core_1.QpqDeployEnvVar.featureName]].filter(Boolean).join('-');
+    return `${env[core_1.QpqDeployEnvVar.deployName]} (${identity})`;
+};
+exports.getDeployTargetLabel = getDeployTargetLabel;
+//# sourceMappingURL=getDeployTargetLabel.js.map

package/lib/commonjs/lib/getDeployTargetLabel.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"getDeployTargetLabel.js","sourceRoot":"","sources":["../../../src/lib/getDeployTargetLabel.ts"],"names":[],"mappings":";;;AAAA,sCAA8C;AAE9C,0GAA0G;AACnG,MAAM,oBAAoB,GAAG,GAAW,EAAE;IAC/C,MAAM,GAAG,GAAG,OAAO,CAAC,GAAG,CAAC;IACxB,MAAM,QAAQ,GAAG,CAAC,GAAG,CAAC,sBAAe,CAAC,eAAe,CAAC,EAAE,GAAG,CAAC,sBAAe,CAAC,WAAW,CAAC,EAAE,GAAG,CAAC,sBAAe,CAAC,WAAW,CAAC,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;IACtJ,OAAO,GAAG,GAAG,CAAC,sBAAe,CAAC,UAAU,CAAC,KAAK,QAAQ,GAAG,CAAC;AAC5D,CAAC,CAAC;AAJW,QAAA,oBAAoB,wBAI/B","sourcesContent":["import { QpqDeployEnvVar } from '@qpqjs/core';\n\n/** The resolved deployment as a human label for confirmations, e.g. `production (example-production)`. */\nexport const getDeployTargetLabel = (): string => {\n  const env = process.env;\n  const identity = [env[QpqDeployEnvVar.applicationName], env[QpqDeployEnvVar.environment], env[QpqDeployEnvVar.featureName]].filter(Boolean).join('-');\n  return `${env[QpqDeployEnvVar.deployName]} (${identity})`;\n};\n"]}

package/lib/commonjs/lib/goDockerMode.d.ts

@@ -0,0 +1,6 @@
+/** Which half of `qpq go:docker` a run performs: both, the build and save, or the deploy from a saved build. */
+export type GoDockerMode = 'full' | 'build-only' | 'from-build';
+export declare const BUILD_ONLY_FLAG = "--build-only";
+export declare const FROM_BUILD_FLAG = "--from-build";
+/** Reads the mode off the command's argv. Throws when both flags are given, since one run cannot be both halves. */
+export declare const resolveGoDockerMode: (argv: string[]) => GoDockerMode;

package/lib/commonjs/lib/goDockerMode.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.resolveGoDockerMode = exports.FROM_BUILD_FLAG = exports.BUILD_ONLY_FLAG = void 0;
+const args_1 = require("./args");
+exports.BUILD_ONLY_FLAG = '--build-only';
+exports.FROM_BUILD_FLAG = '--from-build';
+/** Reads the mode off the command's argv. Throws when both flags are given, since one run cannot be both halves. */
+const resolveGoDockerMode = (argv) => {
+    const buildOnly = (0, args_1.hasArgFlag)(argv, exports.BUILD_ONLY_FLAG);
+    const fromBuild = (0, args_1.hasArgFlag)(argv, exports.FROM_BUILD_FLAG);
+    if (buildOnly && fromBuild) {
+        throw new Error(`${exports.BUILD_ONLY_FLAG} and ${exports.FROM_BUILD_FLAG} are exclusive: build on one run, deploy on another`);
+    }
+    if (buildOnly) {
+        return 'build-only';
+    }
+    if (fromBuild) {
+        return 'from-build';
+    }
+    return 'full';
+};
+exports.resolveGoDockerMode = resolveGoDockerMode;
+//# sourceMappingURL=goDockerMode.js.map

package/lib/commonjs/lib/goDockerMode.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"goDockerMode.js","sourceRoot":"","sources":["../../../src/lib/goDockerMode.ts"],"names":[],"mappings":";;;AAAA,iCAAoC;AAKvB,QAAA,eAAe,GAAG,cAAc,CAAC;AACjC,QAAA,eAAe,GAAG,cAAc,CAAC;AAE9C,oHAAoH;AAC7G,MAAM,mBAAmB,GAAG,CAAC,IAAc,EAAgB,EAAE;IAClE,MAAM,SAAS,GAAG,IAAA,iBAAU,EAAC,IAAI,EAAE,uBAAe,CAAC,CAAC;IACpD,MAAM,SAAS,GAAG,IAAA,iBAAU,EAAC,IAAI,EAAE,uBAAe,CAAC,CAAC;IAEpD,IAAI,SAAS,IAAI,SAAS,EAAE,CAAC;QAC3B,MAAM,IAAI,KAAK,CAAC,GAAG,uBAAe,QAAQ,uBAAe,qDAAqD,CAAC,CAAC;IAClH,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,IAAI,SAAS,EAAE,CAAC;QACd,OAAO,YAAY,CAAC;IACtB,CAAC;IACD,OAAO,MAAM,CAAC;AAChB,CAAC,CAAC;AAdW,QAAA,mBAAmB,uBAc9B","sourcesContent":["import { hasArgFlag } from './args';\n\n/** Which half of `qpq go:docker` a run performs: both, the build and save, or the deploy from a saved build. */\nexport type GoDockerMode = 'full' | 'build-only' | 'from-build';\n\nexport const BUILD_ONLY_FLAG = '--build-only';\nexport const FROM_BUILD_FLAG = '--from-build';\n\n/** Reads the mode off the command's argv. Throws when both flags are given, since one run cannot be both halves. */\nexport const resolveGoDockerMode = (argv: string[]): GoDockerMode => {\n  const buildOnly = hasArgFlag(argv, BUILD_ONLY_FLAG);\n  const fromBuild = hasArgFlag(argv, FROM_BUILD_FLAG);\n\n  if (buildOnly && fromBuild) {\n    throw new Error(`${BUILD_ONLY_FLAG} and ${FROM_BUILD_FLAG} are exclusive: build on one run, deploy on another`);\n  }\n  if (buildOnly) {\n    return 'build-only';\n  }\n  if (fromBuild) {\n    return 'from-build';\n  }\n  return 'full';\n};\n"]}

package/lib/commonjs/lib/hooks.d.ts

@@ -0,0 +1,9 @@
+import { TaskFailure } from './runTasks';
+export declare const runAppHook: (appName: string, hook: string) => Promise<boolean>;
+/** Runs a hook in every app and workspace package that defines it. Returns the failures; callers decide fatality. */
+export declare const runHookForAllPackages: (hook: string, jobs: number) => Promise<TaskFailure[]>;
+/**
+ * Runs a hook in one app's packages, the shared packages outside apps/, and anything those depend on.
+ * Other apps' packages are skipped. Returns the failures; callers decide fatality.
+ */
+export declare const runHookForAppPackages: (hook: string, appName: string, jobs: number) => Promise<TaskFailure[]>;

package/lib/commonjs/lib/hooks.js

@@ -0,0 +1,178 @@
+"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.runHookForAppPackages = exports.runHookForAllPackages = exports.runAppHook = void 0;
+const fs_1 = __importDefault(require("fs"));
+const path_1 = __importDefault(require("path"));
+const discovery_1 = require("./discovery");
+const runCommand_1 = require("./runCommand");
+const runTasks_1 = require("./runTasks");
+// App lifecycle hooks: apps/<app>/package.json scripts named `qpq:<hook>`
+// (e.g. qpq:postinstall, qpq:prebuild). The CLI invokes them when present;
+// apps without the hook are skipped silently.
+const runAppHook = (appName, hook) => __awaiter(void 0, void 0, void 0, function* () {
+    var _a;
+    const packageJsonPath = path_1.default.join((0, discovery_1.getAppDirectory)(appName), 'package.json');
+    if (!fs_1.default.existsSync(packageJsonPath)) {
+        return false;
+    }
+    const packageJson = JSON.parse(fs_1.default.readFileSync(packageJsonPath, 'utf-8'));
+    const scriptName = `qpq:${hook}`;
+    if (!((_a = packageJson.scripts) === null || _a === void 0 ? void 0 : _a[scriptName])) {
+        return false;
+    }
+    console.log(`Running ${scriptName} for [${appName}]`);
+    yield (0, runCommand_1.runCommand)('npm', ['run', scriptName], { cwd: (0, discovery_1.getAppDirectory)(appName) });
+    return true;
+});
+exports.runAppHook = runAppHook;
+const isDirectory = (candidate) => fs_1.default.existsSync(candidate) && fs_1.default.statSync(candidate).isDirectory();
+const listSubdirectories = (dir) => {
+    if (!isDirectory(dir)) {
+        return [];
+    }
+    return fs_1.default
+        .readdirSync(dir)
+        .map((name) => path_1.default.join(dir, name))
+        .filter(isDirectory);
+};
+// Expand one `workspaces` glob. Only literal segments and bare `*` are
+// supported, which covers the patterns qpq repos use (e.g.
+// "apps/*/services/*/models"); anything fancier ("**", braces) matches nothing.
+const expandWorkspacePattern = (root, pattern) => {
+    let dirs = [root];
+    for (const segment of pattern.split('/')) {
+        if (segment === '*') {
+            dirs = dirs.flatMap(listSubdirectories);
+        }
+        else {
+            dirs = dirs.map((dir) => path_1.default.join(dir, segment)).filter(isDirectory);
+        }
+    }
+    return dirs;
+};
+const readPackageJson = (dir) => {
+    const packageJsonPath = path_1.default.join(dir, 'package.json');
+    if (!fs_1.default.existsSync(packageJsonPath)) {
+        return undefined;
+    }
+    return JSON.parse(fs_1.default.readFileSync(packageJsonPath, 'utf-8'));
+};
+// Every directory that can carry hooks: app dirs plus all workspace packages,
+// deduped (an app dir could itself be a workspace).
+const getHookPackages = () => {
+    var _a, _b;
+    const root = (0, discovery_1.getRoot)();
+    const rootPkg = readPackageJson(root);
+    const appDirs = (0, discovery_1.getAvailableApps)().map((appName) => ({ dir: (0, discovery_1.getAppDirectory)(appName), fallbackLabel: appName }));
+    const workspaceDirs = ((_a = rootPkg === null || rootPkg === void 0 ? void 0 : rootPkg.workspaces) !== null && _a !== void 0 ? _a : [])
+        .flatMap((pattern) => expandWorkspacePattern(root, pattern))
+        .map((dir) => ({ dir, fallbackLabel: path_1.default.relative(root, dir) }));
+    const packages = [];
+    const seen = new Set();
+    for (const { dir, fallbackLabel } of [...appDirs, ...workspaceDirs]) {
+        const resolved = path_1.default.resolve(dir);
+        if (seen.has(resolved)) {
+            continue;
+        }
+        seen.add(resolved);
+        const pkg = readPackageJson(dir);
+        if (pkg) {
+            packages.push({ dir, label: (_b = pkg.name) !== null && _b !== void 0 ? _b : fallbackLabel, pkg });
+        }
+    }
+    return packages;
+};
+// The script a hook resolves to in one package: `qpq:<hook>` when defined,
+// otherwise the plain `<hook>` script. Empty-string scripts count as absent.
+const resolveHookScript = (pkg, hook) => {
+    var _a, _b;
+    if ((_a = pkg.scripts) === null || _a === void 0 ? void 0 : _a[`qpq:${hook}`]) {
+        return `qpq:${hook}`;
+    }
+    if ((_b = pkg.scripts) === null || _b === void 0 ? void 0 : _b[hook]) {
+        return hook;
+    }
+    return undefined;
+};
+const getDeclaredDependencyNames = (pkg) => Object.keys(Object.assign(Object.assign(Object.assign({}, pkg.dependencies), pkg.devDependencies), pkg.peerDependencies));
+// True for a package inside apps/<some other app>/. Packages outside apps/
+// are shared, so they never count as another app's.
+const isOtherAppPackage = (dir, appName) => {
+    const relative = path_1.default.relative((0, discovery_1.getAppsDirectory)(), path_1.default.resolve(dir));
+    if (relative === '' || relative.startsWith('..') || path_1.default.isAbsolute(relative)) {
+        return false;
+    }
+    return relative.split(path_1.default.sep)[0] !== appName;
+};
+// The app's own packages and the shared ones, plus every package they depend
+// on wherever it lives, so a cross-app dependency still gets built.
+const getAppHookPackages = (appName) => {
+    const allPackages = getHookPackages();
+    const byName = new Map();
+    for (const hookPackage of allPackages) {
+        if (hookPackage.pkg.name) {
+            byName.set(hookPackage.pkg.name, hookPackage);
+        }
+    }
+    const selected = new Set(allPackages.filter((hookPackage) => !isOtherAppPackage(hookPackage.dir, appName)));
+    const pending = [...selected];
+    for (let current = pending.pop(); current; current = pending.pop()) {
+        for (const depName of getDeclaredDependencyNames(current.pkg)) {
+            const dep = byName.get(depName);
+            if (dep && !selected.has(dep)) {
+                selected.add(dep);
+                pending.push(dep);
+            }
+        }
+    }
+    return allPackages.filter((hookPackage) => selected.has(hookPackage));
+};
+// Run the hook's script in each of `candidates` that defines it (qpq:<hook>
+// preferred over a plain <hook> script), in dependency order (declared deps
+// resolved by package name), with up to `jobs` running concurrently. Packages
+// whose dependencies aren't part of this run don't wait on them.
+const runHookForPackages = (candidates, hook, jobs) => __awaiter(void 0, void 0, void 0, function* () {
+    const hookPackages = candidates
+        .map((candidate) => (Object.assign(Object.assign({}, candidate), { scriptName: resolveHookScript(candidate.pkg, hook) })))
+        .filter((candidate) => candidate.scriptName !== undefined);
+    if (hookPackages.length === 0) {
+        console.log(`No app or workspace package defines a "qpq:${hook}" or "${hook}" script, nothing to run.`);
+        return [];
+    }
+    // Dependency edges only count between packages that are part of this run:
+    // a dep that doesn't define the hook has nothing to wait for.
+    const runSetNames = new Set(hookPackages.map((hookPackage) => hookPackage.pkg.name).filter(Boolean));
+    const tasks = hookPackages.map((hookPackage) => {
+        var _a;
+        return ({
+            id: (_a = hookPackage.pkg.name) !== null && _a !== void 0 ? _a : hookPackage.dir,
+            label: hookPackage.label,
+            deps: getDeclaredDependencyNames(hookPackage.pkg).filter((name) => runSetNames.has(name) && name !== hookPackage.pkg.name),
+            run: () => (0, runCommand_1.runCommandPrefixed)(hookPackage.label, 'npm', ['run', hookPackage.scriptName], { cwd: hookPackage.dir, color: (0, runCommand_1.nextPrefixColor)() }),
+        });
+    });
+    console.log(`Running ${hook} hooks in ${tasks.length} package(s) (${jobs} jobs, dependency ordered)`);
+    return (0, runTasks_1.runDependencyTasks)(tasks, jobs);
+});
+/** Runs a hook in every app and workspace package that defines it. Returns the failures; callers decide fatality. */
+const runHookForAllPackages = (hook, jobs) => runHookForPackages(getHookPackages(), hook, jobs);
+exports.runHookForAllPackages = runHookForAllPackages;
+/**
+ * Runs a hook in one app's packages, the shared packages outside apps/, and anything those depend on.
+ * Other apps' packages are skipped. Returns the failures; callers decide fatality.
+ */
+const runHookForAppPackages = (hook, appName, jobs) => runHookForPackages(getAppHookPackages(appName), hook, jobs);
+exports.runHookForAppPackages = runHookForAppPackages;
+//# sourceMappingURL=hooks.js.map