@open-rlb/nestjs-amqp 2.1.0 → 2.2.0

package/schematics/enable-load-config/index.ts

@@ -0,0 +1,39 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { askText, loadPrompts, logOutcome } from '../utils/schematic-prompt.util';
+import { findConfigYaml, readConfigDoc, setIn, writeConfigDoc } from '../utils/yaml-config.util';
+import { EnableLoadConfigOptions } from './schema';
+
+/**
+ * `enable-load-config` — add `gateway.loadConfig.paths` (and optionally `.events`) so the gateway
+ * pulls DB-managed routes/events and merges them with the YAML paths on every (re)load. Idempotent
+ * + comment-preserving.
+ */
+export function main(options: EnableLoadConfigOptions): Rule {
+  return async (tree: Tree, context: SchematicContext) => {
+    const flagsProvided = options.pathsTopic !== undefined || options.eventsTopic !== undefined;
+    const prompts = loadPrompts(context, flagsProvided);
+
+    const pathsTopic = options.pathsTopic || (await askText(prompts, 'Paths export topic?', 'rlb-gateway-admin'));
+    const pathsAction = options.pathsAction || (await askText(prompts, 'Paths export action?', 'gw-path-export'));
+
+    const configPath = findConfigYaml(tree, options.config);
+    const { doc, existed } = readConfigDoc(tree, configPath);
+    if (!existed) context.logger.info(`[rlb-amqp] ${configPath} not found — creating it.`);
+
+    const pOutcome = setIn(doc, ['gateway', 'loadConfig', 'paths'], { topic: pathsTopic, action: pathsAction });
+    logOutcome(context, 'gateway.loadConfig.paths', pOutcome);
+
+    if (options.eventsTopic && options.eventsAction) {
+      const eOutcome = setIn(doc, ['gateway', 'loadConfig', 'events'], {
+        topic: options.eventsTopic,
+        action: options.eventsAction,
+      });
+      logOutcome(context, 'gateway.loadConfig.events', eOutcome);
+    } else if (options.eventsTopic || options.eventsAction) {
+      context.logger.warn('[rlb-amqp] enable-load-config: events needs BOTH eventsTopic and eventsAction — skipped.');
+    }
+
+    writeConfigDoc(tree, configPath, doc);
+    return tree;
+  };
+}

package/schematics/enable-load-config/schema.d.ts

@@ -0,0 +1,8 @@
+export interface EnableLoadConfigOptions {
+    pathsTopic?: string;
+    pathsAction?: string;
+    eventsTopic?: string;
+    eventsAction?: string;
+    overwrite?: boolean;
+    config?: string;
+}

package/schematics/enable-load-config/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/schematics/enable-load-config/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../libs/rlb-nestjs-amqp/src/schematics/enable-load-config/schema.ts"],"names":[],"mappings":""}

package/schematics/enable-load-config/schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsRlbAmqpEnableLoadConfig",
+  "title": "Add gateway.loadConfig (pull DB-managed routes/events on (re)load)",
+  "type": "object",
+  "properties": {
+    "pathsTopic": {
+      "type": "string",
+      "default": "rlb-gateway-admin",
+      "description": "Topic the gateway pulls DB-managed paths from."
+    },
+    "pathsAction": {
+      "type": "string",
+      "default": "gw-path-export",
+      "description": "Action for the paths export."
+    },
+    "eventsTopic": {
+      "type": "string",
+      "description": "Topic the gateway pulls DB-managed events from (optional; requires eventsAction)."
+    },
+    "eventsAction": {
+      "type": "string",
+      "description": "Action for the events export (optional; requires eventsTopic)."
+    },
+    "overwrite": {
+      "type": "boolean",
+      "default": false,
+      "description": "Update the entries if they already exist."
+    },
+    "config": {
+      "type": "string",
+      "description": "Path to config.yaml (default: auto-detected)."
+    }
+  },
+  "required": []
+}

package/schematics/enable-load-config/schema.ts

@@ -0,0 +1,14 @@
+export interface EnableLoadConfigOptions {
+  /** Topic the gateway pulls DB-managed paths from. Default: 'rlb-gateway-admin'. */
+  pathsTopic?: string;
+  /** Action for the paths export. Default: 'gw-path-export'. */
+  pathsAction?: string;
+  /** Topic the gateway pulls DB-managed events from (optional; both events options required together). */
+  eventsTopic?: string;
+  /** Action for the events export (optional; both events options required together). */
+  eventsAction?: string;
+  /** Update the entries when they already exist (default: overwrite the scalar values). */
+  overwrite?: boolean;
+  /** Path to config.yaml (default: auto-detected, typically config/config.yaml). */
+  config?: string;
+}

package/schematics/enable-retry/index.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '@angular-devkit/schematics';
+import { EnableRetryOptions } from './schema';
+export declare function main(options: EnableRetryOptions): Rule;

package/schematics/enable-retry/index.js

@@ -0,0 +1,51 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const broker_yaml_util_1 = require("../utils/broker-yaml.util");
+const schematic_prompt_util_1 = require("../utils/schematic-prompt.util");
+const yaml_config_util_1 = require("../utils/yaml-config.util");
+function main(options) {
+    return async (tree, context) => {
+        const flagsProvided = options.scope !== undefined || options.maxAttempts !== undefined;
+        const prompts = (0, schematic_prompt_util_1.loadPrompts)(context, flagsProvided);
+        const scope = options.scope || (await (0, schematic_prompt_util_1.askSelect)(prompts, 'Retry scope?', ['broker', 'topic'], 'broker'));
+        const maxAttempts = options.maxAttempts ?? (await (0, schematic_prompt_util_1.askNumber)(prompts, 'Max attempts?', 5)) ?? 5;
+        const delayMs = options.delayMs ?? (await (0, schematic_prompt_util_1.askNumber)(prompts, 'Delay between attempts (ms)?', 0)) ?? 0;
+        const dlx = options.deadLetterExchange;
+        const onExhausted = options.onExhausted ?? (dlx ? 'dead-letter' : 'drop');
+        const retry = { maxAttempts, delayMs, onExhausted };
+        if (dlx) {
+            retry.deadLetter = { exchange: dlx, ...(options.deadLetterRoutingKey ? { routingKey: options.deadLetterRoutingKey } : {}) };
+        }
+        const configPath = (0, yaml_config_util_1.findConfigYaml)(tree, options.config);
+        const { doc, existed } = (0, yaml_config_util_1.readConfigDoc)(tree, configPath);
+        if (!existed)
+            context.logger.info(`[rlb-amqp] ${configPath} not found — creating it.`);
+        if (onExhausted === 'dead-letter' && dlx && (options.declareDlx ?? true)) {
+            const dlxOutcome = (0, broker_yaml_util_1.ensureExchange)(doc, { name: dlx, type: options.dlxType ?? 'topic' });
+            (0, schematic_prompt_util_1.logOutcome)(context, `dead-letter exchange '${dlx}'`, dlxOutcome);
+        }
+        if (scope === 'broker') {
+            const outcome = (0, yaml_config_util_1.setIn)(doc, ['broker', 'retry'], retry);
+            (0, schematic_prompt_util_1.logOutcome)(context, 'broker.retry', outcome);
+        }
+        else {
+            const topic = options.topic;
+            if (!topic) {
+                context.logger.error('[rlb-amqp] enable-retry: --topic is required when scope=topic.');
+                return tree;
+            }
+            const item = (0, yaml_config_util_1.findSeqItemByKey)(doc, ['topics'], 'name', topic);
+            if (!item) {
+                context.logger.warn(`[rlb-amqp] enable-retry: topic ${topic} not found in topics[]`);
+            }
+            else {
+                item.set('retry', doc.createNode(retry));
+                (0, schematic_prompt_util_1.logOutcome)(context, `topics[${topic}].retry`, 'updated');
+            }
+        }
+        (0, yaml_config_util_1.writeConfigDoc)(tree, configPath, doc);
+        return tree;
+    };
+}
+//# sourceMappingURL=index.js.map

package/schematics/enable-retry/index.js.map

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

package/schematics/enable-retry/index.spec.ts

@@ -0,0 +1,73 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { parseDocument } from 'yaml';
+import { main } from './index';
+import { EnableRetryOptions } from './schema';
+
+/** Invoke the factory Rule directly (SchematicTestRunner eagerly loads ESM `ora`). */
+const ctx = { logger: { info() {}, warn() {}, error() {} } } as unknown as SchematicContext;
+
+async function run(options: EnableRetryOptions, tree: Tree): Promise<Tree> {
+  const rule = main(options) as Rule;
+  const result = await (rule as (t: Tree, c: SchematicContext) => Promise<Tree>)(tree, ctx);
+  return result || tree;
+}
+
+function read(tree: Tree, path = 'config/config.yaml'): string {
+  return tree.read(path)!.toString('utf-8');
+}
+function doc(tree: Tree) {
+  return parseDocument(read(tree));
+}
+function seedConfig(): Tree {
+  const tree = Tree.empty();
+  tree.create(
+    'config/config.yaml',
+    ['# my config', 'broker:', '  exchanges:', '    - name: rlb', '      type: direct', 'topics:', '  - name: orders', '    mode: handle', ''].join('\n'),
+  );
+  return tree;
+}
+
+describe('enable-retry schematic', () => {
+  it('sets broker.retry with the resolved onExhausted default', async () => {
+    const tree = await run({ scope: 'broker', maxAttempts: 3, delayMs: 100 }, seedConfig());
+    const retry = doc(tree).getIn(['broker', 'retry']) as any;
+    expect(Number(retry.get('maxAttempts'))).toBe(3);
+    expect(Number(retry.get('delayMs'))).toBe(100);
+    expect(String(retry.get('onExhausted'))).toBe('drop'); // no DLX set
+    expect(read(tree)).toContain('# my config');
+  });
+
+  it('is idempotent: re-running with the same values leaves broker.retry unchanged', async () => {
+    let tree = await run({ scope: 'broker', maxAttempts: 5 }, seedConfig());
+    const first = read(tree);
+    tree = await run({ scope: 'broker', maxAttempts: 5 }, tree);
+    expect(read(tree)).toBe(first);
+  });
+
+  it('declares the dead-letter exchange in broker.exchanges when dead-lettering', async () => {
+    const tree = await run(
+      { scope: 'broker', deadLetterExchange: 'rlb-dlx', deadLetterRoutingKey: 'dead' },
+      seedConfig(),
+    );
+    const exchanges = doc(tree).getIn(['broker', 'exchanges']) as any;
+    const names = exchanges.items.map((i: any) => String(i.get('name')));
+    expect(names).toContain('rlb-dlx');
+    const dlx = exchanges.items.find((i: any) => String(i.get('name')) === 'rlb-dlx');
+    expect(String(dlx.get('type'))).toBe('topic');
+    const retry = doc(tree).getIn(['broker', 'retry']) as any;
+    expect(String(retry.get('onExhausted'))).toBe('dead-letter');
+    expect(String(retry.getIn(['deadLetter', 'exchange']))).toBe('rlb-dlx');
+    expect(String(retry.getIn(['deadLetter', 'routingKey']))).toBe('dead');
+  });
+
+  it('scope=topic sets topics[<name>].retry on the matching topic', async () => {
+    const tree = await run({ scope: 'topic', topic: 'orders', maxAttempts: 2 }, seedConfig());
+    const topic = (doc(tree).getIn(['topics']) as any).items.find((i: any) => String(i.get('name')) === 'orders');
+    expect(Number(topic.getIn(['retry', 'maxAttempts']))).toBe(2);
+  });
+
+  it('scope=topic warns and makes no change when the topic is missing', async () => {
+    const tree = await run({ scope: 'topic', topic: 'ghost', maxAttempts: 2 }, seedConfig());
+    expect(doc(tree).getIn(['broker', 'retry'])).toBeUndefined();
+  });
+});

package/schematics/enable-retry/index.ts

@@ -0,0 +1,62 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { ensureExchange, ExchangeType, RetrySpec } from '../utils/broker-yaml.util';
+import { askNumber, askSelect, loadPrompts, logOutcome } from '../utils/schematic-prompt.util';
+import { findConfigYaml, findSeqItemByKey, readConfigDoc, setIn, writeConfigDoc } from '../utils/yaml-config.util';
+import { EnableRetryOptions } from './schema';
+
+/**
+ * `enable-retry` — configure the 2.1.x bounded retry policy that replaces the old infinite-requeue
+ * behaviour (built-in default is 5 attempts → drop). Its real value-add is DECLARING the dead-letter
+ * exchange in broker.exchanges automatically, since retry.deadLetter.exchange must resolve to a real
+ * declared exchange. Writes to broker.retry (broker-wide default) or topics[<name>].retry.
+ */
+export function main(options: EnableRetryOptions): Rule {
+  return async (tree: Tree, context: SchematicContext) => {
+    const flagsProvided = options.scope !== undefined || options.maxAttempts !== undefined;
+    const prompts = loadPrompts(context, flagsProvided);
+
+    const scope = options.scope || (await askSelect(prompts, 'Retry scope?', ['broker', 'topic'] as const, 'broker'));
+    const maxAttempts = options.maxAttempts ?? (await askNumber(prompts, 'Max attempts?', 5)) ?? 5;
+    const delayMs = options.delayMs ?? (await askNumber(prompts, 'Delay between attempts (ms)?', 0)) ?? 0;
+
+    // onExhausted defaults to dead-letter only when a DLX is actually configured, else drop.
+    const dlx = options.deadLetterExchange;
+    const onExhausted = options.onExhausted ?? (dlx ? 'dead-letter' : 'drop');
+
+    const retry: RetrySpec = { maxAttempts, delayMs, onExhausted };
+    if (dlx) {
+      retry.deadLetter = { exchange: dlx, ...(options.deadLetterRoutingKey ? { routingKey: options.deadLetterRoutingKey } : {}) };
+    }
+
+    const configPath = findConfigYaml(tree, options.config);
+    const { doc, existed } = readConfigDoc(tree, configPath);
+    if (!existed) context.logger.info(`[rlb-amqp] ${configPath} not found — creating it.`);
+
+    // Declare the DLX so retry.deadLetter points at a real exchange (the schematic's main value).
+    if (onExhausted === 'dead-letter' && dlx && (options.declareDlx ?? true)) {
+      const dlxOutcome = ensureExchange(doc, { name: dlx, type: (options.dlxType as ExchangeType) ?? 'topic' });
+      logOutcome(context, `dead-letter exchange '${dlx}'`, dlxOutcome);
+    }
+
+    if (scope === 'broker') {
+      const outcome = setIn(doc, ['broker', 'retry'], retry);
+      logOutcome(context, 'broker.retry', outcome);
+    } else {
+      const topic = options.topic;
+      if (!topic) {
+        context.logger.error('[rlb-amqp] enable-retry: --topic is required when scope=topic.');
+        return tree;
+      }
+      const item = findSeqItemByKey(doc, ['topics'], 'name', topic);
+      if (!item) {
+        context.logger.warn(`[rlb-amqp] enable-retry: topic ${topic} not found in topics[]`);
+      } else {
+        item.set('retry', doc.createNode(retry));
+        logOutcome(context, `topics[${topic}].retry`, 'updated');
+      }
+    }
+
+    writeConfigDoc(tree, configPath, doc);
+    return tree;
+  };
+}

package/schematics/enable-retry/schema.d.ts

@@ -0,0 +1,13 @@
+export interface EnableRetryOptions {
+    scope?: 'broker' | 'topic';
+    topic?: string;
+    maxAttempts?: number;
+    delayMs?: number;
+    onExhausted?: 'dead-letter' | 'drop';
+    deadLetterExchange?: string;
+    deadLetterRoutingKey?: string;
+    declareDlx?: boolean;
+    dlxType?: 'direct' | 'topic' | 'fanout' | 'headers';
+    overwrite?: boolean;
+    config?: string;
+}

package/schematics/enable-retry/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/schematics/enable-retry/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../libs/rlb-nestjs-amqp/src/schematics/enable-retry/schema.ts"],"names":[],"mappings":""}

package/schematics/enable-retry/schema.json

@@ -0,0 +1,64 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsRlbAmqpEnableRetry",
+  "title": "Configure a bounded retry policy in config.yaml",
+  "type": "object",
+  "properties": {
+    "scope": {
+      "type": "string",
+      "enum": ["broker", "topic"],
+      "default": "broker",
+      "description": "Broker-wide default (broker.retry) or a single topic (topics[].retry).",
+      "x-prompt": "Retry scope?",
+      "$default": { "$source": "argv", "index": 0 }
+    },
+    "topic": {
+      "type": "string",
+      "description": "Topic name (required when scope=topic)."
+    },
+    "maxAttempts": {
+      "type": "number",
+      "default": 5,
+      "description": "Bounded attempt count before dead-lettering/dropping."
+    },
+    "delayMs": {
+      "type": "number",
+      "default": 0,
+      "description": "Delay between attempts (ms)."
+    },
+    "onExhausted": {
+      "type": "string",
+      "enum": ["dead-letter", "drop"],
+      "description": "What to do once attempts are exhausted (default: dead-letter when a DLX is set, else drop)."
+    },
+    "deadLetterExchange": {
+      "type": "string",
+      "description": "Dead-letter exchange to route exhausted messages to."
+    },
+    "deadLetterRoutingKey": {
+      "type": "string",
+      "description": "Routing key used when dead-lettering (omitted when unset)."
+    },
+    "declareDlx": {
+      "type": "boolean",
+      "default": true,
+      "description": "Also declare the DLX in broker.exchanges."
+    },
+    "dlxType": {
+      "type": "string",
+      "enum": ["direct", "topic", "fanout", "headers"],
+      "default": "topic",
+      "description": "Type of the declared DLX."
+    },
+    "overwrite": {
+      "type": "boolean",
+      "default": false,
+      "description": "Update the retry block if it already exists."
+    },
+    "config": {
+      "type": "string",
+      "description": "Path to config.yaml (default: auto-detected)."
+    }
+  },
+  "required": []
+}

package/schematics/enable-retry/schema.ts

@@ -0,0 +1,24 @@
+export interface EnableRetryOptions {
+  /** Where the retry policy lives: broker-wide default or a single topic. Default: 'broker'. */
+  scope?: 'broker' | 'topic';
+  /** Topic name — required when scope=topic. */
+  topic?: string;
+  /** Bounded attempt count before the message is dead-lettered/dropped. Default: 5. */
+  maxAttempts?: number;
+  /** Delay between attempts, in ms. Default: 0. */
+  delayMs?: number;
+  /** What to do once attempts are exhausted. Default: 'dead-letter' when a DLX is set, else 'drop'. */
+  onExhausted?: 'dead-letter' | 'drop';
+  /** Dead-letter exchange to route exhausted messages to. */
+  deadLetterExchange?: string;
+  /** Optional routing key used when dead-lettering. */
+  deadLetterRoutingKey?: string;
+  /** Also declare the DLX in broker.exchanges (this schematic's main value-add). Default: true. */
+  declareDlx?: boolean;
+  /** Type of the declared DLX. Default: 'topic'. */
+  dlxType?: 'direct' | 'topic' | 'fanout' | 'headers';
+  /** Update the retry block when it already exists (default: leave it untouched). */
+  overwrite?: boolean;
+  /** Path to config.yaml (default: auto-detected, typically config/config.yaml). */
+  config?: string;
+}

package/schematics/enable-route-discovery/index.d.ts

@@ -0,0 +1,3 @@
+import { Rule } from '@angular-devkit/schematics';
+import { EnableRouteDiscoveryOptions } from './schema';
+export declare function main(options: EnableRouteDiscoveryOptions): Rule;

package/schematics/enable-route-discovery/index.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const broker_yaml_util_1 = require("../utils/broker-yaml.util");
+const formatting_1 = require("../utils/formatting");
+const schematic_prompt_util_1 = require("../utils/schematic-prompt.util");
+const yaml_config_util_1 = require("../utils/yaml-config.util");
+function main(options) {
+    return async (tree, context) => {
+        const flagsProvided = options.serviceName !== undefined;
+        const prompts = (0, schematic_prompt_util_1.loadPrompts)(context, flagsProvided);
+        const rawName = options.serviceName || (await (0, schematic_prompt_util_1.askText)(prompts, 'Service name?', ''));
+        if (!rawName) {
+            context.logger.error('[rlb-amqp] enable-route-discovery: a serviceName is required.');
+            return tree;
+        }
+        const svc = (0, formatting_1.normalizeToKebabOrSnakeCase)(rawName);
+        const exchange = options.exchange || 'rlb-route-discovery';
+        const queue = options.queue || 'rlb-route-sync';
+        const publishOnBoot = options.publishOnBoot ?? true;
+        const configPath = (0, yaml_config_util_1.findConfigYaml)(tree, options.config);
+        const { doc, existed } = (0, yaml_config_util_1.readConfigDoc)(tree, configPath);
+        if (!existed)
+            context.logger.info(`[rlb-amqp] ${configPath} not found — creating it.`);
+        const outcome = (0, yaml_config_util_1.setIn)(doc, ['broker', 'routeDiscovery'], { serviceName: svc, publishOnBoot, exchange, queue });
+        (0, schematic_prompt_util_1.logOutcome)(context, 'broker.routeDiscovery', outcome);
+        if (options.declareExchange ?? true) {
+            const exOutcome = (0, broker_yaml_util_1.ensureExchange)(doc, { name: exchange, type: 'fanout' });
+            (0, schematic_prompt_util_1.logOutcome)(context, `discovery exchange '${exchange}'`, exOutcome);
+        }
+        context.logger.info(`[rlb-amqp] serviceName '${svc}' also fills connection_name when none is set (see set-connection-name).`);
+        (0, yaml_config_util_1.writeConfigDoc)(tree, configPath, doc);
+        return tree;
+    };
+}
+//# sourceMappingURL=index.js.map

package/schematics/enable-route-discovery/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../libs/rlb-nestjs-amqp/src/schematics/enable-route-discovery/index.ts"],"names":[],"mappings":";;AAYA,oBAmCC;AA9CD,gEAA2D;AAC3D,oDAAkE;AAClE,0EAAkF;AAClF,gEAAiG;AAQjG,SAAgB,IAAI,CAAC,OAAoC;IACvD,OAAO,KAAK,EAAE,IAAU,EAAE,OAAyB,EAAE,EAAE;QACrD,MAAM,aAAa,GAAG,OAAO,CAAC,WAAW,KAAK,SAAS,CAAC;QACxD,MAAM,OAAO,GAAG,IAAA,mCAAW,EAAC,OAAO,EAAE,aAAa,CAAC,CAAC;QAEpD,MAAM,OAAO,GAAG,OAAO,CAAC,WAAW,IAAI,CAAC,MAAM,IAAA,+BAAO,EAAC,OAAO,EAAE,eAAe,EAAE,EAAE,CAAC,CAAC,CAAC;QACrF,IAAI,CAAC,OAAO,EAAE,CAAC;YACb,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,+DAA+D,CAAC,CAAC;YACtF,OAAO,IAAI,CAAC;QACd,CAAC;QACD,MAAM,GAAG,GAAG,IAAA,wCAA2B,EAAC,OAAO,CAAC,CAAC;QACjD,MAAM,QAAQ,GAAG,OAAO,CAAC,QAAQ,IAAI,qBAAqB,CAAC;QAC3D,MAAM,KAAK,GAAG,OAAO,CAAC,KAAK,IAAI,gBAAgB,CAAC;QAChD,MAAM,aAAa,GAAG,OAAO,CAAC,aAAa,IAAI,IAAI,CAAC;QAEpD,MAAM,UAAU,GAAG,IAAA,iCAAc,EAAC,IAAI,EAAE,OAAO,CAAC,MAAM,CAAC,CAAC;QACxD,MAAM,EAAE,GAAG,EAAE,OAAO,EAAE,GAAG,IAAA,gCAAa,EAAC,IAAI,EAAE,UAAU,CAAC,CAAC;QACzD,IAAI,CAAC,OAAO;YAAE,OAAO,CAAC,MAAM,CAAC,IAAI,CAAC,cAAc,UAAU,2BAA2B,CAAC,CAAC;QAEvF,MAAM,OAAO,GAAG,IAAA,wBAAK,EAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,gBAAgB,CAAC,EAAE,EAAE,WAAW,EAAE,GAAG,EAAE,aAAa,EAAE,QAAQ,EAAE,KAAK,EAAE,CAAC,CAAC;QAC/G,IAAA,kCAAU,EAAC,OAAO,EAAE,uBAAuB,EAAE,OAAO,CAAC,CAAC;QAGtD,IAAI,OAAO,CAAC,eAAe,IAAI,IAAI,EAAE,CAAC;YACpC,MAAM,SAAS,GAAG,IAAA,iCAAc,EAAC,GAAG,EAAE,EAAE,IAAI,EAAE,QAAQ,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;YAC1E,IAAA,kCAAU,EAAC,OAAO,EAAE,uBAAuB,QAAQ,GAAG,EAAE,SAAS,CAAC,CAAC;QACrE,CAAC;QAED,OAAO,CAAC,MAAM,CAAC,IAAI,CACjB,2BAA2B,GAAG,0EAA0E,CACzG,CAAC;QAEF,IAAA,iCAAc,EAAC,IAAI,EAAE,UAAU,EAAE,GAAG,CAAC,CAAC;QACtC,OAAO,IAAI,CAAC;IACd,CAAC,CAAC;AACJ,CAAC"}

package/schematics/enable-route-discovery/index.spec.ts

@@ -0,0 +1,55 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { parseDocument } from 'yaml';
+import { main } from './index';
+import { EnableRouteDiscoveryOptions } from './schema';
+
+/** Invoke the factory Rule directly (SchematicTestRunner eagerly loads ESM `ora`). */
+const ctx = { logger: { info() {}, warn() {}, error() {} } } as unknown as SchematicContext;
+
+async function run(options: EnableRouteDiscoveryOptions, tree: Tree): Promise<Tree> {
+  const rule = main(options) as Rule;
+  const result = await (rule as (t: Tree, c: SchematicContext) => Promise<Tree>)(tree, ctx);
+  return result || tree;
+}
+
+function read(tree: Tree, path = 'config/config.yaml'): string {
+  return tree.read(path)!.toString('utf-8');
+}
+function doc(tree: Tree) {
+  return parseDocument(read(tree));
+}
+function seedConfig(): Tree {
+  const tree = Tree.empty();
+  tree.create('config/config.yaml', ['# my config', 'broker:', '  exchanges: []', 'topics: []', ''].join('\n'));
+  return tree;
+}
+
+describe('enable-route-discovery schematic', () => {
+  it('sets broker.routeDiscovery and kebab-normalizes the service name', async () => {
+    const tree = await run({ serviceName: 'OrderService' }, seedConfig());
+    const rd = doc(tree).getIn(['broker', 'routeDiscovery']) as any;
+    expect(String(rd.get('serviceName'))).toBe('order-service');
+    expect(String(rd.get('exchange'))).toBe('rlb-route-discovery');
+    expect(String(rd.get('queue'))).toBe('rlb-route-sync');
+    expect(rd.get('publishOnBoot')).toBe(true);
+    expect(read(tree)).toContain('# my config');
+  });
+
+  it('declares the discovery exchange as fanout', async () => {
+    const tree = await run({ serviceName: 'billing' }, seedConfig());
+    const exchanges = doc(tree).getIn(['broker', 'exchanges']) as any;
+    const ex = exchanges.items.find((i: any) => String(i.get('name')) === 'rlb-route-discovery');
+    expect(ex).toBeDefined();
+    expect(String(ex.get('type'))).toBe('fanout');
+  });
+
+  it('is idempotent: re-running with the same values does not duplicate the exchange', async () => {
+    let tree = await run({ serviceName: 'billing' }, seedConfig());
+    const first = read(tree);
+    tree = await run({ serviceName: 'billing' }, tree);
+    expect(read(tree)).toBe(first);
+    const exchanges = doc(tree).getIn(['broker', 'exchanges']) as any;
+    const count = exchanges.items.filter((i: any) => String(i.get('name')) === 'rlb-route-discovery').length;
+    expect(count).toBe(1);
+  });
+});

package/schematics/enable-route-discovery/index.ts

@@ -0,0 +1,48 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { ensureExchange } from '../utils/broker-yaml.util';
+import { normalizeToKebabOrSnakeCase } from '../utils/formatting';
+import { askText, loadPrompts, logOutcome } from '../utils/schematic-prompt.util';
+import { findConfigYaml, readConfigDoc, setIn, writeConfigDoc } from '../utils/yaml-config.util';
+import { EnableRouteDiscoveryOptions } from './schema';
+
+/**
+ * `enable-route-discovery` — publisher-side route auto-discovery: the service publishes its route
+ * manifest on a fanout exchange so a gateway can sync it. Declares that fanout exchange automatically
+ * so the discovery wiring is complete in one shot.
+ */
+export function main(options: EnableRouteDiscoveryOptions): Rule {
+  return async (tree: Tree, context: SchematicContext) => {
+    const flagsProvided = options.serviceName !== undefined;
+    const prompts = loadPrompts(context, flagsProvided);
+
+    const rawName = options.serviceName || (await askText(prompts, 'Service name?', ''));
+    if (!rawName) {
+      context.logger.error('[rlb-amqp] enable-route-discovery: a serviceName is required.');
+      return tree;
+    }
+    const svc = normalizeToKebabOrSnakeCase(rawName);
+    const exchange = options.exchange || 'rlb-route-discovery';
+    const queue = options.queue || 'rlb-route-sync';
+    const publishOnBoot = options.publishOnBoot ?? true;
+
+    const configPath = findConfigYaml(tree, options.config);
+    const { doc, existed } = readConfigDoc(tree, configPath);
+    if (!existed) context.logger.info(`[rlb-amqp] ${configPath} not found — creating it.`);
+
+    const outcome = setIn(doc, ['broker', 'routeDiscovery'], { serviceName: svc, publishOnBoot, exchange, queue });
+    logOutcome(context, 'broker.routeDiscovery', outcome);
+
+    // A fanout exchange is the discovery bus; declare it so publish-on-boot has somewhere to go.
+    if (options.declareExchange ?? true) {
+      const exOutcome = ensureExchange(doc, { name: exchange, type: 'fanout' });
+      logOutcome(context, `discovery exchange '${exchange}'`, exOutcome);
+    }
+
+    context.logger.info(
+      `[rlb-amqp] serviceName '${svc}' also fills connection_name when none is set (see set-connection-name).`,
+    );
+
+    writeConfigDoc(tree, configPath, doc);
+    return tree;
+  };
+}

package/schematics/enable-route-discovery/schema.d.ts

@@ -0,0 +1,9 @@
+export interface EnableRouteDiscoveryOptions {
+    serviceName?: string;
+    exchange?: string;
+    queue?: string;
+    publishOnBoot?: boolean;
+    declareExchange?: boolean;
+    overwrite?: boolean;
+    config?: string;
+}

package/schematics/enable-route-discovery/schema.js

@@ -0,0 +1,3 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+//# sourceMappingURL=schema.js.map

package/schematics/enable-route-discovery/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../../../libs/rlb-nestjs-amqp/src/schematics/enable-route-discovery/schema.ts"],"names":[],"mappings":""}

package/schematics/enable-route-discovery/schema.json

@@ -0,0 +1,44 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsRlbAmqpEnableRouteDiscovery",
+  "title": "Enable publisher-side route auto-discovery in config.yaml",
+  "type": "object",
+  "properties": {
+    "serviceName": {
+      "type": "string",
+      "description": "Logical service name published for auto-discovery (kebab/snake-normalized).",
+      "x-prompt": "Service name?",
+      "$default": { "$source": "argv", "index": 0 }
+    },
+    "exchange": {
+      "type": "string",
+      "default": "rlb-route-discovery",
+      "description": "Discovery fanout exchange."
+    },
+    "queue": {
+      "type": "string",
+      "default": "rlb-route-sync",
+      "description": "Queue the gateway syncs from."
+    },
+    "publishOnBoot": {
+      "type": "boolean",
+      "default": true,
+      "description": "Publish the route manifest on boot."
+    },
+    "declareExchange": {
+      "type": "boolean",
+      "default": true,
+      "description": "Also declare the discovery exchange in broker.exchanges."
+    },
+    "overwrite": {
+      "type": "boolean",
+      "default": false,
+      "description": "Update broker.routeDiscovery if it already exists."
+    },
+    "config": {
+      "type": "string",
+      "description": "Path to config.yaml (default: auto-detected)."
+    }
+  },
+  "required": []
+}