@beeblock/svelar 0.4.9 → 0.5.1

package/dist/plugins/PluginInstaller.js

@@ -1 +1 @@
-var b=(u=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(u,{get:(s,e)=>(typeof require<"u"?require:s)[e]}):u)(function(u){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+u+'" is not supported')});function f(u,s){let e=Symbol.for(u),i=globalThis;return i[e]||(i[e]=s()),i[e]}var y=class{plugins=new Map;enabledPlugins=new Set;async discover(){let{join:s}=await import("path"),{existsSync:e,readdirSync:i}=await import("fs"),{readFile:c}=await import("fs/promises"),o=[],t=s(process.cwd(),"node_modules");if(!e(t))return o;try{let p=i(t,{withFileTypes:!0});for(let l of p){if(!l.isDirectory())continue;let g=l.name;if(g.startsWith("."))continue;let a=g.startsWith("svelar-");if(!a)continue;let d=s(t,g,"package.json");if(e(d))try{let n=await c(d,"utf-8"),r=JSON.parse(n),m=r.keywords?.includes("svelar-plugin");if(!a&&!m)continue;let h={name:r.name||g,version:r.version||"0.0.0",description:r.description||"",packageName:g,installed:!0,enabled:!1,hasConfig:!!r.svelar?.config,hasMigrations:!!r.svelar?.migrations};o.push(h),this.plugins.set(h.name,h)}catch{}}}catch{}return o}enable(s){let e=this.plugins.get(s);if(!e)throw new Error(`Plugin "${s}" not found in registry.`);this.enabledPlugins.add(s),e.enabled=!0}disable(s){this.enabledPlugins.delete(s);let e=this.plugins.get(s);e&&(e.enabled=!1)}isEnabled(s){return this.enabledPlugins.has(s)}list(){return[...this.plugins.values()]}listEnabled(){return[...this.plugins.values()].filter(s=>this.enabledPlugins.has(s.name))}get(s){return this.plugins.get(s)}register(s){this.plugins.set(s.name,s)}},w=f("svelar.pluginRegistry",()=>new y);var P=class{async publish(s,e){let{mkdir:i,copyFile:c}=await import("fs/promises"),{join:o,dirname:t}=await import("path"),{existsSync:p}=await import("fs"),l={configs:[],migrations:[],assets:[]},g=s.publishables?.()||{};for(let[a,d]of Object.entries(g))for(let n of d){if(e?.only&&n.type!==e.only)continue;let r=o(process.cwd(),n.dest),m=t(r);if(!(p(r)&&!e?.force))try{await i(m,{recursive:!0}),await c(n.source,r),n.type==="config"?l.configs.push(r):n.type==="migration"?l.migrations.push(r):n.type==="asset"&&l.assets.push(r)}catch(h){console.warn(`Failed to publish ${n.source} to ${r}:`,h)}}return l}async preview(s){let e={configs:[],migrations:[],assets:[]},i=s.publishables?.()||{};for(let[c,o]of Object.entries(i))for(let t of o){let p=b("path").join(process.cwd(),t.dest);t.type==="config"?e.configs.push(p):t.type==="migration"?e.migrations.push(p):t.type==="asset"&&e.assets.push(p)}return e}},M=f("svelar.pluginPublisher",()=>new P);var v=class{async install(s,e){let{spawn:i}=await import("child_process"),{promisify:c}=await import("util"),{join:o}=await import("path"),{readFile:t}=await import("fs/promises"),{existsSync:p}=await import("fs");try{await this.runNpmInstall(s);let l=w,g=await l.discover(),a;for(let n of g)if(n.packageName===s||n.name===s){a=n;break}if(!a)return{success:!1,pluginName:s,version:"0.0.0",published:null,error:`Plugin not found after installation. Make sure ${s} is a valid Svelar plugin.`};l.enable(a.name);let d=null;if(e?.publish!==!1)try{let n=await this.loadPluginClass(a.packageName);n&&(d=await M.publish(new n))}catch(n){console.warn("Failed to publish plugin assets:",n)}return{success:!0,pluginName:a.name,version:a.version,published:d}}catch(l){return{success:!1,pluginName:s,version:"0.0.0",published:null,error:l?.message??String(l)}}}async uninstall(s){try{let e=w,i=e.get(s);return i?(e.disable(s),await this.runNpmUninstall(i.packageName),!0):!1}catch(e){return console.error("Failed to uninstall plugin:",e),!1}}async runNpmInstall(s){return new Promise((e,i)=>{let{spawn:c}=b("child_process"),o=c("npm",["install",s],{cwd:process.cwd(),stdio:"inherit"});o.on("close",t=>{t===0?e():i(new Error(`npm install exited with code ${t}`))}),o.on("error",i)})}async runNpmUninstall(s){return new Promise((e,i)=>{let{spawn:c}=b("child_process"),o=c("npm",["uninstall",s],{cwd:process.cwd(),stdio:"inherit"});o.on("close",t=>{t===0?e():i(new Error(`npm uninstall exited with code ${t}`))}),o.on("error",i)})}async loadPluginClass(s){try{let e=await import(s);return e.default||Object.values(e)[0]}catch{return null}}},I=f("svelar.pluginInstaller",()=>new v);export{I as PluginInstaller};
+var w=(u=>typeof require<"u"?require:typeof Proxy<"u"?new Proxy(u,{get:(s,e)=>(typeof require<"u"?require:s)[e]}):u)(function(u){if(typeof require<"u")return require.apply(this,arguments);throw Error('Dynamic require of "'+u+'" is not supported')});function m(u,s){let e=Symbol.for(u),n=globalThis;return n[e]||(n[e]=s()),n[e]}var P=class{plugins=new Map;enabledPlugins=new Set;async discover(){let{join:s}=await import("path"),{existsSync:e,readdirSync:n}=await import("fs"),{readFile:c}=await import("fs/promises"),o=[],t=s(process.cwd(),"node_modules");if(!e(t))return o;let g=async(r,d="")=>{if(e(r))try{let p=n(r,{withFileTypes:!0});for(let a of p){if(!a.isDirectory()||a.name.startsWith("."))continue;if(a.name.startsWith("@")){let h=s(r,a.name);await g(h,a.name+"/");continue}let i=d+a.name,l=a.name.startsWith("svelar-");if(!l)continue;let b=s(r,a.name,"package.json");if(e(b))try{let h=await c(b,"utf-8"),f=JSON.parse(h),k=f.keywords?.includes("svelar-plugin");if(!l&&!k)continue;let y={name:f.name||i,version:f.version||"0.0.0",description:f.description||"",packageName:i,installed:!0,enabled:!1,hasConfig:!!f.svelar?.config,hasMigrations:!!f.svelar?.migrations};o.push(y),this.plugins.set(y.name,y)}catch{}}}catch{}};return await g(t),o}enable(s){let e=this.plugins.get(s);if(!e)throw new Error(`Plugin "${s}" not found in registry.`);this.enabledPlugins.add(s),e.enabled=!0}disable(s){this.enabledPlugins.delete(s);let e=this.plugins.get(s);e&&(e.enabled=!1)}isEnabled(s){return this.enabledPlugins.has(s)}list(){return[...this.plugins.values()]}listEnabled(){return[...this.plugins.values()].filter(s=>this.enabledPlugins.has(s.name))}get(s){return this.plugins.get(s)}register(s){this.plugins.set(s.name,s)}},v=m("svelar.pluginRegistry",()=>new P);var M=class{async publish(s,e){let{mkdir:n,copyFile:c}=await import("fs/promises"),{join:o,dirname:t}=await import("path"),{existsSync:g}=await import("fs"),r={configs:[],migrations:[],assets:[]},d=s.publishables?.()||{};for(let[p,a]of Object.entries(d))for(let i of a){if(e?.only&&i.type!==e.only)continue;let l=o(process.cwd(),i.dest),b=t(l);if(!(g(l)&&!e?.force))try{await n(b,{recursive:!0}),await c(i.source,l),i.type==="config"?r.configs.push(l):i.type==="migration"?r.migrations.push(l):i.type==="asset"&&r.assets.push(l)}catch(h){console.warn(`Failed to publish ${i.source} to ${l}:`,h)}}return r}async preview(s){let e={configs:[],migrations:[],assets:[]},n=s.publishables?.()||{};for(let[c,o]of Object.entries(n))for(let t of o){let g=w("path").join(process.cwd(),t.dest);t.type==="config"?e.configs.push(g):t.type==="migration"?e.migrations.push(g):t.type==="asset"&&e.assets.push(g)}return e}},R=m("svelar.pluginPublisher",()=>new M);var x=class{async install(s,e){let{spawn:n}=await import("child_process"),{promisify:c}=await import("util"),{join:o}=await import("path"),{readFile:t}=await import("fs/promises"),{existsSync:g}=await import("fs");try{await this.runNpmInstall(s);let r=v,d=await r.discover(),p;for(let i of d)if(i.packageName===s||i.name===s){p=i;break}if(!p)return{success:!1,pluginName:s,version:"0.0.0",published:null,error:`Plugin not found after installation. Make sure ${s} is a valid Svelar plugin.`};r.enable(p.name);let a=null;if(e?.publish!==!1)try{let i=await this.loadPluginClass(p.packageName);i&&(a=await R.publish(new i))}catch(i){console.warn("Failed to publish plugin assets:",i)}return{success:!0,pluginName:p.name,version:p.version,published:a}}catch(r){return{success:!1,pluginName:s,version:"0.0.0",published:null,error:r?.message??String(r)}}}async uninstall(s){try{let e=v,n=e.get(s);return n?(e.disable(s),await this.runNpmUninstall(n.packageName),!0):!1}catch(e){return console.error("Failed to uninstall plugin:",e),!1}}async runNpmInstall(s){return new Promise((e,n)=>{let{spawn:c}=w("child_process"),o=c("npm",["install",s],{cwd:process.cwd(),stdio:"inherit"});o.on("close",t=>{t===0?e():n(new Error(`npm install exited with code ${t}`))}),o.on("error",n)})}async runNpmUninstall(s){return new Promise((e,n)=>{let{spawn:c}=w("child_process"),o=c("npm",["uninstall",s],{cwd:process.cwd(),stdio:"inherit"});o.on("close",t=>{t===0?e():n(new Error(`npm uninstall exited with code ${t}`))}),o.on("error",n)})}async loadPluginClass(s){try{let e=await import(s);return e.default||Object.values(e)[0]}catch{return null}}},D=m("svelar.pluginInstaller",()=>new x);export{D as PluginInstaller};

package/dist/plugins/PluginRegistry.js

@@ -1 +1 @@
-function p(g,n){let e=Symbol.for(g),i=globalThis;return i[e]||(i[e]=n()),i[e]}var l=class{plugins=new Map;enabledPlugins=new Set;async discover(){let{join:n}=await import("path"),{existsSync:e,readdirSync:i}=await import("fs"),{readFile:h}=await import("fs/promises"),a=[],o=n(process.cwd(),"node_modules");if(!e(o))return a;try{let f=i(o,{withFileTypes:!0});for(let u of f){if(!u.isDirectory())continue;let s=u.name;if(s.startsWith("."))continue;let c=s.startsWith("svelar-");if(!c)continue;let d=n(o,s,"package.json");if(e(d))try{let b=await h(d,"utf-8"),t=JSON.parse(b),P=t.keywords?.includes("svelar-plugin");if(!c&&!P)continue;let r={name:t.name||s,version:t.version||"0.0.0",description:t.description||"",packageName:s,installed:!0,enabled:!1,hasConfig:!!t.svelar?.config,hasMigrations:!!t.svelar?.migrations};a.push(r),this.plugins.set(r.name,r)}catch{}}}catch{}return a}enable(n){let e=this.plugins.get(n);if(!e)throw new Error(`Plugin "${n}" not found in registry.`);this.enabledPlugins.add(n),e.enabled=!0}disable(n){this.enabledPlugins.delete(n);let e=this.plugins.get(n);e&&(e.enabled=!1)}isEnabled(n){return this.enabledPlugins.has(n)}list(){return[...this.plugins.values()]}listEnabled(){return[...this.plugins.values()].filter(n=>this.enabledPlugins.has(n.name))}get(n){return this.plugins.get(n)}register(n){this.plugins.set(n.name,n)}},y=p("svelar.pluginRegistry",()=>new l);export{y as PluginRegistry};
+function m(c,n){let e=Symbol.for(c),s=globalThis;return s[e]||(s[e]=n()),s[e]}var g=class{plugins=new Map;enabledPlugins=new Set;async discover(){let{join:n}=await import("path"),{existsSync:e,readdirSync:s}=await import("fs"),{readFile:b}=await import("fs/promises"),o=[],u=n(process.cwd(),"node_modules");if(!e(u))return o;let d=async(a,P="")=>{if(e(a))try{let v=s(a,{withFileTypes:!0});for(let t of v){if(!t.isDirectory()||t.name.startsWith("."))continue;if(t.name.startsWith("@")){let r=n(a,t.name);await d(r,t.name+"/");continue}let p=P+t.name,h=t.name.startsWith("svelar-");if(!h)continue;let f=n(a,t.name,"package.json");if(e(f))try{let r=await b(f,"utf-8"),i=JSON.parse(r),y=i.keywords?.includes("svelar-plugin");if(!h&&!y)continue;let l={name:i.name||p,version:i.version||"0.0.0",description:i.description||"",packageName:p,installed:!0,enabled:!1,hasConfig:!!i.svelar?.config,hasMigrations:!!i.svelar?.migrations};o.push(l),this.plugins.set(l.name,l)}catch{}}}catch{}};return await d(u),o}enable(n){let e=this.plugins.get(n);if(!e)throw new Error(`Plugin "${n}" not found in registry.`);this.enabledPlugins.add(n),e.enabled=!0}disable(n){this.enabledPlugins.delete(n);let e=this.plugins.get(n);e&&(e.enabled=!1)}isEnabled(n){return this.enabledPlugins.has(n)}list(){return[...this.plugins.values()]}listEnabled(){return[...this.plugins.values()].filter(n=>this.enabledPlugins.has(n.name))}get(n){return this.plugins.get(n)}register(n){this.plugins.set(n.name,n)}},k=m("svelar.pluginRegistry",()=>new g);export{k as PluginRegistry};

package/dist/testing/Factory.d.ts

@@ -0,0 +1,37 @@
+/**
+ * Factory — Laravel-inspired model factory for tests.
+ *
+ * Subclass this to define factories for your models. Each factory
+ * has a `definition()` method that returns default attributes and
+ * a `model()` method that returns the Model class.
+ */
+import type { Model } from '../orm/Model.js';
+type ModelClass<T> = new (...args: any[]) => T;
+export declare abstract class Factory<T extends Model> {
+    private static _sequence;
+    /** Auto-incrementing counter unique per factory invocation */
+    get sequence(): number;
+    /** Reset the global sequence counter (useful between tests) */
+    static resetSequence(): void;
+    /** Return the Model class this factory produces */
+    abstract model(): ModelClass<T>;
+    /** Return default attribute values for the model */
+    abstract definition(): Record<string, any>;
+    /**
+     * Create a model instance and persist it to the database.
+     */
+    create(overrides?: Partial<Record<string, any>>): Promise<T>;
+    /**
+     * Create multiple model instances and persist them.
+     */
+    createMany(count: number, overrides?: Partial<Record<string, any>>): Promise<T[]>;
+    /**
+     * Make a model instance without persisting it.
+     */
+    make(overrides?: Partial<Record<string, any>>): T;
+    /**
+     * Make multiple model instances without persisting them.
+     */
+    makeMany(count: number, overrides?: Partial<Record<string, any>>): T[];
+}
+export {};

package/dist/testing/assertions.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Database assertions for tests.
+ *
+ * These helpers query the database and throw assertion errors
+ * when the expectation is not met, integrating with any test runner.
+ */
+/**
+ * Assert that a row matching `conditions` exists in the given table.
+ */
+export declare function assertDatabaseHas(table: string, conditions: Record<string, any>, connectionName?: string): Promise<void>;
+/**
+ * Assert that no row matching `conditions` exists in the given table.
+ */
+export declare function assertDatabaseMissing(table: string, conditions: Record<string, any>, connectionName?: string): Promise<void>;
+/**
+ * Assert that the table has exactly `expected` rows matching
+ * optional `conditions`. If conditions is omitted, counts all rows.
+ */
+export declare function assertDatabaseCount(table: string, expected: number, conditions?: Record<string, any>, connectionName?: string): Promise<void>;

package/dist/testing/auth.d.ts

@@ -0,0 +1,15 @@
+/**
+ * actingAs — Simulate an authenticated user in tests.
+ *
+ * Sets `event.locals.user` to the provided user object,
+ * mimicking how AuthenticateMiddleware populates it.
+ */
+import { type RequestEventOptions } from './request.js';
+/**
+ * Attach a user to the event's locals, simulating authentication.
+ *
+ * If `event` is not provided, a fresh RequestEvent is created.
+ * Returns the event with `locals.user` set.
+ */
+export declare function actingAs(user: any, event?: any): any;
+export declare function actingAs(user: any, options?: RequestEventOptions): any;

package/dist/testing/index.d.ts

@@ -0,0 +1,5 @@
+export { Factory } from './Factory.js';
+export { useSvelarTest, refreshDatabase, type UseSvelarTestOptions } from './setup.js';
+export { assertDatabaseHas, assertDatabaseMissing, assertDatabaseCount } from './assertions.js';
+export { actingAs } from './auth.js';
+export { createRequestEvent, type RequestEventOptions } from './request.js';

package/dist/testing/index.js

@@ -0,0 +1,4 @@
+var f=class o{static _sequence=0;get sequence(){return++o._sequence}static resetSequence(){o._sequence=0}async create(t={}){let e=this.model(),n={...this.definition(),...t},r=new e;return Object.assign(r,n),await r.save(),r}async createMany(t,e={}){let n=[];for(let r=0;r<t;r++)n.push(await this.create(e));return n}make(t={}){let e=this.model(),n={...this.definition(),...t},r=new e;return Object.assign(r,n),r}makeMany(t,e={}){let n=[];for(let r=0;r<t;r++)n.push(this.make(e));return n}};import{readdirSync as S}from"fs";import{join as v}from"path";import{pathToFileURL as I}from"url";function b(o,t){let e=Symbol.for(o),n=globalThis;return n[e]||(n[e]=t()),n[e]}var T=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 s=await this.rawClient(n),l=e.map(m=>typeof m=="boolean"?m?1:0:m instanceof Date?m.toISOString():m),c=s.prepare(t),u=t.trimStart().toUpperCase();return u.startsWith("SELECT")||u.startsWith("PRAGMA")||u.startsWith("WITH")?c.all(...l):c.run(...l)}case"postgres":return(await this.rawClient(n))(t,...e);case"mysql":{let s=await this.rawClient(n),[l]=await s.execute(t,e);return l}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 s=await t();return await i.commit(),i.release(),s}catch(s){throw await i.rollback(),i.release(),s}}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 s={prepare(c){let u=i.prepare(c);return{all(...m){return u.all(...m)},run(...m){return u.run(...m)},get(...m){return u.get(...m)}}},exec(c){i.exec(c)},pragma(c){return i.prepare(`PRAGMA ${c}`).all()},close(){i.close()}},l;try{let{drizzle:c}=await import("drizzle-orm/better-sqlite3");l=c(s)}catch{l=s}return{drizzle:l,config:t,rawClient:s}}}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{}}},a=b("svelar.connection",()=>new T);var h=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 N(this.column)}build(){return this.column}},N=class{constructor(t){this.column=t}onDelete(t){return this.column.references.onDelete=t,this}onUpdate(t){return this.column.references.onUpdate=t,this}},E=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 h(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 h(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 h(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 h(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 s=`FOREIGN KEY (${i.name}) REFERENCES ${i.references.table}(${i.references.column})`;i.references.onDelete&&(s+=` ON DELETE ${i.references.onDelete}`),i.references.onUpdate&&(s+=` ON UPDATE ${i.references.onUpdate}`),r.push(s)}n.push(`CREATE TABLE ${t} (
+  ${r.join(`,
+  `)}
+)`);for(let i of this.indices){let s=i.name??`idx_${t}_${i.columns.join("_")}`,l=i.unique?"UNIQUE ":"";n.push(`CREATE ${l}INDEX ${s} 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}},p=class{constructor(t){this.connectionName=t}async createTable(t,e){let n=new E;e(n);let r=a.getDriver(this.connectionName),i=n.toSQL(t,r);for(let s of i)await a.raw(s,[],this.connectionName)}async dropTable(t){await a.raw(`DROP TABLE IF EXISTS ${t}`,[],this.connectionName)}async dropTableIfExists(t){await a.raw(`DROP TABLE IF EXISTS ${t}`,[],this.connectionName)}async renameTable(t,e){a.getDriver(this.connectionName)==="mysql"?await a.raw(`RENAME TABLE ${t} TO ${e}`,[],this.connectionName):await a.raw(`ALTER TABLE ${t} RENAME TO ${e}`,[],this.connectionName)}async hasTable(t){let e=a.getDriver(this.connectionName),n;switch(e){case"sqlite":n=await a.raw("SELECT name FROM sqlite_master WHERE type='table' AND name=?",[t],this.connectionName);break;case"postgres":n=await a.raw("SELECT tablename FROM pg_tables WHERE tablename = $1",[t],this.connectionName);break;case"mysql":n=await a.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 E;e(n);let r=a.getDriver(this.connectionName),i=n.columns;for(let s of i){let l=n.columnToSQL(s,r);await a.raw(`ALTER TABLE ${t} ADD COLUMN ${l}`,[],this.connectionName)}}async dropColumn(t,e){await a.raw(`ALTER TABLE ${t} DROP COLUMN ${e}`,[],this.connectionName)}},z=b("svelar.schema",()=>new p);var y=class{migrationsTable="svelar_migrations";connectionName;constructor(t){this.connectionName=t}async ensureMigrationsTable(){let t=new p(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(s=>!e.includes(s.name));if(n.length===0)return[];let r=await this.getNextBatch(),i=[];for(let s of n)await s.migration.up(),await a.raw(`INSERT INTO ${this.migrationsTable} (migration, batch) VALUES (?, ?)`,[s.name,r],this.connectionName),i.push(s.name);return i}async rollback(t){await this.ensureMigrationsTable();let e=await this.getLastBatch();if(e===0)return[];let n=await a.raw(`SELECT migration FROM ${this.migrationsTable} WHERE batch = ? ORDER BY id DESC`,[e],this.connectionName),r=[];for(let i of n){let s=i.migration,l=t.find(c=>c.name===s);l&&(await l.migration.down(),await a.raw(`DELETE FROM ${this.migrationsTable} WHERE migration = ?`,[s],this.connectionName),r.push(s))}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=a.getDriver(this.connectionName),e=[];switch(t){case"sqlite":{e=(await a.raw("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'",[],this.connectionName)).map(r=>r.name),await a.raw("PRAGMA foreign_keys = OFF",[],this.connectionName);for(let r of e)await a.raw(`DROP TABLE IF EXISTS "${r}"`,[],this.connectionName);await a.raw("PRAGMA foreign_keys = ON",[],this.connectionName);break}case"mysql":{e=(await a.raw("SHOW TABLES",[],this.connectionName)).map(r=>Object.values(r)[0]),await a.raw("SET FOREIGN_KEY_CHECKS = 0",[],this.connectionName);for(let r of e)await a.raw(`DROP TABLE IF EXISTS \`${r}\``,[],this.connectionName);await a.raw("SET FOREIGN_KEY_CHECKS = 1",[],this.connectionName);break}case"postgres":{e=(await a.raw("SELECT tablename FROM pg_tables WHERE schemaname = 'public'",[],this.connectionName)).map(r=>r.tablename);for(let r of e)await a.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 a.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 a.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 a.raw(`SELECT MAX(batch) as max_batch FROM ${this.migrationsTable}`,[],this.connectionName))[0]?.max_batch??0}catch{return 0}}};function M(o={}){let t=globalThis.beforeAll,e=globalThis.beforeEach,n=globalThis.afterEach;if(!t||!e)throw new Error("useSvelarTest() requires Vitest globals. Set `globals: true` in vitest.config.ts.");t(async()=>{try{a.getDriver()}catch{a.configure({default:"sqlite",connections:{sqlite:{driver:"sqlite",filename:":memory:"}}})}}),e(async()=>{f.resetSequence(),o.refreshDatabase&&await R(o.connectionName)})}async function R(o){let t=new y(o),e=v(process.cwd(),"src","lib","database","migrations"),n;try{n=S(e).filter(i=>i.endsWith(".ts")||i.endsWith(".js")).sort()}catch{return}let r=[];for(let i of n){let s=v(e,i);try{let l=await import(I(s).href),c=l.default??Object.values(l).find(u=>typeof u=="function"&&u.prototype&&typeof u.prototype.up=="function");c&&r.push({name:i.replace(/\.(ts|js)$/,""),timestamp:i.split("_")[0],path:s,migration:new c})}catch{}}await t.fresh(r)}async function L(o,t,e){if(await C(o,t,e)===0){let r=JSON.stringify(t);throw new Error(`assertDatabaseHas failed: expected at least one row in "${o}" matching ${r}, but found none.`)}}async function O(o,t,e){let n=await C(o,t,e);if(n>0){let r=JSON.stringify(t);throw new Error(`assertDatabaseMissing failed: expected no rows in "${o}" matching ${r}, but found ${n}.`)}}async function B(o,t,e,n){let r=e?await C(o,e,n):await C(o,{},n);if(r!==t){let i=e?` matching ${JSON.stringify(e)}`:"";throw new Error(`assertDatabaseCount failed: expected ${t} row(s) in "${o}"${i}, but found ${r}.`)}}async function C(o,t,e){let n=Object.keys(t),r=`SELECT COUNT(*) AS cnt FROM "${o}"`,i=[];if(n.length>0){let l=n.map(c=>(i.push(t[c]),`"${c}" = ?`));r+=` WHERE ${l.join(" AND ")}`}let s=await a.raw(r,i,e);return Number(s[0]?.cnt??0)}function D(o={}){let{method:t="GET",url:e="http://localhost:5173/",headers:n={},body:r,params:i={},locals:s={},cookies:l={}}=o,c=new URL(e,"http://localhost:5173"),u=new Map(Object.entries(n).map(([d,g])=>[d.toLowerCase(),g])),m={method:t,headers:n};r!==void 0&&t!=="GET"&&t!=="HEAD"&&(m.body=typeof r=="string"?r:JSON.stringify(r),u.has("content-type")||u.set("content-type","application/json"));let A=new Request(c.href,m),w=new Map(Object.entries(l));return{request:A,url:c,params:i,locals:{...s},route:{id:c.pathname},isDataRequest:!1,isSubRequest:!1,platform:{},cookies:{get:d=>w.get(d),getAll:()=>Array.from(w.entries()).map(([d,g])=>({name:d,value:g})),set:(d,g)=>{w.set(d,g)},delete:d=>{w.delete(d)},serialize:(d,g)=>`${d}=${g}`},fetch:globalThis.fetch,getClientAddress:()=>"127.0.0.1",setHeaders:()=>{}}}function $(o,t){let e;return t&&typeof t=="object"&&"request"in t?e=t:e=D(t??{}),e.locals.user=o,e}export{f as Factory,$ as actingAs,B as assertDatabaseCount,L as assertDatabaseHas,O as assertDatabaseMissing,D as createRequestEvent,R as refreshDatabase,M as useSvelarTest};

package/dist/testing/request.d.ts

@@ -0,0 +1,20 @@
+/**
+ * createRequestEvent — Build a mock SvelteKit RequestEvent for testing.
+ *
+ * This allows testing server-side handlers (load functions, API endpoints,
+ * controllers) without a running server.
+ */
+export interface RequestEventOptions {
+    method?: string;
+    url?: string;
+    headers?: Record<string, string>;
+    body?: any;
+    params?: Record<string, string>;
+    locals?: Record<string, any>;
+    cookies?: Record<string, string>;
+}
+/**
+ * Create a mock SvelteKit RequestEvent suitable for passing to
+ * server handlers, controllers, and middleware.
+ */
+export declare function createRequestEvent(options?: RequestEventOptions): any;

package/dist/testing/setup.d.ts

@@ -0,0 +1,35 @@
+/**
+ * Test setup utilities.
+ *
+ * `useSvelarTest()` wires up beforeEach/afterEach hooks automatically.
+ * `refreshDatabase()` drops all tables and re-runs migrations.
+ */
+export interface UseSvelarTestOptions {
+    /** When true, calls refreshDatabase() before each test. Default: false */
+    refreshDatabase?: boolean;
+    /** Database connection name to use. Default: undefined (uses default) */
+    connectionName?: string;
+}
+/**
+ * Wire up the Svelar test environment in a describe block.
+ *
+ * Call this at the top of a `describe()` block:
+ *
+ * ```ts
+ * describe('UserService', () => {
+ *   useSvelarTest({ refreshDatabase: true });
+ *   // ...
+ * });
+ * ```
+ *
+ * Automatically:
+ * - Configures an in-memory SQLite database
+ * - Resets factory sequences between tests
+ * - Optionally runs refreshDatabase() before each test
+ */
+export declare function useSvelarTest(options?: UseSvelarTestOptions): void;
+/**
+ * Drop all tables and re-run all migrations from the project's
+ * `src/lib/database/migrations/` directory.
+ */
+export declare function refreshDatabase(connectionName?: string): Promise<void>;

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@beeblock/svelar",
-  "version": "0.4.9",
+  "version": "0.5.1",
   "description": "Laravel-inspired framework on top of SvelteKit 2",
   "type": "module",
   "main": "./dist/index.js",
@@ -245,6 +245,10 @@
     "./stripe": {
       "types": "./dist/stripe/index.d.ts",
       "import": "./dist/stripe/index.js"
+    },
+    "./testing": {
+      "types": "./dist/testing/index.d.ts",
+      "import": "./dist/testing/index.js"
     }
   },
   "scripts": {
@@ -289,7 +293,8 @@
     "postgres": "*",
     "pusher-js": ">=8.0.0",
     "stripe": ">=14.0.0",
-    "sveltekit-superforms": ">=2.0.0"
+    "sveltekit-superforms": ">=2.0.0",
+    "vitest": ">=1.0.0"
   },
   "peerDependenciesMeta": {
     "@aws-sdk/client-s3": {
@@ -330,6 +335,9 @@
     },
     "stripe": {
       "optional": true
+    },
+    "vitest": {
+      "optional": true
     }
   },
   "keywords": [