kinetic-sql 1.0.0 → 1.0.2

package/README.md

@@ -5,7 +5,6 @@
 
 Kinetic SQL is a next-gen Node.js client that wraps **PostgreSQL** and **MySQL** with a developer experience similar to Supabase, but for your own backend.
 
-![Kinetic Demo](https://placehold.co/600x200?text=Imagine+Autocomplete+GIF+Here)
 ## ✨ Features
 
 - **🔮 Invisible Type Safety:** Run `npx k-sql gen` and your entire database schema is auto-injected into your client. No manual interfaces.

package/dist/cli/generate.cjs

@@ -1,24 +1,24 @@
 #!/usr/bin/env node
-"use strict";var h=Object.create;var _=Object.defineProperty;var N=Object.getOwnPropertyDescriptor;var S=Object.getOwnPropertyNames;var O=Object.getPrototypeOf,M=Object.prototype.hasOwnProperty;var A=(t,n,e,r)=>{if(n&&typeof n=="object"||typeof n=="function")for(let s of S(n))!M.call(t,s)&&s!==e&&_(t,s,{get:()=>n[s],enumerable:!(r=N(n,s))||r.enumerable});return t};var u=(t,n,e)=>(e=t!=null?h(O(t)):{},A(n||!t||!t.__esModule?_(e,"default",{value:t,enumerable:!0}):e,t));var T=()=>typeof document>"u"?new URL(`file:${__filename}`).href:document.currentScript&&document.currentScript.tagName.toUpperCase()==="SCRIPT"?document.currentScript.src:new URL("main.js",document.baseURI).href,g=T();var b=u(require("postgres"),1),y=u(require("mysql2/promise"),1),l=u(require("fs"),1),c=u(require("path"),1),f=require("url"),B=(0,f.fileURLToPath)(g),L={text:"string",varchar:"string",char:"string",uuid:"string",int2:"number",int4:"number",int8:"number",float4:"number",float8:"number",numeric:"number",bool:"boolean",json:"any",jsonb:"any",date:"string",timestamp:"string",timestamptz:"string",bytea:"Buffer",_text:"string[]",_int4:"number[]"},w={varchar:"string",char:"string",text:"string",longtext:"string",int:"number",tinyint:"number",smallint:"number",mediumint:"number",bigint:"number",float:"number",double:"number",decimal:"number",datetime:"string",date:"string",timestamp:"string",json:"any",blob:"Buffer",longblob:"Buffer",tinyint1:"boolean"};function I(){let t=process.argv.slice(2),n={type:"pg"};for(let e=0;e<t.length;e++){let r=t[e];if(r.startsWith("--")){let s=r.replace(/^--/,"");if(s.includes("=")){let[i,a]=s.split("=");n[i]=a}else t[e+1]&&!t[e+1].startsWith("--")&&(n[s]=t[e+1],e++)}}return n}function P(t){let n=t;for(;n!==c.default.parse(n).root;){if(l.default.existsSync(c.default.join(n,"package.json")))return n;n=c.default.dirname(n)}return t}async function C(t){let n;t.connection?n=(0,b.default)(t.connection,{max:1}):n=(0,b.default)({host:t.host||"localhost",port:Number(t.port)||5432,user:t.user||"postgres",password:t.password||"",database:t.db||"postgres",max:1});try{let e=await n`
+"use strict";var N=Object.create;var y=Object.defineProperty;var S=Object.getOwnPropertyDescriptor;var M=Object.getOwnPropertyNames;var O=Object.getPrototypeOf,T=Object.prototype.hasOwnProperty;var A=(e,n,t,s)=>{if(n&&typeof n=="object"||typeof n=="function")for(let r of M(n))!T.call(e,r)&&r!==t&&y(e,r,{get:()=>n[r],enumerable:!(s=S(n,r))||s.enumerable});return e};var u=(e,n,t)=>(t=e!=null?N(O(e)):{},A(n||!e||!e.__esModule?y(t,"default",{value:e,enumerable:!0}):t,e));var w=()=>typeof document>"u"?new URL(`file:${__filename}`).href:document.currentScript&&document.currentScript.tagName.toUpperCase()==="SCRIPT"?document.currentScript.src:new URL("main.js",document.baseURI).href,g=w();var f=u(require("postgres"),1),_=u(require("mysql2/promise"),1),E=u(require("better-sqlite3"),1),p=u(require("fs"),1),l=u(require("path"),1),R=require("url"),$=(0,R.fileURLToPath)(g),L={text:"string",varchar:"string",char:"string",uuid:"string",int2:"number",int4:"number",int8:"number",float4:"number",float8:"number",numeric:"number",bool:"boolean",json:"any",jsonb:"any",date:"string",timestamp:"string",timestamptz:"string",bytea:"Buffer",_text:"string[]",_int4:"number[]"},I={varchar:"string",char:"string",text:"string",longtext:"string",int:"number",tinyint:"number",smallint:"number",mediumint:"number",bigint:"number",float:"number",double:"number",decimal:"number",datetime:"string",date:"string",timestamp:"string",json:"any",blob:"Buffer",longblob:"Buffer",tinyint1:"boolean"},P={integer:"number",int:"number",smallint:"number",bigint:"number",text:"string",varchar:"string",char:"string",clob:"string",blob:"Buffer",real:"number",double:"number",float:"number",numeric:"number",boolean:"boolean",bool:"boolean"};function C(){let e=process.argv.slice(2),n={type:"pg"};for(let t=0;t<e.length;t++){let s=e[t];if(s.startsWith("--")){let r=s.replace(/^--/,"");if(r.includes("=")){let[o,i]=r.split("=");n[o]=i}else e[t+1]&&!e[t+1].startsWith("--")&&(n[r]=e[t+1],t++)}}return n}function x(e){let n=e;for(;n!==l.default.parse(n).root;){if(p.default.existsSync(l.default.join(n,"package.json")))return n;n=l.default.dirname(n)}return e}async function U(e){let n;e.connection?n=(0,f.default)(e.connection,{max:1}):n=(0,f.default)({host:e.host||"localhost",port:Number(e.port)||5432,user:e.user||"postgres",password:e.password||"",database:e.db||"postgres",max:1});try{let t=await n`
             SELECT table_name, column_name, udt_name, is_nullable
             FROM information_schema.columns
             WHERE table_schema = 'public'
-            ORDER BY table_name, ordinal_position;`,r=await n`
+            ORDER BY table_name, ordinal_position;`,s=await n`
             SELECT p.proname                        as function_name,
                    pg_get_function_arguments(p.oid) as args_raw,
                    t.typname                        as return_type
             FROM pg_proc p
                      JOIN pg_type t ON p.prorettype = t.oid
                      JOIN pg_namespace n ON p.pronamespace = n.oid
-            WHERE n.nspname = 'public';`;return{columns:e,functions:r,typeMap:L}}finally{await n.end()}}async function U(t){let n=await y.default.createConnection({host:t.host||"localhost",user:t.user||"root",password:t.password||"",database:t.db,port:Number(t.port)||3306});try{let[e]=await n.execute(`
+            WHERE n.nspname = 'public';`;return{columns:t,functions:s,typeMap:L}}finally{await n.end()}}async function q(e){let n=await _.default.createConnection({host:e.host||"localhost",user:e.user||"root",password:e.password||"",database:e.db,port:Number(e.port)||3306});try{let[t]=await n.execute(`
             SELECT TABLE_NAME as table_name, COLUMN_NAME as column_name, DATA_TYPE as udt_name, IS_NULLABLE as is_nullable
             FROM INFORMATION_SCHEMA.COLUMNS
             WHERE TABLE_SCHEMA = ?
-            ORDER BY TABLE_NAME, ORDINAL_POSITION`,[t.db]),[r]=await n.execute(`
+            ORDER BY TABLE_NAME, ORDINAL_POSITION`,[e.db]),[s]=await n.execute(`
             SELECT ROUTINE_NAME as function_name
             FROM INFORMATION_SCHEMA.ROUTINES
             WHERE ROUTINE_SCHEMA = ?
-              AND ROUTINE_TYPE = 'PROCEDURE'`,[t.db]);return{columns:e,functions:r,typeMap:w}}finally{await n.end()}}async function x(){let t=I();console.log(`\u{1F52E} Kinetic SQL: Introspecting ${t.type==="mysql"?"MySQL":"PostgreSQL"}...`);try{let n;t.type==="mysql"?n=await U(t):n=await C(t);let{columns:e,functions:r,typeMap:s}=n,i={};for(let o of e){i[o.table_name]||(i[o.table_name]=[]);let m=s[o.udt_name]||"any";t.type==="mysql"&&o.udt_name==="tinyint"&&(m="number");let R=o.is_nullable==="YES"?"| null":"";i[o.table_name].push(`                ${o.column_name}: ${m}${R};`)}let a=`// Auto-generated by Kinetic SQL \u26A0\uFE0F Do NOT import this file manually.
+              AND ROUTINE_TYPE = 'PROCEDURE'`,[e.db]);return{columns:t,functions:s,typeMap:I}}finally{await n.end()}}async function j(e){let n=e.db||e.filename||e.connection;if(!n)throw new Error("\u274C Missing SQLite file path. Usage: k-sql gen --type=sqlite --db=./dev.db");let t=new E.default(n,{readonly:!0});try{let s=t.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'").all(),r=[];for(let o of s){let i=t.prepare(`PRAGMA table_info('${o.name}')`).all();for(let c of i){let m=(c.type||"text").split("(")[0].toLowerCase().trim();r.push({table_name:o.name,column_name:c.name,udt_name:m,is_nullable:c.notnull===1?"NO":"YES"})}}return{columns:r,functions:[],typeMap:P}}finally{t.close()}}async function v(){let e=C();console.log(`\u{1F52E} Kinetic SQL: Introspecting ${e.type||"pg"}...`);try{let n;e.type==="mysql"?n=await q(e):e.type==="sqlite"?n=await j(e):n=await U(e);let{columns:t,functions:s,typeMap:r}=n,o={};for(let a of t){o[a.table_name]||(o[a.table_name]=[]);let b=r[a.udt_name]||"any";e.type==="mysql"&&a.udt_name==="tinyint"&&(b="number");let h=a.is_nullable==="YES"?"| null":"";o[a.table_name].push(`                ${a.column_name}: ${b}${h};`)}let i=`// Auto-generated by Kinetic SQL \u26A0\uFE0F Do NOT import this file manually.
 
 import 'kinetic-sql';
 
@@ -26,18 +26,18 @@ declare module 'kinetic-sql' {
     export interface Register {
         schema: {
             tables: {
-`;for(let[o,m]of Object.entries(i))a+=`            ${o}: {
-${m.join(`
+`;for(let[a,b]of Object.entries(o))i+=`            ${a}: {
+${b.join(`
 `)}
             };
-`;a+=`            };
+`;i+=`            };
             functions: {
-`;for(let o of r)a+=`                ${o.function_name}: {
+`;for(let a of s)i+=`                ${a.function_name}: {
                     args: Record<string, any>;
                     returns: any;
                 };
-`;a+=`            };
+`;i+=`            };
         };
     }
 }
-`;let E=P(process.cwd()),p=c.default.resolve(E,"kinetic-schema","kinetic-env.d.ts"),d=c.default.dirname(p);l.default.existsSync(d)||l.default.mkdirSync(d,{recursive:!0}),l.default.writeFileSync(p,a),console.log(`\u2705 Generated types at: ${p}`)}catch(n){console.error("\u274C Generation failed:",n),process.exit(1)}}x().then(()=>console.log("Auto-complete types generated successfully \u2728"));
+`;let c=x(process.cwd()),m=l.default.resolve(c,"kinetic-schema","kinetic-env.d.ts"),d=l.default.dirname(m);p.default.existsSync(d)||p.default.mkdirSync(d,{recursive:!0}),p.default.writeFileSync(m,i),console.log(`\u2705 Generated types at: ${m}`)}catch(n){console.error("\u274C Generation failed:",n),process.exit(1)}}v().then(()=>console.log("Auto-complete types generated successfully \u2728"));

package/dist/cli/generate.js

@@ -1,24 +1,24 @@
 #!/usr/bin/env node
-import b from"postgres";import g from"mysql2/promise";import m from"fs";import c from"path";import{fileURLToPath as d}from"url";var P=d(import.meta.url),f={text:"string",varchar:"string",char:"string",uuid:"string",int2:"number",int4:"number",int8:"number",float4:"number",float8:"number",numeric:"number",bool:"boolean",json:"any",jsonb:"any",date:"string",timestamp:"string",timestamptz:"string",bytea:"Buffer",_text:"string[]",_int4:"number[]"},E={varchar:"string",char:"string",text:"string",longtext:"string",int:"number",tinyint:"number",smallint:"number",mediumint:"number",bigint:"number",float:"number",double:"number",decimal:"number",datetime:"string",date:"string",timestamp:"string",json:"any",blob:"Buffer",longblob:"Buffer",tinyint1:"boolean"};function R(){let n=process.argv.slice(2),t={type:"pg"};for(let e=0;e<n.length;e++){let r=n[e];if(r.startsWith("--")){let i=r.replace(/^--/,"");if(i.includes("=")){let[a,o]=i.split("=");t[a]=o}else n[e+1]&&!n[e+1].startsWith("--")&&(t[i]=n[e+1],e++)}}return t}function N(n){let t=n;for(;t!==c.parse(t).root;){if(m.existsSync(c.join(t,"package.json")))return t;t=c.dirname(t)}return n}async function O(n){let t;n.connection?t=b(n.connection,{max:1}):t=b({host:n.host||"localhost",port:Number(n.port)||5432,user:n.user||"postgres",password:n.password||"",database:n.db||"postgres",max:1});try{let e=await t`
+import y from"postgres";import g from"mysql2/promise";import _ from"better-sqlite3";import p from"fs";import m from"path";import{fileURLToPath as d}from"url";var v=d(import.meta.url),E={text:"string",varchar:"string",char:"string",uuid:"string",int2:"number",int4:"number",int8:"number",float4:"number",float8:"number",numeric:"number",bool:"boolean",json:"any",jsonb:"any",date:"string",timestamp:"string",timestamptz:"string",bytea:"Buffer",_text:"string[]",_int4:"number[]"},R={varchar:"string",char:"string",text:"string",longtext:"string",int:"number",tinyint:"number",smallint:"number",mediumint:"number",bigint:"number",float:"number",double:"number",decimal:"number",datetime:"string",date:"string",timestamp:"string",json:"any",blob:"Buffer",longblob:"Buffer",tinyint1:"boolean"},h={integer:"number",int:"number",smallint:"number",bigint:"number",text:"string",varchar:"string",char:"string",clob:"string",blob:"Buffer",real:"number",double:"number",float:"number",numeric:"number",boolean:"boolean",bool:"boolean"};function N(){let n=process.argv.slice(2),t={type:"pg"};for(let e=0;e<n.length;e++){let s=n[e];if(s.startsWith("--")){let i=s.replace(/^--/,"");if(i.includes("=")){let[a,o]=i.split("=");t[a]=o}else n[e+1]&&!n[e+1].startsWith("--")&&(t[i]=n[e+1],e++)}}return t}function O(n){let t=n;for(;t!==m.parse(t).root;){if(p.existsSync(m.join(t,"package.json")))return t;t=m.dirname(t)}return n}async function M(n){let t;n.connection?t=y(n.connection,{max:1}):t=y({host:n.host||"localhost",port:Number(n.port)||5432,user:n.user||"postgres",password:n.password||"",database:n.db||"postgres",max:1});try{let e=await t`
             SELECT table_name, column_name, udt_name, is_nullable
             FROM information_schema.columns
             WHERE table_schema = 'public'
-            ORDER BY table_name, ordinal_position;`,r=await t`
+            ORDER BY table_name, ordinal_position;`,s=await t`
             SELECT p.proname                        as function_name,
                    pg_get_function_arguments(p.oid) as args_raw,
                    t.typname                        as return_type
             FROM pg_proc p
                      JOIN pg_type t ON p.prorettype = t.oid
                      JOIN pg_namespace n ON p.pronamespace = n.oid
-            WHERE n.nspname = 'public';`;return{columns:e,functions:r,typeMap:f}}finally{await t.end()}}async function h(n){let t=await g.createConnection({host:n.host||"localhost",user:n.user||"root",password:n.password||"",database:n.db,port:Number(n.port)||3306});try{let[e]=await t.execute(`
+            WHERE n.nspname = 'public';`;return{columns:e,functions:s,typeMap:E}}finally{await t.end()}}async function A(n){let t=await g.createConnection({host:n.host||"localhost",user:n.user||"root",password:n.password||"",database:n.db,port:Number(n.port)||3306});try{let[e]=await t.execute(`
             SELECT TABLE_NAME as table_name, COLUMN_NAME as column_name, DATA_TYPE as udt_name, IS_NULLABLE as is_nullable
             FROM INFORMATION_SCHEMA.COLUMNS
             WHERE TABLE_SCHEMA = ?
-            ORDER BY TABLE_NAME, ORDINAL_POSITION`,[n.db]),[r]=await t.execute(`
+            ORDER BY TABLE_NAME, ORDINAL_POSITION`,[n.db]),[s]=await t.execute(`
             SELECT ROUTINE_NAME as function_name
             FROM INFORMATION_SCHEMA.ROUTINES
             WHERE ROUTINE_SCHEMA = ?
-              AND ROUTINE_TYPE = 'PROCEDURE'`,[n.db]);return{columns:e,functions:r,typeMap:E}}finally{await t.end()}}async function M(){let n=R();console.log(`\u{1F52E} Kinetic SQL: Introspecting ${n.type==="mysql"?"MySQL":"PostgreSQL"}...`);try{let t;n.type==="mysql"?t=await h(n):t=await O(n);let{columns:e,functions:r,typeMap:i}=t,a={};for(let s of e){a[s.table_name]||(a[s.table_name]=[]);let l=i[s.udt_name]||"any";n.type==="mysql"&&s.udt_name==="tinyint"&&(l="number");let _=s.is_nullable==="YES"?"| null":"";a[s.table_name].push(`                ${s.column_name}: ${l}${_};`)}let o=`// Auto-generated by Kinetic SQL \u26A0\uFE0F Do NOT import this file manually.
+              AND ROUTINE_TYPE = 'PROCEDURE'`,[n.db]);return{columns:e,functions:s,typeMap:R}}finally{await t.end()}}async function T(n){let t=n.db||n.filename||n.connection;if(!t)throw new Error("\u274C Missing SQLite file path. Usage: k-sql gen --type=sqlite --db=./dev.db");let e=new _(t,{readonly:!0});try{let s=e.prepare("SELECT name FROM sqlite_master WHERE type='table' AND name NOT LIKE 'sqlite_%'").all(),i=[];for(let a of s){let o=e.prepare(`PRAGMA table_info('${a.name}')`).all();for(let l of o){let c=(l.type||"text").split("(")[0].toLowerCase().trim();i.push({table_name:a.name,column_name:l.name,udt_name:c,is_nullable:l.notnull===1?"NO":"YES"})}}return{columns:i,functions:[],typeMap:h}}finally{e.close()}}async function S(){let n=N();console.log(`\u{1F52E} Kinetic SQL: Introspecting ${n.type||"pg"}...`);try{let t;n.type==="mysql"?t=await A(n):n.type==="sqlite"?t=await T(n):t=await M(n);let{columns:e,functions:s,typeMap:i}=t,a={};for(let r of e){a[r.table_name]||(a[r.table_name]=[]);let u=i[r.udt_name]||"any";n.type==="mysql"&&r.udt_name==="tinyint"&&(u="number");let f=r.is_nullable==="YES"?"| null":"";a[r.table_name].push(`                ${r.column_name}: ${u}${f};`)}let o=`// Auto-generated by Kinetic SQL \u26A0\uFE0F Do NOT import this file manually.
 
 import 'kinetic-sql';
 
@@ -26,13 +26,13 @@ declare module 'kinetic-sql' {
     export interface Register {
         schema: {
             tables: {
-`;for(let[s,l]of Object.entries(a))o+=`            ${s}: {
-${l.join(`
+`;for(let[r,u]of Object.entries(a))o+=`            ${r}: {
+${u.join(`
 `)}
             };
 `;o+=`            };
             functions: {
-`;for(let s of r)o+=`                ${s.function_name}: {
+`;for(let r of s)o+=`                ${r.function_name}: {
                     args: Record<string, any>;
                     returns: any;
                 };
@@ -40,4 +40,4 @@ ${l.join(`
         };
     }
 }
-`;let y=N(process.cwd()),u=c.resolve(y,"kinetic-schema","kinetic-env.d.ts"),p=c.dirname(u);m.existsSync(p)||m.mkdirSync(p,{recursive:!0}),m.writeFileSync(u,o),console.log(`\u2705 Generated types at: ${u}`)}catch(t){console.error("\u274C Generation failed:",t),process.exit(1)}}M().then(()=>console.log("Auto-complete types generated successfully \u2728"));
+`;let l=O(process.cwd()),c=m.resolve(l,"kinetic-schema","kinetic-env.d.ts"),b=m.dirname(c);p.existsSync(b)||p.mkdirSync(b,{recursive:!0}),p.writeFileSync(c,o),console.log(`\u2705 Generated types at: ${c}`)}catch(t){console.error("\u274C Generation failed:",t),process.exit(1)}}S().then(()=>console.log("Auto-complete types generated successfully \u2728"));

package/dist/index.cjs

@@ -1,4 +1,19 @@
-"use strict";var S=Object.create;var p=Object.defineProperty;var f=Object.getOwnPropertyDescriptor;var O=Object.getOwnPropertyNames;var T=Object.getPrototypeOf,N=Object.prototype.hasOwnProperty;var v=(t,e)=>{for(var r in e)p(t,r,{get:e[r],enumerable:!0})},m=(t,e,r,n)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of O(e))!N.call(t,i)&&i!==r&&p(t,i,{get:()=>e[i],enumerable:!(n=f(e,i))||n.enumerable});return t};var C=(t,e,r)=>(r=t!=null?S(T(t)):{},m(e||!t||!t.__esModule?p(r,"default",{value:t,enumerable:!0}):r,t)),x=t=>m(p({},"__esModule",{value:!0}),t);var D={};v(D,{KineticClient:()=>d,KineticError:()=>a,and:()=>s.and,asc:()=>s.asc,desc:()=>s.desc,eq:()=>s.eq,or:()=>s.or,sql:()=>s.sql});module.exports=x(D);var c=C(require("postgres"),1);var a=class t extends Error{code;details;constructor(e,r,n){super(r),this.name="KineticError",this.code=e,this.details=n,Object.setPrototypeOf(this,t.prototype)}};var g=`
+"use strict";var N=Object.create;var d=Object.defineProperty;var I=Object.getOwnPropertyDescriptor;var C=Object.getOwnPropertyNames;var D=Object.getPrototypeOf,_=Object.prototype.hasOwnProperty;var L=(s,e)=>{for(var t in e)d(s,t,{get:e[t],enumerable:!0})},R=(s,e,t,r)=>{if(e&&typeof e=="object"||typeof e=="function")for(let i of C(e))!_.call(s,i)&&i!==t&&d(s,i,{get:()=>e[i],enumerable:!(r=I(e,i))||r.enumerable});return s};var u=(s,e,t)=>(t=s!=null?N(D(s)):{},R(e||!s||!s.__esModule?d(t,"default",{value:s,enumerable:!0}):t,s)),$=s=>R(d({},"__esModule",{value:!0}),s);var x={};L(x,{KineticClient:()=>g,KineticError:()=>o,and:()=>a.and,asc:()=>a.asc,desc:()=>a.desc,eq:()=>a.eq,or:()=>a.or,sql:()=>a.sql});module.exports=$(x);var o=class s extends Error{code;details;constructor(e,t,r){super(t),this.name="KineticError",this.code=e,this.details=r,Object.setPrototypeOf(this,s.prototype)}};var S=u(require("better-sqlite3"),1),y=class{db;subscribers=new Map;constructor(e){let t=":memory:";typeof e.connectionString=="string"?t=e.connectionString.replace(/^sqlite:\/\//,""):e.filename&&(t=e.filename),this.db=new S.default(t,e.options||{})}get raw(){return this.db}async init(){this.db.function("kinetic_bridge",(e,t,r)=>{this.handleEvent(e,t,r)})}handleEvent(e,t,r){let i=this.subscribers.get(e);if(!(!i||i.length===0))try{let n=null;t!=="DELETE"&&(n=this.db.prepare(`SELECT * FROM ${e} WHERE rowid = ?`).get(r));let l={action:t,data:n};i.forEach(p=>p(l))}catch(n){console.error(`\u26A0\uFE0F Kinetic SQLite: Failed to bridge event for ${e}`,n)}}async subscribe(e,t){return this.subscribers.has(e)||(this.subscribers.set(e,[]),this.attachTriggers(e)),this.subscribers.get(e).push(t),{unsubscribe:()=>{let r=this.subscribers.get(e);if(r){let i=r.indexOf(t);i>-1&&r.splice(i,1)}}}}attachTriggers(e){try{this.db.exec(`
+                CREATE TRIGGER IF NOT EXISTS kinetic_${e}_insert AFTER INSERT ON ${e}
+                BEGIN
+                    SELECT kinetic_bridge('${e}', 'INSERT', NEW.rowid);
+                END;
+                
+                CREATE TRIGGER IF NOT EXISTS kinetic_${e}_update AFTER UPDATE ON ${e}
+                BEGIN
+                    SELECT kinetic_bridge('${e}', 'UPDATE', NEW.rowid);
+                END;
+
+                CREATE TRIGGER IF NOT EXISTS kinetic_${e}_delete AFTER DELETE ON ${e}
+                BEGIN
+                    SELECT kinetic_bridge('${e}', 'DELETE', OLD.rowid);
+                END;
+            `)}catch(t){console.warn(`\u26A0\uFE0F Kinetic SQLite: Could not attach triggers to ${e}. Ensure table exists.`,t)}}async rpc(e,t){try{let i=Object.keys(t||{}).map(()=>"?").join(","),n=Object.values(t||{});return{data:this.db.prepare(`SELECT ${e}(${i})`).all(...n),error:null}}catch(r){return{data:null,error:r}}}async end(){this.db.close()}};var f=u(require("mysql2/promise"),1),b=u(require("@rodrigogs/mysql-events"),1);var m=class{pool;instance=null;subscribers=new Map;config;constructor(e){this.config=e,this.pool=f.default.createPool({host:e.host,user:e.user,password:e.password,database:e.database,port:e.port||3306,waitForConnections:!0,connectionLimit:e.poolSize||10,queueLimit:0})}get raw(){return this.pool}async init(){if(!this.config.realtimeEnabled)return;let e={host:this.config.host,user:this.config.user,password:this.config.password,port:this.config.port||3306};this.instance=new b.default(e,{startAtEnd:!0,excludedSchemas:{mysql:!0,sys:!0,information_schema:!0,performance_schema:!0}}),await this.instance.start(),this.instance.addTrigger({name:"KINETIC_EVENTS",expression:"*",statement:b.default.STATEMENTS.ALL,onEvent:t=>{if(t.schema===this.config.database&&this.subscribers.has(t.table)){let r=this.subscribers.get(t.table);r&&t.rows.forEach(i=>{r({action:t.type,data:i})})}}}),this.instance.on("error",t=>console.error("MySQL Realtime Error:",t))}async subscribe(e,t){if(!this.config.realtimeEnabled)throw new o("CONFIG_ERROR","Realtime is disabled. Set { realtimeEnabled: true } in config.");return this.subscribers.set(e,t),{unsubscribe:()=>{this.subscribers.delete(e)}}}async rpc(e,t){try{let r=Object.values(t||{}),i=r.map(()=>"?").join(", "),[n]=await this.pool.execute(`CALL ${e}(${i})`,r);return{data:n,error:null}}catch(r){return{data:null,error:new o("RPC_ERROR",`MySQL RPC Failed: ${e}`,r)}}}async end(){this.instance&&await this.instance.stop(),await this.pool.end()}};var E=u(require("postgres"),1);var T=`
 CREATE OR REPLACE FUNCTION notify_changes() RETURNS TRIGGER AS $$
 DECLARE
   payload json;
@@ -11,13 +26,13 @@ BEGIN
   PERFORM pg_notify('table_events', payload::text);
   RETURN NEW;
 END;
-$$ LANGUAGE plpgsql;`,b=t=>`
+$$ LANGUAGE plpgsql;`,v=s=>`
 DO $$
 BEGIN
-  IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'watch_${t}') THEN
-    CREATE TRIGGER watch_${t}
-    AFTER INSERT OR UPDATE OR DELETE ON "${t}"
+  IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'watch_${s}') THEN
+    CREATE TRIGGER watch_${s}
+    AFTER INSERT OR UPDATE OR DELETE ON "${s}"
     FOR EACH ROW EXECUTE FUNCTION notify_changes();
   END IF;
 END
-$$;`;var l=class{sql;config;realtimeEnabled;constructor(e){if(this.config=e,this.realtimeEnabled=e.realtimeEnabled||!1,typeof e.connectionString=="string")this.sql=(0,c.default)(e.connectionString,{max:e.poolSize||10});else{let{type:r,realtimeEnabled:n,poolSize:i,...o}=e;this.sql=(0,c.default)({...o,max:i||10})}}get raw(){return this.sql}async init(){if(this.realtimeEnabled)try{await this.sql.unsafe(g)}catch(e){console.warn("\u26A0\uFE0F Kinetic Driver: Failed to install generic broadcast function.",e)}}async rpc(e,r){try{let n=Object.values(r||{}),o=Object.keys(r||{}).map((h,u)=>`${h} := $${u+1}`).join(", "),R=`SELECT * FROM "${e}"(${o})`;return{data:await this.sql.unsafe(R,n),error:null}}catch(n){return{data:null,error:new a("RPC_ERROR",`Failed to execute function: ${e}`,n)}}}async subscribe(e,r){if(!this.realtimeEnabled)throw new a("CONFIG_ERROR","Realtime is disabled in config.");try{await this.sql.unsafe(b(e))}catch(i){console.error(`Failed to attach trigger to ${e}`,i)}let n;if(typeof this.config.connectionString=="string")n=(0,c.default)(this.config.connectionString,{max:1});else{let{type:i,realtimeEnabled:o,poolSize:R,...y}=this.config;n=(0,c.default)({...y,max:1})}return n.listen("table_events",i=>{let o=JSON.parse(i);o.table===e&&r(o)}).catch(i=>console.error("Listener error:",i)),{unsubscribe:async()=>{await n.end()}}}async end(){await this.sql.end()}};var d=class t{constructor(e){this.config=e;if(e.type==="pg")this.driver=new l(e);else throw new a("CONFIG_ERROR",`Unsupported DB type: ${e.type}`)}driver;static async create(e){let r=new t(e);return await r.init(),r}async init(){this.driver instanceof l&&await this.driver.init()}async rpc(e,r){return this.driver.rpc(e,r)}async subscribe(e,r){return this.driver.subscribe(e,r)}};var s=require("drizzle-orm");0&&(module.exports={KineticClient,KineticError,and,asc,desc,eq,or,sql});
+$$;`;var h=class{sql;config;realtimeEnabled;constructor(e){if(this.config=e,this.realtimeEnabled=e.realtimeEnabled||!1,typeof e.connectionString=="string")this.sql=(0,E.default)(e.connectionString,{max:e.poolSize||10});else{let{type:t,realtimeEnabled:r,poolSize:i,...n}=e;this.sql=(0,E.default)({...n,max:i||10})}}get raw(){return this.sql}async init(){if(this.realtimeEnabled)try{await this.sql.unsafe(T)}catch(e){console.warn("\u26A0\uFE0F Kinetic Driver: Failed to install generic broadcast function.",e)}}async rpc(e,t){try{let r=Object.values(t||{}),n=Object.keys(t||{}).map((O,w)=>`${O} := $${w+1}`).join(", "),l=`SELECT * FROM "${e}"(${n})`;return{data:await this.sql.unsafe(l,r),error:null}}catch(r){return{data:null,error:new o("RPC_ERROR",`Failed to execute function: ${e}`,r)}}}async subscribe(e,t){if(!this.realtimeEnabled)throw new o("CONFIG_ERROR","Realtime is disabled in config.");try{await this.sql.unsafe(v(e))}catch(i){console.error(`Failed to attach trigger to ${e}`,i)}let r;if(typeof this.config.connectionString=="string")r=(0,E.default)(this.config.connectionString,{max:1});else{let{type:i,realtimeEnabled:n,poolSize:l,...p}=this.config;r=(0,E.default)({...p,max:1})}return r.listen("table_events",i=>{let n=JSON.parse(i);n.table===e&&t(n)}).catch(i=>console.error("Listener error:",i)),{unsubscribe:async()=>{await r.end()}}}async end(){await this.sql.end()}};var g=class s{constructor(e){this.config=e;if(e.type==="pg")this.driver=new h(e);else if(e.type==="mysql")this.driver=new m(e);else if(e.type==="sqlite")this.driver=new y(e);else throw new o("CONFIG_ERROR",`Unsupported DB type: ${e.type}`)}driver;static async create(e){let t=new s(e);return await t.init(),t}async init(){await this.driver.init()}async rpc(e,t){return this.driver.rpc(e,t)}async subscribe(e,t){return this.driver.subscribe(e,t)}get raw(){return this.driver.raw}};var a=require("drizzle-orm");0&&(module.exports={KineticClient,KineticError,and,asc,desc,eq,or,sql});

package/dist/index.d.cts

@@ -36,6 +36,11 @@ type KineticConfig = {
     port?: number;
     poolSize?: number;
     realtimeEnabled?: boolean;
+} | {
+    type: 'sqlite';
+    connectionString?: string;
+    filename?: string;
+    options?: any;
 };
 declare class KineticClient<Schema extends KineticSchema = ResolvedDB> {
     private config;
@@ -53,6 +58,7 @@ declare class KineticClient<Schema extends KineticSchema = ResolvedDB> {
     }) => void): Promise<{
         unsubscribe: () => void;
     }>;
+    get raw(): any;
 }
 
 type KineticErrorCode = 'CONFIG_ERROR' | 'CONNECTION_FAILED' | 'QUERY_FAILED' | 'RPC_ERROR' | 'REALTIME_ERROR' | 'INTERNAL_ERROR';

package/dist/index.d.ts

@@ -36,6 +36,11 @@ type KineticConfig = {
     port?: number;
     poolSize?: number;
     realtimeEnabled?: boolean;
+} | {
+    type: 'sqlite';
+    connectionString?: string;
+    filename?: string;
+    options?: any;
 };
 declare class KineticClient<Schema extends KineticSchema = ResolvedDB> {
     private config;
@@ -53,6 +58,7 @@ declare class KineticClient<Schema extends KineticSchema = ResolvedDB> {
     }) => void): Promise<{
         unsubscribe: () => void;
     }>;
+    get raw(): any;
 }
 
 type KineticErrorCode = 'CONFIG_ERROR' | 'CONNECTION_FAILED' | 'QUERY_FAILED' | 'RPC_ERROR' | 'REALTIME_ERROR' | 'INTERNAL_ERROR';

package/dist/index.js

@@ -1,4 +1,19 @@
-import p from"postgres";var a=class n extends Error{code;details;constructor(e,t,r){super(t),this.name="KineticError",this.code=e,this.details=r,Object.setPrototypeOf(this,n.prototype)}};var R=`
+var a=class n extends Error{code;details;constructor(e,t,r){super(t),this.name="KineticError",this.code=e,this.details=r,Object.setPrototypeOf(this,n.prototype)}};import f from"better-sqlite3";var E=class{db;subscribers=new Map;constructor(e){let t=":memory:";typeof e.connectionString=="string"?t=e.connectionString.replace(/^sqlite:\/\//,""):e.filename&&(t=e.filename),this.db=new f(t,e.options||{})}get raw(){return this.db}async init(){this.db.function("kinetic_bridge",(e,t,r)=>{this.handleEvent(e,t,r)})}handleEvent(e,t,r){let i=this.subscribers.get(e);if(!(!i||i.length===0))try{let s=null;t!=="DELETE"&&(s=this.db.prepare(`SELECT * FROM ${e} WHERE rowid = ?`).get(r));let l={action:t,data:s};i.forEach(p=>p(l))}catch(s){console.error(`\u26A0\uFE0F Kinetic SQLite: Failed to bridge event for ${e}`,s)}}async subscribe(e,t){return this.subscribers.has(e)||(this.subscribers.set(e,[]),this.attachTriggers(e)),this.subscribers.get(e).push(t),{unsubscribe:()=>{let r=this.subscribers.get(e);if(r){let i=r.indexOf(t);i>-1&&r.splice(i,1)}}}}attachTriggers(e){try{this.db.exec(`
+                CREATE TRIGGER IF NOT EXISTS kinetic_${e}_insert AFTER INSERT ON ${e}
+                BEGIN
+                    SELECT kinetic_bridge('${e}', 'INSERT', NEW.rowid);
+                END;
+                
+                CREATE TRIGGER IF NOT EXISTS kinetic_${e}_update AFTER UPDATE ON ${e}
+                BEGIN
+                    SELECT kinetic_bridge('${e}', 'UPDATE', NEW.rowid);
+                END;
+
+                CREATE TRIGGER IF NOT EXISTS kinetic_${e}_delete AFTER DELETE ON ${e}
+                BEGIN
+                    SELECT kinetic_bridge('${e}', 'DELETE', OLD.rowid);
+                END;
+            `)}catch(t){console.warn(`\u26A0\uFE0F Kinetic SQLite: Could not attach triggers to ${e}. Ensure table exists.`,t)}}async rpc(e,t){try{let i=Object.keys(t||{}).map(()=>"?").join(","),s=Object.values(t||{});return{data:this.db.prepare(`SELECT ${e}(${i})`).all(...s),error:null}}catch(r){return{data:null,error:r}}}async end(){this.db.close()}};import T from"mysql2/promise";import m from"@rodrigogs/mysql-events";var d=class{pool;instance=null;subscribers=new Map;config;constructor(e){this.config=e,this.pool=T.createPool({host:e.host,user:e.user,password:e.password,database:e.database,port:e.port||3306,waitForConnections:!0,connectionLimit:e.poolSize||10,queueLimit:0})}get raw(){return this.pool}async init(){if(!this.config.realtimeEnabled)return;let e={host:this.config.host,user:this.config.user,password:this.config.password,port:this.config.port||3306};this.instance=new m(e,{startAtEnd:!0,excludedSchemas:{mysql:!0,sys:!0,information_schema:!0,performance_schema:!0}}),await this.instance.start(),this.instance.addTrigger({name:"KINETIC_EVENTS",expression:"*",statement:m.STATEMENTS.ALL,onEvent:t=>{if(t.schema===this.config.database&&this.subscribers.has(t.table)){let r=this.subscribers.get(t.table);r&&t.rows.forEach(i=>{r({action:t.type,data:i})})}}}),this.instance.on("error",t=>console.error("MySQL Realtime Error:",t))}async subscribe(e,t){if(!this.config.realtimeEnabled)throw new a("CONFIG_ERROR","Realtime is disabled. Set { realtimeEnabled: true } in config.");return this.subscribers.set(e,t),{unsubscribe:()=>{this.subscribers.delete(e)}}}async rpc(e,t){try{let r=Object.values(t||{}),i=r.map(()=>"?").join(", "),[s]=await this.pool.execute(`CALL ${e}(${i})`,r);return{data:s,error:null}}catch(r){return{data:null,error:new a("RPC_ERROR",`MySQL RPC Failed: ${e}`,r)}}}async end(){this.instance&&await this.instance.stop(),await this.pool.end()}};import u from"postgres";var h=`
 CREATE OR REPLACE FUNCTION notify_changes() RETURNS TRIGGER AS $$
 DECLARE
   payload json;
@@ -11,7 +26,7 @@ BEGIN
   PERFORM pg_notify('table_events', payload::text);
   RETURN NEW;
 END;
-$$ LANGUAGE plpgsql;`,y=n=>`
+$$ LANGUAGE plpgsql;`,b=n=>`
 DO $$
 BEGIN
   IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'watch_${n}') THEN
@@ -20,4 +35,4 @@ BEGIN
     FOR EACH ROW EXECUTE FUNCTION notify_changes();
   END IF;
 END
-$$;`;var o=class{sql;config;realtimeEnabled;constructor(e){if(this.config=e,this.realtimeEnabled=e.realtimeEnabled||!1,typeof e.connectionString=="string")this.sql=p(e.connectionString,{max:e.poolSize||10});else{let{type:t,realtimeEnabled:r,poolSize:i,...s}=e;this.sql=p({...s,max:i||10})}}get raw(){return this.sql}async init(){if(this.realtimeEnabled)try{await this.sql.unsafe(R)}catch(e){console.warn("\u26A0\uFE0F Kinetic Driver: Failed to install generic broadcast function.",e)}}async rpc(e,t){try{let r=Object.values(t||{}),s=Object.keys(t||{}).map((g,b)=>`${g} := $${b+1}`).join(", "),E=`SELECT * FROM "${e}"(${s})`;return{data:await this.sql.unsafe(E,r),error:null}}catch(r){return{data:null,error:new a("RPC_ERROR",`Failed to execute function: ${e}`,r)}}}async subscribe(e,t){if(!this.realtimeEnabled)throw new a("CONFIG_ERROR","Realtime is disabled in config.");try{await this.sql.unsafe(y(e))}catch(i){console.error(`Failed to attach trigger to ${e}`,i)}let r;if(typeof this.config.connectionString=="string")r=p(this.config.connectionString,{max:1});else{let{type:i,realtimeEnabled:s,poolSize:E,...d}=this.config;r=p({...d,max:1})}return r.listen("table_events",i=>{let s=JSON.parse(i);s.table===e&&t(s)}).catch(i=>console.error("Listener error:",i)),{unsubscribe:async()=>{await r.end()}}}async end(){await this.sql.end()}};var m=class n{constructor(e){this.config=e;if(e.type==="pg")this.driver=new o(e);else throw new a("CONFIG_ERROR",`Unsupported DB type: ${e.type}`)}driver;static async create(e){let t=new n(e);return await t.init(),t}async init(){this.driver instanceof o&&await this.driver.init()}async rpc(e,t){return this.driver.rpc(e,t)}async subscribe(e,t){return this.driver.subscribe(e,t)}};import{sql as L,eq as K,desc as G,asc as U,and as P,or as j}from"drizzle-orm";export{m as KineticClient,a as KineticError,P as and,U as asc,G as desc,K as eq,j as or,L as sql};
+$$;`;var y=class{sql;config;realtimeEnabled;constructor(e){if(this.config=e,this.realtimeEnabled=e.realtimeEnabled||!1,typeof e.connectionString=="string")this.sql=u(e.connectionString,{max:e.poolSize||10});else{let{type:t,realtimeEnabled:r,poolSize:i,...s}=e;this.sql=u({...s,max:i||10})}}get raw(){return this.sql}async init(){if(this.realtimeEnabled)try{await this.sql.unsafe(h)}catch(e){console.warn("\u26A0\uFE0F Kinetic Driver: Failed to install generic broadcast function.",e)}}async rpc(e,t){try{let r=Object.values(t||{}),s=Object.keys(t||{}).map((R,S)=>`${R} := $${S+1}`).join(", "),l=`SELECT * FROM "${e}"(${s})`;return{data:await this.sql.unsafe(l,r),error:null}}catch(r){return{data:null,error:new a("RPC_ERROR",`Failed to execute function: ${e}`,r)}}}async subscribe(e,t){if(!this.realtimeEnabled)throw new a("CONFIG_ERROR","Realtime is disabled in config.");try{await this.sql.unsafe(b(e))}catch(i){console.error(`Failed to attach trigger to ${e}`,i)}let r;if(typeof this.config.connectionString=="string")r=u(this.config.connectionString,{max:1});else{let{type:i,realtimeEnabled:s,poolSize:l,...p}=this.config;r=u({...p,max:1})}return r.listen("table_events",i=>{let s=JSON.parse(i);s.table===e&&t(s)}).catch(i=>console.error("Listener error:",i)),{unsubscribe:async()=>{await r.end()}}}async end(){await this.sql.end()}};var g=class n{constructor(e){this.config=e;if(e.type==="pg")this.driver=new y(e);else if(e.type==="mysql")this.driver=new d(e);else if(e.type==="sqlite")this.driver=new E(e);else throw new a("CONFIG_ERROR",`Unsupported DB type: ${e.type}`)}driver;static async create(e){let t=new n(e);return await t.init(),t}async init(){await this.driver.init()}async rpc(e,t){return this.driver.rpc(e,t)}async subscribe(e,t){return this.driver.subscribe(e,t)}get raw(){return this.driver.raw}};import{sql as V,eq as Y,desc as Z,asc as ee,and as te,or as re}from"drizzle-orm";export{g as KineticClient,a as KineticError,te as and,ee as asc,Z as desc,Y as eq,re as or,V as sql};

package/package.json

@@ -1,12 +1,13 @@
 {
   "name": "kinetic-sql",
-  "version": "1.0.0",
+  "version": "1.0.2",
   "description": "Zero-config, type-safe Postgres & MySQL client with Realtime subscriptions.",
   "type": "module",
   "main": "./dist/index.js",
   "scripts": {
     "prebuild": "rm -rf dist",
     "build": "tsup",
+    "prepublishOnly": "npm run build",
     "dev": "tsup --watch",
     "gen": "node dist/cli/generate.cjs"
   },
@@ -27,6 +28,7 @@
   ],
   "dependencies": {
     "@rodrigogs/mysql-events": "^0.6.0",
+    "better-sqlite3": "^12.6.2",
     "drizzle-orm": "^0.45.1",
     "mysql2": "^3.16.3",
     "postgres": "^3.4.8"
@@ -34,6 +36,7 @@
   "devDependencies": {
     "@eslint/js": "^9.39.2",
     "@stylistic/eslint-plugin": "^5.7.1",
+    "@types/better-sqlite3": "^7.6.13",
     "@types/node": "^25.2.0",
     "@typescript-eslint/parser": "^8.54.0",
     "eslint": "^9.39.2",