@aventara/cli 0.1.0-pilot.4 → 1.0.0-rc.1

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@aventara/cli",
-  "version": "0.1.0-pilot.4",
+  "version": "1.0.0-rc.1",
   "license": "SEE LICENSE IN LICENSE",
   "description": "Scaffolds an Aventara server: `aventara new` for a new NestJS project, `aventara init` for an existing one.",
   "type": "module",
@@ -12,7 +12,8 @@
   },
   "files": [
     "dist",
-    "LICENSE-ADDITIONAL-PERMISSION.md"
+    "LICENSE-ADDITIONAL-PERMISSION.md",
+    "CHANGELOG.md"
   ],
   "publishConfig": {
     "access": "public"
@@ -23,7 +24,7 @@
   },
   "scripts": {
     "prebuild": "node scripts/adapter-catalog.generator.ts",
-    "build": "tsc -p tsconfig.json --removeComments --declaration false",
+    "build": "node ../../scripts/build/build-output.cleaner.ts dist && tsc -p tsconfig.json --removeComments",
     "typecheck": "tsc -p tsconfig.typecheck.json --noEmit",
     "test": "vitest run --typecheck --config ../../vitest.config.mts --root .",
     "lint": "biome lint src scripts"

package/dist/apply/app-module.anchor.d.ts

@@ -1,24 +0,0 @@
-/**
- * The scan is string- and comment-aware (a `@Module(` or an `imports: [` inside a
- * comment, a string or a template literal is not code), and it never reformats:
- * everything outside the two insertion points keeps its bytes. When the anchor is
- * not found exactly once — two `@Module`s, a computed `imports`, no `imports` at
- * all — nothing is edited and the caller prints the lines to add instead.
- */
-export type AppModuleWiring = {
-    /** Complete import declarations, one per line. */
-    readonly imports: readonly string[];
-    /** `imports:` entries, each possibly multi-line, each ending with a comma. */
-    readonly entries: readonly string[];
-};
-export type AppModuleEdit = {
-    readonly kind: "edited";
-    readonly text: string;
-} | {
-    readonly kind: "not-anchored";
-    readonly reason: string;
-};
-/** Splices `wiring` into `text` at the anchor, or says why there is no anchor. */
-export declare function spliceAppModule(text: string, wiring: AppModuleWiring): AppModuleEdit;
-/** What to add by hand when there is no anchor. */
-export declare function wiringInstructions(wiring: AppModuleWiring): string;

package/dist/apply/conflict.confirmer.d.ts

@@ -1,15 +0,0 @@
-import type { Prompter } from "../wizard/answer.resolver.js";
-/** Nobody confirmed replacing existing content. A refusal: nothing was touched. */
-export declare class ConflictsNotConfirmedError extends Error {
-    readonly name = "ConflictsNotConfirmedError";
-}
-export declare function conflictWarning(conflicts: readonly string[]): string;
-/**
- * Resolves when `conflicts` may be replaced; throws when they may not.
- *
- * @throws ConflictsNotConfirmedError
- */
-export declare function confirmConflicts(conflicts: readonly string[], consent: {
-    readonly yes: boolean;
-    readonly prompter: Prompter;
-}): Promise<void>;

package/dist/apply/e2e-spec.anchor.d.ts

@@ -1,18 +0,0 @@
-/**
- * pilot.1 — the scaffold's own e2e spec also proves the protocol is mounted.
- *
- * `nest new`'s `test/app.e2e-spec.ts` (`@nestjs/schematics` 12's template, ESM
- * and CommonJS alike) tests `GET /` and nothing else. Like the `app.module.ts`
- * edit, this one is anchored on Nest's exact text: the `/ (GET)` test is found
- * exactly once, and a `GET <entrypoint>/_contract` test is added right after
- * it, through the spec's own `app` and `request`. A spec that is not Nest's —
- * the developer's own — is left as it is, and nothing is said: the test is a
- * convenience, and the developer's tests are theirs.
- */
-/** The e2e spec `nest new` writes. */
-export declare const E2E_SPEC = "test/app.e2e-spec.ts";
-/**
- * `spec` with the contract test after Nest's `GET /` test, or `undefined` when
- * the anchor is not there exactly once, or the contract test already is.
- */
-export declare function spliceContractTest(spec: string, entrypoint: string): string | undefined;

package/dist/apply/main-cors.anchor.d.ts

@@ -1,50 +0,0 @@
-/**
- * pilot.3 — the scaffold turns CORS on in `src/main.ts` for the origins listed in
- * `CORS_ORIGINS`, so a browser frontend on another port (Vite's 5173, a Next.js
- * dev server on 3001) can call the protocol:
- *
- * const corsOrigins = (process.env.CORS_ORIGINS ?? '')…filter(Boolean);
- * app.enableCors({ origin: corsOrigins.length > 0 ? corsOrigins : false });
- *
- * followed by a commented-out platform-level rate limiter.
- *
- * **Unset or empty is OFF, never open.** The `cors` package Nest's Express
- * platform uses — and `@fastify/cors` — answer `Access-Control-Allow-Origin: *`
- * when given no origin, so the list is never passed through as it is: no origin is
- * `false`, CORS disabled.
- *
- * Like the `app.module.ts` edit, this one is anchored and never reformats: the
- * lines are inserted after the one statement that creates the application — `const
- * app = await NestFactory.create(…);`, found in code exactly once — through its
- * own variable. A `main.ts` that already configures CORS (`enableCors`, or a
- * `cors` option given to `NestFactory.create`) is the developer's decision and is
- * left as it is; one with no such statement is not edited, and the lines are
- * printed instead.
- */
-/** The variable the inserted lines read. */
-export declare const CORS_ORIGINS_VARIABLE = "CORS_ORIGINS";
-/** What the scaffold's `.env` lists: Vite's dev server, and a Next.js one beside Nest's 3000. */
-export declare const SCAFFOLD_CORS_ORIGINS = "http://localhost:5173,http://localhost:3001";
-/** The main file `nest new` writes. */
-export declare const MAIN_FILE = "src/main.ts";
-export type MainCorsEdit = 
-/** The lines were inserted. */
-{
-    readonly kind: "edited";
-    readonly text: string;
-}
-/** The lines are already there: a previous run's edit. */
- | {
-    readonly kind: "present";
-}
-/** The developer configures CORS: nothing is changed. */
- | {
-    readonly kind: "configured";
-} | {
-    readonly kind: "not-anchored";
-    readonly reason: string;
-};
-/** Splices the CORS lines into `text`, or says why they are not. */
-export declare function spliceMainCors(text: string): MainCorsEdit;
-/** What to add by hand when there is no anchor. */
-export declare function mainCorsInstructions(): string;

package/dist/apply/manifest.merger.d.ts

@@ -1,51 +0,0 @@
-/**
- * The merges `aventara init` makes into files a project already has —
- * `package.json`, `.env`, `.gitignore`, `pnpm-workspace.yaml` — each answering the
- * merged text and the **conflicts**: values already there that differ from what
- * would be written (the `generateAt` rule's "content the tool did not produce"). A
- * value already equal to what would be written is no change; a conflict is
- * replaced only once confirmed (`conflict.confirmer.ts`), so each merge is
- * computed with conflicts both kept and replaced.
- */
-export type Merge = {
-    readonly text: string;
-    /** What differs, named for the person asked: `package.json's scripts["postinstall"]`. */
-    readonly conflicts: readonly string[];
-};
-export type PackageManifest = {
-    readonly [key: string]: unknown;
-    readonly dependencies?: Readonly<Record<string, string>>;
-    readonly devDependencies?: Readonly<Record<string, string>>;
-    readonly scripts?: Readonly<Record<string, string>>;
-};
-export type ManifestChanges = {
-    readonly dependencies: Readonly<Record<string, string>>;
-    readonly devDependencies: Readonly<Record<string, string>>;
-    /** Scripts to set; a different existing value is a conflict. */
-    readonly scripts: Readonly<Record<string, string>>;
-    /**
-     * Scripts to rewrite only from a known value: `from` → `to`. Any other existing
-     * value is a conflict; an absent script is left absent.
-     */
-    readonly rewrites: Readonly<Record<string, {
-        readonly from: string;
-        readonly to: string;
-    }>>;
-};
-/** `package.json`, in npm's own layout: two-space JSON, dependencies sorted. */
-export declare function mergePackageManifest(text: string, changes: ManifestChanges, replaceConflicts: boolean): Merge;
-/** `.env`: a missing key is appended as `KEY="value"`, after a final newline. */
-export declare function mergeEnvFile(text: string | undefined, entries: Readonly<Record<string, string>>, replaceConflicts: boolean): Merge;
-/**
- * pilot.3 — `.env`: `KEY="value"` appended after a final newline when no line sets
- * `key`; a line that does is the developer's, never a conflict, and nothing else
- * is reordered or rewritten.
- */
-export declare function appendEnvEntryIfAbsent(text: string | undefined, key: string, value: string): string;
-/** `.gitignore`: missing lines appended, nothing else touched. */
-export declare function mergeGitignore(text: string | undefined, additions: readonly string[]): Merge;
-/**
- * Keys missing under an existing `allowBuilds:` are added there; otherwise the
- * block is appended.
- */
-export declare function mergePnpmWorkspace(text: string | undefined, packages: readonly string[]): Merge;

package/dist/aventara.bin.d.ts

@@ -1,2 +0,0 @@
-#!/usr/bin/env node
-export {};

package/dist/catalog/adapter.catalog.generated.d.ts

@@ -1,20 +0,0 @@
-export declare const ADAPTER_CATALOG: readonly [{
-    readonly id: "prisma7";
-    readonly alias: "prisma7";
-    readonly adapterPackage: "@aventara/prisma7-adapter";
-    readonly orm: {
-        readonly family: "prisma";
-        readonly label: "Prisma";
-        readonly package: "@prisma/client";
-        readonly major: 7;
-    };
-    readonly range: "^7.10.0";
-    readonly familyPackages: readonly ["prisma", "@prisma/client", "@prisma/prisma7", "@prisma/orm-*"];
-    readonly providers: readonly ["sqlite", "postgresql"];
-    readonly drivers: {
-        readonly sqlite: "@prisma/adapter-better-sqlite3";
-        readonly postgresql: "@prisma/adapter-pg";
-    };
-    readonly generators: readonly ["prisma-client"];
-    readonly bin: "aventara-prisma7-generate";
-}];

package/dist/catalog/catalog-entry.interface.d.ts

@@ -1,54 +0,0 @@
-import type { ADAPTER_CATALOG } from "./adapter.catalog.generated.js";
-/**
- * One entry per Aventara adapter package that exists: what the CLI may offer and
- * what it must refuse, every value traced to that adapter's own manifest — its
- * `aventara.adapter` declaration, its `peerDependencies` and its `bin`. The
- * entries are **generated** at this package's build by
- * `scripts/adapter-catalog.generator.ts` into `adapter.catalog.generated.ts` and
- * never edited. The CLI holds no list of ORMs, majors, providers or drivers of its
- * own.
- */
-export type CatalogEntry = {
-    /**
-     * The adapter package's ORM stem, e.g. `prisma7`: the wizard's value and the
-     * templates' key.
-     */
-    readonly id: string;
-    /**
-     * `aventara.adapter.alias`, e.g. `prisma7`: what `--orm` takes. Always
-     * `<orm><major>`, the generator refuses any other.
-     */
-    readonly alias: string;
-    /** The adapter package a project installs, e.g. `@aventara/prisma7-adapter`. */
-    readonly adapterPackage: string;
-    readonly orm: {
-        /** `aventara.adapter.orm`, e.g. `prisma`: the family the wizard groups majors under. */
-        readonly family: string;
-        /** `aventara.adapter.ormLabel`, e.g. `Prisma`: how the wizard names the family. */
-        readonly label: string;
-        /** `aventara.adapter.ormPackage`, e.g. `@prisma/client`: whose installed version selects the entry. */
-        readonly package: string;
-        /** The one major `range` admits. */
-        readonly major: number;
-    };
-    /** `peerDependencies[orm.package]`: the ORM versions the adapter supports. */
-    readonly range: string;
-    /** Packages that identify the ORM family in a project. */
-    readonly familyPackages: readonly string[];
-    /** Database providers, in the adapter's order; the first is the default. */
-    readonly providers: readonly string[];
-    /** Provider → the driver adapter package for it. */
-    readonly drivers: Readonly<Record<string, string>>;
-    /** The ORM generators whose output the adapter reads. */
-    readonly generators: readonly string[];
-    /** The adapter's generate step: its one `bin`. */
-    readonly bin: string;
-};
-export type AdapterCatalog = readonly CatalogEntry[];
-/** The generated catalog's literal type: what the template registry is checked against. */
-export type Catalog = typeof ADAPTER_CATALOG;
-export type EntryId = Catalog[number]["id"];
-/** The providers one entry declares, as literals. */
-export type ProviderOf<I extends EntryId> = Extract<Catalog[number], {
-    readonly id: I;
-}>["providers"][number];

package/dist/catalog/catalog.matcher.d.ts

@@ -1,40 +0,0 @@
-import type { AdapterCatalog, CatalogEntry } from "./catalog-entry.interface.js";
-/**
- * 1. The ORM family: the catalog entries whose family packages the project depends
- *    on (a pattern ending in `*` is a prefix).
- * 2. Every other family package installed must be of that same major — a Prisma 8
- *    CLI or an `@prisma/orm-*` beside a Prisma 7 client is a project
- *    mid-migration, refused.
- * 3. The entry for that major, or a refusal naming what exists.
- * 4. The installed version inside the entry's declared range.
- * 5. Then what the project's ORM setup declares — provider, driver, generator —
- *    against the entry's providers, drivers and generators.
- *
- * Every refusal is one sentence naming what was found and what the catalog offers.
- * Nothing has been written when one is raised.
- */
-export type MatchVerdict = {
-    readonly kind: "matched";
-    readonly entry: CatalogEntry;
-} | {
-    readonly kind: "refused";
-    readonly sentence: string;
-};
-export type InstalledOrm = {
-    /** The project's dependency names (dependencies and devDependencies). */
-    readonly dependencies: readonly string[];
-    /** The installed version of a package, or `undefined` when it is not installed. */
-    readonly installedVersion: (name: string) => string | undefined;
-    /** The command that installs the project's dependencies. */
-    readonly installCommand: string;
-};
-/** What the project's ORM setup states, read by the entry's templates. */
-export type OrmSetup = {
-    readonly provider: string | undefined;
-    readonly generator: string | undefined;
-    /** The driver-adapter packages the project depends on. */
-    readonly drivers: readonly string[];
-};
-export declare function matchInstalledOrm(catalog: AdapterCatalog, project: InstalledOrm): MatchVerdict;
-/** Step 5: the project's provider, driver and generator against what `entry` declares. */
-export declare function matchOrmSetup(entry: CatalogEntry, setup: OrmSetup): string | undefined;

package/dist/catalog/range.reader.d.ts

@@ -1,11 +0,0 @@
-/** `^7.10.0` → `7.10.0`; `>=7.10.0 <8` → `7.10.0`. */
-export declare function lowestVersionOf(range: string): string;
-/** `^12.0.1` → 12; `~6.0.2` → 6; a range with no number (`latest`, `*`) → `undefined`. */
-export declare function lowestMajorOf(range: string): number | undefined;
-/**
- * Whether an installed `version` is in a declared `range`. Reads the comparator
- * forms an adapter's peer range uses; a pre-release never satisfies (semver's rule
- * for a range whose comparators carry none). Any other form is refused rather than
- * guessed.
- */
-export declare function satisfiesRange(version: string, range: string): boolean;

package/dist/cli.d.ts

@@ -1,29 +0,0 @@
-import type { AdapterCatalog } from "./catalog/catalog-entry.interface.js";
-import { type CommandRunner } from "./run/command.runner.js";
-import { type Prompter } from "./wizard/answer.resolver.js";
-/**
- * `aventara` — the bin: `new` and `init`. A refusal is one sentence on stderr and
- * exit 1, never a stack; anything else is a defect and keeps its stack.
- *
- * `init` initializes the project in the working directory
- * (`run/init.orchestrator.ts`); `new` creates one with the pinned `nest new` and
- * then runs the same pipeline over it (`run/new.orchestrator.ts`).
- */
-export type CliIo = {
-    /** The working directory: where `init` initializes and `new` creates. */
-    readonly cwd: string;
-    readonly env: Readonly<Record<string, string | undefined>>;
-    readonly stdout: (text: string) => void;
-    readonly stderr: (text: string) => void;
-    readonly prompter: Prompter;
-    readonly runner?: CommandRunner;
-    readonly catalog?: AdapterCatalog;
-};
-export declare function runCli(argv: readonly string[], io: CliIo): Promise<number>;
-/**
- * Runs `aventara` over this process — its arguments, its terminal, its exit
- * code. Called by the bin's entry (`aventara.bin.ts`) once the Node guard has
- * admitted this Node; importing this module runs nothing, which lets `runCli`
- * be tested in process.
- */
-export declare function runFromProcess(): Promise<void>;

package/dist/command/command.parser.d.ts

@@ -1,38 +0,0 @@
-import type { AdapterCatalog } from "../catalog/catalog-entry.interface.js";
-import { type QuestionId } from "../wizard/wizard.questions.js";
-/**
- * The `aventara` command line: `new <name>` and `init`, each question's flag from
- * the wizard's table, and the options that are not questions. Unknown, misplaced
- * or repeated arguments are refused in one sentence; a flag's VALUE is the
- * question's to judge, because what is valid (`--db`'s providers) depends on the
- * catalog and on earlier answers.
- */
-export type ScaffoldCommandName = "new" | "init";
-export type ScaffoldCommand = {
-    readonly command: ScaffoldCommandName;
-    /** Raw answers by question, from flags and `new`'s positional `<name>`. */
-    readonly given: Readonly<Partial<Record<QuestionId, string>>>;
-    readonly skipInstall: boolean;
-    /** `new` only: passed through to `nest new`. */
-    readonly skipGit: boolean;
-    /** Accepts each unanswered question's default and confirms overwrites. */
-    readonly yes: boolean;
-};
-export type CliCommand = 
-/** `--help`; with `topic`, `aventara <topic> --help` (pilot.1). */
-{
-    readonly command: "help";
-    readonly topic?: ScaffoldCommandName;
-} | {
-    readonly command: "version";
-} | ScaffoldCommand;
-/** The command line cannot be understood. A refusal: one sentence, exit 1. */
-export declare class CliCommandError extends Error {
-    readonly name = "CliCommandError";
-}
-/** `aventara <command> --help` (pilot.1): that command's usage alone. */
-export declare function commandUsage(command: ScaffoldCommandName, catalog: AdapterCatalog): string;
-/** `aventara --help`: both commands, each flag with the values `catalog` offers. */
-export declare function usage(catalog: AdapterCatalog): string;
-/** @throws CliCommandError when `argv` is not a command this CLI has. */
-export declare function parseCliCommand(argv: readonly string[]): CliCommand;

package/dist/node-version.guard.d.ts

@@ -1,8 +0,0 @@
-/** The sentence a bin answers on `version`, or `undefined` when `range` admits it. */
-export declare function nodeVersionRefusal(bin: string, packageName: string, range: string, version: string): string | undefined;
-/**
- * Reads the manifest at `manifestUrl`; on a Node its `engines.node` does not
- * admit, writes the sentence to stderr, sets exit code 1 and answers `true` —
- * the bin then loads nothing else.
- */
-export declare function refuseUnsupportedNode(bin: string, manifestUrl: URL): boolean;

package/dist/plan/project.planner.d.ts

@@ -1,53 +0,0 @@
-import type { CatalogEntry } from "../catalog/catalog-entry.interface.js";
-import { type ProjectInspection } from "../project/project.inspector.js";
-import { type OrmScaffold } from "../templates/template.registry.js";
-import type { PackageManager } from "../wizard/wizard.questions.js";
-/**
- * Pure apart from reading the files it would replace.
- */
-/**
- * The name of the script that regenerates the ORM client and the discovery
- * artifact.
- */
-export declare const PREPARE_SCRIPT = "aventara:prepare";
-export type PlannedWrite = {
-    readonly path: string;
-    readonly content: string;
-    /** `create` a new file, or `replace` one whose content changes. */
-    readonly change: "create" | "replace";
-};
-export type ProjectPlan = {
-    /** What is written when the conflicts are kept as they are. */
-    readonly keeping: readonly PlannedWrite[];
-    /** What is written once the conflicts are confirmed (`--yes`, or a yes). */
-    readonly replacing: readonly PlannedWrite[];
-    /** Existing content that differs from what would be written. */
-    readonly conflicts: readonly string[];
-    readonly warnings: readonly string[];
-    /** Printed when the anchored edit could not be made. */
-    readonly instructions: string | undefined;
-    readonly nextSteps: readonly string[];
-};
-export type PlanInput = {
-    readonly inspection: ProjectInspection;
-    readonly entry: CatalogEntry;
-    readonly scaffold: OrmScaffold;
-    readonly packageManager: PackageManager;
-    /** This CLI's version: every Aventara package is pinned to it. */
-    readonly aventaraVersion: string;
-    readonly skipInstall: boolean;
-    /** The current text of a project file, or `undefined` when absent. */
-    readonly read: (file: string) => string | undefined;
-    /** The anchored edit is not attempted; the wiring is printed. */
-    readonly wiringByHand?: string;
-    /** Said before the write, beside the planner's own. */
-    readonly warnings?: readonly string[];
-};
-/**
- * pilot.1 — the frontend's first command, as the developer can run it: the
- * package manager's own one-off runner (`npx` or `pnpm dlx`), and — while this
- * CLI is a prerelease — its dist-tag, so the client comes from the same release
- * (`0.1.0-pilot.1` → `@aventara/client@pilot`). A release has no tag to name.
- */
-export declare function frontendInitCommand(packageManager: PackageManager, cliVersion: string): string;
-export declare function planInit(input: PlanInput): ProjectPlan;

package/dist/project/package-manager.detector.d.ts

@@ -1,5 +0,0 @@
-import type { PackageManager } from "../wizard/wizard.questions.js";
-export declare function detectPackageManager(signals: {
-    readonly lockfile?: PackageManager | undefined;
-    readonly userAgent?: string | undefined;
-}): PackageManager;

package/dist/project/project.inspector.d.ts

@@ -1,32 +0,0 @@
-import type { PackageManifest } from "../apply/manifest.merger.js";
-import type { AdapterCatalog, CatalogEntry } from "../catalog/catalog-entry.interface.js";
-import type { ModuleKind } from "../templates/template.registry.js";
-import type { PackageManager } from "../wizard/wizard.questions.js";
-/** The project is not one `aventara init` serves. A refusal: one sentence, nothing written. */
-export declare class ProjectRefusedError extends Error {
-    readonly name = "ProjectRefusedError";
-}
-/** The ORM a project already has, by the catalog's family packages. */
-export type OrmPresence = {
-    readonly kind: "absent";
-} | {
-    readonly kind: "present";
-    /** The family packages found among its dependencies. */
-    readonly packages: readonly string[];
-    /** The catalog entries whose family they belong to. */
-    readonly families: readonly CatalogEntry["orm"]["label"][];
-};
-export type ProjectInspection = {
-    readonly directory: string;
-    readonly manifest: PackageManifest;
-    readonly manifestText: string;
-    readonly moduleKind: ModuleKind;
-    /** The package manager the lockfile names, if exactly one does. */
-    readonly lockfile: PackageManager | undefined;
-    readonly orm: OrmPresence;
-    /** `@nestjs/config` loads `.env` itself, so the start scripts are left alone. */
-    readonly usesNestConfig: boolean;
-};
-/** The file the anchored edit opens. */
-export declare const APP_MODULE = "src/app.module.ts";
-export declare function inspectProject(directory: string, catalog: AdapterCatalog): ProjectInspection;

package/dist/project/service.detector.d.ts

@@ -1,40 +0,0 @@
-/**
- * 1. **Candidates**: exported classes that `extends` the ORM's client class, where
- *    the file imports that class from a specifier the ORM's templates recognise
- *    (the generated client, or the ORM package).
- * 3. **Modules**: each `@Module({…})`-decorated exported class with the
- *    identifiers its `providers` and `exports` list, and whether it is
- *    `@Global()`.
- *
- * Which of them is *the* service is the caller's question (the wizard's).
- */
-export type ExportReference = {
-    /** Relative to the project root, POSIX separators. */
-    readonly file: string;
-    readonly exportName: string;
-};
-export type ServiceComposition = ExportReference & {
-    /** The member that holds the client. */
-    readonly member: string;
-};
-export type ModuleDeclaration = ExportReference & {
-    readonly providers: readonly string[];
-    readonly exports: readonly string[];
-    readonly global: boolean;
-};
-export type ServiceScan = {
-    readonly candidates: readonly ExportReference[];
-    readonly compositions: readonly ServiceComposition[];
-    readonly modules: readonly ModuleDeclaration[];
-};
-export type ClientShape = {
-    /** The client class a service extends, e.g. the ORM's generated client. */
-    readonly clientClass: string;
-    /** Whether `specifier`, imported by `file` (project-relative), is the client's module. */
-    readonly importsClient: (specifier: string, file: string) => boolean;
-    /** Directories under `src/` that hold generated code, skipped. */
-    readonly skip: readonly string[];
-};
-export declare function scanServices(directory: string, shape: ClientShape): ServiceScan;
-/** The modules that make `service` injectable elsewhere: providing and exporting it, or global. */
-export declare function modulesProviding(scan: ServiceScan, service: ExportReference): readonly ModuleDeclaration[];

package/dist/project/source.scanner.d.ts

@@ -1,16 +0,0 @@
-/**
- * A lexical view of TypeScript source — enough to find decorators, classes,
- * imports and brackets **in code**, never inside a comment, a string or a
- * template literal's text — with no compiler: `aventara new` runs before
- * anything (TypeScript included) is installed in the project, and the CLI
- * carries no TypeScript of its own. Shared by the anchored `app.module.ts` edit
- * and the detection of a developer's ORM service.
- */
-/** For each character: is it code (not inside a comment, string or template text)? */
-export declare function codeMask(text: string): boolean[];
-/** Every index where `token` starts in code. */
-export declare function codeIndexes(text: string, code: boolean[], token: RegExp): number[];
-export declare const OPENERS: Readonly<Record<string, string>>;
-/** The index of the bracket closing the one at `open`, counting code brackets only. */
-export declare function closing(text: string, code: boolean[], open: number): number;
-export declare function nextCode(text: string, code: boolean[], from: number): number;

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

@@ -1,15 +0,0 @@
-/**
- * The one external process seam: a command, its arguments, a working directory.
- * Its stdout is always **piped**, never inherited — `nest new` asks a question it
- * has no flag for when its stdout is a terminal — and both streams are collected,
- * so a failure can be reported with what it said.
- */
-export type CommandResult = {
-    readonly code: number;
-    readonly stdout: string;
-    readonly stderr: string;
-};
-export type CommandRunner = (command: string, args: readonly string[], options: {
-    readonly cwd: string;
-}) => Promise<CommandResult>;
-export declare const runCommand: CommandRunner;

package/dist/run/init.orchestrator.d.ts

@@ -1,27 +0,0 @@
-import type { AdapterCatalog } from "../catalog/catalog-entry.interface.js";
-import type { ScaffoldCommand } from "../command/command.parser.js";
-import { type Prompter } from "../wizard/answer.resolver.js";
-import type { CommandRunner } from "./command.runner.js";
-/**
- * Every step before the write reads; so a refusal anywhere before it leaves the
- * project exactly as it was. A failure after it (the install) names the command,
- * its exit code and what to re-run; nothing is rolled back.
- */
-export type InitIo = {
-    readonly directory: string;
-    readonly env: Readonly<Record<string, string | undefined>>;
-    readonly stdout: (text: string) => void;
-    readonly stderr: (text: string) => void;
-    readonly prompter: Prompter;
-    readonly runner: CommandRunner;
-    readonly catalog: AdapterCatalog;
-    /** This CLI's own version. */
-    readonly aventaraVersion: string;
-    /** Next steps that come before init's own (`new`'s `cd <name>`). */
-    readonly firstSteps?: readonly string[];
-};
-/** The install step failed after the files were written. Reported, exit 1. */
-export declare class InstallFailedError extends Error {
-    readonly name = "InstallFailedError";
-}
-export declare function runInit(command: ScaffoldCommand, io: InitIo): Promise<number>;

package/dist/run/new.orchestrator.d.ts

@@ -1,20 +0,0 @@
-import type { ScaffoldCommand } from "../command/command.parser.js";
-import { type InitIo } from "./init.orchestrator.js";
-/**
- * `aventara new <name>`: the pinned `nest new`, then **exactly** `aventara init`'s
- * pipeline over the fresh project, with the wizard's answers carried in — so every
- * `new` run exercises the anchored edit, the merges and the templates `init` uses
- * — and, after the install, the project's first commit (`scaffold.committer.ts`,
- * pilot.3).
- *
- * Nest authors its own scaffold: the CLI never writes Nest's files. Its output is
- * pinned by digest, so a `@nestjs/cli` that writes something else stops the run
- * before anything of Aventara's is written over it.
- */
-export declare const NEST_CLI = "@nestjs/cli@12.0.8";
-export declare const NEST_APP_MODULE_SHA256 = "fe98c4cd2552342272494652287c02e4ef58db3072fcb18513ea831c60f85778";
-export type NewIo = Omit<InitIo, "directory"> & {
-    /** Where `new` creates the project directory. */
-    readonly cwd: string;
-};
-export declare function runNew(command: ScaffoldCommand, io: NewIo): Promise<number>;