kinetic-sql 1.0.0

package/LICENSE

@@ -0,0 +1,23 @@
+MIT License
+
+Copyright (c) 2026 Kapil Kumar
+Github Link: https://github.com/serial-committer
+Portfolio Link: https://the-debug-knight.bio
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# ⚡ Kinetic SQL (`k-sql`)
+
+> **The "Tailwind" of Database Clients.** 
+> Zero Config. Full Autocomplete. Realtime by default.
+
+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.
+- **⚡ Realtime Subscriptions:** Listen to table changes (`INSERT`, `UPDATE`) with one line of code.
+- **🛡️ RPC Wrapper:** Call Stored Procedures as native JavaScript functions.
+- **🔌 Connection Pooling:** Built-in management for high-scale apps.
+
+---
+
+## 🚀 Quick Start
+
+### 1. Install
+
+```bash
+
+# For PostgreSQL
+
+npm install kinetic-sql drizzle-orm postgres
+
+# For MySQL
+
+npm install kinetic-sql drizzle-orm mysql2 @rodrigogs/mysql-events
+```
+
+### 2. Initialize
+
+```typescript
+import { KineticClient } from 'kinetic-sql';
+
+// Connects using your DATABASE_URL env var by default
+const db = await KineticClient.create({
+type: 'pg', // or 'mysql'
+connectionString: process.env.DATABASE_URL,
+realtimeEnabled: true
+});
+```
+
+### 3. Generate Types (The Magic)
+
+Run this command in your terminal. It reads your DB and patches the library automatically.
+
+```bash
+
+# PostgreSQL (Default)
+
+npx k-sql gen --connection "postgres://..."
+
+# MySQL
+
+npx k-sql gen --type mysql --host localhost --user root --db mydb
+```
+
+---
+
+## 📚 Usage
+
+### Realtime Subscriptions ✨
+
+#### Listen to database events without setting up WebSockets.
+
+```typescript
+// 'tasks' is auto-completed!
+const sub = await db.subscribe('tasks', (event) => {
+console.log(event.action); // 'INSERT' | 'UPDATE'
+console.log(event.data.title); // Typed!
+});
+
+// Later...
+await sub.unsubscribe();
+```
+
+### Calling RPC Functions ✨
+
+#### Call stored procedures as native JS methods.
+
+```typescript
+// 'add_todo' is auto-completed!
+const { data, error } = await db.rpc('add_todo', {
+p_title: "Build cool app", // Param names are checked!
+p_user_id: 123
+});
+```
+
+### Standard Queries (via Drizzle) ✨
+
+#### We expose the full power of Drizzle ORM under the hood.
+
+```typescript
+import { sql, eq } from 'kinetic-sql';
+
+const users = await db.orm
+.select()
+.from(sql`users`)
+.where(eq(sql`id`, 1));
+```
+
+---
+
+## ⚙️ Configuration
+
+### PostgreSQL
+
+```typescript
+const db = await KineticClient.create({
+type: 'pg',
+host: 'localhost',
+port: 5432,
+user: 'postgres',
+password: 'password',
+database: 'mydb',
+realtimeEnabled: true
+});
+```
+
+### MySQL
+
+```typescript
+const db = await KineticClient.create({
+type: 'mysql',
+host: 'localhost',
+port: 3306,
+user: 'root',
+password: 'password',
+database: 'mydb',
+realtimeEnabled: true // Requires Binary Logging enabled on server
+});
+```
+
+## ⚠️ Requirements
+
+- **Node.js:** 18+
+- **PostgreSQL:** 12+ (Native `LISTEN/NOTIFY` used)
+- **MySQL:** 5.7+
+    - *Note:* For Realtime features, your MySQL server must have **Binary Logging** enabled (`log_bin = ON`).
+
+## 📄 License
+
+MIT

package/dist/cli/generate.cjs

@@ -0,0 +1,43 @@
+#!/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`
+            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`
+            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(`
+            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(`
+            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.
+
+import 'kinetic-sql';
+
+declare module 'kinetic-sql' {
+    export interface Register {
+        schema: {
+            tables: {
+`;for(let[o,m]of Object.entries(i))a+=`            ${o}: {
+${m.join(`
+`)}
+            };
+`;a+=`            };
+            functions: {
+`;for(let o of r)a+=`                ${o.function_name}: {
+                    args: Record<string, any>;
+                    returns: any;
+                };
+`;a+=`            };
+        };
+    }
+}
+`;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"));

package/dist/cli/generate.d.cts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/generate.d.ts

@@ -0,0 +1 @@
+#!/usr/bin/env node

package/dist/cli/generate.js

@@ -0,0 +1,43 @@
+#!/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`
+            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`
+            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(`
+            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(`
+            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.
+
+import 'kinetic-sql';
+
+declare module 'kinetic-sql' {
+    export interface Register {
+        schema: {
+            tables: {
+`;for(let[s,l]of Object.entries(a))o+=`            ${s}: {
+${l.join(`
+`)}
+            };
+`;o+=`            };
+            functions: {
+`;for(let s of r)o+=`                ${s.function_name}: {
+                    args: Record<string, any>;
+                    returns: any;
+                };
+`;o+=`            };
+        };
+    }
+}
+`;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"));

package/dist/index.cjs

@@ -0,0 +1,23 @@
+"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=`
+CREATE OR REPLACE FUNCTION notify_changes() RETURNS TRIGGER AS $$
+DECLARE
+  payload json;
+BEGIN
+  payload = json_build_object(
+    'table', TG_TABLE_NAME,
+    'action', TG_OP,
+    'data', COALESCE(NEW, OLD)
+  );
+  PERFORM pg_notify('table_events', payload::text);
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;`,b=t=>`
+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}"
+    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});

package/dist/index.d.cts

@@ -0,0 +1,65 @@
+export { and, asc, desc, eq, or, sql } from 'drizzle-orm';
+
+interface Register {
+}
+interface KineticSchema {
+    tables: Record<string, any>;
+    functions: Record<string, {
+        args: any;
+        returns: any;
+    }>;
+}
+type ResolvedDB = Register extends {
+    schema: infer S;
+} ? S : KineticSchema;
+type KineticConfig = {
+    type: 'pg';
+    connectionString: string;
+    poolSize?: number;
+    realtimeEnabled?: boolean;
+} | {
+    type: 'pg';
+    host: string;
+    port: number;
+    user: string;
+    password?: string;
+    database: string;
+    ssl?: boolean;
+    poolSize?: number;
+    realtimeEnabled?: boolean;
+} | {
+    type: 'mysql';
+    host: string;
+    user: string;
+    password?: string;
+    database: string;
+    port?: number;
+    poolSize?: number;
+    realtimeEnabled?: boolean;
+};
+declare class KineticClient<Schema extends KineticSchema = ResolvedDB> {
+    private config;
+    private readonly driver;
+    static create<S extends KineticSchema = ResolvedDB>(config: KineticConfig): Promise<KineticClient<S>>;
+    private constructor();
+    private init;
+    rpc<FnName extends keyof Schema['functions'] & string>(functionName: FnName, params: Schema['functions'][FnName]['args']): Promise<{
+        data: any;
+        error: any;
+    }>;
+    subscribe<TableName extends keyof Schema['tables'] & string>(tableName: TableName, callback: (payload: {
+        action: 'INSERT' | 'UPDATE' | 'DELETE';
+        data: Schema['tables'][TableName];
+    }) => void): Promise<{
+        unsubscribe: () => void;
+    }>;
+}
+
+type KineticErrorCode = 'CONFIG_ERROR' | 'CONNECTION_FAILED' | 'QUERY_FAILED' | 'RPC_ERROR' | 'REALTIME_ERROR' | 'INTERNAL_ERROR';
+declare class KineticError extends Error {
+    readonly code: KineticErrorCode;
+    readonly details?: any;
+    constructor(code: KineticErrorCode, message: string, originalError?: any);
+}
+
+export { KineticClient, type KineticConfig, KineticError, type KineticErrorCode, type KineticSchema, type Register, type ResolvedDB };

package/dist/index.d.ts

@@ -0,0 +1,65 @@
+export { and, asc, desc, eq, or, sql } from 'drizzle-orm';
+
+interface Register {
+}
+interface KineticSchema {
+    tables: Record<string, any>;
+    functions: Record<string, {
+        args: any;
+        returns: any;
+    }>;
+}
+type ResolvedDB = Register extends {
+    schema: infer S;
+} ? S : KineticSchema;
+type KineticConfig = {
+    type: 'pg';
+    connectionString: string;
+    poolSize?: number;
+    realtimeEnabled?: boolean;
+} | {
+    type: 'pg';
+    host: string;
+    port: number;
+    user: string;
+    password?: string;
+    database: string;
+    ssl?: boolean;
+    poolSize?: number;
+    realtimeEnabled?: boolean;
+} | {
+    type: 'mysql';
+    host: string;
+    user: string;
+    password?: string;
+    database: string;
+    port?: number;
+    poolSize?: number;
+    realtimeEnabled?: boolean;
+};
+declare class KineticClient<Schema extends KineticSchema = ResolvedDB> {
+    private config;
+    private readonly driver;
+    static create<S extends KineticSchema = ResolvedDB>(config: KineticConfig): Promise<KineticClient<S>>;
+    private constructor();
+    private init;
+    rpc<FnName extends keyof Schema['functions'] & string>(functionName: FnName, params: Schema['functions'][FnName]['args']): Promise<{
+        data: any;
+        error: any;
+    }>;
+    subscribe<TableName extends keyof Schema['tables'] & string>(tableName: TableName, callback: (payload: {
+        action: 'INSERT' | 'UPDATE' | 'DELETE';
+        data: Schema['tables'][TableName];
+    }) => void): Promise<{
+        unsubscribe: () => void;
+    }>;
+}
+
+type KineticErrorCode = 'CONFIG_ERROR' | 'CONNECTION_FAILED' | 'QUERY_FAILED' | 'RPC_ERROR' | 'REALTIME_ERROR' | 'INTERNAL_ERROR';
+declare class KineticError extends Error {
+    readonly code: KineticErrorCode;
+    readonly details?: any;
+    constructor(code: KineticErrorCode, message: string, originalError?: any);
+}
+
+export { KineticClient, type KineticConfig, KineticError, type KineticErrorCode, type KineticSchema, type Register, type ResolvedDB };

package/dist/index.js

@@ -0,0 +1,23 @@
+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=`
+CREATE OR REPLACE FUNCTION notify_changes() RETURNS TRIGGER AS $$
+DECLARE
+  payload json;
+BEGIN
+  payload = json_build_object(
+    'table', TG_TABLE_NAME,
+    'action', TG_OP,
+    'data', COALESCE(NEW, OLD)
+  );
+  PERFORM pg_notify('table_events', payload::text);
+  RETURN NEW;
+END;
+$$ LANGUAGE plpgsql;`,y=n=>`
+DO $$
+BEGIN
+  IF NOT EXISTS (SELECT 1 FROM pg_trigger WHERE tgname = 'watch_${n}') THEN
+    CREATE TRIGGER watch_${n}
+    AFTER INSERT OR UPDATE OR DELETE ON "${n}"
+    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};

package/package.json

@@ -0,0 +1,69 @@
+{
+  "name": "kinetic-sql",
+  "version": "1.0.0",
+  "description": "Zero-config, type-safe Postgres & MySQL client with Realtime subscriptions.",
+  "type": "module",
+  "main": "./dist/index.js",
+  "scripts": {
+    "prebuild": "rm -rf dist",
+    "build": "tsup",
+    "dev": "tsup --watch",
+    "gen": "node dist/cli/generate.cjs"
+  },
+  "exports": {
+    ".": {
+      "types": "./dist/index.d.ts",
+      "import": "./dist/index.js",
+      "require": "./dist/index.cjs"
+    }
+  },
+  "bin": {
+    "k-sql": "./dist/cli/generate.cjs"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE"
+  ],
+  "dependencies": {
+    "@rodrigogs/mysql-events": "^0.6.0",
+    "drizzle-orm": "^0.45.1",
+    "mysql2": "^3.16.3",
+    "postgres": "^3.4.8"
+  },
+  "devDependencies": {
+    "@eslint/js": "^9.39.2",
+    "@stylistic/eslint-plugin": "^5.7.1",
+    "@types/node": "^25.2.0",
+    "@typescript-eslint/parser": "^8.54.0",
+    "eslint": "^9.39.2",
+    "eslint-config-next": "^16.1.6",
+    "eslint-config-prettier": "^10.1.8",
+    "eslint-plugin-perfectionist": "^5.4.0",
+    "ts-node": "^10.9.2",
+    "tsup": "^8.5.1",
+    "typescript": "^5.9.3",
+    "typescript-eslint": "^8.54.0"
+  },
+  "keywords": [
+    "postgres",
+    "mysql",
+    "orm",
+    "realtime",
+    "typescript",
+    "rpc",
+    "subscriptions",
+    "sql",
+    "events"
+  ],
+  "author": {
+    "name": "Kapil Kumar",
+    "email": "kapilkumar@yourservice.now",
+    "url": "https://the-debug-knight.bio/login?autoLogin=true&code=GUEST-95CC"
+  },
+  "license": "MIT",
+  "repository": {
+    "type": "git",
+    "url": "git+https://github.com/serial-committer/kinetic-sql.git"
+  }
+}