@fluojs/cli 1.1.0 → 2.0.1

package/dist/new/scaffold.js

@@ -1050,13 +1050,36 @@ const codec = JSONCodec();
 
 class LazyNatsTransport implements MicroserviceTransport {
   private connection: NatsConnection | undefined;
+  private initializing: Promise<NatsMicroserviceTransport> | undefined;
   private transport: NatsMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await this.connection?.close();
-    this.transport = undefined;
-    this.connection = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    let closeError: unknown;
+    let closeFailed = false;
+    try {
+      await transport?.close();
+    } catch (error) {
+      closeError = error;
+      closeFailed = true;
+    } finally {
+      try {
+        await this.connection?.close();
+      } catch (error) {
+        if (!closeFailed) {
+          closeError = error;
+          closeFailed = true;
+        }
+      } finally {
+        this.initializing = undefined;
+        this.transport = undefined;
+        this.connection = undefined;
+      }
+    }
+
+    if (closeFailed) {
+      throw closeError;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1076,6 +1099,19 @@ class LazyNatsTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const connection = await connect({
       name: 'fluo-microservice-starter',
       servers,
@@ -1149,18 +1185,24 @@ const responseTopic = process.env.KAFKA_RESPONSE_TOPIC ?? 'fluo.microservices.re
 
 class LazyKafkaTransport implements MicroserviceTransport {
   private consumer: Consumer | undefined;
+  private initializing: Promise<KafkaMicroserviceTransport> | undefined;
   private producer: Producer | undefined;
   private transport: KafkaMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await Promise.all([
-      this.consumer?.disconnect().catch(() => undefined),
-      this.producer?.disconnect().catch(() => undefined),
-    ]);
-    this.consumer = undefined;
-    this.producer = undefined;
-    this.transport = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    try {
+      await transport?.close();
+    } finally {
+      await Promise.all([
+        this.consumer?.disconnect().catch(() => undefined),
+        this.producer?.disconnect().catch(() => undefined),
+      ]);
+      this.initializing = undefined;
+      this.consumer = undefined;
+      this.producer = undefined;
+      this.transport = undefined;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1180,6 +1222,19 @@ class LazyKafkaTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const kafka = new Kafka({
       brokers,
       clientId,
@@ -1187,13 +1242,24 @@ class LazyKafkaTransport implements MicroserviceTransport {
     });
     const producer = kafka.producer();
     const consumer = kafka.consumer({ groupId: consumerGroup });
-    await Promise.all([producer.connect(), consumer.connect()]);
+    this.producer = producer;
+    this.consumer = consumer;
+    try {
+      await producer.connect();
+      await consumer.connect();
+    } catch (error) {
+      await Promise.all([
+        consumer.disconnect().catch(() => undefined),
+        producer.disconnect().catch(() => undefined),
+      ]);
+      this.consumer = undefined;
+      this.producer = undefined;
+      throw error;
+    }
 
     const handlers = new Map<string, (message: string) => Promise<void> | void>();
     let consumerRunning = false;
 
-    this.producer = producer;
-    this.consumer = consumer;
     this.transport = new KafkaMicroserviceTransport({
       consumer: {
         async subscribe(topic: string, handler: (message: string) => Promise<void> | void) {
@@ -1277,15 +1343,21 @@ const responseQueue = process.env.RABBITMQ_RESPONSE_QUEUE ?? 'fluo.microservices
 class LazyRabbitMqTransport implements MicroserviceTransport {
   private channel: Awaited<ReturnType<Awaited<ReturnType<typeof connect>>['createConfirmChannel']>> | undefined;
   private connection: Awaited<ReturnType<typeof connect>> | undefined;
+  private initializing: Promise<RabbitMqMicroserviceTransport> | undefined;
   private transport: RabbitMqMicroserviceTransport | undefined;
 
   async close() {
-    await this.transport?.close();
-    await this.channel?.close().catch(() => undefined);
-    await this.connection?.close().catch(() => undefined);
-    this.channel = undefined;
-    this.connection = undefined;
-    this.transport = undefined;
+    const transport = this.initializing ? await this.initializing.catch(() => undefined) : this.transport;
+    try {
+      await transport?.close();
+    } finally {
+      await this.channel?.close().catch(() => undefined);
+      await this.connection?.close().catch(() => undefined);
+      this.initializing = undefined;
+      this.channel = undefined;
+      this.connection = undefined;
+      this.transport = undefined;
+    }
   }
 
   async emit(pattern: string, payload: unknown) {
@@ -1305,11 +1377,31 @@ class LazyRabbitMqTransport implements MicroserviceTransport {
       return this.transport;
     }
 
+    this.initializing ??= this.createTransport();
+    try {
+      return await this.initializing;
+    } finally {
+      this.initializing = undefined;
+    }
+  }
+
+  private async createTransport() {
+    if (this.transport) {
+      return this.transport;
+    }
+
     const connection = await connect(url);
-    const channel = await connection.createConfirmChannel();
+    this.connection = connection;
+    let channel: Awaited<ReturnType<typeof connection.createConfirmChannel>>;
+    try {
+      channel = await connection.createConfirmChannel();
+    } catch (error) {
+      await connection.close().catch(() => undefined);
+      this.connection = undefined;
+      throw error;
+    }
     const consumerTags = new Map<string, string>();
 
-    this.connection = connection;
     this.channel = channel;
     this.transport = new RabbitMqMicroserviceTransport({
       consumer: {

package/dist/new/types.d.ts

@@ -53,11 +53,9 @@ export interface BootstrapAnswers extends BootstrapSchema {
 }
 /** Programmatic overrides for `runNewCommand(...)`. */
 export interface NewCommandOptions {
-    dependencySource?: DependencySource;
     force?: boolean;
     initializeGit?: boolean;
     installDependencies?: boolean;
-    repoRoot?: string;
     skipInstall?: boolean;
 }
 //# sourceMappingURL=types.d.ts.map

package/dist/new/types.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/new/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AACrD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AACtE,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9E,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;AACpH,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/new/types.ts"],"names":[],"mappings":"AAAA,yDAAyD;AACzD,MAAM,MAAM,cAAc,GAAG,KAAK,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,CAAC;AAC7D,yDAAyD;AACzD,MAAM,MAAM,gBAAgB,GAAG,OAAO,GAAG,WAAW,CAAC;AACrD,+CAA+C;AAC/C,MAAM,MAAM,cAAc,GAAG,aAAa,GAAG,cAAc,GAAG,OAAO,CAAC;AACtE,iEAAiE;AACjE,MAAM,MAAM,gBAAgB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,MAAM,CAAC;AAC9E,kEAAkE;AAClE,MAAM,MAAM,iBAAiB,GAAG,KAAK,GAAG,oBAAoB,GAAG,MAAM,GAAG,SAAS,GAAG,SAAS,GAAG,QAAQ,GAAG,MAAM,CAAC;AAClH,mEAAmE;AACnE,MAAM,MAAM,kBAAkB,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,MAAM,GAAG,MAAM,GAAG,UAAU,GAAG,eAAe,GAAG,KAAK,CAAC;AACpH,gEAAgE;AAChE,MAAM,MAAM,sBAAsB,GAAG,UAAU,CAAC;AAEhD,0DAA0D;AAC1D,MAAM,WAAW,iBAAiB;IAChC,QAAQ,EAAE,OAAO,CAAC;IAClB,IAAI,EAAE,gBAAgB,CAAC;CACxB;AAED,mEAAmE;AACnE,MAAM,WAAW,eAAe;IAC9B,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,OAAO,EAAE,gBAAgB,CAAC;IAC1B,KAAK,EAAE,cAAc,CAAC;IACtB,OAAO,EAAE,sBAAsB,CAAC;IAChC,QAAQ,EAAE,iBAAiB,CAAC;IAC5B,SAAS,EAAE,kBAAkB,CAAC;CAC/B;AAED,2EAA2E;AAC3E,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,gBAAgB,CAAC,EAAE,gBAAgB,CAAC;IACpC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,QAAQ,CAAC,EAAE,MAAM,CAAC;IAClB,WAAW,CAAC,EAAE,OAAO,CAAC;IACtB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,yDAAyD;AACzD,MAAM,WAAW,eAAe;IAC9B,GAAG,EAAE,MAAM,gBAAgB,CAAC;IAC5B,KAAK,EAAE,MAAM,CAAC;CACf;AAED,mFAAmF;AACnF,MAAM,WAAW,gBAAiB,SAAQ,eAAe;IACvD,aAAa,EAAE,OAAO,CAAC;IACvB,mBAAmB,EAAE,OAAO,CAAC;IAC7B,cAAc,EAAE,cAAc,CAAC;IAC/B,WAAW,EAAE,MAAM,CAAC;IACpB,eAAe,EAAE,MAAM,CAAC;CACzB;AAED,uDAAuD;AACvD,MAAM,WAAW,iBAAiB;IAChC,KAAK,CAAC,EAAE,OAAO,CAAC;IAChB,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,mBAAmB,CAAC,EAAE,OAAO,CAAC;IAC9B,WAAW,CAAC,EAAE,OAAO,CAAC;CACvB"}

package/dist/public-generate.d.ts

@@ -0,0 +1,2 @@
+export { type GeneratePlanAction, type GeneratePlanEntry, type GenerateResult, runGenerateCommand } from './generate-command.js';
+//# sourceMappingURL=public-generate.d.ts.map

package/dist/public-generate.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-generate.d.ts","sourceRoot":"","sources":["../src/public-generate.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,KAAK,kBAAkB,EAAE,KAAK,iBAAiB,EAAE,KAAK,cAAc,EAAE,kBAAkB,EAAE,MAAM,uBAAuB,CAAC"}

package/dist/public-generate.js

@@ -0,0 +1 @@
+export { runGenerateCommand } from './generate-command.js';

package/dist/public-inspect.d.ts

@@ -0,0 +1,13 @@
+import type { InspectCommandRuntimeOptions } from './commands/inspect.js';
+import { inspectUsage } from './usage.js';
+export type { InspectCommandRuntimeOptions } from './commands/inspect.js';
+export { inspectUsage };
+/**
+ * Runs the inspect command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `inspect`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the inspect command.
+ */
+export declare function runInspectCommand(argv: string[], runtime?: InspectCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=public-inspect.d.ts.map

package/dist/public-inspect.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-inspect.d.ts","sourceRoot":"","sources":["../src/public-inspect.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,MAAM,YAAY,CAAC;AAE1C,YAAY,EAAE,4BAA4B,EAAE,MAAM,uBAAuB,CAAC;AAC1E,OAAO,EAAE,YAAY,EAAE,CAAC;AAExB;;;;;;GAMG;AACH,wBAAsB,iBAAiB,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,4BAAiC,GAAG,OAAO,CAAC,MAAM,CAAC,CAGnH"}

package/dist/public-inspect.js

@@ -0,0 +1,16 @@
+import { inspectUsage } from './usage.js';
+export { inspectUsage };
+
+/**
+ * Runs the inspect command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `inspect`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the inspect command.
+ */
+export async function runInspectCommand(argv, runtime = {}) {
+  const {
+    runInspectCommand: runInspectCommandImplementation
+  } = await import('./commands/inspect.js');
+  return runInspectCommandImplementation(argv, runtime);
+}

package/dist/public-new.d.ts

@@ -0,0 +1,13 @@
+import type { NewCommandRuntimeOptions } from './commands/new.js';
+import { newUsage } from './usage.js';
+export type { NewCommandRuntimeOptions } from './commands/new.js';
+export { newUsage };
+/**
+ * Runs the new command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `new` or `create`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the new command.
+ */
+export declare function runNewCommand(argv: string[], runtime?: NewCommandRuntimeOptions): Promise<number>;
+//# sourceMappingURL=public-new.d.ts.map

package/dist/public-new.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"public-new.d.ts","sourceRoot":"","sources":["../src/public-new.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAC;AAEtC,YAAY,EAAE,wBAAwB,EAAE,MAAM,mBAAmB,CAAC;AAClE,OAAO,EAAE,QAAQ,EAAE,CAAC;AAEpB;;;;;;GAMG;AACH,wBAAsB,aAAa,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,GAAE,wBAA6B,GAAG,OAAO,CAAC,MAAM,CAAC,CAG3G"}

package/dist/public-new.js

@@ -0,0 +1,16 @@
+import { newUsage } from './usage.js';
+export { newUsage };
+
+/**
+ * Runs the new command through a lazy implementation import.
+ *
+ * @param argv Command arguments after `new` or `create`.
+ * @param runtime Runtime overrides for programmatic callers.
+ * @returns Process-style exit code from the new command.
+ */
+export async function runNewCommand(argv, runtime = {}) {
+  const {
+    runNewCommand: runNewCommandImplementation
+  } = await import('./commands/new.js');
+  return runNewCommandImplementation(argv, runtime);
+}

package/dist/studio/sidecar.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/studio/sidecar.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AAwQD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAmLnG"}
+{"version":3,"file":"sidecar.d.ts","sourceRoot":"","sources":["../../src/studio/sidecar.ts"],"names":[],"mappings":"AAOA;;GAEG;AACH,MAAM,MAAM,oBAAoB,GAAG,KAAK,GAAG,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;AAEvE;;GAEG;AACH,MAAM,WAAW,oBAAoB;IACnC,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,oBAAoB,CAAC;CAChC;AAED;;GAEG;AACH,MAAM,WAAW,aAAa;IAC5B,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC,UAAU,CAAC;IAChC,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,KAAK,EAAE,MAAM,CAAC;IACvB,QAAQ,CAAC,GAAG,EAAE,MAAM,CAAC;IACrB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC,CAAC;CACxB;AA4UD;;;;;GAKG;AACH,wBAAsB,kBAAkB,CAAC,OAAO,GAAE,oBAAyB,GAAG,OAAO,CAAC,aAAa,CAAC,CAyLnG"}

package/dist/studio/sidecar.js

@@ -21,10 +21,36 @@ const DEFAULT_HOST = '127.0.0.1';
 const DEFAULT_HEARTBEAT_MS = 15_000;
 const MAX_EVENT_REPLAY = 1_000;
 const MAX_REQUEST_BYTES = 1_048_576;
+const BODY_LIKE_PAYLOAD_FIELDS = new Set(['body', 'headers', 'payload', 'rawBody', 'requestBody', 'responseBody']);
 const require = createRequire(import.meta.url);
 function isRecord(value) {
   return typeof value === 'object' && value !== null;
 }
+function findBodyLikePayloadField(value, path = 'payload') {
+  if (Array.isArray(value)) {
+    for (const [index, item] of value.entries()) {
+      const match = findBodyLikePayloadField(item, `${path}[${String(index)}]`);
+      if (match) {
+        return match;
+      }
+    }
+    return undefined;
+  }
+  if (!isRecord(value)) {
+    return undefined;
+  }
+  for (const [key, nestedValue] of Object.entries(value)) {
+    const nestedPath = `${path}.${key}`;
+    if (BODY_LIKE_PAYLOAD_FIELDS.has(key)) {
+      return nestedPath;
+    }
+    const match = findBodyLikePayloadField(nestedValue, nestedPath);
+    if (match) {
+      return match;
+    }
+  }
+  return undefined;
+}
 function isRestartEpochBoundary(incoming) {
   if (incoming.type !== 'restart' || !isRecord(incoming.payload)) {
     return false;
@@ -60,20 +86,53 @@ function createDefaultAppId() {
 }
 function readBody(request) {
   return new Promise((resolve, reject) => {
+    let settled = false;
     let body = '';
     request.setEncoding('utf8');
-    request.on('data', chunk => {
+    const settle = (action, value) => {
+      if (settled) {
+        return;
+      }
+      settled = true;
+      request.off('data', onData);
+      request.off('end', onEnd);
+      request.off('error', onError);
+      request.off('close', onClose);
+      if (action === 'resolve') {
+        resolve(value);
+      } else {
+        reject(value);
+      }
+    };
+    const onData = chunk => {
       body += chunk;
       if (body.length > MAX_REQUEST_BYTES) {
-        reject(new Error('Studio event payload is too large.'));
+        settle('reject', new Error('Studio event payload is too large.'));
         request.destroy();
       }
-    });
-    request.on('end', () => resolve(body));
-    request.on('error', reject);
+    };
+    const onEnd = () => settle('resolve', body);
+    const onError = error => settle('reject', error);
+    // A client that closes the socket after sending only a partial request body
+    // may never emit `end` or `error`. Bind `close` to body-reader cancellation
+    // so the sidecar cannot hang on a malformed local client indefinitely.
+    const onClose = () => {
+      if (body.length === 0) {
+        settle('reject', new Error('Studio sidecar request closed before any body was received.'));
+        return;
+      }
+      settle('reject', new Error('Studio sidecar request closed before the full body was received.'));
+    };
+    request.on('data', onData);
+    request.on('end', onEnd);
+    request.on('error', onError);
+    request.on('close', onClose);
   });
 }
 function writeJson(response, statusCode, payload) {
+  if (response.writableEnded) {
+    return;
+  }
   response.writeHead(statusCode, {
     'cache-control': 'no-store',
     'content-type': 'application/json; charset=utf-8'
@@ -335,6 +394,13 @@ export async function startStudioSidecar(options = {}) {
           });
           return;
         }
+        const bodyLikeField = findBodyLikePayloadField(parsed.payload);
+        if (bodyLikeField) {
+          writeJson(response, 400, {
+            error: `Studio runtime event payload must not include body-like field ${bodyLikeField}.`
+          });
+          return;
+        }
         const event = publish(parsed);
         writeJson(response, 202, {
           accepted: true,

package/dist/usage.d.ts

@@ -0,0 +1,13 @@
+/**
+ * Renders CLI help text for `fluo new` without importing the scaffold implementation.
+ *
+ * @returns Stable help output for the scaffolding command.
+ */
+export declare function newUsage(): string;
+/**
+ * Returns the usage information string for the inspect command without importing runtime inspection logic.
+ *
+ * @returns Formatted help text including usage and options.
+ */
+export declare function inspectUsage(): string;
+//# sourceMappingURL=usage.d.ts.map

package/dist/usage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"usage.d.ts","sourceRoot":"","sources":["../src/usage.ts"],"names":[],"mappings":"AAiIA;;;;GAIG;AACH,wBAAgB,QAAQ,IAAI,MAAM,CA0BjC;AAED;;;;GAIG;AACH,wBAAgB,YAAY,IAAI,MAAM,CAarC"}

package/dist/usage.js

@@ -0,0 +1,131 @@
+import { renderAliasList, renderHelpTable } from './help.js';
+const NEW_OPTION_HELP = [{
+  aliases: [],
+  description: 'Provide the project name without using the positional argument.',
+  option: '--name <project-name>'
+}, {
+  aliases: [],
+  description: 'Select the scaffold shape explicitly (application for HTTP, microservice for the transport-driven starter path, mixed for the API + microservice starter).',
+  option: '--shape <application|microservice|mixed>'
+}, {
+  aliases: [],
+  description: 'Select the transport path explicitly (http for applications, tcp for the runnable microservice starter, plus shipped microservice starter transports).',
+  option: '--transport <http|tcp|redis-streams|nats|kafka|rabbitmq|mqtt|grpc>'
+}, {
+  aliases: [],
+  description: 'Select the runtime explicitly (node, bun, deno, or cloudflare-workers for application starters; node for microservice and mixed starters).',
+  option: '--runtime <node|bun|deno|cloudflare-workers>'
+}, {
+  aliases: [],
+  description: 'Select the platform adapter explicitly (fastify, express, or nodejs on node; bun/deno/cloudflare-workers on their native runtimes; none for microservices).',
+  option: '--platform <fastify|express|nodejs|bun|deno|cloudflare-workers|none>'
+}, {
+  aliases: [],
+  description: 'Select the starter tooling preset explicitly (currently only standard).',
+  option: '--tooling <standard>'
+}, {
+  aliases: [],
+  description: 'Select the starter topology mode explicitly (currently only single-package).',
+  option: '--topology <single-package>'
+}, {
+  aliases: [],
+  description: 'Choose which package manager installs the starter dependencies.',
+  option: '--package-manager <pnpm|npm|yarn|bun>'
+}, {
+  aliases: [],
+  description: 'Write the new app to a custom target directory (always overrides positional name path).',
+  option: '--target-directory <path>'
+}, {
+  aliases: [],
+  description: 'Overwrite files in a non-empty target directory without prompting.',
+  option: '--force'
+}, {
+  aliases: [],
+  description: 'Install starter dependencies after writing files.',
+  option: '--install'
+}, {
+  aliases: [],
+  description: 'Skip starter dependency installation.',
+  option: '--no-install'
+}, {
+  aliases: [],
+  description: 'Initialize a git repository in the generated starter.',
+  option: '--git'
+}, {
+  aliases: [],
+  description: 'Skip git repository initialization in the generated starter.',
+  option: '--no-git'
+}, {
+  aliases: [],
+  description: 'Print the resolved scaffold plan without writing files, installing dependencies, or initializing git.',
+  option: '--print-plan'
+}, {
+  aliases: ['-h'],
+  description: 'Show help for the new command.',
+  option: '--help'
+}];
+const INSPECT_OPTION_HELP = [{
+  aliases: [],
+  description: 'Emit the runtime platform snapshot/diagnostics payload as JSON (default when no output mode is selected).',
+  option: '--json'
+}, {
+  aliases: [],
+  description: 'Emit a Mermaid graph through the optional @fluojs/studio rendering contract.',
+  option: '--mermaid'
+}, {
+  aliases: [],
+  description: 'Include bootstrap timing diagnostics next to JSON inspect output.',
+  option: '--timing'
+}, {
+  aliases: [],
+  description: 'Emit a CI-friendly JSON report with summary, snapshot, diagnostics, and timing.',
+  option: '--report'
+}, {
+  aliases: [],
+  description: 'Write the selected inspect payload to a file instead of stdout.',
+  option: '--output <path>'
+}, {
+  aliases: [],
+  description: 'Select the exported module symbol name (default: AppModule).',
+  option: '--export <name>'
+}, {
+  aliases: ['-h'],
+  description: 'Show help for the inspect command.',
+  option: '--help'
+}];
+
+/**
+ * Renders CLI help text for `fluo new` without importing the scaffold implementation.
+ *
+ * @returns Stable help output for the scaffolding command.
+ */
+export function newUsage() {
+  return ['Usage: fluo new|create [project-name] [options]', '', 'Options', renderHelpTable(NEW_OPTION_HELP, [{
+    header: 'Option',
+    render: entry => entry.option
+  }, {
+    header: 'Aliases',
+    render: entry => renderAliasList(entry.aliases)
+  }, {
+    header: 'Description',
+    render: entry => entry.description
+  }]), '', 'Next steps:', '  cd <app-name>', '  pnpm dev  # runs fluo dev from the generated package.json script', '', 'Docs: https://github.com/fluojs/fluo/tree/main/docs/getting-started/quick-start.md'].join('\n');
+}
+
+/**
+ * Returns the usage information string for the inspect command without importing runtime inspection logic.
+ *
+ * @returns Formatted help text including usage and options.
+ */
+export function inspectUsage() {
+  return ['Usage: fluo inspect <module-path> [options]', '', 'Options', renderHelpTable(INSPECT_OPTION_HELP, [{
+    header: 'Option',
+    render: entry => entry.option
+  }, {
+    header: 'Aliases',
+    render: entry => renderAliasList(entry.aliases)
+  }, {
+    header: 'Description',
+    render: entry => entry.description
+  }]), '', 'Docs: https://github.com/fluojs/fluo/tree/main/docs/getting-started/quick-start.md'].join('\n');
+}

package/package.json

@@ -9,7 +9,7 @@
     "migration",
     "diagnostics"
   ],
-  "version": "1.1.0",
+  "version": "2.0.1",
   "private": false,
   "license": "MIT",
   "repository": {
@@ -44,10 +44,10 @@
     "ejs": "^3.1.10",
     "tsx": "^4.20.4",
     "typescript": "^6.0.2",
-    "@fluojs/runtime": "^1.1.8"
+    "@fluojs/runtime": "^2.0.1"
   },
   "peerDependencies": {
-    "@fluojs/studio": "^1.0.7"
+    "@fluojs/studio": "^1.0.8"
   },
   "peerDependenciesMeta": {
     "@fluojs/studio": {