@beeblock/svelar 0.4.0

package/dist/database/SchemaBuilder.d.ts

@@ -0,0 +1,91 @@
+/**
+ * Svelar Schema Builder
+ *
+ * Laravel-like schema builder that generates raw SQL for migrations.
+ * Database-agnostic: produces the right SQL for SQLite, PostgreSQL, or MySQL.
+ */
+import { type DatabaseDriver } from './Connection.js';
+export interface ColumnDefinition {
+    name: string;
+    type: string;
+    nullable: boolean;
+    defaultValue?: any;
+    primaryKey: boolean;
+    autoIncrement: boolean;
+    unique: boolean;
+    unsigned: boolean;
+    references?: {
+        table: string;
+        column: string;
+        onDelete?: string;
+        onUpdate?: string;
+    };
+    check?: string;
+}
+export declare class ColumnBuilder {
+    private column;
+    constructor(column: ColumnDefinition);
+    nullable(): ColumnBuilder;
+    notNullable(): ColumnBuilder;
+    default(value: any): ColumnBuilder;
+    primary(): ColumnBuilder;
+    unique(): ColumnBuilder;
+    unsigned(): ColumnBuilder;
+    references(column: string, table: string): ForeignKeyBuilder;
+    /** @internal */
+    build(): ColumnDefinition;
+}
+export declare class ForeignKeyBuilder {
+    private column;
+    constructor(column: ColumnDefinition);
+    onDelete(action: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION'): ForeignKeyBuilder;
+    onUpdate(action: 'CASCADE' | 'SET NULL' | 'RESTRICT' | 'NO ACTION'): ForeignKeyBuilder;
+}
+export declare class TableBuilder {
+    private columns;
+    private indices;
+    private compositePrimary;
+    private addColumn;
+    increments(name?: string): ColumnBuilder;
+    bigIncrements(name?: string): ColumnBuilder;
+    string(name: string, length?: number): ColumnBuilder;
+    text(name: string): ColumnBuilder;
+    integer(name: string): ColumnBuilder;
+    bigInteger(name: string): ColumnBuilder;
+    float(name: string): ColumnBuilder;
+    decimal(name: string, precision?: number, scale?: number): ColumnBuilder;
+    boolean(name: string): ColumnBuilder;
+    date(name: string): ColumnBuilder;
+    datetime(name: string): ColumnBuilder;
+    timestamp(name: string): ColumnBuilder;
+    timestamps(): void;
+    json(name: string): ColumnBuilder;
+    blob(name: string): ColumnBuilder;
+    enum(name: string, values: string[]): ColumnBuilder;
+    uuid(name?: string): ColumnBuilder;
+    ulid(name?: string): ColumnBuilder;
+    jsonb(name: string): ColumnBuilder;
+    primary(columns: string[]): void;
+    index(columns: string | string[], name?: string): void;
+    uniqueIndex(columns: string | string[], name?: string): void;
+    foreign(column: string): ColumnBuilder;
+    /** @internal */
+    toSQL(tableName: string, driver: DatabaseDriver): string[];
+    private columnToSQL;
+    private mapSQLiteType;
+    private mapPostgresType;
+    private mapMySQLType;
+}
+export declare class Schema {
+    private connectionName?;
+    constructor(connectionName?: string | undefined);
+    createTable(name: string, callback: (table: TableBuilder) => void): Promise<void>;
+    dropTable(name: string): Promise<void>;
+    dropTableIfExists(name: string): Promise<void>;
+    renameTable(from: string, to: string): Promise<void>;
+    hasTable(name: string): Promise<boolean>;
+    addColumn(table: string, callback: (tb: TableBuilder) => void): Promise<void>;
+    dropColumn(table: string, column: string): Promise<void>;
+}
+/** Default schema instance */
+export declare const schema: Schema;

package/dist/database/Seeder.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Svelar Database Seeder
+ */
+export declare abstract class Seeder {
+    /** Run the seeder */
+    abstract run(): Promise<void>;
+    /** Call another seeder */
+    protected call(SeederClass: new () => Seeder): Promise<void>;
+}

package/dist/database/index.d.ts

@@ -0,0 +1,4 @@
+export { Connection, type DatabaseConfig, type DatabaseDriver, type ConnectionsConfig, type DrizzleInstance } from './Connection.js';
+export { Schema, schema, TableBuilder, ColumnBuilder, ForeignKeyBuilder, type ColumnDefinition } from './SchemaBuilder.js';
+export { Migration, Migrator, type MigrationFile } from './Migration.js';
+export { Seeder } from './Seeder.js';

package/dist/database/index.js

@@ -0,0 +1,4 @@
+function f(u,t){let e=Symbol.for(u),n=globalThis;return n[e]||(n[e]=t()),n[e]}var p=class{connections=new Map;config=null;defaultName="default";configure(t){this.config=t,this.defaultName=t.default}async connection(t){let e=t??this.defaultName;if(this.connections.has(e))return this.connections.get(e).drizzle;if(!this.config)throw new Error("Database not configured. Call Connection.configure() first, or register DatabaseServiceProvider.");let n=this.config.connections[e];if(!n)throw new Error(`Database connection "${e}" is not defined in configuration.`);let r=await this.createConnection(n);return this.connections.set(e,r),r.drizzle}async rawClient(t){let e=t??this.defaultName;return await this.connection(e),this.connections.get(e).rawClient}async raw(t,e=[],n){let r=await this.connection(n),i=this.getConfig(n);switch(i.driver){case"sqlite":{let a=await this.rawClient(n),o=e.map(l=>typeof l=="boolean"?l?1:0:l instanceof Date?l.toISOString():l),c=a.prepare(t),m=t.trimStart().toUpperCase();return m.startsWith("SELECT")||m.startsWith("PRAGMA")||m.startsWith("WITH")?c.all(...o):c.run(...o)}case"postgres":return(await this.rawClient(n))(t,...e);case"mysql":{let a=await this.rawClient(n),[o]=await a.execute(t,e);return o}default:throw new Error(`Unsupported driver: ${i.driver}`)}}getDriver(t){return this.getConfig(t).driver}getConfig(t){let e=t??this.defaultName;if(!this.config)throw new Error("Database not configured.");let n=this.config.connections[e];if(!n)throw new Error(`Database connection "${e}" is not defined.`);return n}async disconnect(t){if(t){let e=this.connections.get(t);e&&(await this.closeConnection(e),this.connections.delete(t))}else{for(let[e,n]of this.connections)await this.closeConnection(n);this.connections.clear()}}isConnected(t){return this.connections.has(t??this.defaultName)}async transaction(t,e){let n=this.getConfig(e),r=await this.rawClient(e);switch(n.driver){case"sqlite":{r.exec("BEGIN");try{let i=await t();return r.exec("COMMIT"),i}catch(i){throw r.exec("ROLLBACK"),i}}case"postgres":{await r`BEGIN`;try{let i=await t();return await r`COMMIT`,i}catch(i){throw await r`ROLLBACK`,i}}case"mysql":{let i=await r.getConnection();await i.beginTransaction();try{let a=await t();return await i.commit(),i.release(),a}catch(a){throw await i.rollback(),i.release(),a}}default:throw new Error(`Unsupported driver: ${n.driver}`)}}async createConnection(t){switch(t.driver){case"sqlite":return this.createSQLiteConnection(t);case"postgres":return this.createPostgresConnection(t);case"mysql":return this.createMySQLConnection(t);default:throw new Error(`Unsupported database driver: ${t.driver}`)}}async createSQLiteConnection(t){let e=t.filename??t.database??":memory:";try{let n=(await import("better-sqlite3")).default,{drizzle:r}=await import("drizzle-orm/better-sqlite3"),i=new n(e);return i.pragma("journal_mode = WAL"),i.pragma("foreign_keys = ON"),{drizzle:r(i),config:t,rawClient:i}}catch(n){let r;try{r=(await new Function("mod","return import(mod)")("node:sqlite")).DatabaseSync}catch{throw new Error(`No SQLite driver available. Install better-sqlite3 (npm install better-sqlite3) or use Node.js v22+ which includes built-in SQLite support. Original error: ${n instanceof Error?n.message:String(n)}`)}let i=new r(e);i.exec("PRAGMA journal_mode = WAL"),i.exec("PRAGMA foreign_keys = ON");let a={prepare(c){let m=i.prepare(c);return{all(...l){return m.all(...l)},run(...l){return m.run(...l)},get(...l){return m.get(...l)}}},exec(c){i.exec(c)},pragma(c){return i.prepare(`PRAGMA ${c}`).all()},close(){i.close()}},o;try{let{drizzle:c}=await import("drizzle-orm/better-sqlite3");o=c(a)}catch{o=a}return{drizzle:o,config:t,rawClient:a}}}async createPostgresConnection(t){let e=(await import("postgres")).default,{drizzle:n}=await import("drizzle-orm/postgres-js"),r=t.url??`postgres://${t.user}:${t.password}@${t.host??"localhost"}:${t.port??5432}/${t.database}`,i=e(r);return{drizzle:n(i),config:t,rawClient:i}}async createMySQLConnection(t){let e=await import("mysql2/promise"),{drizzle:n}=await import("drizzle-orm/mysql2"),r=e.createPool({host:t.host??"localhost",port:t.port??3306,database:t.database,user:t.user,password:t.password,uri:t.url});return{drizzle:n(r),config:t,rawClient:r}}async closeConnection(t){try{switch(t.config.driver){case"sqlite":t.rawClient.close();break;case"postgres":await t.rawClient.end();break;case"mysql":await t.rawClient.end();break}}catch{}}},s=f("svelar.connection",()=>new p);var d=class{constructor(t){this.column=t}nullable(){return this.column.nullable=!0,this}notNullable(){return this.column.nullable=!1,this}default(t){return this.column.defaultValue=t,this}primary(){return this.column.primaryKey=!0,this}unique(){return this.column.unique=!0,this}unsigned(){return this.column.unsigned=!0,this}references(t,e){return this.column.references={table:e,column:t},new w(this.column)}build(){return this.column}},w=class{constructor(t){this.column=t}onDelete(t){return this.column.references.onDelete=t,this}onUpdate(t){return this.column.references.onUpdate=t,this}},h=class{columns=[];indices=[];compositePrimary=null;addColumn(t,e){let n={name:t,type:e,nullable:!1,primaryKey:!1,autoIncrement:!1,unique:!1,unsigned:!1};return this.columns.push(n),new d(n)}increments(t="id"){let e={name:t,type:"INTEGER",nullable:!1,primaryKey:!0,autoIncrement:!0,unique:!1,unsigned:!0};return this.columns.push(e),new d(e)}bigIncrements(t="id"){let e={name:t,type:"BIGINT",nullable:!1,primaryKey:!0,autoIncrement:!0,unique:!1,unsigned:!0};return this.columns.push(e),new d(e)}string(t,e=255){return this.addColumn(t,`VARCHAR(${e})`)}text(t){return this.addColumn(t,"TEXT")}integer(t){return this.addColumn(t,"INTEGER")}bigInteger(t){return this.addColumn(t,"BIGINT")}float(t){return this.addColumn(t,"FLOAT")}decimal(t,e=8,n=2){return this.addColumn(t,`DECIMAL(${e},${n})`)}boolean(t){return this.addColumn(t,"BOOLEAN")}date(t){return this.addColumn(t,"DATE")}datetime(t){return this.addColumn(t,"DATETIME")}timestamp(t){return this.addColumn(t,"TIMESTAMP")}timestamps(){this.timestamp("created_at").nullable(),this.timestamp("updated_at").nullable()}json(t){return this.addColumn(t,"JSON")}blob(t){return this.addColumn(t,"BLOB")}enum(t,e){return this.addColumn(t,`ENUM(${e.map(n=>`'${n}'`).join(",")})`)}uuid(t="id"){return this.addColumn(t,"UUID")}ulid(t="id"){return this.addColumn(t,"ULID")}jsonb(t){return this.addColumn(t,"JSONB")}primary(t){this.compositePrimary=t}index(t,e){let n=Array.isArray(t)?t:[t];this.indices.push({columns:n,unique:!1,name:e})}uniqueIndex(t,e){let n=Array.isArray(t)?t:[t];this.indices.push({columns:n,unique:!0,name:e})}foreign(t){let e=this.columns.find(n=>n.name===t);if(!e)throw new Error(`Column "${t}" must be defined before adding a foreign key.`);return new d(e)}toSQL(t,e){let n=[],r=[];for(let i of this.columns)r.push(this.columnToSQL(i,e));this.compositePrimary&&r.push(`PRIMARY KEY (${this.compositePrimary.join(", ")})`);for(let i of this.columns)if(i.references){let a=`FOREIGN KEY (${i.name}) REFERENCES ${i.references.table}(${i.references.column})`;i.references.onDelete&&(a+=` ON DELETE ${i.references.onDelete}`),i.references.onUpdate&&(a+=` ON UPDATE ${i.references.onUpdate}`),r.push(a)}n.push(`CREATE TABLE ${t} (
+  ${r.join(`,
+  `)}
+)`);for(let i of this.indices){let a=i.name??`idx_${t}_${i.columns.join("_")}`,o=i.unique?"UNIQUE ":"";n.push(`CREATE ${o}INDEX ${a} ON ${t} (${i.columns.join(", ")})`)}return n}columnToSQL(t,e){let n=t.name,r=t.type;if(e==="sqlite"?r=this.mapSQLiteType(r,t):e==="postgres"?r=this.mapPostgresType(r,t):e==="mysql"&&(r=this.mapMySQLType(r,t)),n+=` ${r}`,t.primaryKey&&!this.compositePrimary&&(n+=" PRIMARY KEY",t.autoIncrement&&(e==="sqlite"?n+=" AUTOINCREMENT":e==="postgres"||e==="mysql"&&(n+=" AUTO_INCREMENT"))),!t.nullable&&!t.primaryKey&&(n+=" NOT NULL"),t.unique&&!t.primaryKey&&(n+=" UNIQUE"),t.defaultValue!==void 0){let i=typeof t.defaultValue=="string"?`'${t.defaultValue}'`:t.defaultValue===null?"NULL":t.defaultValue;n+=` DEFAULT ${i}`}return n}mapSQLiteType(t,e){return t==="BOOLEAN"?"INTEGER":t==="UUID"||t==="ULID"||t.startsWith("ENUM")||t==="JSON"||t==="JSONB"?"TEXT":t==="BIGINT"&&e.autoIncrement?"INTEGER":t}mapPostgresType(t,e){return e.autoIncrement&&t==="INTEGER"?"SERIAL":e.autoIncrement&&t==="BIGINT"?"BIGSERIAL":t==="DATETIME"?"TIMESTAMP":t==="BLOB"?"BYTEA":t.startsWith("ENUM")?"TEXT":t==="UUID"?"UUID":t==="ULID"?"VARCHAR(26)":t==="JSON"||t==="JSONB"?"JSONB":t}mapMySQLType(t,e){return t==="BOOLEAN"?"TINYINT(1)":t==="UUID"?"CHAR(36)":t==="ULID"?"CHAR(26)":t==="JSONB"?"JSON":t==="TIMESTAMP"?"DATETIME":e.unsigned&&!t.startsWith("DECIMAL")?`${t} UNSIGNED`:t}},g=class{constructor(t){this.connectionName=t}async createTable(t,e){let n=new h;e(n);let r=s.getDriver(this.connectionName),i=n.toSQL(t,r);for(let a of i)await s.raw(a,[],this.connectionName)}async dropTable(t){await s.raw(`DROP TABLE IF EXISTS ${t}`,[],this.connectionName)}async dropTableIfExists(t){await s.raw(`DROP TABLE IF EXISTS ${t}`,[],this.connectionName)}async renameTable(t,e){s.getDriver(this.connectionName)==="mysql"?await s.raw(`RENAME TABLE ${t} TO ${e}`,[],this.connectionName):await s.raw(`ALTER TABLE ${t} RENAME TO ${e}`,[],this.connectionName)}async hasTable(t){let e=s.getDriver(this.connectionName),n;switch(e){case"sqlite":n=await s.raw("SELECT name FROM sqlite_master WHERE type='table' AND name=?",[t],this.connectionName);break;case"postgres":n=await s.raw("SELECT tablename FROM pg_tables WHERE tablename = $1",[t],this.connectionName);break;case"mysql":n=await s.raw("SELECT TABLE_NAME FROM information_schema.TABLES WHERE TABLE_NAME = ?",[t],this.connectionName);break;default:throw new Error(`Unsupported driver: ${e}`)}return n.length>0}async addColumn(t,e){let n=new h;e(n);let r=s.getDriver(this.connectionName),i=n.columns;for(let a of i){let o=n.columnToSQL(a,r);await s.raw(`ALTER TABLE ${t} ADD COLUMN ${o}`,[],this.connectionName)}}async dropColumn(t,e){await s.raw(`ALTER TABLE ${t} DROP COLUMN ${e}`,[],this.connectionName)}},T=f("svelar.schema",()=>new g);var C=class{schema=new g},E=class{migrationsTable="svelar_migrations";connectionName;constructor(t){this.connectionName=t}async ensureMigrationsTable(){let t=new g(this.connectionName);await t.hasTable(this.migrationsTable)||await t.createTable(this.migrationsTable,n=>{n.increments("id"),n.string("migration").unique(),n.integer("batch"),n.timestamp("ran_at").default("CURRENT_TIMESTAMP")})}async run(t){await this.ensureMigrationsTable();let e=await this.getRanMigrations(),n=t.filter(a=>!e.includes(a.name));if(n.length===0)return[];let r=await this.getNextBatch(),i=[];for(let a of n)await a.migration.up(),await s.raw(`INSERT INTO ${this.migrationsTable} (migration, batch) VALUES (?, ?)`,[a.name,r],this.connectionName),i.push(a.name);return i}async rollback(t){await this.ensureMigrationsTable();let e=await this.getLastBatch();if(e===0)return[];let n=await s.raw(`SELECT migration FROM ${this.migrationsTable} WHERE batch = ? ORDER BY id DESC`,[e],this.connectionName),r=[];for(let i of n){let a=i.migration,o=t.find(c=>c.name===a);o&&(await o.migration.down(),await s.raw(`DELETE FROM ${this.migrationsTable} WHERE migration = ?`,[a],this.connectionName),r.push(a))}return r}async reset(t){let e=[];for(;;){let n=await this.rollback(t);if(n.length===0)break;e.push(...n)}return e}async refresh(t){let e=await this.reset(t),n=await this.run(t);return{reset:e,migrated:n}}async fresh(t){let e=await this.dropAllTables(),n=await this.run(t);return{dropped:e,migrated:n}}async dropAllTables(){let t=s.getDriver(this.connectionName),e=[];switch(t){case"sqlite":{e=(await s.raw("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'",[],this.connectionName)).map(r=>r.name),await s.raw("PRAGMA foreign_keys = OFF",[],this.connectionName);for(let r of e)await s.raw(`DROP TABLE IF EXISTS "${r}"`,[],this.connectionName);await s.raw("PRAGMA foreign_keys = ON",[],this.connectionName);break}case"mysql":{e=(await s.raw("SHOW TABLES",[],this.connectionName)).map(r=>Object.values(r)[0]),await s.raw("SET FOREIGN_KEY_CHECKS = 0",[],this.connectionName);for(let r of e)await s.raw(`DROP TABLE IF EXISTS \`${r}\``,[],this.connectionName);await s.raw("SET FOREIGN_KEY_CHECKS = 1",[],this.connectionName);break}case"postgres":{e=(await s.raw("SELECT tablename FROM pg_tables WHERE schemaname = 'public'",[],this.connectionName)).map(r=>r.tablename);for(let r of e)await s.raw(`DROP TABLE IF EXISTS "${r}" CASCADE`,[],this.connectionName);break}default:throw new Error(`Unsupported driver for fresh: ${t}`)}return e}async getRanMigrations(){try{return(await s.raw(`SELECT migration FROM ${this.migrationsTable} ORDER BY batch, id`,[],this.connectionName)).map(e=>e.migration)}catch{return[]}}async status(t){let e=await this.getRanMigrations(),n=new Map;try{let r=await s.raw(`SELECT migration, batch FROM ${this.migrationsTable}`,[],this.connectionName);for(let i of r)n.set(i.migration,i.batch)}catch{}return t.map(r=>({name:r.name,ran:e.includes(r.name),batch:n.get(r.name)??null}))}async getNextBatch(){return await this.getLastBatch()+1}async getLastBatch(){try{return(await s.raw(`SELECT MAX(batch) as max_batch FROM ${this.migrationsTable}`,[],this.connectionName))[0]?.max_batch??0}catch{return 0}}};var b=class{async call(t){await new t().run()}};export{d as ColumnBuilder,s as Connection,w as ForeignKeyBuilder,C as Migration,E as Migrator,g as Schema,b as Seeder,h as TableBuilder,T as schema};

package/dist/email-templates/index.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Svelar Email Templates
+ * Reusable, customizable email templates with variable interpolation.
+ */
+export interface EmailTemplate {
+    id: string;
+    name: string;
+    subject: string;
+    html: string;
+    text?: string;
+    variables: string[];
+    category?: string;
+    active: boolean;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface RenderResult {
+    subject: string;
+    html: string;
+    text?: string;
+}
+export interface TemplateConfig {
+    driver: 'database' | 'memory' | 'file';
+    path?: string;
+    table?: string;
+}
+declare class EmailTemplateManager {
+    private config;
+    private templates;
+    constructor();
+    configure(config: TemplateConfig): void;
+    /** Register a template */
+    register(template: Omit<EmailTemplate, 'id' | 'createdAt' | 'updatedAt'>): Promise<EmailTemplate>;
+    /** Render a template with variables */
+    render(name: string, variables: Record<string, any>): Promise<RenderResult>;
+    /** Get a template by name */
+    get(name: string): Promise<EmailTemplate | null>;
+    /** List all templates */
+    list(category?: string): Promise<EmailTemplate[]>;
+    /** Update a template */
+    update(name: string, data: Partial<EmailTemplate>): Promise<EmailTemplate | null>;
+    /** Delete a template */
+    delete(name: string): Promise<boolean>;
+    /** Register built-in default templates */
+    private registerDefaults;
+    /** Simple template engine — replaces {{var}}, {{#if}}, {{#each}} */
+    private interpolate;
+    private getNestedValue;
+}
+export declare const EmailTemplates: EmailTemplateManager;
+export {};

package/dist/email-templates/index.js

@@ -0,0 +1,57 @@
+var y=Object.defineProperty;var f=(p,e)=>()=>(p&&(e=p(p=0)),e);var b=(p,e)=>{for(var t in e)y(p,t,{get:e[t],enumerable:!0})};function m(p,e){let t=Symbol.for(p),n=globalThis;return n[t]||(n[t]=e()),n[t]}var d=f(()=>{"use strict"});var w={};b(w,{Connection:()=>C});var h,C,v=f(()=>{"use strict";d();h=class{connections=new Map;config=null;defaultName="default";configure(e){this.config=e,this.defaultName=e.default}async connection(e){let t=e??this.defaultName;if(this.connections.has(t))return this.connections.get(t).drizzle;if(!this.config)throw new Error("Database not configured. Call Connection.configure() first, or register DatabaseServiceProvider.");let n=this.config.connections[t];if(!n)throw new Error(`Database connection "${t}" is not defined in configuration.`);let r=await this.createConnection(n);return this.connections.set(t,r),r.drizzle}async rawClient(e){let t=e??this.defaultName;return await this.connection(t),this.connections.get(t).rawClient}async raw(e,t=[],n){let r=await this.connection(n),i=this.getConfig(n);switch(i.driver){case"sqlite":{let a=await this.rawClient(n),c=t.map(o=>typeof o=="boolean"?o?1:0:o instanceof Date?o.toISOString():o),s=a.prepare(e),l=e.trimStart().toUpperCase();return l.startsWith("SELECT")||l.startsWith("PRAGMA")||l.startsWith("WITH")?s.all(...c):s.run(...c)}case"postgres":return(await this.rawClient(n))(e,...t);case"mysql":{let a=await this.rawClient(n),[c]=await a.execute(e,t);return c}default:throw new Error(`Unsupported driver: ${i.driver}`)}}getDriver(e){return this.getConfig(e).driver}getConfig(e){let t=e??this.defaultName;if(!this.config)throw new Error("Database not configured.");let n=this.config.connections[t];if(!n)throw new Error(`Database connection "${t}" is not defined.`);return n}async disconnect(e){if(e){let t=this.connections.get(e);t&&(await this.closeConnection(t),this.connections.delete(e))}else{for(let[t,n]of this.connections)await this.closeConnection(n);this.connections.clear()}}isConnected(e){return this.connections.has(e??this.defaultName)}async transaction(e,t){let n=this.getConfig(t),r=await this.rawClient(t);switch(n.driver){case"sqlite":{r.exec("BEGIN");try{let i=await e();return r.exec("COMMIT"),i}catch(i){throw r.exec("ROLLBACK"),i}}case"postgres":{await r`BEGIN`;try{let i=await e();return await r`COMMIT`,i}catch(i){throw await r`ROLLBACK`,i}}case"mysql":{let i=await r.getConnection();await i.beginTransaction();try{let a=await e();return await i.commit(),i.release(),a}catch(a){throw await i.rollback(),i.release(),a}}default:throw new Error(`Unsupported driver: ${n.driver}`)}}async createConnection(e){switch(e.driver){case"sqlite":return this.createSQLiteConnection(e);case"postgres":return this.createPostgresConnection(e);case"mysql":return this.createMySQLConnection(e);default:throw new Error(`Unsupported database driver: ${e.driver}`)}}async createSQLiteConnection(e){let t=e.filename??e.database??":memory:";try{let n=(await import("better-sqlite3")).default,{drizzle:r}=await import("drizzle-orm/better-sqlite3"),i=new n(t);return i.pragma("journal_mode = WAL"),i.pragma("foreign_keys = ON"),{drizzle:r(i),config:e,rawClient:i}}catch(n){let r;try{r=(await new Function("mod","return import(mod)")("node:sqlite")).DatabaseSync}catch{throw new Error(`No SQLite driver available. Install better-sqlite3 (npm install better-sqlite3) or use Node.js v22+ which includes built-in SQLite support. Original error: ${n instanceof Error?n.message:String(n)}`)}let i=new r(t);i.exec("PRAGMA journal_mode = WAL"),i.exec("PRAGMA foreign_keys = ON");let a={prepare(s){let l=i.prepare(s);return{all(...o){return l.all(...o)},run(...o){return l.run(...o)},get(...o){return l.get(...o)}}},exec(s){i.exec(s)},pragma(s){return i.prepare(`PRAGMA ${s}`).all()},close(){i.close()}},c;try{let{drizzle:s}=await import("drizzle-orm/better-sqlite3");c=s(a)}catch{c=a}return{drizzle:c,config:e,rawClient:a}}}async createPostgresConnection(e){let t=(await import("postgres")).default,{drizzle:n}=await import("drizzle-orm/postgres-js"),r=e.url??`postgres://${e.user}:${e.password}@${e.host??"localhost"}:${e.port??5432}/${e.database}`,i=t(r);return{drizzle:n(i),config:e,rawClient:i}}async createMySQLConnection(e){let t=await import("mysql2/promise"),{drizzle:n}=await import("drizzle-orm/mysql2"),r=t.createPool({host:e.host??"localhost",port:e.port??3306,database:e.database,user:e.user,password:e.password,uri:e.url});return{drizzle:n(r),config:e,rawClient:r}}async closeConnection(e){try{switch(e.config.driver){case"sqlite":e.rawClient.close();break;case"postgres":await e.rawClient.end();break;case"mysql":await e.rawClient.end();break}}catch{}}},C=m("svelar.connection",()=>new h)});d();import{randomUUID as u}from"crypto";var g=class{config={driver:"memory"};templates=new Map;constructor(){this.registerDefaults()}configure(e){this.config=e}async register(e){let t={...e,id:u(),createdAt:Date.now(),updatedAt:Date.now()};if(this.config.driver==="memory")this.templates.set(e.name,t);else if(this.config.driver==="database")try{let{Connection:n}=await Promise.resolve().then(()=>(v(),w));await n.connection()}catch{this.templates.set(e.name,t)}return t}async render(e,t){let n=await this.get(e);if(!n)throw new Error(`Template "${e}" not found`);let r=this.interpolate(n.subject,t),i=this.interpolate(n.html,t),a=n.text?this.interpolate(n.text,t):void 0;return{subject:r,html:i,text:a}}async get(e){return this.templates.get(e)||null}async list(e){let t=Array.from(this.templates.values());return e&&(t=t.filter(n=>n.category===e)),t}async update(e,t){let n=this.templates.get(e);return n?(Object.assign(n,t,{updatedAt:Date.now()}),n):null}async delete(e){return this.templates.delete(e)}registerDefaults(){this.templates.set("welcome",{id:u(),name:"welcome",subject:"Welcome to {{appName}}, {{user.name}}!",html:`
+        <h1>Welcome, {{user.name}}!</h1>
+        <p>Thank you for joining {{appName}}.</p>
+        <p>Your account has been created with the email: <strong>{{user.email}}</strong></p>
+        <p><a href="{{confirmUrl}}">Confirm your email address</a></p>
+      `,text:`Welcome, {{user.name}}!
+
+Confirm your email: {{confirmUrl}}`,variables:["appName","user.name","user.email","confirmUrl"],category:"auth",active:!0,createdAt:Date.now(),updatedAt:Date.now()}),this.templates.set("password-reset",{id:u(),name:"password-reset",subject:"Reset your {{appName}} password",html:`
+        <h1>Password Reset</h1>
+        <p>Hi {{user.name}},</p>
+        <p>Click the link below to reset your password. This link expires in 1 hour.</p>
+        <p><a href="{{resetUrl}}">Reset Password</a></p>
+        <p>If you didn't request this, you can ignore this email.</p>
+      `,text:`Reset your password: {{resetUrl}}
+
+This link expires in 1 hour.`,variables:["appName","user.name","resetUrl"],category:"auth",active:!0,createdAt:Date.now(),updatedAt:Date.now()}),this.templates.set("email-verification",{id:u(),name:"email-verification",subject:"Verify your email address",html:`
+        <h1>Verify Your Email</h1>
+        <p>Hi {{user.name}},</p>
+        <p><a href="{{verifyUrl}}">Click here to verify your email address</a></p>
+        <p>This link expires in 24 hours.</p>
+      `,text:"Verify your email: {{verifyUrl}}",variables:["user.name","verifyUrl"],category:"auth",active:!0,createdAt:Date.now(),updatedAt:Date.now()}),this.templates.set("team-invitation",{id:u(),name:"team-invitation",subject:"{{inviter.name}} invited you to join {{team.name}}",html:`
+        <h1>Team Invitation</h1>
+        <p>Hi {{user.name}},</p>
+        <p><strong>{{inviter.name}}</strong> has invited you to join the team <strong>{{team.name}}</strong>.</p>
+        <p><a href="{{acceptUrl}}">Accept Invitation</a></p>
+        <p>This invitation expires in 3 days.</p>
+      `,text:"Accept: {{acceptUrl}}",variables:["user.name","inviter.name","team.name","acceptUrl"],category:"notification",active:!0,createdAt:Date.now(),updatedAt:Date.now()}),this.templates.set("invoice",{id:u(),name:"invoice",subject:"Invoice #{{invoice.number}} from {{appName}}",html:`
+        <h1>Invoice #{{invoice.number}}</h1>
+        <p>Hi {{customer.name}},</p>
+        <p>Thank you for your purchase!</p>
+        <p><strong>Amount:</strong> {{invoice.amount}}</p>
+        <p><strong>Date:</strong> {{invoice.date}}</p>
+        <p><a href="{{invoiceUrl}}">View Invoice</a></p>
+      `,text:`Invoice #{{invoice.number}}
+Amount: {{invoice.amount}}`,variables:["appName","customer.name","invoice.number","invoice.amount","invoice.date","invoiceUrl"],category:"billing",active:!0,createdAt:Date.now(),updatedAt:Date.now()}),this.templates.set("subscription-confirmation",{id:u(),name:"subscription-confirmation",subject:"Subscription Confirmation",html:`
+        <h1>Subscription Confirmed</h1>
+        <p>Hi {{user.name}},</p>
+        <p>Your {{plan.name}} plan is now active.</p>
+        <p><strong>Price:</strong> {{plan.price}} / {{plan.interval}}</p>
+        <p>Your next billing date is {{nextBillingDate}}.</p>
+      `,text:`Your {{plan.name}} plan is active.
+Next billing: {{nextBillingDate}}`,variables:["user.name","plan.name","plan.price","plan.interval","nextBillingDate"],category:"billing",active:!0,createdAt:Date.now(),updatedAt:Date.now()}),this.templates.set("otp-code",{id:u(),name:"otp-code",subject:"Your {{appName}} verification code: {{code}}",html:`
+        <h1>Your Verification Code</h1>
+        <p>Hi {{user.name}},</p>
+        <p>Your one-time verification code is:</p>
+        <p style="font-size: 32px; font-weight: bold; letter-spacing: 8px; text-align: center; padding: 16px; background: #f3f4f6; border-radius: 8px; font-family: monospace;">{{code}}</p>
+        <p>This code expires in {{expiresMinutes}} minutes.</p>
+        <p>If you didn't request this code, you can safely ignore this email.</p>
+      `,text:`Your verification code: {{code}}
+
+This code expires in {{expiresMinutes}} minutes.`,variables:["appName","user.name","code","expiresMinutes","purpose"],category:"auth",active:!0,createdAt:Date.now(),updatedAt:Date.now()}),this.templates.set("subscription-canceled",{id:u(),name:"subscription-canceled",subject:"Your subscription has been canceled",html:`
+        <h1>Subscription Canceled</h1>
+        <p>Hi {{user.name}},</p>
+        <p>Your {{plan.name}} subscription has been canceled.</p>
+        <p>You have access until {{accessUntilDate}}.</p>
+      `,text:`Your {{plan.name}} subscription is canceled.
+Access until: {{accessUntilDate}}`,variables:["user.name","plan.name","accessUntilDate"],category:"billing",active:!0,createdAt:Date.now(),updatedAt:Date.now()})}interpolate(e,t){let n=e;return n=n.replace(/\{\{#if\s+(\w+(?:\.\w+)*)\}\}([\s\S]*?)\{\{\/if\}\}/g,(r,i,a)=>this.getNestedValue(t,i)?a:""),n=n.replace(/\{\{#each\s+(\w+(?:\.\w+)*)\}\}([\s\S]*?)\{\{\/each\}\}/g,(r,i,a)=>{let c=this.getNestedValue(t,i);return Array.isArray(c)?c.map((s,l)=>{let o={...t,this:s,$index:l};return this.interpolate(a,o)}).join(""):""}),n=n.replace(/\{\{([\w.$]+)\}\}/g,(r,i)=>{let a=this.getNestedValue(t,i);return a!=null?String(a):""}),n}getNestedValue(e,t){return t.split(".").reduce((n,r)=>n?.[r],e)}},P=m("svelar.emailTemplates",()=>new g);export{P as EmailTemplates};

package/dist/errors/Handler.d.ts

@@ -0,0 +1,100 @@
+/**
+ * Svelar Error Handler
+ *
+ * Centralized error handling with structured responses,
+ * error reporting, and SvelteKit integration.
+ *
+ * Errors are automatically logged via the Svelar Log system
+ * (console, file, stack channels) instead of leaking to the UI.
+ *
+ * @example
+ * ```ts
+ * // hooks.server.ts
+ * import { ErrorHandler } from 'svelar/errors';
+ *
+ * const handler = new ErrorHandler({
+ *   debug: process.env.NODE_ENV !== 'production',
+ *   report: async (error) => {
+ *     // Send to Sentry, Datadog, etc.
+ *   },
+ * });
+ *
+ * export const handleError = handler.handleSvelteKitError();
+ * ```
+ */
+export declare class HttpError extends Error {
+    readonly statusCode: number;
+    readonly details?: Record<string, any> | undefined;
+    constructor(statusCode: number, message: string, details?: Record<string, any> | undefined);
+}
+export declare class NotFoundError extends HttpError {
+    constructor(message?: string);
+}
+export declare class UnauthorizedError extends HttpError {
+    constructor(message?: string);
+}
+export declare class ForbiddenError extends HttpError {
+    constructor(message?: string);
+}
+export declare class ValidationError extends HttpError {
+    readonly errors: Record<string, string[]>;
+    constructor(errors: Record<string, string[]>, message?: string);
+}
+export declare class ConflictError extends HttpError {
+    constructor(message?: string);
+}
+export declare class TooManyRequestsError extends HttpError {
+    readonly retryAfter?: number | undefined;
+    constructor(message?: string, retryAfter?: number | undefined);
+}
+export declare class ServiceUnavailableError extends HttpError {
+    constructor(message?: string);
+}
+export declare class ModelNotFoundError extends NotFoundError {
+    constructor(model: string, id?: any);
+}
+/**
+ * Throw an HTTP error (like Laravel's abort())
+ */
+export declare function abort(statusCode: number, message?: string): never;
+/**
+ * Abort if a condition is true
+ */
+export declare function abortIf(condition: boolean, statusCode: number, message?: string): void;
+/**
+ * Abort unless a condition is true
+ */
+export declare function abortUnless(condition: boolean, statusCode: number, message?: string): void;
+export interface ErrorHandlerConfig {
+    /** Show detailed errors (stack traces, etc.) */
+    debug?: boolean;
+    /** Custom error reporter (e.g. Sentry) */
+    report?: (error: Error, context?: Record<string, any>) => void | Promise<void>;
+    /** Errors that should not be reported */
+    dontReport?: Array<new (...args: any[]) => Error>;
+    /** Custom render function */
+    render?: (error: Error, event?: any) => Response | Promise<Response>;
+}
+export declare class ErrorHandler {
+    private config;
+    constructor(config?: ErrorHandlerConfig);
+    /**
+     * Handle an error and return a Response
+     */
+    handle(error: Error | unknown, event?: any): Promise<Response>;
+    /**
+     * Create a SvelteKit-compatible handleError hook
+     */
+    handleSvelteKitError(): (input: {
+        error: unknown;
+        event: any;
+        status: number;
+        message: string;
+    }) => any;
+    /**
+     * Create an error-handling middleware
+     */
+    middleware(): (ctx: any, next: () => Promise<Response | void>) => Promise<Response | void>;
+    private reportError;
+    private renderError;
+}

package/dist/errors/index.d.ts

@@ -0,0 +1 @@
+export { ErrorHandler, HttpError, NotFoundError, UnauthorizedError, ForbiddenError, ValidationError, ConflictError, TooManyRequestsError, ServiceUnavailableError, ModelNotFoundError, abort, abortIf, abortUnless, type ErrorHandlerConfig, } from './Handler.js';

package/dist/errors/index.js

@@ -0,0 +1,5 @@
+import{appendFile as $,mkdir as N}from"fs/promises";import{dirname as D}from"path";function R(r,e){let t=Symbol.for(r),n=globalThis;return n[t]||(n[t]=e()),n[t]}var d={debug:0,info:1,warn:2,error:3,fatal:4},l=class{minLevel;format;constructor(e){this.minLevel=e.level??"debug",this.format=e.format??"text"}write(e){if(d[e.level]<d[this.minLevel])return;if(this.format==="json"){console.log(JSON.stringify(e));return}let t={debug:"\x1B[90m",info:"\x1B[34m",warn:"\x1B[33m",error:"\x1B[31m",fatal:"\x1B[35m"},n="\x1B[0m",s=t[e.level]??"",i=e.level.toUpperCase().padEnd(5),k=Object.keys(e.context).length>0?` ${JSON.stringify(e.context)}`:"",T=e.level==="error"||e.level==="fatal"?"error":"log";console[T](`${s}[${e.timestamp}] ${i}${n} ${e.message}${k}`)}},f=class{minLevel;path;format;initialized=!1;constructor(e){this.minLevel=e.level??"info",this.path=e.path??"storage/logs/app.log",this.format=e.format??"text"}async write(e){if(d[e.level]<d[this.minLevel])return;this.initialized||(await N(D(this.path),{recursive:!0}),this.initialized=!0);let t;if(this.format==="json")t=JSON.stringify(e)+`
+`;else{let n=e.level.toUpperCase().padEnd(5),s=Object.keys(e.context).length>0?` ${JSON.stringify(e.context)}`:"";t=`[${e.timestamp}] ${n} ${e.message}${s}
+`}await $(this.path,t)}},p=class{minLevel="debug";channelNames;resolver;constructor(e,t){this.channelNames=e.channels??[],this.resolver=t,this.minLevel=e.level??"debug"}async write(e){for(let t of this.channelNames){let n=this.resolver(t);n&&await n.write(e)}}},m=class{minLevel="debug";write(){}},v=class{config={default:"console",channels:{console:{driver:"console",level:"debug"}}};channels=new Map;configure(e){this.config=e,this.channels.clear()}channel(e){return new b(this.resolveChannel(e))}debug(e,t={}){this.writeToDefault({level:"debug",message:e,context:t,timestamp:a()})}info(e,t={}){this.writeToDefault({level:"info",message:e,context:t,timestamp:a()})}warn(e,t={}){this.writeToDefault({level:"warn",message:e,context:t,timestamp:a()})}error(e,t={}){this.writeToDefault({level:"error",message:e,context:t,timestamp:a()})}fatal(e,t={}){this.writeToDefault({level:"fatal",message:e,context:t,timestamp:a()})}writeToDefault(e){this.resolveChannel(this.config.default).write(e)}resolveChannel(e){if(this.channels.has(e))return this.channels.get(e);let t=this.config.channels[e];if(!t){let s=new l({driver:"console"});return this.channels.set(e,s),s}let n=this.createChannel(t);return this.channels.set(e,n),n}createChannel(e){switch(e.driver){case"console":return new l(e);case"file":return new f(e);case"stack":return new p(e,t=>this.resolveChannel(t));case"null":return new m;default:return new l(e)}}},b=class{constructor(e){this.channel=e}debug(e,t={}){this.channel.write({level:"debug",message:e,context:t,timestamp:a()})}info(e,t={}){this.channel.write({level:"info",message:e,context:t,timestamp:a()})}warn(e,t={}){this.channel.write({level:"warn",message:e,context:t,timestamp:a()})}error(e,t={}){this.channel.write({level:"error",message:e,context:t,timestamp:a()})}fatal(e,t={}){this.channel.write({level:"fatal",message:e,context:t,timestamp:a()})}};function a(){return new Date().toISOString()}var S=R("svelar.log",()=>new v);var o=class extends Error{constructor(t,n,s){super(n);this.statusCode=t;this.details=s;this.name="HttpError"}},c=class extends o{constructor(e="The requested resource was not found"){super(404,e),this.name="NotFoundError"}},u=class extends o{constructor(e="Unauthenticated"){super(401,e),this.name="UnauthorizedError"}},h=class extends o{constructor(e="You do not have permission to perform this action"){super(403,e),this.name="ForbiddenError"}},g=class extends o{constructor(t,n="The given data was invalid"){super(422,n,{errors:t});this.errors=t;this.name="ValidationError"}},w=class extends o{constructor(e="Resource conflict"){super(409,e),this.name="ConflictError"}},x=class extends o{constructor(t="Too many requests",n){super(429,t,n?{retryAfter:n}:void 0);this.retryAfter=n;this.name="TooManyRequestsError"}},y=class extends o{constructor(e="Service temporarily unavailable"){super(503,e),this.name="ServiceUnavailableError"}},L=class extends c{constructor(e,t){super(t?`${e} with ID ${t} not found`:`${e} not found`),this.name="ModelNotFoundError"}};function C(r,e){throw new o(r,e??P(r))}function O(r,e,t){r&&C(e,t)}function j(r,e,t){r||C(e,t)}var E=class{config;constructor(e={}){this.config={debug:process.env.NODE_ENV!=="production",dontReport:[g,c,u,h],...e}}async handle(e,t){let n=e instanceof Error?e:new Error(String(e));return await this.reportError(n,t),this.config.render?this.config.render(n,t):this.renderError(n)}handleSvelteKitError(){return({error:e,event:t,status:n,message:s})=>{let i=e instanceof Error?e:new Error(String(e));return this.reportError(i,t),i instanceof o?{message:i.message,status:i.statusCode,...i.details??{},...this.config.debug?{stack:i.stack}:{}}:{message:this.config.debug?i.message:"An unexpected error occurred",status:n,...this.config.debug?{stack:i.stack}:{}}}}middleware(){let e=this;return async(t,n)=>{try{return await n()}catch(s){return e.handle(s,t.event)}}}async reportError(e,t){if(this.config.dontReport){for(let s of this.config.dontReport)if(e instanceof s)return}let n={error:e.name,...t?.url?{url:t.url.toString()}:{},...e.stack?{stack:e.stack}:{}};if(S.error(e.message,n),this.config.report)try{await this.config.report(e,t?{url:t.url?.toString()}:void 0)}catch{}}renderError(e){if(e instanceof o){let n={message:e.message};return e instanceof g&&(n.errors=e.errors),e.details&&Object.assign(n,e.details),this.config.debug&&(n.exception=e.name,n.stack=e.stack?.split(`
+`).map(s=>s.trim())),new Response(JSON.stringify(n),{status:e.statusCode,headers:{"Content-Type":"application/json"}})}let t={message:this.config.debug?e.message:"Internal server error"};return this.config.debug&&(t.exception=e.name,t.stack=e.stack?.split(`
+`).map(n=>n.trim())),new Response(JSON.stringify(t),{status:500,headers:{"Content-Type":"application/json"}})}};function P(r){return{400:"Bad request",401:"Unauthenticated",403:"Forbidden",404:"Not found",405:"Method not allowed",409:"Conflict",419:"Page expired",422:"Unprocessable entity",429:"Too many requests",500:"Internal server error",502:"Bad gateway",503:"Service unavailable",504:"Gateway timeout"}[r]??"An error occurred"}export{w as ConflictError,E as ErrorHandler,h as ForbiddenError,o as HttpError,L as ModelNotFoundError,c as NotFoundError,y as ServiceUnavailableError,x as TooManyRequestsError,u as UnauthorizedError,g as ValidationError,C as abort,O as abortIf,j as abortUnless};

package/dist/events/EventServiceProvider.d.ts

@@ -0,0 +1,82 @@
+/**
+ * Svelar EventServiceProvider
+ *
+ * Base class for registering event-to-listener mappings and model observers
+ * in a declarative way. Extend this in your app to wire up all event handling.
+ *
+ * @example
+ * ```ts
+ * import { EventServiceProvider } from '@beeblock/svelar/events';
+ * import { UserRegistered } from '../events/UserRegistered.js';
+ * import { SendWelcomeEmail } from '../listeners/SendWelcomeEmail.js';
+ * import { User } from '../modules/users/User.js';
+ * import { UserObserver } from '../modules/users/UserObserver.js';
+ *
+ * export class AppEventServiceProvider extends EventServiceProvider {
+ *   protected listen = {
+ *     [UserRegistered.name]: [SendWelcomeEmail],
+ *     'order.created': [NotifyWarehouse, SendOrderConfirmation],
+ *   };
+ *
+ *   protected observers = {
+ *     [User.name]: [UserObserver],
+ *   };
+ * }
+ * ```
+ */
+import { ServiceProvider } from '../container/ServiceProvider.js';
+import { Event, type EventListener } from './index.js';
+import type { ModelObserver } from '../orm/Observer.js';
+export type ListenerClass = new () => {
+    handle(event: any): void | Promise<void>;
+};
+export type ListenMap = Record<string, (ListenerClass | EventListener)[]>;
+export type ObserverMap = Record<string, (new () => ModelObserver)[]>;
+export declare abstract class EventServiceProvider extends ServiceProvider {
+    /**
+     * Map of event names/classes to their listeners.
+     *
+     * Keys can be class names (for class-based events) or string event names.
+     * Values are arrays of Listener classes or inline functions.
+     */
+    protected listen: ListenMap;
+    /**
+     * Map of model class names to their observer classes.
+     *
+     * Keys are model class names (e.g. 'User').
+     * Values are arrays of observer class constructors.
+     */
+    protected observers: ObserverMap;
+    /**
+     * The subscriber classes to register.
+     * Each subscriber's subscribe() method receives the EventDispatcher.
+     */
+    protected subscribe: (new () => {
+        subscribe(events: typeof Event): void;
+    })[];
+    register(): void;
+    boot(): Promise<void>;
+    private registerListeners;
+    private registerSubscribers;
+    private registerObservers;
+    /**
+     * Check if a listener entry is a class (has a handle method) vs an inline function
+     */
+    private isListenerClass;
+    private static modelRegistry;
+    /**
+     * Register a model class so observers can be attached by name.
+     * Call this in your app setup or in a service provider's register().
+     */
+    static registerModel(ModelClass: {
+        name: string;
+        observe(observer: ModelObserver): void;
+    }): void;
+    /**
+     * Register multiple model classes at once.
+     */
+    static registerModels(...models: {
+        name: string;
+        observe(observer: ModelObserver): void;
+    }[]): void;
+}

package/dist/events/Listener.d.ts

@@ -0,0 +1,28 @@
+/**
+ * Svelar Listener
+ *
+ * Base class for event listeners. Listeners encapsulate the logic
+ * that runs in response to a dispatched event.
+ *
+ * @example
+ * ```ts
+ * import { Listener } from '@beeblock/svelar/events';
+ *
+ * export class SendWelcomeEmail extends Listener {
+ *   async handle(event: UserRegistered) {
+ *     await Mail.to(event.user.email).send(new WelcomeEmail(event.user));
+ *   }
+ * }
+ * ```
+ */
+export declare abstract class Listener<T = any> {
+    /**
+     * Handle the event.
+     */
+    abstract handle(event: T): void | Promise<void>;
+    /**
+     * Determine whether the listener should handle the event.
+     * Override to add conditional logic.
+     */
+    shouldHandle(_event: T): boolean;
+}

package/dist/events/index.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Svelar Events
+ *
+ * Laravel-inspired event dispatcher with typed events, listeners, and subscribers.
+ *
+ * @example
+ * ```ts
+ * import { Event } from 'svelar/events';
+ *
+ * // Define an event
+ * class UserRegistered {
+ *   constructor(public readonly user: User) {}
+ * }
+ *
+ * // Register a listener
+ * Event.listen(UserRegistered, async (event) => {
+ *   await sendWelcomeEmail(event.user);
+ * });
+ *
+ * // Dispatch
+ * await Event.dispatch(new UserRegistered(user));
+ * ```
+ */
+export type EventClass<T = any> = new (...args: any[]) => T;
+export type EventListener<T = any> = (event: T) => void | Promise<void>;
+export type WildcardListener = (eventName: string, event: any) => void | Promise<void>;
+export interface Subscriber {
+    subscribe(events: EventDispatcher): void;
+}
+export declare class EventDispatcher {
+    private listeners;
+    private wildcardListeners;
+    private onceListeners;
+    /**
+     * Register an event listener
+     */
+    listen<T>(event: EventClass<T> | string, listener: EventListener<T>): () => void;
+    /**
+     * Register a one-time listener
+     */
+    once<T>(event: EventClass<T> | string, listener: EventListener<T>): () => void;
+    /**
+     * Register a wildcard listener (called for every event)
+     */
+    onAny(listener: WildcardListener): () => void;
+    /**
+     * Dispatch an event
+     */
+    dispatch<T extends object>(event: T): Promise<void>;
+    /**
+     * Dispatch an event by string name with payload
+     */
+    emit(name: string, payload?: any): Promise<void>;
+    /**
+     * Register a subscriber (an object that subscribes to multiple events)
+     */
+    subscribe(subscriber: Subscriber): void;
+    /**
+     * Remove all listeners for an event
+     */
+    forget(event: EventClass | string): void;
+    /**
+     * Remove all listeners
+     */
+    flush(): void;
+    /**
+     * Check if an event has listeners
+     */
+    hasListeners(event: EventClass | string): boolean;
+    /**
+     * Get the count of listeners for an event
+     */
+    listenerCount(event: EventClass | string): number;
+}
+/**
+ * Global event dispatcher singleton
+ */
+export declare const Event: EventDispatcher;
+export { Listener } from './Listener.js';
+export { EventServiceProvider, type ListenMap, type ObserverMap, type ListenerClass } from './EventServiceProvider.js';

package/dist/events/index.js

@@ -0,0 +1 @@
+function v(n,e){let s=Symbol.for(n),t=globalThis;return t[s]||(t[s]=e()),t[s]}var c=class{shouldHandle(e){return!0}};var o=class{app;constructor(e){this.app=e}boot(){}};var l=class n extends o{listen={};observers={};subscribe=[];register(){}async boot(){this.registerListeners(),this.registerSubscribers(),await this.registerObservers()}registerListeners(){for(let[e,s]of Object.entries(this.listen))for(let t of s)if(this.isListenerClass(t)){let i=new t;a.listen(e,async r=>{"shouldHandle"in i&&typeof i.shouldHandle=="function"&&!i.shouldHandle(r)||await i.handle(r)})}else a.listen(e,t)}registerSubscribers(){for(let e of this.subscribe){let s=new e;a.subscribe(s)}}async registerObservers(){for(let[e,s]of Object.entries(this.observers)){let t=n.modelRegistry.get(e);if(!t){console.warn(`[EventServiceProvider] Model "${e}" not found in registry. Register it with EventServiceProvider.registerModel(${e}).`);continue}for(let i of s)t.observe(new i)}}isListenerClass(e){return typeof e=="function"&&e.prototype&&typeof e.prototype.handle=="function"}static modelRegistry=new Map;static registerModel(e){this.modelRegistry.set(e.name,e)}static registerModels(...e){for(let s of e)this.registerModel(s)}};var d=class{listeners=new Map;wildcardListeners=[];onceListeners=new Map;listen(e,s){let t=typeof e=="string"?e:e.name;return this.listeners.has(t)||this.listeners.set(t,[]),this.listeners.get(t).push(s),()=>{let i=this.listeners.get(t);if(i){let r=i.indexOf(s);r>=0&&i.splice(r,1)}}}once(e,s){let t=typeof e=="string"?e:e.name;return this.onceListeners.has(t)||this.onceListeners.set(t,[]),this.onceListeners.get(t).push(s),()=>{let i=this.onceListeners.get(t);if(i){let r=i.indexOf(s);r>=0&&i.splice(r,1)}}}onAny(e){return this.wildcardListeners.push(e),()=>{let s=this.wildcardListeners.indexOf(e);s>=0&&this.wildcardListeners.splice(s,1)}}async dispatch(e){let s=e.constructor.name,t=this.listeners.get(s)??[];for(let r of t)await r(e);let i=this.onceListeners.get(s)??[];for(let r of i)await r(e);this.onceListeners.delete(s);for(let r of this.wildcardListeners)await r(s,e)}async emit(e,s){let t=this.listeners.get(e)??[];for(let r of t)await r(s);let i=this.onceListeners.get(e)??[];for(let r of i)await r(s);this.onceListeners.delete(e);for(let r of this.wildcardListeners)await r(e,s)}subscribe(e){e.subscribe(this)}forget(e){let s=typeof e=="string"?e:e.name;this.listeners.delete(s),this.onceListeners.delete(s)}flush(){this.listeners.clear(),this.onceListeners.clear(),this.wildcardListeners=[]}hasListeners(e){let s=typeof e=="string"?e:e.name;return(this.listeners.get(s)?.length??0)>0||(this.onceListeners.get(s)?.length??0)>0||this.wildcardListeners.length>0}listenerCount(e){let s=typeof e=="string"?e:e.name;return(this.listeners.get(s)?.length??0)+(this.onceListeners.get(s)?.length??0)}},a=v("svelar.event",()=>new d);export{a as Event,d as EventDispatcher,l as EventServiceProvider,c as Listener};