@aventara/client 1.0.0-rc.0 → 1.0.0-rc.10

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

@@ -4,9 +4,9 @@ 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";
+import { AvContractTransportError } from "../contract/contract.fetcher.js";
 import { CLIENT_ENTRY_FILE } from "../emit/emitted-tree.interface.js";
-import { ClientInitNotConfirmedError, ClientInitStepError, } from "./client-init.errors.js";
+import { AvClientInitNotConfirmedError, AvClientInitStepError, } from "./client-init.errors.js";
 import { GENERATE_SCRIPT, planClientInit } from "./client-init.planner.js";
 import { resolveClientInitAnswers } from "./client-init.questions.js";
 import { inspectClientProject } from "./client-project.inspector.js";
@@ -40,11 +40,11 @@ export async function runClientInit(command, io) {
         const them = plan.conflicts.length === 1 ? "it" : "them";
         const has = plan.conflicts.length === 1 ? "has" : "have";
         if (!io.interactive) {
-            throw new ClientInitNotConfirmedError(`not initializing, and nothing was touched: ${plan.conflicts.join(", ")} already ${has} other content and nobody can be asked (stdin is not a terminal); run \`avclient init --yes\` to replace ${them}.`);
+            throw new AvClientInitNotConfirmedError(`not initializing, and nothing was touched: ${plan.conflicts.join(", ")} already ${has} other content and nobody can be asked (stdin is not a terminal); run \`avclient init --yes\` to replace ${them}.`);
         }
         io.stderr(`avclient: warning: ${plan.conflicts.join(", ")} already ${has} other content, and initializing will replace ${them}.\n`);
         if (!(await io.confirm("avclient: replace them and initialize? [y/N] "))) {
-            throw new ClientInitNotConfirmedError(`cancelled, and nothing was touched; run again and answer yes to replace ${them}.`);
+            throw new AvClientInitNotConfirmedError(`cancelled, and nothing was touched; run again and answer yes to replace ${them}.`);
         }
     }
     const writes = plan.conflicts.length === 0 ? plan.keeping : plan.replacing;
@@ -80,7 +80,7 @@ export async function runClientInit(command, io) {
             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()}`);
+            throw new AvClientInitStepError(`\`${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) {
@@ -92,8 +92,8 @@ export async function runClientInit(command, io) {
         return await runGenerate(io, command.yes, progress);
     }
     catch (error) {
-        if (error instanceof ContractTransportError) {
-            throw new ClientInitStepError(`the project is set up, but the server did not answer (${error.message.replace(/\.$/, "")}); once it is running, run \`avclient generate\`.`);
+        if (error instanceof AvContractTransportError) {
+            throw new AvClientInitStepError(`the project is set up, but the server did not answer (${error.message.replace(/\.$/, "")}); once it is running, run \`avclient generate\`.`);
         }
         throw error;
     }

package/dist/init/client-init.planner.d.ts

@@ -2,11 +2,11 @@ import type { ClientInitAnswers } from "./client-init.questions.js";
 import type { ClientProject } from "./client-project.inspector.js";
 export declare const GENERATE_SCRIPT = "avclient:generate";
 /** One change to a project file: its new content, or `undefined` to remove it. */
-export type ClientInitWrite = {
+type ClientInitWrite = {
     readonly path: string;
     readonly content: string | undefined;
 };
-export type ClientInitPlan = {
+type ClientInitPlan = {
     readonly keeping: readonly ClientInitWrite[];
     readonly replacing: readonly ClientInitWrite[];
     readonly conflicts: readonly string[];
@@ -16,3 +16,4 @@ export declare function planClientInit(input: {
     readonly answers: ClientInitAnswers;
     readonly clientVersion: string;
 }): ClientInitPlan;
+export {};

package/dist/init/client-init.questions.d.ts

@@ -8,25 +8,14 @@ export type ClientInitAnswers = {
 };
 type QuestionId = "entrypoint" | "envVar" | "generateAt" | "packageManager";
 /** An answer the question cannot take. A refusal: one sentence. */
-export declare class ClientInitAnswerError extends Error {
-    readonly name = "ClientInitAnswerError";
+export declare class AvClientInitAnswerError extends Error {
+    readonly name = "AvClientInitAnswerError";
 }
 /** Nobody can answer and some questions are unanswered. A refusal: one sentence. */
-export declare class ClientInitUnansweredError extends Error {
-    readonly name = "ClientInitUnansweredError";
+export declare class AvClientInitUnansweredError extends Error {
+    readonly name = "AvClientInitUnansweredError";
 }
-export type ClientInitQuestion = {
-    readonly id: QuestionId;
-    readonly flag: string;
-    readonly placeholder: string;
-    readonly label: string;
-    readonly defaultFor: (detectedPackageManager: PackageManager) => string;
-    /** @throws ClientInitAnswerError */
-    readonly parse: (raw: string) => string;
-};
-export declare const DEFAULT_ENV_VAR = "AVENTARA_API_URL";
-export declare const CLIENT_INIT_QUESTIONS: readonly ClientInitQuestion[];
-export type ClientInitSources = {
+type ClientInitSources = {
     readonly given: Readonly<Partial<Record<QuestionId, string>>>;
     /** `--no-env-var`: the entrypoint is written as a literal, and no variable is asked. */
     readonly noEnvVar: boolean;

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

@@ -1,13 +1,13 @@
 import { resolveEntrypoint } from "../config/config.resolver.js";
 export const PACKAGE_MANAGERS = ["npm", "pnpm"];
-export class ClientInitAnswerError extends Error {
-    name = "ClientInitAnswerError";
+export class AvClientInitAnswerError extends Error {
+    name = "AvClientInitAnswerError";
 }
-export class ClientInitUnansweredError extends Error {
-    name = "ClientInitUnansweredError";
+export class AvClientInitUnansweredError extends Error {
+    name = "AvClientInitUnansweredError";
 }
-export const DEFAULT_ENV_VAR = "AVENTARA_API_URL";
-export const CLIENT_INIT_QUESTIONS = [
+const DEFAULT_ENV_VAR = "AVENTARA_API_URL";
+const CLIENT_INIT_QUESTIONS = [
     {
         id: "entrypoint",
         flag: "--entrypoint",
@@ -19,7 +19,7 @@ export const CLIENT_INIT_QUESTIONS = [
                 resolveEntrypoint(raw.trim());
             }
             catch (error) {
-                throw new ClientInitAnswerError(error.message.replace(/\.$/, ""));
+                throw new AvClientInitAnswerError(error.message.replace(/\.$/, ""));
             }
             return raw.trim();
         },
@@ -33,7 +33,7 @@ export const CLIENT_INIT_QUESTIONS = [
         parse: (raw) => {
             const name = raw.trim();
             if (!/^[A-Za-z_][A-Za-z0-9_]*$/.test(name)) {
-                throw new ClientInitAnswerError(`${JSON.stringify(raw)} is not an environment variable name.`);
+                throw new AvClientInitAnswerError(`${JSON.stringify(raw)} is not an environment variable name.`);
             }
             return name;
         },
@@ -47,7 +47,7 @@ export const CLIENT_INIT_QUESTIONS = [
         parse: (raw) => {
             const directory = raw.trim();
             if (directory === "") {
-                throw new ClientInitAnswerError("--generate-at takes a directory.");
+                throw new AvClientInitAnswerError("--generate-at takes a directory.");
             }
             return directory;
         },
@@ -61,7 +61,7 @@ export const CLIENT_INIT_QUESTIONS = [
         parse: (raw) => {
             const manager = PACKAGE_MANAGERS.find((candidate) => candidate === raw.trim());
             if (manager === undefined) {
-                throw new ClientInitAnswerError(`${JSON.stringify(raw)} is not a supported package manager; choose ${PACKAGE_MANAGERS.join(" or ")}.`);
+                throw new AvClientInitAnswerError(`${JSON.stringify(raw)} is not a supported package manager; choose ${PACKAGE_MANAGERS.join(" or ")}.`);
             }
             return manager;
         },
@@ -90,7 +90,7 @@ export async function resolveClientInitAnswers(sources) {
                     break;
                 }
                 catch (error) {
-                    if (!(error instanceof ClientInitAnswerError)) {
+                    if (!(error instanceof AvClientInitAnswerError)) {
                         throw error;
                     }
                     sources.say(error.message);
@@ -102,7 +102,7 @@ export async function resolveClientInitAnswers(sources) {
         }
     }
     if (missing.length > 0) {
-        throw new ClientInitUnansweredError(`stdin is not a terminal, so nothing can be asked: pass ${missing.join(", ")}, or pass --yes to accept their defaults.`);
+        throw new AvClientInitUnansweredError(`stdin is not a terminal, so nothing can be asked: pass ${missing.join(", ")}, or pass --yes to accept their defaults.`);
     }
     return {
         entrypoint: answered.entrypoint,

package/dist/init/client-project.inspector.d.ts

@@ -1,8 +1,8 @@
 import type { PackageManager } from "./client-init.questions.js";
 /** The frontend `avclient init` serves, read before anything is asked or written. */
 /** The directory is not a project `avclient init` can set up. A refusal: nothing written. */
-export declare class ClientProjectRefusedError extends Error {
-    readonly name = "ClientProjectRefusedError";
+export declare class AvClientProjectRefusedError extends Error {
+    readonly name = "AvClientProjectRefusedError";
 }
 export type ClientProject = {
     readonly directory: string;

package/dist/init/client-project.inspector.js

@@ -1,13 +1,13 @@
 import { existsSync, readFileSync } from "node:fs";
 import path from "node:path";
 import { findClientConfigFile } from "../config/config.loader.js";
-export class ClientProjectRefusedError extends Error {
-    name = "ClientProjectRefusedError";
+export class AvClientProjectRefusedError extends Error {
+    name = "AvClientProjectRefusedError";
 }
 export function inspectClientProject(directory) {
     const manifest = path.join(directory, "package.json");
     if (!existsSync(manifest)) {
-        throw new ClientProjectRefusedError("avclient init runs in a frontend project: no package.json here; create one first.");
+        throw new AvClientProjectRefusedError("avclient init runs in a frontend project: no package.json here; create one first.");
     }
     const lockfiles = [
         ["package-lock.json", "npm"],

package/dist/internal.d.ts

@@ -0,0 +1,25 @@
+/**
+ * `@aventara/client/internal` is not public API.
+ *
+ * It holds what Aventara's own packages need from the client generator and an
+ * application does not. It carries no stability promise: any export here may
+ * change or disappear in any release, including a patch release.
+ */
+export type { ClientEntrypoint, EmittedEntrypoint, SameOriginEntrypoint, } from "./config/client-config.interface.js";
+export { AvClientConfigError, sameOriginEntrypoint, } from "./config/config.resolver.js";
+export type { EnvCascadeResolution } from "./config/env.cascade.js";
+export { AvEnvFileError, resolveEnvCascade } from "./config/env.cascade.js";
+export { resolveModuleStyle } from "./config/module-style.resolver.js";
+export type { ContractAcceptance } from "./contract/contract.acceptance.js";
+export { acceptClientContract } from "./contract/contract.acceptance.js";
+export { accessVerbsOf } from "./emit/access.emitter.js";
+export type { RegenerateCommand } from "./emit/banner.emitter.js";
+export { carriesGeneratedOwnership } from "./emit/banner.emitter.js";
+export type { ClientClassExport } from "./emit/client-tree.emitter.js";
+export { clientEntryReExports, emitClientTree, } from "./emit/client-tree.emitter.js";
+export type { ClientEmission, EmittedFile, EmittedTree, } from "./emit/emitted-tree.interface.js";
+export { GENERATED_DIRECTORY } from "./emit/emitted-tree.interface.js";
+export type { ClientModuleStyle } from "./emit/module-style.interface.js";
+export { importSpecifier } from "./emit/module-style.interface.js";
+export { AvGeneratedNameError } from "./emit/name.deriver.js";
+export { HYDRATION_FORMAT } from "./hydration/hydration-tag.format.js";

package/dist/internal.js

@@ -0,0 +1,11 @@
+export { AvClientConfigError, sameOriginEntrypoint, } from "./config/config.resolver.js";
+export { AvEnvFileError, resolveEnvCascade } from "./config/env.cascade.js";
+export { resolveModuleStyle } from "./config/module-style.resolver.js";
+export { acceptClientContract } from "./contract/contract.acceptance.js";
+export { accessVerbsOf } from "./emit/access.emitter.js";
+export { carriesGeneratedOwnership } from "./emit/banner.emitter.js";
+export { clientEntryReExports, emitClientTree, } from "./emit/client-tree.emitter.js";
+export { GENERATED_DIRECTORY } from "./emit/emitted-tree.interface.js";
+export { importSpecifier } from "./emit/module-style.interface.js";
+export { AvGeneratedNameError } from "./emit/name.deriver.js";
+export { HYDRATION_FORMAT } from "./hydration/hydration-tag.format.js";

package/dist/output/output.validator.d.ts

@@ -14,7 +14,7 @@ export type TypeScriptResolver = () => Promise<TypeScriptCompiler | undefined>;
  */
 export declare function typeScriptResolverFor(specifier: string, directory: string): TypeScriptResolver;
 export declare function projectTypeScriptResolver(generateAt: string): TypeScriptResolver;
-export declare const MINIMUM_TYPESCRIPT = "5.5.0";
+export declare const MINIMUM_TYPESCRIPT = "5.7.0";
 /** How deeply the tree was judged. */
 export type OutputCheck = "types" | "syntax" | "shape";
 export interface OutputAccepted {
@@ -45,9 +45,8 @@ export declare const SYNTAX_CHECK_UNAVAILABLE_WARNING: string;
 export declare function typeScriptWithoutCompilerApiWarning(version: string, checked: "syntax" | "shape"): string;
 /**
  * The warning a run carries when the project's `typescript` is older than the
- * peer range: its compiler API lacks options the check sets (`Bundler`
- * resolution, `verbatimModuleSyntax`), so its verdict would not be the one a
- * supported compiler gives.
+ * peer range: Aventara's types are not measured under it, so its verdict
+ * would not be the one a supported compiler gives.
  */
 export declare function typeScriptBelowRangeWarning(version: string, checked: "syntax" | "shape"): string;
 /**

package/dist/output/output.validator.js

@@ -24,7 +24,7 @@ export function typeScriptResolverFor(specifier, directory) {
 export function projectTypeScriptResolver(generateAt) {
     return typeScriptResolverFor("typescript", generateAt);
 }
-export const MINIMUM_TYPESCRIPT = "5.5.0";
+export const MINIMUM_TYPESCRIPT = "5.7.0";
 function meetsMinimum(version) {
     const parts = /^(\d+)\.(\d+)\.(\d+)/.exec(version);
     const minimum = MINIMUM_TYPESCRIPT.split(".").map(Number);
@@ -57,7 +57,7 @@ export const SYNTAX_CHECK_UNAVAILABLE_WARNING = "neither `typescript` nor Node's
 export function typeScriptWithoutCompilerApiWarning(version, checked) {
     return (`the installed \`typescript\` ${version} has no classic compiler API (\`createProgram\`), so the generated ` +
         `output was NOT type-checked${checked === "shape" ? " or parsed — only its shape was" : " — only its shape and syntax were"}. ` +
-        "Your project's own `tsc` checks it when it compiles; a `typescript` 5.5 to 6 restores the generator's own type check.");
+        "Your project's own `tsc` checks it when it compiles; a `typescript` 5.7 to 6 restores the generator's own type check.");
 }
 export function typeScriptBelowRangeWarning(version, checked) {
     return (`the installed \`typescript\` ${version} is older than ${MINIMUM_TYPESCRIPT}, the lowest @aventara/client supports, so the generated ` +

package/dist/output/output.writer.d.ts

@@ -5,9 +5,9 @@ import { type OutputCheck, type TypeScriptResolver } from "./output.validator.js
 /** The four stages a write passes through, in order. */
 export type OutputWriteStage = "prepare" | "temp" | "validate" | "replace";
 /** A write that stopped; the previous output is intact unless it says otherwise. */
-export declare class OutputWriteError extends Error {
+export declare class AvOutputWriteError extends Error {
     readonly stage: OutputWriteStage;
-    readonly name = "OutputWriteError";
+    readonly name = "AvOutputWriteError";
     /**
      * What the run said before it stopped, in the order a success returns its
      * warnings: the emission's, the validator's, the writer's. Printed before the
@@ -19,7 +19,7 @@ export declare class OutputWriteError extends Error {
         readonly warnings?: readonly string[];
     });
     /** The same refusal, with `earlier` said before the warnings it already carries. */
-    precededBy(earlier: readonly string[]): OutputWriteError;
+    precededBy(earlier: readonly string[]): AvOutputWriteError;
 }
 /**
  * Records `earlier` as said before `defect`, ahead of anything already recorded,
@@ -32,7 +32,7 @@ export declare function precedeDefect(defect: unknown, earlier: readonly string[
  */
 export declare function warningsRaisedBeforeDefect(defect: unknown): readonly string[];
 export type OutputFileSystem = Pick<typeof fsPromises, "lstat" | "mkdir" | "open" | "readdir" | "rename" | "rm" | "rmdir" | "writeFile">;
-export interface ClientOutputWriteInput {
+interface ClientOutputWriteInput {
     /** What `emitClientTree` returned: the tree, and the warnings it raised. */
     readonly emission: ClientEmission;
     readonly generateAt: AbsolutePath;
@@ -40,7 +40,7 @@ export interface ClientOutputWriteInput {
     readonly resolveTypeScript?: TypeScriptResolver;
     readonly fileSystem?: OutputFileSystem;
 }
-export interface ClientOutputWritten {
+interface ClientOutputWritten {
     readonly generateAt: AbsolutePath;
     readonly checked: OutputCheck;
     readonly warnings: readonly string[];
@@ -49,12 +49,13 @@ export interface ClientOutputWritten {
  * Writes `emission.tree` as `<generateAt>/AvClient.ts` and
  * `<generateAt>/generated/`.
  *
- * @throws OutputWriteError when the write stops; the previous output is intact.
+ * @throws AvOutputWriteError when the write stops; the previous output is intact.
  */
 export declare function writeClientOutput(input: ClientOutputWriteInput): Promise<ClientOutputWritten>;
 /**
- * @throws OutputWriteError when `generateAt` is not a directory, `generated` is
+ * @throws AvOutputWriteError when `generateAt` is not a directory, `generated` is
  *   not a directory or an entry file is not a file: no confirmation repairs that.
  */
 export declare function findForeignOutputContent(generateAt: AbsolutePath, fileSystem?: OutputFileSystem): Promise<readonly string[]>;
 export declare function ownedOutputMatches(generateAt: AbsolutePath, tree: EmittedTree): Promise<boolean>;
+export {};

package/dist/output/output.writer.js

@@ -4,9 +4,9 @@ import path from "node:path";
 import { carriesGeneratedOwnership, GENERATED_OWNERSHIP_HEAD_BYTES, } from "../emit/banner.emitter.js";
 import { CLIENT_ENTRY_FILES, GENERATED_DIRECTORY, LEGACY_CLIENT_ENTRY_FILES, } from "../emit/emitted-tree.interface.js";
 import { projectTypeScriptResolver, validateOutputTree, } from "./output.validator.js";
-export class OutputWriteError extends Error {
+export class AvOutputWriteError extends Error {
     stage;
-    name = "OutputWriteError";
+    name = "AvOutputWriteError";
     warnings;
     constructor(stage, message, options) {
         super(message, options);
@@ -14,7 +14,7 @@ export class OutputWriteError extends Error {
         this.warnings = options?.warnings ?? [];
     }
     precededBy(earlier) {
-        return new OutputWriteError(this.stage, this.message, {
+        return new AvOutputWriteError(this.stage, this.message, {
             cause: this.cause,
             warnings: [...earlier, ...this.warnings],
         });
@@ -65,7 +65,7 @@ export async function writeClientOutput(input) {
             ...validationWarnings,
             ...writerWarnings,
         ];
-        throw error instanceof OutputWriteError
+        throw error instanceof AvOutputWriteError
             ? error.precededBy(said)
             : precedeDefect(error, said);
     }
@@ -99,7 +99,7 @@ export async function writeClientOutput(input) {
                 validationWarnings = validation.warnings;
             }
             else {
-                throw new OutputWriteError("validate", `the generated output failed its ${validation.checked} check, so ${LEFT_AS_THEY_WERE(paths)} ` +
+                throw new AvOutputWriteError("validate", `the generated output failed its ${validation.checked} check, so ${LEFT_AS_THEY_WERE(paths)} ` +
                     "This is a defect in @aventara/client; please report it with these findings:\n" +
                     validation.findings.map((finding) => `  ${finding}`).join("\n"));
             }
@@ -267,7 +267,7 @@ async function inspectOwnedEntries(fs, paths, generatedSource = paths.generated)
     const generatedStats = await lstatOrUndefined(fs, generatedSource);
     if (generatedStats !== undefined) {
         if (!generatedStats.isDirectory()) {
-            throw new OutputWriteError("prepare", `refusing to replace ${generatedSource}: it is not a directory, and the generator owns ` +
+            throw new AvOutputWriteError("prepare", `refusing to replace ${generatedSource}: it is not a directory, and the generator owns ` +
                 `${GENERATED_DIRECTORY}/ as one; move it, or choose another \`generateAt\`. Nothing was written.`);
         }
         const entries = await fs.readdir(generatedSource, {
@@ -292,7 +292,7 @@ async function inspectOwnedEntries(fs, paths, generatedSource = paths.generated)
             continue;
         }
         if (!stats.isFile()) {
-            throw new OutputWriteError("prepare", `refusing to replace ${file}: it is not a file, and the generator owns ${name} ` +
+            throw new AvOutputWriteError("prepare", `refusing to replace ${file}: it is not a file, and the generator owns ${name} ` +
                 "as one; move it, or choose another `generateAt`. Nothing was written.");
         }
         entries.push(name);
@@ -317,12 +317,12 @@ async function inspectOwnedEntries(fs, paths, generatedSource = paths.generated)
 }
 function foreignContentRefusal(paths, foreign) {
     const them = foreign.length === 1 ? "it" : "them";
-    return new OutputWriteError("prepare", `refusing to generate into ${paths.generateAt}: ${foreign.join(", ")} ${foreign.length === 1 ? "was" : "were"} ` +
+    return new AvOutputWriteError("prepare", `refusing to generate into ${paths.generateAt}: ${foreign.join(", ")} ${foreign.length === 1 ? "was" : "were"} ` +
         `not generated by @aventara/client, and generating would overwrite or remove ${them}; confirm the ` +
         `override, move ${them} out, or choose another \`generateAt\`. Nothing was written.`);
 }
 function notADirectory(generateAt) {
-    return new OutputWriteError("prepare", `refusing to generate into ${generateAt}: it is not a directory. ` +
+    return new AvOutputWriteError("prepare", `refusing to generate into ${generateAt}: it is not a directory. ` +
         "`generateAt` must name a directory; choose another `generateAt`. Nothing was written.");
 }
 async function carriesOwnershipLine(fs, file) {
@@ -341,7 +341,7 @@ async function rollBack(paths, cause, undo) {
         await undo();
     }
     catch (rollbackError) {
-        throw new OutputWriteError("replace", `the generated output could not be moved into ${paths.generateAt} (${describe(cause)}), and the ` +
+        throw new AvOutputWriteError("replace", `the generated output could not be moved into ${paths.generateAt} (${describe(cause)}), and the ` +
             `previous output could not be restored (${describe(rollbackError)}). The previous ` +
             `${GENERATED_DIRECTORY}/ is intact at ${paths.previous}; the next run puts it back.`, { cause });
     }
@@ -351,10 +351,10 @@ async function stage(name, paths, run) {
         return await run();
     }
     catch (error) {
-        if (error instanceof OutputWriteError || !isSystemError(error)) {
+        if (error instanceof AvOutputWriteError || !isSystemError(error)) {
             throw error;
         }
-        throw new OutputWriteError(name, `could not ${STAGE_ACTIONS[name]} (${describe(error)}); ${LEFT_AS_THEY_WERE(paths)}`, { cause: error });
+        throw new AvOutputWriteError(name, `could not ${STAGE_ACTIONS[name]} (${describe(error)}); ${LEFT_AS_THEY_WERE(paths)}`, { cause: error });
     }
 }
 const STAGE_ACTIONS = {

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@aventara/client",
-  "version": "1.0.0-rc.0",
+  "version": "1.0.0-rc.10",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Development-time generator for Aventara typed remote clients.",
   "type": "module",
   "engines": {
-    "node": "^22.18.0 || >=24.2.0"
+    "node": "^22.23.4 || >=24.22.1"
   },
   "main": "./dist/index.js",
   "types": "./dist/index.d.ts",
@@ -16,6 +16,10 @@
     ".": {
       "types": "./dist/index.d.ts",
       "import": "./dist/index.js"
+    },
+    "./internal": {
+      "types": "./dist/internal.d.ts",
+      "import": "./dist/internal.js"
     }
   },
   "files": [
@@ -24,12 +28,12 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@aventara/core": "1.0.0-rc.0",
+    "@aventara/core": "1.0.0-rc.10",
     "c12": "3.3.4",
     "get-tsconfig": "4.10.0"
   },
   "peerDependencies": {
-    "typescript": ">=5.5.0"
+    "typescript": ">=5.7.0"
   },
   "peerDependenciesMeta": {
     "typescript": {
@@ -40,7 +44,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@aventara/testing": "1.0.0-rc.0",
+    "@aventara/testing": "1.0.0-rc.10",
     "@types/node": "24.10.1",
     "typescript": "^5.9.2"
   },