@beeblock/svelar 0.4.0

package/dist/cli/ts-resolve-hook.mjs

@@ -0,0 +1,74 @@
+/**
+ * ESM resolve hook for Svelar CLI:
+ * 1. Resolves 'svelar' and 'svelar/*' imports directly from THIS package's dist/
+ *    (bypasses node_modules entirely — no symlinks, junctions, or platform issues)
+ * 2. Rewrites .js → .ts when the .js file doesn't exist
+ */
+
+import { existsSync } from 'node:fs';
+import { resolve as pathResolve, sep, dirname } from 'node:path';
+import { fileURLToPath, pathToFileURL } from 'node:url';
+
+// This file lives at <svelar-root>/dist/cli/ts-resolve-hook.mjs
+// So the svelar package root is two directories up from here.
+const thisFileDir = dirname(fileURLToPath(import.meta.url));
+const svelarRoot = pathResolve(thisFileDir, '..', '..');
+
+/**
+ * Resolve 'svelar' or 'svelar/<subpath>' by pointing directly at our own dist/.
+ * This works on every OS because it never touches node_modules or symlinks.
+ */
+function resolveSvelar(specifier) {
+  if (specifier === 'svelar') {
+    const target = pathResolve(svelarRoot, 'dist', 'index.js');
+    if (existsSync(target)) return pathToFileURL(target).href;
+    return null;
+  }
+
+  if (specifier.startsWith('svelar/')) {
+    const subpath = specifier.slice('svelar/'.length); // e.g. 'database', 'orm', 'auth'
+    const target = pathResolve(svelarRoot, 'dist', subpath, 'index.js');
+    if (existsSync(target)) return pathToFileURL(target).href;
+
+    // Also try direct file (e.g. svelar/something.js)
+    const directTarget = pathResolve(svelarRoot, 'dist', subpath + '.js');
+    if (existsSync(directTarget)) return pathToFileURL(directTarget).href;
+
+    return null;
+  }
+
+  return null;
+}
+
+export async function resolve(specifier, context, nextResolve) {
+  // 1. Intercept svelar imports FIRST — before Node tries (and fails) to resolve them
+  if (specifier === 'svelar' || specifier.startsWith('svelar/')) {
+    const resolved = resolveSvelar(specifier);
+    if (resolved) {
+      return { url: resolved, shortCircuit: true };
+    }
+  }
+
+  // 2. Handle relative .js → .ts resolution
+  if (specifier.startsWith('.') && specifier.endsWith('.js')) {
+    try {
+      const parentPath = context.parentURL ? fileURLToPath(context.parentURL) : process.cwd();
+      const parentDir = parentPath.endsWith(sep) || parentPath.endsWith('/')
+        ? parentPath
+        : dirname(parentPath);
+      const jsPath = pathResolve(parentDir, specifier);
+
+      if (!existsSync(jsPath)) {
+        const tsPath = jsPath.replace(/\.js$/, '.ts');
+        if (existsSync(tsPath)) {
+          return { url: pathToFileURL(tsPath).href, shortCircuit: true };
+        }
+      }
+    } catch {
+      // Fall through
+    }
+  }
+
+  // 3. Default resolution
+  return nextResolve(specifier, context);
+}

package/dist/cli/ts-resolver.mjs

@@ -0,0 +1,8 @@
+/**
+ * Register hook: resolves .js imports to .ts files when the .js doesn't exist.
+ * Use with: node --import ./ts-resolver.mjs
+ */
+
+import { register } from 'node:module';
+
+register('./ts-resolve-hook.mjs', import.meta.url);

package/dist/config/Config.d.ts

@@ -0,0 +1,65 @@
+/**
+ * Svelar Config
+ *
+ * Environment-aware configuration management with optional
+ * directory-based config loading (like Laravel's config/ folder).
+ */
+/**
+ * Get an environment variable with an optional default.
+ * Similar to Laravel's env() helper.
+ *
+ * @example
+ * env('DB_HOST', 'localhost')       // string
+ * env<number>('DB_PORT', 5432)      // number
+ * env<boolean>('APP_DEBUG', false)  // boolean
+ */
+export declare function env<T extends string | number | boolean = string>(key: string, defaultValue?: T): T;
+declare class ConfigManager {
+    private items;
+    /**
+     * Clear all configuration
+     */
+    clear(): void;
+    /**
+     * Load configuration from an object
+     */
+    load(config: Record<string, any>): void;
+    /**
+     * Load all config files from a directory.
+     * Each file becomes a top-level config key based on its filename.
+     *
+     * Files must export a default object (or a named `config` export).
+     *
+     * @example
+     * // config/app.ts → config.get('app.name')
+     * // config/database.ts → config.get('database.default')
+     * // config/mail.ts → config.get('mail.driver')
+     *
+     * await config.loadFromDirectory('./config');
+     *
+     * @param dirPath - Path to the config directory (relative to cwd or absolute)
+     */
+    loadFromDirectory(dirPath: string): Promise<string[]>;
+    /**
+     * Get a configuration value using dot notation
+     * @example config.get('database.default') // 'sqlite'
+     */
+    get<T = any>(key: string, defaultValue?: T): T;
+    /**
+     * Set a configuration value using dot notation
+     */
+    set(key: string, value: any): void;
+    /**
+     * Check if a configuration key exists
+     */
+    has(key: string): boolean;
+    /**
+     * Get all configuration as a plain object
+     */
+    all(): Record<string, any>;
+}
+/**
+ * Global config singleton
+ */
+export declare const config: ConfigManager;
+export {};

package/dist/config/index.d.ts

@@ -0,0 +1 @@
+export { config, env } from './Config.js';

package/dist/config/index.js

@@ -0,0 +1 @@
+function h(a,n){let t=Symbol.for(a),e=globalThis;return e[t]||(e[t]=n()),e[t]}function T(a,n){let t=process.env[a];return t===void 0?n!==void 0?n:"":t==="true"?!0:t==="false"?!1:t==="null"?null:/^\d+$/.test(t)?Number(t):t}var u=class{items=new Map;clear(){this.items.clear()}load(n){for(let[t,e]of Object.entries(n))this.set(t,e)}async loadFromDirectory(n){let{resolve:t,basename:e,extname:s}=await import("path"),{existsSync:r,readdirSync:i}=await import("fs"),{pathToFileURL:m}=await import("url"),l=t(n);if(!r(l))return[];let y=i(l).filter(o=>(o.endsWith(".ts")||o.endsWith(".js"))&&!o.startsWith(".")),g=[];for(let o of y){let d=e(o,s(o)),p=t(l,o);try{let f=await import(m(p).href),c=f.default??f.config??f;c&&typeof c=="object"&&!Array.isArray(c)&&(this.set(d,c),g.push(d))}catch{}}return g}get(n,t){let e=n.split("."),s=this.items.get(e[0]);for(let r=1;r<e.length;r++){if(s==null)return t;s=s[e[r]]}return s??t}set(n,t){let e=n.split(".");if(e.length===1){this.items.set(n,t);return}let s=this.items.get(e[0]);(s===void 0||typeof s!="object")&&(s={},this.items.set(e[0],s));let r=s;for(let i=1;i<e.length-1;i++)(r[e[i]]===void 0||typeof r[e[i]]!="object")&&(r[e[i]]={}),r=r[e[i]];r[e[e.length-1]]=t}has(n){return this.get(n)!==void 0}all(){let n={};for(let[t,e]of this.items)n[t]=e;return n}},b=h("svelar.config",()=>new u);export{b as config,T as env};

package/dist/container/Application.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Svelar Application
+ *
+ * Bootstraps the framework by registering and booting all service providers.
+ */
+import { Container } from './Container.js';
+import { ServiceProvider } from './ServiceProvider.js';
+export declare class Application {
+    readonly container: Container;
+    private providers;
+    private booted;
+    constructor(container?: Container);
+    /**
+     * Register a service provider
+     */
+    register(ProviderClass: new (app: Container) => ServiceProvider): this;
+    /**
+     * Bootstrap the application: register all, then boot all
+     */
+    bootstrap(): Promise<this>;
+    /**
+     * Check if the application has been bootstrapped
+     */
+    isBooted(): boolean;
+    /**
+     * Resolve a service from the container
+     */
+    make<T = any>(name: string): Promise<T>;
+    /**
+     * Get the list of registered providers
+     */
+    getProviders(): ServiceProvider[];
+}

package/dist/container/Container.d.ts

@@ -0,0 +1,70 @@
+/**
+ * Svelar IoC Container
+ *
+ * Laravel-inspired service container with dependency injection,
+ * singleton support, and service provider lifecycle.
+ */
+export type Factory<T = any> = (container: Container) => T;
+export type AsyncFactory<T = any> = (container: Container) => T | Promise<T>;
+export declare class Container {
+    private bindings;
+    private aliases;
+    private resolved;
+    /**
+     * Register a binding in the container
+     */
+    bind<T>(name: string, factory: AsyncFactory<T>): void;
+    /**
+     * Register a singleton binding (resolved once, then cached)
+     */
+    singleton<T>(name: string, factory: AsyncFactory<T>): void;
+    /**
+     * Register an existing instance as a singleton
+     */
+    instance<T>(name: string, value: T): void;
+    /**
+     * Create an alias for a binding
+     */
+    alias(alias: string, target: string): void;
+    /**
+     * Resolve a binding from the container
+     */
+    make<T = any>(name: string): Promise<T>;
+    /**
+     * Synchronous resolve (only works for already-resolved singletons or sync factories)
+     */
+    makeSync<T = any>(name: string): T;
+    /**
+     * Check if a binding exists
+     */
+    has(name: string): boolean;
+    /**
+     * Check if a binding has been resolved
+     */
+    isResolved(name: string): boolean;
+    /**
+     * Tag bindings for group resolution
+     */
+    tag(names: string[], tag: string): void;
+    /**
+     * Resolve all bindings with a given tag
+     */
+    tagged<T = any>(tag: string): Promise<T[]>;
+    /**
+     * Flush all resolved singletons (useful for testing)
+     */
+    flush(): void;
+    /**
+     * Remove a binding entirely
+     */
+    forget(name: string): void;
+    /**
+     * Get all binding names
+     */
+    getBindings(): string[];
+    private resolveAlias;
+}
+/**
+ * Global application container
+ */
+export declare const container: Container;

package/dist/container/ServiceProvider.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Svelar Service Provider
+ *
+ * Base class for registering services into the IoC container.
+ * Follows Laravel's register/boot lifecycle.
+ */
+import { Container } from './Container.js';
+export declare abstract class ServiceProvider {
+    protected app: Container;
+    constructor(app: Container);
+    /**
+     * Register bindings into the container.
+     * Called before any provider is booted.
+     */
+    abstract register(): void | Promise<void>;
+    /**
+     * Bootstrap services after all providers are registered.
+     * Use this for logic that depends on other services being available.
+     */
+    boot(): void | Promise<void>;
+}

package/dist/container/index.d.ts

@@ -0,0 +1,3 @@
+export { Container, container, type Factory, type AsyncFactory } from './Container.js';
+export { ServiceProvider } from './ServiceProvider.js';
+export { Application } from './Application.js';

package/dist/container/index.js

@@ -0,0 +1 @@
+function c(r,n){let i=Symbol.for(r),t=globalThis;return t[i]||(t[i]=n()),t[i]}var e=class{bindings=new Map;aliases=new Map;resolved=new Set;bind(n,i){this.bindings.set(n,{factory:i,singleton:!1,tags:[]})}singleton(n,i){this.bindings.set(n,{factory:i,singleton:!0,tags:[]})}instance(n,i){this.bindings.set(n,{factory:()=>i,singleton:!0,instance:i,tags:[]})}alias(n,i){this.aliases.set(n,i)}async make(n){let i=this.resolveAlias(n),t=this.bindings.get(i);if(!t)throw new Error(`No binding found for "${n}" in the container.`);if(t.singleton&&t.instance!==void 0)return t.instance;let s=await t.factory(this);return t.singleton&&(t.instance=s),this.resolved.add(i),s}makeSync(n){let i=this.resolveAlias(n),t=this.bindings.get(i);if(!t)throw new Error(`No binding found for "${n}" in the container.`);if(t.singleton&&t.instance!==void 0)return t.instance;let s=t.factory(this);if(s instanceof Promise)throw new Error(`Binding "${n}" has an async factory. Use container.make() instead of container.makeSync().`);return t.singleton&&(t.instance=s),this.resolved.add(i),s}has(n){let i=this.resolveAlias(n);return this.bindings.has(i)}isResolved(n){return this.resolved.has(this.resolveAlias(n))}tag(n,i){for(let t of n){let s=this.bindings.get(t);s&&s.tags.push(i)}}async tagged(n){let i=[];for(let[t,s]of this.bindings)s.tags.includes(n)&&i.push(await this.make(t));return i}flush(){for(let n of this.bindings.values())n.singleton&&(n.instance=void 0);this.resolved.clear()}forget(n){this.bindings.delete(n),this.resolved.delete(n)}getBindings(){return[...this.bindings.keys()]}resolveAlias(n){return this.aliases.get(n)??n}},d=c("svelar.container",()=>new e);var o=class{app;constructor(n){this.app=n}boot(){}};var a=class{container;providers=[];booted=!1;constructor(n){this.container=n??new e,this.container.instance("app",this),this.container.instance("container",this.container)}register(n){let i=new n(this.container);return this.providers.push(i),this}async bootstrap(){if(this.booted)return this;for(let n of this.providers)await n.register();for(let n of this.providers)await n.boot();return this.booted=!0,this}isBooted(){return this.booted}async make(n){return this.container.make(n)}getProviders(){return[...this.providers]}};export{a as Application,e as Container,o as ServiceProvider,d as container};

package/dist/dashboard/index.d.ts

@@ -0,0 +1,123 @@
+/**
+ * Svelar Admin Dashboard Plugin
+ *
+ * Provides a centralized admin dashboard that aggregates system health,
+ * queue metrics, scheduler status, and logs for monitoring and management.
+ *
+ * @example
+ * ```ts
+ * import { Dashboard, configureDashboard, getDashboardHealth } from 'svelar/dashboard';
+ *
+ * // Configure the dashboard
+ * configureDashboard({
+ *   enabled: true,
+ *   prefix: '/admin/dashboard',
+ *   refreshInterval: 5000,
+ * });
+ *
+ * // Get system health
+ * const health = getDashboardHealth();
+ * console.log(`Uptime: ${health.uptime}ms`);
+ *
+ * // Get full dashboard data
+ * const data = Dashboard.getDashboardData();
+ * ```
+ */
+import type { Container } from '../container/Container.js';
+import { Plugin } from '../plugins/index.js';
+import { type QueueHealth } from '../queue/JobMonitor.js';
+import { type SchedulerHealth } from '../scheduler/ScheduleMonitor.js';
+export interface DashboardConfig {
+    /** Enable or disable the dashboard */
+    enabled?: boolean;
+    /** Route prefix for dashboard endpoints (default: '/admin/dashboard') */
+    prefix?: string;
+    /** Interval in ms for automatic health collection (default: 5000) */
+    refreshInterval?: number;
+    /** Section visibility toggles */
+    sections?: {
+        logs?: boolean;
+        queue?: boolean;
+        scheduler?: boolean;
+        system?: boolean;
+    };
+}
+export interface SystemHealth {
+    status: 'healthy' | 'degraded' | 'critical';
+    uptime: number;
+    nodeVersion: string;
+    memoryUsage: {
+        heapUsed: number;
+        heapTotal: number;
+        rss: number;
+        external: number;
+    };
+    cpuUsage: {
+        user: number;
+        system: number;
+    };
+    queueHealth: QueueHealth;
+    schedulerHealth: SchedulerHealth;
+    logStats: {
+        totalEntries: number;
+        byLevel: Record<string, number>;
+        byChannel: Record<string, number>;
+    };
+    timestamp: string;
+}
+declare class DashboardPlugin extends Plugin {
+    readonly name = "svelar-dashboard";
+    readonly version = "1.0.0";
+    readonly description = "Admin dashboard with system health monitoring";
+    private dashboardConfig;
+    private startTime;
+    private healthCollectionInterval;
+    /**
+     * Return plugin configuration
+     */
+    config(): {
+        key: string;
+        defaults: Required<DashboardConfig>;
+    };
+    /**
+     * Register services and configuration
+     */
+    register(app: Container): Promise<void>;
+    /**
+     * Bootstrap the dashboard plugin
+     */
+    boot(app: Container): Promise<void>;
+    /**
+     * Clean up on shutdown
+     */
+    shutdown(): Promise<void>;
+    /**
+     * Update dashboard configuration
+     */
+    setConfig(config: DashboardConfig): void;
+    /**
+     * Get aggregated system health from all monitors
+     */
+    getSystemHealth(): Promise<SystemHealth>;
+    /**
+     * Get complete dashboard data with all sections
+     */
+    getDashboardData(): Promise<Record<string, any>>;
+}
+/**
+ * Global Dashboard singleton
+ */
+export declare const Dashboard: DashboardPlugin;
+/**
+ * Configure the dashboard
+ */
+export declare function configureDashboard(config: DashboardConfig): void;
+/**
+ * Quick access to system health
+ */
+export declare function getDashboardHealth(): Promise<SystemHealth>;
+/**
+ * Quick access to full dashboard data
+ */
+export declare function getDashboardData(): Promise<Record<string, any>>;
+export {};

package/dist/dashboard/index.js

@@ -0,0 +1,5 @@
+var x=Object.defineProperty;var T=(l,e)=>()=>(l&&(e=l(l=0)),e);var N=(l,e)=>{for(var t in e)x(l,t,{get:e[t],enumerable:!0})};function d(l,e){let t=Symbol.for(l),s=globalThis;return s[t]||(s[t]=e()),s[t]}var g=T(()=>{"use strict"});var f={};N(f,{Connection:()=>A});var C,A,p=T(()=>{"use strict";g();C=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 s=this.config.connections[t];if(!s)throw new Error(`Database connection "${t}" is not defined in configuration.`);let n=await this.createConnection(s);return this.connections.set(t,n),n.drizzle}async rawClient(e){let t=e??this.defaultName;return await this.connection(t),this.connections.get(t).rawClient}async raw(e,t=[],s){let n=await this.connection(s),r=this.getConfig(s);switch(r.driver){case"sqlite":{let i=await this.rawClient(s),a=t.map(c=>typeof c=="boolean"?c?1:0:c instanceof Date?c.toISOString():c),o=i.prepare(e),u=e.trimStart().toUpperCase();return u.startsWith("SELECT")||u.startsWith("PRAGMA")||u.startsWith("WITH")?o.all(...a):o.run(...a)}case"postgres":return(await this.rawClient(s))(e,...t);case"mysql":{let i=await this.rawClient(s),[a]=await i.execute(e,t);return a}default:throw new Error(`Unsupported driver: ${r.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 s=this.config.connections[t];if(!s)throw new Error(`Database connection "${t}" is not defined.`);return s}async disconnect(e){if(e){let t=this.connections.get(e);t&&(await this.closeConnection(t),this.connections.delete(e))}else{for(let[t,s]of this.connections)await this.closeConnection(s);this.connections.clear()}}isConnected(e){return this.connections.has(e??this.defaultName)}async transaction(e,t){let s=this.getConfig(t),n=await this.rawClient(t);switch(s.driver){case"sqlite":{n.exec("BEGIN");try{let r=await e();return n.exec("COMMIT"),r}catch(r){throw n.exec("ROLLBACK"),r}}case"postgres":{await n`BEGIN`;try{let r=await e();return await n`COMMIT`,r}catch(r){throw await n`ROLLBACK`,r}}case"mysql":{let r=await n.getConnection();await r.beginTransaction();try{let i=await e();return await r.commit(),r.release(),i}catch(i){throw await r.rollback(),r.release(),i}}default:throw new Error(`Unsupported driver: ${s.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 s=(await import("better-sqlite3")).default,{drizzle:n}=await import("drizzle-orm/better-sqlite3"),r=new s(t);return r.pragma("journal_mode = WAL"),r.pragma("foreign_keys = ON"),{drizzle:n(r),config:e,rawClient:r}}catch(s){let n;try{n=(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: ${s instanceof Error?s.message:String(s)}`)}let r=new n(t);r.exec("PRAGMA journal_mode = WAL"),r.exec("PRAGMA foreign_keys = ON");let i={prepare(o){let u=r.prepare(o);return{all(...c){return u.all(...c)},run(...c){return u.run(...c)},get(...c){return u.get(...c)}}},exec(o){r.exec(o)},pragma(o){return r.prepare(`PRAGMA ${o}`).all()},close(){r.close()}},a;try{let{drizzle:o}=await import("drizzle-orm/better-sqlite3");a=o(i)}catch{a=i}return{drizzle:a,config:e,rawClient:i}}}async createPostgresConnection(e){let t=(await import("postgres")).default,{drizzle:s}=await import("drizzle-orm/postgres-js"),n=e.url??`postgres://${e.user}:${e.password}@${e.host??"localhost"}:${e.port??5432}/${e.database}`,r=t(n);return{drizzle:s(r),config:e,rawClient:r}}async createMySQLConnection(e){let t=await import("mysql2/promise"),{drizzle:s}=await import("drizzle-orm/mysql2"),n=t.createPool({host:e.host??"localhost",port:e.port??3306,database:e.database,user:e.user,password:e.password,uri:e.url});return{drizzle:s(n),config:e,rawClient:n}}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{}}},A=d("svelar.connection",()=>new C)});import{hostname as O}from"os";var Q,L=T(()=>{"use strict";Q=`${O()}:${process.pid}:${Math.random().toString(36).slice(2,10)}`});var y=class{description;dependencies;async register(e){}async boot(e){}async shutdown(){}migrations(){return[]}config(){return null}middleware(){return[]}commands(){return[]}routes(){return[]}listeners(){return[]}publishables(){return{}}};g();g();var E=class{ringBuffer=[];maxSize=1e4;currentIndex=0;tailSubscribers=[];addEntry(e){let t={timestamp:e.timestamp,level:e.level,channel:e.channel??"default",message:e.message,context:e.context};this.ringBuffer.length<this.maxSize?this.ringBuffer.push(t):(this.ringBuffer[this.currentIndex]=t,this.currentIndex=(this.currentIndex+1)%this.maxSize);for(let s of this.tailSubscribers)try{s(t)}catch{}}query(e={}){let t=this.getAllEntries();if(e.level){let r={debug:0,info:1,warn:2,error:3,fatal:4},i=r[e.level];t=t.filter(a=>r[a.level]>=i)}if(e.channel&&(t=t.filter(r=>r.channel===e.channel)),e.since){let r=e.since.getTime();t=t.filter(i=>new Date(i.timestamp).getTime()>=r)}if(e.until){let r=e.until.getTime();t=t.filter(i=>new Date(i.timestamp).getTime()<=r)}if(e.search){let r=e.search.toLowerCase();t=t.filter(i=>i.message.toLowerCase().includes(r)||JSON.stringify(i.context).toLowerCase().includes(r))}let s=e.offset??0,n=e.limit??100;return t.slice(s,s+n)}getStats(){let e=this.getAllEntries(),t={totalEntries:e.length,byLevel:{},byChannel:{}};for(let s of e)t.byLevel[s.level]=(t.byLevel[s.level]??0)+1,t.byChannel[s.channel]=(t.byChannel[s.channel]??0)+1;return t}getRecentErrors(e=10){return this.getAllEntries().filter(s=>s.level==="error"||s.level==="fatal").slice(-e).reverse()}clear(){this.ringBuffer=[],this.currentIndex=0}tail(e,t){let s=t?n=>{this.matchesFilter(n,t)&&e(n)}:e;return this.tailSubscribers.push(s),()=>{let n=this.tailSubscribers.indexOf(s);n>-1&&this.tailSubscribers.splice(n,1)}}getAllEntries(){return this.ringBuffer.length<this.maxSize?[...this.ringBuffer]:[...this.ringBuffer.slice(this.currentIndex),...this.ringBuffer.slice(0,this.currentIndex)]}matchesFilter(e,t){if(t.level){let s={debug:0,info:1,warn:2,error:3,fatal:4},n=s[t.level];if(s[e.level]<n)return!1}if(t.channel&&e.channel!==t.channel)return!1;if(t.since){let s=t.since.getTime();if(new Date(e.timestamp).getTime()<s)return!1}if(t.until){let s=t.until.getTime();if(new Date(e.timestamp).getTime()>s)return!1}if(t.search){let s=t.search.toLowerCase();if(!(e.message.toLowerCase().includes(s)||JSON.stringify(e.context).toLowerCase().includes(s)))return!1}return!0}},m=d("svelar.logViewer",()=>new E);g();var k=class{_config=null;_bullmq=null;_metrics={processed:[],failed:[]};configure(e){this._config=e}recordProcessed(){this._metrics.processed.push(Date.now());let e=Date.now()-36e5;this._metrics.processed=this._metrics.processed.filter(t=>t>e)}recordFailed(){this._metrics.failed.push(Date.now());let e=Date.now()-36e5;this._metrics.failed=this._metrics.failed.filter(t=>t>e)}async getCounts(e="default"){let t=this._config?.connections[this._config.default]?.driver;return t==="redis"?this._getRedisJobCounts(e):t==="database"?this._getDatabaseJobCounts(e):{waiting:0,active:0,completed:0,failed:0,delayed:0,total:0}}async listJobs(e={}){let t=this._config?.connections[this._config.default]?.driver;return t==="redis"?this._listRedisJobs(e):t==="database"?this._listDatabaseJobs(e):[]}async getJob(e){let t=this._config?.connections[this._config.default]?.driver;return t==="redis"?this._getRedisJob(e):t==="database"?this._getDatabaseJob(e):null}async retryJob(e){let t=this._config?.connections[this._config.default]?.driver;return t==="redis"?this._retryRedisJob(e):t==="database"?this._retryDatabaseJob(e):!1}async deleteJob(e){let t=this._config?.connections[this._config.default]?.driver;return t==="redis"?this._deleteRedisJob(e):t==="database"?this._deleteDatabaseJob(e):!1}async getHealth(){let e=this._config?.connections[this._config.default]?.driver??"sync",t=await this.getCounts("default"),s=Date.now()-36e5,n=this._metrics.processed.filter(a=>a>s).length,r=this._metrics.failed.filter(a=>a>s).length,i=n+r;return{driver:e,queues:{default:t},failureRate:i>0?r/i*100:0,throughput:n}}async flushCompleted(e="default"){return this._config?.connections[this._config.default]?.driver==="redis"?this._flushRedisCompleted(e):0}async flushFailed(e="default"){let t=this._config?.connections[this._config.default]?.driver;return t==="redis"?this._flushRedisFailed(e):t==="database"?this._flushDatabaseFailed(e):0}async getBullMQ(){if(this._bullmq)return this._bullmq;try{return this._bullmq=await Function('return import("bullmq")')(),this._bullmq}catch{throw new Error("bullmq is required for the Redis queue monitor.")}}getRedisConnection(){let e=this._config?.connections[this._config.default]??{};if(e.url){let t=new URL(e.url);return{host:t.hostname||"localhost",port:parseInt(t.port)||6379,password:t.password||e.password||void 0,db:parseInt(t.pathname?.slice(1)||"0")||e.db||0}}return{host:e.host??"localhost",port:e.port??6379,password:e.password,db:e.db??0}}async getRedisQueue(e){let t=await this.getBullMQ(),s=this.getRedisConnection(),n=this._config?.connections[this._config.default]??{};return new t.Queue(e,{connection:s,prefix:n.prefix??"svelar"})}async _getRedisJobCounts(e){let t=await this.getRedisQueue(e);try{let s=await t.getJobCounts("waiting","active","completed","failed","delayed");return{waiting:s.waiting??0,active:s.active??0,completed:s.completed??0,failed:s.failed??0,delayed:s.delayed??0,total:(s.waiting??0)+(s.active??0)+(s.completed??0)+(s.failed??0)+(s.delayed??0)}}finally{await t.close()}}async _listRedisJobs(e){let t=await this.getRedisQueue(e.queue??"default"),s=e.limit??50,n=e.offset??0;try{let r;return e.status?r=await t.getJobs([e.status],n,n+s-1):r=await t.getJobs(["waiting","active","completed","failed","delayed"],n,n+s-1),r.filter(i=>i!=null).filter(i=>!e.jobClass||i.name===e.jobClass).map(i=>this._bullmqJobToInfo(i))}finally{await t.close()}}async _getRedisJob(e){let t=await this.getRedisQueue("default");try{let s=await t.getJob(e);return s?this._bullmqJobToInfo(s):null}finally{await t.close()}}async _retryRedisJob(e){let t=await this.getRedisQueue("default");try{let s=await t.getJob(e);return s?(await s.retry(),!0):!1}catch{return!1}finally{await t.close()}}async _deleteRedisJob(e){let t=await this.getRedisQueue("default");try{let s=await t.getJob(e);return s?(await s.remove(),!0):!1}catch{return!1}finally{await t.close()}}async _flushRedisCompleted(e){let t=await this.getRedisQueue(e);try{let s=await t.getJobs(["completed"]),n=0;for(let r of s)r&&(await r.remove(),n++);return n}finally{await t.close()}}async _flushRedisFailed(e){let t=await this.getRedisQueue(e);try{let s=await t.getJobs(["failed"]),n=0;for(let r of s)r&&(await r.remove(),n++);return n}finally{await t.close()}}_bullmqJobToInfo(e){let t=e.finishedOn?e.failedReason?"failed":"completed":e.delay&&e.delay>0&&!e.processedOn?"delayed":e.processedOn?"active":"waiting";return{id:e.id,jobClass:e.name??e.data?.jobClass??"Unknown",queue:e.queueName??"default",status:t,attempts:e.attemptsMade??0,maxAttempts:e.opts?.attempts??3,payload:JSON.stringify(e.data??{}),error:e.failedReason??void 0,createdAt:e.timestamp??Date.now(),processedAt:e.processedOn??void 0,failedAt:e.failedReason?e.finishedOn:void 0,delayedUntil:e.delay?e.timestamp+e.delay:void 0}}async getDbConnection(){let{Connection:e}=await Promise.resolve().then(()=>(p(),f));return e}getDbTable(){return this._config?.connections[this._config.default]?.table??"svelar_jobs"}async _getDatabaseJobCounts(e){let t=await this.getDbConnection(),s=this.getDbTable(),n=Math.floor(Date.now()/1e3),i=(await t.raw(`SELECT
+         SUM(CASE WHEN reserved_at IS NULL AND available_at <= ? THEN 1 ELSE 0 END) as waiting,
+         SUM(CASE WHEN reserved_at IS NOT NULL THEN 1 ELSE 0 END) as active,
+         SUM(CASE WHEN reserved_at IS NULL AND available_at > ? THEN 1 ELSE 0 END) as delayed
+       FROM ${s} WHERE queue = ?`,[n,n,e]))?.[0]??{},a=Number(i.waiting)||0,o=Number(i.active)||0,u=Number(i.delayed)||0;return{waiting:a,active:o,completed:0,failed:0,delayed:u,total:a+o+u}}async _listDatabaseJobs(e){let t=await this.getDbConnection(),s=this.getDbTable(),n=e.limit??50,r=e.offset??0,i=Math.floor(Date.now()/1e3),a="WHERE 1=1",o=[];return e.queue&&(a+=" AND queue = ?",o.push(e.queue)),e.status==="waiting"?(a+=" AND reserved_at IS NULL AND available_at <= ?",o.push(i)):e.status==="active"?a+=" AND reserved_at IS NOT NULL":e.status==="delayed"&&(a+=" AND reserved_at IS NULL AND available_at > ?",o.push(i)),o.push(n,r),(await t.raw(`SELECT * FROM ${s} ${a} ORDER BY created_at DESC LIMIT ? OFFSET ?`,o)??[]).map(c=>{let v=JSON.parse(c.payload??"{}"),h=c.reserved_at!=null,I=!h&&c.available_at>i;return{id:c.id,jobClass:v.jobClass??"Unknown",queue:c.queue,status:h?"active":I?"delayed":"waiting",attempts:c.attempts??0,maxAttempts:c.max_attempts??3,payload:c.payload,createdAt:(c.created_at??0)*1e3,delayedUntil:I?c.available_at*1e3:void 0}})}async _getDatabaseJob(e){let t=await this.getDbConnection(),s=this.getDbTable(),n=await t.raw(`SELECT * FROM ${s} WHERE id = ?`,[e]);if(!n||n.length===0)return null;let r=n[0],i=JSON.parse(r.payload??"{}"),a=Math.floor(Date.now()/1e3);return{id:r.id,jobClass:i.jobClass??"Unknown",queue:r.queue,status:r.reserved_at?"active":r.available_at>a?"delayed":"waiting",attempts:r.attempts??0,maxAttempts:r.max_attempts??3,payload:r.payload,createdAt:(r.created_at??0)*1e3}}async _retryDatabaseJob(e){let t=await this.getDbConnection(),s=this.getDbTable(),n=Math.floor(Date.now()/1e3);try{return await t.raw(`UPDATE ${s} SET reserved_at = NULL, available_at = ?, attempts = 0 WHERE id = ?`,[n,e]),!0}catch{return!1}}async _deleteDatabaseJob(e){let t=await this.getDbConnection(),s=this.getDbTable();try{return await t.raw(`DELETE FROM ${s} WHERE id = ?`,[e]),!0}catch{return!1}}async _flushDatabaseFailed(e){let t=await this.getDbConnection(),s=this.getDbTable();return 0}},_=d("svelar.jobMonitor",()=>new k);L();function b(l,e,t){if(l==="*")return null;let s=new Set;for(let n of l.split(",")){let[r,i]=n.split("/"),a=i?parseInt(i,10):1;if(r==="*")for(let o=e;o<=t;o+=a)s.add(o);else if(r.includes("-")){let[o,u]=r.split("-"),c=parseInt(o,10),v=parseInt(u,10);for(let h=c;h<=v;h+=a)s.add(h)}else s.add(parseInt(r,10))}return[...s].sort((n,r)=>n-r)}function M(l){let e=l.trim().split(/\s+/);if(e.length!==5)throw new Error(`Invalid cron expression: "${l}". Expected 5 fields.`);return{minute:b(e[0],0,59),hour:b(e[1],0,23),dayOfMonth:b(e[2],1,31),month:b(e[3],1,12),dayOfWeek:b(e[4],0,6)}}function P(l,e){let t=M(l),s=e.getMinutes(),n=e.getHours(),r=e.getDate(),i=e.getMonth()+1,a=e.getDay();return!(t.minute&&!t.minute.includes(s)||t.hour&&!t.hour.includes(n)||t.dayOfMonth&&!t.dayOfMonth.includes(r)||t.month&&!t.month.includes(i)||t.dayOfWeek&&!t.dayOfWeek.includes(a))}g();var R=class{scheduler=null;startTime=new Date;taskEnabled=new Map;configure(e){this.scheduler=e,this.startTime=new Date;for(let t of e.getTasks())this.taskEnabled.has(t.name)||this.taskEnabled.set(t.name,!0)}async listTasks(){if(!this.scheduler)return[];let e=this.scheduler.getTasks(),t=await this.loadHistoryFromDb(e.map(s=>s.name));return e.map(s=>this.createTaskInfo(s,t.get(s.name)||[]))}async getTask(e){if(!this.scheduler)return null;let t=this.scheduler.getTasks().find(n=>n.name===e);if(!t)return null;let s=await this.loadHistoryFromDb([e]);return this.createTaskInfo(t,s.get(e)||[])}enableTask(e){this.taskEnabled.set(e,!0)}disableTask(e){this.taskEnabled.set(e,!1)}async runTask(e){if(!this.scheduler)throw new Error("Scheduler not configured");if(this.taskEnabled.has(e)&&!this.taskEnabled.get(e))throw new Error(`Task "${e}" is disabled`);let t=this.scheduler.getTasks().find(n=>n.name===e);if(!t)throw new Error(`Task "${e}" not found`);let s=await t.executeTask();await this.persistResult(s).catch(()=>{})}async getTaskHistory(e,t=10){return(await this.loadHistoryFromDb([e],t)).get(e)||[]}async getHealth(){if(!this.scheduler)return{totalTasks:0,enabledTasks:0,runningTasks:0,lastErrors:[],uptime:0};let e=this.scheduler.getTasks(),t=e.filter(i=>!this.taskEnabled.has(i.name)||this.taskEnabled.get(i.name)).length,s=e.filter(i=>i.isRunning()).length,n=[];try{let{Connection:i}=await Promise.resolve().then(()=>(p(),f)),a=await i.raw("SELECT task, error, ran_at FROM scheduled_task_runs WHERE error IS NOT NULL ORDER BY ran_at DESC LIMIT 10");for(let o of a)n.push({task:o.task,error:o.error,timestamp:new Date(o.ran_at)})}catch{}let r=Date.now()-this.startTime.getTime();return{totalTasks:e.length,enabledTasks:t,runningTasks:s,lastErrors:n,uptime:r}}async loadHistoryFromDb(e,t=20){let s=new Map;if(e.length===0)return s;try{let{Connection:n}=await Promise.resolve().then(()=>(p(),f)),r=e.map(()=>"?").join(", "),i=await n.raw(`SELECT task, success, duration, error, ran_at FROM scheduled_task_runs WHERE task IN (${r}) ORDER BY ran_at DESC LIMIT ?`,[...e,e.length*t]);for(let a of i){s.has(a.task)||s.set(a.task,[]);let o=s.get(a.task);o.length<t&&o.push({timestamp:new Date(a.ran_at),success:!!a.success,duration:a.duration,error:a.error||void 0})}}catch{}return s}async persistResult(e){let{Connection:t}=await Promise.resolve().then(()=>(p(),f));await t.raw("INSERT INTO scheduled_task_runs (task, success, duration, error, ran_at) VALUES (?, ?, ?, ?, ?)",[e.task,e.success,e.duration,e.error||null,e.timestamp.toISOString()])}createTaskInfo(e,t){let s=e.getExpression(),n=t.length>0?t[0]:null,r=!this.taskEnabled.has(e.name)||this.taskEnabled.get(e.name)===!0;return{name:e.name,expression:s,humanReadable:this.humanizeExpression(s),nextRun:this.getNextRun(s),lastRun:n?.timestamp,lastDuration:n?.duration,lastStatus:n?.success?"success":"failed",enabled:r,isRunning:e.isRunning(),history:t.slice(0,5)}}humanizeExpression(e){let t=e.trim().split(/\s+/);if(t.length!==5)return e;let[s,n,r,i,a]=t;if(e==="* * * * *")return"Every minute";if(e==="*/5 * * * *")return"Every 5 minutes";if(e==="*/10 * * * *")return"Every 10 minutes";if(e==="*/15 * * * *")return"Every 15 minutes";if(e==="*/30 * * * *")return"Every 30 minutes";if(e==="0 * * * *")return"Every hour";if(e==="0 0 * * *")return"Daily at midnight";if(e==="0 0 * * 0")return"Weekly (Sunday at midnight)";if(e==="0 0 1 * *")return"Monthly (1st at midnight)";if(e==="0 0 1 1 *")return"Yearly (Jan 1st at midnight)";if(r==="*"&&i==="*"&&a==="*"&&n!=="*"&&s!=="*"){let o=parseInt(n,10),u=parseInt(s,10);return`Daily at ${o.toString().padStart(2,"0")}:${u.toString().padStart(2,"0")}`}if(a==="1-5"&&r==="*"&&i==="*"&&n!=="*"&&s!=="*"){let o=parseInt(n,10),u=parseInt(s,10);return`Weekdays at ${o.toString().padStart(2,"0")}:${u.toString().padStart(2,"0")}`}return e}getNextRun(e){let t=new Date,s=new Date(t);s.setSeconds(0),s.setMilliseconds(0),s.setMinutes(s.getMinutes()+1);let n=366*24*60,r=0;for(;r<n;){if(P(e,s))return s;s.setMinutes(s.getMinutes()+1),r++}return t}},w=d("svelar.scheduleMonitor",()=>new R);var D=class extends y{name="svelar-dashboard";version="1.0.0";description="Admin dashboard with system health monitoring";dashboardConfig={enabled:!0,prefix:"/admin/dashboard",refreshInterval:5e3,sections:{logs:!0,queue:!0,scheduler:!0,system:!0}};startTime=Date.now();healthCollectionInterval=null;config(){return{key:"dashboard",defaults:this.dashboardConfig}}async register(e){e.instance("config.dashboard",this.dashboardConfig),e.instance("svelar.logViewer",m),e.instance("svelar.jobMonitor",_),e.instance("svelar.scheduleMonitor",w)}async boot(e){this.dashboardConfig.enabled&&this.dashboardConfig.refreshInterval>0&&(this.healthCollectionInterval=setInterval(()=>{this.getSystemHealth().catch(t=>{console.error("[Dashboard] Health collection error:",t)})},this.dashboardConfig.refreshInterval))}async shutdown(){this.healthCollectionInterval&&(clearInterval(this.healthCollectionInterval),this.healthCollectionInterval=null)}setConfig(e){this.dashboardConfig={...this.dashboardConfig,...e,sections:{...this.dashboardConfig.sections,...e.sections??{}}},this.healthCollectionInterval&&(clearInterval(this.healthCollectionInterval),this.healthCollectionInterval=null),this.dashboardConfig.enabled&&this.dashboardConfig.refreshInterval>0&&(this.healthCollectionInterval=setInterval(()=>{this.getSystemHealth().catch(t=>{console.error("[Dashboard] Health collection error:",t)})},this.dashboardConfig.refreshInterval))}async getSystemHealth(){let e=Date.now()-this.startTime,t=process.memoryUsage(),s=process.cpuUsage(),n=await _.getHealth(),r=await w.getHealth(),i=m.getStats(),a="healthy";return n.failureRate>50||r.lastErrors.length>5?a="critical":(n.failureRate>20||r.lastErrors.length>2)&&(a="degraded"),t.heapUsed/t.heapTotal*100>90&&(a=a==="healthy"?"degraded":a),{status:a,uptime:e,nodeVersion:process.version,memoryUsage:{heapUsed:t.heapUsed,heapTotal:t.heapTotal,rss:t.rss,external:t.external},cpuUsage:{user:s.user,system:s.system},queueHealth:n,schedulerHealth:r,logStats:i,timestamp:new Date().toISOString()}}async getDashboardData(){let e=await this.getSystemHealth(),t={health:e,config:this.dashboardConfig};return this.dashboardConfig.sections.logs&&(t.logs={stats:m.getStats(),recentErrors:m.getRecentErrors(20)}),this.dashboardConfig.sections.queue&&(t.queue={health:e.queueHealth}),this.dashboardConfig.sections.scheduler&&(t.scheduler={health:e.schedulerHealth,tasks:await w.listTasks()}),this.dashboardConfig.sections.system&&(t.system={uptime:e.uptime,nodeVersion:e.nodeVersion,memoryUsage:e.memoryUsage,cpuUsage:e.cpuUsage}),t}},S=d("svelar.dashboard",()=>new D);function ie(l){S.setConfig(l)}async function ae(){return S.getSystemHealth()}async function oe(){return S.getDashboardData()}export{S as Dashboard,ie as configureDashboard,oe as getDashboardData,ae as getDashboardHealth};

package/dist/database/Connection.d.ts

@@ -0,0 +1,80 @@
+/**
+ * Svelar Database Connection
+ *
+ * Manages database connections with support for SQLite, PostgreSQL, and MySQL.
+ * Wraps Drizzle ORM for the underlying driver.
+ */
+export type DatabaseDriver = 'sqlite' | 'postgres' | 'mysql';
+export interface DatabaseConfig {
+    driver: DatabaseDriver;
+    /** SQLite file path */
+    filename?: string;
+    /** Host for postgres/mysql */
+    host?: string;
+    /** Port for postgres/mysql */
+    port?: number;
+    /** Database name */
+    database?: string;
+    /** Database user */
+    user?: string;
+    /** Database password */
+    password?: string;
+    /** Connection URL (alternative to individual fields) */
+    url?: string;
+    /** Enable debug/query logging */
+    debug?: boolean;
+}
+export interface ConnectionsConfig {
+    default: DatabaseDriver;
+    connections: Record<string, DatabaseConfig>;
+}
+export type DrizzleInstance = any;
+declare class ConnectionManager {
+    private connections;
+    private config;
+    private defaultName;
+    /**
+     * Initialize the connection manager with configuration
+     */
+    configure(config: ConnectionsConfig): void;
+    /**
+     * Get or create a database connection by name
+     */
+    connection(name?: string): Promise<DrizzleInstance>;
+    /**
+     * Get the raw client (e.g. better-sqlite3 Database, pg Pool, mysql2 connection)
+     */
+    rawClient(name?: string): Promise<any>;
+    /**
+     * Execute raw SQL
+     */
+    raw(sql: string, bindings?: any[], connectionName?: string): Promise<any>;
+    /**
+     * Get the driver type for a connection
+     */
+    getDriver(name?: string): DatabaseDriver;
+    /**
+     * Get connection config
+     */
+    getConfig(name?: string): DatabaseConfig;
+    /**
+     * Close all connections
+     */
+    disconnect(name?: string): Promise<void>;
+    /**
+     * Check if a connection is active
+     */
+    isConnected(name?: string): boolean;
+    /**
+     * Run a callback inside a database transaction.
+     * Automatically commits on success, rolls back on error.
+     */
+    transaction<T>(callback: () => Promise<T>, connectionName?: string): Promise<T>;
+    private createConnection;
+    private createSQLiteConnection;
+    private createPostgresConnection;
+    private createMySQLConnection;
+    private closeConnection;
+}
+export declare const Connection: ConnectionManager;
+export {};

package/dist/database/Migration.d.ts

@@ -0,0 +1,76 @@
+/**
+ * Svelar Migration System
+ *
+ * Laravel-like database migrations with up/down support,
+ * batch tracking, and rollback capabilities.
+ */
+import { Schema } from './SchemaBuilder.js';
+export declare abstract class Migration {
+    protected schema: Schema;
+    /** Apply the migration */
+    abstract up(): Promise<void>;
+    /** Reverse the migration */
+    abstract down(): Promise<void>;
+}
+export interface MigrationFile {
+    name: string;
+    timestamp: string;
+    path: string;
+    migration: Migration;
+}
+export declare class Migrator {
+    private migrationsTable;
+    private connectionName?;
+    constructor(connectionName?: string);
+    /**
+     * Ensure the migrations tracking table exists
+     */
+    ensureMigrationsTable(): Promise<void>;
+    /**
+     * Run all pending migrations
+     */
+    run(migrations: MigrationFile[]): Promise<string[]>;
+    /**
+     * Rollback the last batch of migrations
+     */
+    rollback(migrations: MigrationFile[]): Promise<string[]>;
+    /**
+     * Reset all migrations (rollback everything)
+     */
+    reset(migrations: MigrationFile[]): Promise<string[]>;
+    /**
+     * Refresh: reset + run all
+     */
+    refresh(migrations: MigrationFile[]): Promise<{
+        reset: string[];
+        migrated: string[];
+    }>;
+    /**
+     * Fresh: drop ALL tables then re-run all migrations.
+     * Unlike refresh (which calls each migration's down() method),
+     * fresh simply drops every table in the database and starts clean.
+     */
+    fresh(migrations: MigrationFile[]): Promise<{
+        dropped: string[];
+        migrated: string[];
+    }>;
+    /**
+     * Drop all tables in the database.
+     * Returns the list of dropped table names.
+     */
+    dropAllTables(): Promise<string[]>;
+    /**
+     * Get list of already-ran migration names
+     */
+    getRanMigrations(): Promise<string[]>;
+    /**
+     * Get the status of all migrations
+     */
+    status(migrations: MigrationFile[]): Promise<{
+        name: string;
+        ran: boolean;
+        batch: number | null;
+    }[]>;
+    private getNextBatch;
+    private getLastBatch;
+}