@hypersonic-js/cli 0.2.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 Joaquim Dalton-Pereira
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/dist/bin/hypersonic.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=hypersonic.d.ts.map

package/dist/bin/hypersonic.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypersonic.d.ts","sourceRoot":"","sources":["../../bin/hypersonic.ts"],"names":[],"mappings":""}

package/dist/bin/hypersonic.js

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+import { createProgram } from '../src/index.js';
+createProgram().parse();
+//# sourceMappingURL=hypersonic.js.map

package/dist/bin/hypersonic.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hypersonic.js","sourceRoot":"","sources":["../../bin/hypersonic.ts"],"names":[],"mappings":";AACA,OAAO,EAAE,aAAa,EAAE,MAAM,iBAAiB,CAAA;AAE/C,aAAa,EAAE,CAAC,KAAK,EAAE,CAAA"}

package/dist/package.json

@@ -0,0 +1,49 @@
+{
+    "name": "@hypersonic-js/cli",
+    "version": "0.2.0",
+    "description": "Hypersonic.js CLI — developer tooling for the Hypersonic framework",
+    "type": "module",
+    "bin": {
+        "hypersonic": "./dist/bin/hypersonic.js"
+    },
+    "files": [
+        "dist"
+    ],
+    "repository": {
+        "type": "git",
+        "url": "https://github.com/hypersonic-js/hypersonic-js"
+    },
+    "author": "Joaquim Dalton-Pereira",
+    "license": "MIT",
+    "homepage": "https://hypersonic-js.com",
+    "publishConfig": {
+        "access": "public"
+    },
+    "engines": {
+        "node": "^24.0.0"
+    },
+    "scripts": {
+        "build": "tsc",
+        "test": "vitest run",
+        "test:coverage": "vitest run --coverage",
+        "type-check": "tsc --noEmit",
+        "clean": "rm -rf dist coverage"
+    },
+    "dependencies": {
+        "@hypersonic-js/admin": "workspace:*",
+        "commander": "15.0.0",
+        "dotenv": "17.4.2",
+        "picocolors": "1.1.1",
+        "@prisma/get-dmmf": "7.8.0"
+    },
+    "devDependencies": {
+        "@hypersonic-js/core": "workspace:*",
+        "@prisma/adapter-pg": "7.8.0",
+        "@prisma/client": "7.8.0",
+        "@types/node": "25.9.3",
+        "@vitest/coverage-v8": "4.1.8",
+        "better-auth": "1.6.17",
+        "typescript": "6.0.3",
+        "vitest": "4.1.8"
+    }
+}

package/dist/src/commands/admin/create-admin.d.ts

@@ -0,0 +1,79 @@
+import type { Command } from 'commander';
+import { type PromptFn } from '../../utils/prompt.js';
+export interface CreateAdminOptions {
+    email: string;
+    name: string;
+    password: string;
+}
+/** Minimal shape of the auth API we need from Better Auth. */
+interface BetterAuthApi {
+    createUser(opts: {
+        body: {
+            email: string;
+            name: string;
+            password: string;
+            role: string;
+        };
+    }): Promise<{
+        user: {
+            id: string;
+            email: string;
+        };
+    }>;
+}
+interface BetterAuthInstance {
+    api: BetterAuthApi;
+}
+interface LoadedConfig {
+    config: {
+        database: {
+            provider: string;
+        };
+    };
+    env: {
+        DATABASE_URL: string;
+        BETTER_AUTH_SECRET: string;
+    };
+}
+/** Injectable dependency bag — swap out in tests to avoid real I/O. */
+export interface CreateAdminDeps {
+    betterAuth(opts: unknown): BetterAuthInstance;
+    prismaAdapter(client: unknown, opts: {
+        provider: string;
+    }): unknown;
+    adminPlugin(): unknown;
+    /** Prisma v7 requires an adapter — never constructed bare. */
+    PrismaClient: new (opts: {
+        adapter: unknown;
+    }) => {
+        $disconnect(): Promise<void>;
+    };
+    /** Reads hypersonic.config.ts and validates env — throws if either is missing. */
+    loadConfig(): Promise<LoadedConfig>;
+    /** Creates the driver adapter for the given provider and DATABASE_URL. */
+    createDatabaseAdapter(provider: string, databaseUrl: string): Promise<unknown>;
+}
+/**
+ * Core logic for creating the first admin user.
+ * Accepts an optional `deps` parameter so unit tests can inject mocks
+ * without touching the filesystem or a real database.
+ *
+ * Environment validation and config loading are handled by `loadConfig` —
+ * it will throw a descriptive error if DATABASE_URL, BETTER_AUTH_SECRET, or
+ * hypersonic.config.ts are missing.
+ */
+export declare function runCreateAdmin(opts: CreateAdminOptions, deps?: CreateAdminDeps): Promise<void>;
+/**
+ * Registers the `hypersonic admin create-admin` subcommand.
+ *
+ * Prompts interactively for email, name, and password (password is hidden).
+ * Loads the project's .env file automatically before running so
+ * DATABASE_URL and BETTER_AUTH_SECRET are available without the caller
+ * having to export them manually.
+ *
+ * Optional `promptFn` and `deps` can be injected for testing without
+ * touching stdin or a real database.
+ */
+export declare function registerCreateAdmin(adminCommand: Command, promptFn?: PromptFn, deps?: CreateAdminDeps): void;
+export {};
+//# sourceMappingURL=create-admin.d.ts.map

package/dist/src/commands/admin/create-admin.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-admin.d.ts","sourceRoot":"","sources":["../../../../src/commands/admin/create-admin.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAExC,OAAO,EAA2B,KAAK,QAAQ,EAAE,MAAM,uBAAuB,CAAA;AAK9E,MAAM,WAAW,kBAAkB;IACjC,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,QAAQ,EAAE,MAAM,CAAA;CACjB;AAED,8DAA8D;AAC9D,UAAU,aAAa;IACrB,UAAU,CAAC,IAAI,EAAE;QACf,IAAI,EAAE;YAAE,KAAK,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAC;YAAC,QAAQ,EAAE,MAAM,CAAC;YAAC,IAAI,EAAE,MAAM,CAAA;SAAE,CAAA;KACtE,GAAG,OAAO,CAAC;QAAE,IAAI,EAAE;YAAE,EAAE,EAAE,MAAM,CAAC;YAAC,KAAK,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAC,CAAA;CACrD;AAED,UAAU,kBAAkB;IAC1B,GAAG,EAAE,aAAa,CAAA;CACnB;AAED,UAAU,YAAY;IACpB,MAAM,EAAE;QAAE,QAAQ,EAAE;YAAE,QAAQ,EAAE,MAAM,CAAA;SAAE,CAAA;KAAE,CAAA;IAC1C,GAAG,EAAE;QAAE,YAAY,EAAE,MAAM,CAAC;QAAC,kBAAkB,EAAE,MAAM,CAAA;KAAE,CAAA;CAC1D;AAED,uEAAuE;AACvE,MAAM,WAAW,eAAe;IAC9B,UAAU,CAAC,IAAI,EAAE,OAAO,GAAG,kBAAkB,CAAA;IAC7C,aAAa,CAAC,MAAM,EAAE,OAAO,EAAE,IAAI,EAAE;QAAE,QAAQ,EAAE,MAAM,CAAA;KAAE,GAAG,OAAO,CAAA;IACnE,WAAW,IAAI,OAAO,CAAA;IACtB,8DAA8D;IAC9D,YAAY,EAAE,KAAK,IAAI,EAAE;QAAE,OAAO,EAAE,OAAO,CAAA;KAAE,KAAK;QAAE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC,CAAA;KAAE,CAAA;IAClF,kFAAkF;IAClF,UAAU,IAAI,OAAO,CAAC,YAAY,CAAC,CAAA;IACnC,0EAA0E;IAC1E,qBAAqB,CAAC,QAAQ,EAAE,MAAM,EAAE,WAAW,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC,CAAA;CAC/E;AAwBD;;;;;;;;GAQG;AACH,wBAAsB,cAAc,CAClC,IAAI,EAAE,kBAAkB,EACxB,IAAI,CAAC,EAAE,eAAe,GACrB,OAAO,CAAC,IAAI,CAAC,CA2Bf;AAID;;;;;;;;;;GAUG;AACH,wBAAgB,mBAAmB,CACjC,YAAY,EAAE,OAAO,EACrB,QAAQ,CAAC,EAAE,QAAQ,EACnB,IAAI,CAAC,EAAE,eAAe,GACrB,IAAI,CAqBN"}

package/dist/src/commands/admin/create-admin.js

@@ -0,0 +1,82 @@
+import { prompt as defaultPrompt } from '../../utils/prompt.js';
+import { logger } from '../../utils/logger.js';
+// ── Dependency loader ────────────────────────────────────────────────────────
+async function loadDeps() {
+    const [ba, pa, pl, pc, core] = await Promise.all([
+        import('better-auth'),
+        import('better-auth/adapters/prisma'),
+        import('better-auth/plugins'),
+        import('@prisma/client'),
+        import('@hypersonic-js/core'),
+    ]);
+    return {
+        betterAuth: ba.betterAuth,
+        prismaAdapter: pa.prismaAdapter,
+        adminPlugin: pl.admin,
+        PrismaClient: pc.PrismaClient,
+        loadConfig: () => core.loadConfig(),
+        createDatabaseAdapter: core.createDatabaseAdapter,
+    };
+}
+// ── Core logic ───────────────────────────────────────────────────────────────
+/**
+ * Core logic for creating the first admin user.
+ * Accepts an optional `deps` parameter so unit tests can inject mocks
+ * without touching the filesystem or a real database.
+ *
+ * Environment validation and config loading are handled by `loadConfig` —
+ * it will throw a descriptive error if DATABASE_URL, BETTER_AUTH_SECRET, or
+ * hypersonic.config.ts are missing.
+ */
+export async function runCreateAdmin(opts, deps) {
+    const { betterAuth, prismaAdapter, adminPlugin, PrismaClient, loadConfig, createDatabaseAdapter } = deps ?? (await loadDeps());
+    const { config, env } = await loadConfig();
+    const adapter = await createDatabaseAdapter(config.database.provider, env.DATABASE_URL);
+    const prisma = new PrismaClient({ adapter });
+    try {
+        const auth = betterAuth({
+            secret: env.BETTER_AUTH_SECRET,
+            database: prismaAdapter(prisma, { provider: config.database.provider }),
+            emailAndPassword: { enabled: true },
+            plugins: [adminPlugin()],
+        });
+        logger.info(`Creating admin user ${opts.email}…`);
+        await auth.api.createUser({
+            body: { email: opts.email, name: opts.name, password: opts.password, role: 'admin' },
+        });
+        logger.success(`Admin user created: ${opts.email}`);
+    }
+    finally {
+        await prisma.$disconnect();
+    }
+}
+// ── Command registration ──────────────────────────────────────────────────────
+/**
+ * Registers the `hypersonic admin create-admin` subcommand.
+ *
+ * Prompts interactively for email, name, and password (password is hidden).
+ * Loads the project's .env file automatically before running so
+ * DATABASE_URL and BETTER_AUTH_SECRET are available without the caller
+ * having to export them manually.
+ *
+ * Optional `promptFn` and `deps` can be injected for testing without
+ * touching stdin or a real database.
+ */
+export function registerCreateAdmin(adminCommand, promptFn, deps) {
+    const ask = promptFn ?? defaultPrompt;
+    adminCommand
+        .command('create-admin')
+        .description('Create the initial admin user. Run once after your first migration to bootstrap ' +
+        'admin access. Subsequent admins can be promoted through the dashboard.')
+        .action(async () => {
+        // Load .env from the project root so DATABASE_URL and BETTER_AUTH_SECRET
+        // are available when the CLI is run from the project directory.
+        const { config } = await import('dotenv');
+        config();
+        const email = await ask('Email: ');
+        const name = await ask('Name: ');
+        const password = await ask('Password: ', true);
+        await runCreateAdmin({ email, name, password }, deps);
+    });
+}
+//# sourceMappingURL=create-admin.js.map

package/dist/src/commands/admin/create-admin.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"create-admin.js","sourceRoot":"","sources":["../../../../src/commands/admin/create-admin.ts"],"names":[],"mappings":"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"}

package/dist/src/commands/admin/generate-meta.d.ts

@@ -0,0 +1,14 @@
+import type { Command } from 'commander';
+export interface GenerateMetaDeps {
+    getDMMF: (opts: {
+        datamodel: string;
+    }) => unknown;
+    readFile: (path: string) => string;
+    writeFile: (path: string, content: string) => void;
+}
+export declare function runGenerateMeta(opts: {
+    schema: string;
+    output: string;
+}, deps?: GenerateMetaDeps): Promise<void>;
+export declare function registerGenerateMeta(adminCmd: Command, deps?: GenerateMetaDeps): void;
+//# sourceMappingURL=generate-meta.d.ts.map

package/dist/src/commands/admin/generate-meta.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-meta.d.ts","sourceRoot":"","sources":["../../../../src/commands/admin/generate-meta.ts"],"names":[],"mappings":"AAEA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC,MAAM,WAAW,gBAAgB;IAC/B,OAAO,EAAE,CAAC,IAAI,EAAE;QAAE,SAAS,EAAE,MAAM,CAAA;KAAE,KAAK,OAAO,CAAA;IACjD,QAAQ,EAAE,CAAC,IAAI,EAAE,MAAM,KAAK,MAAM,CAAA;IAClC,SAAS,EAAE,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,KAAK,IAAI,CAAA;CACnD;AAWD,wBAAsB,eAAe,CACnC,IAAI,EAAE;IAAE,MAAM,EAAE,MAAM,CAAC;IAAC,MAAM,EAAE,MAAM,CAAA;CAAE,EACxC,IAAI,CAAC,EAAE,gBAAgB,GACtB,OAAO,CAAC,IAAI,CAAC,CAMf;AAED,wBAAgB,oBAAoB,CAAC,QAAQ,EAAE,OAAO,EAAE,IAAI,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAmBrF"}

package/dist/src/commands/admin/generate-meta.js

@@ -0,0 +1,39 @@
+import { readFileSync, writeFileSync } from 'node:fs';
+import { resolve } from 'node:path';
+import { parseDmmf } from '../../dmmf/parser.js';
+import { logger } from '../../utils/logger.js';
+async function loadDeps() {
+    const { getDMMF } = await import('@prisma/get-dmmf');
+    return {
+        getDMMF,
+        readFile: (p) => readFileSync(p, 'utf-8'),
+        writeFile: (p, c) => writeFileSync(p, c),
+    };
+}
+export async function runGenerateMeta(opts, deps) {
+    const { getDMMF, readFile, writeFile } = deps ?? (await loadDeps());
+    const schema = readFile(resolve(opts.schema));
+    const dmmf = await getDMMF({ datamodel: schema });
+    const models = parseDmmf(dmmf);
+    writeFile(resolve(opts.output), JSON.stringify(models, null, 2));
+}
+export function registerGenerateMeta(adminCmd, deps) {
+    adminCmd
+        .command('generate-meta')
+        .description('Generate prisma/admin-meta.json from your Prisma schema. ' +
+        'Commit this file to your repo — it is the static metadata the admin dashboard reads at runtime.')
+        .option('--schema <path>', 'Path to Prisma schema file', 'prisma/schema.prisma')
+        .option('--output <path>', 'Output path for the generated meta file', 'prisma/admin-meta.json')
+        .action(async (options) => {
+        try {
+            logger.info(`Reading schema from ${options.schema}…`);
+            await runGenerateMeta(options, deps);
+            logger.success(`Admin meta written to ${options.output}`);
+        }
+        catch (err) {
+            logger.error(err instanceof Error ? err.message : String(err));
+            process.exit(1);
+        }
+    });
+}
+//# sourceMappingURL=generate-meta.js.map

package/dist/src/commands/admin/generate-meta.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"generate-meta.js","sourceRoot":"","sources":["../../../../src/commands/admin/generate-meta.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,YAAY,EAAE,aAAa,EAAE,MAAM,SAAS,CAAA;AACrD,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAEnC,OAAO,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AAChD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAS9C,KAAK,UAAU,QAAQ;IACrB,MAAM,EAAE,OAAO,EAAE,GAAG,MAAM,MAAM,CAAC,kBAAkB,CAAC,CAAA;IACpD,OAAO;QACL,OAAO;QACP,QAAQ,EAAE,CAAC,CAAC,EAAE,EAAE,CAAC,YAAY,CAAC,CAAC,EAAE,OAAO,CAAC;QACzC,SAAS,EAAE,CAAC,CAAC,EAAE,CAAC,EAAE,EAAE,CAAC,aAAa,CAAC,CAAC,EAAE,CAAC,CAAC;KACzC,CAAA;AACH,CAAC;AAED,MAAM,CAAC,KAAK,UAAU,eAAe,CACnC,IAAwC,EACxC,IAAuB;IAEvB,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,SAAS,EAAE,GAAG,IAAI,IAAI,CAAC,MAAM,QAAQ,EAAE,CAAC,CAAA;IACnE,MAAM,MAAM,GAAG,QAAQ,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,CAAA;IAC7C,MAAM,IAAI,GAAG,MAAM,OAAO,CAAC,EAAE,SAAS,EAAE,MAAM,EAAE,CAAC,CAAA;IACjD,MAAM,MAAM,GAAG,SAAS,CAAC,IAAoB,CAAC,CAAA;IAC9C,SAAS,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,IAAI,CAAC,SAAS,CAAC,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC,CAAC,CAAA;AAClE,CAAC;AAED,MAAM,UAAU,oBAAoB,CAAC,QAAiB,EAAE,IAAuB;IAC7E,QAAQ;SACL,OAAO,CAAC,eAAe,CAAC;SACxB,WAAW,CACV,2DAA2D;QACzD,iGAAiG,CACpG;SACA,MAAM,CAAC,iBAAiB,EAAE,4BAA4B,EAAE,sBAAsB,CAAC;SAC/E,MAAM,CAAC,iBAAiB,EAAE,yCAAyC,EAAE,wBAAwB,CAAC;SAC9F,MAAM,CAAC,KAAK,EAAE,OAA2C,EAAE,EAAE;QAC5D,IAAI,CAAC;YACH,MAAM,CAAC,IAAI,CAAC,uBAAuB,OAAO,CAAC,MAAM,GAAG,CAAC,CAAA;YACrD,MAAM,eAAe,CAAC,OAAO,EAAE,IAAI,CAAC,CAAA;YACpC,MAAM,CAAC,OAAO,CAAC,yBAAyB,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;QAC3D,CAAC;QAAC,OAAO,GAAG,EAAE,CAAC;YACb,MAAM,CAAC,KAAK,CAAC,GAAG,YAAY,KAAK,CAAC,CAAC,CAAC,GAAG,CAAC,OAAO,CAAC,CAAC,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,CAAA;YAC9D,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAA;QACjB,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/src/commands/admin/index.d.ts

@@ -0,0 +1,6 @@
+import type { Command } from 'commander';
+/**
+ * Registers the `hypersonic admin` command group and all its subcommands.
+ */
+export declare function registerAdminCommands(program: Command): void;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/commands/admin/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../../src/commands/admin/index.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAKxC;;GAEG;AACH,wBAAgB,qBAAqB,CAAC,OAAO,EAAE,OAAO,GAAG,IAAI,CAQ5D"}

package/dist/src/commands/admin/index.js

@@ -0,0 +1,15 @@
+import { registerAdminScaffold } from './scaffold.js';
+import { registerCreateAdmin } from './create-admin.js';
+import { registerGenerateMeta } from './generate-meta.js';
+/**
+ * Registers the `hypersonic admin` command group and all its subcommands.
+ */
+export function registerAdminCommands(program) {
+    const admin = program
+        .command('admin')
+        .description('Admin dashboard commands');
+    registerAdminScaffold(admin);
+    registerCreateAdmin(admin);
+    registerGenerateMeta(admin);
+}
+//# sourceMappingURL=index.js.map

package/dist/src/commands/admin/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../../src/commands/admin/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,qBAAqB,EAAE,MAAM,eAAe,CAAA;AACrD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAA;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAA;AAEzD;;GAEG;AACH,MAAM,UAAU,qBAAqB,CAAC,OAAgB;IACpD,MAAM,KAAK,GAAG,OAAO;SAClB,OAAO,CAAC,OAAO,CAAC;SAChB,WAAW,CAAC,0BAA0B,CAAC,CAAA;IAE1C,qBAAqB,CAAC,KAAK,CAAC,CAAA;IAC5B,mBAAmB,CAAC,KAAK,CAAC,CAAA;IAC1B,oBAAoB,CAAC,KAAK,CAAC,CAAA;AAC7B,CAAC"}

package/dist/src/commands/admin/scaffold.d.ts

@@ -0,0 +1,9 @@
+import type { Command } from 'commander';
+/**
+ * Registers the `hypersonic admin scaffold` subcommand.
+ *
+ * Usage:
+ *   hypersonic admin scaffold [--target-dir <dir>] [--force]
+ */
+export declare function registerAdminScaffold(adminCommand: Command): void;
+//# sourceMappingURL=scaffold.d.ts.map

package/dist/src/commands/admin/scaffold.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.d.ts","sourceRoot":"","sources":["../../../../src/commands/admin/scaffold.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAIxC;;;;;GAKG;AACH,wBAAgB,qBAAqB,CAAC,YAAY,EAAE,OAAO,GAAG,IAAI,CAiCjE"}

package/dist/src/commands/admin/scaffold.js

@@ -0,0 +1,33 @@
+import { scaffoldAdmin } from '@hypersonic-js/admin';
+import { logger } from '../../utils/logger.js';
+/**
+ * Registers the `hypersonic admin scaffold` subcommand.
+ *
+ * Usage:
+ *   hypersonic admin scaffold [--target-dir <dir>] [--force]
+ */
+export function registerAdminScaffold(adminCommand) {
+    adminCommand
+        .command('scaffold')
+        .description('Scaffold the three generic admin page components (Dashboard, ModelIndex, ModelForm) ' +
+        'into your project. These components are schema-driven and never need to be regenerated.')
+        .option('--target-dir <dir>', 'Directory to scaffold admin pages into', 'resources/js/Pages')
+        .option('-f, --force', 'Overwrite existing files', false)
+        .action(async (opts) => {
+        logger.info(`Scaffolding admin pages into ${opts.targetDir}/Admin/…`);
+        const result = await scaffoldAdmin({
+            targetDir: opts.targetDir,
+            force: opts.force,
+        });
+        for (const file of result.written) {
+            logger.success(`Written  ${opts.targetDir}/Admin/${file}`);
+        }
+        for (const file of result.skipped) {
+            logger.warn(`Skipped  ${opts.targetDir}/Admin/${file} (already exists — use --force to overwrite)`);
+        }
+        if (result.written.length === 0 && result.skipped.length === 0) {
+            logger.warn('No files written. This is unexpected — please file a bug.');
+        }
+    });
+}
+//# sourceMappingURL=scaffold.js.map

package/dist/src/commands/admin/scaffold.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"scaffold.js","sourceRoot":"","sources":["../../../../src/commands/admin/scaffold.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,aAAa,EAAE,MAAM,sBAAsB,CAAA;AACpD,OAAO,EAAE,MAAM,EAAE,MAAM,uBAAuB,CAAA;AAE9C;;;;;GAKG;AACH,MAAM,UAAU,qBAAqB,CAAC,YAAqB;IACzD,YAAY;SACT,OAAO,CAAC,UAAU,CAAC;SACnB,WAAW,CACV,sFAAsF;QACpF,yFAAyF,CAC5F;SACA,MAAM,CACL,oBAAoB,EACpB,wCAAwC,EACxC,oBAAoB,CACrB;SACA,MAAM,CAAC,aAAa,EAAE,0BAA0B,EAAE,KAAK,CAAC;SACxD,MAAM,CAAC,KAAK,EAAE,IAA2C,EAAE,EAAE;QAC5D,MAAM,CAAC,IAAI,CAAC,gCAAgC,IAAI,CAAC,SAAS,UAAU,CAAC,CAAA;QAErE,MAAM,MAAM,GAAG,MAAM,aAAa,CAAC;YACjC,SAAS,EAAE,IAAI,CAAC,SAAS;YACzB,KAAK,EAAE,IAAI,CAAC,KAAK;SAClB,CAAC,CAAA;QAEF,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,OAAO,CAAC,YAAY,IAAI,CAAC,SAAS,UAAU,IAAI,EAAE,CAAC,CAAA;QAC5D,CAAC;QAED,KAAK,MAAM,IAAI,IAAI,MAAM,CAAC,OAAO,EAAE,CAAC;YAClC,MAAM,CAAC,IAAI,CAAC,YAAY,IAAI,CAAC,SAAS,UAAU,IAAI,8CAA8C,CAAC,CAAA;QACrG,CAAC;QAED,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YAC/D,MAAM,CAAC,IAAI,CAAC,2DAA2D,CAAC,CAAA;QAC1E,CAAC;IACH,CAAC,CAAC,CAAA;AACN,CAAC"}

package/dist/src/dmmf/constants.d.ts

@@ -0,0 +1,4 @@
+export declare const DISPLAY_FIELD_CANDIDATES: readonly ["name", "title", "email", "label", "slug"];
+export declare const AUTO_MANAGED_FIELD_NAMES: readonly ["createdAt", "updatedAt"];
+export declare const LARGE_TEXT_FIELD_NAMES: readonly ["body", "content", "description", "text", "html", "markdown"];
+//# sourceMappingURL=constants.d.ts.map

package/dist/src/dmmf/constants.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.d.ts","sourceRoot":"","sources":["../../../src/dmmf/constants.ts"],"names":[],"mappings":"AAAA,eAAO,MAAM,wBAAwB,sDAAuD,CAAA;AAC5F,eAAO,MAAM,wBAAwB,qCAAsC,CAAA;AAC3E,eAAO,MAAM,sBAAsB,yEAA0E,CAAA"}

package/dist/src/dmmf/constants.js

@@ -0,0 +1,4 @@
+export const DISPLAY_FIELD_CANDIDATES = ['name', 'title', 'email', 'label', 'slug'];
+export const AUTO_MANAGED_FIELD_NAMES = ['createdAt', 'updatedAt'];
+export const LARGE_TEXT_FIELD_NAMES = ['body', 'content', 'description', 'text', 'html', 'markdown'];
+//# sourceMappingURL=constants.js.map

package/dist/src/dmmf/constants.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"constants.js","sourceRoot":"","sources":["../../../src/dmmf/constants.ts"],"names":[],"mappings":"AAAA,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,MAAM,EAAE,OAAO,EAAE,OAAO,EAAE,OAAO,EAAE,MAAM,CAAU,CAAA;AAC5F,MAAM,CAAC,MAAM,wBAAwB,GAAG,CAAC,WAAW,EAAE,WAAW,CAAU,CAAA;AAC3E,MAAM,CAAC,MAAM,sBAAsB,GAAG,CAAC,MAAM,EAAE,SAAS,EAAE,aAAa,EAAE,MAAM,EAAE,MAAM,EAAE,UAAU,CAAU,CAAA"}

package/dist/src/dmmf/fields.d.ts

@@ -0,0 +1,49 @@
+import type { AdminFieldMeta, AdminFieldKind } from '@hypersonic-js/admin';
+import type { DmmfField, DmmfEnum } from './types.js';
+/** Maps a DMMF field kind to our simplified AdminFieldKind. */
+export declare function classifyField(field: DmmfField): AdminFieldKind;
+/**
+ * Returns true for fields that are auto-managed by Prisma or the database
+ * and should therefore be excluded from admin create/edit forms.
+ * Covers:
+ *  - field.isUpdatedAt — @updatedAt fields managed by the Prisma client
+ *  - AUTO_MANAGED_FIELD_NAMES — convention-based names (createdAt / updatedAt)
+ *                               for schemas where Prisma does not set the flags
+ *                               (e.g. Better Auth-managed timestamps)
+ *
+ * NOTE: We intentionally do NOT check field.isReadOnly here. Prisma sets
+ * isReadOnly on FK scalars as well as on auto-managed columns. FK scalars
+ * must remain editable in the admin form; auto-managed fields are caught by
+ * the isUpdatedAt flag and the name-convention list above.
+ */
+export declare function isAutoManagedField(field: DmmfField): boolean;
+/** Chooses the most human-readable field name for list view labels. */
+export declare function getDisplayField(fields: AdminFieldMeta[]): string;
+/** Returns the subset of fields suitable for table list columns. Capped at 6. */
+export declare function getListFields(fields: AdminFieldMeta[]): AdminFieldMeta[];
+/**
+ * Returns the subset of fields to show in create/edit forms.
+ *
+ * Inclusion rules:
+ *  - Relation fields are excluded (they have no direct column).
+ *  - Auto-managed read-only fields (timestamps, @updatedAt) are excluded.
+ *  - FK scalar fields are INCLUDED even though isReadOnly is true — the admin
+ *    needs to supply the FK value; the router renders them as a <select>.
+ *  - Id fields with a default (e.g. autoincrement) are excluded.
+ */
+export declare function getFormFields(fields: AdminFieldMeta[]): AdminFieldMeta[];
+/**
+ * Maps a raw DMMF field to an AdminFieldMeta, resolving enum values.
+ *
+ * @param field     The DMMF field to map.
+ * @param enums     All enum definitions from the DMMF document.
+ * @param fkToModel Map of FK scalar field name → related model name, built by
+ *                  parseDmmf from relation fields' relationFromFields.
+ *                  e.g. new Map([['userId', 'User'], ['authorId', 'Author']])
+ * @param fkToSlug  Map of FK scalar field name → related model urlSlug, built
+ *                  by parseDmmf. Always use this — never derive the slug
+ *                  client-side from the model name.
+ *                  e.g. new Map([['userId', 'user'], ['userProfileId', 'userprofile']])
+ */
+export declare function mapField(field: DmmfField, enums: DmmfEnum[], fkToModel?: ReadonlyMap<string, string>, fkToSlug?: ReadonlyMap<string, string>): AdminFieldMeta;
+//# sourceMappingURL=fields.d.ts.map

package/dist/src/dmmf/fields.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.d.ts","sourceRoot":"","sources":["../../../src/dmmf/fields.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1E,OAAO,KAAK,EAAE,SAAS,EAAE,QAAQ,EAAE,MAAM,YAAY,CAAA;AAMrD,+DAA+D;AAC/D,wBAAgB,aAAa,CAAC,KAAK,EAAE,SAAS,GAAG,cAAc,CAI9D;AAED;;;;;;;;;;;;;GAaG;AACH,wBAAgB,kBAAkB,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAG5D;AAED,uEAAuE;AACvE,wBAAgB,eAAe,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,MAAM,CAOhE;AAED,iFAAiF;AACjF,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAKxE;AAED;;;;;;;;;GASG;AACH,wBAAgB,aAAa,CAAC,MAAM,EAAE,cAAc,EAAE,GAAG,cAAc,EAAE,CAOxE;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,QAAQ,CACtB,KAAK,EAAE,SAAS,EAChB,KAAK,EAAE,QAAQ,EAAE,EACjB,SAAS,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,EAClD,QAAQ,GAAE,WAAW,CAAC,MAAM,EAAE,MAAM,CAAa,GAChD,cAAc,CAqBhB"}

package/dist/src/dmmf/fields.js

@@ -0,0 +1,103 @@
+const DISPLAY_FIELD_CANDIDATES = ['name', 'title', 'email', 'label', 'slug'];
+const AUTO_MANAGED_FIELD_NAMES = ['createdAt', 'updatedAt'];
+const LARGE_TEXT_FIELD_NAMES = ['body', 'content', 'description', 'text', 'html', 'markdown'];
+/** Maps a DMMF field kind to our simplified AdminFieldKind. */
+export function classifyField(field) {
+    if (field.kind === 'object')
+        return 'relation';
+    if (field.kind === 'enum')
+        return 'enum';
+    return 'scalar';
+}
+/**
+ * Returns true for fields that are auto-managed by Prisma or the database
+ * and should therefore be excluded from admin create/edit forms.
+ * Covers:
+ *  - field.isUpdatedAt — @updatedAt fields managed by the Prisma client
+ *  - AUTO_MANAGED_FIELD_NAMES — convention-based names (createdAt / updatedAt)
+ *                               for schemas where Prisma does not set the flags
+ *                               (e.g. Better Auth-managed timestamps)
+ *
+ * NOTE: We intentionally do NOT check field.isReadOnly here. Prisma sets
+ * isReadOnly on FK scalars as well as on auto-managed columns. FK scalars
+ * must remain editable in the admin form; auto-managed fields are caught by
+ * the isUpdatedAt flag and the name-convention list above.
+ */
+export function isAutoManagedField(field) {
+    if (field.isUpdatedAt)
+        return true;
+    return AUTO_MANAGED_FIELD_NAMES.includes(field.name);
+}
+/** Chooses the most human-readable field name for list view labels. */
+export function getDisplayField(fields) {
+    for (const candidate of DISPLAY_FIELD_CANDIDATES) {
+        const found = fields.find((f) => f.name === candidate && f.kind === 'scalar');
+        if (found !== undefined)
+            return found.name;
+    }
+    const idField = fields.find((f) => f.isId);
+    return idField?.name ?? 'id';
+}
+/** Returns the subset of fields suitable for table list columns. Capped at 6. */
+export function getListFields(fields) {
+    return fields
+        .filter((f) => f.kind === 'scalar' && !f.isList)
+        .filter((f) => !LARGE_TEXT_FIELD_NAMES.includes(f.name))
+        .slice(0, 6);
+}
+/**
+ * Returns the subset of fields to show in create/edit forms.
+ *
+ * Inclusion rules:
+ *  - Relation fields are excluded (they have no direct column).
+ *  - Auto-managed read-only fields (timestamps, @updatedAt) are excluded.
+ *  - FK scalar fields are INCLUDED even though isReadOnly is true — the admin
+ *    needs to supply the FK value; the router renders them as a <select>.
+ *  - Id fields with a default (e.g. autoincrement) are excluded.
+ */
+export function getFormFields(fields) {
+    return fields.filter((f) => {
+        if (f.kind === 'relation')
+            return false;
+        if (f.isReadOnly && !f.isForeignKey)
+            return false;
+        if (f.isId && f.hasDefault)
+            return false;
+        return true;
+    });
+}
+/**
+ * Maps a raw DMMF field to an AdminFieldMeta, resolving enum values.
+ *
+ * @param field     The DMMF field to map.
+ * @param enums     All enum definitions from the DMMF document.
+ * @param fkToModel Map of FK scalar field name → related model name, built by
+ *                  parseDmmf from relation fields' relationFromFields.
+ *                  e.g. new Map([['userId', 'User'], ['authorId', 'Author']])
+ * @param fkToSlug  Map of FK scalar field name → related model urlSlug, built
+ *                  by parseDmmf. Always use this — never derive the slug
+ *                  client-side from the model name.
+ *                  e.g. new Map([['userId', 'user'], ['userProfileId', 'userprofile']])
+ */
+export function mapField(field, enums, fkToModel = new Map(), fkToSlug = new Map()) {
+    const kind = classifyField(field);
+    const enumDef = kind === 'enum' ? enums.find((e) => e.name === field.type) : undefined;
+    const isForeignKey = field.kind === 'scalar' && fkToModel.has(field.name);
+    return {
+        name: field.name,
+        prismaType: field.type,
+        kind,
+        isRequired: field.isRequired,
+        isId: field.isId,
+        isUnique: field.isUnique,
+        hasDefault: field.hasDefaultValue,
+        isReadOnly: field.isReadOnly || isAutoManagedField(field),
+        isForeignKey,
+        relatedModelName: isForeignKey ? fkToModel.get(field.name) : undefined,
+        relatedModelSlug: isForeignKey ? fkToSlug.get(field.name) : undefined,
+        isList: field.isList,
+        relationTo: field.kind === 'object' ? field.type : undefined,
+        enumValues: enumDef?.values.map((v) => v.name),
+    };
+}
+//# sourceMappingURL=fields.js.map

package/dist/src/dmmf/fields.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"fields.js","sourceRoot":"","sources":["../../../src/dmmf/fields.ts"],"names":[],"mappings":"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"}

package/dist/src/dmmf/parser.d.ts

@@ -0,0 +1,14 @@
+import type { AdminModelMeta } from '@hypersonic-js/admin';
+import type { DmmfDocument } from './types.js';
+/**
+ * Converts a model name to a plural display name.
+ * Handles the most common English pluralisation rules.
+ */
+export declare function toDisplayName(name: string): string;
+/**
+ * Maps a full Prisma DMMF document into AdminModelMeta for all models.
+ * No filtering is applied — filtering by showAuthModels / hiddenModels
+ * happens at runtime in mountAdmin.
+ */
+export declare function parseDmmf(dmmf: DmmfDocument): AdminModelMeta[];
+//# sourceMappingURL=parser.d.ts.map

package/dist/src/dmmf/parser.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.d.ts","sourceRoot":"","sources":["../../../src/dmmf/parser.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,sBAAsB,CAAA;AAC1D,OAAO,KAAK,EAAE,YAAY,EAAE,MAAM,YAAY,CAAA;AAG9C;;;GAGG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,CAMlD;AAED;;;;GAIG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,YAAY,GAAG,cAAc,EAAE,CAyD9D"}

package/dist/src/dmmf/parser.js

@@ -0,0 +1,57 @@
+import { mapField, getDisplayField, getListFields, getFormFields } from './fields.js';
+/**
+ * Converts a model name to a plural display name.
+ * Handles the most common English pluralisation rules.
+ */
+export function toDisplayName(name) {
+    if (name.endsWith('s'))
+        return name;
+    if (name.endsWith('y') && !/[aeiou]y$/i.test(name)) {
+        return name.slice(0, -1) + 'ies';
+    }
+    return name + 's';
+}
+/**
+ * Maps a full Prisma DMMF document into AdminModelMeta for all models.
+ * No filtering is applied — filtering by showAuthModels / hiddenModels
+ * happens at runtime in mountAdmin.
+ */
+export function parseDmmf(dmmf) {
+    // Pre-build model name → urlSlug for all models so FK fields can carry the
+    // correct slug without any client-side derivation. A model named
+    // "UserProfile" gets slug "userprofile", not "userProfile".
+    const modelToSlug = new Map(dmmf.datamodel.models.map((m) => [m.name, m.name.toLowerCase()]));
+    return dmmf.datamodel.models.map((model) => {
+        // Build a map of FK scalar name → related model name.
+        // Each relation (object) field lists its FK scalars in relationFromFields
+        // and its type is the related model name.
+        // e.g. `user User @relation(fields: [userId], …)` → { 'userId' → 'User' }
+        const fkToModel = new Map(model.fields
+            .filter((f) => f.kind === 'object')
+            .flatMap((f) => (f.relationFromFields ?? []).map((scalar) => [scalar, f.type])));
+        // Build a map of FK scalar name → related model urlSlug.
+        // Used by ModelForm to construct the correct /related-options/:slug URL
+        // for load-more pagination instead of deriving it client-side.
+        const fkToSlug = new Map(model.fields
+            .filter((f) => f.kind === 'object')
+            .flatMap((f) => (f.relationFromFields ?? []).map((scalar) => [scalar, modelToSlug.get(f.type) ?? f.type.toLowerCase()])));
+        const fields = model.fields.map((f) => mapField(f, dmmf.datamodel.enums, fkToModel, fkToSlug));
+        const idField = fields.find((f) => f.isId) ?? fields[0];
+        if (idField === undefined) {
+            throw new Error(`Admin: model "${model.name}" has no fields — cannot build admin meta.`);
+        }
+        const idType = idField.prismaType === 'Int' || idField.prismaType === 'Float' ? 'number' : 'string';
+        return {
+            name: model.name,
+            urlSlug: model.name.toLowerCase(),
+            displayName: toDisplayName(model.name),
+            idField: idField.name,
+            idType,
+            displayField: getDisplayField(fields),
+            fields,
+            listFields: getListFields(fields),
+            formFields: getFormFields(fields),
+        };
+    });
+}
+//# sourceMappingURL=parser.js.map

package/dist/src/dmmf/parser.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"parser.js","sourceRoot":"","sources":["../../../src/dmmf/parser.ts"],"names":[],"mappings":"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"}

package/dist/src/dmmf/types.d.ts

@@ -0,0 +1,37 @@
+export interface DmmfEnumValue {
+    name: string;
+    dbName: string | null;
+}
+export interface DmmfEnum {
+    name: string;
+    values: DmmfEnumValue[];
+    dbName: string | null;
+}
+export interface DmmfField {
+    name: string;
+    type: string;
+    kind: 'scalar' | 'object' | 'enum' | 'unsupported';
+    isRequired: boolean;
+    isUnique: boolean;
+    isId: boolean;
+    isList: boolean;
+    hasDefaultValue: boolean;
+    isReadOnly: boolean;
+    isGenerated?: boolean;
+    isUpdatedAt: boolean;
+    relationName?: string | null;
+    relationFromFields?: string[];
+    relationToFields?: string[];
+}
+export interface DmmfModel {
+    name: string;
+    fields: DmmfField[];
+    dbName: string | null;
+}
+export interface DmmfDocument {
+    datamodel: {
+        models: DmmfModel[];
+        enums: DmmfEnum[];
+    };
+}
+//# sourceMappingURL=types.d.ts.map

package/dist/src/dmmf/types.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../../src/dmmf/types.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,QAAQ;IACvB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,aAAa,EAAE,CAAA;IACvB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,MAAM,CAAA;IACZ,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,MAAM,GAAG,aAAa,CAAA;IAClD,UAAU,EAAE,OAAO,CAAA;IACnB,QAAQ,EAAE,OAAO,CAAA;IACjB,IAAI,EAAE,OAAO,CAAA;IACb,MAAM,EAAE,OAAO,CAAA;IACf,eAAe,EAAE,OAAO,CAAA;IACxB,UAAU,EAAE,OAAO,CAAA;IACnB,WAAW,CAAC,EAAE,OAAO,CAAA;IACrB,WAAW,EAAE,OAAO,CAAA;IACpB,YAAY,CAAC,EAAE,MAAM,GAAG,IAAI,CAAA;IAC5B,kBAAkB,CAAC,EAAE,MAAM,EAAE,CAAA;IAC7B,gBAAgB,CAAC,EAAE,MAAM,EAAE,CAAA;CAC5B;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IACZ,MAAM,EAAE,SAAS,EAAE,CAAA;IACnB,MAAM,EAAE,MAAM,GAAG,IAAI,CAAA;CACtB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE;QACT,MAAM,EAAE,SAAS,EAAE,CAAA;QACnB,KAAK,EAAE,QAAQ,EAAE,CAAA;KAClB,CAAA;CACF"}

package/dist/src/dmmf/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/src/dmmf/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../../../src/dmmf/types.ts"],"names":[],"mappings":""}

package/dist/src/index.d.ts

@@ -0,0 +1,9 @@
+import { Command } from 'commander';
+export declare const CLI_VERSION: string;
+/**
+ * Builds and returns the configured Commander program.
+ * Exported separately from parse() so the program is testable
+ * without actually invoking process.argv.
+ */
+export declare function createProgram(): Command;
+//# sourceMappingURL=index.d.ts.map

package/dist/src/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AAInC,eAAO,MAAM,WAAW,EAAE,MAAoB,CAAA;AAE9C;;;;GAIG;AACH,wBAAgB,aAAa,IAAI,OAAO,CASvC"}

package/dist/src/index.js

@@ -0,0 +1,18 @@
+import { Command } from 'commander';
+import { registerAdminCommands } from './commands/admin/index.js';
+import pkg from '../package.json' with { type: 'json' };
+export const CLI_VERSION = pkg.version;
+/**
+ * Builds and returns the configured Commander program.
+ * Exported separately from parse() so the program is testable
+ * without actually invoking process.argv.
+ */
+export function createProgram() {
+    const program = new Command()
+        .name('hypersonic')
+        .description('Hypersonic.js framework CLI')
+        .version(CLI_VERSION, '-v, --version', 'Print the CLI version');
+    registerAdminCommands(program);
+    return program;
+}
+//# sourceMappingURL=index.js.map

package/dist/src/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,EAAE,MAAM,WAAW,CAAA;AACnC,OAAO,EAAE,qBAAqB,EAAE,MAAM,2BAA2B,CAAA;AACjE,OAAO,GAAG,MAAM,iBAAiB,CAAC,OAAO,IAAI,EAAE,MAAM,EAAE,CAAA;AAEvD,MAAM,CAAC,MAAM,WAAW,GAAW,GAAG,CAAC,OAAO,CAAA;AAE9C;;;;GAIG;AACH,MAAM,UAAU,aAAa;IAC3B,MAAM,OAAO,GAAG,IAAI,OAAO,EAAE;SAC1B,IAAI,CAAC,YAAY,CAAC;SAClB,WAAW,CAAC,6BAA6B,CAAC;SAC1C,OAAO,CAAC,WAAW,EAAE,eAAe,EAAE,uBAAuB,CAAC,CAAA;IAEjE,qBAAqB,CAAC,OAAO,CAAC,CAAA;IAE9B,OAAO,OAAO,CAAA;AAChB,CAAC"}

package/dist/src/utils/logger.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Minimal coloured console logger for CLI output.
+ * Writes info/success/warn to stdout, error to stderr.
+ */
+export declare const logger: {
+    info: (msg: string) => void;
+    success: (msg: string) => void;
+    warn: (msg: string) => void;
+    error: (msg: string) => void;
+};
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/utils/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,eAAO,MAAM,MAAM;gBACL,MAAM,KAAG,IAAI;mBAGV,MAAM,KAAG,IAAI;gBAGhB,MAAM,KAAG,IAAI;iBAGZ,MAAM,KAAG,IAAI;CAG3B,CAAA"}

package/dist/src/utils/logger.js

@@ -0,0 +1,20 @@
+import pc from 'picocolors';
+/**
+ * Minimal coloured console logger for CLI output.
+ * Writes info/success/warn to stdout, error to stderr.
+ */
+export const logger = {
+    info: (msg) => {
+        process.stdout.write(pc.blue('  info ') + msg + '\n');
+    },
+    success: (msg) => {
+        process.stdout.write(pc.green('  ✓ ') + msg + '\n');
+    },
+    warn: (msg) => {
+        process.stdout.write(pc.yellow('  warn ') + msg + '\n');
+    },
+    error: (msg) => {
+        process.stderr.write(pc.red('  ✗ ') + msg + '\n');
+    },
+};
+//# sourceMappingURL=logger.js.map

package/dist/src/utils/logger.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/utils/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,YAAY,CAAA;AAE3B;;;GAGG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG;IACpB,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,IAAI,CAAC,SAAS,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAA;IACvD,CAAC;IACD,OAAO,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC7B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAA;IACrD,CAAC;IACD,IAAI,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC1B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,CAAC,SAAS,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAA;IACzD,CAAC;IACD,KAAK,EAAE,CAAC,GAAW,EAAQ,EAAE;QAC3B,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,EAAE,CAAC,GAAG,CAAC,MAAM,CAAC,GAAG,GAAG,GAAG,IAAI,CAAC,CAAA;IACnD,CAAC;CACF,CAAA"}

package/dist/src/utils/prompt.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Function signature for asking the user a single question.
+ * `hidden` suppresses echo, suitable for passwords.
+ */
+export type PromptFn = (question: string, hidden?: boolean) => Promise<string>;
+/**
+ * Asks the user a question via stdin/stdout.
+ *
+ * When `hidden` is true the typed characters are not echoed — use this for
+ * passwords. Requires stdin to be a TTY; if it isn't (e.g. in a pipe) the
+ * input is still read but cannot be hidden.
+ */
+export declare function prompt(question: string, hidden?: boolean): Promise<string>;
+//# sourceMappingURL=prompt.d.ts.map

package/dist/src/utils/prompt.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.d.ts","sourceRoot":"","sources":["../../../src/utils/prompt.ts"],"names":[],"mappings":"AAEA;;;GAGG;AACH,MAAM,MAAM,QAAQ,GAAG,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,KAAK,OAAO,CAAC,MAAM,CAAC,CAAA;AAE9E;;;;;;GAMG;AACH,wBAAsB,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,MAAM,UAAQ,GAAG,OAAO,CAAC,MAAM,CAAC,CAa9E"}

package/dist/src/utils/prompt.js

@@ -0,0 +1,47 @@
+import { createInterface } from 'readline';
+/**
+ * Asks the user a question via stdin/stdout.
+ *
+ * When `hidden` is true the typed characters are not echoed — use this for
+ * passwords. Requires stdin to be a TTY; if it isn't (e.g. in a pipe) the
+ * input is still read but cannot be hidden.
+ */
+export async function prompt(question, hidden = false) {
+    if (hidden && process.stdin.isTTY) {
+        return promptHidden(question);
+    }
+    const rl = createInterface({ input: process.stdin, output: process.stdout });
+    return new Promise((resolve) => {
+        rl.question(question, (answer) => {
+            rl.close();
+            resolve(answer);
+        });
+    });
+}
+function promptHidden(question) {
+    return new Promise((resolve) => {
+        process.stdout.write(question);
+        let value = '';
+        const onData = (chunk) => {
+            const char = chunk.toString('utf8');
+            if (char === '\r' || char === '\n' || char === '\u0003' /* Ctrl-C */) {
+                process.stdin.setRawMode(false);
+                process.stdin.pause();
+                process.stdin.removeListener('data', onData);
+                process.stdout.write('\n');
+                resolve(value);
+            }
+            else if (char === '\u007F' /* backspace */) {
+                value = value.slice(0, -1);
+            }
+            else {
+                value += char;
+            }
+        };
+        process.stdin.setRawMode(true);
+        process.stdin.resume();
+        process.stdin.setEncoding('utf8');
+        process.stdin.on('data', onData);
+    });
+}
+//# sourceMappingURL=prompt.js.map

package/dist/src/utils/prompt.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"prompt.js","sourceRoot":"","sources":["../../../src/utils/prompt.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAA;AAQ1C;;;;;;GAMG;AACH,MAAM,CAAC,KAAK,UAAU,MAAM,CAAC,QAAgB,EAAE,MAAM,GAAG,KAAK;IAC3D,IAAI,MAAM,IAAI,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAC;QAClC,OAAO,YAAY,CAAC,QAAQ,CAAC,CAAA;IAC/B,CAAC;IAED,MAAM,EAAE,GAAG,eAAe,CAAC,EAAE,KAAK,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,OAAO,CAAC,MAAM,EAAE,CAAC,CAAA;IAE5E,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,EAAE,CAAC,QAAQ,CAAC,QAAQ,EAAE,CAAC,MAAM,EAAE,EAAE;YAC/B,EAAE,CAAC,KAAK,EAAE,CAAA;YACV,OAAO,CAAC,MAAM,CAAC,CAAA;QACjB,CAAC,CAAC,CAAA;IACJ,CAAC,CAAC,CAAA;AACJ,CAAC;AAED,SAAS,YAAY,CAAC,QAAgB;IACpC,OAAO,IAAI,OAAO,CAAS,CAAC,OAAO,EAAE,EAAE;QACrC,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,QAAQ,CAAC,CAAA;QAE9B,IAAI,KAAK,GAAG,EAAE,CAAA;QAEd,MAAM,MAAM,GAAG,CAAC,KAAa,EAAQ,EAAE;YACrC,MAAM,IAAI,GAAG,KAAK,CAAC,QAAQ,CAAC,MAAM,CAAC,CAAA;YAEnC,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,IAAI,IAAI,IAAI,KAAK,QAAQ,CAAC,YAAY,EAAE,CAAC;gBACrE,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,KAAK,CAAC,CAAA;gBAC/B,OAAO,CAAC,KAAK,CAAC,KAAK,EAAE,CAAA;gBACrB,OAAO,CAAC,KAAK,CAAC,cAAc,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;gBAC5C,OAAO,CAAC,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAAA;gBAC1B,OAAO,CAAC,KAAK,CAAC,CAAA;YAChB,CAAC;iBAAM,IAAI,IAAI,KAAK,QAAQ,CAAC,eAAe,EAAE,CAAC;gBAC7C,KAAK,GAAG,KAAK,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAA;YAC5B,CAAC;iBAAM,CAAC;gBACN,KAAK,IAAI,IAAI,CAAA;YACf,CAAC;QACH,CAAC,CAAA;QAED,OAAO,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAA;QAC9B,OAAO,CAAC,KAAK,CAAC,MAAM,EAAE,CAAA;QACtB,OAAO,CAAC,KAAK,CAAC,WAAW,CAAC,MAAM,CAAC,CAAA;QACjC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAClC,CAAC,CAAC,CAAA;AACJ,CAAC"}

package/package.json

@@ -0,0 +1,49 @@
+{
+  "name": "@hypersonic-js/cli",
+  "version": "0.2.0",
+  "description": "Hypersonic.js CLI — developer tooling for the Hypersonic framework",
+  "type": "module",
+  "bin": {
+    "hypersonic": "./dist/bin/hypersonic.js"
+  },
+  "files": [
+    "dist"
+  ],
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/hypersonic-js/hypersonic-js"
+  },
+  "author": "Joaquim Dalton-Pereira",
+  "license": "MIT",
+  "homepage": "https://hypersonic-js.com",
+  "publishConfig": {
+    "access": "public"
+  },
+  "engines": {
+    "node": "^24.0.0"
+  },
+  "dependencies": {
+    "commander": "15.0.0",
+    "dotenv": "17.4.2",
+    "picocolors": "1.1.1",
+    "@prisma/get-dmmf": "7.8.0",
+    "@hypersonic-js/admin": "0.2.0"
+  },
+  "devDependencies": {
+    "@prisma/adapter-pg": "7.8.0",
+    "@prisma/client": "7.8.0",
+    "@types/node": "25.9.3",
+    "@vitest/coverage-v8": "4.1.8",
+    "better-auth": "1.6.17",
+    "typescript": "6.0.3",
+    "vitest": "4.1.8",
+    "@hypersonic-js/core": "0.2.0"
+  },
+  "scripts": {
+    "build": "tsc",
+    "test": "vitest run",
+    "test:coverage": "vitest run --coverage",
+    "type-check": "tsc --noEmit",
+    "clean": "rm -rf dist coverage"
+  }
+}