@rebasepro/server-core 0.0.1-canary.09e5ec5

package/src/email/smtp-email-service.ts

@@ -0,0 +1,91 @@
+import { createTransport, Transporter } from "nodemailer";
+import { EmailService, EmailSendOptions, EmailConfig } from "./types";
+
+/**
+ * SMTP Email Service implementation using Nodemailer
+ */
+export class SMTPEmailService implements EmailService {
+    private transporter: Transporter | null = null;
+    private config: EmailConfig;
+
+    constructor(config: EmailConfig) {
+        this.config = config;
+
+        if (config.smtp) {
+            this.transporter = createTransport({
+                host: config.smtp.host,
+                port: config.smtp.port,
+                secure: config.smtp.secure ?? (config.smtp.port === 465),
+                auth: config.smtp.auth ? {
+                    user: config.smtp.auth.user,
+                    pass: config.smtp.auth.pass
+                } : undefined
+            });
+        }
+    }
+
+    /**
+     * Check if the email service is properly configured
+     */
+    isConfigured(): boolean {
+        return !!(this.transporter || this.config.sendEmail);
+    }
+
+    /**
+     * Send an email using SMTP or custom send function
+     */
+    async send(options: EmailSendOptions): Promise<void> {
+        // Use custom send function if provided
+        if (this.config.sendEmail) {
+            await this.config.sendEmail(options);
+            return;
+        }
+
+        // Use SMTP transporter
+        if (!this.transporter) {
+            throw new Error("Email service not configured. Provide SMTP config or sendEmail function.");
+        }
+
+        const to = Array.isArray(options.to) ? options.to.join(", ") : options.to;
+
+        try {
+            await this.transporter.sendMail({
+                from: this.config.from,
+                to,
+                subject: options.subject,
+                html: options.html,
+                text: options.text,
+                replyTo: options.replyTo
+            });
+        } catch (error: unknown) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error("Failed to send email:", message);
+            throw new Error(`Failed to send email: ${message}`);
+        }
+    }
+
+    /**
+     * Verify SMTP connection (useful for startup checks)
+     */
+    async verifyConnection(): Promise<boolean> {
+        if (!this.transporter) {
+            return !!this.config.sendEmail;
+        }
+
+        try {
+            await this.transporter.verify();
+            return true;
+        } catch (error: unknown) {
+            const message = error instanceof Error ? error.message : String(error);
+            console.error("SMTP connection verification failed:", message);
+            return false;
+        }
+    }
+}
+
+/**
+ * Create an email service from configuration
+ */
+export function createEmailService(config: EmailConfig): EmailService {
+    return new SMTPEmailService(config);
+}

package/src/email/templates.ts

@@ -0,0 +1,388 @@
+/**
+ * Default email templates for authentication emails
+ */
+
+interface TemplateUser {
+    email: string;
+    displayName?: string | null;
+}
+
+/**
+ * Get a greeting name for the user
+ */
+function getGreeting(user: TemplateUser): string {
+    return user.displayName || user.email.split("@")[0];
+}
+
+/**
+ * Common email styles
+ */
+const styles = {
+    container: `
+        font-family: -apple-system, BlinkMacSystemFont, 'Segoe UI', Roboto, 'Helvetica Neue', Arial, sans-serif;
+        max-width: 600px;
+        margin: 0 auto;
+        padding: 40px 20px;
+        background-color: #f8fafc;
+    `,
+    card: `
+        background-color: #ffffff;
+        border-radius: 12px;
+        padding: 40px;
+        box-shadow: 0 4px 6px -1px rgba(0, 0, 0, 0.1);
+    `,
+    heading: `
+        color: #1e293b;
+        font-size: 24px;
+        font-weight: 600;
+        margin: 0 0 20px 0;
+    `,
+    paragraph: `
+        color: #475569;
+        font-size: 16px;
+        line-height: 1.6;
+        margin: 0 0 20px 0;
+    `,
+    button: `
+        display: inline-block;
+        background-color: #3b82f6;
+        color: #ffffff;
+        font-size: 16px;
+        font-weight: 600;
+        text-decoration: none;
+        padding: 14px 28px;
+        border-radius: 8px;
+        margin: 20px 0;
+    `,
+    footer: `
+        color: #94a3b8;
+        font-size: 14px;
+        margin-top: 30px;
+        padding-top: 20px;
+        border-top: 1px solid #e2e8f0;
+    `,
+    warning: `
+        color: #64748b;
+        font-size: 14px;
+        background-color: #fef3c7;
+        padding: 12px 16px;
+        border-radius: 6px;
+        margin-top: 20px;
+    `
+};
+
+/**
+ * Default password reset email template
+ */
+export function getPasswordResetTemplate(
+    resetUrl: string,
+    user: TemplateUser,
+    appName = "Rebase"
+): { subject: string; html: string; text: string } {
+    const greeting = getGreeting(user);
+
+    const subject = `Reset your ${appName} password`;
+
+    const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${subject}</title>
+</head>
+<body style="margin: 0; padding: 0; background-color: #f8fafc;">
+    <div style="${styles.container}">
+        <div style="${styles.card}">
+            <h1 style="${styles.heading}">Reset Your Password</h1>
+            
+            <p style="${styles.paragraph}">
+                Hi ${greeting},
+            </p>
+            
+            <p style="${styles.paragraph}">
+                We received a request to reset your password for your ${appName} account. 
+                Click the button below to create a new password:
+            </p>
+            
+            <div style="text-align: center;">
+                <a href="${resetUrl}" style="${styles.button}">Reset Password</a>
+            </div>
+            
+            <p style="${styles.paragraph}">
+                Or copy and paste this link into your browser:
+            </p>
+            <p style="color: #3b82f6; word-break: break-all; font-size: 14px;">
+                ${resetUrl}
+            </p>
+            
+            <div style="${styles.warning}">
+                ⏰ This link will expire in 1 hour for security reasons.
+            </div>
+            
+            <div style="${styles.footer}">
+                <p style="margin: 0;">
+                    If you didn't request a password reset, you can safely ignore this email. 
+                    Your password will remain unchanged.
+                </p>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
+    `.trim();
+
+    const text = `
+Reset Your Password
+
+Hi ${greeting},
+
+We received a request to reset your password for your ${appName} account.
+
+Click this link to create a new password:
+${resetUrl}
+
+This link will expire in 1 hour for security reasons.
+
+If you didn't request a password reset, you can safely ignore this email.
+Your password will remain unchanged.
+    `.trim();
+
+    return { subject,
+html,
+text };
+}
+
+/**
+ * Default email verification template
+ */
+export function getEmailVerificationTemplate(
+    verifyUrl: string,
+    user: TemplateUser,
+    appName = "Rebase"
+): { subject: string; html: string; text: string } {
+    const greeting = getGreeting(user);
+
+    const subject = `Verify your ${appName} email address`;
+
+    const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${subject}</title>
+</head>
+<body style="margin: 0; padding: 0; background-color: #f8fafc;">
+    <div style="${styles.container}">
+        <div style="${styles.card}">
+            <h1 style="${styles.heading}">Verify Your Email</h1>
+            
+            <p style="${styles.paragraph}">
+                Hi ${greeting},
+            </p>
+            
+            <p style="${styles.paragraph}">
+                Thanks for signing up for ${appName}! Please verify your email address 
+                by clicking the button below:
+            </p>
+            
+            <div style="text-align: center;">
+                <a href="${verifyUrl}" style="${styles.button}">Verify Email Address</a>
+            </div>
+            
+            <p style="${styles.paragraph}">
+                Or copy and paste this link into your browser:
+            </p>
+            <p style="color: #3b82f6; word-break: break-all; font-size: 14px;">
+                ${verifyUrl}
+            </p>
+            
+            <div style="${styles.footer}">
+                <p style="margin: 0;">
+                    If you didn't create an account with ${appName}, you can safely ignore this email.
+                </p>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
+    `.trim();
+
+    const text = `
+Verify Your Email
+
+Hi ${greeting},
+
+Thanks for signing up for ${appName}! Please verify your email address by clicking this link:
+${verifyUrl}
+
+If you didn't create an account with ${appName}, you can safely ignore this email.
+    `.trim();
+
+    return { subject,
+html,
+text };
+}
+
+/**
+ * Default user invitation email template
+ * Sent when an admin creates a new user account
+ */
+export function getUserInvitationTemplate(
+    setPasswordUrl: string,
+    user: TemplateUser,
+    appName = "Rebase"
+): { subject: string; html: string; text: string } {
+    const greeting = getGreeting(user);
+
+    const subject = `You've been invited to ${appName}`;
+
+    const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${subject}</title>
+</head>
+<body style="margin: 0; padding: 0; background-color: #f8fafc;">
+    <div style="${styles.container}">
+        <div style="${styles.card}">
+            <h1 style="${styles.heading}">Welcome to ${appName}!</h1>
+            
+            <p style="${styles.paragraph}">
+                Hi ${greeting},
+            </p>
+            
+            <p style="${styles.paragraph}">
+                An account has been created for you on ${appName}. 
+                Click the button below to set your password and get started:
+            </p>
+            
+            <div style="text-align: center;">
+                <a href="${setPasswordUrl}" style="${styles.button}">Set Your Password</a>
+            </div>
+            
+            <p style="${styles.paragraph}">
+                Or copy and paste this link into your browser:
+            </p>
+            <p style="color: #3b82f6; word-break: break-all; font-size: 14px;">
+                ${setPasswordUrl}
+            </p>
+            
+            <div style="${styles.warning}">
+                ⏰ This link will expire in 1 hour for security reasons.
+            </div>
+            
+            <div style="${styles.footer}">
+                <p style="margin: 0;">
+                    If you weren't expecting this invitation, you can safely ignore this email.
+                </p>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
+    `.trim();
+
+    const text = `
+Welcome to ${appName}!
+
+Hi ${greeting},
+
+An account has been created for you on ${appName}.
+
+Click this link to set your password and get started:
+${setPasswordUrl}
+
+This link will expire in 1 hour for security reasons.
+
+If you weren't expecting this invitation, you can safely ignore this email.
+    `.trim();
+
+    return { subject,
+html,
+text };
+}
+
+/**
+ * Default welcome email template
+ * Sent automatically when a new user registers
+ */
+export function getWelcomeEmailTemplate(
+    user: TemplateUser,
+    appName = "Rebase",
+    loginUrl?: string
+): { subject: string; html: string; text: string } {
+    const greeting = getGreeting(user);
+    const url = loginUrl || "";
+
+    const subject = `¡Bienvenido/a a ${appName}!`;
+
+    const html = `
+<!DOCTYPE html>
+<html>
+<head>
+    <meta charset="utf-8">
+    <meta name="viewport" content="width=device-width, initial-scale=1.0">
+    <title>${subject}</title>
+</head>
+<body style="margin: 0; padding: 0; background-color: #f8fafc;">
+    <div style="${styles.container}">
+        <div style="${styles.card}">
+            <h1 style="${styles.heading}">¡Bienvenido/a a ${appName}!</h1>
+            
+            <p style="${styles.paragraph}">
+                Hola ${greeting},
+            </p>
+            
+            <p style="${styles.paragraph}">
+                Tu cuenta en ${appName} ha sido creada exitosamente. 
+                Estamos encantados de tenerte con nosotros.
+            </p>
+            
+            <p style="${styles.paragraph}">
+                Ya puedes acceder a tu panel y empezar a explorar todas las oportunidades 
+                que tenemos para ti.
+            </p>
+
+            ${url ? `
+            <div style="text-align: center;">
+                <a href="${url}" style="${styles.button}">Ir a mi Panel</a>
+            </div>
+            ` : ""}
+            
+            <p style="${styles.paragraph}">
+                Si tienes alguna pregunta, no dudes en contactarnos respondiendo a este correo.
+            </p>
+            
+            <div style="${styles.footer}">
+                <p style="margin: 0;">
+                    Este correo fue enviado porque se creó una cuenta con esta dirección de email en ${appName}.
+                </p>
+            </div>
+        </div>
+    </div>
+</body>
+</html>
+    `.trim();
+
+    const text = `
+¡Bienvenido/a a ${appName}!
+
+Hola ${greeting},
+
+Tu cuenta en ${appName} ha sido creada exitosamente. Estamos encantados de tenerte con nosotros.
+
+Ya puedes acceder a tu panel y empezar a explorar todas las oportunidades que tenemos para ti.
+
+${url ? `Ir a mi panel: ${url}` : ""}
+
+Si tienes alguna pregunta, no dudes en contactarnos respondiendo a este correo.
+    `.trim();
+
+    return { subject,
+html,
+text };
+}

package/src/email/types.ts

@@ -0,0 +1,105 @@
+/**
+ * Email service types and interfaces.
+ *
+ * The canonical `EmailService` and `EmailSendOptions` live in `@rebasepro/types`
+ * so they can be used on the `RebaseClient` interface without pulling in nodemailer.
+ * This file re-exports them for backward compatibility and adds server-specific
+ * config types (SMTP, template functions, etc.).
+ */
+
+import type { EmailService, EmailSendOptions } from "@rebasepro/types";
+
+export type { EmailService, EmailSendOptions };
+
+/**
+ * SMTP server configuration
+ */
+export interface SMTPConfig {
+    host: string;
+    port: number;
+    secure?: boolean;
+    auth?: {
+        user: string;
+        pass: string;
+    };
+}
+
+/**
+ * Template function for password reset emails
+ */
+export type PasswordResetTemplateFunction = (
+    resetUrl: string,
+    user: { email: string; displayName?: string | null }
+) => { subject: string; html: string; text?: string };
+
+/**
+ * Template function for email verification emails
+ */
+export type EmailVerificationTemplateFunction = (
+    verifyUrl: string,
+    user: { email: string; displayName?: string | null }
+) => { subject: string; html: string; text?: string };
+
+/**
+ * Template function for user invitation emails
+ */
+export type UserInvitationTemplateFunction = (
+    setPasswordUrl: string,
+    user: { email: string; displayName?: string | null }
+) => { subject: string; html: string; text?: string };
+
+/**
+ * Template function for welcome emails sent after registration
+ */
+export type WelcomeEmailTemplateFunction = (
+    user: { email: string; displayName?: string | null },
+    appName: string
+) => { subject: string; html: string; text?: string };
+
+/**
+ * Complete email configuration
+ */
+export interface EmailConfig {
+    /**
+     * From address for all emails (e.g., "noreply@example.com" or "MyApp <noreply@example.com>")
+     */
+    from: string;
+
+    /**
+     * SMTP configuration for sending emails via SMTP server
+     */
+    smtp?: SMTPConfig;
+
+    /**
+     * Alternative: custom function to send emails
+     * Use this for custom email providers (AWS SES SDK, Resend, etc.)
+     */
+    sendEmail?: (options: EmailSendOptions) => Promise<void>;
+
+    /**
+     * Base URL for password reset links (e.g., "https://myapp.com")
+     * The reset link will be: {baseUrl}/reset-password?token={token}
+     */
+    resetPasswordUrl?: string;
+
+    /**
+     * Base URL for email verification links (e.g., "https://myapp.com")
+     * The verification link will be: {baseUrl}/verify-email?token={token}
+     */
+    verifyEmailUrl?: string;
+
+    /**
+     * Application name to use in email templates
+     */
+    appName?: string;
+
+    /**
+     * Custom email templates (optional - defaults are provided)
+     */
+    templates?: {
+        passwordReset?: PasswordResetTemplateFunction;
+        emailVerification?: EmailVerificationTemplateFunction;
+        userInvitation?: UserInvitationTemplateFunction;
+        welcomeEmail?: WelcomeEmailTemplateFunction;
+    };
+}

package/src/functions/function-loader.ts

@@ -0,0 +1,119 @@
+import * as fs from "fs";
+import * as path from "path";
+import { pathToFileURL } from "url";
+import { Hono } from "hono";
+
+export interface LoadedFunction {
+    /** Endpoint name derived from filename (e.g., "send-invoice") */
+    name: string;
+    /** The Hono sub-app to mount */
+    app: Hono<import("hono").Env>;
+}
+
+/**
+ * Auto-discover Hono route files from a directory.
+ *
+ * Each file should default-export a Hono app (or router).
+ * The filename (without extension) becomes the mount path:
+ *   `functions/send-invoice.ts` → mounted at `/send-invoice`
+ *
+ * This mirrors how `loadCollectionsFromDirectory` works for collections.
+ */
+export async function loadFunctionsFromDirectory(
+    directory: string
+): Promise<LoadedFunction[]> {
+    const functions: LoadedFunction[] = [];
+
+    if (!fs.existsSync(directory)) {
+        return functions;
+    }
+
+    const files = fs.readdirSync(directory);
+    for (const file of files) {
+        if (
+            (file.endsWith(".ts") || file.endsWith(".js")) &&
+            !file.includes(".test.") &&
+            !file.endsWith(".d.ts") &&
+            file !== "index.ts" &&
+            file !== "index.js"
+        ) {
+            const filePath = path.join(directory, file);
+            try {
+                const fileUrl = pathToFileURL(filePath).href;
+
+                // Use new Function to compile dynamic import natively and bypass
+                // tsc converting import() to require() — same pattern as collection loader
+                const dynamicImport = new Function("url", "return import(url)");
+                const mod = await dynamicImport(fileUrl);
+
+                const exported = mod.default;
+
+                if (!exported) {
+                    console.warn(
+                        `[functions] ${file}: no default export. Skipping.`
+                    );
+                    continue;
+                }
+
+                // Accept a Hono instance — use duck-typing to handle different
+                // Hono versions which may not share the same prototype.
+                if (isHonoLike(exported)) {
+                    const name = path.basename(file, path.extname(file));
+                    functions.push({ name,
+app: exported as Hono });
+                    console.log(`⚡ Loaded function route: ${name}`);
+                    continue;
+                }
+
+                // Also accept a factory function that returns a Hono instance
+                if (typeof exported === "function") {
+                    const result = exported();
+                    if (isHonoLike(result)) {
+                        const name = path.basename(file, path.extname(file));
+                        functions.push({ name,
+app: result as Hono });
+                        console.log(`⚡ Loaded function route: ${name}`);
+                        continue;
+                    }
+                }
+
+                // Provide actionable diagnostics
+                const exportType = typeof exported;
+                const keys = exported && typeof exported === "object"
+                    ? Object.getOwnPropertyNames(Object.getPrototypeOf(exported)).slice(0, 10).join(", ")
+                    : "N/A";
+                console.warn(
+                    `[functions] ${file}: default export is not a Hono app or factory. Skipping.\n` +
+                    `  export type: ${exportType}${exported?.constructor?.name ? ` (${exported.constructor.name})` : ""}\n` +
+                    `  prototype methods: ${keys}\n` +
+                    "  Hint: ensure the function exports a Hono app created with the same hono version as the server.\n" +
+                    "  The loader checks for .fetch() and .routes — any Hono-compatible app will work."
+                );
+            } catch (err: unknown) {
+                const message =
+                    err instanceof Error ? err.message : String(err);
+                console.error(
+                    `[functions] Failed to load ${file}: ${message}`
+                );
+            }
+        }
+    }
+
+    return functions;
+}
+
+/**
+ * Duck-type check for Hono apps.
+ * We avoid `instanceof Hono` because different Hono versions
+ * installed in the user's project vs. our dependencies will
+ * not share the same prototype, causing false negatives.
+ */
+function isHonoLike(obj: unknown): boolean {
+    if (!obj || typeof obj !== "object") return false;
+    // Hono instances always have .fetch() and .routes
+    const record = obj as Record<string, unknown>;
+    return (
+        typeof record.fetch === "function" &&
+        Array.isArray(record.routes)
+    );
+}