@idevconn/create-icore 0.5.1 → 0.6.0

package/dist/cli.js

@@ -195,7 +195,10 @@ Re-run with @latest to refresh:
     options: [
       { value: "tcp", label: "TCP (default, no broker required)" },
       { value: "redis", label: "Redis" },
-      { value: "nats", label: "NATS" }
+      { value: "nats", label: "NATS" },
+      { value: "mqtt", label: "MQTT" },
+      { value: "rmq", label: "RabbitMQ" },
+      { value: "kafka", label: "Kafka" }
     ],
     initialValue: "tcp"
   });
@@ -265,6 +268,24 @@ async function copyTree(src, dest) {
     else if (entry.isFile()) await copyFile(s, d);
   }
 }
+var TRANSPORT_ENV_TOKEN = {
+  redis: "REDIS",
+  nats: "NATS",
+  mqtt: "MQTT",
+  rmq: "RMQ",
+  kafka: "KAFKA"
+};
+var TRANSPORT_DEPS = {
+  nats: { nats: "^2.29.3" },
+  mqtt: { mqtt: "^5.15.1" },
+  rmq: { amqplib: "^2.0.1", "amqp-connection-manager": "^5.0.0" },
+  kafka: { kafkajs: "^2.2.4" }
+};
+function uncommentTransportEnv(text2, prefix, transport) {
+  const token = TRANSPORT_ENV_TOKEN[transport];
+  if (!token) return text2;
+  return text2.replace(new RegExp(`^# (${prefix}_${token}_[A-Z0-9_]*=)`, "gm"), "$1");
+}
 async function rewriteRootPackageJson(targetDir, opts) {
   const pkgPath = join2(targetDir, "package.json");
   const raw = await readFile2(pkgPath, "utf8");
@@ -273,9 +294,10 @@ async function rewriteRootPackageJson(targetDir, opts) {
   pkg["version"] = "0.0.1";
   pkg["private"] = true;
   delete pkg.description;
-  if (opts.transport === "nats") {
+  const transportDeps = TRANSPORT_DEPS[opts.transport];
+  if (transportDeps) {
     const deps = pkg["dependencies"] ??= {};
-    deps["nats"] = "^2.29.3";
+    Object.assign(deps, transportDeps);
   }
   if (opts.packageManager !== "yarn") {
     delete pkg.packageManager;
@@ -302,9 +324,7 @@ async function writeAuthEnv(targetDir, opts) {
   const envExample = join2(targetDir, "apps/microservices/auth/.env.example");
   const env = await readFile2(envExample, "utf8");
   let next = env.replace(/^AUTH_PROVIDER=.*$/m, `AUTH_PROVIDER=${opts.authProvider}`).replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1");
-  }
+  next = uncommentTransportEnv(next, "AUTH", opts.transport);
   await writeFile(join2(targetDir, "apps/microservices/auth/.env"), next);
 }
 async function writeUploadEnv(targetDir, opts) {
@@ -312,9 +332,7 @@ async function writeUploadEnv(targetDir, opts) {
   const envExample = join2(targetDir, "apps/microservices/upload/.env.example");
   const env = await readFile2(envExample, "utf8");
   let next = env.replace(/^STORAGE_PROVIDER=.*$/m, `STORAGE_PROVIDER=${opts.upload}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1");
-  }
+  next = uncommentTransportEnv(next, "UPLOAD", opts.transport);
   await writeFile(join2(targetDir, "apps/microservices/upload/.env"), next);
 }
 async function writeNotesEnv(targetDir, opts) {
@@ -323,9 +341,7 @@ async function writeNotesEnv(targetDir, opts) {
   try {
     const env = await readFile2(envExample, "utf8");
     let next = env.replace(/^NOTES_TRANSPORT=.*$/m, `NOTES_TRANSPORT=${opts.transport}`);
-    if (opts.transport !== "tcp") {
-      next = next.replace(/^# (NOTES_(?:REDIS|NATS)_URL=)/m, "$1");
-    }
+    next = uncommentTransportEnv(next, "NOTES", opts.transport);
     await writeFile(join2(targetDir, "apps/microservices/notes/.env"), next);
   } catch {
   }
@@ -334,8 +350,8 @@ async function writeGatewayEnv(targetDir, opts) {
   const envExample = join2(targetDir, "apps/api/.env.example");
   const env = await readFile2(envExample, "utf8");
   let next = env.replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`).replace(/^NOTES_TRANSPORT=.*$/m, `NOTES_TRANSPORT=${opts.transport}`).replace(/^PAYMENT_TRANSPORT=.*$/m, `PAYMENT_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (NOTES_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (PAYMENT_(?:REDIS|NATS)_URL=)/m, "$1");
+  for (const prefix of ["AUTH", "UPLOAD", "NOTES", "PAYMENT"]) {
+    next = uncommentTransportEnv(next, prefix, opts.transport);
   }
   await writeFile(join2(targetDir, "apps/api/.env"), next);
 }
@@ -373,9 +389,7 @@ async function writePaymentEnv(targetDir, opts) {
   try {
     const env = await readFile2(envExample, "utf8");
     let next = env.replace(/^PAYMENT_PROVIDER=.*$/m, `PAYMENT_PROVIDER=${opts.payment}`).replace(/^PAYMENT_TRANSPORT=.*$/m, `PAYMENT_TRANSPORT=${opts.transport}`);
-    if (opts.transport !== "tcp") {
-      next = next.replace(/^# (PAYMENT_(?:REDIS|NATS)_URL=)/m, "$1");
-    }
+    next = uncommentTransportEnv(next, "PAYMENT", opts.transport);
     await writeFile(join2(targetDir, "apps/microservices/payment/.env"), next);
   } catch {
   }
@@ -476,21 +490,16 @@ async function removeNotesStack(targetDir) {
   const siderPath = join2(targetDir, "apps/client/src/components/layout/LayoutSider.tsx");
   try {
     const src = await readFile2(siderPath, "utf8");
-    const next = src.replace(", StickyNote", "").replace(/\n {8}<Link\n {10}to="\/_dashboard\/notes"[\s\S]*?<\/Link>/, "").replace(", FileTextOutlined", "").replace(
+    const next = src.replace(", StickyNote", "").replace(/\n {8}<Link\n {10}to="\/(?:_dashboard\/)?notes"[\s\S]*?<\/Link>/, "").replace(", FileTextOutlined", "").replace(
       "const selectedKey = pathname.includes('/notes')\n    ? 'notes'\n    : pathname.includes('/profile')",
       "const selectedKey = pathname.includes('/profile')"
     ).replace(
-      `
-    {
-      key: 'notes',
-      icon: <FileTextOutlined />,
-      label: <Link to="/_dashboard/notes">{t('notes.title')}</Link>,
-    },`,
+      /\n {4}\{\n {6}key: 'notes',\n {6}icon: <FileTextOutlined \/>,\n {6}label: <Link to="\/(?:_dashboard\/)?notes">\{t\('notes\.title'\)\}<\/Link>,\n {4}\},/,
       ""
     ).replace("import NoteOutlinedIcon from '@mui/icons-material/NoteOutlined';\n", "").replace(
-      /\n {8}<ListItemButton\n {10}component=\{Link\}\n {10}to="\/_dashboard\/notes"[\s\S]*?<\/ListItemButton>/,
+      /\n {8}<ListItemButton\n {10}component=\{Link\}\n {10}to="\/(?:_dashboard\/)?notes"[\s\S]*?<\/ListItemButton>/,
       ""
-    ).replace(/\n\s*<Link to="\/_dashboard\/notes">[\s\S]*?<\/Link>/m, "");
+    ).replace(/\n\s*<Link to="\/(?:_dashboard\/)?notes">[\s\S]*?<\/Link>/m, "");
     await writeFile(siderPath, next);
   } catch {
   }
@@ -874,7 +883,7 @@ Apache-2.0
 
 - **Branch strategy**: \`dev\` is default. Cut \`feature/<name>\` or \`bug/<name>\` from dev. PRs only target dev. Never push directly to main.
 - **No code without approval**: Propose changes first, wait for go-ahead.
-- **\u0417\u0410\u041A\u041E\u041D \u2014 no crash on missing .env**: MS factories must catch config errors, print a boxed banner with ALL missing vars, and return a Fake strategy in dev. In prod (\`NODE_ENV=production\`) throw the same banner. The \`formatEnvBanner\` + \`missingEnv\` helpers from \`@icore/shared\` handle this.
+- **RULE \u2014 no crash on missing .env**: MS factories must catch config errors, print a boxed banner with ALL missing vars, and return a Fake strategy in dev. In prod (\`NODE_ENV=production\`) throw the same banner. The \`formatEnvBanner\` + \`missingEnv\` helpers from \`@icore/shared\` handle this.
 - **Post-coding routine**: \`npx prettier --write <files>\` \u2192 \`${nx} lint <project>\` \u2192 \`${nx} build <project>\` \u2014 all green before committing.
 - **Nx generators only**: never hand-write \`project.json\` / tsconfig stacks. Use \`${nx} g @nx/<plugin>:<schematic>\`.
 

package/dist/index.cjs

@@ -74,6 +74,24 @@ async function copyTree(src, dest) {
     else if (entry.isFile()) await (0, import_promises.copyFile)(s, d);
   }
 }
+var TRANSPORT_ENV_TOKEN = {
+  redis: "REDIS",
+  nats: "NATS",
+  mqtt: "MQTT",
+  rmq: "RMQ",
+  kafka: "KAFKA"
+};
+var TRANSPORT_DEPS = {
+  nats: { nats: "^2.29.3" },
+  mqtt: { mqtt: "^5.15.1" },
+  rmq: { amqplib: "^2.0.1", "amqp-connection-manager": "^5.0.0" },
+  kafka: { kafkajs: "^2.2.4" }
+};
+function uncommentTransportEnv(text2, prefix, transport) {
+  const token = TRANSPORT_ENV_TOKEN[transport];
+  if (!token) return text2;
+  return text2.replace(new RegExp(`^# (${prefix}_${token}_[A-Z0-9_]*=)`, "gm"), "$1");
+}
 async function rewriteRootPackageJson(targetDir, opts) {
   const pkgPath = (0, import_node_path.join)(targetDir, "package.json");
   const raw = await (0, import_promises.readFile)(pkgPath, "utf8");
@@ -82,9 +100,10 @@ async function rewriteRootPackageJson(targetDir, opts) {
   pkg["version"] = "0.0.1";
   pkg["private"] = true;
   delete pkg.description;
-  if (opts.transport === "nats") {
+  const transportDeps = TRANSPORT_DEPS[opts.transport];
+  if (transportDeps) {
     const deps = pkg["dependencies"] ??= {};
-    deps["nats"] = "^2.29.3";
+    Object.assign(deps, transportDeps);
   }
   if (opts.packageManager !== "yarn") {
     delete pkg.packageManager;
@@ -111,9 +130,7 @@ async function writeAuthEnv(targetDir, opts) {
   const envExample = (0, import_node_path.join)(targetDir, "apps/microservices/auth/.env.example");
   const env = await (0, import_promises.readFile)(envExample, "utf8");
   let next = env.replace(/^AUTH_PROVIDER=.*$/m, `AUTH_PROVIDER=${opts.authProvider}`).replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1");
-  }
+  next = uncommentTransportEnv(next, "AUTH", opts.transport);
   await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/microservices/auth/.env"), next);
 }
 async function writeUploadEnv(targetDir, opts) {
@@ -121,9 +138,7 @@ async function writeUploadEnv(targetDir, opts) {
   const envExample = (0, import_node_path.join)(targetDir, "apps/microservices/upload/.env.example");
   const env = await (0, import_promises.readFile)(envExample, "utf8");
   let next = env.replace(/^STORAGE_PROVIDER=.*$/m, `STORAGE_PROVIDER=${opts.upload}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1");
-  }
+  next = uncommentTransportEnv(next, "UPLOAD", opts.transport);
   await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/microservices/upload/.env"), next);
 }
 async function writeNotesEnv(targetDir, opts) {
@@ -132,9 +147,7 @@ async function writeNotesEnv(targetDir, opts) {
   try {
     const env = await (0, import_promises.readFile)(envExample, "utf8");
     let next = env.replace(/^NOTES_TRANSPORT=.*$/m, `NOTES_TRANSPORT=${opts.transport}`);
-    if (opts.transport !== "tcp") {
-      next = next.replace(/^# (NOTES_(?:REDIS|NATS)_URL=)/m, "$1");
-    }
+    next = uncommentTransportEnv(next, "NOTES", opts.transport);
     await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/microservices/notes/.env"), next);
   } catch {
   }
@@ -143,8 +156,8 @@ async function writeGatewayEnv(targetDir, opts) {
   const envExample = (0, import_node_path.join)(targetDir, "apps/api/.env.example");
   const env = await (0, import_promises.readFile)(envExample, "utf8");
   let next = env.replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`).replace(/^NOTES_TRANSPORT=.*$/m, `NOTES_TRANSPORT=${opts.transport}`).replace(/^PAYMENT_TRANSPORT=.*$/m, `PAYMENT_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (NOTES_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (PAYMENT_(?:REDIS|NATS)_URL=)/m, "$1");
+  for (const prefix of ["AUTH", "UPLOAD", "NOTES", "PAYMENT"]) {
+    next = uncommentTransportEnv(next, prefix, opts.transport);
   }
   await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/api/.env"), next);
 }
@@ -182,9 +195,7 @@ async function writePaymentEnv(targetDir, opts) {
   try {
     const env = await (0, import_promises.readFile)(envExample, "utf8");
     let next = env.replace(/^PAYMENT_PROVIDER=.*$/m, `PAYMENT_PROVIDER=${opts.payment}`).replace(/^PAYMENT_TRANSPORT=.*$/m, `PAYMENT_TRANSPORT=${opts.transport}`);
-    if (opts.transport !== "tcp") {
-      next = next.replace(/^# (PAYMENT_(?:REDIS|NATS)_URL=)/m, "$1");
-    }
+    next = uncommentTransportEnv(next, "PAYMENT", opts.transport);
     await (0, import_promises.writeFile)((0, import_node_path.join)(targetDir, "apps/microservices/payment/.env"), next);
   } catch {
   }
@@ -285,21 +296,16 @@ async function removeNotesStack(targetDir) {
   const siderPath = (0, import_node_path.join)(targetDir, "apps/client/src/components/layout/LayoutSider.tsx");
   try {
     const src = await (0, import_promises.readFile)(siderPath, "utf8");
-    const next = src.replace(", StickyNote", "").replace(/\n {8}<Link\n {10}to="\/_dashboard\/notes"[\s\S]*?<\/Link>/, "").replace(", FileTextOutlined", "").replace(
+    const next = src.replace(", StickyNote", "").replace(/\n {8}<Link\n {10}to="\/(?:_dashboard\/)?notes"[\s\S]*?<\/Link>/, "").replace(", FileTextOutlined", "").replace(
       "const selectedKey = pathname.includes('/notes')\n    ? 'notes'\n    : pathname.includes('/profile')",
       "const selectedKey = pathname.includes('/profile')"
     ).replace(
-      `
-    {
-      key: 'notes',
-      icon: <FileTextOutlined />,
-      label: <Link to="/_dashboard/notes">{t('notes.title')}</Link>,
-    },`,
+      /\n {4}\{\n {6}key: 'notes',\n {6}icon: <FileTextOutlined \/>,\n {6}label: <Link to="\/(?:_dashboard\/)?notes">\{t\('notes\.title'\)\}<\/Link>,\n {4}\},/,
       ""
     ).replace("import NoteOutlinedIcon from '@mui/icons-material/NoteOutlined';\n", "").replace(
-      /\n {8}<ListItemButton\n {10}component=\{Link\}\n {10}to="\/_dashboard\/notes"[\s\S]*?<\/ListItemButton>/,
+      /\n {8}<ListItemButton\n {10}component=\{Link\}\n {10}to="\/(?:_dashboard\/)?notes"[\s\S]*?<\/ListItemButton>/,
       ""
-    ).replace(/\n\s*<Link to="\/_dashboard\/notes">[\s\S]*?<\/Link>/m, "");
+    ).replace(/\n\s*<Link to="\/(?:_dashboard\/)?notes">[\s\S]*?<\/Link>/m, "");
     await (0, import_promises.writeFile)(siderPath, next);
   } catch {
   }
@@ -683,7 +689,7 @@ Apache-2.0
 
 - **Branch strategy**: \`dev\` is default. Cut \`feature/<name>\` or \`bug/<name>\` from dev. PRs only target dev. Never push directly to main.
 - **No code without approval**: Propose changes first, wait for go-ahead.
-- **\u0417\u0410\u041A\u041E\u041D \u2014 no crash on missing .env**: MS factories must catch config errors, print a boxed banner with ALL missing vars, and return a Fake strategy in dev. In prod (\`NODE_ENV=production\`) throw the same banner. The \`formatEnvBanner\` + \`missingEnv\` helpers from \`@icore/shared\` handle this.
+- **RULE \u2014 no crash on missing .env**: MS factories must catch config errors, print a boxed banner with ALL missing vars, and return a Fake strategy in dev. In prod (\`NODE_ENV=production\`) throw the same banner. The \`formatEnvBanner\` + \`missingEnv\` helpers from \`@icore/shared\` handle this.
 - **Post-coding routine**: \`npx prettier --write <files>\` \u2192 \`${nx} lint <project>\` \u2192 \`${nx} build <project>\` \u2014 all green before committing.
 - **Nx generators only**: never hand-write \`project.json\` / tsconfig stacks. Use \`${nx} g @nx/<plugin>:<schematic>\`.
 
@@ -980,7 +986,10 @@ Re-run with @latest to refresh:
     options: [
       { value: "tcp", label: "TCP (default, no broker required)" },
       { value: "redis", label: "Redis" },
-      { value: "nats", label: "NATS" }
+      { value: "nats", label: "NATS" },
+      { value: "mqtt", label: "MQTT" },
+      { value: "rmq", label: "RabbitMQ" },
+      { value: "kafka", label: "Kafka" }
     ],
     initialValue: "tcp"
   });

package/dist/index.d.cts

@@ -5,7 +5,7 @@ type PaymentProvider = 'paypal' | 'none';
 type JobsProvider = 'bullmq' | 'none';
 type ExampleMode = 'notes' | 'none';
 type UiLibrary = 'shadcn' | 'antd' | 'mui';
-type MsTransport = 'tcp' | 'redis' | 'nats';
+type MsTransport = 'tcp' | 'redis' | 'nats' | 'mqtt' | 'rmq' | 'kafka';
 type PackageManager = 'yarn' | 'npm' | 'pnpm';
 /**
  * Returns the correct invocation for a package.json script.

package/dist/index.d.ts

@@ -5,7 +5,7 @@ type PaymentProvider = 'paypal' | 'none';
 type JobsProvider = 'bullmq' | 'none';
 type ExampleMode = 'notes' | 'none';
 type UiLibrary = 'shadcn' | 'antd' | 'mui';
-type MsTransport = 'tcp' | 'redis' | 'nats';
+type MsTransport = 'tcp' | 'redis' | 'nats' | 'mqtt' | 'rmq' | 'kafka';
 type PackageManager = 'yarn' | 'npm' | 'pnpm';
 /**
  * Returns the correct invocation for a package.json script.

package/dist/index.js

@@ -32,6 +32,24 @@ async function copyTree(src, dest) {
     else if (entry.isFile()) await copyFile(s, d);
   }
 }
+var TRANSPORT_ENV_TOKEN = {
+  redis: "REDIS",
+  nats: "NATS",
+  mqtt: "MQTT",
+  rmq: "RMQ",
+  kafka: "KAFKA"
+};
+var TRANSPORT_DEPS = {
+  nats: { nats: "^2.29.3" },
+  mqtt: { mqtt: "^5.15.1" },
+  rmq: { amqplib: "^2.0.1", "amqp-connection-manager": "^5.0.0" },
+  kafka: { kafkajs: "^2.2.4" }
+};
+function uncommentTransportEnv(text2, prefix, transport) {
+  const token = TRANSPORT_ENV_TOKEN[transport];
+  if (!token) return text2;
+  return text2.replace(new RegExp(`^# (${prefix}_${token}_[A-Z0-9_]*=)`, "gm"), "$1");
+}
 async function rewriteRootPackageJson(targetDir, opts) {
   const pkgPath = join(targetDir, "package.json");
   const raw = await readFile(pkgPath, "utf8");
@@ -40,9 +58,10 @@ async function rewriteRootPackageJson(targetDir, opts) {
   pkg["version"] = "0.0.1";
   pkg["private"] = true;
   delete pkg.description;
-  if (opts.transport === "nats") {
+  const transportDeps = TRANSPORT_DEPS[opts.transport];
+  if (transportDeps) {
     const deps = pkg["dependencies"] ??= {};
-    deps["nats"] = "^2.29.3";
+    Object.assign(deps, transportDeps);
   }
   if (opts.packageManager !== "yarn") {
     delete pkg.packageManager;
@@ -69,9 +88,7 @@ async function writeAuthEnv(targetDir, opts) {
   const envExample = join(targetDir, "apps/microservices/auth/.env.example");
   const env = await readFile(envExample, "utf8");
   let next = env.replace(/^AUTH_PROVIDER=.*$/m, `AUTH_PROVIDER=${opts.authProvider}`).replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1");
-  }
+  next = uncommentTransportEnv(next, "AUTH", opts.transport);
   await writeFile(join(targetDir, "apps/microservices/auth/.env"), next);
 }
 async function writeUploadEnv(targetDir, opts) {
@@ -79,9 +96,7 @@ async function writeUploadEnv(targetDir, opts) {
   const envExample = join(targetDir, "apps/microservices/upload/.env.example");
   const env = await readFile(envExample, "utf8");
   let next = env.replace(/^STORAGE_PROVIDER=.*$/m, `STORAGE_PROVIDER=${opts.upload}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1");
-  }
+  next = uncommentTransportEnv(next, "UPLOAD", opts.transport);
   await writeFile(join(targetDir, "apps/microservices/upload/.env"), next);
 }
 async function writeNotesEnv(targetDir, opts) {
@@ -90,9 +105,7 @@ async function writeNotesEnv(targetDir, opts) {
   try {
     const env = await readFile(envExample, "utf8");
     let next = env.replace(/^NOTES_TRANSPORT=.*$/m, `NOTES_TRANSPORT=${opts.transport}`);
-    if (opts.transport !== "tcp") {
-      next = next.replace(/^# (NOTES_(?:REDIS|NATS)_URL=)/m, "$1");
-    }
+    next = uncommentTransportEnv(next, "NOTES", opts.transport);
     await writeFile(join(targetDir, "apps/microservices/notes/.env"), next);
   } catch {
   }
@@ -101,8 +114,8 @@ async function writeGatewayEnv(targetDir, opts) {
   const envExample = join(targetDir, "apps/api/.env.example");
   const env = await readFile(envExample, "utf8");
   let next = env.replace(/^AUTH_TRANSPORT=.*$/m, `AUTH_TRANSPORT=${opts.transport}`).replace(/^UPLOAD_TRANSPORT=.*$/m, `UPLOAD_TRANSPORT=${opts.transport}`).replace(/^NOTES_TRANSPORT=.*$/m, `NOTES_TRANSPORT=${opts.transport}`).replace(/^PAYMENT_TRANSPORT=.*$/m, `PAYMENT_TRANSPORT=${opts.transport}`);
-  if (opts.transport !== "tcp") {
-    next = next.replace(/^# (AUTH_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (UPLOAD_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (NOTES_(?:REDIS|NATS)_URL=)/m, "$1").replace(/^# (PAYMENT_(?:REDIS|NATS)_URL=)/m, "$1");
+  for (const prefix of ["AUTH", "UPLOAD", "NOTES", "PAYMENT"]) {
+    next = uncommentTransportEnv(next, prefix, opts.transport);
   }
   await writeFile(join(targetDir, "apps/api/.env"), next);
 }
@@ -140,9 +153,7 @@ async function writePaymentEnv(targetDir, opts) {
   try {
     const env = await readFile(envExample, "utf8");
     let next = env.replace(/^PAYMENT_PROVIDER=.*$/m, `PAYMENT_PROVIDER=${opts.payment}`).replace(/^PAYMENT_TRANSPORT=.*$/m, `PAYMENT_TRANSPORT=${opts.transport}`);
-    if (opts.transport !== "tcp") {
-      next = next.replace(/^# (PAYMENT_(?:REDIS|NATS)_URL=)/m, "$1");
-    }
+    next = uncommentTransportEnv(next, "PAYMENT", opts.transport);
     await writeFile(join(targetDir, "apps/microservices/payment/.env"), next);
   } catch {
   }
@@ -243,21 +254,16 @@ async function removeNotesStack(targetDir) {
   const siderPath = join(targetDir, "apps/client/src/components/layout/LayoutSider.tsx");
   try {
     const src = await readFile(siderPath, "utf8");
-    const next = src.replace(", StickyNote", "").replace(/\n {8}<Link\n {10}to="\/_dashboard\/notes"[\s\S]*?<\/Link>/, "").replace(", FileTextOutlined", "").replace(
+    const next = src.replace(", StickyNote", "").replace(/\n {8}<Link\n {10}to="\/(?:_dashboard\/)?notes"[\s\S]*?<\/Link>/, "").replace(", FileTextOutlined", "").replace(
       "const selectedKey = pathname.includes('/notes')\n    ? 'notes'\n    : pathname.includes('/profile')",
       "const selectedKey = pathname.includes('/profile')"
     ).replace(
-      `
-    {
-      key: 'notes',
-      icon: <FileTextOutlined />,
-      label: <Link to="/_dashboard/notes">{t('notes.title')}</Link>,
-    },`,
+      /\n {4}\{\n {6}key: 'notes',\n {6}icon: <FileTextOutlined \/>,\n {6}label: <Link to="\/(?:_dashboard\/)?notes">\{t\('notes\.title'\)\}<\/Link>,\n {4}\},/,
       ""
     ).replace("import NoteOutlinedIcon from '@mui/icons-material/NoteOutlined';\n", "").replace(
-      /\n {8}<ListItemButton\n {10}component=\{Link\}\n {10}to="\/_dashboard\/notes"[\s\S]*?<\/ListItemButton>/,
+      /\n {8}<ListItemButton\n {10}component=\{Link\}\n {10}to="\/(?:_dashboard\/)?notes"[\s\S]*?<\/ListItemButton>/,
       ""
-    ).replace(/\n\s*<Link to="\/_dashboard\/notes">[\s\S]*?<\/Link>/m, "");
+    ).replace(/\n\s*<Link to="\/(?:_dashboard\/)?notes">[\s\S]*?<\/Link>/m, "");
     await writeFile(siderPath, next);
   } catch {
   }
@@ -641,7 +647,7 @@ Apache-2.0
 
 - **Branch strategy**: \`dev\` is default. Cut \`feature/<name>\` or \`bug/<name>\` from dev. PRs only target dev. Never push directly to main.
 - **No code without approval**: Propose changes first, wait for go-ahead.
-- **\u0417\u0410\u041A\u041E\u041D \u2014 no crash on missing .env**: MS factories must catch config errors, print a boxed banner with ALL missing vars, and return a Fake strategy in dev. In prod (\`NODE_ENV=production\`) throw the same banner. The \`formatEnvBanner\` + \`missingEnv\` helpers from \`@icore/shared\` handle this.
+- **RULE \u2014 no crash on missing .env**: MS factories must catch config errors, print a boxed banner with ALL missing vars, and return a Fake strategy in dev. In prod (\`NODE_ENV=production\`) throw the same banner. The \`formatEnvBanner\` + \`missingEnv\` helpers from \`@icore/shared\` handle this.
 - **Post-coding routine**: \`npx prettier --write <files>\` \u2192 \`${nx} lint <project>\` \u2192 \`${nx} build <project>\` \u2014 all green before committing.
 - **Nx generators only**: never hand-write \`project.json\` / tsconfig stacks. Use \`${nx} g @nx/<plugin>:<schematic>\`.
 
@@ -938,7 +944,10 @@ Re-run with @latest to refresh:
     options: [
       { value: "tcp", label: "TCP (default, no broker required)" },
       { value: "redis", label: "Redis" },
-      { value: "nats", label: "NATS" }
+      { value: "nats", label: "NATS" },
+      { value: "mqtt", label: "MQTT" },
+      { value: "rmq", label: "RabbitMQ" },
+      { value: "kafka", label: "Kafka" }
     ],
     initialValue: "tcp"
   });

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@idevconn/create-icore",
-  "version": "0.5.1",
+  "version": "0.6.0",
   "description": "Bootstrap a new project from the iCore scaffold (Nx + NestJS + React + Vite + shadcn/Tailwind, swappable auth + storage providers).",
   "license": "Apache-2.0",
   "author": "iDEVconn",
@@ -56,6 +56,8 @@
     "test:watch": "vitest",
     "lint": "eslint src",
     "typecheck": "tsc --noEmit",
+    "smoke": "npm run build && node scripts/snapshot-templates.mjs && node scripts/smoke-scaffold.mjs --mode=link --projects=shared,firebase-admin,auth,upload,notes,api",
+    "smoke:run": "npm run build && node scripts/snapshot-templates.mjs && node scripts/smoke-scaffold.mjs --mode=install --run --projects=shared,firebase-admin,auth,upload,notes,api --services=api,auth,upload,notes",
     "prepublishOnly": "node scripts/snapshot-templates.mjs && npm run typecheck && npm run test && npm run build"
   },
   "dependencies": {

package/templates/apps/api/.env.example

@@ -7,6 +7,11 @@ AUTH_HOST=127.0.0.1
 AUTH_PORT=4001
 # AUTH_REDIS_URL=redis://localhost:6379
 # AUTH_NATS_URL=nats://localhost:4222
+# AUTH_MQTT_URL=mqtt://localhost:1883
+# AUTH_RMQ_URL=amqp://localhost:5672
+# AUTH_RMQ_QUEUE=auth_queue
+# AUTH_KAFKA_BROKERS=localhost:9092
+# AUTH_KAFKA_CLIENT_ID=auth
 
 # Upload MS transport — must match apps/microservices/upload/.env
 UPLOAD_TRANSPORT=tcp
@@ -14,6 +19,11 @@ UPLOAD_HOST=127.0.0.1
 UPLOAD_PORT=4002
 # UPLOAD_REDIS_URL=redis://localhost:6379
 # UPLOAD_NATS_URL=nats://localhost:4222
+# UPLOAD_MQTT_URL=mqtt://localhost:1883
+# UPLOAD_RMQ_URL=amqp://localhost:5672
+# UPLOAD_RMQ_QUEUE=upload_queue
+# UPLOAD_KAFKA_BROKERS=localhost:9092
+# UPLOAD_KAFKA_CLIENT_ID=upload
 
 # Notes MS transport — must match apps/microservices/notes/.env
 NOTES_TRANSPORT=tcp
@@ -21,6 +31,11 @@ NOTES_HOST=127.0.0.1
 NOTES_PORT=4004
 # NOTES_REDIS_URL=redis://localhost:6379
 # NOTES_NATS_URL=nats://localhost:4222
+# NOTES_MQTT_URL=mqtt://localhost:1883
+# NOTES_RMQ_URL=amqp://localhost:5672
+# NOTES_RMQ_QUEUE=notes_queue
+# NOTES_KAFKA_BROKERS=localhost:9092
+# NOTES_KAFKA_CLIENT_ID=notes
 
 # Payment MS transport — must match apps/microservices/payment/.env
 PAYMENT_TRANSPORT=tcp
@@ -28,6 +43,11 @@ PAYMENT_HOST=127.0.0.1
 PAYMENT_PORT=4003
 # PAYMENT_REDIS_URL=redis://localhost:6379
 # PAYMENT_NATS_URL=nats://localhost:4222
+# PAYMENT_MQTT_URL=mqtt://localhost:1883
+# PAYMENT_RMQ_URL=amqp://localhost:5672
+# PAYMENT_RMQ_QUEUE=payment_queue
+# PAYMENT_KAFKA_BROKERS=localhost:9092
+# PAYMENT_KAFKA_CLIENT_ID=payment
 
 # Per-request multipart file size cap (KB). Default 5120 (5 MB) when unset.
 MAX_FILE_SIZE_KB=5120

package/templates/apps/api/tsconfig.json

@@ -11,6 +11,11 @@
     }
   ],
   "compilerOptions": {
-    "esModuleInterop": true
+    "esModuleInterop": true,
+    "module": "node16",
+    "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "es2021"
   }
 }

package/templates/apps/microservices/auth/.env.example

@@ -4,6 +4,11 @@ AUTH_HOST=127.0.0.1
 AUTH_PORT=4001
 # AUTH_REDIS_URL=redis://localhost:6379
 # AUTH_NATS_URL=nats://localhost:4222
+# AUTH_MQTT_URL=mqtt://localhost:1883
+# AUTH_RMQ_URL=amqp://localhost:5672
+# AUTH_RMQ_QUEUE=auth_queue
+# AUTH_KAFKA_BROKERS=localhost:9092
+# AUTH_KAFKA_CLIENT_ID=auth
 
 # Which concrete AuthStrategy to instantiate
 AUTH_PROVIDER=supabase

package/templates/apps/microservices/auth/tsconfig.json

@@ -11,6 +11,11 @@
     }
   ],
   "compilerOptions": {
-    "esModuleInterop": true
+    "esModuleInterop": true,
+    "module": "node16",
+    "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "es2021"
   }
 }

package/templates/apps/microservices/jobs/tsconfig.json

@@ -8,6 +8,11 @@
     }
   ],
   "compilerOptions": {
-    "esModuleInterop": true
+    "esModuleInterop": true,
+    "module": "node16",
+    "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "es2021"
   }
 }

package/templates/apps/microservices/notes/.env.example

@@ -4,6 +4,11 @@ NOTES_HOST=127.0.0.1
 NOTES_PORT=4004
 # NOTES_REDIS_URL=redis://localhost:6379
 # NOTES_NATS_URL=nats://localhost:4222
+# NOTES_MQTT_URL=mqtt://localhost:1883
+# NOTES_RMQ_URL=amqp://localhost:5672
+# NOTES_RMQ_QUEUE=notes_queue
+# NOTES_KAFKA_BROKERS=localhost:9092
+# NOTES_KAFKA_CLIENT_ID=notes
 
 # Which DB to use — defaults to the root .env DB_PROVIDER if unset.
 # Supabase Postgres or Firestore. Both honored by NotesController via DBStrategy.

package/templates/apps/microservices/notes/tsconfig.json

@@ -8,6 +8,11 @@
     }
   ],
   "compilerOptions": {
-    "esModuleInterop": true
+    "esModuleInterop": true,
+    "module": "node16",
+    "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "es2021"
   }
 }

package/templates/apps/microservices/notes-e2e/src/support/global.d.ts

@@ -0,0 +1,6 @@
+// Augments globalThis so TypeScript accepts custom properties set in
+// global-setup.ts and read in global-teardown.ts (TS7017 fix).
+declare global {
+  var __TEARDOWN_MESSAGE__: string;
+}
+export {};

package/templates/apps/microservices/payment/.env.example

@@ -4,6 +4,11 @@ PAYMENT_HOST=127.0.0.1
 PAYMENT_PORT=4003
 # PAYMENT_REDIS_URL=redis://localhost:6379
 # PAYMENT_NATS_URL=nats://localhost:4222
+# PAYMENT_MQTT_URL=mqtt://localhost:1883
+# PAYMENT_RMQ_URL=amqp://localhost:5672
+# PAYMENT_RMQ_QUEUE=payment_queue
+# PAYMENT_KAFKA_BROKERS=localhost:9092
+# PAYMENT_KAFKA_CLIENT_ID=payment
 
 # Which concrete PaymentStrategy to instantiate
 PAYMENT_PROVIDER=paypal

package/templates/apps/microservices/payment/tsconfig.json

@@ -8,6 +8,11 @@
     }
   ],
   "compilerOptions": {
-    "esModuleInterop": true
+    "esModuleInterop": true,
+    "module": "node16",
+    "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "es2021"
   }
 }

package/templates/apps/microservices/upload/.env.example

@@ -4,6 +4,11 @@ UPLOAD_HOST=127.0.0.1
 UPLOAD_PORT=4002
 # UPLOAD_REDIS_URL=redis://localhost:6379
 # UPLOAD_NATS_URL=nats://localhost:4222
+# UPLOAD_MQTT_URL=mqtt://localhost:1883
+# UPLOAD_RMQ_URL=amqp://localhost:5672
+# UPLOAD_RMQ_QUEUE=upload_queue
+# UPLOAD_KAFKA_BROKERS=localhost:9092
+# UPLOAD_KAFKA_CLIENT_ID=upload
 
 # Which concrete StorageStrategy to instantiate
 STORAGE_PROVIDER=supabase

package/templates/apps/microservices/upload/tsconfig.json

@@ -11,6 +11,11 @@
     }
   ],
   "compilerOptions": {
-    "esModuleInterop": true
+    "esModuleInterop": true,
+    "module": "node16",
+    "moduleResolution": "node16",
+    "experimentalDecorators": true,
+    "emitDecoratorMetadata": true,
+    "target": "es2021"
   }
 }