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

package/dist/templates/prisma7/prisma7.templates.js

@@ -1,370 +1,12 @@
-import { existsSync, readdirSync, readFileSync, statSync } from "node:fs";
-import path from "node:path";
-import { lowestVersionOf } from "../../catalog/range.reader.js";
-import { SCAFFOLD_ENTRYPOINT, } from "../template.registry.js";
-const CLIENT_OUTPUT = "src/generated/prisma";
-const SCHEMA = "prisma/schema.prisma";
-const CONFIG_FILES = ["prisma7.config.ts", "prisma.config.ts"];
-const DRIVER_PREFIX = "@prisma/adapter-";
-const NEW_SERVICE = {
-    file: "src/prisma.service.ts",
-    exportName: "PrismaService",
-};
-const NEW_MODULE = {
-    file: "src/prisma.service.ts",
-    exportName: "PrismaModule",
-};
-const PROVIDERS = {
-    sqlite: {
-        driverClass: "PrismaBetterSqlite3",
-        driverOptions: "{ url }",
-        databaseUrl: "file:./dev.db",
-        gitignore: ["/dev.db*"],
-        nativeBuilds: ["@prisma/engines", "better-sqlite3", "prisma"],
-    },
-    postgresql: {
-        driverClass: "PrismaPg",
-        driverOptions: "{ connectionString: url }",
-        databaseUrl: "postgresql://johndoe:randompassword@localhost:5432/mydb?schema=public",
-        gitignore: [],
-        nativeBuilds: ["@prisma/engines", "prisma"],
-    },
-};
-function specifier(from, to, js) {
-    const relative = path.posix.relative(path.posix.dirname(from), to);
-    return `${relative.startsWith(".") ? relative : `./${relative}`}${js}`;
-}
-function schema(input) {
-    return [
-        "generator client {",
-        `  provider = "${input.entry.generators[0]}"`,
-        `  output   = "../${CLIENT_OUTPUT}"`,
-        ...(input.moduleKind === "cjs" ? ['  moduleFormat = "cjs"'] : []),
-        "}",
-        "",
-        "datasource db {",
-        `  provider = "${input.provider}"`,
-        "}",
-        "",
-        "model User {",
-        "  id    Int     @id @default(autoincrement())",
-        "  email String  @unique",
-        "  name  String?",
-        "}",
-        "",
-    ].join("\n");
-}
-function prismaConfig() {
-    return [
-        "import { existsSync } from 'node:fs';",
-        "import { defineConfig } from 'prisma/config';",
-        "",
-        "// Prisma reads DATABASE_URL from the environment and does not load .env itself.",
-        "if (existsSync('.env')) {",
-        "  process.loadEnvFile('.env');",
-        "}",
-        "",
-        "export default defineConfig({",
-        `  schema: '${SCHEMA}',`,
-        "  migrations: {",
-        "    path: 'prisma/migrations',",
-        "  },",
-        "  datasource: {",
-        "    url: process.env.DATABASE_URL,",
-        "  },",
-        "});",
-        "",
-    ].join("\n");
-}
-function prismaService(input) {
-    const provider = PROVIDERS[input.provider];
-    const driver = input.entry.drivers[input.provider];
-    return [
-        "import { Injectable, Module, type OnModuleDestroy } from '@nestjs/common';",
-        `import { ${provider.driverClass} } from '${driver}';`,
-        `import { PrismaClient } from '${specifier(NEW_SERVICE.file, `${input.clientOutput}/client`, input.js)}';`,
-        "",
-        "@Injectable()",
-        "export class PrismaService extends PrismaClient implements OnModuleDestroy {",
-        "  constructor() {",
-        "    const url = process.env.DATABASE_URL;",
-        "    if (!url) {",
-        "      // Thrown while Nest builds the application, before it listens.",
-        "      throw new Error(",
-        "        'DATABASE_URL is not set: put it in .env (the start scripts load it) or in the environment.',",
-        "      );",
-        "    }",
-        `    super({ adapter: new ${provider.driverClass}(${provider.driverOptions}) });`,
-        "  }",
-        "",
-        "  async onModuleDestroy(): Promise<void> {",
-        "    await this.$disconnect();",
-        "  }",
-        "}",
-        "",
-        "@Module({ providers: [PrismaService], exports: [PrismaService] })",
-        "export class PrismaModule {}",
-        "",
-    ].join("\n");
-}
-function aventaraConfig(input) {
-    const file = "src/aventara.config.ts";
-    const service = input.service.exportName;
-    return [
-        `import { createPrismaAdapter } from '${input.entry.adapterPackage}';`,
-        `import { discovery } from '${specifier(file, input.artifact.replace(/\.ts$/, ""), input.js)}';`,
-        `import type { ${service} } from '${specifier(file, input.service.file.replace(/\.ts$/, ""), input.js)}';`,
-        "",
-        "/**",
-        " * Aventara's configuration: the entrypoint, and the restrictions and",
-        " * pipelines you add. AventaraModule (app.module.ts) builds the framework from",
-        " * it; `discovery` is regenerated by the aventara:prepare script.",
-        " */",
-        `export async function aventaraConfig(prisma: ${service}) {`,
-        "  return {",
-        `    entrypoint: '${SCAFFOLD_ENTRYPOINT}',`,
-        "    adapter: await createPrismaAdapter({",
-        input.service.clientMember === undefined
-            ? "      client: prisma,"
-            : `      client: prisma.${input.service.clientMember},`,
-        "      discovery,",
-        `      provider: '${input.provider}',`,
-        `      driver: '${input.entry.drivers[input.provider]}',`,
-        "    }),",
-        "  } as const;",
-        "}",
-        "",
-    ].join("\n");
-}
-function prepare(input) {
-    return [
-        input.entry.bin,
-        `--schema ${input.schema}`,
-        `--client ${input.clientOutput}`,
-        `--provider ${input.provider}`,
-        `--driver ${input.entry.drivers[input.provider]}`,
-        `--out ${input.artifact}`,
-    ].join(" ");
-}
-function appModule(service, module, js) {
-    const from = "src/app.module.ts";
-    const sameFile = service.file === module.file;
-    return {
-        imports: [
-            `import { aventaraConfig } from '${specifier(from, "src/aventara.config", js)}';`,
-            ...(sameFile
-                ? [
-                    `import { ${module.exportName}, ${service.exportName} } from '${specifier(from, service.file.replace(/\.ts$/, ""), js)}';`,
-                ]
-                : [
-                    `import { ${module.exportName} } from '${specifier(from, module.file.replace(/\.ts$/, ""), js)}';`,
-                    `import { ${service.exportName} } from '${specifier(from, service.file.replace(/\.ts$/, ""), js)}';`,
-                ]),
-        ],
-        entries: [
-            `${module.exportName},`,
-            [
-                "AventaraModule.forRootAsync({",
-                `  imports: [${module.exportName}],`,
-                `  inject: [${service.exportName}],`,
-                `  useFactory: async (prisma: ${service.exportName}) => ({`,
-                "    config: await aventaraConfig(prisma),",
-                "  }),",
-                "}),",
-            ].join("\n"),
-        ],
-    };
-}
-function scaffold(input) {
-    const js = input.moduleKind === "esm" ? ".js" : "";
-    const floor = lowestVersionOf(input.entry.range);
-    const provider = PROVIDERS[input.provider];
-    const driver = input.entry.drivers[input.provider];
-    const run = input.packageManager === "pnpm" ? "pnpm exec" : "npx";
-    const artifact = "src/generated/aventara/discovery.artifact.ts";
-    return {
-        files: [
-            { path: SCHEMA, content: schema(input) },
-            { path: "prisma.config.ts", content: prismaConfig() },
-            {
-                path: NEW_SERVICE.file,
-                content: prismaService({ ...input, clientOutput: CLIENT_OUTPUT, js }),
-            },
-            {
-                path: "src/aventara.config.ts",
-                content: aventaraConfig({
-                    ...input,
-                    service: NEW_SERVICE,
-                    artifact,
-                    js,
-                }),
-            },
-        ],
-        env: { DATABASE_URL: provider.databaseUrl },
-        gitignore: ["/src/generated/", ...provider.gitignore],
-        dependencies: { [input.entry.orm.package]: floor, [driver]: floor },
-        devDependencies: { prisma: floor },
-        prepare: prepare({
-            ...input,
-            schema: SCHEMA,
-            clientOutput: CLIENT_OUTPUT,
-            artifact,
-        }),
-        appModule: appModule(NEW_SERVICE, NEW_MODULE, js),
-        nativeBuilds: provider.nativeBuilds,
-        nextSteps: [
-            ...(input.provider === "postgresql"
-                ? ["Set DATABASE_URL in .env to your PostgreSQL database."]
-                : []),
-            `Create the database tables: ${run} prisma db push`,
-        ],
-    };
-}
-function reuse(input) {
-    const js = input.moduleKind === "esm" ? ".js" : "";
-    const { facts } = input;
-    return {
-        files: [
-            ...(input.writeService
-                ? [
-                    {
-                        path: NEW_SERVICE.file,
-                        content: prismaService({
-                            entry: input.entry,
-                            provider: facts.provider,
-                            clientOutput: facts.clientOutput,
-                            js,
-                        }),
-                    },
-                ]
-                : []),
-            {
-                path: "src/aventara.config.ts",
-                content: aventaraConfig({
-                    entry: input.entry,
-                    provider: facts.provider,
-                    service: input.service,
-                    artifact: input.artifact,
-                    js,
-                }),
-            },
-        ],
-        env: {},
-        gitignore: [`/${path.posix.dirname(input.artifact)}/`],
-        dependencies: {},
-        devDependencies: {},
-        prepare: prepare({
-            entry: input.entry,
-            schema: facts.schema,
-            clientOutput: facts.clientOutput,
-            provider: facts.provider,
-            artifact: input.artifact,
-        }),
-        appModule: appModule(input.service, input.module, js),
-        nativeBuilds: [],
-        nextSteps: [],
-    };
-}
-function schemaLocation(directory, manifest) {
-    for (const config of CONFIG_FILES) {
-        const file = path.join(directory, config);
-        if (existsSync(file)) {
-            const declared = /\bschema\s*:\s*['"]([^'"]+)['"]/.exec(readFileSync(file, "utf8"))?.[1];
-            if (declared !== undefined) {
-                return path.posix.normalize(declared);
-            }
-        }
-    }
-    const prisma = manifest.prisma;
-    return typeof prisma?.schema === "string"
-        ? path.posix.normalize(prisma.schema)
-        : SCHEMA;
-}
-function schemaFiles(directory, schemaPath) {
-    const full = path.join(directory, schemaPath);
-    if (!existsSync(full)) {
-        return [];
-    }
-    if (!statSync(full).isDirectory()) {
-        return [schemaPath];
-    }
-    return readdirSync(full, { recursive: true, withFileTypes: true })
-        .filter((entry) => entry.isFile() && entry.name.endsWith(".prisma"))
-        .map((entry) => path
-        .relative(directory, path.join(entry.parentPath, entry.name))
-        .split(path.sep)
-        .join("/"))
-        .sort();
-}
-function blocks(text, kind) {
-    return [
-        ...text.matchAll(new RegExp(`^\\s*${kind}\\s+\\w+\\s*\\{([^}]*)\\}`, "gm")),
-    ].map((match) => match[1]);
-}
-function setting(block, name) {
-    return new RegExp(`^\\s*${name}\\s*=\\s*"([^"]*)"`, "m").exec(block)?.[1];
-}
-function readProject(directory, manifest) {
-    const schemaPath = schemaLocation(directory, manifest);
-    let provider;
-    let generator;
-    let clientOutput;
-    for (const file of schemaFiles(directory, schemaPath)) {
-        const text = readFileSync(path.join(directory, file), "utf8").replace(/\/\/.*$/gm, "");
-        provider ??= blocks(text, "datasource")
-            .map((block) => setting(block, "provider"))
-            .find((value) => value !== undefined);
-        for (const block of blocks(text, "generator")) {
-            const declared = setting(block, "provider");
-            const output = setting(block, "output");
-            if (generator === undefined || /^prisma-client/.test(declared ?? "")) {
-                generator = declared;
-                clientOutput =
-                    output === undefined
-                        ? undefined
-                        : path.posix.normalize(path.posix.join(path.posix.dirname(file), output));
-            }
-        }
-    }
-    const dependencies = [
-        ...Object.keys(manifest.dependencies ?? {}),
-        ...Object.keys(manifest.devDependencies ?? {}),
-    ];
-    return {
-        schema: schemaPath,
-        provider,
-        generator,
-        clientOutput,
-        drivers: dependencies.filter((name) => name.startsWith(DRIVER_PREFIX)),
-    };
-}
-function clientShape(facts) {
-    return {
-        clientClass: "PrismaClient",
-        importsClient: (imported, file) => {
-            if (!imported.startsWith(".")) {
-                return imported === "@prisma/client";
-            }
-            if (facts.clientOutput === undefined) {
-                return false;
-            }
-            const resolved = path.posix
-                .join(path.posix.dirname(file), imported)
-                .replace(/\.(js|ts)$/, "");
-            return (resolved === facts.clientOutput ||
-                resolved === `${facts.clientOutput}/client` ||
-                resolved === `${facts.clientOutput}/index`);
-        },
-        skip: facts.clientOutput === undefined
-            ? ["src/generated"]
-            : ["src/generated", facts.clientOutput],
-    };
-}
+import { PRISMA7_NEST_TEMPLATES } from "./prisma7-nest.templates.js";
+import { PRISMA7_NEXT_TEMPLATES } from "./prisma7-next.templates.js";
+import { clientShape, PROVIDERS, readProject, } from "./prisma7-orm.templates.js";
 export const PRISMA7_TEMPLATES = {
     providers: PROVIDERS,
-    scaffold,
     readProject,
     clientShape,
-    newService: { service: NEW_SERVICE, module: NEW_MODULE },
-    reuse,
+    hosts: {
+        nest: PRISMA7_NEST_TEMPLATES,
+        next: PRISMA7_NEXT_TEMPLATES,
+    },
 };

package/dist/templates/template.registry.js

@@ -1,6 +1,6 @@
 import { PRISMA7_TEMPLATES } from "./prisma7/prisma7.templates.js";
-export const SCAFFOLD_ENTRYPOINT = "/api";
-export const TEMPLATE_REGISTRY = {
+export const SCAFFOLD_API = "/api";
+const TEMPLATE_REGISTRY = {
     prisma7: PRISMA7_TEMPLATES,
 };
 export function templatesFor(entry) {

package/dist/wizard/answer.resolver.js

@@ -1,6 +1,6 @@
-import { WizardAnswerError } from "./wizard.questions.js";
-export class UnansweredQuestionsError extends Error {
-    name = "UnansweredQuestionsError";
+import { AvWizardAnswerError } from "./wizard.questions.js";
+export class AvUnansweredQuestionsError extends Error {
+    name = "AvUnansweredQuestionsError";
 }
 function flagSpelling(question, context) {
     if (!question.flag.startsWith("--")) {
@@ -41,7 +41,7 @@ async function prompt(question, context, prompter) {
             return question.parse(raw, context);
         }
         catch (error) {
-            if (!(error instanceof WizardAnswerError)) {
+            if (!(error instanceof AvWizardAnswerError)) {
                 throw error;
             }
             prompter.say(`${error.message}.`);
@@ -90,7 +90,7 @@ export async function resolveAnswers(questions, sources) {
         });
     }
     if (missing.length > 0) {
-        throw new UnansweredQuestionsError(unansweredSentence(missing, sources.yes));
+        throw new AvUnansweredQuestionsError(unansweredSentence(missing, sources.yes));
     }
     return answered;
 }

package/dist/wizard/readline.prompter.js

@@ -1,13 +1,13 @@
 import { createInterface } from "node:readline";
-export class WizardCancelledError extends Error {
-    name = "WizardCancelledError";
+export class AvWizardCancelledError extends Error {
+    name = "AvWizardCancelledError";
 }
 export function createReadlinePrompter(streams) {
     let session;
     let ended = false;
     const lines = [];
     const waiting = [];
-    const cancelled = () => new WizardCancelledError("the wizard was closed before it was answered");
+    const cancelled = () => new AvWizardCancelledError("the wizard was closed before it was answered");
     const open = () => {
         if (session === undefined) {
             session = createInterface({

package/dist/wizard/wizard.questions.js

@@ -1,7 +1,7 @@
 import { modulesProviding, } from "../project/service.detector.js";
 export const PACKAGE_MANAGERS = ["npm", "pnpm"];
-export class WizardAnswerError extends Error {
-    name = "WizardAnswerError";
+export class AvWizardAnswerError extends Error {
+    name = "AvWizardAnswerError";
 }
 function ormLabel(entry) {
     return `${entry.orm.label} ${entry.orm.major}`;
@@ -32,7 +32,7 @@ export const NAME_QUESTION = {
     parse: (raw) => {
         const name = raw.trim();
         if (!NAME.test(name)) {
-            throw new WizardAnswerError(`${JSON.stringify(raw)} is not a project name: use letters, digits, ".", "_" and "-", starting with a letter or digit`);
+            throw new AvWizardAnswerError(`${JSON.stringify(raw)} is not a project name: use letters, digits, ".", "_" and "-", starting with a letter or digit`);
         }
         return name;
     },
@@ -52,7 +52,7 @@ export const ORM_QUESTION = {
         const alias = raw.trim().toLowerCase();
         const entry = context.catalog.find((candidate) => candidate.alias === alias);
         if (entry === undefined) {
-            throw new WizardAnswerError(`there is no Aventara adapter for the ORM ${JSON.stringify(raw)}; ${ormAliasesSentence(context.catalog)}`);
+            throw new AvWizardAnswerError(`there is no Aventara adapter for the ORM ${JSON.stringify(raw)}; ${ormAliasesSentence(context.catalog)}`);
         }
         return entry;
     },
@@ -82,7 +82,7 @@ export const DB_QUESTION = {
         const orm = requireOrm(context);
         const db = raw.trim().toLowerCase();
         if (!orm.providers.includes(db)) {
-            throw new WizardAnswerError(`the ${ormLabel(orm)} adapter does not support the database ${JSON.stringify(raw)}; choose ${orm.providers.join(" or ")}`);
+            throw new AvWizardAnswerError(`the ${ormLabel(orm)} adapter does not support the database ${JSON.stringify(raw)}; choose ${orm.providers.join(" or ")}`);
         }
         return db;
     },
@@ -98,7 +98,7 @@ export const PACKAGE_MANAGER_QUESTION = {
     parse: (raw) => {
         const manager = PACKAGE_MANAGERS.find((candidate) => candidate === raw.trim().toLowerCase());
         if (manager === undefined) {
-            throw new WizardAnswerError(`${JSON.stringify(raw)} is not a supported package manager; choose ${PACKAGE_MANAGERS.join(" or ")}`);
+            throw new AvWizardAnswerError(`${JSON.stringify(raw)} is not a supported package manager; choose ${PACKAGE_MANAGERS.join(" or ")}`);
         }
         return manager;
     },
@@ -109,7 +109,7 @@ function reference(raw, flag) {
     const exportName = raw.slice(hash + 1).trim();
     const file = raw.slice(0, hash).trim().replace(/^\.\//, "");
     if (hash <= 0 || !/^[A-Za-z_$][\w$]*$/.test(exportName)) {
-        throw new WizardAnswerError(`${flag} takes <path#Export>, a file and the name it exports, such as src/prisma.service.ts#PrismaService; got ${JSON.stringify(raw)}`);
+        throw new AvWizardAnswerError(`${flag} takes <path#Export>, a file and the name it exports, such as src/prisma.service.ts#PrismaService; got ${JSON.stringify(raw)}`);
     }
     return { file, exportName };
 }
@@ -136,7 +136,7 @@ function serviceOptions(services) {
         ? found
         : [{ ...services.newService, isNew: true }];
 }
-export const SERVICE_QUESTION = {
+const SERVICE_QUESTION = {
     id: "service",
     flag: "--prisma-service",
     placeholder: "<path#Export>",
@@ -166,7 +166,7 @@ export const SERVICE_QUESTION = {
         const options = serviceOptions(services);
         const chosen = options.find((option) => option.file === wanted.file && option.exportName === wanted.exportName);
         if (chosen === undefined) {
-            throw new WizardAnswerError(`${spelled(wanted)} is not a service found in src/ (a class extending ${services.clientClass}, or one holding it); found: ${options
+            throw new AvWizardAnswerError(`${spelled(wanted)} is not a service found in src/ (a class extending ${services.clientClass}, or one holding it); found: ${options
                 .filter((option) => !option.isNew)
                 .map(spelled)
                 .join(", ") || "none"}`);
@@ -175,7 +175,7 @@ export const SERVICE_QUESTION = {
     },
     describe: spelled,
 };
-export const MODULE_QUESTION = {
+const MODULE_QUESTION = {
     id: "module",
     flag: "--prisma-module",
     placeholder: "<path#Export>",
@@ -202,7 +202,7 @@ export const MODULE_QUESTION = {
             : modulesProviding(services.scan, service);
         const chosen = modules.find((module) => module.file === wanted.file && module.exportName === wanted.exportName);
         if (chosen === undefined) {
-            throw new WizardAnswerError(`${spelled(wanted)} is not a module that provides and exports ${service.exportName}; found: ${modules.map(spelled).join(", ") || "none"}`);
+            throw new AvWizardAnswerError(`${spelled(wanted)} is not a module that provides and exports ${service.exportName}; found: ${modules.map(spelled).join(", ") || "none"}`);
         }
         return { file: chosen.file, exportName: chosen.exportName };
     },

package/package.json

@@ -1,11 +1,11 @@
 {
   "name": "@aventara/cli",
-  "version": "1.0.0-rc.0",
+  "version": "1.0.0-rc.10",
   "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",
   "engines": {
-    "node": "^22.18.0 || >=24.2.0"
+    "node": "^22.23.4 || >=24.22.1"
   },
   "bin": {
     "aventara": "./dist/aventara.bin.js"
@@ -23,7 +23,7 @@
     "typescript": "^5.9.2"
   },
   "scripts": {
-    "prebuild": "node scripts/adapter-catalog.generator.ts",
+    "prebuild": "node scripts/adapter-catalog.generator.ts && node ../../scripts/build/host-catalog.generator.ts --out src/catalog/host.catalog.generated.ts && node scripts/agent-skill.generator.ts",
     "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 .",