@open-rlb/nestjs-amqp 2.1.0 → 2.2.0

package/schematics/add-exchange/schema.json

@@ -0,0 +1,50 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsRlbAmqpAddExchange",
+  "title": "Add a broker exchange to config.yaml",
+  "type": "object",
+  "properties": {
+    "name": {
+      "type": "string",
+      "description": "Exchange name (the key).",
+      "x-prompt": "Exchange name?",
+      "$default": { "$source": "argv", "index": 0 }
+    },
+    "type": {
+      "type": "string",
+      "enum": ["direct", "topic", "fanout", "headers"],
+      "default": "direct",
+      "description": "Exchange type."
+    },
+    "createIfNotExists": {
+      "type": "boolean",
+      "default": true,
+      "description": "Emit createExchangeIfNotExists (false => the exchange must pre-exist)."
+    },
+    "durable": { "type": "boolean", "default": true, "description": "options.durable" },
+    "autoDelete": { "type": "boolean", "default": false, "description": "options.autoDelete" },
+    "internal": { "type": "boolean", "default": false, "description": "options.internal" },
+    "withQueue": {
+      "type": "boolean",
+      "description": "Also create a queue bound to this exchange."
+    },
+    "queueName": {
+      "type": "string",
+      "description": "Name of the bound queue (default: the exchange name)."
+    },
+    "routingKey": {
+      "type": "string",
+      "description": "routingKey for the bound queue (required when type=topic; default: the queue name)."
+    },
+    "overwrite": {
+      "type": "boolean",
+      "default": false,
+      "description": "Update the entry if it already exists (default: leave it untouched)."
+    },
+    "config": {
+      "type": "string",
+      "description": "Path to config.yaml (default: auto-detected)."
+    }
+  },
+  "required": []
+}

package/schematics/add-exchange/schema.ts

@@ -0,0 +1,26 @@
+import { ExchangeType } from '../utils/broker-yaml.util';
+
+export interface AddExchangeOptions {
+  /** Exchange name (the key). Prompted when omitted. */
+  name?: string;
+  /** direct | topic | fanout | headers. Default: direct. */
+  type?: ExchangeType;
+  /** Emit `createExchangeIfNotExists`. Default: true. */
+  createIfNotExists?: boolean;
+  /** options.durable. Default: true. */
+  durable?: boolean;
+  /** options.autoDelete. Default: false. */
+  autoDelete?: boolean;
+  /** options.internal. Default: false. */
+  internal?: boolean;
+  /** Also create a queue bound to this exchange. */
+  withQueue?: boolean;
+  /** Name of that queue. Default: the exchange name. */
+  queueName?: string;
+  /** routingKey for the bound queue (required when type=topic). Default: the queue name. */
+  routingKey?: string;
+  /** Update the entry 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/add-exchange-binding/index.d.ts

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

package/schematics/add-exchange-binding/index.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+const yaml_1 = require("yaml");
+const schematic_prompt_util_1 = require("../utils/schematic-prompt.util");
+const yaml_config_util_1 = require("../utils/yaml-config.util");
+const BINDINGS = ['broker', 'exchangeBindings'];
+function main(options) {
+    return async (tree, context) => {
+        const flagsProvided = options.source !== undefined;
+        const prompts = (0, schematic_prompt_util_1.loadPrompts)(context, flagsProvided);
+        const source = options.source || (await (0, schematic_prompt_util_1.askText)(prompts, 'Source exchange?', ''));
+        const destination = options.destination || (await (0, schematic_prompt_util_1.askText)(prompts, 'Destination exchange?', ''));
+        if (!source || !destination) {
+            context.logger.error('[rlb-amqp] add-exchange-binding: source and destination are required.');
+            return tree;
+        }
+        const pattern = options.pattern ?? (await (0, schematic_prompt_util_1.askText)(prompts, 'Binding pattern (routing key)?', ''));
+        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 item = { source, destination, pattern };
+        if (options.args !== undefined)
+            item.args = options.args;
+        const seq = (0, yaml_config_util_1.ensureSeqAt)(doc, BINDINGS);
+        const existing = seq.items.find((it) => (0, yaml_1.isMap)(it) &&
+            String(it.get('source')) === String(source) &&
+            String(it.get('destination')) === String(destination) &&
+            String(it.get('pattern')) === String(pattern));
+        let outcome;
+        if (!existing) {
+            const node = doc.createNode(item);
+            seq.flow = false;
+            node.flow = false;
+            seq.add(node);
+            outcome = 'created';
+        }
+        else if (options.overwrite) {
+            const before = existing.toString();
+            for (const [k, v] of Object.entries(item))
+                existing.set(k, doc.createNode(v));
+            outcome = existing.toString() === before ? 'unchanged' : 'updated';
+        }
+        else {
+            outcome = 'unchanged';
+        }
+        (0, schematic_prompt_util_1.logOutcome)(context, `exchange binding '${source}' → '${destination}'`, outcome);
+        (0, yaml_config_util_1.writeConfigDoc)(tree, configPath, doc);
+        return tree;
+    };
+}
+//# sourceMappingURL=index.js.map

package/schematics/add-exchange-binding/index.js.map

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

package/schematics/add-exchange-binding/index.spec.ts

@@ -0,0 +1,73 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { parseDocument } from 'yaml';
+import { main } from './index';
+import { AddExchangeBindingOptions } from './schema';
+
+/**
+ * Invoke the factory Rule directly against a Tree (NOT SchematicTestRunner — it eagerly loads `ora`,
+ * an ESM-only module jest cannot transform here). Passing `source` makes `flagsProvided` true, so no
+ * interactive prompt is attempted.
+ */
+const ctx = { logger: { info() {}, warn() {}, error() {} } } as unknown as SchematicContext;
+
+async function run(options: AddExchangeBindingOptions, 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: []', ''].join('\n'),
+  );
+  return tree;
+}
+
+describe('add-exchange-binding schematic', () => {
+  it('appends a new binding, preserving comments', async () => {
+    const tree = await run({ source: 'rlb', destination: 'audit', pattern: 'order.*' }, seedConfig());
+    const bindings = doc(tree).getIn(['broker', 'exchangeBindings']) as any;
+    expect(bindings.items).toHaveLength(1);
+    expect(String(bindings.items[0].get('source'))).toBe('rlb');
+    expect(String(bindings.items[0].get('destination'))).toBe('audit');
+    expect(String(bindings.items[0].get('pattern'))).toBe('order.*');
+    expect(read(tree)).toContain('# my config');
+  });
+
+  it('is idempotent: re-adding the same triple leaves a single entry', async () => {
+    let tree = await run({ source: 'rlb', destination: 'audit', pattern: 'order.*' }, seedConfig());
+    tree = await run({ source: 'rlb', destination: 'audit', pattern: 'order.*' }, tree);
+    const bindings = doc(tree).getIn(['broker', 'exchangeBindings']) as any;
+    expect(bindings.items).toHaveLength(1);
+  });
+
+  it('treats a different pattern as a distinct binding', async () => {
+    let tree = await run({ source: 'rlb', destination: 'audit', pattern: 'order.*' }, seedConfig());
+    tree = await run({ source: 'rlb', destination: 'audit', pattern: 'user.*' }, tree);
+    const bindings = doc(tree).getIn(['broker', 'exchangeBindings']) as any;
+    expect(bindings.items).toHaveLength(2);
+  });
+
+  it('updates fields on an existing binding only when overwrite is set', async () => {
+    let tree = await run({ source: 'rlb', destination: 'audit', pattern: 'order.*' }, seedConfig());
+    tree = await run(
+      { source: 'rlb', destination: 'audit', pattern: 'order.*', args: { 'x-match': 'all' }, overwrite: true },
+      tree,
+    );
+    const binding = (doc(tree).getIn(['broker', 'exchangeBindings']) as any).items[0];
+    expect((binding.get('args') as any).get('x-match')).toBe('all');
+  });
+
+  it('creates config.yaml when it does not exist', async () => {
+    const tree = await run({ source: 'rlb', destination: 'audit', pattern: 'order.*' }, Tree.empty());
+    expect(tree.exists('config/config.yaml')).toBe(true);
+  });
+});

package/schematics/add-exchange-binding/index.ts

@@ -0,0 +1,64 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { isMap, YAMLMap } from 'yaml';
+import { askText, loadPrompts, logOutcome } from '../utils/schematic-prompt.util';
+import { ensureSeqAt, findConfigYaml, readConfigDoc, UpsertOutcome, writeConfigDoc } from '../utils/yaml-config.util';
+import { AddExchangeBindingOptions } from './schema';
+
+const BINDINGS = ['broker', 'exchangeBindings'];
+
+/**
+ * `add-exchange-binding` — idempotent upsert of a `broker.exchangeBindings[]` entry, comment-preserving.
+ * Unlike exchanges/queues/topics there is no single `name` key, so identity is the (source, destination,
+ * pattern) triple. We scan the seq for a matching item ourselves rather than reusing upsertSeqItemByKey.
+ */
+export function main(options: AddExchangeBindingOptions): Rule {
+  return async (tree: Tree, context: SchematicContext) => {
+    const flagsProvided = options.source !== undefined;
+    const prompts = loadPrompts(context, flagsProvided);
+
+    const source = options.source || (await askText(prompts, 'Source exchange?', ''));
+    const destination = options.destination || (await askText(prompts, 'Destination exchange?', ''));
+    if (!source || !destination) {
+      context.logger.error('[rlb-amqp] add-exchange-binding: source and destination are required.');
+      return tree;
+    }
+    const pattern = options.pattern ?? (await askText(prompts, 'Binding pattern (routing key)?', ''));
+
+    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 item: Record<string, unknown> = { source, destination, pattern };
+    if (options.args !== undefined) item.args = options.args;
+
+    const seq = ensureSeqAt(doc, BINDINGS);
+    // Identity = source + destination + pattern (pattern discriminates fanout vs. topic bindings).
+    const existing = seq.items.find(
+      (it): it is YAMLMap =>
+        isMap(it) &&
+        String(it.get('source')) === String(source) &&
+        String(it.get('destination')) === String(destination) &&
+        String(it.get('pattern')) === String(pattern),
+    );
+
+    let outcome: UpsertOutcome;
+    if (!existing) {
+      const node = doc.createNode(item) as YAMLMap;
+      // Keep the container block-styled even if it was seeded as an empty flow seq (`exchangeBindings: []`).
+      seq.flow = false;
+      node.flow = false;
+      seq.add(node);
+      outcome = 'created';
+    } else if (options.overwrite) {
+      const before = existing.toString();
+      for (const [k, v] of Object.entries(item)) existing.set(k, doc.createNode(v));
+      outcome = existing.toString() === before ? 'unchanged' : 'updated';
+    } else {
+      outcome = 'unchanged';
+    }
+    logOutcome(context, `exchange binding '${source}' → '${destination}'`, outcome);
+
+    writeConfigDoc(tree, configPath, doc);
+    return tree;
+  };
+}

package/schematics/add-exchange-binding/schema.d.ts

@@ -0,0 +1,8 @@
+export interface AddExchangeBindingOptions {
+    source?: string;
+    destination?: string;
+    pattern?: string;
+    args?: Record<string, unknown>;
+    overwrite?: boolean;
+    config?: string;
+}

package/schematics/add-exchange-binding/schema.js

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

package/schematics/add-exchange-binding/schema.js.map

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

package/schematics/add-exchange-binding/schema.json

@@ -0,0 +1,36 @@
+{
+  "$schema": "http://json-schema.org/schema",
+  "$id": "SchematicsRlbAmqpAddExchangeBinding",
+  "title": "Bind two exchanges via broker.exchangeBindings[]",
+  "type": "object",
+  "properties": {
+    "source": {
+      "type": "string",
+      "description": "Source exchange.",
+      "x-prompt": "Source exchange?",
+      "$default": { "$source": "argv", "index": 0 }
+    },
+    "destination": {
+      "type": "string",
+      "description": "Destination exchange."
+    },
+    "pattern": {
+      "type": "string",
+      "description": "Binding pattern / routing key."
+    },
+    "args": {
+      "type": "object",
+      "description": "Optional binding arguments."
+    },
+    "overwrite": {
+      "type": "boolean",
+      "default": false,
+      "description": "Update the entry if it already exists (default: leave it untouched)."
+    },
+    "config": {
+      "type": "string",
+      "description": "Path to config.yaml (default: auto-detected)."
+    }
+  },
+  "required": []
+}

package/schematics/add-exchange-binding/schema.ts

@@ -0,0 +1,14 @@
+export interface AddExchangeBindingOptions {
+  /** Source exchange (mirrors RabbitMQExchangeBindingConfig.source). Prompted when omitted. */
+  source?: string;
+  /** Destination exchange (mirrors RabbitMQExchangeBindingConfig.destination). */
+  destination?: string;
+  /** Binding pattern / routing key (mirrors RabbitMQExchangeBindingConfig.pattern). */
+  pattern?: string;
+  /** Optional binding arguments (mirrors RabbitMQExchangeBindingConfig.args). */
+  args?: Record<string, unknown>;
+  /** Update the entry 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/add-gateway/index.d.ts

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

package/schematics/add-gateway/index.js

@@ -0,0 +1,105 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.main = main;
+exports.configAndWireRule = configAndWireRule;
+const schematics_1 = require("@angular-devkit/schematics");
+const path_1 = require("path");
+const broker_yaml_util_1 = require("../utils/broker-yaml.util");
+const nest_wiring_util_1 = require("../utils/nest-wiring.util");
+const yaml_config_util_1 = require("../utils/yaml-config.util");
+const paths_1 = require("./paths");
+const wiring_1 = require("./wiring");
+function main(options) {
+    const r = resolveFlags(options);
+    return (0, schematics_1.chain)([
+        configAndWireRule(options),
+        copyAsset('db-core'),
+        r.acl ? copyAsset('acl') : (0, schematics_1.noop)(),
+        r.anyAdmin ? copyAsset('gateway-admin') : (0, schematics_1.noop)(),
+    ]);
+}
+function resolveFlags(options) {
+    const exchange = options.exchange || 'rlb';
+    const aclQueue = options.aclQueue || 'rlb-acl';
+    const adminQueue = options.adminQueue || 'rlb-gateway-admin';
+    const controlTopic = options.controlTopic || 'rlb-gateway-control';
+    const routeExchange = options.routeExchange || 'rlb-route-discovery';
+    const routeQueue = options.routeQueue || 'rlb-route-sync';
+    const acl = options.acl ?? true;
+    const admin = options.admin ?? true;
+    const routeReception = options.routeReception ?? true;
+    const anyAdmin = admin || routeReception;
+    const features = { acl, admin, routeReception, routeExchange, routeQueue };
+    return { exchange, aclQueue, adminQueue, controlTopic, routeExchange, routeQueue, acl, admin, routeReception, anyAdmin, features };
+}
+function configAndWireRule(options) {
+    return (tree, context) => {
+        const r = resolveFlags(options);
+        const opts = { overwrite: options.overwrite };
+        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 (doc.hasIn(['broker', 'routeDiscovery'])) {
+            doc.deleteIn(['broker', 'routeDiscovery']);
+            context.logger.info('[rlb-amqp] removed broker.routeDiscovery (a gateway consumes routes, it does not publish its own).');
+        }
+        (0, broker_yaml_util_1.ensureExchange)(doc, { name: r.exchange, type: 'direct' }, opts);
+        if (r.acl) {
+            (0, broker_yaml_util_1.ensureQueue)(doc, { name: r.aclQueue, exchange: r.exchange, routingKey: r.aclQueue, durable: true }, opts);
+            (0, broker_yaml_util_1.ensureTopic)(doc, { name: 'rlb-acl', mode: 'rpc', queue: r.aclQueue, exchange: r.exchange, routingKey: r.aclQueue }, opts);
+        }
+        if (r.anyAdmin) {
+            (0, broker_yaml_util_1.ensureQueue)(doc, { name: r.adminQueue, exchange: r.exchange, routingKey: r.adminQueue, durable: true }, opts);
+            (0, broker_yaml_util_1.ensureTopic)(doc, { name: 'rlb-gateway-admin', mode: 'rpc', queue: r.adminQueue, exchange: r.exchange, routingKey: r.adminQueue }, opts);
+            (0, broker_yaml_util_1.ensureTopic)(doc, { name: r.controlTopic, mode: 'broadcast', exchange: r.exchange, routingKey: r.controlTopic }, opts);
+        }
+        if (r.routeReception) {
+            (0, broker_yaml_util_1.ensureExchange)(doc, { name: r.routeExchange, type: 'fanout' }, opts);
+            (0, broker_yaml_util_1.ensureQueue)(doc, { name: r.routeQueue, exchange: r.routeExchange, durable: true }, opts);
+        }
+        if (!doc.hasIn(['gateway', 'events']))
+            (0, yaml_config_util_1.setIn)(doc, ['gateway', 'events'], []);
+        if (!doc.hasIn(['gateway', 'ws']))
+            (0, yaml_config_util_1.setIn)(doc, ['gateway', 'ws'], { heartbeatIntervalMs: 30000 });
+        if (r.anyAdmin) {
+            if (!doc.hasIn(['gateway', 'reloadTopic']))
+                (0, yaml_config_util_1.setIn)(doc, ['gateway', 'reloadTopic'], r.controlTopic);
+            if (!doc.hasIn(['gateway', 'metrics']))
+                (0, yaml_config_util_1.setIn)(doc, ['gateway', 'metrics'], { topic: 'rlb-gateway-admin', action: 'gw-metrics-track' });
+            if (!doc.hasIn(['gateway', 'loadConfig']))
+                (0, yaml_config_util_1.setIn)(doc, ['gateway', 'loadConfig'], { paths: { topic: 'rlb-gateway-admin', action: 'gw-path-export' } });
+        }
+        if (!doc.hasIn(['gateway', 'paths']))
+            (0, yaml_config_util_1.setIn)(doc, ['gateway', 'paths'], []);
+        const paths = [...(r.acl ? (0, paths_1.aclManagementPaths)() : []), ...(r.anyAdmin ? (0, paths_1.adminManagementPaths)(r.controlTopic) : [])];
+        for (const p of paths)
+            (0, yaml_config_util_1.upsertSeqItemByKey)(doc, ['gateway', 'paths'], 'name', p, opts);
+        (0, yaml_config_util_1.writeConfigDoc)(tree, configPath, doc);
+        (0, nest_wiring_util_1.createConfigLoader)(tree);
+        const modulePath = (0, nest_wiring_util_1.wireAppModule)(tree, {
+            libSymbols: (0, wiring_1.libSymbols)(r.features),
+            importLines: (0, wiring_1.importLines)(r.features),
+            entries: (0, wiring_1.moduleEntries)(r.features),
+        });
+        if (!modulePath) {
+            context.logger.warn('[rlb-amqp] app.module.ts not found — module wiring skipped. Wire Broker/Proxy/Http' + (r.acl ? '/Acl' : '') + (r.anyAdmin ? '/GatewayAdmin' : '') + ' modules manually.');
+        }
+        if (!(0, nest_wiring_util_1.configureMainForGateway)(tree)) {
+            context.logger.warn('[rlb-amqp] main.ts not found — enable rawBody + WsAdapter manually.');
+        }
+        (0, nest_wiring_util_1.addDeps)(tree, {
+            '@nestjs/config': '^4.0.4',
+            'js-yaml': '^4.1.0',
+            '@nestjs/axios': '^4.0.1',
+            '@nestjs/platform-ws': '^11.0.1',
+            '@nestjs/websockets': '^11.0.1',
+            ws: '^8.21.0',
+        });
+        return tree;
+    };
+}
+function copyAsset(name) {
+    return (0, schematics_1.mergeWith)((0, schematics_1.apply)((0, schematics_1.url)(`./files/${name}`), [(0, schematics_1.move)((0, path_1.normalize)('.'))]), schematics_1.MergeStrategy.Overwrite);
+}
+//# sourceMappingURL=index.js.map

package/schematics/add-gateway/index.js.map

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

package/schematics/add-gateway/index.spec.ts

@@ -0,0 +1,163 @@
+import { Rule, SchematicContext, Tree } from '@angular-devkit/schematics';
+import { parseDocument } from 'yaml';
+import { configAndWireRule } from './index';
+import { AddGatewayOptions } from './schema';
+
+/**
+ * Tests target `configAndWireRule` (config.yaml + TS wiring) directly against a Tree. The full `main`
+ * additionally copies in-memory-repo assets via url()/mergeWith, which needs a real engine context —
+ * that path is covered by the end-to-end CLI run, not this unit test.
+ */
+const ctx = { logger: { info() {}, warn() {}, error() {} } } as unknown as SchematicContext;
+
+async function run(options: AddGatewayOptions, tree: Tree): Promise<Tree> {
+  const rule = configAndWireRule(options) as (t: Tree, c: SchematicContext) => Promise<Tree>;
+  return (await rule(tree, ctx)) || tree;
+}
+
+function read(tree: Tree, path = 'config/config.yaml'): string {
+  return tree.read(path)!.toString('utf-8');
+}
+const doc = (tree: Tree) => parseDocument(read(tree));
+const topicNames = (tree: Tree): string[] =>
+  ((doc(tree).getIn(['topics']) as any)?.items || []).map((i: any) => String(i.get('name')));
+const queueNames = (tree: Tree): string[] =>
+  ((doc(tree).getIn(['broker', 'queues']) as any)?.items || []).map((i: any) => String(i.get('name')));
+const pathNames = (tree: Tree): string[] =>
+  ((doc(tree).getIn(['gateway', 'paths']) as any)?.items || []).map((i: any) => String(i.get('name')));
+
+function seedMicroservice(): Tree {
+  const tree = Tree.empty();
+  tree.create(
+    'config/config.yaml',
+    [
+      '# my service',
+      'broker:',
+      '  routeDiscovery:',
+      '    serviceName: "svc"',
+      '    exchange: rlb-route-discovery',
+      '    queue: rlb-route-sync',
+      '  exchanges: []',
+      '  queues: []',
+      'topics: []',
+      '',
+    ].join('\n'),
+  );
+  return tree;
+}
+
+const APP_MODULE = `import { Module } from '@nestjs/common';
+
+@Module({ imports: [] })
+export class AppModule {}
+`;
+const MAIN_TS = `import { NestFactory } from '@nestjs/core';
+import { AppModule } from './app.module';
+
+async function bootstrap() {
+  const app = await NestFactory.create(AppModule);
+  await app.listen(3000);
+}
+bootstrap();
+`;
+
+function seedProject(): Tree {
+  const tree = seedMicroservice();
+  tree.create('src/app.module.ts', APP_MODULE);
+  tree.create('src/main.ts', MAIN_TS);
+  tree.create('package.json', JSON.stringify({ name: 'demo', dependencies: {} }, null, 2));
+  return tree;
+}
+
+describe('add-gateway schematic', () => {
+  describe('config.yaml', () => {
+    it('removes publisher route-discovery and declares the fixed acl/admin/control topics', async () => {
+      const tree = await run({}, seedMicroservice());
+      const d = doc(tree);
+      expect(d.hasIn(['broker', 'routeDiscovery'])).toBe(false);
+      expect(topicNames(tree)).toEqual(expect.arrayContaining(['rlb-acl', 'rlb-gateway-admin', 'rlb-gateway-control']));
+      const byName = (n: string) => (d.getIn(['topics']) as any).items.find((i: any) => String(i.get('name')) === n);
+      expect(String(byName('rlb-gateway-control').get('mode'))).toBe('broadcast');
+      expect(queueNames(tree)).toEqual(expect.arrayContaining(['rlb-acl', 'rlb-gateway-admin', 'rlb-route-sync']));
+      expect(String(d.getIn(['gateway', 'reloadTopic']))).toBe('rlb-gateway-control');
+      expect(read(tree)).toContain('# my service');
+    });
+
+    it('seeds the ACL + admin management routes into gateway.paths', async () => {
+      const tree = await run({}, seedMicroservice());
+      const names = pathNames(tree);
+      expect(names).toEqual(expect.arrayContaining(['acl-check-action', 'acl-grant', 'gw-path-list', 'gw-reload', 'health']));
+    });
+
+    it('does not clobber a pre-existing gateway section', async () => {
+      const tree = seedMicroservice();
+      tree.overwrite(
+        'config/config.yaml',
+        read(tree) + ['gateway:', '  ws:', '    heartbeatIntervalMs: 9999', '  reloadTopic: my-custom-topic', ''].join('\n'),
+      );
+      const d = doc(await run({}, tree));
+      expect(String(d.getIn(['gateway', 'ws', 'heartbeatIntervalMs']))).toBe('9999');
+      expect(String(d.getIn(['gateway', 'reloadTopic']))).toBe('my-custom-topic');
+    });
+
+    it('is idempotent: re-running duplicates neither topics nor management routes', async () => {
+      let tree = await run({}, seedMicroservice());
+      tree = await run({}, tree);
+      expect(topicNames(tree).filter((n) => n === 'rlb-acl')).toHaveLength(1);
+      expect(pathNames(tree).filter((n) => n === 'acl-check-action')).toHaveLength(1);
+    });
+
+    it('respects feature toggles (acl/routeReception off)', async () => {
+      const tree = await run({ acl: false, routeReception: false }, seedMicroservice());
+      expect(topicNames(tree)).not.toContain('rlb-acl');
+      expect(pathNames(tree)).not.toContain('acl-check-action');
+      expect(topicNames(tree)).toContain('rlb-gateway-admin');
+    });
+  });
+
+  describe('TypeScript wiring', () => {
+    it('wires the modules into AppModule and merges the lib import', async () => {
+      const tree = await run({}, seedProject());
+      const mod = tree.read('src/app.module.ts')!.toString('utf-8');
+      expect(mod).toContain('BrokerModule.forRootAsync');
+      expect(mod).toContain('ProxyModule.forRootAsync');
+      expect(mod).toContain('AclModule.forRoot');
+      expect(mod).toContain('GatewayAdminModule.forRoot');
+      expect(mod).toContain('HttpModule');
+      expect(mod).toContain(`from '@open-rlb/nestjs-amqp'`);
+      expect(mod).toContain(`from '@nestjs/config'`);
+      expect(tree.exists('src/config/config.loader.ts')).toBe(true);
+    });
+
+    it('patches main.ts (rawBody + WsAdapter) and package.json deps', async () => {
+      const tree = await run({}, seedProject());
+      const main = tree.read('src/main.ts')!.toString('utf-8');
+      expect(main).toContain('rawBody: true');
+      expect(main).toContain('useWebSocketAdapter(new WsAdapter');
+      const pkg = JSON.parse(tree.read('package.json')!.toString('utf-8'));
+      expect(pkg.dependencies['@nestjs/axios']).toBeDefined();
+      expect(pkg.dependencies['@nestjs/platform-ws']).toBeDefined();
+    });
+
+    it('is idempotent: re-running does not duplicate the module entries', async () => {
+      let tree = await run({}, seedProject());
+      tree = await run({}, tree);
+      const mod = tree.read('src/app.module.ts')!.toString('utf-8');
+      expect(mod.match(/ProxyModule\.forRootAsync/g)).toHaveLength(1);
+      expect(mod.match(/BrokerModule\.forRootAsync/g)).toHaveLength(1);
+      expect(mod.match(/AclModule\.forRoot/g)).toHaveLength(1);
+    });
+
+    it('merges into an existing lib import without duplicating it', async () => {
+      const tree = seedProject();
+      tree.overwrite(
+        'src/app.module.ts',
+        `import { Module } from '@nestjs/common';\nimport { BrokerModule } from '@open-rlb/nestjs-amqp';\n\n@Module({ imports: [] })\nexport class AppModule {}\n`,
+      );
+      const mod = (await run({}, tree)).read('src/app.module.ts')!.toString('utf-8');
+      expect(mod.match(/from '@open-rlb\/nestjs-amqp'/g)).toHaveLength(1);
+      expect(mod).toContain('ProxyModule');
+      expect(mod).toContain('AclModule');
+    });
+  });
+});