@rebasepro/server-core 0.0.1-canary.4d4fb3e

package/src/bootstrappers/index.ts

@@ -0,0 +1 @@
+// PostgresBootstrapper was moved to @rebasepro/server-postgresql

package/src/collections/BackendCollectionRegistry.ts

@@ -0,0 +1,20 @@
+import { CollectionRegistry } from "@rebasepro/common";
+import { CollectionRegistryInterface } from "../db/interfaces";
+import { EntityCollection } from "@rebasepro/types";
+
+/**
+ * Backend-agnostic collection registry.
+ * Satisfies CollectionRegistryInterface through inheritance from CollectionRegistry.
+ */
+export class BackendCollectionRegistry extends CollectionRegistry implements CollectionRegistryInterface {
+
+    /**
+     * Get the available relation keys for a given collection path.
+     * Maps from the collection's relation property names to the relation names.
+     */
+    getRelationKeysForCollection(collectionPath: string): string[] {
+        const collection = this.getCollectionByPath(collectionPath) as (EntityCollection & { relations?: { relationName?: string, localKey?: string }[] }) | undefined;
+        if (!collection?.relations) return [];
+        return collection.relations.map(r => (r.relationName || r.localKey || "") as string).filter(Boolean);
+    }
+}

package/src/collections/loader.ts

@@ -0,0 +1,49 @@
+import { EntityCollection } from "@rebasepro/types";
+import * as fs from "fs";
+import * as path from "path";
+import { pathToFileURL } from "url";
+
+/**
+ * Asynchronously load collection files from a directory for backend initialization
+ */
+export async function loadCollectionsFromDirectory(directory: string): Promise<EntityCollection[]> {
+    const collections: EntityCollection[] = [];
+    try {
+        if (!fs.existsSync(directory)) {
+            console.warn(`[loadCollectionsFromDirectory] Collections directory not found: ${directory}`);
+            return collections;
+        }
+
+        const files = fs.readdirSync(directory);
+        for (const file of files) {
+            // Only load .ts and .js files, ignore test files and declaration 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()
+                    const dynamicImport = new Function('url', 'return import(url)');
+                    const module = await dynamicImport(fileUrl);
+                    
+                    // Expect the collection to be the default export
+                    if (module && module.default) {
+                        collections.push(module.default);
+                    } else {
+                        console.warn(`[loadCollectionsFromDirectory] File ${file} does not have a default export. Skipping.`);
+                    }
+                } catch (err: unknown) {
+                    const message = err instanceof Error ? err.message : String(err);
+                    console.error(`[loadCollectionsFromDirectory] Failed to load collection from ${file}: ${message}`);
+                }
+            }
+        }
+    } catch (err) {
+        console.error(`[loadCollectionsFromDirectory] Error reading collections directory: ${err}`);
+    }
+    return collections;
+}

package/src/db/interfaces.ts

@@ -0,0 +1,60 @@
+/**
+ * Database Abstraction Interfaces
+ * 
+ * These interfaces define the contracts that any database backend must implement
+ * to be used with Rebase. This allows for pluggable database backends like
+ * PostgreSQL, MongoDB, MySQL, etc.
+ */
+
+import { 
+    Entity,
+    EntityCollection,
+    FilterValues,
+    WhereFilterOp,
+    DatabaseConnection,
+    QueryFilter,
+    FetchCollectionOptions,
+    SearchOptions,
+    CountOptions,
+    ConditionBuilder,
+    ConditionBuilderStatic,
+    EntityRepository,
+    CollectionSubscriptionConfig,
+    EntitySubscriptionConfig,
+    RealtimeProvider,
+    CollectionRegistryInterface,
+    DataTransformer,
+    BackendConfig,
+    BackendInstance,
+    BackendFactory
+} from "@rebasepro/types";
+import { NodePgDatabase } from "drizzle-orm/node-postgres";
+import { PgTransaction } from "drizzle-orm/pg-core";
+
+/**
+ * Type representing either a direct database connection or a transaction.
+ * Used to allow services to operate within a transaction context.
+ * Note: `any` is intentional here — it represents a Drizzle client with
+ * a dynamic schema, enabling `db.query[tableName]` access without casts.
+ */
+// eslint-disable-next-line @typescript-eslint/no-explicit-any
+export type DrizzleClient = NodePgDatabase<Record<string, unknown>> | PgTransaction<any, any, any>;
+
+export type {
+    DatabaseConnection,
+    QueryFilter,
+    FetchCollectionOptions,
+    SearchOptions,
+    CountOptions,
+    ConditionBuilder,
+    ConditionBuilderStatic,
+    EntityRepository,
+    CollectionSubscriptionConfig,
+    EntitySubscriptionConfig,
+    RealtimeProvider,
+    CollectionRegistryInterface,
+    DataTransformer,
+    BackendConfig,
+    BackendInstance,
+    BackendFactory
+};

package/src/email/index.ts

@@ -0,0 +1,17 @@
+/**
+ * Email module exports
+ */
+
+export type {
+    EmailService,
+    EmailSendOptions,
+    SMTPConfig,
+    EmailConfig,
+    PasswordResetTemplateFunction,
+    EmailVerificationTemplateFunction,
+    UserInvitationTemplateFunction
+} from "./types";
+
+export { SMTPEmailService, createEmailService } from "./smtp-email-service";
+
+export { getPasswordResetTemplate, getEmailVerificationTemplate, getUserInvitationTemplate } from "./templates";

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

@@ -0,0 +1,88 @@
+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.");
+        }
+
+        try {
+            await this.transporter.sendMail({
+                from: this.config.from,
+                to: options.to,
+                subject: options.subject,
+                html: options.html,
+                text: options.text
+            });
+        } 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,301 @@
+/**
+ * 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: string = "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: string = "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: string = "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 };
+}

package/src/email/types.ts

@@ -0,0 +1,112 @@
+/**
+ * Email service types and interfaces
+ */
+
+/**
+ * Options for sending an email
+ */
+export interface EmailSendOptions {
+    to: string;
+    subject: string;
+    html: string;
+    text?: string;
+}
+
+/**
+ * Email service interface - abstraction for sending emails
+ */
+export interface EmailService {
+    /**
+     * Send an email
+     */
+    send(options: EmailSendOptions): Promise<void>;
+
+    /**
+     * Check if the email service is properly configured
+     */
+    isConfigured(): boolean;
+}
+
+/**
+ * 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 };
+
+/**
+ * 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;
+    };
+}