@paneljs/paneljs 0.1.0 → 0.2.1

package/dist/builtInAuth.js

@@ -0,0 +1,117 @@
+import { createHash, randomBytes } from "node:crypto";
+import { verifyLoginPassword } from "./passwords.js";
+export const SESSION_COOKIE_NAME = "paneljs_session";
+export const DEFAULT_SESSION_TTL_SECONDS = 60 * 60 * 24 * 7;
+export function hashSessionToken(token) {
+    return createHash("sha256").update(token).digest("hex");
+}
+export function readSessionToken(req) {
+    const header = req.headers.cookie;
+    if (typeof header !== "string")
+        return null;
+    for (const part of header.split(";")) {
+        const [key, ...value] = part.trim().split("=");
+        if (key === SESSION_COOKIE_NAME) {
+            try {
+                return decodeURIComponent(value.join("="));
+            }
+            catch {
+                return null;
+            }
+        }
+    }
+    return null;
+}
+function cookieSecure(config) {
+    return config.secureCookies ?? process.env.NODE_ENV === "production";
+}
+export function sessionCookie(token, config, basePath, expires) {
+    return {
+        name: SESSION_COOKIE_NAME,
+        value: token,
+        path: basePath,
+        httpOnly: true,
+        sameSite: "Lax",
+        maxAge: Math.max(0, Math.floor((expires.getTime() - Date.now()) / 1000)),
+        expires,
+        secure: cookieSecure(config),
+    };
+}
+export function clearedSessionCookie(config, basePath) {
+    return {
+        name: SESSION_COOKIE_NAME,
+        value: "",
+        path: basePath,
+        httpOnly: true,
+        sameSite: "Lax",
+        maxAge: 0,
+        expires: new Date(0),
+        secure: cookieSecure(config),
+    };
+}
+export function builtInUserToAdminUser(user) {
+    if (!user.isActive || !["ADMIN", "SUPER_ADMIN"].includes(user.role))
+        return null;
+    return {
+        id: user.id,
+        email: user.email ?? user.username ?? user.id,
+        ...(user.username ? { username: user.username } : {}),
+        ...(user.tenantId ? { tenantId: user.tenantId } : {}),
+        role: user.role,
+        isSuperAdmin: user.role === "SUPER_ADMIN",
+    };
+}
+export function resolveAuthStore(adapter, auth) {
+    if (auth.store)
+        return auth.store;
+    if (adapter.createAuthStore)
+        return adapter.createAuthStore(auth);
+    throw new Error("[paneljs] Built-in auth requires auth.store or an adapter that implements createAuthStore().");
+}
+export async function authenticateSession(store, token) {
+    if (!token)
+        return null;
+    const session = await store.findSessionWithUser(hashSessionToken(token));
+    if (!session)
+        return null;
+    if (session.expiresAt.getTime() <= Date.now())
+        return null;
+    return builtInUserToAdminUser(session.user);
+}
+export async function authenticateBuiltInRequest(req, store) {
+    return authenticateSession(store, readSessionToken(req));
+}
+const invalidCredentials = {
+    ok: false,
+    status: 401,
+    body: { error: "Invalid credentials.", code: "INVALID_CREDENTIALS" },
+};
+export async function loginWithPassword(store, config, credentials, basePath) {
+    const identifier = credentials.identifier.trim();
+    const password = credentials.password;
+    if (!identifier || !password || identifier.length > 254 || password.length > 1_024) {
+        return invalidCredentials;
+    }
+    const user = await store.findUserByIdentifier(identifier);
+    const passwordMatches = await verifyLoginPassword(password, user?.passwordHash);
+    const adminUser = user && passwordMatches ? builtInUserToAdminUser(user) : null;
+    if (!user || !adminUser)
+        return invalidCredentials;
+    const token = randomBytes(32).toString("base64url");
+    const ttlSeconds = config.sessionTtlSeconds ?? DEFAULT_SESSION_TTL_SECONDS;
+    const expiresAt = new Date(Date.now() + ttlSeconds * 1_000);
+    await store.createSession({ tokenHash: hashSessionToken(token), userId: user.id, expiresAt });
+    return {
+        ok: true,
+        status: 200,
+        body: { ok: true },
+        cookie: sessionCookie(token, config, basePath, expiresAt),
+    };
+}
+export async function logoutBuiltIn(store, req, config, basePath) {
+    const token = readSessionToken(req);
+    if (token)
+        await store.deleteSessionByTokenHash(hashSessionToken(token));
+    return { status: 204, cookie: clearedSessionCookie(config, basePath) };
+}
+//# sourceMappingURL=builtInAuth.js.map

package/dist/builtInAuth.js.map

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

package/dist/cli/args.d.ts

@@ -0,0 +1,2 @@
+export declare function argument(argv: string[], name: string): string | undefined;
+export declare function hasFlag(argv: string[], name: string): boolean;

package/dist/cli/args.js

@@ -0,0 +1,16 @@
+export function argument(argv, name) {
+    const equals = argv.find((item) => item.startsWith(`${name}=`));
+    if (equals)
+        return equals.slice(name.length + 1) || undefined;
+    const index = argv.indexOf(name);
+    if (index < 0)
+        return undefined;
+    const value = argv[index + 1];
+    if (!value || value.startsWith("-"))
+        return undefined;
+    return value;
+}
+export function hasFlag(argv, name) {
+    return argv.includes(name);
+}
+//# sourceMappingURL=args.js.map

package/dist/cli/args.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"args.js","sourceRoot":"","sources":["../../src/cli/args.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,QAAQ,CACtB,IAAc,EACd,IAAY;IAEZ,MAAM,MAAM,GAAG,IAAI,CAAC,IAAI,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAI,CAAC,UAAU,CAAC,GAAG,IAAI,GAAG,CAAC,CAAC,CAAC;IAChE,IAAI,MAAM;QAAE,OAAO,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,IAAI,SAAS,CAAC;IAC9D,MAAM,KAAK,GAAG,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,CAAC;IACjC,IAAI,KAAK,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IAChC,MAAM,KAAK,GAAG,IAAI,CAAC,KAAK,GAAG,CAAC,CAAC,CAAC;IAC9B,IAAI,CAAC,KAAK,IAAI,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC;QAAE,OAAO,SAAS,CAAC;IACtD,OAAO,KAAK,CAAC;AACf,CAAC;AAED,MAAM,UAAU,OAAO,CAAC,IAAc,EAAE,IAAY;IAClD,OAAO,IAAI,CAAC,QAAQ,CAAC,IAAI,CAAC,CAAC;AAC7B,CAAC"}

package/dist/cli/auth.d.ts

@@ -0,0 +1,7 @@
+import type { BuiltInAuthConfig } from "../types.js";
+export interface PaneljsCliConfig {
+    prisma: object;
+    auth: BuiltInAuthConfig;
+}
+export declare function authSchema(identifier: string): string;
+export declare const createSuperuser: (argv: string[]) => Promise<void>;

package/dist/cli/auth.js

@@ -0,0 +1,95 @@
+import { resolve } from "node:path";
+import { pathToFileURL } from "node:url";
+import { hashAdminPassword } from "../passwords.js";
+import { argument } from "./args.js";
+import { confirm, hiddenQuestion, question } from "./prompt.js";
+const emailSchema = `enum ExpressAdminRole {
+  ADMIN
+  SUPER_ADMIN
+}
+
+model ExpressAdminUser {
+  id           String           @id @default(cuid())
+  email        String           @unique
+  passwordHash String
+  role         ExpressAdminRole @default(ADMIN)
+  isActive     Boolean          @default(true)
+  createdAt    DateTime         @default(now())
+  updatedAt    DateTime         @updatedAt
+  sessions     ExpressAdminSession[]
+}
+
+model ExpressAdminSession {
+  id        String           @id @default(cuid())
+  tokenHash String           @unique
+  userId    String
+  user      ExpressAdminUser @relation(fields: [userId], references: [id], onDelete: Cascade)
+  expiresAt DateTime
+  createdAt DateTime         @default(now())
+
+  @@index([userId])
+  @@index([expiresAt])
+}`;
+const usernameSchema = emailSchema.replace("email        String           @unique", "username     String           @unique");
+export function authSchema(identifier) {
+    if (identifier !== "email" && identifier !== "username") {
+        throw new Error("auth:schema requires --identifier email or --identifier username");
+    }
+    return identifier === "email" ? emailSchema : usernameSchema;
+}
+const modelKey = (modelName) => modelName.charAt(0).toLowerCase() + modelName.slice(1);
+const loadConfig = async (configPath) => {
+    const module = await import(pathToFileURL(resolve(configPath)).href);
+    const config = module.default;
+    if (!config?.prisma || config.auth?.mode !== "built-in")
+        throw new Error('The config must default-export { prisma, auth: { mode: "built-in", ... } }. TypeORM apps should insert the first operator with hashAdminPassword instead.');
+    return config;
+};
+export const createSuperuser = async (argv) => {
+    const configPath = argument(argv, "--config");
+    if (!configPath)
+        throw new Error("createsuperuser requires --config ./paneljs.config.mjs");
+    const config = await loadConfig(configPath);
+    try {
+        const identifierName = config.auth.identifier;
+        const identifier = argument(argv, `--${identifierName}`) ??
+            (await question(`${identifierName === "email" ? "Email" : "Username"}: `));
+        const suppliedPassword = argument(argv, "--password") ?? process.env.EXPRESS_ADMIN_PASSWORD;
+        const password = suppliedPassword ?? (await hiddenQuestion("Password: "));
+        if (!suppliedPassword) {
+            const confirmation = await hiddenQuestion("Confirm password: ");
+            if (password !== confirmation)
+                throw new Error("Passwords do not match.");
+        }
+        if (!identifier || identifier.length > 254)
+            throw new Error(`A valid ${identifierName} is required.`);
+        if (!password)
+            throw new Error("Password cannot be empty.");
+        if (password.length < 12) {
+            const warning = "This password is shorter than the recommended 12 characters. Continue anyway?";
+            if (suppliedPassword)
+                console.warn(`Warning: ${warning}`);
+            else if (!(await confirm(warning, false)))
+                throw new Error("Superuser creation cancelled.");
+        }
+        const delegate = config.prisma[modelKey(config.auth.userModel ?? "ExpressAdminUser")];
+        if (!delegate)
+            throw new Error(`Prisma client has no delegate for ${config.auth.userModel ?? "ExpressAdminUser"}. Generate your Prisma client after adding the auth schema.`);
+        await delegate.create({
+            data: {
+                [identifierName]: identifier,
+                passwordHash: await hashAdminPassword(password),
+                role: "SUPER_ADMIN",
+                isActive: true,
+            },
+        });
+        console.log(`Superuser created. Sign in at /admin/login with your ${identifierName}.`);
+    }
+    finally {
+        const disconnect = config.prisma
+            .$disconnect;
+        if (disconnect)
+            await disconnect.call(config.prisma);
+    }
+};
+//# sourceMappingURL=auth.js.map

package/dist/cli/auth.js.map

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

package/dist/cli/init.d.ts

@@ -0,0 +1,37 @@
+import { type InstallPlan, type PackageManifest } from "./project.js";
+import type { SelectItem } from "./prompt.js";
+import { type FrameworkId, type OrmId, type PackageManager } from "./stack.js";
+export interface InitFlags {
+    framework?: string;
+    orm?: string;
+    pm?: string;
+    yes?: boolean;
+    dryRun?: boolean;
+    help?: boolean;
+}
+export interface InitIo {
+    stdout: {
+        write(chunk: string): void;
+    };
+    isTTY: boolean;
+    env: NodeJS.ProcessEnv;
+    select(label: string, items: SelectItem[]): Promise<string>;
+    confirm(label: string): Promise<boolean>;
+    install(pm: PackageManager, cwd: string, dependencies: string[], devDependencies: string[]): Promise<void>;
+}
+export declare function parseInitArgs(argv: string[]): InitFlags;
+export declare const INIT_USAGE = "Usage:\n  paneljs init [--framework express] [--orm prisma|typeorm] [--pm npm|pnpm|yarn|bun] [--yes] [--dry-run]\n\nAdds PanelJS packages to the app in this directory. Does not rewrite source files.\nFastify, Nest.js, and Drizzle are listed in the prompt but are not selectable yet.";
+export interface ResolvedInit {
+    framework: FrameworkId;
+    orm: OrmId;
+    pm: PackageManager;
+    plan: InstallPlan;
+    packages: string[];
+}
+export declare function resolveInitPlan(cwd: string, flags: InitFlags, manifest: PackageManifest, env: NodeJS.ProcessEnv, framework: FrameworkId, orm: OrmId): ResolvedInit;
+export declare function runInit(input: {
+    cwd: string;
+    argv: string[];
+    io: InitIo;
+}): Promise<void>;
+export declare function createDefaultInstall(): InitIo["install"];

package/dist/cli/init.js

@@ -0,0 +1,137 @@
+import { spawn } from "node:child_process";
+import { argument, hasFlag } from "./args.js";
+import { detectPackageManager, installArgs, peersFor, planInstall, readManifest, } from "./project.js";
+import { docsUrl, FRAMEWORKS, ORMS, paneljsPackages, parseFramework, parseOrm, resolveFramework, resolveOrm, setupSnippet, } from "./stack.js";
+export function parseInitArgs(argv) {
+    const unknown = argv.filter((item) => item.startsWith("-") &&
+        item !== "--framework" &&
+        item !== "--orm" &&
+        item !== "--pm" &&
+        item !== "--yes" &&
+        item !== "-y" &&
+        item !== "--dry-run" &&
+        item !== "--help" &&
+        item !== "-h" &&
+        !item.startsWith("--framework=") &&
+        !item.startsWith("--orm=") &&
+        !item.startsWith("--pm="));
+    if (unknown.length > 0) {
+        throw new Error(`Unknown init flag: ${unknown[0]}`);
+    }
+    return {
+        framework: argument(argv, "--framework"),
+        orm: argument(argv, "--orm"),
+        pm: argument(argv, "--pm"),
+        yes: hasFlag(argv, "--yes") || hasFlag(argv, "-y"),
+        dryRun: hasFlag(argv, "--dry-run"),
+        help: hasFlag(argv, "--help") || hasFlag(argv, "-h"),
+    };
+}
+export const INIT_USAGE = `Usage:
+  paneljs init [--framework express] [--orm prisma|typeorm] [--pm npm|pnpm|yarn|bun] [--yes] [--dry-run]
+
+Adds PanelJS packages to the app in this directory. Does not rewrite source files.
+Fastify, Nest.js, and Drizzle are listed in the prompt but are not selectable yet.`;
+export function resolveInitPlan(cwd, flags, manifest, env, framework, orm) {
+    const frameworkChoice = resolveFramework(framework);
+    const ormChoice = resolveOrm(orm);
+    const packages = paneljsPackages(frameworkChoice.id, ormChoice.id);
+    const plan = planInstall(manifest, packages, peersFor(ormChoice.id));
+    if (plan.incompatible.length > 0) {
+        throw new Error(plan.incompatible.join("\n"));
+    }
+    const pm = detectPackageManager(cwd, manifest, env, flags.pm);
+    return { framework: frameworkChoice.id, orm: ormChoice.id, pm, plan, packages };
+}
+export async function runInit(input) {
+    const flags = parseInitArgs(input.argv);
+    if (flags.help === true) {
+        input.io.stdout.write(`${INIT_USAGE}\n`);
+        return;
+    }
+    const manifest = readManifest(input.cwd);
+    const framework = await pick("Which Node framework are you using?", flags.framework, FRAMEWORKS.map((item) => ({
+        value: item.id,
+        label: item.label,
+        disabled: !item.available,
+    })), flags, input.io, (value) => parseFramework(value));
+    const orm = await pick("Which ORM are you using?", flags.orm, ORMS.map((item) => ({
+        value: item.id,
+        label: item.label,
+        disabled: !item.available,
+    })), flags, input.io, (value) => parseOrm(value));
+    const resolved = resolveInitPlan(input.cwd, flags, manifest, input.io.env, framework, orm);
+    const { plan } = resolved;
+    const adding = [...plan.dependencies, ...plan.devDependencies];
+    input.io.stdout.write("\n");
+    if (adding.length === 0) {
+        input.io.stdout.write("PanelJS packages for this stack are already listed.\n");
+    }
+    else {
+        input.io.stdout.write(`Using ${resolved.pm}. Will add:\n`);
+        for (const name of plan.dependencies)
+            input.io.stdout.write(`  ${name}\n`);
+        for (const name of plan.devDependencies)
+            input.io.stdout.write(`  ${name} (dev)\n`);
+    }
+    if (plan.alreadyPresent.length > 0) {
+        input.io.stdout.write(`Already present: ${plan.alreadyPresent.join(", ")}\n`);
+    }
+    input.io.stdout.write("No source files will be changed.\n");
+    if (flags.dryRun === true) {
+        input.io.stdout.write("\nDry run. Nothing was installed.\n");
+        writeSnippet(input.io, resolved.framework, resolved.orm);
+        return;
+    }
+    if (adding.length > 0 && flags.yes !== true) {
+        if (!input.io.isTTY) {
+            throw new Error("Non-interactive install requires --yes.");
+        }
+        const ok = await input.io.confirm("Install these packages?");
+        if (!ok)
+            throw new Error("Init cancelled.");
+    }
+    if (adding.length > 0) {
+        await input.io.install(resolved.pm, input.cwd, plan.dependencies, plan.devDependencies);
+    }
+    input.io.stdout.write("\nInstalled. Wire this into your existing server:\n\n");
+    writeSnippet(input.io, resolved.framework, resolved.orm);
+}
+function writeSnippet(io, framework, orm) {
+    io.stdout.write(`${setupSnippet(framework, orm)}\n\n`);
+    io.stdout.write(`Docs: ${docsUrl(framework, orm)}\n`);
+    io.stdout.write("Auth: https://www.paneljs.com/docs/guide/auth\n");
+}
+async function pick(label, flagged, items, flags, io, parse) {
+    if (flagged)
+        return parse(flagged);
+    if (flags.yes === true || !io.isTTY) {
+        throw new Error(`${label} Pass the matching flag with --yes, or run in a terminal.`);
+    }
+    return parse(await io.select(label, items));
+}
+export function createDefaultInstall() {
+    return async (pm, cwd, dependencies, devDependencies) => {
+        if (dependencies.length > 0)
+            await runCommand(pm, installArgs(pm, dependencies, false), cwd);
+        if (devDependencies.length > 0)
+            await runCommand(pm, installArgs(pm, devDependencies, true), cwd);
+    };
+}
+function runCommand(command, args, cwd) {
+    return new Promise((resolve, reject) => {
+        const child = spawn(command, args, {
+            cwd,
+            stdio: "inherit",
+            shell: process.platform === "win32",
+        });
+        child.on("error", reject);
+        child.on("exit", (code) => {
+            if (code === 0)
+                resolve();
+            else
+                reject(new Error(`${command} ${args.join(" ")} exited with code ${code}.`));
+        });
+    });
+}
+//# sourceMappingURL=init.js.map

package/dist/cli/init.js.map

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

package/dist/cli/project.d.ts

@@ -0,0 +1,31 @@
+import type { OrmId, PackageManager } from "./stack.js";
+export interface PackageManifest {
+    dependencies?: Record<string, string>;
+    devDependencies?: Record<string, string>;
+    optionalDependencies?: Record<string, string>;
+    packageManager?: string;
+}
+export interface PeerNeed {
+    name: string;
+    installAs: "dep" | "dev";
+    spec?: string;
+}
+export declare function readManifest(cwd: string): PackageManifest;
+export declare function declaredSpec(manifest: PackageManifest, name: string): string | undefined;
+export declare function detectPackageManager(cwd: string, manifest: PackageManifest, env: NodeJS.ProcessEnv, override?: string): PackageManager;
+export declare function packageManagerFromUserAgent(userAgent: string | undefined): PackageManager | undefined;
+export declare function peersFor(orm: OrmId): PeerNeed[];
+export declare function incompatiblePeer(name: string, spec: string): string | undefined;
+export declare function parseLeadingVersion(spec: string): {
+    major: number;
+    minor: number;
+    patch: number;
+} | undefined;
+export interface InstallPlan {
+    dependencies: string[];
+    devDependencies: string[];
+    alreadyPresent: string[];
+    incompatible: string[];
+}
+export declare function planInstall(manifest: PackageManifest, panelPackages: string[], peers: PeerNeed[]): InstallPlan;
+export declare function installArgs(pm: PackageManager, packages: string[], dev: boolean): string[];

package/dist/cli/project.js

@@ -0,0 +1,150 @@
+import { existsSync, readFileSync } from "node:fs";
+import { join } from "node:path";
+const PRISMA_PEERS = [
+    { name: "express", installAs: "dep" },
+    { name: "@prisma/client", installAs: "dep", spec: "~7.5.0" },
+    { name: "prisma", installAs: "dev", spec: "~7.5.0" },
+];
+const TYPEORM_PEERS = [
+    { name: "express", installAs: "dep" },
+    { name: "typeorm", installAs: "dep", spec: "^0.3.20" },
+];
+export function readManifest(cwd) {
+    const path = join(cwd, "package.json");
+    if (!existsSync(path)) {
+        throw new Error("No package.json in this directory. Run paneljs init inside your app.");
+    }
+    try {
+        return JSON.parse(readFileSync(path, "utf8"));
+    }
+    catch {
+        throw new Error(`Could not parse ${path}.`);
+    }
+}
+export function declaredSpec(manifest, name) {
+    return (manifest.dependencies?.[name] ??
+        manifest.devDependencies?.[name] ??
+        manifest.optionalDependencies?.[name]);
+}
+export function detectPackageManager(cwd, manifest, env, override) {
+    if (override) {
+        const allowed = ["npm", "pnpm", "yarn", "bun"];
+        if (!allowed.includes(override)) {
+            throw new Error(`Unknown package manager "${override}". Use npm, pnpm, yarn, or bun.`);
+        }
+        return override;
+    }
+    const fromAgent = packageManagerFromUserAgent(env.npm_config_user_agent);
+    if (fromAgent)
+        return fromAgent;
+    const field = manifest.packageManager?.split("@")[0];
+    if (field === "npm" || field === "pnpm" || field === "yarn" || field === "bun") {
+        return field;
+    }
+    if (existsSync(join(cwd, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(cwd, "yarn.lock")))
+        return "yarn";
+    if (existsSync(join(cwd, "bun.lock")) || existsSync(join(cwd, "bun.lockb")))
+        return "bun";
+    if (existsSync(join(cwd, "package-lock.json")))
+        return "npm";
+    return "npm";
+}
+export function packageManagerFromUserAgent(userAgent) {
+    if (!userAgent)
+        return undefined;
+    const name = userAgent.split("/")[0];
+    if (name === "npm" || name === "pnpm" || name === "yarn" || name === "bun") {
+        return name;
+    }
+    return undefined;
+}
+export function peersFor(orm) {
+    if (orm === "prisma")
+        return PRISMA_PEERS;
+    if (orm === "typeorm")
+        return TYPEORM_PEERS;
+    return [{ name: "express", installAs: "dep" }];
+}
+export function incompatiblePeer(name, spec) {
+    if (spec.startsWith("workspace:") ||
+        spec.startsWith("catalog:") ||
+        spec === "*" ||
+        spec === "latest") {
+        return undefined;
+    }
+    const version = parseLeadingVersion(spec);
+    if (!version)
+        return undefined;
+    if (name === "prisma" || name === "@prisma/client") {
+        if (version.major !== 7 || version.minor !== 5) {
+            return `${name}@${spec} is not Prisma 7.5.x. @paneljs/prisma requires ~7.5.0.`;
+        }
+        return undefined;
+    }
+    if (name === "typeorm") {
+        if (version.major !== 0 ||
+            version.minor < 3 ||
+            (version.minor === 3 && version.patch < 20)) {
+            return `${name}@${spec} is below ^0.3.20.`;
+        }
+        return undefined;
+    }
+    if (name === "express") {
+        if (version.major < 4 || (version.major === 4 && version.minor < 18)) {
+            return `${name}@${spec} is below ^4.18 or ^5.`;
+        }
+        return undefined;
+    }
+    return undefined;
+}
+export function parseLeadingVersion(spec) {
+    const match = spec
+        .replace(/^[~^>=<\s]+/, "")
+        .match(/^(\d+)\.(\d+)(?:\.(\d+))?/);
+    if (!match)
+        return undefined;
+    return {
+        major: Number(match[1]),
+        minor: Number(match[2]),
+        patch: Number(match[3] ?? 0),
+    };
+}
+export function planInstall(manifest, panelPackages, peers) {
+    const incompatible = [];
+    const alreadyPresent = [];
+    const dependencies = [];
+    const devDependencies = [];
+    const consider = (name, installAs, spec) => {
+        const declared = declaredSpec(manifest, name);
+        if (declared) {
+            const problem = incompatiblePeer(name, declared);
+            if (problem)
+                incompatible.push(problem);
+            else
+                alreadyPresent.push(name);
+            return;
+        }
+        const token = spec ? `${name}@${spec}` : name;
+        if (installAs === "dev")
+            devDependencies.push(token);
+        else
+            dependencies.push(token);
+    };
+    for (const name of panelPackages)
+        consider(name, "dep");
+    for (const peer of peers)
+        consider(peer.name, peer.installAs, peer.spec);
+    return { dependencies, devDependencies, alreadyPresent, incompatible };
+}
+export function installArgs(pm, packages, dev) {
+    if (packages.length === 0)
+        return [];
+    if (pm === "npm")
+        return ["install", ...(dev ? ["-D"] : []), ...packages];
+    if (pm === "bun")
+        return ["add", ...(dev ? ["-d"] : []), ...packages];
+    return ["add", ...(dev ? ["-D"] : []), ...packages];
+}
+//# sourceMappingURL=project.js.map

package/dist/cli/project.js.map

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

package/dist/cli/prompt.d.ts

@@ -0,0 +1,10 @@
+export interface SelectItem {
+    value: string;
+    label: string;
+    disabled?: boolean;
+    hint?: string;
+}
+export declare function question(label: string): Promise<string>;
+export declare function confirm(label: string, defaultYes?: boolean): Promise<boolean>;
+export declare function hiddenQuestion(label: string): Promise<string>;
+export declare function select(label: string, items: SelectItem[]): Promise<string>;