@buenojs/bueno 0.8.10 → 0.8.11

package/dist/security/index.js

@@ -0,0 +1,309 @@
+/**
+ * Security Primitives
+ *
+ * Provides password hashing, JWT handling, CSRF protection,
+ * and authentication middleware using Bun's built-in capabilities.
+ */
+export const Password = {
+    /**
+     * Hash a password using Bun's built-in password hashing
+     */
+    async hash(password, options) {
+        const algorithm = options?.algorithm ?? "argon2id";
+        // Bun.password.hash returns a string hash
+        return Bun.password.hash(password, {
+            algorithm,
+        });
+    },
+    /**
+     * Verify a password against a hash
+     */
+    async verify(password, hash) {
+        return Bun.password.verify(password, hash);
+    },
+    /**
+     * Check if a hash needs rehashing (e.g., algorithm upgrade)
+     */
+    needsRehash(hash, options) {
+        const algorithm = options?.algorithm ?? "argon2id";
+        // Check if needsRehash exists on Bun.password (it may not in all versions)
+        if (typeof Bun.password
+            .needsRehash === "function") {
+            const needsRehashFn = Bun.password
+                .needsRehash;
+            return !needsRehashFn(hash, { algorithm });
+        }
+        // Fallback: check if hash starts with the expected algorithm prefix
+        if (algorithm === "argon2id" && !hash.startsWith("$argon2id")) {
+            return true;
+        }
+        if (algorithm === "bcrypt" && !hash.startsWith("$2")) {
+            return true;
+        }
+        return false;
+    },
+};
+export class JWT {
+    secret;
+    options;
+    constructor(secret, options = {}) {
+        this.secret = secret;
+        this.options = options;
+    }
+    /**
+     * Sign a payload and create a JWT
+     */
+    async sign(payload) {
+        const now = Math.floor(Date.now() / 1000);
+        const fullPayload = {
+            ...payload,
+            iat: now,
+        };
+        // Add expiry
+        if (this.options.expiresIn) {
+            if (typeof this.options.expiresIn === "number") {
+                fullPayload.exp = now + this.options.expiresIn;
+            }
+            else {
+                // Parse string like '1h', '7d'
+                fullPayload.exp = now + this.parseExpiry(this.options.expiresIn);
+            }
+        }
+        // Add issuer
+        if (this.options.issuer) {
+            fullPayload.iss = this.options.issuer;
+        }
+        // Add audience
+        if (this.options.audience) {
+            fullPayload.aud = this.options.audience;
+        }
+        // Create JWT using Bun's JWT support or fallback to manual creation
+        return this.createToken(fullPayload);
+    }
+    /**
+     * Verify and decode a JWT
+     */
+    async verify(token) {
+        try {
+            const payload = await this.decodeToken(token);
+            if (!payload) {
+                return null;
+            }
+            // Check expiry
+            if (payload.exp && payload.exp < Math.floor(Date.now() / 1000)) {
+                return null;
+            }
+            return payload;
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Decode token without verification (for debugging)
+     */
+    decode(token) {
+        try {
+            return this.decodeTokenUnsafe(token);
+        }
+        catch {
+            return null;
+        }
+    }
+    /**
+     * Parse expiry string to seconds
+     */
+    parseExpiry(expiresIn) {
+        const match = expiresIn.match(/^(\d+)([smhd])$/);
+        if (!match) {
+            throw new Error(`Invalid expiresIn format: ${expiresIn}`);
+        }
+        const value = Number.parseInt(match[1], 10);
+        const unit = match[2];
+        switch (unit) {
+            case "s":
+                return value;
+            case "m":
+                return value * 60;
+            case "h":
+                return value * 60 * 60;
+            case "d":
+                return value * 60 * 60 * 24;
+            default:
+                throw new Error(`Unknown time unit: ${unit}`);
+        }
+    }
+    /**
+     * Create JWT token manually
+     */
+    async createToken(payload) {
+        const header = { alg: "HS256", typ: "JWT" };
+        const encoder = new TextEncoder();
+        const headerB64 = this.base64UrlEncode(encoder.encode(JSON.stringify(header)));
+        const payloadB64 = this.base64UrlEncode(encoder.encode(JSON.stringify(payload)));
+        const data = `${headerB64}.${payloadB64}`;
+        const signature = await this.signData(data);
+        return `${data}.${signature}`;
+    }
+    /**
+     * Decode and verify token
+     */
+    async decodeToken(token) {
+        const parts = token.split(".");
+        if (parts.length !== 3) {
+            return null;
+        }
+        const [headerB64, payloadB64, signature] = parts;
+        const data = `${headerB64}.${payloadB64}`;
+        // Verify signature
+        const expectedSignature = await this.signData(data);
+        if (signature !== expectedSignature) {
+            return null;
+        }
+        // Decode payload
+        return this.base64UrlDecode(payloadB64);
+    }
+    /**
+     * Decode token without verification
+     */
+    decodeTokenUnsafe(token) {
+        const parts = token.split(".");
+        if (parts.length !== 3) {
+            return null;
+        }
+        return this.base64UrlDecode(parts[1]);
+    }
+    /**
+     * Sign data using HMAC-SHA256
+     */
+    async signData(data) {
+        const encoder = new TextEncoder();
+        const key = await crypto.subtle.importKey("raw", encoder.encode(this.secret), { name: "HMAC", hash: "SHA-256" }, false, ["sign"]);
+        const signature = await crypto.subtle.sign("HMAC", key, encoder.encode(data));
+        return this.base64UrlEncode(new Uint8Array(signature));
+    }
+    /**
+     * Base64URL encode
+     */
+    base64UrlEncode(data) {
+        const base64 = btoa(String.fromCharCode(...data));
+        return base64.replace(/\+/g, "-").replace(/\//g, "_").replace(/=/g, "");
+    }
+    /**
+     * Base64URL decode
+     */
+    base64UrlDecode(data) {
+        const base64 = data.replace(/-/g, "+").replace(/_/g, "/");
+        const padded = base64 + "=".repeat((4 - (base64.length % 4)) % 4);
+        const decoded = atob(padded);
+        return JSON.parse(decoded);
+    }
+}
+// ============= CSRF Protection =============
+export const CSRF = {
+    /**
+     * Generate a CSRF token
+     */
+    generate() {
+        return crypto.randomUUID();
+    },
+    /**
+     * Get the secret for a token (for cookie-based validation)
+     */
+    getSecret() {
+        return crypto.randomUUID();
+    },
+    /**
+     * Verify a CSRF token against a secret
+     */
+    verify(token, secret) {
+        // Simple comparison - in production, use constant-time comparison
+        return token === secret;
+    },
+    /**
+     * Create CSRF middleware
+     */
+    middleware() {
+        return async (context, next) => {
+            // Skip for safe methods
+            if (["GET", "HEAD", "OPTIONS"].includes(context.method)) {
+                return next();
+            }
+            const token = context.getHeader("x-csrf-token");
+            const cookieToken = context.getCookie("csrf-token");
+            if (!token || !cookieToken || token !== cookieToken) {
+                return context.status(403).json({ error: "Invalid CSRF token" });
+            }
+            return next();
+        };
+    },
+};
+/**
+ * Create authentication middleware
+ */
+export function createAuthMiddleware(options) {
+    const { jwt, header = "authorization", prefix = "Bearer ", skipPaths = [], } = options;
+    return async (context, next) => {
+        // Skip certain paths
+        if (skipPaths.some((path) => context.path.startsWith(path))) {
+            return next();
+        }
+        const authHeader = context.getHeader(header);
+        if (!authHeader) {
+            return context
+                .status(401)
+                .json({ error: "Missing authorization header" });
+        }
+        if (!authHeader.startsWith(prefix)) {
+            return context
+                .status(401)
+                .json({ error: "Invalid authorization format" });
+        }
+        const token = authHeader.slice(prefix.length);
+        const payload = await jwt.verify(token);
+        if (!payload) {
+            return context.status(401).json({ error: "Invalid or expired token" });
+        }
+        // Store user in context
+        context.set("user", payload);
+        return next();
+    };
+}
+/**
+ * Create RBAC middleware
+ */
+export function createRBACMiddleware(options) {
+    const { getUserRoles } = options;
+    return (allowedRoles) => {
+        return async (context, next) => {
+            const user = context.get("user");
+            if (!user?.userId) {
+                return context.status(401).json({ error: "Unauthorized" });
+            }
+            const userRoles = await getUserRoles(user.userId);
+            const hasRole = allowedRoles.some((role) => userRoles.includes(role));
+            if (!hasRole) {
+                return context.status(403).json({ error: "Forbidden" });
+            }
+            return next();
+        };
+    };
+}
+/**
+ * Create API key authentication middleware
+ */
+export function createAPIKeyMiddleware(options) {
+    const { validateKey, header = "x-api-key" } = options;
+    return async (context, next) => {
+        const apiKey = context.getHeader(header);
+        if (!apiKey) {
+            return context.status(401).json({ error: "Missing API key" });
+        }
+        const isValid = await validateKey(apiKey);
+        if (!isValid) {
+            return context.status(401).json({ error: "Invalid API key" });
+        }
+        return next();
+    };
+}
+//# 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":"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"}

package/dist/ssg/index.d.ts

@@ -0,0 +1,73 @@
+/**
+ * Static Site Generation (SSG) Module
+ *
+ * Provides markdown-to-HTML conversion with frontmatter support,
+ * template system, and static site generation capabilities.
+ */
+import { Router } from "../router";
+export interface Frontmatter {
+    title?: string;
+    description?: string;
+    layout?: string;
+    date?: string;
+    slug?: string;
+    [key: string]: unknown;
+}
+export interface Page {
+    path: string;
+    content: string;
+    html: string;
+    frontmatter: Frontmatter;
+    raw: string;
+}
+export interface SSGConfig {
+    contentDir: string;
+    outputDir: string;
+    publicDir?: string;
+    layoutsDir?: string;
+    defaultLayout?: string;
+    baseUrl?: string;
+    minify?: boolean;
+}
+export interface LayoutContext {
+    title?: string;
+    description?: string;
+    content: string;
+    page: Page;
+    site: SiteConfig;
+    [key: string]: unknown;
+}
+export interface SiteConfig {
+    title: string;
+    description: string;
+    baseUrl: string;
+    [key: string]: unknown;
+}
+declare function parseFrontmatter(content: string): {
+    frontmatter: Frontmatter;
+    body: string;
+};
+declare function parseMarkdown(markdown: string): string;
+export declare class SSG {
+    private config;
+    private pages;
+    private layouts;
+    private siteConfig;
+    private router;
+    constructor(config: SSGConfig, siteConfig?: Partial<SiteConfig>);
+    private registerDefaultLayouts;
+    registerLayout(name: string, render: (ctx: LayoutContext) => string): void;
+    loadContent(): Promise<void>;
+    private scanDirectory;
+    private processFile;
+    renderPage(page: Page): string;
+    build(): Promise<void>;
+    private copyPublicDir;
+    createRouter(): Router;
+    serve(port?: number): Promise<void>;
+    getPages(): Page[];
+    getPage(path: string): Page | undefined;
+}
+export declare function createSSG(config: SSGConfig, siteConfig?: Partial<SiteConfig>): SSG;
+export { parseMarkdown, parseFrontmatter };
+//# sourceMappingURL=index.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../src/ssg/index.ts"],"names":[],"mappings":"AAAA;;;;;GAKG;AAGH,OAAO,EAAE,MAAM,EAAE,MAAM,WAAW,CAAC;AAEnC,MAAM,WAAW,WAAW;IAC3B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,IAAI;IACpB,IAAI,EAAE,MAAM,CAAC;IACb,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,MAAM,CAAC;IACb,WAAW,EAAE,WAAW,CAAC;IACzB,GAAG,EAAE,MAAM,CAAC;CACZ;AAED,MAAM,WAAW,SAAS;IACzB,UAAU,EAAE,MAAM,CAAC;IACnB,SAAS,EAAE,MAAM,CAAC;IAClB,SAAS,CAAC,EAAE,MAAM,CAAC;IACnB,UAAU,CAAC,EAAE,MAAM,CAAC;IACpB,aAAa,CAAC,EAAE,MAAM,CAAC;IACvB,OAAO,CAAC,EAAE,MAAM,CAAC;IACjB,MAAM,CAAC,EAAE,OAAO,CAAC;CACjB;AAED,MAAM,WAAW,aAAa;IAC7B,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,OAAO,EAAE,MAAM,CAAC;IAChB,IAAI,EAAE,IAAI,CAAC;IACX,IAAI,EAAE,UAAU,CAAC;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAED,MAAM,WAAW,UAAU;IAC1B,KAAK,EAAE,MAAM,CAAC;IACd,WAAW,EAAE,MAAM,CAAC;IACpB,OAAO,EAAE,MAAM,CAAC;IAChB,CAAC,GAAG,EAAE,MAAM,GAAG,OAAO,CAAC;CACvB;AAkBD,iBAAS,gBAAgB,CAAC,OAAO,EAAE,MAAM,GAAG;IAC3C,WAAW,EAAE,WAAW,CAAC;IACzB,IAAI,EAAE,MAAM,CAAC;CACb,CAqCA;AA6FD,iBAAS,aAAa,CAAC,QAAQ,EAAE,MAAM,GAAG,MAAM,CAsI/C;AAED,qBAAa,GAAG;IACf,OAAO,CAAC,MAAM,CAAY;IAC1B,OAAO,CAAC,KAAK,CAAgC;IAC7C,OAAO,CAAC,OAAO,CAA0D;IACzE,OAAO,CAAC,UAAU,CAAa;IAC/B,OAAO,CAAC,MAAM,CAAS;gBAEX,MAAM,EAAE,SAAS,EAAE,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC;IAa/D,OAAO,CAAC,sBAAsB;IAiE9B,cAAc,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC,GAAG,EAAE,aAAa,KAAK,MAAM,GAAG,IAAI;IAIpE,WAAW,IAAI,OAAO,CAAC,IAAI,CAAC;YAiBpB,aAAa;YAYb,WAAW;IAiCzB,UAAU,CAAC,IAAI,EAAE,IAAI,GAAG,MAAM;IAyBxB,KAAK,IAAI,OAAO,CAAC,IAAI,CAAC;YA4Bd,aAAa;IAqB3B,YAAY,IAAI,MAAM;IAyBhB,KAAK,CAAC,IAAI,SAAO,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BvC,QAAQ,IAAI,IAAI,EAAE;IAIlB,OAAO,CAAC,IAAI,EAAE,MAAM,GAAG,IAAI,GAAG,SAAS;CAGvC;AAED,wBAAgB,SAAS,CACxB,MAAM,EAAE,SAAS,EACjB,UAAU,CAAC,EAAE,OAAO,CAAC,UAAU,CAAC,GAC9B,GAAG,CAEL;AAED,OAAO,EAAE,aAAa,EAAE,gBAAgB,EAAE,CAAC"}