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

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

@@ -1,10 +1,10 @@
 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 = [
@@ -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/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,
@@ -49,11 +49,11 @@ 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[]>;

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,6 +1,6 @@
 {
   "name": "@aventara/client",
-  "version": "1.0.0-rc.0",
+  "version": "1.0.0-rc.2",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Development-time generator for Aventara typed remote clients.",
   "type": "module",
@@ -24,12 +24,12 @@
     "CHANGELOG.md"
   ],
   "dependencies": {
-    "@aventara/core": "1.0.0-rc.0",
+    "@aventara/core": "1.0.0-rc.2",
     "c12": "3.3.4",
     "get-tsconfig": "4.10.0"
   },
   "peerDependencies": {
-    "typescript": ">=5.5.0"
+    "typescript": ">=5.7.0"
   },
   "peerDependenciesMeta": {
     "typescript": {
@@ -40,7 +40,7 @@
     "access": "public"
   },
   "devDependencies": {
-    "@aventara/testing": "1.0.0-rc.0",
+    "@aventara/testing": "1.0.0-rc.2",
     "@types/node": "24.10.1",
     "typescript": "^5.9.2"
   },