@aventara/client 0.1.0-pilot.4 → 1.0.0-rc.0

package/dist/init/client-init.orchestrator.js

@@ -1,6 +1,7 @@
 import { mkdirSync, readFileSync, rmSync, writeFileSync } from "node:fs";
 import path from "node:path";
-import { runGenerate } from "../cli/generate.command.js";
+import { GENERATION_STEPS, runGenerate, } from "../cli/generate.command.js";
+import { createStepReporter } from "../cli/step.reporter.js";
 import { CLIENT_CONFIG_FILE } from "../config/config.loader.js";
 import { resolveModuleStyle } from "../config/module-style.resolver.js";
 import { ContractTransportError } from "../contract/contract.fetcher.js";
@@ -47,34 +48,48 @@ export async function runClientInit(command, io) {
         }
     }
     const writes = plan.conflicts.length === 0 ? plan.keeping : plan.replacing;
-    for (const write of writes) {
-        const target = path.join(io.cwd, write.path);
-        if (write.content === undefined) {
-            rmSync(target, { force: true });
-            continue;
+    const progress = createStepReporter({
+        write: io.stderr,
+        mode: io.progress ?? "off",
+        total: command.skipInstall
+            ? 1
+            : 2 + (command.skipGenerate ? 0 : GENERATION_STEPS),
+        verbose: command.verbose === true,
+    });
+    await progress.step("Writing the client setup", () => {
+        for (const write of writes) {
+            const target = path.join(io.cwd, write.path);
+            if (write.content === undefined) {
+                rmSync(target, { force: true });
+                continue;
+            }
+            mkdirSync(path.dirname(target), { recursive: true });
+            writeFileSync(target, write.content);
         }
-        mkdirSync(path.dirname(target), { recursive: true });
-        writeFileSync(target, write.content);
-    }
+    });
     io.stdout(`avclient: initialized ${io.cwd}: ${writes.map((write) => (write.content === undefined ? `removed ${write.path}` : write.path)).join(", ") || "nothing to change"}.\n`);
     const install = `${answers.packageManager} install`;
     if (command.skipInstall) {
+        progress.finish("avclient", "done");
         io.stdout(`Next:\n  1. Install @aventara/client ${clientVersion}: ${install}\n  2. With the server running: ${answers.packageManager} run ${GENERATE_SCRIPT}\n`);
         return 0;
     }
-    io.stdout(`avclient: running ${install}…\n`);
-    const installed = await (io.run ?? runCommand)(answers.packageManager, ["install"], {
-        cwd: io.cwd,
+    await progress.step(`Installing dependencies (${install})`, async () => {
+        const installed = await (io.run ?? runCommand)(answers.packageManager, ["install"], {
+            cwd: io.cwd,
+            onOutput: progress.output,
+        });
+        if (installed.code !== 0) {
+            throw new ClientInitStepError(`\`${install}\` exited with code ${installed.code} after ${project.configFile ?? CLIENT_CONFIG_FILE} was written; fix what it reports and run \`${install}\` again:\n${installed.stderr.trimEnd()}`);
+        }
     });
-    if (installed.code !== 0) {
-        throw new ClientInitStepError(`\`${install}\` exited with code ${installed.code} after ${project.configFile ?? CLIENT_CONFIG_FILE} was written; fix what it reports and run \`${install}\` again:\n${installed.stderr.trimEnd()}`);
-    }
     if (command.skipGenerate) {
+        progress.finish("avclient", "done");
         io.stdout(`Next: with the server running, ${answers.packageManager} run ${GENERATE_SCRIPT}\n`);
         return 0;
     }
     try {
-        return await runGenerate(io, command.yes);
+        return await runGenerate(io, command.yes, progress);
     }
     catch (error) {
         if (error instanceof ContractTransportError) {

package/dist/init/command.runner.d.ts

@@ -1,6 +1,8 @@
 /** One child process, stdout and stderr piped and collected: `init`'s install. */
 export type CommandRunner = (command: string, args: readonly string[], options: {
     readonly cwd: string;
+    /** Each chunk of the child's stdout and stderr as it arrives (`--verbose`). */
+    readonly onOutput?: (chunk: string) => void;
 }) => Promise<{
     readonly code: number;
     readonly stderr: string;

package/dist/init/command.runner.js

@@ -6,9 +6,12 @@ export const runCommand = (command, args, options) => new Promise((resolve, reje
         env: process.env,
     });
     let stderr = "";
-    child.stdout.resume();
+    child.stdout.setEncoding("utf8").on("data", (chunk) => {
+        options.onOutput?.(chunk);
+    });
     child.stderr.setEncoding("utf8").on("data", (chunk) => {
         stderr += chunk;
+        options.onOutput?.(chunk);
     });
     child.once("error", reject);
     child.once("close", (code) => {

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventara/client",
-  "version": "0.1.0-pilot.4",
+  "version": "1.0.0-rc.0",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Development-time generator for Aventara typed remote clients.",
   "type": "module",
@@ -20,10 +20,11 @@
   },
   "files": [
     "dist",
-    "LICENSE-ADDITIONAL-PERMISSION.md"
+    "LICENSE-ADDITIONAL-PERMISSION.md",
+    "CHANGELOG.md"
   ],
   "dependencies": {
-    "@aventara/core": "0.1.0-pilot.4",
+    "@aventara/core": "1.0.0-rc.0",
     "c12": "3.3.4",
     "get-tsconfig": "4.10.0"
   },
@@ -39,12 +40,12 @@
     "access": "public"
   },
   "devDependencies": {
-    "@aventara/testing": "0.1.0-pilot.4",
+    "@aventara/testing": "1.0.0-rc.0",
     "@types/node": "24.10.1",
     "typescript": "^5.9.2"
   },
   "scripts": {
-    "build": "tsc -p tsconfig.json --removeComments --declaration false && tsc -p tsconfig.json --emitDeclarationOnly && node ../../scripts/build/declaration-comments.sanitizer.ts dist",
+    "build": "node ../../scripts/build/build-output.cleaner.ts dist && tsc -p tsconfig.json --removeComments --declaration false && tsc -p tsconfig.json --emitDeclarationOnly && node ../../scripts/build/declaration-comments.sanitizer.ts dist",
     "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
     "test": "vitest run --typecheck --config ../../vitest.config.mts --root .",
     "lint": "biome lint src"