@beeblock/svelar 0.4.0

package/dist/excel/index.d.ts

@@ -0,0 +1,154 @@
+/**
+ * Svelar Excel
+ *
+ * Excel import/export with streaming support for large files.
+ * Uses ExcelJS under the hood (requires `npm install exceljs`).
+ *
+ * @example
+ * ```ts
+ * import { Excel, Spreadsheet } from '@beeblock/svelar/excel';
+ *
+ * // Quick export from array of objects
+ * const buffer = await Excel.export({
+ *   sheets: [{
+ *     name: 'Users',
+ *     columns: [
+ *       { header: 'Name', key: 'name', width: 30 },
+ *       { header: 'Email', key: 'email', width: 40 },
+ *       { header: 'Created', key: 'createdAt', width: 20 },
+ *     ],
+ *     rows: users,
+ *   }],
+ * });
+ *
+ * // Quick import
+ * const rows = await Excel.import(buffer, { sheet: 'Users' });
+ * // [{ name: 'John', email: 'john@example.com', createdAt: '2026-01-01' }, ...]
+ *
+ * // Streaming export (low memory for large datasets)
+ * const buffer = await Excel.stream({
+ *   sheets: [{
+ *     name: 'Orders',
+ *     columns: [
+ *       { header: 'Order ID', key: 'id' },
+ *       { header: 'Total', key: 'total' },
+ *     ],
+ *     rows: async function* () {
+ *       let page = 1;
+ *       while (true) {
+ *         const batch = await Order.query().page(page, 1000);
+ *         if (batch.length === 0) break;
+ *         for (const order of batch) yield order;
+ *         page++;
+ *       }
+ *     },
+ *   }],
+ * });
+ *
+ * // Streaming import (low memory)
+ * await Excel.importStream(buffer, {
+ *   sheet: 'Orders',
+ *   onRow: async (row, index) => {
+ *     await Order.create(row);
+ *   },
+ * });
+ *
+ * // Advanced: Spreadsheet builder
+ * const spreadsheet = new Spreadsheet();
+ * spreadsheet
+ *   .sheet('Report')
+ *   .columns([
+ *     { header: 'Month', key: 'month', width: 15 },
+ *     { header: 'Revenue', key: 'revenue', width: 15, style: { numFmt: '"$"#,##0.00' } },
+ *   ])
+ *   .addRows(data)
+ *   .headerStyle({ font: { bold: true }, fill: { type: 'pattern', pattern: 'solid', fgColor: { argb: 'FF4472C4' } } })
+ *   .autoFilter();
+ *
+ * const buffer = await spreadsheet.toBuffer();
+ * ```
+ */
+export interface ColumnDef {
+    header: string;
+    key: string;
+    width?: number;
+    style?: Record<string, any>;
+}
+export interface SheetDef {
+    name: string;
+    columns: ColumnDef[];
+    rows: Record<string, any>[] | (() => AsyncIterable<Record<string, any>>);
+}
+export interface ExportOptions {
+    sheets: SheetDef[];
+    creator?: string;
+}
+export interface ImportOptions {
+    /** Sheet name or 1-based index (default: 1) */
+    sheet?: string | number;
+    /** Map column headers to keys. If not provided, uses first row as headers. */
+    headerRow?: number;
+}
+export interface ImportStreamOptions extends ImportOptions {
+    onRow: (row: Record<string, any>, index: number) => void | Promise<void>;
+}
+export declare class SheetBuilder {
+    private spreadsheet;
+    readonly name: string;
+    private _columns;
+    private _rows;
+    private _headerStyle;
+    private _autoFilter;
+    private _frozenRows;
+    private _frozenCols;
+    constructor(spreadsheet: Spreadsheet, name: string);
+    columns(cols: ColumnDef[]): this;
+    addRow(row: Record<string, any>): this;
+    addRows(rows: Record<string, any>[]): this;
+    headerStyle(style: Record<string, any>): this;
+    autoFilter(): this;
+    freeze(rows: number, cols?: number): this;
+    /** Start a new sheet on the same spreadsheet */
+    sheet(name: string): SheetBuilder;
+    /** Build to buffer */
+    toBuffer(): Promise<Buffer>;
+    /** @internal */
+    _apply(worksheet: any): void;
+}
+export declare class Spreadsheet {
+    private sheets;
+    private _creator;
+    creator(name: string): this;
+    sheet(name: string): SheetBuilder;
+    toBuffer(): Promise<Buffer>;
+}
+declare class ExcelManager {
+    /**
+     * Export data to an Excel buffer.
+     */
+    export(options: ExportOptions): Promise<Buffer>;
+    /**
+     * Streaming export for large datasets.
+     * Rows can be provided as an async generator to keep memory low.
+     */
+    stream(options: ExportOptions): Promise<Buffer>;
+    /**
+     * Import an Excel file into an array of objects.
+     * Uses the first row as headers by default.
+     */
+    import(input: Buffer | string, options?: ImportOptions): Promise<Record<string, any>[]>;
+    /**
+     * Streaming import for large files.
+     * Processes rows one at a time without loading the entire file into memory.
+     */
+    importStream(input: Buffer | string, options: ImportStreamOptions): Promise<void>;
+    /**
+     * Create a Spreadsheet builder for advanced use cases.
+     */
+    create(): Spreadsheet;
+}
+/**
+ * Global Excel singleton
+ */
+export declare const Excel: ExcelManager;
+export {};

package/dist/excel/index.js

@@ -0,0 +1 @@
+function g(a,e){let t=Symbol.for(a),r=globalThis;return r[t]||(r[t]=e()),r[t]}async function u(){try{return await import("exceljs")}catch(a){throw a.code==="MODULE_NOT_FOUND"||a.code==="ERR_MODULE_NOT_FOUND"?new Error("Excel support requires exceljs. Install: npm install exceljs"):a}}function S(a,e){return e?typeof e=="number"?a.worksheets[e-1]:a.getWorksheet(e):a.worksheets[0]}function R(a,e){let t={};for(let r=0;r<e.length;r++){let s=a.getCell(r+1);t[e[r]]=s.value}return t}var d=class{constructor(e,t){this.spreadsheet=e;this.name=t}_columns=[];_rows=[];_headerStyle=null;_autoFilter=!1;_frozenRows=0;_frozenCols=0;columns(e){return this._columns=e,this}addRow(e){return this._rows.push(e),this}addRows(e){return this._rows.push(...e),this}headerStyle(e){return this._headerStyle=e,this}autoFilter(){return this._autoFilter=!0,this}freeze(e,t=0){return this._frozenRows=e,this._frozenCols=t,this}sheet(e){return this.spreadsheet.sheet(e)}async toBuffer(){return this.spreadsheet.toBuffer()}_apply(e){this._columns.length&&(e.columns=this._columns.map(t=>({header:t.header,key:t.key,width:t.width,style:t.style})));for(let t of this._rows)e.addRow(t);if(this._headerStyle&&e.rowCount>0){let t=e.getRow(1);for(let r of Object.keys(this._headerStyle))t[r]=this._headerStyle[r];t.commit?.()}this._autoFilter&&this._columns.length&&(e.autoFilter={from:{row:1,column:1},to:{row:1,column:this._columns.length}}),(this._frozenRows>0||this._frozenCols>0)&&(e.views=[{state:"frozen",xSplit:this._frozenCols,ySplit:this._frozenRows}])}},w=class{sheets=[];_creator="Svelar";creator(e){return this._creator=e,this}sheet(e){let t=new d(this,e);return this.sheets.push(t),t}async toBuffer(){let e=await u(),t=new e.Workbook;t.creator=this._creator,t.created=new Date;for(let r of this.sheets){let s=t.addWorksheet(r.name);r._apply(s)}return t.xlsx.writeBuffer()}},m=class{async export(e){let t=await u(),r=new t.Workbook;r.creator=e.creator??"Svelar",r.created=new Date;for(let s of e.sheets){let n=r.addWorksheet(s.name);n.columns=s.columns.map(o=>({header:o.header,key:o.key,width:o.width,style:o.style}));let c=Array.isArray(s.rows)?s.rows:null;if(c)for(let o of c)n.addRow(o)}return r.xlsx.writeBuffer()}async stream(e){let t=await u(),{PassThrough:r}=await import("stream"),s=new r,n=[];s.on("data",o=>n.push(o));let c=new t.stream.xlsx.WorkbookWriter({stream:s,useStyles:!0,useSharedStrings:!0});c.creator=e.creator??"Svelar";for(let o of e.sheets){let l=c.addWorksheet(o.name);if(l.columns=o.columns.map(i=>({header:i.header,key:i.key,width:i.width,style:i.style})),Array.isArray(o.rows))for(let i of o.rows)l.addRow(i).commit();else{let i=o.rows();for await(let h of i)l.addRow(h).commit()}l.commit()}return await c.commit(),Buffer.concat(n)}async import(e,t={}){let r=await u(),s=new r.Workbook;typeof e=="string"?await s.xlsx.readFile(e):await s.xlsx.load(e);let n=S(s,t.sheet);if(!n)throw new Error("Worksheet not found");let c=t.headerRow??1,o=n.getRow(c),l=[];o.eachCell({includeEmpty:!0},(h,f)=>{l[f-1]=String(h.value??`col${f}`)});let i=[];return n.eachRow({includeEmpty:!1},(h,f)=>{f<=c||i.push(R(h,l))}),i}async importStream(e,t){let r=await u(),{Readable:s}=await import("stream"),n=t.sheet,c=t.headerRow??1,o;typeof e=="string"?o=(await import("fs")).createReadStream(e):o=s.from(e);let l=new r.stream.xlsx.WorkbookReader(o,{}),i=[],h=0;for await(let f of l)if(!(n&&(typeof n=="string"&&f.name!==n||typeof n=="number"&&f.id!==n))){for await(let y of f){if(h++,h===c){y.eachCell({includeEmpty:!0},(_,p)=>{i[p-1]=String(_.value??`col${p}`)});continue}if(h<=c)continue;let x=R(y,i);await t.onRow(x,h-c-1)}break}}create(){return new w}},v=g("svelar.excel",()=>new m);export{v as Excel,d as SheetBuilder,w as Spreadsheet};

package/dist/feature-flags/index.d.ts

@@ -0,0 +1,158 @@
+/**
+ * Svelar Feature Flags
+ *
+ * Database-backed feature flags with per-user, per-team, and percentage
+ * rollout support. Tables are auto-created on first use — no migration required.
+ *
+ * Usage:
+ *   import { Features } from '@beeblock/svelar/feature-flags';
+ *
+ *   Features.configure({ driver: 'database' });
+ *
+ *   // Define flags (typically in app.ts)
+ *   Features.define('new-dashboard', { description: 'Redesigned dashboard UI' });
+ *   Features.define('beta-api', { description: 'Beta API v2', percentage: 20 });
+ *
+ *   // Check flags
+ *   if (await Features.enabled('new-dashboard')) { ... }
+ *   if (await Features.enabledFor('beta-api', userId)) { ... }
+ *   if (await Features.enabledForTeam('beta-api', teamId)) { ... }
+ */
+export interface FeatureFlag {
+    id: string;
+    name: string;
+    description: string;
+    enabled: boolean;
+    /** 0–100. When set, the flag is enabled for this percentage of users (consistent hashing). */
+    percentage: number | null;
+    metadata?: Record<string, any>;
+    createdAt: number;
+    updatedAt: number;
+}
+export interface FeatureFlagOverride {
+    id: string;
+    flagName: string;
+    /** 'user' or 'team' */
+    scopeType: 'user' | 'team';
+    scopeId: string | number;
+    enabled: boolean;
+    createdAt: number;
+}
+export interface FeatureFlagsConfig {
+    driver: 'database' | 'memory';
+    table?: string;
+    overridesTable?: string;
+}
+export interface FeatureFlagDefinition {
+    description?: string;
+    enabled?: boolean;
+    percentage?: number | null;
+}
+declare class FeatureFlagManager {
+    private config;
+    private memFlags;
+    private memOverrides;
+    private tablesEnsured;
+    configure(config: FeatureFlagsConfig): void;
+    private get flagsTable();
+    private get overridesTable();
+    private get useDb();
+    private getConnection;
+    /**
+     * Auto-create feature_flags and feature_flag_overrides tables on first use.
+     */
+    ensureTables(): Promise<void>;
+    private rowToFlag;
+    private rowToOverride;
+    /**
+     * Define (or update) a feature flag. Safe to call multiple times —
+     * if the flag already exists, it updates description/percentage only.
+     */
+    define(name: string, opts?: FeatureFlagDefinition): Promise<FeatureFlag>;
+    /**
+     * Get a flag by name.
+     */
+    getFlag(name: string): Promise<FeatureFlag | null>;
+    /**
+     * List all flags.
+     */
+    allFlags(): Promise<FeatureFlag[]>;
+    /**
+     * Update a flag's properties.
+     */
+    updateFlag(name: string, data: Partial<Pick<FeatureFlag, 'description' | 'enabled' | 'percentage' | 'metadata'>>): Promise<FeatureFlag | null>;
+    /**
+     * Delete a flag and all its overrides.
+     */
+    deleteFlag(name: string): Promise<boolean>;
+    /**
+     * Globally enable a flag.
+     */
+    enable(name: string): Promise<void>;
+    /**
+     * Globally disable a flag.
+     */
+    disable(name: string): Promise<void>;
+    /**
+     * Check if a flag is globally enabled (ignores per-user/team overrides).
+     */
+    enabled(name: string): Promise<boolean>;
+    /**
+     * Check if a flag is enabled for a specific user.
+     *
+     * Resolution order:
+     * 1. User-level override (if exists) — wins
+     * 2. Percentage rollout (if configured) — consistent per user
+     * 3. Global enabled/disabled state
+     */
+    enabledFor(name: string, userId: string | number): Promise<boolean>;
+    /**
+     * Check if a flag is enabled for a specific team.
+     *
+     * Resolution order:
+     * 1. Team-level override (if exists) — wins
+     * 2. Percentage rollout (if configured) — consistent per team
+     * 3. Global enabled/disabled state
+     */
+    enabledForTeam(name: string, teamId: string | number): Promise<boolean>;
+    /**
+     * Set an override for a specific user or team.
+     */
+    setOverride(flagName: string, scopeType: 'user' | 'team', scopeId: string | number, enabled: boolean): Promise<FeatureFlagOverride>;
+    /**
+     * Remove an override for a specific user or team.
+     */
+    removeOverride(flagName: string, scopeType: 'user' | 'team', scopeId: string | number): Promise<boolean>;
+    /**
+     * Get a specific override.
+     */
+    getOverride(flagName: string, scopeType: 'user' | 'team', scopeId: string | number): Promise<FeatureFlagOverride | null>;
+    /**
+     * List all overrides for a flag.
+     */
+    getOverrides(flagName: string): Promise<FeatureFlagOverride[]>;
+    /**
+     * Enable a flag for a specific user.
+     */
+    enableFor(name: string, userId: string | number): Promise<void>;
+    /**
+     * Disable a flag for a specific user.
+     */
+    disableFor(name: string, userId: string | number): Promise<void>;
+    /**
+     * Enable a flag for a specific team.
+     */
+    enableForTeam(name: string, teamId: string | number): Promise<void>;
+    /**
+     * Disable a flag for a specific team.
+     */
+    disableForTeam(name: string, teamId: string | number): Promise<void>;
+    /**
+     * Deterministic percentage check using a simple hash.
+     * The same flag+identifier always produces the same result,
+     * so a user consistently sees the feature (or doesn't).
+     */
+    private inPercentage;
+}
+export declare const Features: FeatureFlagManager;
+export {};

package/dist/feature-flags/index.js

@@ -0,0 +1,59 @@
+var w=Object.defineProperty;var b=(d,e)=>()=>(d&&(e=d(d=0)),e);var E=(d,e)=>{for(var t in e)w(d,t,{get:e[t],enumerable:!0})};function u(d,e){let t=Symbol.for(d),a=globalThis;return a[t]||(a[t]=e()),a[t]}var m=b(()=>{"use strict"});var f={};E(f,{Connection:()=>N});var p,N,h=b(()=>{"use strict";m();p=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 a=this.config.connections[t];if(!a)throw new Error(`Database connection "${t}" is not defined in configuration.`);let r=await this.createConnection(a);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=[],a){let r=await this.connection(a),n=this.getConfig(a);switch(n.driver){case"sqlite":{let i=await this.rawClient(a),o=t.map(l=>typeof l=="boolean"?l?1:0:l instanceof Date?l.toISOString():l),s=i.prepare(e),c=e.trimStart().toUpperCase();return c.startsWith("SELECT")||c.startsWith("PRAGMA")||c.startsWith("WITH")?s.all(...o):s.run(...o)}case"postgres":return(await this.rawClient(a))(e,...t);case"mysql":{let i=await this.rawClient(a),[o]=await i.execute(e,t);return o}default:throw new Error(`Unsupported driver: ${n.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 a=this.config.connections[t];if(!a)throw new Error(`Database connection "${t}" is not defined.`);return a}async disconnect(e){if(e){let t=this.connections.get(e);t&&(await this.closeConnection(t),this.connections.delete(e))}else{for(let[t,a]of this.connections)await this.closeConnection(a);this.connections.clear()}}isConnected(e){return this.connections.has(e??this.defaultName)}async transaction(e,t){let a=this.getConfig(t),r=await this.rawClient(t);switch(a.driver){case"sqlite":{r.exec("BEGIN");try{let n=await e();return r.exec("COMMIT"),n}catch(n){throw r.exec("ROLLBACK"),n}}case"postgres":{await r`BEGIN`;try{let n=await e();return await r`COMMIT`,n}catch(n){throw await r`ROLLBACK`,n}}case"mysql":{let n=await r.getConnection();await n.beginTransaction();try{let i=await e();return await n.commit(),n.release(),i}catch(i){throw await n.rollback(),n.release(),i}}default:throw new Error(`Unsupported driver: ${a.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 a=(await import("better-sqlite3")).default,{drizzle:r}=await import("drizzle-orm/better-sqlite3"),n=new a(t);return n.pragma("journal_mode = WAL"),n.pragma("foreign_keys = ON"),{drizzle:r(n),config:e,rawClient:n}}catch(a){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: ${a instanceof Error?a.message:String(a)}`)}let n=new r(t);n.exec("PRAGMA journal_mode = WAL"),n.exec("PRAGMA foreign_keys = ON");let i={prepare(s){let c=n.prepare(s);return{all(...l){return c.all(...l)},run(...l){return c.run(...l)},get(...l){return c.get(...l)}}},exec(s){n.exec(s)},pragma(s){return n.prepare(`PRAGMA ${s}`).all()},close(){n.close()}},o;try{let{drizzle:s}=await import("drizzle-orm/better-sqlite3");o=s(i)}catch{o=i}return{drizzle:o,config:e,rawClient:i}}}async createPostgresConnection(e){let t=(await import("postgres")).default,{drizzle:a}=await import("drizzle-orm/postgres-js"),r=e.url??`postgres://${e.user}:${e.password}@${e.host??"localhost"}:${e.port??5432}/${e.database}`,n=t(r);return{drizzle:a(n),config:e,rawClient:n}}async createMySQLConnection(e){let t=await import("mysql2/promise"),{drizzle:a}=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:a(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{}}},N=u("svelar.connection",()=>new p)});m();import{randomUUID as g}from"crypto";var T=class{config={driver:"memory"};memFlags=[];memOverrides=[];tablesEnsured=!1;configure(e){this.config={...this.config,...e},this.tablesEnsured=!1}get flagsTable(){return this.config.table||"feature_flags"}get overridesTable(){return this.config.overridesTable||"feature_flag_overrides"}get useDb(){return this.config.driver==="database"}async getConnection(){let{Connection:e}=await Promise.resolve().then(()=>(h(),f));return e}async ensureTables(){if(this.tablesEnsured||!this.useDb)return;let e=await this.getConnection(),t=e.getDriver(),a=this.flagsTable,r=this.overridesTable;switch(t){case"sqlite":await e.raw(`CREATE TABLE IF NOT EXISTS ${a} (
+            id TEXT PRIMARY KEY,
+            name TEXT NOT NULL UNIQUE,
+            description TEXT NOT NULL DEFAULT '',
+            enabled INTEGER NOT NULL DEFAULT 0,
+            percentage INTEGER,
+            metadata TEXT,
+            created_at TEXT NOT NULL,
+            updated_at TEXT NOT NULL
+          )`),await e.raw(`CREATE TABLE IF NOT EXISTS ${r} (
+            id TEXT PRIMARY KEY,
+            flag_name TEXT NOT NULL,
+            scope_type TEXT NOT NULL,
+            scope_id TEXT NOT NULL,
+            enabled INTEGER NOT NULL DEFAULT 1,
+            created_at TEXT NOT NULL,
+            UNIQUE(flag_name, scope_type, scope_id)
+          )`);break;case"postgres":await e.raw(`CREATE TABLE IF NOT EXISTS ${a} (
+            id VARCHAR(255) PRIMARY KEY,
+            name VARCHAR(255) NOT NULL UNIQUE,
+            description TEXT NOT NULL DEFAULT '',
+            enabled BOOLEAN NOT NULL DEFAULT FALSE,
+            percentage INTEGER,
+            metadata JSONB,
+            created_at TIMESTAMPTZ NOT NULL,
+            updated_at TIMESTAMPTZ NOT NULL
+          )`),await e.raw(`CREATE TABLE IF NOT EXISTS ${r} (
+            id VARCHAR(255) PRIMARY KEY,
+            flag_name VARCHAR(255) NOT NULL,
+            scope_type VARCHAR(50) NOT NULL,
+            scope_id VARCHAR(255) NOT NULL,
+            enabled BOOLEAN NOT NULL DEFAULT TRUE,
+            created_at TIMESTAMPTZ NOT NULL,
+            UNIQUE(flag_name, scope_type, scope_id)
+          )`);break;case"mysql":await e.raw(`CREATE TABLE IF NOT EXISTS ${a} (
+            id VARCHAR(255) PRIMARY KEY,
+            name VARCHAR(255) NOT NULL UNIQUE,
+            description TEXT NOT NULL,
+            enabled TINYINT(1) NOT NULL DEFAULT 0,
+            percentage INT,
+            metadata JSON,
+            created_at DATETIME NOT NULL,
+            updated_at DATETIME NOT NULL
+          ) ENGINE=InnoDB`),await e.raw(`CREATE TABLE IF NOT EXISTS ${r} (
+            id VARCHAR(255) PRIMARY KEY,
+            flag_name VARCHAR(255) NOT NULL,
+            scope_type VARCHAR(50) NOT NULL,
+            scope_id VARCHAR(255) NOT NULL,
+            enabled TINYINT(1) NOT NULL DEFAULT 1,
+            created_at DATETIME NOT NULL,
+            UNIQUE(flag_name, scope_type, scope_id)
+          ) ENGINE=InnoDB`);break}this.tablesEnsured=!0}rowToFlag(e){return{id:e.id,name:e.name,description:e.description||"",enabled:!!e.enabled,percentage:e.percentage!=null?Number(e.percentage):null,metadata:e.metadata?typeof e.metadata=="string"?JSON.parse(e.metadata):e.metadata:void 0,createdAt:new Date(e.created_at).getTime(),updatedAt:new Date(e.updated_at).getTime()}}rowToOverride(e){return{id:e.id,flagName:e.flag_name,scopeType:e.scope_type,scopeId:e.scope_id,enabled:!!e.enabled,createdAt:new Date(e.created_at).getTime()}}async define(e,t={}){let a=await this.getFlag(e);if(a){let i={};return t.description!==void 0&&(i.description=t.description),t.percentage!==void 0&&(i.percentage=t.percentage),t.enabled!==void 0&&(i.enabled=t.enabled),Object.keys(i).length>0?await this.updateFlag(e,i):a}let r=Date.now(),n={id:g(),name:e,description:t.description||"",enabled:t.enabled??!1,percentage:t.percentage??null,createdAt:r,updatedAt:r};if(this.useDb){await this.ensureTables();let i=await this.getConnection(),o=new Date(r).toISOString();await i.raw(`INSERT INTO ${this.flagsTable} (id, name, description, enabled, percentage, metadata, created_at, updated_at) VALUES (?, ?, ?, ?, ?, ?, ?, ?)`,[n.id,n.name,n.description,n.enabled?1:0,n.percentage,null,o,o])}else this.memFlags.push(n);return n}async getFlag(e){if(this.useDb){await this.ensureTables();let a=await(await this.getConnection()).raw(`SELECT * FROM ${this.flagsTable} WHERE name = ?`,[e]);return a.length>0?this.rowToFlag(a[0]):null}return this.memFlags.find(t=>t.name===e)||null}async allFlags(){return this.useDb?(await this.ensureTables(),(await(await this.getConnection()).raw(`SELECT * FROM ${this.flagsTable} ORDER BY name`)).map(a=>this.rowToFlag(a))):[...this.memFlags].sort((e,t)=>e.name.localeCompare(t.name))}async updateFlag(e,t){if(this.useDb){await this.ensureTables();let r=await this.getConnection(),n=await this.getFlag(e);if(!n)return null;let i=new Date().toISOString(),o=t.description??n.description,s=t.enabled??n.enabled,c=t.percentage!==void 0?t.percentage:n.percentage,l=t.metadata!==void 0?JSON.stringify(t.metadata):n.metadata?JSON.stringify(n.metadata):null;return await r.raw(`UPDATE ${this.flagsTable} SET description = ?, enabled = ?, percentage = ?, metadata = ?, updated_at = ? WHERE name = ?`,[o,s?1:0,c,l,i,e]),this.getFlag(e)}let a=this.memFlags.find(r=>r.name===e);return a?(t.description!==void 0&&(a.description=t.description),t.enabled!==void 0&&(a.enabled=t.enabled),t.percentage!==void 0&&(a.percentage=t.percentage),t.metadata!==void 0&&(a.metadata=t.metadata),a.updatedAt=Date.now(),a):null}async deleteFlag(e){if(this.useDb){await this.ensureTables();let a=await this.getConnection();return await a.raw(`DELETE FROM ${this.overridesTable} WHERE flag_name = ?`,[e]),await a.raw(`DELETE FROM ${this.flagsTable} WHERE name = ?`,[e]),!0}let t=this.memFlags.findIndex(a=>a.name===e);return t===-1?!1:(this.memFlags.splice(t,1),this.memOverrides=this.memOverrides.filter(a=>a.flagName!==e),!0)}async enable(e){await this.updateFlag(e,{enabled:!0})}async disable(e){await this.updateFlag(e,{enabled:!1})}async enabled(e){let t=await this.getFlag(e);return t?t.enabled:!1}async enabledFor(e,t){let a=await this.getFlag(e);if(!a)return!1;let r=await this.getOverride(e,"user",t);return r?r.enabled:a.percentage!=null?this.inPercentage(e,String(t),a.percentage):a.enabled}async enabledForTeam(e,t){let a=await this.getFlag(e);if(!a)return!1;let r=await this.getOverride(e,"team",t);return r?r.enabled:a.percentage!=null?this.inPercentage(e,`team:${t}`,a.percentage):a.enabled}async setOverride(e,t,a,r){let n=Date.now();if(this.useDb){await this.ensureTables();let s=await this.getConnection(),c=new Date(n).toISOString();switch(s.getDriver()){case"sqlite":await s.raw(`INSERT INTO ${this.overridesTable} (id, flag_name, scope_type, scope_id, enabled, created_at)
+             VALUES (?, ?, ?, ?, ?, ?)
+             ON CONFLICT(flag_name, scope_type, scope_id)
+             DO UPDATE SET enabled = ?, created_at = ?`,[g(),e,t,String(a),r?1:0,c,r?1:0,c]);break;case"postgres":await s.raw(`INSERT INTO ${this.overridesTable} (id, flag_name, scope_type, scope_id, enabled, created_at)
+             VALUES ($1, $2, $3, $4, $5, $6)
+             ON CONFLICT(flag_name, scope_type, scope_id)
+             DO UPDATE SET enabled = $5, created_at = $6`,[g(),e,t,String(a),r,c]);break;case"mysql":await s.raw(`DELETE FROM ${this.overridesTable} WHERE flag_name = ? AND scope_type = ? AND scope_id = ?`,[e,t,String(a)]),await s.raw(`INSERT INTO ${this.overridesTable} (id, flag_name, scope_type, scope_id, enabled, created_at)
+             VALUES (?, ?, ?, ?, ?, ?)`,[g(),e,t,String(a),r?1:0,c]);break}return await this.getOverride(e,t,a)}let i=this.memOverrides.find(s=>s.flagName===e&&s.scopeType===t&&s.scopeId===String(a));if(i)return i.enabled=r,i;let o={id:g(),flagName:e,scopeType:t,scopeId:String(a),enabled:r,createdAt:n};return this.memOverrides.push(o),o}async removeOverride(e,t,a){if(this.useDb)return await this.ensureTables(),await(await this.getConnection()).raw(`DELETE FROM ${this.overridesTable} WHERE flag_name = ? AND scope_type = ? AND scope_id = ?`,[e,t,String(a)]),!0;let r=this.memOverrides.findIndex(n=>n.flagName===e&&n.scopeType===t&&n.scopeId===String(a));return r===-1?!1:(this.memOverrides.splice(r,1),!0)}async getOverride(e,t,a){if(this.useDb){await this.ensureTables();let n=await(await this.getConnection()).raw(`SELECT * FROM ${this.overridesTable} WHERE flag_name = ? AND scope_type = ? AND scope_id = ?`,[e,t,String(a)]);return n.length>0?this.rowToOverride(n[0]):null}return this.memOverrides.find(r=>r.flagName===e&&r.scopeType===t&&r.scopeId===String(a))||null}async getOverrides(e){return this.useDb?(await this.ensureTables(),(await(await this.getConnection()).raw(`SELECT * FROM ${this.overridesTable} WHERE flag_name = ?`,[e])).map(r=>this.rowToOverride(r))):this.memOverrides.filter(t=>t.flagName===e)}async enableFor(e,t){await this.setOverride(e,"user",t,!0)}async disableFor(e,t){await this.setOverride(e,"user",t,!1)}async enableForTeam(e,t){await this.setOverride(e,"team",t,!0)}async disableForTeam(e,t){await this.setOverride(e,"team",t,!1)}inPercentage(e,t,a){if(a>=100)return!0;if(a<=0)return!1;let r=`${e}:${t}`,n=2166136261;for(let i=0;i<r.length;i++)n^=r.charCodeAt(i),n=n*16777619>>>0;return n%100<a}},F=u("svelar.feature-flags",()=>new T);export{F as Features};

package/dist/forms/index.d.ts

@@ -0,0 +1,81 @@
+/**
+ * Svelar Forms Integration
+ *
+ * Bridges sveltekit-superforms with Svelar's validation layer.
+ * Provides helpers for creating forms with Zod schemas and server-side validation.
+ *
+ * @module svelar/forms
+ *
+ * @example
+ * ```ts
+ * // +page.server.ts
+ * import { createFormAction, loadForm } from 'svelar/forms';
+ * import { z } from 'zod';
+ *
+ * const schema = z.object({ title: z.string().min(3), body: z.string().min(10) });
+ *
+ * export const load = async (event) => ({
+ *   form: await loadForm(schema),
+ * });
+ *
+ * export const actions = {
+ *   default: createFormAction(schema, async (data, event) => {
+ *     await Post.create(data);
+ *   }),
+ * };
+ * ```
+ */
+import { z } from 'zod';
+export type { z };
+export interface FormActionOptions<T extends z.ZodTypeAny> {
+    /** Redirect URL on success */
+    redirectTo?: string;
+    /** Custom error message on failure */
+    errorMessage?: string;
+    /** Whether to reset form after success (default: true) */
+    resetOnSuccess?: boolean;
+}
+/**
+ * Creates a server-side form action handler with Zod validation.
+ * Compatible with sveltekit-superforms.
+ *
+ * @example
+ * ```ts
+ * import { createFormAction } from 'svelar/forms';
+ * import { createPostSchema } from '$lib/schemas/post';
+ *
+ * export const actions = {
+ *   default: createFormAction(createPostSchema, async (data, event) => {
+ *     const user = event.locals.user;
+ *     await Post.create({ ...data, user_id: user.id });
+ *   }),
+ * };
+ * ```
+ */
+export declare function createFormAction<T extends z.ZodTypeAny>(schema: T, handler: (data: z.infer<T>, event: any) => Promise<void | Record<string, any>>, options?: FormActionOptions<T>): (event: any) => Promise<Record<string, any> | import("@sveltejs/kit").ActionFailure<{
+    form: import("sveltekit-superforms").SuperValidated<{}, any, {}>;
+}> | {
+    form: import("sveltekit-superforms").SuperValidated<{}, any, {}>;
+}>;
+/**
+ * Load an empty form for a given schema.
+ * Use this in SvelteKit `load` functions.
+ *
+ * @example
+ * ```ts
+ * export const load = async () => ({
+ *   form: await loadForm(mySchema),
+ * });
+ * ```
+ */
+export declare function loadForm<T extends z.ZodTypeAny>(schema: T, data?: Partial<z.infer<T>>): Promise<import("sveltekit-superforms").SuperValidated<{}, any, z.TypeOf<T>>>;
+/**
+ * Validate form data against a Zod schema (server-side).
+ * Returns the validated data or throws a FormValidationError.
+ *
+ * @example
+ * ```ts
+ * const data = await validateForm(event, createPostSchema);
+ * ```
+ */
+export declare function validateForm<T extends z.ZodTypeAny>(event: any, schema: T): Promise<z.infer<T>>;

package/dist/forms/index.js

@@ -0,0 +1 @@
+var R=Object.defineProperty;var x=(r,e)=>()=>(r&&(e=r(r=0)),e);var b=(r,e)=>{for(var t in e)R(r,t,{get:e[t],enumerable:!0})};var h={};b(h,{FormAuthorizationError:()=>l,FormRequest:()=>g,FormValidationError:()=>p});var g,p,l,T=x(()=>{"use strict";g=class{authorize(e){return!0}messages(){return{}}attributes(){return{}}passedValidation(e){return e}failedValidation(e){throw new p(e)}failedAuthorization(){throw new l}async parseBody(e){let t=e.request.headers.get("content-type")??"";if(t.includes("application/json"))return e.request.json();if(t.includes("multipart/form-data")||t.includes("application/x-www-form-urlencoded")){let s=await e.request.formData();return Object.fromEntries(s)}return Object.fromEntries(e.url.searchParams)}static async validate(e){let t=new this;await t.authorize(e)||t.failedAuthorization();let n=await t.parseBody(e),i={...Object.fromEntries(e.url.searchParams),...e.params,...n},c=t.rules().safeParse(i);if(!c.success){let a={},o=t.messages(),m=t.attributes();for(let y of c.error.issues){let d=y.path.join("."),f=m[d]??d;a[f]||(a[f]=[]);let w=`${d}.${y.code}`,z=o[w]??o[d];a[f].push(z??y.message)}t.failedValidation(a)}return t.passedValidation(c.data)}},p=class extends Error{constructor(t){super("The given data was invalid.");this.errors=t;this.name="FormValidationError"}statusCode=422;toResponse(){return new Response(JSON.stringify({message:this.message,errors:this.errors}),{status:422,headers:{"Content-Type":"application/json"}})}},l=class extends Error{statusCode=403;constructor(e="This action is unauthorized."){super(e),this.name="FormAuthorizationError"}toResponse(){return new Response(JSON.stringify({message:this.message}),{status:403,headers:{"Content-Type":"application/json"}})}}});function E(r,e,t={}){return async s=>{let{superValidate:n,fail:i,message:u}=await import("sveltekit-superforms"),{zod:c}=await import("sveltekit-superforms/adapters"),a=await n(s,c(r));if(!a.valid)return i(400,{form:a});try{let o=await e(a.data,s);if(t.redirectTo){let{redirect:m}=await import("@sveltejs/kit");throw m(303,t.redirectTo)}return o??{form:a}}catch(o){if(o?.status>=300&&o?.status<400)throw o;return u(a,t.errorMessage||o.message||"An error occurred",{status:o.status||400})}}}async function P(r,e){let{superValidate:t}=await import("sveltekit-superforms"),{zod:s}=await import("sveltekit-superforms/adapters");return t(e??null,s(r))}async function j(r,e){let t=await r.request.formData(),s={};for(let[i,u]of t.entries())s[i]=u;let n=e.safeParse(s);if(!n.success){let{FormValidationError:i}=await Promise.resolve().then(()=>(T(),h));throw new i(n.error.flatten().fieldErrors)}return n.data}export{E as createFormAction,P as loadForm,j as validateForm};

package/dist/hashing/Hash.d.ts

@@ -0,0 +1,51 @@
+/**
+ * Svelar Hashing
+ *
+ * Password hashing with bcrypt and argon2 support.
+ * Falls back to a built-in scrypt implementation for zero-dependency usage.
+ *
+ * @example
+ * ```ts
+ * import { Hash } from 'svelar';
+ *
+ * const hashed = await Hash.make('my-password');
+ * const valid = await Hash.verify('my-password', hashed);
+ * ```
+ */
+export type HashDriver = 'scrypt' | 'bcrypt' | 'argon2';
+export interface HashConfig {
+    driver: HashDriver;
+    /** scrypt: CPU/memory cost (default: 16384) */
+    scryptCost?: number;
+    /** bcrypt: rounds (default: 12) */
+    bcryptRounds?: number;
+}
+declare class HashManager {
+    private config;
+    /**
+     * Configure the hash manager
+     */
+    configure(config: Partial<HashConfig>): void;
+    /**
+     * Hash a plain text value
+     */
+    make(value: string): Promise<string>;
+    /**
+     * Verify a plain text value against a hash
+     */
+    verify(value: string, hash: string): Promise<boolean>;
+    /**
+     * Check if a hash needs to be rehashed (e.g. cost parameter changed)
+     */
+    needsRehash(hash: string): boolean;
+    /**
+     * Generate a random string (useful for tokens, API keys)
+     */
+    randomString(length?: number): string;
+    /**
+     * Generate a random token (URL-safe base64)
+     */
+    randomToken(bytes?: number): string;
+}
+export declare const Hash: HashManager;
+export {};

package/dist/hashing/index.d.ts

@@ -0,0 +1 @@
+export { Hash, type HashDriver, type HashConfig } from './Hash.js';

package/dist/hashing/index.js

@@ -0,0 +1 @@
+import{randomBytes as p,scrypt as u,timingSafeEqual as b}from"crypto";function y(e,r){let t=Symbol.for(e),s=globalThis;return s[t]||(s[t]=r()),s[t]}async function l(e,r=16384){let t=p(16),s=64,o=await new Promise((n,a)=>{u(e,t,s,{N:r,r:8,p:1},(i,c)=>{i?a(i):n(c)})});return`$scrypt$N=${r}$${t.toString("base64")}$${o.toString("base64")}`}async function m(e,r){let t=r.split("$");if(t.length!==5||t[1]!=="scrypt")return!1;let s=parseInt(t[2].replace("N=",""),10),o=Buffer.from(t[3],"base64"),n=Buffer.from(t[4],"base64"),a=n.length,i=await new Promise((c,h)=>{u(e,o,a,{N:s,r:8,p:1},(g,d)=>{g?h(g):c(d)})});return b(i,n)}var f=class{config={driver:"scrypt",scryptCost:16384,bcryptRounds:12};configure(r){Object.assign(this.config,r)}async make(r){switch(this.config.driver){case"scrypt":return l(r,this.config.scryptCost);case"bcrypt":try{return(await import("bcrypt")).default.hash(r,this.config.bcryptRounds??12)}catch{throw new Error('bcrypt driver requires the "bcrypt" package. Install it: npm install bcrypt')}case"argon2":try{return(await import("argon2")).default.hash(r)}catch{throw new Error('argon2 driver requires the "argon2" package. Install it: npm install argon2')}default:throw new Error(`Unsupported hash driver: ${this.config.driver}`)}}async verify(r,t){if(t.startsWith("$scrypt$"))return m(r,t);if(t.startsWith("$2b$")||t.startsWith("$2a$")||t.startsWith("$2y$"))try{return(await import("bcrypt")).default.compare(r,t)}catch{throw new Error("bcrypt package required to verify bcrypt hashes.")}if(t.startsWith("$argon2"))try{return(await import("argon2")).default.verify(t,r)}catch{throw new Error("argon2 package required to verify argon2 hashes.")}return!1}needsRehash(r){if(this.config.driver==="scrypt"&&r.startsWith("$scrypt$")){let t=r.match(/N=(\d+)/);if(t)return parseInt(t[1],10)!==this.config.scryptCost}if(this.config.driver==="bcrypt"&&(r.startsWith("$2b$")||r.startsWith("$2a$"))){let t=r.match(/\$2[aby]\$(\d+)\$/);if(t)return parseInt(t[1],10)!==this.config.bcryptRounds}return this.config.driver==="scrypt"&&!r.startsWith("$scrypt$")||this.config.driver==="bcrypt"&&!r.startsWith("$2")||this.config.driver==="argon2"&&!r.startsWith("$argon2")}randomString(r=32){return p(Math.ceil(r/2)).toString("hex").slice(0,r)}randomToken(r=32){return p(r).toString("base64url")}},$=y("svelar.hash",()=>new f);export{$ as Hash};