@qpqjs/cli 0.0.0-stage → 0.2.0

package/lib/esm/lib/runCommand.js

@@ -0,0 +1,92 @@
+import { spawn } from 'child_process';
+// Spawn a command, inheriting stdio, resolving on success. A non-zero exit
+// REJECTS so a failed build/deploy stops the run.
+export const runCommand = (command, args, options = {}) => new Promise((resolve, reject) => {
+    const validArgs = args.filter((a) => !!a);
+    if (options.logCommand) {
+        console.log(`Running command: ${command} ${validArgs.join(' ')}`);
+    }
+    const child = spawn(command, validArgs, {
+        stdio: 'inherit',
+        // Shell only on Windows (to resolve npm/aws/cdk .cmd shims). On posix, run
+        // without a shell so the already-array args are passed straight to the
+        // program and can't be re-interpreted by `sh -c` — no command injection via
+        // interpolated values (stack names, CI-supplied env, etc.).
+        shell: process.platform === 'win32',
+        cwd: options.cwd ?? process.cwd(),
+        env: { ...process.env, ...(options.env ?? {}) },
+    });
+    child.on('error', (error) => reject(error));
+    child.on('exit', (code, signal) => {
+        if (signal)
+            return reject(new Error(`${command} was killed with signal ${signal}`));
+        if (code)
+            return reject(new Error(`${command} ${validArgs.join(' ')} exited with code ${code}`));
+        return resolve();
+    });
+});
+// Run a command for its side effect only, swallowing both its output and its
+// exit code — for best-effort cleanup steps (e.g. `docker rm -f` of a container
+// that may not exist) that must never fail the run. Without a shell there's no
+// `>/dev/null 2>&1 || true`, so quieting and non-failing happen here instead.
+export const runCommandBestEffort = (command, args, options = {}) => new Promise((resolve) => {
+    const validArgs = args.filter((a) => !!a);
+    const child = spawn(command, validArgs, {
+        stdio: 'ignore',
+        shell: process.platform === 'win32',
+        cwd: options.cwd ?? process.cwd(),
+        env: { ...process.env, ...(options.env ?? {}) },
+    });
+    child.on('error', () => resolve());
+    child.on('exit', () => resolve());
+});
+const PREFIX_COLORS = [36, 32, 33, 35, 34, 96, 92, 93, 95, 94];
+let colorIndex = 0;
+// Hand each concurrent task a distinct prefix color so interleaved output is
+// scannable.
+export const nextPrefixColor = () => {
+    const color = PREFIX_COLORS[colorIndex % PREFIX_COLORS.length];
+    colorIndex += 1;
+    return color;
+};
+// Like runCommand, but pipes output and prefixes every line with a colored
+// [label] — for running many commands concurrently without unreadable
+// interleaving. Rejects on non-zero exit.
+export const runCommandPrefixed = (label, command, args, options = {}) => new Promise((resolve, reject) => {
+    const validArgs = args.filter((a) => !!a);
+    const prefix = `\x1b[${options.color ?? 36}m[${label}]\x1b[0m `;
+    const child = spawn(command, validArgs, {
+        stdio: ['ignore', 'pipe', 'pipe'],
+        // Shell only on Windows (to resolve npm/aws/cdk .cmd shims). On posix, run
+        // without a shell so the already-array args are passed straight to the
+        // program and can't be re-interpreted by `sh -c` — no command injection via
+        // interpolated values (stack names, CI-supplied env, etc.).
+        shell: process.platform === 'win32',
+        cwd: options.cwd ?? process.cwd(),
+        env: { ...process.env, ...(options.env ?? {}) },
+    });
+    const attach = (stream, out) => {
+        let buffered = '';
+        stream.on('data', (chunk) => {
+            buffered += chunk.toString();
+            const lines = buffered.split('\n');
+            buffered = lines.pop() ?? '';
+            lines.forEach((line) => out.write(`${prefix}${line}\n`));
+        });
+        stream.on('end', () => {
+            if (buffered)
+                out.write(`${prefix}${buffered}\n`);
+        });
+    };
+    attach(child.stdout, process.stdout);
+    attach(child.stderr, process.stderr);
+    child.on('error', (error) => reject(error));
+    child.on('exit', (code, signal) => {
+        if (signal)
+            return reject(new Error(`[${label}] ${command} was killed with signal ${signal}`));
+        if (code)
+            return reject(new Error(`[${label}] ${command} exited with code ${code}`));
+        return resolve();
+    });
+});
+//# sourceMappingURL=runCommand.js.map

package/lib/esm/lib/runCommand.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runCommand.js","sourceRoot":"","sources":["../../../src/lib/runCommand.ts"],"names":[],"mappings":"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","sourcesContent":["import { spawn } from 'child_process';\nimport type { Readable } from 'stream';\n\nexport type RunCommandOptions = {\n  // Extra environment variables merged over the parent process env.\n  env?: Record<string, string>;\n  // Working directory for the child (defaults to cwd).\n  cwd?: string;\n  // Echo the command before running it.\n  logCommand?: boolean;\n};\n\n// Spawn a command, inheriting stdio, resolving on success. A non-zero exit\n// REJECTS so a failed build/deploy stops the run.\nexport const runCommand = (command: string, args: string[], options: RunCommandOptions = {}): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const validArgs = args.filter((a) => !!a);\n\n    if (options.logCommand) {\n      console.log(`Running command: ${command} ${validArgs.join(' ')}`);\n    }\n\n    const child = spawn(command, validArgs, {\n      stdio: 'inherit',\n      // Shell only on Windows (to resolve npm/aws/cdk .cmd shims). On posix, run\n      // without a shell so the already-array args are passed straight to the\n      // program and can't be re-interpreted by `sh -c` — no command injection via\n      // interpolated values (stack names, CI-supplied env, etc.).\n      shell: process.platform === 'win32',\n      cwd: options.cwd ?? process.cwd(),\n      env: { ...process.env, ...(options.env ?? {}) },\n    });\n\n    child.on('error', (error) => reject(error));\n\n    child.on('exit', (code, signal) => {\n      if (signal) return reject(new Error(`${command} was killed with signal ${signal}`));\n      if (code) return reject(new Error(`${command} ${validArgs.join(' ')} exited with code ${code}`));\n      return resolve();\n    });\n  });\n\n// Run a command for its side effect only, swallowing both its output and its\n// exit code — for best-effort cleanup steps (e.g. `docker rm -f` of a container\n// that may not exist) that must never fail the run. Without a shell there's no\n// `>/dev/null 2>&1 || true`, so quieting and non-failing happen here instead.\nexport const runCommandBestEffort = (command: string, args: string[], options: RunCommandOptions = {}): Promise<void> =>\n  new Promise((resolve) => {\n    const validArgs = args.filter((a) => !!a);\n\n    const child = spawn(command, validArgs, {\n      stdio: 'ignore',\n      shell: process.platform === 'win32',\n      cwd: options.cwd ?? process.cwd(),\n      env: { ...process.env, ...(options.env ?? {}) },\n    });\n\n    child.on('error', () => resolve());\n    child.on('exit', () => resolve());\n  });\n\nexport type RunCommandPrefixedOptions = {\n  env?: Record<string, string>;\n  cwd?: string;\n  // ANSI color code for the prefix (see nextPrefixColor).\n  color?: number;\n};\n\nconst PREFIX_COLORS = [36, 32, 33, 35, 34, 96, 92, 93, 95, 94];\nlet colorIndex = 0;\n\n// Hand each concurrent task a distinct prefix color so interleaved output is\n// scannable.\nexport const nextPrefixColor = (): number => {\n  const color = PREFIX_COLORS[colorIndex % PREFIX_COLORS.length];\n  colorIndex += 1;\n  return color;\n};\n\n// Like runCommand, but pipes output and prefixes every line with a colored\n// [label] — for running many commands concurrently without unreadable\n// interleaving. Rejects on non-zero exit.\nexport const runCommandPrefixed = (label: string, command: string, args: string[], options: RunCommandPrefixedOptions = {}): Promise<void> =>\n  new Promise((resolve, reject) => {\n    const validArgs = args.filter((a) => !!a);\n    const prefix = `\\x1b[${options.color ?? 36}m[${label}]\\x1b[0m `;\n\n    const child = spawn(command, validArgs, {\n      stdio: ['ignore', 'pipe', 'pipe'],\n      // Shell only on Windows (to resolve npm/aws/cdk .cmd shims). On posix, run\n      // without a shell so the already-array args are passed straight to the\n      // program and can't be re-interpreted by `sh -c` — no command injection via\n      // interpolated values (stack names, CI-supplied env, etc.).\n      shell: process.platform === 'win32',\n      cwd: options.cwd ?? process.cwd(),\n      env: { ...process.env, ...(options.env ?? {}) },\n    });\n\n    const attach = (stream: Readable, out: NodeJS.WriteStream): void => {\n      let buffered = '';\n      stream.on('data', (chunk: Buffer) => {\n        buffered += chunk.toString();\n        const lines = buffered.split('\\n');\n        buffered = lines.pop() ?? '';\n        lines.forEach((line) => out.write(`${prefix}${line}\\n`));\n      });\n      stream.on('end', () => {\n        if (buffered) out.write(`${prefix}${buffered}\\n`);\n      });\n    };\n\n    attach(child.stdout as Readable, process.stdout);\n    attach(child.stderr as Readable, process.stderr);\n\n    child.on('error', (error) => reject(error));\n\n    child.on('exit', (code, signal) => {\n      if (signal) return reject(new Error(`[${label}] ${command} was killed with signal ${signal}`));\n      if (code) return reject(new Error(`[${label}] ${command} exited with code ${code}`));\n      return resolve();\n    });\n  });\n"]}

package/lib/esm/lib/runTasks.d.ts

@@ -0,0 +1,15 @@
+export type Task = {
+    label: string;
+    run: () => Promise<void>;
+};
+export type TaskFailure = {
+    label: string;
+    error: Error;
+};
+export declare const runTasks: (tasks: Task[], limit: number) => Promise<TaskFailure[]>;
+export type DependencyTask = Task & {
+    id: string;
+    deps: string[];
+};
+export declare const runDependencyTasks: (tasks: DependencyTask[], limit: number) => Promise<TaskFailure[]>;
+export declare const assertNoFailures: (phaseName: string, failures: TaskFailure[]) => void;

package/lib/esm/lib/runTasks.js

@@ -0,0 +1,108 @@
+// Run tasks with at most `limit` in flight; never rejects — failures come back
+// labelled so a whole wave can finish before we report what broke.
+export const runTasks = async (tasks, limit) => {
+    const failures = [];
+    let nextIndex = 0;
+    const workerCount = Math.max(1, Math.min(limit, tasks.length));
+    await Promise.all(Array.from({ length: workerCount }, async () => {
+        while (nextIndex < tasks.length) {
+            const task = tasks[nextIndex];
+            nextIndex += 1;
+            try {
+                await task.run();
+            }
+            catch (error) {
+                failures.push({ label: task.label, error: error });
+            }
+        }
+    }));
+    return failures;
+};
+// Run tasks with at most `limit` in flight, but a task only starts once every
+// task in its `deps` has succeeded. A failure doesn't stop unrelated tasks;
+// dependents of the failed task are skipped (logged, not returned as failures,
+// the root cause already is). Never rejects. Tasks left unstartable by a
+// dependency cycle come back as failures.
+export const runDependencyTasks = async (tasks, limit) => {
+    const failures = [];
+    const succeeded = new Set();
+    const failed = new Set();
+    const started = new Set();
+    const pipelines = [];
+    let slots = Math.max(1, limit);
+    const waiting = [];
+    const acquire = async () => {
+        if (slots > 0) {
+            slots -= 1;
+            return;
+        }
+        await new Promise((resolve) => waiting.push(resolve));
+    };
+    const release = () => {
+        const next = waiting.shift();
+        if (next) {
+            next();
+        }
+        else {
+            slots += 1;
+        }
+    };
+    const runOne = async (task) => {
+        await acquire();
+        try {
+            await task.run();
+            succeeded.add(task.id);
+        }
+        catch (error) {
+            failed.add(task.id);
+            failures.push({ label: task.label, error: error });
+        }
+        finally {
+            release();
+        }
+        launchReady();
+    };
+    // Repeatedly sweep until stable: launching one task or cascading one skip can
+    // unblock (or block) tasks earlier in the list.
+    const launchReady = () => {
+        let changed = true;
+        while (changed) {
+            changed = false;
+            for (const task of tasks) {
+                if (started.has(task.id))
+                    continue;
+                if (task.deps.some((dep) => failed.has(dep))) {
+                    started.add(task.id);
+                    failed.add(task.id); // cascade so transitive dependents skip too
+                    console.log(`Skipping ${task.label} (a dependency failed)`);
+                    changed = true;
+                }
+                else if (task.deps.every((dep) => succeeded.has(dep))) {
+                    started.add(task.id);
+                    pipelines.push(runOne(task));
+                    changed = true;
+                }
+            }
+        }
+    };
+    launchReady();
+    // runOne re-invokes launchReady as tasks finish, pushing newly unblocked
+    // pipelines while earlier ones are being awaited; drain until it stays empty.
+    while (pipelines.length > 0) {
+        await Promise.all(pipelines.splice(0, pipelines.length));
+    }
+    for (const task of tasks) {
+        if (!started.has(task.id)) {
+            failures.push({ label: task.label, error: new Error('unstartable: dependency cycle') });
+        }
+    }
+    return failures;
+};
+export const assertNoFailures = (phaseName, failures) => {
+    if (failures.length === 0)
+        return;
+    console.error(`\n${phaseName} failed for:`);
+    failures.forEach((failure) => console.error(`  ${failure.label}: ${failure.error.message}`));
+    throw new Error(`${phaseName}: ${failures.length} task(s) failed`);
+};
+//# sourceMappingURL=runTasks.js.map

package/lib/esm/lib/runTasks.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runTasks.js","sourceRoot":"","sources":["../../../src/lib/runTasks.ts"],"names":[],"mappings":"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","sourcesContent":["export type Task = { label: string; run: () => Promise<void> };\nexport type TaskFailure = { label: string; error: Error };\n\n// Run tasks with at most `limit` in flight; never rejects — failures come back\n// labelled so a whole wave can finish before we report what broke.\nexport const runTasks = async (tasks: Task[], limit: number): Promise<TaskFailure[]> => {\n  const failures: TaskFailure[] = [];\n  let nextIndex = 0;\n\n  const workerCount = Math.max(1, Math.min(limit, tasks.length));\n  await Promise.all(\n    Array.from({ length: workerCount }, async () => {\n      while (nextIndex < tasks.length) {\n        const task = tasks[nextIndex];\n        nextIndex += 1;\n        try {\n          await task.run();\n        } catch (error) {\n          failures.push({ label: task.label, error: error as Error });\n        }\n      }\n    }),\n  );\n\n  return failures;\n};\n\nexport type DependencyTask = Task & {\n  // Unique id other tasks reference in `deps` (e.g. a package name).\n  id: string;\n  // Ids of tasks that must succeed before this one starts. Ids not present in\n  // the task list should be filtered out by the caller.\n  deps: string[];\n};\n\n// Run tasks with at most `limit` in flight, but a task only starts once every\n// task in its `deps` has succeeded. A failure doesn't stop unrelated tasks;\n// dependents of the failed task are skipped (logged, not returned as failures,\n// the root cause already is). Never rejects. Tasks left unstartable by a\n// dependency cycle come back as failures.\nexport const runDependencyTasks = async (tasks: DependencyTask[], limit: number): Promise<TaskFailure[]> => {\n  const failures: TaskFailure[] = [];\n  const succeeded = new Set<string>();\n  const failed = new Set<string>();\n  const started = new Set<string>();\n  const pipelines: Array<Promise<void>> = [];\n\n  let slots = Math.max(1, limit);\n  const waiting: Array<() => void> = [];\n\n  const acquire = async (): Promise<void> => {\n    if (slots > 0) {\n      slots -= 1;\n      return;\n    }\n    await new Promise<void>((resolve) => waiting.push(resolve));\n  };\n\n  const release = (): void => {\n    const next = waiting.shift();\n    if (next) {\n      next();\n    } else {\n      slots += 1;\n    }\n  };\n\n  const runOne = async (task: DependencyTask): Promise<void> => {\n    await acquire();\n    try {\n      await task.run();\n      succeeded.add(task.id);\n    } catch (error) {\n      failed.add(task.id);\n      failures.push({ label: task.label, error: error as Error });\n    } finally {\n      release();\n    }\n    launchReady();\n  };\n\n  // Repeatedly sweep until stable: launching one task or cascading one skip can\n  // unblock (or block) tasks earlier in the list.\n  const launchReady = (): void => {\n    let changed = true;\n    while (changed) {\n      changed = false;\n      for (const task of tasks) {\n        if (started.has(task.id)) continue;\n        if (task.deps.some((dep) => failed.has(dep))) {\n          started.add(task.id);\n          failed.add(task.id); // cascade so transitive dependents skip too\n          console.log(`Skipping ${task.label} (a dependency failed)`);\n          changed = true;\n        } else if (task.deps.every((dep) => succeeded.has(dep))) {\n          started.add(task.id);\n          pipelines.push(runOne(task));\n          changed = true;\n        }\n      }\n    }\n  };\n\n  launchReady();\n  // runOne re-invokes launchReady as tasks finish, pushing newly unblocked\n  // pipelines while earlier ones are being awaited; drain until it stays empty.\n  while (pipelines.length > 0) {\n    await Promise.all(pipelines.splice(0, pipelines.length));\n  }\n\n  for (const task of tasks) {\n    if (!started.has(task.id)) {\n      failures.push({ label: task.label, error: new Error('unstartable: dependency cycle') });\n    }\n  }\n\n  return failures;\n};\n\nexport const assertNoFailures = (phaseName: string, failures: TaskFailure[]): void => {\n  if (failures.length === 0) return;\n  console.error(`\\n${phaseName} failed for:`);\n  failures.forEach((failure) => console.error(`  ${failure.label}: ${failure.error.message}`));\n  throw new Error(`${phaseName}: ${failures.length} task(s) failed`);\n};\n"]}

package/lib/esm/lib/setupStep.d.ts

@@ -0,0 +1,16 @@
+import { Nullable } from '@qpqjs/core';
+export type SetupCheckResult = {
+    done: boolean;
+    detail?: string;
+};
+/**
+ * One item of a platform's setup checklist. `check` says whether it is already in place
+ * (null when it cannot tell), `run` makes it so. A check-only step (credentials, zones) has a
+ * run that re-checks and throws with guidance, so a failed prerequisite stops the sequence.
+ */
+export type SetupStep = {
+    id: string;
+    name: string;
+    check: () => Promise<Nullable<SetupCheckResult>>;
+    run: () => Promise<void>;
+};

package/lib/esm/lib/setupStep.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=setupStep.js.map

package/lib/esm/lib/setupStep.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"setupStep.js","sourceRoot":"","sources":["../../../src/lib/setupStep.ts"],"names":[],"mappings":"","sourcesContent":["import { Nullable } from '@qpqjs/core';\n\nexport type SetupCheckResult = {\n  done: boolean;\n  // One line for the menu: what exists, or what is missing and how to fix it.\n  detail?: string;\n};\n\n/**\n * One item of a platform's setup checklist. `check` says whether it is already in place\n * (null when it cannot tell), `run` makes it so. A check-only step (credentials, zones) has a\n * run that re-checks and throws with guidance, so a failed prerequisite stops the sequence.\n */\nexport type SetupStep = {\n  id: string;\n  name: string;\n  check: () => Promise<Nullable<SetupCheckResult>>;\n  run: () => Promise<void>;\n};\n"]}

package/lib/esm/lib/timing.d.ts

@@ -0,0 +1,2 @@
+export declare const logTimeStart: (name: string) => void;
+export declare const logTimeEnd: (name: string) => void;

package/lib/esm/lib/timing.js

@@ -0,0 +1,6 @@
+export const logTimeStart = (name) => console.time(name);
+export const logTimeEnd = (name) => {
+    console.log('When:', new Date().toLocaleTimeString());
+    console.timeEnd(name);
+};
+//# sourceMappingURL=timing.js.map

package/lib/esm/lib/timing.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"timing.js","sourceRoot":"","sources":["../../../src/lib/timing.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC,IAAY,EAAQ,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC;AAEvE,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAY,EAAQ,EAAE;IAC/C,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,IAAI,EAAE,CAAC,kBAAkB,EAAE,CAAC,CAAC;IACtD,OAAO,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;AACxB,CAAC,CAAC","sourcesContent":["export const logTimeStart = (name: string): void => console.time(name);\n\nexport const logTimeEnd = (name: string): void => {\n  console.log('When:', new Date().toLocaleTimeString());\n  console.timeEnd(name);\n};\n"]}

package/lib/esm/lib/typeWatcher.d.ts

@@ -0,0 +1,2 @@
+import { ChildProcess } from 'child_process';
+export declare const startTypeWatcher: (root: string) => ChildProcess | null;

package/lib/esm/lib/typeWatcher.js

@@ -0,0 +1,51 @@
+// Keeps workspace packages' declaration output (dist/*.d.ts) fresh while
+// `qpq go:dev` runs. The rspack dev builds bundle workspace source directly,
+// so this watcher only feeds the editor and validate-ts, which resolve
+// cross-package types through each package's built declarations.
+//
+// One `tsc -b --watch` over every workspace package that ships types; routine
+// watch chatter is dropped so only real compile errors reach the shared
+// terminal. Opt out with `--no-types`.
+import { getWorkspacePackageDirs } from '@qpqjs/deploy-rspack';
+import { spawn } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+// Routine tsc watch status lines; everything else is worth showing.
+const routineTscPatterns = [/Starting compilation in watch mode/, /File change detected/, /Found 0 errors/];
+const isRoutineTscLine = (line) => routineTscPatterns.some((pattern) => pattern.test(line));
+// Forwards non-routine tsc output line by line under a [types] prefix.
+const forwardTscOutput = (chunk) => {
+    for (const line of chunk.toString().split('\n')) {
+        if (line.trim().length === 0 || isRoutineTscLine(line)) {
+            continue;
+        }
+        console.log(`[types] ${line}`);
+    }
+};
+// A workspace package wants declaration watching when it has a tsconfig and
+// publishes types from its build output. Packages bundled by rspack (views,
+// service handlers) don't ship types and are skipped.
+const isTypedWorkspacePackage = (dir) => {
+    if (!fs.existsSync(path.join(dir, 'tsconfig.json'))) {
+        return false;
+    }
+    const packageJson = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf-8'));
+    return !!(packageJson.types || packageJson.typings);
+};
+export const startTypeWatcher = (root) => {
+    const projectDirs = getWorkspacePackageDirs(root).filter(isTypedWorkspacePackage);
+    if (projectDirs.length === 0) {
+        return null;
+    }
+    const relativeDirs = projectDirs.map((dir) => path.relative(root, dir));
+    const child = spawn('npx', ['tsc', '-b', ...relativeDirs, '--watch', '--preserveWatchOutput', '--pretty'], {
+        cwd: root,
+        stdio: ['ignore', 'pipe', 'pipe'],
+        shell: process.platform === 'win32',
+    });
+    child.stdout?.on('data', forwardTscOutput);
+    child.stderr?.on('data', forwardTscOutput);
+    console.log(`Type watcher: tsc -b --watch over ${relativeDirs.length} workspace packages (disable with --no-types).`);
+    return child;
+};
+//# sourceMappingURL=typeWatcher.js.map

package/lib/esm/lib/typeWatcher.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"typeWatcher.js","sourceRoot":"","sources":["../../../src/lib/typeWatcher.ts"],"names":[],"mappings":"AAAA,yEAAyE;AACzE,6EAA6E;AAC7E,uEAAuE;AACvE,iEAAiE;AACjE,EAAE;AACF,8EAA8E;AAC9E,wEAAwE;AACxE,uCAAuC;AACvC,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAE/D,OAAO,EAAgB,KAAK,EAAE,MAAM,eAAe,CAAC;AACpD,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,oEAAoE;AACpE,MAAM,kBAAkB,GAAG,CAAC,oCAAoC,EAAE,sBAAsB,EAAE,gBAAgB,CAAC,CAAC;AAE5G,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAW,EAAE,CAAC,kBAAkB,CAAC,IAAI,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC;AAE7G,uEAAuE;AACvE,MAAM,gBAAgB,GAAG,CAAC,KAAa,EAAQ,EAAE;IAC/C,KAAK,MAAM,IAAI,IAAI,KAAK,CAAC,QAAQ,EAAE,CAAC,KAAK,CAAC,IAAI,CAAC,EAAE,CAAC;QAChD,IAAI,IAAI,CAAC,IAAI,EAAE,CAAC,MAAM,KAAK,CAAC,IAAI,gBAAgB,CAAC,IAAI,CAAC,EAAE,CAAC;YACvD,SAAS;QACX,CAAC;QACD,OAAO,CAAC,GAAG,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC;IACjC,CAAC;AACH,CAAC,CAAC;AAEF,4EAA4E;AAC5E,4EAA4E;AAC5E,sDAAsD;AACtD,MAAM,uBAAuB,GAAG,CAAC,GAAW,EAAW,EAAE;IACvD,IAAI,CAAC,EAAE,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,eAAe,CAAC,CAAC,EAAE,CAAC;QACpD,OAAO,KAAK,CAAC;IACf,CAAC;IAED,MAAM,WAAW,GAAG,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,cAAc,CAAC,EAAE,OAAO,CAAC,CAAC,CAAC;IACzF,OAAO,CAAC,CAAC,CAAC,WAAW,CAAC,KAAK,IAAI,WAAW,CAAC,OAAO,CAAC,CAAC;AACtD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC,IAAY,EAAuB,EAAE;IACpE,MAAM,WAAW,GAAG,uBAAuB,CAAC,IAAI,CAAC,CAAC,MAAM,CAAC,uBAAuB,CAAC,CAAC;IAClF,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QAC7B,OAAO,IAAI,CAAC;IACd,CAAC;IAED,MAAM,YAAY,GAAG,WAAW,CAAC,GAAG,CAAC,CAAC,GAAG,EAAE,EAAE,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,GAAG,CAAC,CAAC,CAAC;IACxE,MAAM,KAAK,GAAG,KAAK,CAAC,KAAK,EAAE,CAAC,KAAK,EAAE,IAAI,EAAE,GAAG,YAAY,EAAE,SAAS,EAAE,uBAAuB,EAAE,UAAU,CAAC,EAAE;QACzG,GAAG,EAAE,IAAI;QACT,KAAK,EAAE,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC;QACjC,KAAK,EAAE,OAAO,CAAC,QAAQ,KAAK,OAAO;KACpC,CAAC,CAAC;IAEH,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAC3C,KAAK,CAAC,MAAM,EAAE,EAAE,CAAC,MAAM,EAAE,gBAAgB,CAAC,CAAC;IAE3C,OAAO,CAAC,GAAG,CAAC,qCAAqC,YAAY,CAAC,MAAM,gDAAgD,CAAC,CAAC;IAEtH,OAAO,KAAK,CAAC;AACf,CAAC,CAAC","sourcesContent":["// Keeps workspace packages' declaration output (dist/*.d.ts) fresh while\n// `qpq go:dev` runs. The rspack dev builds bundle workspace source directly,\n// so this watcher only feeds the editor and validate-ts, which resolve\n// cross-package types through each package's built declarations.\n//\n// One `tsc -b --watch` over every workspace package that ships types; routine\n// watch chatter is dropped so only real compile errors reach the shared\n// terminal. Opt out with `--no-types`.\nimport { getWorkspacePackageDirs } from '@qpqjs/deploy-rspack';\n\nimport { ChildProcess, spawn } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\n\n// Routine tsc watch status lines; everything else is worth showing.\nconst routineTscPatterns = [/Starting compilation in watch mode/, /File change detected/, /Found 0 errors/];\n\nconst isRoutineTscLine = (line: string): boolean => routineTscPatterns.some((pattern) => pattern.test(line));\n\n// Forwards non-routine tsc output line by line under a [types] prefix.\nconst forwardTscOutput = (chunk: Buffer): void => {\n  for (const line of chunk.toString().split('\\n')) {\n    if (line.trim().length === 0 || isRoutineTscLine(line)) {\n      continue;\n    }\n    console.log(`[types] ${line}`);\n  }\n};\n\n// A workspace package wants declaration watching when it has a tsconfig and\n// publishes types from its build output. Packages bundled by rspack (views,\n// service handlers) don't ship types and are skipped.\nconst isTypedWorkspacePackage = (dir: string): boolean => {\n  if (!fs.existsSync(path.join(dir, 'tsconfig.json'))) {\n    return false;\n  }\n\n  const packageJson = JSON.parse(fs.readFileSync(path.join(dir, 'package.json'), 'utf-8'));\n  return !!(packageJson.types || packageJson.typings);\n};\n\nexport const startTypeWatcher = (root: string): ChildProcess | null => {\n  const projectDirs = getWorkspacePackageDirs(root).filter(isTypedWorkspacePackage);\n  if (projectDirs.length === 0) {\n    return null;\n  }\n\n  const relativeDirs = projectDirs.map((dir) => path.relative(root, dir));\n  const child = spawn('npx', ['tsc', '-b', ...relativeDirs, '--watch', '--preserveWatchOutput', '--pretty'], {\n    cwd: root,\n    stdio: ['ignore', 'pipe', 'pipe'],\n    shell: process.platform === 'win32',\n  });\n\n  child.stdout?.on('data', forwardTscOutput);\n  child.stderr?.on('data', forwardTscOutput);\n\n  console.log(`Type watcher: tsc -b --watch over ${relativeDirs.length} workspace packages (disable with --no-types).`);\n\n  return child;\n};\n"]}

package/lib/esm/lib/userScriptBuilderLayer.d.ts

@@ -0,0 +1,23 @@
+import { JavascriptRuntimeArchitecture } from '@qpqjs/core';
+export type BuilderLayerInstallOptions = {
+    outDir: string;
+    architecture: JavascriptRuntimeArchitecture;
+    rspackVersion: string;
+};
+/** The npm cpu name for a lambda architecture. */
+export declare const getBuilderLayerCpu: (architecture: JavascriptRuntimeArchitecture) => "arm64" | "x64";
+/**
+ * The npm argv that installs rspack for linux and the lambda's cpu into the layer's
+ * nodejs directory. Pure, so the exact invocation is testable without running npm.
+ */
+export declare const getBuilderLayerInstallArgs: ({ outDir, architecture, rspackVersion }: BuilderLayerInstallOptions) => string[];
+export type BuilderLayerRunners = {
+    getNpmVersion: () => string;
+    runNpm: (args: string[]) => void;
+};
+/**
+ * Produces the user-script builder layer directory: `<outDir>/nodejs/node_modules` holding
+ * rspack and its linux binding for the lambda's cpu. Empties `outDir` first and verifies
+ * the binding landed. Needs npm 9 or later for the `--os`/`--cpu` flags.
+ */
+export declare const buildUserScriptBuilderLayer: (options: BuilderLayerInstallOptions, runners?: BuilderLayerRunners) => string;

package/lib/esm/lib/userScriptBuilderLayer.js

@@ -0,0 +1,65 @@
+import { JavascriptRuntimeArchitecture } from '@qpqjs/core';
+import { USER_SCRIPT_BUILDER_LAYER_MODULES } from '@qpqjs/user-script';
+import { execFileSync } from 'child_process';
+import fs from 'fs';
+import path from 'path';
+const MIN_NPM_MAJOR = 9;
+// Lambda's layer layout: /opt/nodejs/node_modules is on the function's module path.
+const LAYER_NODE_DIR = 'nodejs';
+const npmCpuByArchitecture = {
+    [JavascriptRuntimeArchitecture.Arm64]: 'arm64',
+    [JavascriptRuntimeArchitecture.X86_64]: 'x64',
+};
+/** The npm cpu name for a lambda architecture. */
+export const getBuilderLayerCpu = (architecture) => npmCpuByArchitecture[architecture];
+/**
+ * The npm argv that installs rspack for linux and the lambda's cpu into the layer's
+ * nodejs directory. Pure, so the exact invocation is testable without running npm.
+ */
+export const getBuilderLayerInstallArgs = ({ outDir, architecture, rspackVersion }) => [
+    'install',
+    '--prefix',
+    path.join(outDir, LAYER_NODE_DIR),
+    '--os=linux',
+    `--cpu=${getBuilderLayerCpu(architecture)}`,
+    '--libc=glibc',
+    '--omit=dev',
+    '--no-save',
+    '--no-package-lock',
+    '--no-audit',
+    '--no-fund',
+    `@rspack/core@${rspackVersion}`,
+];
+const parseMajor = (version) => parseInt(version.split('.')[0], 10);
+const defaultRunners = {
+    getNpmVersion: () => execFileSync('npm', ['--version'], { encoding: 'utf8' }).trim(),
+    runNpm: (args) => {
+        execFileSync('npm', args, { stdio: 'inherit' });
+    },
+};
+/**
+ * Produces the user-script builder layer directory: `<outDir>/nodejs/node_modules` holding
+ * rspack and its linux binding for the lambda's cpu. Empties `outDir` first and verifies
+ * the binding landed. Needs npm 9 or later for the `--os`/`--cpu` flags.
+ */
+export const buildUserScriptBuilderLayer = (options, runners = defaultRunners) => {
+    const npmVersion = runners.getNpmVersion();
+    if (parseMajor(npmVersion) < MIN_NPM_MAJOR) {
+        throw new Error(`script:builder-layer needs npm ${MIN_NPM_MAJOR} or later for --os/--cpu installs; found ${npmVersion}`);
+    }
+    const nodeDir = path.join(options.outDir, LAYER_NODE_DIR);
+    fs.rmSync(options.outDir, { recursive: true, force: true });
+    fs.mkdirSync(nodeDir, { recursive: true });
+    fs.writeFileSync(path.join(nodeDir, 'package.json'), JSON.stringify({ name: 'user-script-builder-layer', private: true }, null, 2));
+    runners.runNpm(getBuilderLayerInstallArgs(options));
+    const bindingDir = path.join(nodeDir, 'node_modules', '@rspack', `binding-linux-${getBuilderLayerCpu(options.architecture)}-gnu`);
+    if (!fs.existsSync(bindingDir)) {
+        throw new Error(`script:builder-layer: expected the rspack binding at [${bindingDir}] after install; the layer would not load on lambda`);
+    }
+    const installed = USER_SCRIPT_BUILDER_LAYER_MODULES.filter((name) => fs.existsSync(path.join(nodeDir, 'node_modules', name)));
+    if (installed.length !== USER_SCRIPT_BUILDER_LAYER_MODULES.length) {
+        throw new Error(`script:builder-layer: the layer is missing ${USER_SCRIPT_BUILDER_LAYER_MODULES.filter((name) => !installed.includes(name)).join(', ')}`);
+    }
+    return nodeDir;
+};
+//# sourceMappingURL=userScriptBuilderLayer.js.map

package/lib/esm/lib/userScriptBuilderLayer.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userScriptBuilderLayer.js","sourceRoot":"","sources":["../../../src/lib/userScriptBuilderLayer.ts"],"names":[],"mappings":"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","sourcesContent":["import { JavascriptRuntimeArchitecture } from '@qpqjs/core';\nimport { USER_SCRIPT_BUILDER_LAYER_MODULES } from '@qpqjs/user-script';\n\nimport { execFileSync } from 'child_process';\nimport fs from 'fs';\nimport path from 'path';\n\nconst MIN_NPM_MAJOR = 9;\n\n// Lambda's layer layout: /opt/nodejs/node_modules is on the function's module path.\nconst LAYER_NODE_DIR = 'nodejs';\n\nconst npmCpuByArchitecture: Record<JavascriptRuntimeArchitecture, 'arm64' | 'x64'> = {\n  [JavascriptRuntimeArchitecture.Arm64]: 'arm64',\n  [JavascriptRuntimeArchitecture.X86_64]: 'x64',\n};\n\nexport type BuilderLayerInstallOptions = {\n  outDir: string;\n  architecture: JavascriptRuntimeArchitecture;\n  rspackVersion: string;\n};\n\n/** The npm cpu name for a lambda architecture. */\nexport const getBuilderLayerCpu = (architecture: JavascriptRuntimeArchitecture): 'arm64' | 'x64' => npmCpuByArchitecture[architecture];\n\n/**\n * The npm argv that installs rspack for linux and the lambda's cpu into the layer's\n * nodejs directory. Pure, so the exact invocation is testable without running npm.\n */\nexport const getBuilderLayerInstallArgs = ({ outDir, architecture, rspackVersion }: BuilderLayerInstallOptions): string[] => [\n  'install',\n  '--prefix',\n  path.join(outDir, LAYER_NODE_DIR),\n  '--os=linux',\n  `--cpu=${getBuilderLayerCpu(architecture)}`,\n  '--libc=glibc',\n  '--omit=dev',\n  '--no-save',\n  '--no-package-lock',\n  '--no-audit',\n  '--no-fund',\n  `@rspack/core@${rspackVersion}`,\n];\n\nconst parseMajor = (version: string): number => parseInt(version.split('.')[0], 10);\n\nexport type BuilderLayerRunners = {\n  getNpmVersion: () => string;\n  runNpm: (args: string[]) => void;\n};\n\nconst defaultRunners: BuilderLayerRunners = {\n  getNpmVersion: () => execFileSync('npm', ['--version'], { encoding: 'utf8' }).trim(),\n  runNpm: (args) => {\n    execFileSync('npm', args, { stdio: 'inherit' });\n  },\n};\n\n/**\n * Produces the user-script builder layer directory: `<outDir>/nodejs/node_modules` holding\n * rspack and its linux binding for the lambda's cpu. Empties `outDir` first and verifies\n * the binding landed. Needs npm 9 or later for the `--os`/`--cpu` flags.\n */\nexport const buildUserScriptBuilderLayer = (options: BuilderLayerInstallOptions, runners: BuilderLayerRunners = defaultRunners): string => {\n  const npmVersion = runners.getNpmVersion();\n  if (parseMajor(npmVersion) < MIN_NPM_MAJOR) {\n    throw new Error(`script:builder-layer needs npm ${MIN_NPM_MAJOR} or later for --os/--cpu installs; found ${npmVersion}`);\n  }\n\n  const nodeDir = path.join(options.outDir, LAYER_NODE_DIR);\n  fs.rmSync(options.outDir, { recursive: true, force: true });\n  fs.mkdirSync(nodeDir, { recursive: true });\n  fs.writeFileSync(path.join(nodeDir, 'package.json'), JSON.stringify({ name: 'user-script-builder-layer', private: true }, null, 2));\n\n  runners.runNpm(getBuilderLayerInstallArgs(options));\n\n  const bindingDir = path.join(nodeDir, 'node_modules', '@rspack', `binding-linux-${getBuilderLayerCpu(options.architecture)}-gnu`);\n  if (!fs.existsSync(bindingDir)) {\n    throw new Error(`script:builder-layer: expected the rspack binding at [${bindingDir}] after install; the layer would not load on lambda`);\n  }\n\n  const installed = USER_SCRIPT_BUILDER_LAYER_MODULES.filter((name) => fs.existsSync(path.join(nodeDir, 'node_modules', name)));\n  if (installed.length !== USER_SCRIPT_BUILDER_LAYER_MODULES.length) {\n    throw new Error(`script:builder-layer: the layer is missing ${USER_SCRIPT_BUILDER_LAYER_MODULES.filter((name) => !installed.includes(name)).join(', ')}`);\n  }\n\n  return nodeDir;\n};\n"]}

package/lib/esm/lib/userScriptTemplate.d.ts

@@ -0,0 +1,6 @@
+/**
+ * Writes the user-script template project into `targetDir`, naming the package after
+ * the directory and pinning @qpqjs/core to this CLI's own version. Refuses a
+ * directory that already has files in it. Returns the relative paths written.
+ */
+export declare const createUserScriptProject: (targetDir: string) => string[];

package/lib/esm/lib/userScriptTemplate.js

@@ -0,0 +1,39 @@
+import fs from 'fs';
+import path from 'path';
+import { getOwnPackageRoot } from './packageRoot';
+const TEMPLATE_DIR = 'templates/user-script';
+// Shipped as `gitignore` because npm drops `.gitignore` files from a published package.
+const RENAMED_ON_COPY = { gitignore: '.gitignore' };
+const TEXT_SUBSTITUTIONS = ['package.json', 'README.md'];
+const readOwnVersion = () => JSON.parse(fs.readFileSync(path.join(getOwnPackageRoot(), 'package.json'), 'utf8')).version;
+const listFilesRecursive = (dir, base = dir) => fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {
+    const fullPath = path.join(dir, entry.name);
+    return entry.isDirectory() ? listFilesRecursive(fullPath, base) : [path.relative(base, fullPath)];
+});
+const substitute = (text, packageName, qpqVersion) => text.replace(/__PACKAGE_NAME__/g, packageName).replace(/__QPQ_VERSION__/g, qpqVersion);
+/**
+ * Writes the user-script template project into `targetDir`, naming the package after
+ * the directory and pinning @qpqjs/core to this CLI's own version. Refuses a
+ * directory that already has files in it. Returns the relative paths written.
+ */
+export const createUserScriptProject = (targetDir) => {
+    const absoluteTarget = path.resolve(targetDir);
+    if (fs.existsSync(absoluteTarget) && fs.readdirSync(absoluteTarget).length > 0) {
+        throw new Error(`[${absoluteTarget}] is not empty; script:new only writes into a new or empty directory`);
+    }
+    const templateRoot = path.join(getOwnPackageRoot(), TEMPLATE_DIR);
+    const packageName = path.basename(absoluteTarget);
+    const qpqVersion = readOwnVersion();
+    const written = [];
+    for (const relativePath of listFilesRecursive(templateRoot)) {
+        const basename = path.basename(relativePath);
+        const outputRelative = path.join(path.dirname(relativePath), RENAMED_ON_COPY[basename] ?? basename);
+        const outputPath = path.join(absoluteTarget, outputRelative);
+        fs.mkdirSync(path.dirname(outputPath), { recursive: true });
+        const source = fs.readFileSync(path.join(templateRoot, relativePath), 'utf8');
+        fs.writeFileSync(outputPath, TEXT_SUBSTITUTIONS.includes(basename) ? substitute(source, packageName, qpqVersion) : source);
+        written.push(outputRelative);
+    }
+    return written.sort();
+};
+//# sourceMappingURL=userScriptTemplate.js.map

package/lib/esm/lib/userScriptTemplate.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"userScriptTemplate.js","sourceRoot":"","sources":["../../../src/lib/userScriptTemplate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,iBAAiB,EAAE,MAAM,eAAe,CAAC;AAElD,MAAM,YAAY,GAAG,uBAAuB,CAAC;AAE7C,wFAAwF;AACxF,MAAM,eAAe,GAA2B,EAAE,SAAS,EAAE,YAAY,EAAE,CAAC;AAE5E,MAAM,kBAAkB,GAAG,CAAC,cAAc,EAAE,WAAW,CAAC,CAAC;AAEzD,MAAM,cAAc,GAAG,GAAW,EAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,cAAc,CAAC,EAAE,MAAM,CAAC,CAAC,CAAC,OAAiB,CAAC;AAE3I,MAAM,kBAAkB,GAAG,CAAC,GAAW,EAAE,OAAe,GAAG,EAAY,EAAE,CACvE,EAAE,CAAC,WAAW,CAAC,GAAG,EAAE,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;IAC7D,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,IAAI,CAAC,CAAC;IAC5C,OAAO,KAAK,CAAC,WAAW,EAAE,CAAC,CAAC,CAAC,kBAAkB,CAAC,QAAQ,EAAE,IAAI,CAAC,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,IAAI,EAAE,QAAQ,CAAC,CAAC,CAAC;AACpG,CAAC,CAAC,CAAC;AAEL,MAAM,UAAU,GAAG,CAAC,IAAY,EAAE,WAAmB,EAAE,UAAkB,EAAU,EAAE,CACnF,IAAI,CAAC,OAAO,CAAC,mBAAmB,EAAE,WAAW,CAAC,CAAC,OAAO,CAAC,kBAAkB,EAAE,UAAU,CAAC,CAAC;AAEzF;;;;GAIG;AACH,MAAM,CAAC,MAAM,uBAAuB,GAAG,CAAC,SAAiB,EAAY,EAAE;IACrE,MAAM,cAAc,GAAG,IAAI,CAAC,OAAO,CAAC,SAAS,CAAC,CAAC;IAC/C,IAAI,EAAE,CAAC,UAAU,CAAC,cAAc,CAAC,IAAI,EAAE,CAAC,WAAW,CAAC,cAAc,CAAC,CAAC,MAAM,GAAG,CAAC,EAAE,CAAC;QAC/E,MAAM,IAAI,KAAK,CAAC,IAAI,cAAc,sEAAsE,CAAC,CAAC;IAC5G,CAAC;IAED,MAAM,YAAY,GAAG,IAAI,CAAC,IAAI,CAAC,iBAAiB,EAAE,EAAE,YAAY,CAAC,CAAC;IAClE,MAAM,WAAW,GAAG,IAAI,CAAC,QAAQ,CAAC,cAAc,CAAC,CAAC;IAClD,MAAM,UAAU,GAAG,cAAc,EAAE,CAAC;IAEpC,MAAM,OAAO,GAAa,EAAE,CAAC;IAC7B,KAAK,MAAM,YAAY,IAAI,kBAAkB,CAAC,YAAY,CAAC,EAAE,CAAC;QAC5D,MAAM,QAAQ,GAAG,IAAI,CAAC,QAAQ,CAAC,YAAY,CAAC,CAAC;QAC7C,MAAM,cAAc,GAAG,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC,OAAO,CAAC,YAAY,CAAC,EAAE,eAAe,CAAC,QAAQ,CAAC,IAAI,QAAQ,CAAC,CAAC;QACpG,MAAM,UAAU,GAAG,IAAI,CAAC,IAAI,CAAC,cAAc,EAAE,cAAc,CAAC,CAAC;QAC7D,EAAE,CAAC,SAAS,CAAC,IAAI,CAAC,OAAO,CAAC,UAAU,CAAC,EAAE,EAAE,SAAS,EAAE,IAAI,EAAE,CAAC,CAAC;QAE5D,MAAM,MAAM,GAAG,EAAE,CAAC,YAAY,CAAC,IAAI,CAAC,IAAI,CAAC,YAAY,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,CAAC;QAC9E,EAAE,CAAC,aAAa,CAAC,UAAU,EAAE,kBAAkB,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAC3H,OAAO,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC;IAC/B,CAAC;IAED,OAAO,OAAO,CAAC,IAAI,EAAE,CAAC;AACxB,CAAC,CAAC","sourcesContent":["import fs from 'fs';\nimport path from 'path';\n\nimport { getOwnPackageRoot } from './packageRoot';\n\nconst TEMPLATE_DIR = 'templates/user-script';\n\n// Shipped as `gitignore` because npm drops `.gitignore` files from a published package.\nconst RENAMED_ON_COPY: Record<string, string> = { gitignore: '.gitignore' };\n\nconst TEXT_SUBSTITUTIONS = ['package.json', 'README.md'];\n\nconst readOwnVersion = (): string => JSON.parse(fs.readFileSync(path.join(getOwnPackageRoot(), 'package.json'), 'utf8')).version as string;\n\nconst listFilesRecursive = (dir: string, base: string = dir): string[] =>\n  fs.readdirSync(dir, { withFileTypes: true }).flatMap((entry) => {\n    const fullPath = path.join(dir, entry.name);\n    return entry.isDirectory() ? listFilesRecursive(fullPath, base) : [path.relative(base, fullPath)];\n  });\n\nconst substitute = (text: string, packageName: string, qpqVersion: string): string =>\n  text.replace(/__PACKAGE_NAME__/g, packageName).replace(/__QPQ_VERSION__/g, qpqVersion);\n\n/**\n * Writes the user-script template project into `targetDir`, naming the package after\n * the directory and pinning @qpqjs/core to this CLI's own version. Refuses a\n * directory that already has files in it. Returns the relative paths written.\n */\nexport const createUserScriptProject = (targetDir: string): string[] => {\n  const absoluteTarget = path.resolve(targetDir);\n  if (fs.existsSync(absoluteTarget) && fs.readdirSync(absoluteTarget).length > 0) {\n    throw new Error(`[${absoluteTarget}] is not empty; script:new only writes into a new or empty directory`);\n  }\n\n  const templateRoot = path.join(getOwnPackageRoot(), TEMPLATE_DIR);\n  const packageName = path.basename(absoluteTarget);\n  const qpqVersion = readOwnVersion();\n\n  const written: string[] = [];\n  for (const relativePath of listFilesRecursive(templateRoot)) {\n    const basename = path.basename(relativePath);\n    const outputRelative = path.join(path.dirname(relativePath), RENAMED_ON_COPY[basename] ?? basename);\n    const outputPath = path.join(absoluteTarget, outputRelative);\n    fs.mkdirSync(path.dirname(outputPath), { recursive: true });\n\n    const source = fs.readFileSync(path.join(templateRoot, relativePath), 'utf8');\n    fs.writeFileSync(outputPath, TEXT_SUBSTITUTIONS.includes(basename) ? substitute(source, packageName, qpqVersion) : source);\n    written.push(outputRelative);\n  }\n\n  return written.sort();\n};\n"]}

package/lib/esm/lib/views.d.ts

@@ -0,0 +1,2 @@
+export declare const bundleViews: (appName: string, serviceName: string) => Promise<void>;
+export declare const getViewsDistDir: (appName: string, serviceName: string) => string;

package/lib/esm/lib/views.js

@@ -0,0 +1,14 @@
+// Views build — programmatic (getViewsRspackConfig), platform-neutral. Where
+// the built views get hosted is a platform driver concern (see
+// platforms/<platform>/viewsSync).
+import { getViewsRspackConfig, runRspack } from '@qpqjs/deploy-rspack';
+import path from 'path';
+import { getRoot, getServiceDirectory } from './discovery';
+export const bundleViews = async (appName, serviceName) => {
+    const viewsDir = path.join(getServiceDirectory(appName, serviceName), 'views');
+    process.env.NODE_ENV = 'production';
+    delete process.env.LOCAL_DEV_SERVER;
+    await runRspack(getViewsRspackConfig(viewsDir));
+};
+export const getViewsDistDir = (appName, serviceName) => path.join(getRoot(), 'dist', 'apps', appName, 'services', serviceName, 'views');
+//# sourceMappingURL=views.js.map

package/lib/esm/lib/views.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"views.js","sourceRoot":"","sources":["../../../src/lib/views.ts"],"names":[],"mappings":"AAAA,6EAA6E;AAC7E,+DAA+D;AAC/D,mCAAmC;AACnC,OAAO,EAAE,oBAAoB,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAC;AAEvE,OAAO,IAAI,MAAM,MAAM,CAAC;AAExB,OAAO,EAAE,OAAO,EAAE,mBAAmB,EAAE,MAAM,aAAa,CAAC;AAE3D,MAAM,CAAC,MAAM,WAAW,GAAG,KAAK,EAAE,OAAe,EAAE,WAAmB,EAAiB,EAAE;IACvF,MAAM,QAAQ,GAAG,IAAI,CAAC,IAAI,CAAC,mBAAmB,CAAC,OAAO,EAAE,WAAW,CAAC,EAAE,OAAO,CAAC,CAAC;IAE/E,OAAO,CAAC,GAAG,CAAC,QAAQ,GAAG,YAAY,CAAC;IACpC,OAAO,OAAO,CAAC,GAAG,CAAC,gBAAgB,CAAC;IAEpC,MAAM,SAAS,CAAC,oBAAoB,CAAC,QAAQ,CAAC,CAAC,CAAC;AAClD,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC,OAAe,EAAE,WAAmB,EAAU,EAAE,CAC9E,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,EAAE,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,OAAO,CAAC,CAAC","sourcesContent":["// Views build — programmatic (getViewsRspackConfig), platform-neutral. Where\n// the built views get hosted is a platform driver concern (see\n// platforms/<platform>/viewsSync).\nimport { getViewsRspackConfig, runRspack } from '@qpqjs/deploy-rspack';\n\nimport path from 'path';\n\nimport { getRoot, getServiceDirectory } from './discovery';\n\nexport const bundleViews = async (appName: string, serviceName: string): Promise<void> => {\n  const viewsDir = path.join(getServiceDirectory(appName, serviceName), 'views');\n\n  process.env.NODE_ENV = 'production';\n  delete process.env.LOCAL_DEV_SERVER;\n\n  await runRspack(getViewsRspackConfig(viewsDir));\n};\n\nexport const getViewsDistDir = (appName: string, serviceName: string): string =>\n  path.join(getRoot(), 'dist', 'apps', appName, 'services', serviceName, 'views');\n"]}

package/lib/esm/lib/webAddressingEnv.d.ts

@@ -0,0 +1,7 @@
+import { QPQConfig } from '@qpqjs/core';
+import { WebAddressingPorts } from '@qpqjs/dev-server';
+/** Env var the views build reads to bake `WebAddressing` into every bundle. */
+export declare const QPQ_WEB_ADDRESSING_ENV = "QPQ_WEB_ADDRESSING";
+/** Bakes port-mode addressing into the views builds that follow, until `clearWebAddressingEnv`. */
+export declare const setWebAddressingEnv: (qpqConfigs: QPQConfig[], ports: WebAddressingPorts) => void;
+export declare const clearWebAddressingEnv: () => void;

package/lib/esm/lib/webAddressingEnv.js

@@ -0,0 +1,11 @@
+import { getWebAddressing } from '@qpqjs/dev-server';
+/** Env var the views build reads to bake `WebAddressing` into every bundle. */
+export const QPQ_WEB_ADDRESSING_ENV = 'QPQ_WEB_ADDRESSING';
+/** Bakes port-mode addressing into the views builds that follow, until `clearWebAddressingEnv`. */
+export const setWebAddressingEnv = (qpqConfigs, ports) => {
+    process.env[QPQ_WEB_ADDRESSING_ENV] = JSON.stringify(getWebAddressing(qpqConfigs, ports));
+};
+export const clearWebAddressingEnv = () => {
+    delete process.env[QPQ_WEB_ADDRESSING_ENV];
+};
+//# sourceMappingURL=webAddressingEnv.js.map

package/lib/esm/lib/webAddressingEnv.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"webAddressingEnv.js","sourceRoot":"","sources":["../../../src/lib/webAddressingEnv.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,gBAAgB,EAAsB,MAAM,mBAAmB,CAAC;AAEzE,+EAA+E;AAC/E,MAAM,CAAC,MAAM,sBAAsB,GAAG,oBAAoB,CAAC;AAE3D,mGAAmG;AACnG,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC,UAAuB,EAAE,KAAyB,EAAQ,EAAE;IAC9F,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,GAAG,IAAI,CAAC,SAAS,CAAC,gBAAgB,CAAC,UAAU,EAAE,KAAK,CAAC,CAAC,CAAC;AAC5F,CAAC,CAAC;AAEF,MAAM,CAAC,MAAM,qBAAqB,GAAG,GAAS,EAAE;IAC9C,OAAO,OAAO,CAAC,GAAG,CAAC,sBAAsB,CAAC,CAAC;AAC7C,CAAC,CAAC","sourcesContent":["import { QPQConfig } from '@qpqjs/core';\nimport { getWebAddressing, WebAddressingPorts } from '@qpqjs/dev-server';\n\n/** Env var the views build reads to bake `WebAddressing` into every bundle. */\nexport const QPQ_WEB_ADDRESSING_ENV = 'QPQ_WEB_ADDRESSING';\n\n/** Bakes port-mode addressing into the views builds that follow, until `clearWebAddressingEnv`. */\nexport const setWebAddressingEnv = (qpqConfigs: QPQConfig[], ports: WebAddressingPorts): void => {\n  process.env[QPQ_WEB_ADDRESSING_ENV] = JSON.stringify(getWebAddressing(qpqConfigs, ports));\n};\n\nexport const clearWebAddressingEnv = (): void => {\n  delete process.env[QPQ_WEB_ADDRESSING_ENV];\n};\n"]}

package/lib/esm/platforms/aws/awsCredentials.d.ts

@@ -0,0 +1 @@
+export declare const isAwsCredentialsValid: () => Promise<boolean>;

package/lib/esm/platforms/aws/awsCredentials.js

@@ -0,0 +1,15 @@
+import { GetCallerIdentityCommand, STSClient } from '@aws-sdk/client-sts';
+export const isAwsCredentialsValid = async () => {
+    try {
+        const client = new STSClient({
+            region: process.env.AWS_REGION || process.env.AWS_DEFAULT_REGION || 'us-east-1',
+        });
+        await client.send(new GetCallerIdentityCommand({}));
+        return true;
+    }
+    catch (error) {
+        console.log('Error validating AWS credentials:', error);
+        return false;
+    }
+};
+//# sourceMappingURL=awsCredentials.js.map

package/lib/esm/platforms/aws/awsCredentials.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"awsCredentials.js","sourceRoot":"","sources":["../../../../src/platforms/aws/awsCredentials.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,wBAAwB,EAAE,SAAS,EAAE,MAAM,qBAAqB,CAAC;AAE1E,MAAM,CAAC,MAAM,qBAAqB,GAAG,KAAK,IAAsB,EAAE;IAChE,IAAI,CAAC;QACH,MAAM,MAAM,GAAG,IAAI,SAAS,CAAC;YAC3B,MAAM,EAAE,OAAO,CAAC,GAAG,CAAC,UAAU,IAAI,OAAO,CAAC,GAAG,CAAC,kBAAkB,IAAI,WAAW;SAChF,CAAC,CAAC;QACH,MAAM,MAAM,CAAC,IAAI,CAAC,IAAI,wBAAwB,CAAC,EAAE,CAAC,CAAC,CAAC;QACpD,OAAO,IAAI,CAAC;IACd,CAAC;IAAC,OAAO,KAAK,EAAE,CAAC;QACf,OAAO,CAAC,GAAG,CAAC,mCAAmC,EAAE,KAAK,CAAC,CAAC;QACxD,OAAO,KAAK,CAAC;IACf,CAAC;AACH,CAAC,CAAC","sourcesContent":["import { GetCallerIdentityCommand, STSClient } from '@aws-sdk/client-sts';\n\nexport const isAwsCredentialsValid = async (): Promise<boolean> => {\n  try {\n    const client = new STSClient({\n      region: process.env.AWS_REGION || process.env.AWS_DEFAULT_REGION || 'us-east-1',\n    });\n    await client.send(new GetCallerIdentityCommand({}));\n    return true;\n  } catch (error) {\n    console.log('Error validating AWS credentials:', error);\n    return false;\n  }\n};\n"]}

package/lib/esm/platforms/aws/cdkApp.d.ts

@@ -0,0 +1,3 @@
+export declare const getCdkAppCommand: () => string;
+export declare const getCdkCliVersion: () => string;
+export declare const getDockerDir: () => string;