@starklabs/forge 1.3.25-builtin-configs.0 → 2.0.0

package/dist/security/Totp.js

@@ -0,0 +1,111 @@
+import { createHmac, randomBytes, timingSafeEqual } from "node:crypto";
+const ALPHABET = "ABCDEFGHIJKLMNOPQRSTUVWXYZ234567";
+/** RFC 4648 base32 (the encoding authenticator apps expect for secrets). */
+export const base32 = {
+    encode(bytes) {
+        let bits = 0;
+        let value = 0;
+        let out = "";
+        for (const byte of bytes) {
+            value = (value << 8) | byte;
+            bits += 8;
+            while (bits >= 5) {
+                out += ALPHABET[(value >>> (bits - 5)) & 31];
+                bits -= 5;
+            }
+        }
+        if (bits > 0)
+            out += ALPHABET[(value << (5 - bits)) & 31];
+        return out;
+    },
+    decode(text) {
+        const clean = text.replace(/[\s=-]/g, "").toUpperCase();
+        let bits = 0;
+        let value = 0;
+        const out = [];
+        for (const char of clean) {
+            const index = ALPHABET.indexOf(char);
+            if (index === -1)
+                throw new Error("Invalid base32 character");
+            value = (value << 5) | index;
+            bits += 5;
+            if (bits >= 8) {
+                out.push((value >>> (bits - 8)) & 255);
+                bits -= 8;
+            }
+        }
+        return Buffer.from(out);
+    },
+};
+/**
+ * Time-based one-time passwords (RFC 6238, HMAC-SHA1) - what Google Authenticator, Authy,
+ * 1Password and friends generate.
+ */
+export class Totp {
+    digits;
+    period;
+    window;
+    constructor(options = {}) {
+        this.digits = options.digits ?? 6;
+        this.period = options.period ?? 30;
+        this.window = options.window ?? 1;
+    }
+    /** A fresh 160-bit secret, base32 encoded. */
+    static generateSecret(bytes = 20) {
+        return base32.encode(randomBytes(bytes));
+    }
+    /** The time step a moment falls in. */
+    stepAt(timeMs) {
+        return Math.floor(timeMs / 1000 / this.period);
+    }
+    /** The code an authenticator app shows at `timeMs`. */
+    codeAt(secret, timeMs = Date.now()) {
+        return this.hotp(base32.decode(secret), this.stepAt(timeMs));
+    }
+    /**
+     * Checks a user-supplied code against the steps around now.
+     * Returns the matching step (store it, and pass it as `afterStep` next time so a code can never be
+     * used twice), or `undefined`. Every candidate is compared in constant time with no early exit.
+     */
+    verify(secret, code, options = {}) {
+        const candidate = code.replace(/\s/g, "");
+        if (!new RegExp(`^\\d{${this.digits}}$`).test(candidate))
+            return undefined;
+        const key = base32.decode(secret);
+        const current = this.stepAt(options.now ?? Date.now());
+        const given = Buffer.from(candidate);
+        let matched;
+        for (let step = current - this.window; step <= current + this.window; step++) {
+            if (step < 0)
+                continue;
+            const equal = timingSafeEqual(given, Buffer.from(this.hotp(key, step)));
+            if (equal && step > (options.afterStep ?? -1))
+                matched = step;
+        }
+        return matched;
+    }
+    /** The `otpauth://` URI that QR codes encode. */
+    otpauthUrl(input) {
+        const label = `${encodeURIComponent(input.issuer)}:${encodeURIComponent(input.account)}`;
+        const query = new URLSearchParams({
+            secret: input.secret,
+            issuer: input.issuer,
+            algorithm: "SHA1",
+            digits: String(this.digits),
+            period: String(this.period),
+        });
+        return `otpauth://totp/${label}?${query.toString()}`;
+    }
+    hotp(key, counter) {
+        const message = Buffer.alloc(8);
+        message.writeBigUInt64BE(BigInt(counter));
+        const hash = createHmac("sha1", key).update(message).digest();
+        const offset = hash[hash.length - 1] & 0x0f;
+        const binary = ((hash[offset] & 0x7f) << 24) |
+            ((hash[offset + 1] & 0xff) << 16) |
+            ((hash[offset + 2] & 0xff) << 8) |
+            (hash[offset + 3] & 0xff);
+        return (binary % 10 ** this.digits).toString().padStart(this.digits, "0");
+    }
+}
+//# sourceMappingURL=Totp.js.map

package/dist/security/Totp.js.map

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

package/dist/security/index.d.ts

@@ -0,0 +1,4 @@
+export * from "./PasswordHasher.js";
+export * from "./CryptoVault.js";
+export * from "./TokenService.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/security/index.js

@@ -0,0 +1,4 @@
+export * from "./PasswordHasher.js";
+export * from "./CryptoVault.js";
+export * from "./TokenService.js";
+//# sourceMappingURL=index.js.map

package/dist/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/security/index.ts"],"names":[],"mappings":"AAAA,cAAc,qBAAqB,CAAC;AACpC,cAAc,kBAAkB,CAAC;AACjC,cAAc,mBAAmB,CAAC"}

package/dist/terminal/BannerPrinter.d.ts

@@ -0,0 +1,9 @@
+import type { ForgeConfig } from "../config/ForgeConfig.js";
+import type { Collection } from "../types/Collection.js";
+/** Prints the start-up banner from the real, resolved configuration. */
+export declare class BannerPrinter {
+    private readonly config;
+    constructor(config: ForgeConfig);
+    print(collections: readonly Collection[], dbStatus: string, port?: number): void;
+}
+//# sourceMappingURL=BannerPrinter.d.ts.map

package/dist/terminal/BannerPrinter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerPrinter.d.ts","sourceRoot":"","sources":["../../src/terminal/BannerPrinter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,WAAW,EAAE,MAAM,0BAA0B,CAAC;AAC5D,OAAO,KAAK,EAAE,UAAU,EAAE,MAAM,wBAAwB,CAAC;AAGzD,wEAAwE;AACxE,qBAAa,aAAa;IACZ,OAAO,CAAC,QAAQ,CAAC,MAAM;IAAnC,YAA6B,MAAM,EAAE,WAAW,EAAI;IAEpD,KAAK,CAAC,WAAW,EAAE,SAAS,UAAU,EAAE,EAAE,QAAQ,EAAE,MAAM,EAAE,IAAI,GAAE,MAAyB,GAAG,IAAI,CA4BjG;CACF"}

package/dist/terminal/BannerPrinter.js

@@ -0,0 +1,36 @@
+import printBanner from "./banner.js";
+/** Prints the start-up banner from the real, resolved configuration. */
+export class BannerPrinter {
+    config;
+    constructor(config) {
+        this.config = config;
+    }
+    print(collections, dbStatus, port = this.config.port) {
+        const models = new Set(collections.map((c) => c.model).filter(Boolean));
+        const routes = collections.reduce((sum, c) => sum + c.routes.length, 0);
+        const validators = collections.reduce((sum, c) => sum + Object.keys(c.validations ?? {}).length, 0);
+        const routeList = collections.flatMap((c) => c.routes);
+        const features = [
+            collections.some((c) => c.type === "auth") && "authentication",
+            routeList.some((r) => r.auth === "admin" || r.auth === "admin-or-owner") && "authorization",
+            collections.some((c) => c.type === "crud") && "autoCrud",
+            routeList.some((r) => r.files?.length) && "fileUpload",
+            "rateLimiting",
+            "errorHandling",
+            "cors",
+        ].filter((f) => typeof f === "string");
+        printBanner({
+            env: this.config.env,
+            host: "localhost",
+            port,
+            url: `http://localhost:${port}`,
+            apiPrefix: this.config.apiPrefix,
+            health: `${this.config.apiPrefix}/health`,
+            db: { driver: "MongoDB", name: this.config.databaseName, connected: dbStatus === "Connected", status: dbStatus },
+            generated: { models: models.size, validators, routes },
+            features,
+            resources: [...models].filter((m) => typeof m === "string"),
+        });
+    }
+}
+//# sourceMappingURL=BannerPrinter.js.map

package/dist/terminal/BannerPrinter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"BannerPrinter.js","sourceRoot":"","sources":["../../src/terminal/BannerPrinter.ts"],"names":[],"mappings":"AAEA,OAAO,WAAW,MAAM,aAAa,CAAC;AAEtC,wEAAwE;AACxE,MAAM,OAAO,aAAa;IACK,MAAM;IAAnC,YAA6B,MAAmB;sBAAnB,MAAM;IAAgB,CAAC;IAEpD,KAAK,CAAC,WAAkC,EAAE,QAAgB,EAAE,IAAI,GAAW,IAAI,CAAC,MAAM,CAAC,IAAI;QACzF,MAAM,MAAM,GAAG,IAAI,GAAG,CAAC,WAAW,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,CAAC;QACxE,MAAM,MAAM,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,CAAC,CAAC,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACxE,MAAM,UAAU,GAAG,WAAW,CAAC,MAAM,CAAC,CAAC,GAAG,EAAE,CAAC,EAAE,EAAE,CAAC,GAAG,GAAG,MAAM,CAAC,IAAI,CAAC,CAAC,CAAC,WAAW,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;QACpG,MAAM,SAAS,GAAG,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC;QAEvD,MAAM,QAAQ,GAAG;YACf,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,gBAAgB;YAC9D,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,OAAO,IAAI,CAAC,CAAC,IAAI,KAAK,gBAAgB,CAAC,IAAI,eAAe;YAC3F,WAAW,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,IAAI,KAAK,MAAM,CAAC,IAAI,UAAU;YACxD,SAAS,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,KAAK,EAAE,MAAM,CAAC,IAAI,YAAY;YACtD,cAAc;YACd,eAAe;YACf,MAAM;SACP,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC,CAAC;QAEpD,WAAW,CAAC;YACV,GAAG,EAAE,IAAI,CAAC,MAAM,CAAC,GAAG;YACpB,IAAI,EAAE,WAAW;YACjB,IAAI;YACJ,GAAG,EAAE,oBAAoB,IAAI,EAAE;YAC/B,SAAS,EAAE,IAAI,CAAC,MAAM,CAAC,SAAS;YAChC,MAAM,EAAE,GAAG,IAAI,CAAC,MAAM,CAAC,SAAS,SAAS;YACzC,EAAE,EAAE,EAAE,MAAM,EAAE,SAAS,EAAE,IAAI,EAAE,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,SAAS,EAAE,QAAQ,KAAK,WAAW,EAAE,MAAM,EAAE,QAAQ,EAAE;YAChH,SAAS,EAAE,EAAE,MAAM,EAAE,MAAM,CAAC,IAAI,EAAE,UAAU,EAAE,MAAM,EAAE;YACtD,QAAQ;YACR,SAAS,EAAE,CAAC,GAAG,MAAM,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,EAAe,EAAE,CAAC,OAAO,CAAC,KAAK,QAAQ,CAAC;SACzE,CAAC,CAAC;IACL,CAAC;CACF"}

package/dist/terminal/banner.d.ts

@@ -0,0 +1,25 @@
+interface Config {
+    env: string;
+    host: string;
+    port: number | string;
+    url: string;
+    apiPrefix: string;
+    health: string;
+    db: {
+        driver: string;
+        name: string;
+        connected: boolean;
+        status: string;
+    };
+    generated: {
+        models: number;
+        validators: number;
+        routes: number;
+        middlewares?: number;
+    };
+    features: string[];
+    resources: string[];
+}
+export declare const printBanner: (config: Config) => void;
+export default printBanner;
+//# sourceMappingURL=banner.d.ts.map

package/dist/terminal/banner.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.d.ts","sourceRoot":"","sources":["../../src/terminal/banner.ts"],"names":[],"mappings":"AAgUA,UAAU,MAAM;IACd,GAAG,EAAE,MAAM,CAAC;IAEZ,IAAI,EAAE,MAAM,CAAC;IAEb,IAAI,EAAE,MAAM,GAAG,MAAM,CAAC;IAEtB,GAAG,EAAE,MAAM,CAAC;IAEZ,SAAS,EAAE,MAAM,CAAC;IAElB,MAAM,EAAE,MAAM,CAAC;IAEf,EAAE,EAAE;QACF,MAAM,EAAE,MAAM,CAAC;QACf,IAAI,EAAE,MAAM,CAAC;QACb,SAAS,EAAE,OAAO,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;KAChB,CAAC;IAEF,SAAS,EAAE;QACT,MAAM,EAAE,MAAM,CAAC;QACf,UAAU,EAAE,MAAM,CAAC;QACnB,MAAM,EAAE,MAAM,CAAC;QACf,WAAW,CAAC,EAAE,MAAM,CAAC;KACtB,CAAC;IAEF,QAAQ,EAAE,MAAM,EAAE,CAAC;IAEnB,SAAS,EAAE,MAAM,EAAE,CAAC;CACrB;AAMD,eAAO,MAAM,WAAW,WAAY,MAAM,SA2NzC,CAAC;eAEa,WAAW"}

package/dist/terminal/banner.js

@@ -0,0 +1,242 @@
+import os from "os";
+import process from "process";
+import stringWidth from "string-width";
+// ─────────────────────────────────────────────────────────────────────────────
+// Colors & Styling
+// ─────────────────────────────────────────────────────────────────────────────
+const colors = {
+    reset: "\x1b[0m",
+    bold: "\x1b[1m",
+    dim: "\x1b[2m",
+    cyan: "\x1b[36m",
+    green: "\x1b[32m",
+    yellow: "\x1b[33m",
+    blue: "\x1b[34m",
+    magenta: "\x1b[35m",
+    red: "\x1b[31m",
+    gray: "\x1b[90m",
+    white: "\x1b[37m",
+    // Brand Palette
+    orange: "\x1b[38;5;208m",
+    amber: "\x1b[38;5;214m",
+    gold: "\x1b[38;5;220m",
+    darkOrange: "\x1b[38;5;166m",
+};
+const c = (text, color) => `${color}${text}${colors.reset}`;
+// ─────────────────────────────────────────────────────────────────────────────
+// Terminal Width Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+const stripAnsi = (str) => str.replace(/\x1b\[[0-9;]*m/g, "");
+const visibleLen = (str) => stringWidth(stripAnsi(str));
+const padRight = (str, width) => str + " ".repeat(Math.max(0, width - visibleLen(str)));
+// ─────────────────────────────────────────────────────────────────────────────
+// UI Components
+// ─────────────────────────────────────────────────────────────────────────────
+//
+// CARD_WIDTH is the COMPLETE visible width:
+//
+// ╭────────────────────────────────────────────────────────────╮
+// │ content                                                    │
+// ├────────────────────────────────────────────────────────────┤
+// │ content                                                    │
+// ╰────────────────────────────────────────────────────────────╯
+//
+// Everything is calculated from this single value.
+// ─────────────────────────────────────────────────────────────────────────────
+const CARD_WIDTH = 60;
+// Characters outside the content area:
+// │ + space + CONTENT + space + │
+//
+// Therefore:
+const CONTENT_WIDTH = CARD_WIDTH - 4;
+const box = {
+    topLeft: "╭",
+    topRight: "╮",
+    bottomLeft: "╰",
+    bottomRight: "╯",
+    horizontal: "─",
+    vertical: "│",
+    crossRight: "├",
+    crossLeft: "┤",
+};
+// ─────────────────────────────────────────────────────────────────────────────
+// Box Drawing Helpers
+// ─────────────────────────────────────────────────────────────────────────────
+function drawTopBorder() {
+    console.log(c(`${box.topLeft}${box.horizontal.repeat(CARD_WIDTH - 2)}${box.topRight}`, colors.gray));
+}
+function drawBottomBorder() {
+    console.log(c(`${box.bottomLeft}${box.horizontal.repeat(CARD_WIDTH - 2)}${box.bottomRight}`, colors.gray));
+}
+function drawDivider() {
+    console.log(c(`${box.crossRight}${box.horizontal.repeat(CARD_WIDTH - 2)}${box.crossLeft}`, colors.gray));
+}
+function drawEmptyRow() {
+    console.log(`${c(box.vertical, colors.gray)} ${" ".repeat(CONTENT_WIDTH)} ${c(box.vertical, colors.gray)}`);
+}
+function drawHeader(title) {
+    drawEmptyRow();
+    const titleWidth = visibleLen(title);
+    // ├─ title ────────────────────────────────────────────────────────────┤
+    //
+    // 2 = "├─"
+    // 1 = space before title
+    // 1 = space after title
+    // 1 = final "┤"
+    //
+    // The remaining space is filled with horizontal characters.
+    const horizontalLength = CARD_WIDTH - titleWidth - 5;
+    const lineStr = box.horizontal.repeat(Math.max(0, horizontalLength));
+    console.log(c(`${box.crossRight}${box.horizontal} ${title} ${lineStr}${box.crossLeft}`, colors.gray));
+    drawEmptyRow();
+}
+function drawRow(key, value, keyWidth = 16) {
+    const formattedKey = padRight(key, keyWidth);
+    const valSpace = CONTENT_WIDTH - keyWidth - 3;
+    const formattedVal = padRight(String(value), Math.max(0, valSpace));
+    const keyColored = c(formattedKey, colors.gray);
+    const sep = c(box.vertical, colors.gray);
+    console.log(`${c(box.vertical, colors.gray)} ${keyColored} ${sep} ${formattedVal} ${c(box.vertical, colors.gray)}`);
+}
+function drawBadgeList(items) {
+    items.forEach((item) => {
+        const content = `${c("✔", colors.green)} ${c(item, colors.white)}`;
+        const padded = padRight(content, CONTENT_WIDTH);
+        console.log(`${c(box.vertical, colors.gray)} ${padded} ${c(box.vertical, colors.gray)}`);
+    });
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Forge Logo
+// ─────────────────────────────────────────────────────────────────────────────
+function forgeLogo() {
+    const logo = [
+        "      ███████╗ ██████╗  ██████╗   ██████╗ ███████╗",
+        "      ██╔════╝██╔═══██╗██╔══██╗ ██╔════╝ ██╔════╝",
+        "      █████╗  ██║   ██║██████╔╝ ██║  ███╗█████╗  ",
+        "      ██╔══╝  ██║   ██║██╔══██╗ ██║   ██║██╔══╝  ",
+        "      ██║     ╚██████╔╝██║  ██║ ╚██████╔╝███████╗",
+        "      ╚═╝      ╚═════╝ ╚═╝  ╚═╝  ╚═════╝ ╚══════╝",
+    ];
+    console.log();
+    // Top border
+    drawTopBorder();
+    drawEmptyRow();
+    // Brand Tagline Header
+    const brand = c("STARKLABS", colors.amber);
+    const brandPadding = Math.max(0, Math.floor((CONTENT_WIDTH - visibleLen(brand)) / 2));
+    const centeredBrand = padRight(" ".repeat(brandPadding) + brand, CONTENT_WIDTH);
+    console.log(`${c(box.vertical, colors.gray)} ${centeredBrand} ${c(box.vertical, colors.gray)}`);
+    drawEmptyRow();
+    // Divider
+    drawDivider();
+    drawEmptyRow();
+    // Logo Body with Vertical Gradient
+    logo.forEach((lineText, index) => {
+        let color = colors.orange;
+        if (index >= 2 && index <= 3) {
+            color = colors.amber;
+        }
+        if (index >= 4) {
+            color = colors.gold;
+        }
+        const paddedLogo = padRight("  " + lineText, CONTENT_WIDTH);
+        console.log(`${c(box.vertical, colors.gray)} ${c(paddedLogo, color)} ${c(box.vertical, colors.gray)}`);
+    });
+    drawEmptyRow();
+    // Subtitle / Tagline
+    const slogan = c("Build less. Ship everything.", colors.gray);
+    const sloganPadding = Math.max(0, Math.floor((CONTENT_WIDTH - visibleLen(slogan)) / 2));
+    const centeredSlogan = padRight(" ".repeat(sloganPadding) + slogan, CONTENT_WIDTH);
+    console.log(`${c(box.vertical, colors.gray)} ${centeredSlogan} ${c(box.vertical, colors.gray)}`);
+    drawEmptyRow();
+    // Bottom border
+    drawBottomBorder();
+}
+// ─────────────────────────────────────────────────────────────────────────────
+// Date
+// ─────────────────────────────────────────────────────────────────────────────
+const formatDate = () => new Date().toLocaleString("en-PK", {
+    dateStyle: "medium",
+    timeStyle: "short"
+});
+// ─────────────────────────────────────────────────────────────────────────────
+// Main Printer Function
+// ─────────────────────────────────────────────────────────────────────────────
+export const printBanner = (config) => {
+    // ───────────────────────────────────────────────────────────────────────────
+    // Logo
+    // ───────────────────────────────────────────────────────────────────────────
+    forgeLogo();
+    // ───────────────────────────────────────────────────────────────────────────
+    // Runtime
+    // ───────────────────────────────────────────────────────────────────────────
+    drawHeader(c("🚀 Runtime", colors.cyan));
+    drawRow("Status", `${c("●", colors.green)} ${c("Running", colors.white)}`);
+    drawRow("Environment", c(config.env, colors.yellow));
+    drawRow("Node Version", process.version);
+    drawRow("Platform", `${os.platform()} (${os.arch()})`);
+    drawRow("Process PID", process.pid);
+    drawRow("Started At", formatDate());
+    // ───────────────────────────────────────────────────────────────────────────
+    // Server
+    // ───────────────────────────────────────────────────────────────────────────
+    drawHeader(c("🌐 Server", colors.cyan));
+    drawRow("Host / Port", `${config.host}:${config.port}`);
+    drawRow("Base URL", c(config.url, colors.blue));
+    drawRow("API Prefix", config.apiPrefix);
+    drawRow("Healthcheck", c(`${config.url}${config.health}`, colors.magenta));
+    // ───────────────────────────────────────────────────────────────────────────
+    // Database
+    // ───────────────────────────────────────────────────────────────────────────
+    drawHeader(c("🗄 Database", colors.cyan));
+    drawRow("Driver / Name", `${config.db.driver} (${config.db.name})`);
+    drawRow("Connection", config.db.connected
+        ? c("✔ Connected", colors.green)
+        : c("✖ Disconnected", colors.red));
+    drawRow("Status", config.db.status);
+    // ───────────────────────────────────────────────────────────────────────────
+    // Generated Assets
+    // ───────────────────────────────────────────────────────────────────────────
+    drawHeader(c("⚡ Generated Code", colors.cyan));
+    drawRow("Models", config.generated.models);
+    drawRow("Validators", config.generated.validators);
+    drawRow("Routes", config.generated.routes);
+    if (config.generated.middlewares !== undefined) {
+        drawRow("Middlewares", config.generated.middlewares);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Features
+    // ───────────────────────────────────────────────────────────────────────────
+    if (config.features?.length) {
+        drawHeader(c("🧩 Features", colors.cyan));
+        drawBadgeList(config.features);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // Resources
+    // ───────────────────────────────────────────────────────────────────────────
+    if (config.resources?.length) {
+        drawHeader(c("📦 Resources", colors.cyan));
+        drawBadgeList(config.resources);
+    }
+    // ───────────────────────────────────────────────────────────────────────────
+    // System
+    // ───────────────────────────────────────────────────────────────────────────
+    drawHeader(c("💻 System Context", colors.cyan));
+    drawRow("CPU Architecture", `${os.cpus().length} Cores`);
+    drawRow("OS Type", os.type());
+    drawRow("Hostname", os.hostname());
+    // ───────────────────────────────────────────────────────────────────────────
+    // Footer
+    // ───────────────────────────────────────────────────────────────────────────
+    drawEmptyRow();
+    drawDivider();
+    drawEmptyRow();
+    const footerText = `${c("Listening on:", colors.gray)} ${c(`${config.url}${config.apiPrefix}/[route]`, colors.blue)}`;
+    const paddedFooter = padRight(" " + footerText, CONTENT_WIDTH);
+    console.log(`${c(box.vertical, colors.gray)} ${paddedFooter} ${c(box.vertical, colors.gray)}`);
+    drawEmptyRow();
+    drawBottomBorder();
+    console.log();
+};
+export default printBanner;
+//# sourceMappingURL=banner.js.map

package/dist/terminal/banner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"banner.js","sourceRoot":"","sources":["../../src/terminal/banner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,IAAI,CAAC;AACpB,OAAO,OAAO,MAAM,SAAS,CAAC;AAC9B,OAAO,WAAW,MAAM,cAAc,CAAC;AAEvC,gFAAgF;AAChF,mBAAmB;AACnB,gFAAgF;AAEhF,MAAM,MAAM,GAAG;IACb,KAAK,EAAE,SAAS;IAChB,IAAI,EAAE,SAAS;IACf,GAAG,EAAE,SAAS;IAEd,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IACjB,MAAM,EAAE,UAAU;IAClB,IAAI,EAAE,UAAU;IAChB,OAAO,EAAE,UAAU;IACnB,GAAG,EAAE,UAAU;IACf,IAAI,EAAE,UAAU;IAChB,KAAK,EAAE,UAAU;IAEjB,gBAAgB;IAChB,MAAM,EAAE,gBAAgB;IACxB,KAAK,EAAE,gBAAgB;IACvB,IAAI,EAAE,gBAAgB;IACtB,UAAU,EAAE,gBAAgB;CAC7B,CAAC;AAEF,MAAM,CAAC,GAAG,CAAC,IAAqB,EAAE,KAAa,EAAE,EAAE,CACjD,GAAG,KAAK,GAAG,IAAI,GAAG,MAAM,CAAC,KAAK,EAAE,CAAC;AAEnC,gFAAgF;AAChF,yBAAyB;AACzB,gFAAgF;AAEhF,MAAM,SAAS,GAAG,CAAC,GAAW,EAAE,EAAE,CAChC,GAAG,CAAC,OAAO,CAAC,iBAAiB,EAAE,EAAE,CAAC,CAAC;AAErC,MAAM,UAAU,GAAG,CAAC,GAAW,EAAE,EAAE,CACjC,WAAW,CAAC,SAAS,CAAC,GAAG,CAAC,CAAC,CAAC;AAE9B,MAAM,QAAQ,GAAG,CAAC,GAAW,EAAE,KAAa,EAAE,EAAE,CAC9C,GAAG,GAAG,GAAG,CAAC,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,KAAK,GAAG,UAAU,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC;AAEzD,gFAAgF;AAChF,gBAAgB;AAChB,gFAAgF;AAChF,EAAE;AACF,4CAA4C;AAC5C,EAAE;AACF,iEAAiE;AACjE,iEAAiE;AACjE,iEAAiE;AACjE,iEAAiE;AACjE,iEAAiE;AACjE,EAAE;AACF,mDAAmD;AACnD,gFAAgF;AAEhF,MAAM,UAAU,GAAG,EAAE,CAAC;AAEtB,uCAAuC;AACvC,kCAAkC;AAClC,EAAE;AACF,aAAa;AACb,MAAM,aAAa,GAAG,UAAU,GAAG,CAAC,CAAC;AAErC,MAAM,GAAG,GAAG;IACV,OAAO,EAAE,GAAG;IACZ,QAAQ,EAAE,GAAG;IACb,UAAU,EAAE,GAAG;IACf,WAAW,EAAE,GAAG;IAEhB,UAAU,EAAE,GAAG;IACf,QAAQ,EAAE,GAAG;IAEb,UAAU,EAAE,GAAG;IACf,SAAS,EAAE,GAAG;CACf,CAAC;AAEF,gFAAgF;AAChF,sBAAsB;AACtB,gFAAgF;AAEhF,SAAS,aAAa;IACpB,OAAO,CAAC,GAAG,CACT,CAAC,CACC,GAAG,GAAG,CAAC,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,QAAQ,EAAE,EACvE,MAAM,CAAC,IAAI,CACZ,CACF,CAAC;AACJ,CAAC;AAED,SAAS,gBAAgB;IACvB,OAAO,CAAC,GAAG,CACT,CAAC,CACC,GAAG,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,WAAW,EAAE,EAC7E,MAAM,CAAC,IAAI,CACZ,CACF,CAAC;AACJ,CAAC;AAED,SAAS,WAAW;IAClB,OAAO,CAAC,GAAG,CACT,CAAC,CACC,GAAG,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CAAC,UAAU,GAAG,CAAC,CAAC,GAAG,GAAG,CAAC,SAAS,EAAE,EAC3E,MAAM,CAAC,IAAI,CACZ,CACF,CAAC;AACJ,CAAC;AAED,SAAS,YAAY;IACnB,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,IAAI,CAAC,CAC/D,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,IAAI,CACZ,EAAE,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,UAAU,CAAC,KAAa;IAC/B,YAAY,EAAE,CAAC;IAEf,MAAM,UAAU,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC;IAErC,yEAAyE;IACzE,EAAE;IACF,WAAW;IACX,yBAAyB;IACzB,wBAAwB;IACxB,gBAAgB;IAChB,EAAE;IACF,4DAA4D;IAE5D,MAAM,gBAAgB,GACpB,UAAU,GAAG,UAAU,GAAG,CAAC,CAAC;IAE9B,MAAM,OAAO,GAAG,GAAG,CAAC,UAAU,CAAC,MAAM,CACnC,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,gBAAgB,CAAC,CAC9B,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,CAAC,CACC,GAAG,GAAG,CAAC,UAAU,GAAG,GAAG,CAAC,UAAU,IAAI,KAAK,IAAI,OAAO,GAAG,GAAG,CAAC,SAAS,EAAE,EACxE,MAAM,CAAC,IAAI,CACZ,CACF,CAAC;IAEF,YAAY,EAAE,CAAC;AACjB,CAAC;AAED,SAAS,OAAO,CACd,GAAW,EACX,KAAsB,EACtB,QAAQ,GAAG,EAAE;IAEb,MAAM,YAAY,GAAG,QAAQ,CAAC,GAAG,EAAE,QAAQ,CAAC,CAAC;IAE7C,MAAM,QAAQ,GAAG,aAAa,GAAG,QAAQ,GAAG,CAAC,CAAC;IAE9C,MAAM,YAAY,GAAG,QAAQ,CAC3B,MAAM,CAAC,KAAK,CAAC,EACb,IAAI,CAAC,GAAG,CAAC,CAAC,EAAE,QAAQ,CAAC,CACtB,CAAC;IAEF,MAAM,UAAU,GAAG,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAChD,MAAM,GAAG,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;IAEzC,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,UAAU,IAAI,GAAG,IAAI,YAAY,IAAI,CAAC,CACvE,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,IAAI,CACZ,EAAE,CACJ,CAAC;AACJ,CAAC;AAED,SAAS,aAAa,CAAC,KAAe;IACpC,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,EAAE;QACrB,MAAM,OAAO,GAAG,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAC1C,IAAI,EACJ,MAAM,CAAC,KAAK,CACb,EAAE,CAAC;QAEJ,MAAM,MAAM,GAAG,QAAQ,CACrB,OAAO,EACP,aAAa,CACd,CAAC;QAEF,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,MAAM,IAAI,CAAC,CAC5C,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,IAAI,CACZ,EAAE,CACJ,CAAC;IACJ,CAAC,CAAC,CAAC;AACL,CAAC;AAED,gFAAgF;AAChF,aAAa;AACb,gFAAgF;AAEhF,SAAS,SAAS;IAChB,MAAM,IAAI,GAAG;QACX,oDAAoD;QACpD,mDAAmD;QACnD,mDAAmD;QACnD,mDAAmD;QACnD,mDAAmD;QACnD,mDAAmD;KACpD,CAAC;IAEF,OAAO,CAAC,GAAG,EAAE,CAAC;IAEd,aAAa;IACb,aAAa,EAAE,CAAC;IAEhB,YAAY,EAAE,CAAC;IAEf,uBAAuB;IACvB,MAAM,KAAK,GAAG,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,KAAK,CAAC,CAAC;IAE3C,MAAM,YAAY,GAAG,IAAI,CAAC,GAAG,CAC3B,CAAC,EACD,IAAI,CAAC,KAAK,CACR,CAAC,aAAa,GAAG,UAAU,CAAC,KAAK,CAAC,CAAC,GAAG,CAAC,CACxC,CACF,CAAC;IAEF,MAAM,aAAa,GAAG,QAAQ,CAC5B,GAAG,CAAC,MAAM,CAAC,YAAY,CAAC,GAAG,KAAK,EAChC,aAAa,CACd,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,aAAa,IAAI,CAAC,CACnD,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,IAAI,CACZ,EAAE,CACJ,CAAC;IAEF,YAAY,EAAE,CAAC;IAEf,UAAU;IACV,WAAW,EAAE,CAAC;IAEd,YAAY,EAAE,CAAC;IAEf,mCAAmC;IACnC,IAAI,CAAC,OAAO,CAAC,CAAC,QAAQ,EAAE,KAAK,EAAE,EAAE;QAC/B,IAAI,KAAK,GAAG,MAAM,CAAC,MAAM,CAAC;QAE1B,IAAI,KAAK,IAAI,CAAC,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YAC7B,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;QACvB,CAAC;QAED,IAAI,KAAK,IAAI,CAAC,EAAE,CAAC;YACf,KAAK,GAAG,MAAM,CAAC,IAAI,CAAC;QACtB,CAAC;QAED,MAAM,UAAU,GAAG,QAAQ,CACzB,IAAI,GAAG,QAAQ,EACf,aAAa,CACd,CAAC;QAEF,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAClC,UAAU,EACV,KAAK,CACN,IAAI,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,EAAE,CACpC,CAAC;IACJ,CAAC,CAAC,CAAC;IAEH,YAAY,EAAE,CAAC;IAEf,qBAAqB;IACrB,MAAM,MAAM,GAAG,CAAC,CACd,8BAA8B,EAC9B,MAAM,CAAC,IAAI,CACZ,CAAC;IAEF,MAAM,aAAa,GAAG,IAAI,CAAC,GAAG,CAC5B,CAAC,EACD,IAAI,CAAC,KAAK,CACR,CAAC,aAAa,GAAG,UAAU,CAAC,MAAM,CAAC,CAAC,GAAG,CAAC,CACzC,CACF,CAAC;IAEF,MAAM,cAAc,GAAG,QAAQ,CAC7B,GAAG,CAAC,MAAM,CAAC,aAAa,CAAC,GAAG,MAAM,EAClC,aAAa,CACd,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,cAAc,IAAI,CAAC,CACpD,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,IAAI,CACZ,EAAE,CACJ,CAAC;IAEF,YAAY,EAAE,CAAC;IAEf,gBAAgB;IAChB,gBAAgB,EAAE,CAAC;AACrB,CAAC;AAED,gFAAgF;AAChF,OAAO;AACP,gFAAgF;AAEhF,MAAM,UAAU,GAAG,GAAG,EAAE,CACtB,IAAI,IAAI,EAAE,CAAC,cAAc,CAAC,OAAO,EAAE;IACjC,SAAS,EAAE,QAAQ;IACnB,SAAS,EAAE,OAAO;CACnB,CAAC,CAAA;AAsCJ,gFAAgF;AAChF,wBAAwB;AACxB,gFAAgF;AAEhF,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC,MAAc,EAAE,EAAE;IAC5C,8EAA8E;IAC9E,OAAO;IACP,8EAA8E;IAE9E,SAAS,EAAE,CAAC;IAEZ,8EAA8E;IAC9E,UAAU;IACV,8EAA8E;IAE9E,UAAU,CACR,CAAC,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAC7B,CAAC;IAEF,OAAO,CACL,QAAQ,EACR,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,CAAC,KAAK,CAAC,IAAI,CAAC,CAC1B,SAAS,EACT,MAAM,CAAC,KAAK,CACb,EAAE,CACJ,CAAC;IAEF,OAAO,CACL,aAAa,EACb,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,MAAM,CAAC,CAC7B,CAAC;IAEF,OAAO,CACL,cAAc,EACd,OAAO,CAAC,OAAO,CAChB,CAAC;IAEF,OAAO,CACL,UAAU,EACV,GAAG,EAAE,CAAC,QAAQ,EAAE,KAAK,EAAE,CAAC,IAAI,EAAE,GAAG,CAClC,CAAC;IAEF,OAAO,CACL,aAAa,EACb,OAAO,CAAC,GAAG,CACZ,CAAC;IAEF,OAAO,CACL,YAAY,EACZ,UAAU,EAAE,CACb,CAAC;IAEF,8EAA8E;IAC9E,SAAS;IACT,8EAA8E;IAE9E,UAAU,CACR,CAAC,CAAC,WAAW,EAAE,MAAM,CAAC,IAAI,CAAC,CAC5B,CAAC;IAEF,OAAO,CACL,aAAa,EACb,GAAG,MAAM,CAAC,IAAI,IAAI,MAAM,CAAC,IAAI,EAAE,CAChC,CAAC;IAEF,OAAO,CACL,UAAU,EACV,CAAC,CAAC,MAAM,CAAC,GAAG,EAAE,MAAM,CAAC,IAAI,CAAC,CAC3B,CAAC;IAEF,OAAO,CACL,YAAY,EACZ,MAAM,CAAC,SAAS,CACjB,CAAC;IAEF,OAAO,CACL,aAAa,EACb,CAAC,CACC,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,MAAM,EAAE,EAC/B,MAAM,CAAC,OAAO,CACf,CACF,CAAC;IAEF,8EAA8E;IAC9E,WAAW;IACX,8EAA8E;IAE9E,UAAU,CACR,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAC9B,CAAC;IAEF,OAAO,CACL,eAAe,EACf,GAAG,MAAM,CAAC,EAAE,CAAC,MAAM,KAAK,MAAM,CAAC,EAAE,CAAC,IAAI,GAAG,CAC1C,CAAC;IAEF,OAAO,CACL,YAAY,EACZ,MAAM,CAAC,EAAE,CAAC,SAAS;QACjB,CAAC,CAAC,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,KAAK,CAAC;QAChC,CAAC,CAAC,CAAC,CAAC,gBAAgB,EAAE,MAAM,CAAC,GAAG,CAAC,CACpC,CAAC;IAEF,OAAO,CACL,QAAQ,EACR,MAAM,CAAC,EAAE,CAAC,MAAM,CACjB,CAAC;IAEF,8EAA8E;IAC9E,mBAAmB;IACnB,8EAA8E;IAE9E,UAAU,CACR,CAAC,CAAC,kBAAkB,EAAE,MAAM,CAAC,IAAI,CAAC,CACnC,CAAC;IAEF,OAAO,CACL,QAAQ,EACR,MAAM,CAAC,SAAS,CAAC,MAAM,CACxB,CAAC;IAEF,OAAO,CACL,YAAY,EACZ,MAAM,CAAC,SAAS,CAAC,UAAU,CAC5B,CAAC;IAEF,OAAO,CACL,QAAQ,EACR,MAAM,CAAC,SAAS,CAAC,MAAM,CACxB,CAAC;IAEF,IACE,MAAM,CAAC,SAAS,CAAC,WAAW,KAAK,SAAS,EAC1C,CAAC;QACD,OAAO,CACL,aAAa,EACb,MAAM,CAAC,SAAS,CAAC,WAAW,CAC7B,CAAC;IACJ,CAAC;IAED,8EAA8E;IAC9E,WAAW;IACX,8EAA8E;IAE9E,IAAI,MAAM,CAAC,QAAQ,EAAE,MAAM,EAAE,CAAC;QAC5B,UAAU,CACR,CAAC,CAAC,aAAa,EAAE,MAAM,CAAC,IAAI,CAAC,CAC9B,CAAC;QAEF,aAAa,CAAC,MAAM,CAAC,QAAQ,CAAC,CAAC;IACjC,CAAC;IAED,8EAA8E;IAC9E,YAAY;IACZ,8EAA8E;IAE9E,IAAI,MAAM,CAAC,SAAS,EAAE,MAAM,EAAE,CAAC;QAC7B,UAAU,CACR,CAAC,CAAC,cAAc,EAAE,MAAM,CAAC,IAAI,CAAC,CAC/B,CAAC;QAEF,aAAa,CAAC,MAAM,CAAC,SAAS,CAAC,CAAC;IAClC,CAAC;IAED,8EAA8E;IAC9E,SAAS;IACT,8EAA8E;IAE9E,UAAU,CACR,CAAC,CAAC,mBAAmB,EAAE,MAAM,CAAC,IAAI,CAAC,CACpC,CAAC;IAEF,OAAO,CACL,kBAAkB,EAClB,GAAG,EAAE,CAAC,IAAI,EAAE,CAAC,MAAM,QAAQ,CAC5B,CAAC;IAEF,OAAO,CACL,SAAS,EACT,EAAE,CAAC,IAAI,EAAE,CACV,CAAC;IAEF,OAAO,CACL,UAAU,EACV,EAAE,CAAC,QAAQ,EAAE,CACd,CAAC;IAEF,8EAA8E;IAC9E,SAAS;IACT,8EAA8E;IAE9E,YAAY,EAAE,CAAC;IAEf,WAAW,EAAE,CAAC;IAEd,YAAY,EAAE,CAAC;IAEf,MAAM,UAAU,GACd,GAAG,CAAC,CACF,eAAe,EACf,MAAM,CAAC,IAAI,CACZ,IAAI,CAAC,CACJ,GAAG,MAAM,CAAC,GAAG,GAAG,MAAM,CAAC,SAAS,UAAU,EAC1C,MAAM,CAAC,IAAI,CACZ,EAAE,CAAC;IAEN,MAAM,YAAY,GAAG,QAAQ,CAC3B,GAAG,GAAG,UAAU,EAChB,aAAa,CACd,CAAC;IAEF,OAAO,CAAC,GAAG,CACT,GAAG,CAAC,CAAC,GAAG,CAAC,QAAQ,EAAE,MAAM,CAAC,IAAI,CAAC,IAAI,YAAY,IAAI,CAAC,CAClD,GAAG,CAAC,QAAQ,EACZ,MAAM,CAAC,IAAI,CACZ,EAAE,CACJ,CAAC;IAEF,YAAY,EAAE,CAAC;IAEf,gBAAgB,EAAE,CAAC;IAEnB,OAAO,CAAC,GAAG,EAAE,CAAC;AAChB,CAAC,CAAC;AAEF,eAAe,WAAW,CAAC"}

package/dist/terminal/index.d.ts

@@ -0,0 +1,2 @@
+export * from "./BannerPrinter.js";
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/terminal/index.js

@@ -0,0 +1,2 @@
+export * from "./BannerPrinter.js";
+//# sourceMappingURL=index.js.map

package/dist/terminal/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../src/terminal/index.ts"],"names":[],"mappings":"AAAA,cAAc,oBAAoB,CAAC"}

package/dist/testing/FakeOAuthServer.d.ts

@@ -0,0 +1,64 @@
+export interface FakeIdentity {
+    /** The provider's user id (`sub` for Google, numeric id for GitHub). */
+    id: string;
+    email?: string;
+    emailVerified?: boolean;
+    name?: string;
+    picture?: string;
+    /** GitHub only: the user's full e-mail list. Defaults to just `email`. */
+    emails?: Array<{
+        email: string;
+        primary: boolean;
+        verified: boolean;
+    }>;
+}
+export interface FakeRequest {
+    method: string;
+    url: string;
+    headers: Record<string, string>;
+    form?: Record<string, string>;
+}
+type Provider = "google" | "github";
+type FailTarget = "token" | "profile";
+interface Failure {
+    status?: number;
+    body?: unknown;
+    network?: boolean;
+}
+/**
+ * Stands in for Google's and GitHub's OAuth servers in tests: a `fetch` implementation that mimics
+ * their endpoints - including PKCE verification, single-use codes and each provider's own error style.
+ * Any URL it does not know throws, so a test can never talk to the real internet by accident.
+ */
+export declare class FakeOAuthServer {
+    readonly credentials: {
+        clientId: string;
+        clientSecret: string;
+    };
+    readonly requests: FakeRequest[];
+    private readonly codes;
+    private readonly accessTokens;
+    private readonly failures;
+    private counter;
+    constructor(credentials?: {
+        clientId: string;
+        clientSecret: string;
+    });
+    /** Make the next token/profile call fail (once). */
+    failNext(target: FailTarget, failure: Failure): void;
+    /** Mint a one-time authorization code, as the provider would after the user approves. */
+    issueCode(provider: Provider, identity: FakeIdentity, options?: {
+        codeChallenge?: string;
+    }): string;
+    /**
+     * "The user clicked Allow": reads the authorization URL Forge redirected to and returns the callback
+     * path (relative to the API base) the provider would send the browser to.
+     */
+    approve(authorizationUrl: string, identity: FakeIdentity, apiPrefix?: string): string;
+    fetch: typeof fetch;
+    private takeFailure;
+    private token;
+    private profile;
+}
+export {};
+//# sourceMappingURL=FakeOAuthServer.d.ts.map

package/dist/testing/FakeOAuthServer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"FakeOAuthServer.d.ts","sourceRoot":"","sources":["../../src/testing/FakeOAuthServer.ts"],"names":[],"mappings":"AAEA,MAAM,WAAW,YAAY;IAC3B,wEAAwE;IACxE,EAAE,EAAE,MAAM,CAAC;IACX,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,aAAa,CAAC,EAAE,OAAO,CAAC;IACxB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,0EAA0E;IAC1E,MAAM,CAAC,EAAE,KAAK,CAAC;QAAE,KAAK,EAAE,MAAM,CAAC;QAAC,OAAO,EAAE,OAAO,CAAC;QAAC,QAAQ,EAAE,OAAO,CAAA;KAAE,CAAC,CAAC;CACxE;AAED,MAAM,WAAW,WAAW;IAC1B,MAAM,EAAE,MAAM,CAAC;IACf,GAAG,EAAE,MAAM,CAAC;IACZ,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAChC,IAAI,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CAC/B;AAED,KAAK,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAC;AAMpC,KAAK,UAAU,GAAG,OAAO,GAAG,SAAS,CAAC;AACtC,UAAU,OAAO;IACf,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,OAAO,CAAC;IACf,OAAO,CAAC,EAAE,OAAO,CAAC;CACnB;AAKD;;;;GAIG;AACH,qBAAa,eAAe;IAOd,QAAQ,CAAC,WAAW;QAAK,QAAQ;QAAoB,YAAY;;IAN7E,QAAQ,CAAC,QAAQ,EAAE,WAAW,EAAE,CAAM;IACtC,OAAO,CAAC,QAAQ,CAAC,KAAK,CAAiC;IACvD,OAAO,CAAC,QAAQ,CAAC,YAAY,CAAiC;IAC9D,OAAO,CAAC,QAAQ,CAAC,QAAQ,CAAkC;IAC3D,OAAO,CAAC,OAAO,CAAK;IAEpB,YAAqB,WAAW;QAAK,QAAQ;QAAoB,YAAY;KAAwB,EAAI;IAEzG,oDAAoD;IACpD,QAAQ,CAAC,MAAM,EAAE,UAAU,EAAE,OAAO,EAAE,OAAO,GAAG,IAAI,CAEnD;IAED,yFAAyF;IACzF,SAAS,CAAC,QAAQ,EAAE,QAAQ,EAAE,QAAQ,EAAE,YAAY,EAAE,OAAO,GAAE;QAAE,aAAa,CAAC,EAAE,MAAM,CAAA;KAAO,GAAG,MAAM,CAItG;IAED;;;OAGG;IACH,OAAO,CAAC,gBAAgB,EAAE,MAAM,EAAE,QAAQ,EAAE,YAAY,EAAE,SAAS,SAAY,GAAG,MAAM,CAQvF;IAED,KAAK,EAAE,OAAO,KAAK,CAoCjB;IAEF,OAAO,CAAC,WAAW;IAQnB,OAAO,CAAC,KAAK;IAsBb,OAAO,CAAC,OAAO;CAQhB"}