@open-rlb/nestjs-amqp 2.1.0 → 2.2.0

package/schematics/utils/nest-wiring.util.js

@@ -0,0 +1,170 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.findFileInTree = findFileInTree;
+exports.findAppModule = findAppModule;
+exports.findMainTs = findMainTs;
+exports.ensureLibImport = ensureLibImport;
+exports.ensureImportLine = ensureImportLine;
+exports.insertIntoImportsArray = insertIntoImportsArray;
+exports.wireAppModule = wireAppModule;
+exports.coreLibSymbols = coreLibSymbols;
+exports.coreImportLines = coreImportLines;
+exports.configModuleEntry = configModuleEntry;
+exports.brokerModuleEntry = brokerModuleEntry;
+exports.createConfigLoader = createConfigLoader;
+exports.configureMainForGateway = configureMainForGateway;
+exports.addDeps = addDeps;
+const APP_MODULE_CANDIDATES = ['/src/app.module.ts', '/app/app.module.ts', 'src/app.module.ts', 'app/app.module.ts'];
+const MAIN_CANDIDATES = ['/src/main.ts', '/app/main.ts', 'src/main.ts', 'app/main.ts'];
+function findFileInTree(tree, fileName) {
+    let found;
+    tree.visit((path) => {
+        if (!found && path.endsWith(`/${fileName}`))
+            found = path;
+    });
+    return found;
+}
+function findAppModule(tree) {
+    return APP_MODULE_CANDIDATES.find((p) => tree.exists(p)) || findFileInTree(tree, 'app.module.ts');
+}
+function findMainTs(tree) {
+    return MAIN_CANDIDATES.find((p) => tree.exists(p)) || findFileInTree(tree, 'main.ts');
+}
+function findLastImportEndIndex(source) {
+    const importRegex = /^import\s+.+from\s+['"][^'"]+['"];?\s*$/gm;
+    let lastEnd = 0;
+    let match;
+    while ((match = importRegex.exec(source)) !== null) {
+        lastEnd = match.index + match[0].length;
+    }
+    return lastEnd;
+}
+function ensureLibImport(source, symbols) {
+    const re = /import\s*\{([^}]*)\}\s*from\s*['"]@open-rlb\/nestjs-amqp['"];?/;
+    const m = re.exec(source);
+    if (m) {
+        const current = m[1]
+            .split(',')
+            .map((s) => s.trim())
+            .filter(Boolean);
+        const merged = [...new Set([...current, ...symbols])].sort();
+        return source.slice(0, m.index) + `import { ${merged.join(', ')} } from '@open-rlb/nestjs-amqp';` + source.slice(m.index + m[0].length);
+    }
+    const pos = findLastImportEndIndex(source);
+    const line = `\nimport { ${[...new Set(symbols)].sort().join(', ')} } from '@open-rlb/nestjs-amqp';`;
+    return source.slice(0, pos) + line + source.slice(pos);
+}
+function ensureImportLine(source, line, marker) {
+    if (source.includes(marker))
+        return source;
+    const pos = findLastImportEndIndex(source);
+    return source.slice(0, pos) + '\n' + line + source.slice(pos);
+}
+function insertIntoImportsArray(source, moduleEntry) {
+    const match = /imports\s*:\s*\[/.exec(source);
+    if (!match)
+        return source;
+    const openBracketPos = source.indexOf('[', match.index);
+    let depth = 0;
+    let closeBracketPos = -1;
+    for (let i = openBracketPos; i < source.length; i++) {
+        if (source[i] === '[')
+            depth++;
+        else if (source[i] === ']') {
+            depth--;
+            if (depth === 0) {
+                closeBracketPos = i;
+                break;
+            }
+        }
+    }
+    if (closeBracketPos === -1)
+        return source;
+    const arrayContent = source.slice(openBracketPos + 1, closeBracketPos).trim();
+    const newArrayContent = arrayContent.length === 0 ? `\n    ${moduleEntry},\n  ` : `\n    ${moduleEntry},\n    ${arrayContent}\n  `;
+    return source.slice(0, openBracketPos + 1) + newArrayContent + source.slice(closeBracketPos);
+}
+function wireAppModule(tree, opts) {
+    const modulePath = findAppModule(tree);
+    if (!modulePath)
+        return undefined;
+    let content = tree.read(modulePath).toString('utf-8');
+    content = ensureLibImport(content, opts.libSymbols);
+    for (const imp of opts.importLines || [])
+        content = ensureImportLine(content, imp.line, imp.marker);
+    const toAdd = opts.entries.filter((e) => !content.includes(e.sentinel));
+    for (let i = toAdd.length - 1; i >= 0; i--)
+        content = insertIntoImportsArray(content, toAdd[i].code);
+    tree.overwrite(modulePath, content);
+    return modulePath;
+}
+function coreLibSymbols() {
+    return ['AppConfig', 'BrokerModule', 'BrokerTopic', 'RabbitMQConfig'];
+}
+function coreImportLines() {
+    return [
+        { line: `import { ConfigModule, ConfigService } from '@nestjs/config';`, marker: '@nestjs/config' },
+        { line: `import yamlConfig from './config/config.loader';`, marker: './config/config.loader' },
+    ];
+}
+function configModuleEntry() {
+    return { code: `ConfigModule.forRoot({ isGlobal: true, load: [yamlConfig] })`, sentinel: 'ConfigModule.forRoot' };
+}
+function brokerModuleEntry() {
+    return {
+        code: `BrokerModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: async (configService: ConfigService) => ({
+        options: configService.get<RabbitMQConfig>('broker')!,
+        topics: configService.get<BrokerTopic[]>('topics')!,
+        appOptions: configService.get<AppConfig>('app'),
+      })
+    })`,
+        sentinel: 'BrokerModule.forRootAsync',
+    };
+}
+function createConfigLoader(tree) {
+    const path = 'src/config/config.loader.ts';
+    if (tree.exists(path))
+        return;
+    tree.create(path, `import { readFileSync } from 'fs';
+import * as yaml from 'js-yaml';
+import { join } from 'path';
+
+const YAML_CONFIG_FILENAME = 'config/config.yaml';
+
+export default () =>
+  yaml.load(readFileSync(join(process.cwd(), YAML_CONFIG_FILENAME), 'utf8')) as Record<string, any>;
+`);
+}
+function configureMainForGateway(tree) {
+    const mainPath = findMainTs(tree);
+    if (!mainPath)
+        return false;
+    let content = tree.read(mainPath).toString('utf-8');
+    if (content.includes('WsAdapter'))
+        return true;
+    content = ensureImportLine(content, `import { WsAdapter } from '@nestjs/platform-ws';`, '@nestjs/platform-ws');
+    const m = content.match(/const\s+(\w+)\s*=\s*await\s+NestFactory\.create[^(]*\(\s*([A-Za-z0-9_]+)\s*(,\s*\{[^}]*\})?\s*\)\s*;?/);
+    if (m) {
+        const appVar = m[1];
+        const moduleArg = m[2];
+        const replacement = `const ${appVar} = await NestFactory.create(${moduleArg}, { rawBody: true });\n  ${appVar}.useWebSocketAdapter(new WsAdapter(${appVar}));\n  ${appVar}.enableShutdownHooks();`;
+        content = content.replace(m[0], replacement);
+    }
+    tree.overwrite(mainPath, content);
+    return true;
+}
+function addDeps(tree, deps) {
+    if (!tree.exists('package.json'))
+        return;
+    const pkg = JSON.parse(tree.read('package.json').toString('utf-8'));
+    pkg.dependencies = pkg.dependencies || {};
+    for (const [name, version] of Object.entries(deps)) {
+        if (!pkg.dependencies[name])
+            pkg.dependencies[name] = version;
+    }
+    tree.overwrite('package.json', JSON.stringify(pkg, null, 2));
+}
+//# sourceMappingURL=nest-wiring.util.js.map

package/schematics/utils/nest-wiring.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"nest-wiring.util.js","sourceRoot":"","sources":["../../../libs/rlb-nestjs-amqp/src/schematics/utils/nest-wiring.util.ts"],"names":[],"mappings":"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"}

package/schematics/utils/nest-wiring.util.ts

@@ -0,0 +1,211 @@
+import { Tree } from '@angular-devkit/schematics';
+
+/**
+ * TypeScript-source wiring helpers shared by the scaffolding schematics (add-gateway today). They
+ * edit app.module.ts / main.ts / package.json / the config loader idempotently via light source
+ * surgery — the same technique nest-add used, extracted here so a promote-to-gateway run produces a
+ * fully wired app, not just YAML. Every helper is a no-op when its target is already in place.
+ */
+
+const APP_MODULE_CANDIDATES = ['/src/app.module.ts', '/app/app.module.ts', 'src/app.module.ts', 'app/app.module.ts'];
+const MAIN_CANDIDATES = ['/src/main.ts', '/app/main.ts', 'src/main.ts', 'app/main.ts'];
+
+export function findFileInTree(tree: Tree, fileName: string): string | undefined {
+  let found: string | undefined;
+  tree.visit((path) => {
+    if (!found && path.endsWith(`/${fileName}`)) found = path;
+  });
+  return found;
+}
+
+export function findAppModule(tree: Tree): string | undefined {
+  return APP_MODULE_CANDIDATES.find((p) => tree.exists(p)) || findFileInTree(tree, 'app.module.ts');
+}
+
+export function findMainTs(tree: Tree): string | undefined {
+  return MAIN_CANDIDATES.find((p) => tree.exists(p)) || findFileInTree(tree, 'main.ts');
+}
+
+function findLastImportEndIndex(source: string): number {
+  const importRegex = /^import\s+.+from\s+['"][^'"]+['"];?\s*$/gm;
+  let lastEnd = 0;
+  let match: RegExpExecArray | null;
+  while ((match = importRegex.exec(source)) !== null) {
+    lastEnd = match.index + match[0].length;
+  }
+  return lastEnd;
+}
+
+/**
+ * Ensure `symbols` are all imported from `@open-rlb/nestjs-amqp`: merge the missing ones into an
+ * existing lib import (kept sorted), or insert a fresh import after the last import when none exists.
+ */
+export function ensureLibImport(source: string, symbols: string[]): string {
+  const re = /import\s*\{([^}]*)\}\s*from\s*['"]@open-rlb\/nestjs-amqp['"];?/;
+  const m = re.exec(source);
+  if (m) {
+    const current = m[1]
+      .split(',')
+      .map((s) => s.trim())
+      .filter(Boolean);
+    const merged = [...new Set([...current, ...symbols])].sort();
+    return source.slice(0, m.index) + `import { ${merged.join(', ')} } from '@open-rlb/nestjs-amqp';` + source.slice(m.index + m[0].length);
+  }
+  const pos = findLastImportEndIndex(source);
+  const line = `\nimport { ${[...new Set(symbols)].sort().join(', ')} } from '@open-rlb/nestjs-amqp';`;
+  return source.slice(0, pos) + line + source.slice(pos);
+}
+
+/** Ensure a standalone import line is present, keyed by a substring `marker` already-present check. */
+export function ensureImportLine(source: string, line: string, marker: string): string {
+  if (source.includes(marker)) return source;
+  const pos = findLastImportEndIndex(source);
+  return source.slice(0, pos) + '\n' + line + source.slice(pos);
+}
+
+/** Insert `moduleEntry` at the head of the first `imports: [...]` array of the @Module decorator. */
+export function insertIntoImportsArray(source: string, moduleEntry: string): string {
+  const match = /imports\s*:\s*\[/.exec(source);
+  if (!match) return source;
+  const openBracketPos = source.indexOf('[', match.index);
+
+  let depth = 0;
+  let closeBracketPos = -1;
+  for (let i = openBracketPos; i < source.length; i++) {
+    if (source[i] === '[') depth++;
+    else if (source[i] === ']') {
+      depth--;
+      if (depth === 0) {
+        closeBracketPos = i;
+        break;
+      }
+    }
+  }
+  if (closeBracketPos === -1) return source;
+
+  const arrayContent = source.slice(openBracketPos + 1, closeBracketPos).trim();
+  const newArrayContent =
+    arrayContent.length === 0 ? `\n    ${moduleEntry},\n  ` : `\n    ${moduleEntry},\n    ${arrayContent}\n  `;
+  return source.slice(0, openBracketPos + 1) + newArrayContent + source.slice(closeBracketPos);
+}
+
+export interface WireEntry {
+  /** The literal module entry, e.g. `HttpModule` or `ProxyModule.forRootAsync({...})`. */
+  code: string;
+  /** Skip this entry when `source` already contains this substring (idempotency sentinel). */
+  sentinel: string;
+}
+
+export interface WireAppModuleOptions {
+  /** Symbols to import from `@open-rlb/nestjs-amqp`. */
+  libSymbols: string[];
+  /** Extra standalone import lines, each with a presence marker. */
+  importLines?: { line: string; marker: string }[];
+  /** @Module imports[] entries to add (each only if its sentinel is absent). */
+  entries: WireEntry[];
+}
+
+/**
+ * Wire modules into the app's AppModule: ensure the lib + helper imports, then insert each module
+ * entry whose sentinel is missing. Entries are inserted in reverse so the final visual order matches
+ * the given array. Returns the module path when found, else undefined (caller logs the skip).
+ */
+export function wireAppModule(tree: Tree, opts: WireAppModuleOptions): string | undefined {
+  const modulePath = findAppModule(tree);
+  if (!modulePath) return undefined;
+  let content = tree.read(modulePath)!.toString('utf-8');
+
+  content = ensureLibImport(content, opts.libSymbols);
+  for (const imp of opts.importLines || []) content = ensureImportLine(content, imp.line, imp.marker);
+
+  const toAdd = opts.entries.filter((e) => !content.includes(e.sentinel));
+  for (let i = toAdd.length - 1; i >= 0; i--) content = insertIntoImportsArray(content, toAdd[i].code);
+
+  tree.overwrite(modulePath, content);
+  return modulePath;
+}
+
+// --- Core (BrokerModule) wiring shared by nest-add and add-gateway --------------------------------
+
+/** Lib symbols every core (microservice) AppModule needs. */
+export function coreLibSymbols(): string[] {
+  return ['AppConfig', 'BrokerModule', 'BrokerTopic', 'RabbitMQConfig'];
+}
+
+/** The ConfigModule + config-loader import lines. */
+export function coreImportLines(): { line: string; marker: string }[] {
+  return [
+    { line: `import { ConfigModule, ConfigService } from '@nestjs/config';`, marker: '@nestjs/config' },
+    { line: `import yamlConfig from './config/config.loader';`, marker: './config/config.loader' },
+  ];
+}
+
+/** `ConfigModule.forRoot({...})` entry (sentinel: 'ConfigModule.forRoot'). */
+export function configModuleEntry(): WireEntry {
+  return { code: `ConfigModule.forRoot({ isGlobal: true, load: [yamlConfig] })`, sentinel: 'ConfigModule.forRoot' };
+}
+
+/** `BrokerModule.forRootAsync({...})` entry (sentinel: 'BrokerModule.forRootAsync'). */
+export function brokerModuleEntry(): WireEntry {
+  return {
+    code: `BrokerModule.forRootAsync({
+      imports: [ConfigModule],
+      inject: [ConfigService],
+      useFactory: async (configService: ConfigService) => ({
+        options: configService.get<RabbitMQConfig>('broker')!,
+        topics: configService.get<BrokerTopic[]>('topics')!,
+        appOptions: configService.get<AppConfig>('app'),
+      })
+    })`,
+    sentinel: 'BrokerModule.forRootAsync',
+  };
+}
+
+/** Create src/config/config.loader.ts (js-yaml loader) when missing. */
+export function createConfigLoader(tree: Tree): void {
+  const path = 'src/config/config.loader.ts';
+  if (tree.exists(path)) return;
+  tree.create(
+    path,
+    `import { readFileSync } from 'fs';
+import * as yaml from 'js-yaml';
+import { join } from 'path';
+
+const YAML_CONFIG_FILENAME = 'config/config.yaml';
+
+export default () =>
+  yaml.load(readFileSync(join(process.cwd(), YAML_CONFIG_FILENAME), 'utf8')) as Record<string, any>;
+`,
+  );
+}
+
+/** Enable rawBody + the WebSocket adapter + shutdown hooks in main.ts (idempotent). Returns false if unwired. */
+export function configureMainForGateway(tree: Tree): boolean {
+  const mainPath = findMainTs(tree);
+  if (!mainPath) return false;
+  let content = tree.read(mainPath)!.toString('utf-8');
+  if (content.includes('WsAdapter')) return true;
+
+  content = ensureImportLine(content, `import { WsAdapter } from '@nestjs/platform-ws';`, '@nestjs/platform-ws');
+
+  const m = content.match(/const\s+(\w+)\s*=\s*await\s+NestFactory\.create[^(]*\(\s*([A-Za-z0-9_]+)\s*(,\s*\{[^}]*\})?\s*\)\s*;?/);
+  if (m) {
+    const appVar = m[1];
+    const moduleArg = m[2];
+    const replacement = `const ${appVar} = await NestFactory.create(${moduleArg}, { rawBody: true });\n  ${appVar}.useWebSocketAdapter(new WsAdapter(${appVar}));\n  ${appVar}.enableShutdownHooks();`;
+    content = content.replace(m[0], replacement);
+  }
+  tree.overwrite(mainPath, content);
+  return true;
+}
+
+/** Add runtime dependencies to package.json (only when absent). No-op without a package.json. */
+export function addDeps(tree: Tree, deps: Record<string, string>): void {
+  if (!tree.exists('package.json')) return;
+  const pkg = JSON.parse(tree.read('package.json')!.toString('utf-8'));
+  pkg.dependencies = pkg.dependencies || {};
+  for (const [name, version] of Object.entries(deps)) {
+    if (!pkg.dependencies[name]) pkg.dependencies[name] = version;
+  }
+  tree.overwrite('package.json', JSON.stringify(pkg, null, 2));
+}

package/schematics/utils/schematic-prompt.util.d.ts

@@ -0,0 +1,7 @@
+import { SchematicContext } from '@angular-devkit/schematics';
+export declare function loadPrompts(context: SchematicContext, flagsProvided: boolean): any | undefined;
+export declare function askText(prompts: any | undefined, message: string, fallback: string): Promise<string>;
+export declare function askConfirm(prompts: any | undefined, message: string, fallback: boolean): Promise<boolean>;
+export declare function askSelect<T extends string>(prompts: any | undefined, message: string, choices: readonly T[], fallback: T): Promise<T>;
+export declare function askNumber(prompts: any | undefined, message: string, fallback: number | undefined): Promise<number | undefined>;
+export declare function logOutcome(context: SchematicContext, what: string, outcome: 'created' | 'updated' | 'unchanged'): void;

package/schematics/utils/schematic-prompt.util.js

@@ -0,0 +1,57 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadPrompts = loadPrompts;
+exports.askText = askText;
+exports.askConfirm = askConfirm;
+exports.askSelect = askSelect;
+exports.askNumber = askNumber;
+exports.logOutcome = logOutcome;
+function loadPrompts(context, flagsProvided) {
+    const isTty = !!process.stdout && !!process.stdout.isTTY;
+    const canPrompt = isTty && !process.env.CI && !flagsProvided;
+    if (!canPrompt)
+        return undefined;
+    try {
+        return require('@inquirer/prompts');
+    }
+    catch {
+        context.logger.warn('[rlb-amqp] @inquirer/prompts not found; falling back to flags/defaults.');
+        return undefined;
+    }
+}
+async function askText(prompts, message, fallback) {
+    if (!prompts)
+        return fallback;
+    return (await prompts.input({ message, default: fallback })) || fallback;
+}
+async function askConfirm(prompts, message, fallback) {
+    if (!prompts)
+        return fallback;
+    return prompts.confirm({ message, default: fallback });
+}
+async function askSelect(prompts, message, choices, fallback) {
+    if (!prompts)
+        return fallback;
+    return prompts.select({
+        message,
+        default: fallback,
+        choices: choices.map((c) => ({ name: c, value: c })),
+    });
+}
+async function askNumber(prompts, message, fallback) {
+    if (!prompts)
+        return fallback;
+    const raw = await prompts.input({
+        message,
+        default: fallback === undefined ? '' : String(fallback),
+    });
+    if (!raw?.trim())
+        return fallback;
+    const n = Number(raw);
+    return Number.isFinite(n) ? n : fallback;
+}
+function logOutcome(context, what, outcome) {
+    const verb = outcome === 'created' ? 'created' : outcome === 'updated' ? 'updated' : 'already present';
+    context.logger.info(`[rlb-amqp] ${what}: ${verb}.`);
+}
+//# sourceMappingURL=schematic-prompt.util.js.map

package/schematics/utils/schematic-prompt.util.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schematic-prompt.util.js","sourceRoot":"","sources":["../../../libs/rlb-nestjs-amqp/src/schematics/utils/schematic-prompt.util.ts"],"names":[],"mappings":";;AASA,kCAWC;AAGD,0BAOC;AAGD,gCAOC;AAGD,8BAYC;AAGD,8BAaC;AAGD,gCAOC;AAxED,SAAgB,WAAW,CAAC,OAAyB,EAAE,aAAsB;IAC3E,MAAM,KAAK,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,IAAI,CAAC,CAAE,OAAO,CAAC,MAAyC,CAAC,KAAK,CAAC;IAC7F,MAAM,SAAS,GAAG,KAAK,IAAI,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,IAAI,CAAC,aAAa,CAAC;IAC7D,IAAI,CAAC,SAAS;QAAE,OAAO,SAAS,CAAC;IACjC,IAAI,CAAC;QAEH,OAAO,OAAO,CAAC,mBAAmB,CAAC,CAAC;IACtC,CAAC;IAAC,MAAM,CAAC;QACP,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,yEAAyE,CAAC,CAAC;QAC/F,OAAO,SAAS,CAAC;IACnB,CAAC;AACH,CAAC;AAGM,KAAK,UAAU,OAAO,CAC3B,OAAwB,EACxB,OAAe,EACf,QAAgB;IAEhB,IAAI,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,CAAC,MAAM,OAAO,CAAC,KAAK,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC,IAAI,QAAQ,CAAC;AAC3E,CAAC;AAGM,KAAK,UAAU,UAAU,CAC9B,OAAwB,EACxB,OAAe,EACf,QAAiB;IAEjB,IAAI,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,OAAO,CAAC,OAAO,CAAC,EAAE,OAAO,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAC;AACzD,CAAC;AAGM,KAAK,UAAU,SAAS,CAC7B,OAAwB,EACxB,OAAe,EACf,OAAqB,EACrB,QAAW;IAEX,IAAI,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC;IAC9B,OAAO,OAAO,CAAC,MAAM,CAAC;QACpB,OAAO;QACP,OAAO,EAAE,QAAQ;QACjB,OAAO,EAAE,OAAO,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,EAAE,IAAI,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,CAAC,CAAC;KACrD,CAAC,CAAC;AACL,CAAC;AAGM,KAAK,UAAU,SAAS,CAC7B,OAAwB,EACxB,OAAe,EACf,QAA4B;IAE5B,IAAI,CAAC,OAAO;QAAE,OAAO,QAAQ,CAAC;IAC9B,MAAM,GAAG,GAAW,MAAM,OAAO,CAAC,KAAK,CAAC;QACtC,OAAO;QACP,OAAO,EAAE,QAAQ,KAAK,SAAS,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,QAAQ,CAAC;KACxD,CAAC,CAAC;IACH,IAAI,CAAC,GAAG,EAAE,IAAI,EAAE;QAAE,OAAO,QAAQ,CAAC;IAClC,MAAM,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;IACtB,OAAO,MAAM,CAAC,QAAQ,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,QAAQ,CAAC;AAC3C,CAAC;AAGD,SAAgB,UAAU,CACxB,OAAyB,EACzB,IAAY,EACZ,OAA4C;IAE5C,MAAM,IAAI,GAAG,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,OAAO,KAAK,SAAS,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,iBAAiB,CAAC;IACvG,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,IAAI,KAAK,IAAI,GAAG,CAAC,CAAC;AACtD,CAAC"}

package/schematics/utils/schematic-prompt.util.ts

@@ -0,0 +1,82 @@
+import { SchematicContext } from '@angular-devkit/schematics';
+
+/**
+ * Shared interactive-prompt plumbing for the YAML schematics, mirroring nest-add's behaviour:
+ * prompt only when attached to a TTY, not in CI, and no flags were provided; otherwise fall back
+ * to the flags/defaults so the schematics stay CI-safe and scriptable.
+ */
+
+/** Returns the `@inquirer/prompts` module when interactive, or `undefined` to signal "use defaults". */
+export function loadPrompts(context: SchematicContext, flagsProvided: boolean): any | undefined {
+  const isTty = !!process.stdout && !!(process.stdout as unknown as { isTTY?: boolean }).isTTY;
+  const canPrompt = isTty && !process.env.CI && !flagsProvided;
+  if (!canPrompt) return undefined;
+  try {
+    // eslint-disable-next-line @typescript-eslint/no-var-requires
+    return require('@inquirer/prompts');
+  } catch {
+    context.logger.warn('[rlb-amqp] @inquirer/prompts not found; falling back to flags/defaults.');
+    return undefined;
+  }
+}
+
+/** Ask for a string, or return `fallback` when non-interactive. */
+export async function askText(
+  prompts: any | undefined,
+  message: string,
+  fallback: string,
+): Promise<string> {
+  if (!prompts) return fallback;
+  return (await prompts.input({ message, default: fallback })) || fallback;
+}
+
+/** Ask yes/no, or return `fallback` when non-interactive. */
+export async function askConfirm(
+  prompts: any | undefined,
+  message: string,
+  fallback: boolean,
+): Promise<boolean> {
+  if (!prompts) return fallback;
+  return prompts.confirm({ message, default: fallback });
+}
+
+/** Ask to pick one of `choices`, or return `fallback` when non-interactive. */
+export async function askSelect<T extends string>(
+  prompts: any | undefined,
+  message: string,
+  choices: readonly T[],
+  fallback: T,
+): Promise<T> {
+  if (!prompts) return fallback;
+  return prompts.select({
+    message,
+    default: fallback,
+    choices: choices.map((c) => ({ name: c, value: c })),
+  });
+}
+
+/** Ask for a positive integer, or return `fallback` when non-interactive. Empty input → fallback. */
+export async function askNumber(
+  prompts: any | undefined,
+  message: string,
+  fallback: number | undefined,
+): Promise<number | undefined> {
+  if (!prompts) return fallback;
+  const raw: string = await prompts.input({
+    message,
+    default: fallback === undefined ? '' : String(fallback),
+  });
+  if (!raw?.trim()) return fallback;
+  const n = Number(raw);
+  return Number.isFinite(n) ? n : fallback;
+}
+
+/** Log a `created/updated/unchanged` outcome consistently across schematics. */
+export function logOutcome(
+  context: SchematicContext,
+  what: string,
+  outcome: 'created' | 'updated' | 'unchanged',
+): void {
+  const verb = outcome === 'created' ? 'created' : outcome === 'updated' ? 'updated' : 'already present';
+  context.logger.info(`[rlb-amqp] ${what}: ${verb}.`);
+}

package/schematics/utils/yaml-config.util.d.ts

@@ -0,0 +1,22 @@
+import { Tree } from '@angular-devkit/schematics';
+import { Document, YAMLMap, YAMLSeq } from 'yaml';
+export declare const DEFAULT_CONFIG_PATH = "config/config.yaml";
+export type UpsertOutcome = 'created' | 'updated' | 'unchanged';
+export declare function findConfigYaml(tree: Tree, preferred?: string): string;
+export declare function readConfigDoc(tree: Tree, path: string): {
+    doc: Document;
+    existed: boolean;
+};
+export declare function writeConfigDoc(tree: Tree, path: string, doc: Document): void;
+export declare function ensureSeqAt(doc: Document, path: (string | number)[]): YAMLSeq;
+export declare function ensureMapAt(doc: Document, path: (string | number)[]): YAMLMap;
+export declare function findSeqItemByKey(doc: Document, path: (string | number)[], keyField: string, key: string): YAMLMap | undefined;
+export declare function seqItemExists(doc: Document, path: (string | number)[], keyField: string, key: string): boolean;
+export interface UpsertOptions {
+    overwrite?: boolean;
+    commentBefore?: string;
+}
+export declare function upsertSeqItemByKey(doc: Document, path: (string | number)[], keyField: string, item: Record<string, unknown>, opts?: UpsertOptions): UpsertOutcome;
+export declare function setIn(doc: Document, path: (string | number)[], value: unknown): UpsertOutcome;
+export declare function deleteSeqItemByKey(doc: Document, path: (string | number)[], keyField: string, key: string): boolean;
+export declare function getScalar(doc: Document, path: (string | number)[]): unknown;