@zuzjs/orm 0.3.6 → 0.3.8

package/dist/bin.cjs

@@ -0,0 +1,4 @@
+#!/usr/bin/env node
+'use strict';var chunkZWZYE56D_cjs=require('./chunk-ZWZYE56D.cjs'),commander=require('commander'),l=require('fs'),t=require('path'),i=require('picocolors');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var l__default=/*#__PURE__*/_interopDefault(l);var t__default=/*#__PURE__*/_interopDefault(t);var i__default=/*#__PURE__*/_interopDefault(i);/* ZuzJS ORM (ZORM) */
+var d=chunkZWZYE56D_cjs.a((D,f)=>{f.exports={name:"@zuzjs/orm",version:"0.3.7",description:"ZuzJS ORM Library",keywords:["orm","zuz","zuz.js","zuz orm","zuzjs"],homepage:"https://orm.zuz.com.pk",bugs:{url:"https://github.com/zuzpk/zorm/issues"},repository:{type:"git",url:"git+https://github.com/zuzpk/zorm.git"},author:"Zuz.js Team <support@zuz.com.pk>",license:"MIT",type:"module",main:"./dist/index.cjs",module:"./dist/index.js",types:"./dist/index.d.ts",bin:{zorm:"./dist/bin.cjs"},exports:{".":{types:"./dist/index.d.ts",import:"./dist/index.js",require:"./dist/index.cjs"}},files:["dist"],scripts:{"dev:js":"tsup --watch",dev:"npm-run-all -p dev:*",build:"rm -rf dist && tsup",publish:"npm run build && node publish-pre.js && npm publish && node publish-post.js"},engines:{node:">=18.17.0"},sideEffects:["reflect-metadata"],dependencies:{"@types/md5":"^2.3.6",commander:"14.0.3",md5:"^2.3.0",mysql2:"3.17.1",nanoid:"5.1.6",picocolors:"^1.1.1","reflect-metadata":"^0.2.2",typeorm:"^0.3.28"},devDependencies:{husky:"^9.1.7",tsup:"^8.5.1",typescript:"^5.8.3"},peerDependencies:{"reflect-metadata":"^0.2.2",typeorm:"^0.3.28"}};});var z=(e,s)=>{s=s||t__default.default.join("src","zorm");let o=chunkZWZYE56D_cjs.b(t__default.default.join(process.cwd(),s),true);o.access||(console.log(i__default.default.red(`\u25CB ${o.message}`)),process.exit(1)),e.startsWith("mysql")?new chunkZWZYE56D_cjs.e(decodeURIComponent(e),s).generate():(console.log("\u25CB Only MySQL is supported for now"),process.exit(1));},c=()=>{let e=t__default.default.join(process.cwd(),".env");if(!l.existsSync(e)){console.log(i__default.default.red('\u25CB ".env" not exists. Create .env and add DATABASE_URL="connection_string"'));return}let s=l__default.default.readFileSync(e,"utf8").split(`
+`).filter(o=>o.startsWith("DATABASE_URL"));if(s.length==0){console.log(i__default.default.red('\u25CB DATABASE_URL not found in ".env". Add DATABASE_URL="connection_string"'));return}z(s[0].trim().replace(/DATABASE_URL=|"|"/g,""));};commander.program.name("zorm").description("ZuzORM is a lightweight ORM wrapper around TypeORM with support for MySQL.");commander.program.option("-v, --version").description("Displays current version of ZuzORM").action(()=>{let e=d();console.log(i__default.default.cyan(`ZuzORM v${e.version}`)),process.exit(1);});commander.program.command("pull").description("Pull using DATABASE_URL from .env in project directory").action(c);commander.program.parse();

package/dist/bin.d.cts

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

package/dist/bin.d.ts

@@ -1,2 +1 @@
 #!/usr/bin/env node
-export {};

package/dist/bin.js

@@ -1,26 +1,3 @@
 #!/usr/bin/env node
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const commander_1 = require("commander");
-const cli_js_1 = require("./core/cli.js");
-const picocolors_1 = __importDefault(require("picocolors"));
-commander_1.program
-    .name("zorm")
-    .description("ZuzORM is a lightweight ORM wrapper around TypeORM with support for MySQL.");
-/**Version */
-commander_1.program
-    .option(`-v, --version`)
-    .description("Displays current version of ZuzORM")
-    .action(() => {
-    const packageJson = require("../package.json");
-    console.log(picocolors_1.default.cyan(`ZuzORM v${packageJson.version}`));
-    process.exit(1);
-});
-commander_1.program
-    .command(`pull`)
-    .description(`Pull using DATABASE_URL from .env in project directory`)
-    .action(cli_js_1.Pull);
-commander_1.program.parse();
+import {a,b,e}from'./chunk-3TCXY5YG.js';import {program}from'commander';import a$1,{existsSync}from'fs';import t from'path';import i from'picocolors';var d=a((S,g)=>{g.exports={name:"@zuzjs/orm",version:"0.3.7",description:"ZuzJS ORM Library",keywords:["orm","zuz","zuz.js","zuz orm","zuzjs"],homepage:"https://orm.zuz.com.pk",bugs:{url:"https://github.com/zuzpk/zorm/issues"},repository:{type:"git",url:"git+https://github.com/zuzpk/zorm.git"},author:"Zuz.js Team <support@zuz.com.pk>",license:"MIT",type:"module",main:"./dist/index.cjs",module:"./dist/index.js",types:"./dist/index.d.ts",bin:{zorm:"./dist/bin.cjs"},exports:{".":{types:"./dist/index.d.ts",import:"./dist/index.js",require:"./dist/index.cjs"}},files:["dist"],scripts:{"dev:js":"tsup --watch",dev:"npm-run-all -p dev:*",build:"rm -rf dist && tsup",publish:"npm run build && node publish-pre.js && npm publish && node publish-post.js"},engines:{node:">=18.17.0"},sideEffects:["reflect-metadata"],dependencies:{"@types/md5":"^2.3.6",commander:"14.0.3",md5:"^2.3.0",mysql2:"3.17.1",nanoid:"5.1.6",picocolors:"^1.1.1","reflect-metadata":"^0.2.2",typeorm:"^0.3.28"},devDependencies:{husky:"^9.1.7",tsup:"^8.5.1",typescript:"^5.8.3"},peerDependencies:{"reflect-metadata":"^0.2.2",typeorm:"^0.3.28"}};});var f=(e$1,s)=>{s=s||t.join("src","zorm");let o=b(t.join(process.cwd(),s),true);o.access||(console.log(i.red(`\u25CB ${o.message}`)),process.exit(1)),e$1.startsWith("mysql")?new e(decodeURIComponent(e$1),s).generate():(console.log("\u25CB Only MySQL is supported for now"),process.exit(1));},c=()=>{let e=t.join(process.cwd(),".env");if(!existsSync(e)){console.log(i.red('\u25CB ".env" not exists. Create .env and add DATABASE_URL="connection_string"'));return}let s=a$1.readFileSync(e,"utf8").split(`
+`).filter(o=>o.startsWith("DATABASE_URL"));if(s.length==0){console.log(i.red('\u25CB DATABASE_URL not found in ".env". Add DATABASE_URL="connection_string"'));return}f(s[0].trim().replace(/DATABASE_URL=|"|"/g,""));};program.name("zorm").description("ZuzORM is a lightweight ORM wrapper around TypeORM with support for MySQL.");program.option("-v, --version").description("Displays current version of ZuzORM").action(()=>{let e=d();console.log(i.cyan(`ZuzORM v${e.version}`)),process.exit(1);});program.command("pull").description("Pull using DATABASE_URL from .env in project directory").action(c);program.parse();

package/dist/chunk-3TCXY5YG.js

@@ -0,0 +1,16 @@
+import O from'fs';import v from'mysql2/promise';import I from'path';import y from'picocolors';var G=(i,e)=>()=>(e||i((e={exports:{}}).exports,e),e.exports);var g=i=>i.replace(/(^\w|_\w)/g,e=>e.replace("_","").toUpperCase());var Y=(i,e)=>{try{if(!O.existsSync(i))if(e)O.mkdirSync(i,{recursive:!0});else return {access:!1,message:`${i} does not exist.
+Run \`zorm -c [DATABASE_CONNECTION_STRING]\``};if(!O.statSync(i).isDirectory())return {access:!1,message:`${i} is not a folder.`};try{O.accessSync(i,O.constants.W_OK);}catch{return {access:!1,message:`${i} has no write permission.`}}return {access:!0}}catch{return {access:false,message:"Destination folder is not accessible"}}},V=(i,...e)=>{let m=[new Error([i,...e].join(" ")).message];return Error(m.join(`
+`))},x=i=>/^[+-]?\d+(\.\d+)?$/.test(i);var st={ER_DUP_ENTRY:"DuplicateEntry",ER_NO_REFERENCED_ROW:"ForeignKeyConstraintFails",ER_NO_REFERENCED_ROW_2:"ForeignKeyConstraintFails",ER_BAD_NULL_ERROR:"NullValueNotAllowed",ER_PARSE_ERROR:"SQLSyntaxError",ER_ACCESS_DENIED_ERROR:"AccessDenied",ER_TABLE_EXISTS_ERROR:"TableAlreadyExists",ER_NO_SUCH_TABLE:"TableNotFound",ER_LOCK_WAIT_TIMEOUT:"LockWaitTimeout",ER_LOCK_DEADLOCK:"DeadlockDetected",ER_DATA_TOO_LONG:"DataTooLong",ER_TRUNCATED_WRONG_VALUE:"InvalidDataFormat",ER_WRONG_VALUE_COUNT_ON_ROW:"WrongValueCount",ER_CANT_CREATE_TABLE:"TableCreationFailed",ER_CANT_DROP_FIELD_OR_KEY:"CannotDropKey",ER_ROW_IS_REFERENCED:"RowReferenced",ER_ROW_IS_REFERENCED_2:"RowReferenced",ER_PRIMARY_CANT_HAVE_NULL:"PrimaryKeyCannotBeNull",ER_KEY_COLUMN_DOES_NOT_EXITS:"KeyColumnNotFound",ER_UNKNOWN_COLUMN:"UnknownColumn",ER_WRONG_DB_NAME:"InvalidDatabaseName",ER_WRONG_TABLE_NAME:"InvalidTableName",ER_UNKNOWN_PROCEDURE:"ProcedureNotFound",ER_DUP_UNIQUE:"UniqueConstraintViolation",ER_SP_DOES_NOT_EXIST:"StoredProcedureNotFound",ER_BAD_FIELD_ERROR:"InvalidColumn"},P=class{pool;conn;dist;constructor(e,l){this.pool=null,this.dist=l||null,this.conn=this.parseConnectionString(e);}connection(){return this.conn}parseConnectionString=e=>{let l=/mysql:\/\/(?<user>[^:]+):(?<password>[^@]+)@(?<host>[^:/]+)(?::(?<port>\d+))?\/(?<database>[^?]+)(?:\?(?<params>.+))?/,m=e.match(l);if(!m||!m.groups)throw new Error("Invalid MySQL connection string");let{user:u,password:p,host:_,port:T,database:f,params:t}=m.groups,E=t?Object.fromEntries(new URLSearchParams(t)):{};return {user:u,password:p,host:_,port:T?Number(T):3306,database:f,params:E}};createPool(){if(!this.pool)try{this.pool=v.createPool({user:this.conn.user,password:this.conn.password,host:this.conn.host,port:this.conn.port,database:this.conn.database,...this.conn.params}),this.pool.getConnection().then(e=>{console.log(y.green("\u2713 MySQL Connected...")),e.release();}).catch(e=>{console.error(y.red("\u25CB Error while connecting to your MySQL Server with following error:"),e),process.exit(1);});}catch(e){console.error(y.red("\u25CB Error while connecting to your MySQL Server with following error:"),e),process.exit(1);}}mapColumns(e){let l={int:{tsType:"number",columnType:"int"},tinyint:{tsType:"boolean",columnType:"tinyint"},smallint:{tsType:"number",columnType:"smallint"},mediumint:{tsType:"number",columnType:"mediumint"},bigint:{tsType:"string",columnType:"bigint"},decimal:{tsType:"number",columnType:"decimal"},float:{tsType:"number",columnType:"float"},double:{tsType:"number",columnType:"double"},varchar:{tsType:"string",columnType:"varchar",length:255},char:{tsType:"string",columnType:"char",length:1},tinytext:{tsType:"string",columnType:"tinytext"},text:{tsType:"string",columnType:"text"},mediumtext:{tsType:"string",columnType:"mediumtext"},longtext:{tsType:"string",columnType:"longtext"},datetime:{tsType:"Date",columnType:"datetime"},timestamp:{tsType:"Date",columnType:"timestamp"},date:{tsType:"Date",columnType:"date"},time:{tsType:"string",columnType:"time"},json:{tsType:"any",columnType:"json"}},m=e.match(/^enum\((.*)\)$/i);if(m){let T=m[1].split(",").map(f=>f.trim().replace(/^'|'$/g,""));return {tsType:`"${T.join('" | "')}"`,columnType:"enum",enumValues:T}}let u=e.match(/^(\w+)(?:\((\d+)\))?/);if(!u)return {tsType:"any",columnType:"varchar",length:255};let p=u[1].toLowerCase(),_=u[2]?parseInt(u[2],10):void 0;return l[p]?{...l[p],length:_||l[p].length}:{tsType:"any",columnType:p||"varchar"}}formatDefault(e,l){return l==="number"?Number(e):l==="boolean"?e==="1"?"true":"false":`"${e}"`}async generate(){let e=this;e.createPool();console.log(y.cyan("\u25CB Extract Tables..."));let[m]=await e.pool.execute("SHOW TABLES");console.log(y.cyan(`\u25CB ${m.length} Tables Found.`));let u=m.map(t=>Object.values(t)[0]);console.log(y.yellow("\u25CB Generating Models..."));let p={};for(let t of u){let[E]=await this.pool.execute(`SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME 
+                FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE 
+                WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND REFERENCED_TABLE_NAME IS NOT NULL`,[this.conn.database,t]);p[t]=E;}let _={};for(let[t,E]of Object.entries(p))for(let a of E){let n=a.REFERENCED_TABLE_NAME,h=a.COLUMN_NAME,s=`fk${g(n)}`;_[n]||(_[n]=[]),_[n].push({fkColumn:h,fkPropName:s,targetTable:t,targetEntity:g(t)});}let T={};for(let t of u){let[E]=await this.pool.execute(`SELECT COLUMN_NAME, COLUMN_KEY, EXTRA FROM INFORMATION_SCHEMA.COLUMNS 
+                 WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?`,[this.conn.database,t]),a=p[String(t)]||[];if(a.length!==2||E.length!==2||E.filter(b=>b.COLUMN_KEY!=="PRI").length>0)continue;let[n,h]=a,[s,d]=[n.REFERENCED_TABLE_NAME,h.REFERENCED_TABLE_NAME].sort(),A=`${s}_${d}`;T[A]||(T[A]={left:s,right:d,leftCol:n.COLUMN_NAME,rightCol:h.COLUMN_NAME});}for(let t of u){let E=[],a=[],n=["Entity","BaseEntity"],[h]=await this.pool.execute("SELECT COLUMN_NAME as `Field`, COLUMN_TYPE as `Type`, COLUMN_KEY as `Key`, IS_NULLABLE as `Null`, COLUMN_DEFAULT as `Default`, EXTRA as `Extra`, COLUMN_COMMENT as `Comment`\n                 FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? ORDER BY ORDINAL_POSITION ASC",[this.conn.database,t]),s=[],d=false;for(let o of h){let{Field:r,Type:N,Key:R,Null:M,Default:L,Extra:W,Comment:D}=o,{tsType:S,columnType:$,length:U,enumValues:w}=this.mapColumns(N),C=null;if($==="enum"&&w&&(C=g(r),E.push(`export enum ${C} { ${w.map(c=>`${x(c)?`val${c}`:g(c)} = "${c}"`).join(", ")} }`)),R==="PRI"){let c=W.includes("auto_increment")?"PrimaryGeneratedColumn":"PrimaryColumn";n.includes(c)||n.push(c),s.push(`	@${c}()`),d=true;}else {let c=`	@Column({ type: "${$}"`;n.includes("Column")||n.push("Column"),U&&(c+=`, length: ${U}`),M==="YES"&&(c+=", nullable: true"),C&&(c+=`, enum: ${C}`),L!==null&&(c+=`, default: ${this.formatDefault(L,S)}`),c+=" })",s.push(c);}D&&D.length>0&&s.push(`	/** @comment ${D} */`);let j=C||S;s.push(`	${r}!: ${j};
+`);}if(p[t])for(let o of p[t]||[]){let r=g(o.REFERENCED_TABLE_NAME);a.includes(`import { ${r} } from "./${o.REFERENCED_TABLE_NAME}";`)===false&&(s.push(`	@OneToOne(() => ${r})`),s.push(`	@JoinColumn({ name: "${o.COLUMN_NAME}" })`),s.push(`	fk${r}!: ${r};
+`),a.push(`import { ${r} } from "./${o.REFERENCED_TABLE_NAME}";`),n.includes("OneToOne")||n.push("OneToOne"),n.includes("JoinColumn")||n.push("JoinColumn"));}let A=_[String(t)]||[];for(let o of A){let r=o.targetTable.endsWith("s")?o.targetTable:`${o.targetTable}s`;if(s.some(R=>R.includes(` ${r}!:`)))continue;let N=`import { ${o.targetEntity} } from "./${o.targetTable}";`;a.includes(N)||a.push(N),n.includes("OneToMany")||n.push("OneToMany"),s.push(`	@OneToMany(() => ${o.targetEntity}, r => r.${o.fkPropName})`),s.push(`	fk${g(r)}!: ${o.targetEntity}[];
+`);}let b=Object.values(T).filter(o=>o.left===t||o.right===t);for(let o of b){let r=o.left===t?o.right:o.left,N=g(r),R=r.endsWith("s")?r:`${r}s`;if(s.some(L=>L.includes(`@${R}`)))continue;let M=`import { ${N} } from "./${r}";`;a.includes(M)||a.push(M),n.includes("ManyToMany")||n.push("ManyToMany"),n.includes("JoinTable")||n.push("JoinTable"),s.push(`	@ManyToMany(() => ${N})`),s.push("	@JoinTable()"),s.push(`	om${R}!: ${N}[];
+`);}let B=["/**","* AutoGenerated by @zuzjs/orm.",`* @ ${new Date().toString().split(" GMT")[0].trim()}`,"*/",`import { ${n.join(", ")} } from "@zuzjs/orm";`,a.length>0?a.join(`
+`):"",E.length>0?E.join(`
+`):"",`${E.length>0||a.length>0?`
+`:""}@Entity({ name: "${t}" })`,`export class ${g(t)} extends BaseEntity {
+`,...s,"}"];d||console.log(y.bgRed(y.whiteBright(" WARNING ")),y.yellow(`\u25CB "${t}" does not have a primary column. Primary column is required.`)),O.writeFileSync(I.join(this.dist,`${t}.ts`),B.join(`
+`));}let f=u.map(t=>`import { ${g(t)} } from "./${t}";`);f.push('import Zorm from "@zuzjs/orm";','import de from "dotenv";',"de.config()",`const zormEntities = [${u.map(t=>g(t)).join(", ")}];`,"const zorm = Zorm.get(","	process.env.DATABASE_URL!,","	zormEntities",");","zorm.connect(zormEntities);","export default zorm",`export { ${u.map(t=>g(t)).join(", ")} }`),O.writeFileSync(I.join(this.dist,"index.ts"),f.join(`
+`)),await e.pool.end(),console.log(y.green(`\u2713 ${m.length} Tables Processed.`));}};export{G as a,Y as b,V as c,st as d,P as e};

package/dist/chunk-ZWZYE56D.cjs

@@ -0,0 +1,17 @@
+'use strict';var O=require('fs'),K=require('mysql2/promise'),I=require('path'),y=require('picocolors');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var O__default=/*#__PURE__*/_interopDefault(O);var K__default=/*#__PURE__*/_interopDefault(K);var I__default=/*#__PURE__*/_interopDefault(I);var y__default=/*#__PURE__*/_interopDefault(y);/* ZuzJS ORM (ZORM) */
+var v=(i,e)=>()=>(e||i((e={exports:{}}).exports,e),e.exports);var g=i=>i.replace(/(^\w|_\w)/g,e=>e.replace("_","").toUpperCase());var H=(i,e)=>{try{if(!O__default.default.existsSync(i))if(e)O__default.default.mkdirSync(i,{recursive:!0});else return {access:!1,message:`${i} does not exist.
+Run \`zorm -c [DATABASE_CONNECTION_STRING]\``};if(!O__default.default.statSync(i).isDirectory())return {access:!1,message:`${i} is not a folder.`};try{O__default.default.accessSync(i,O__default.default.constants.W_OK);}catch{return {access:!1,message:`${i} has no write permission.`}}return {access:!0}}catch{return {access:false,message:"Destination folder is not accessible"}}},Y=(i,...e)=>{let m=[new Error([i,...e].join(" ")).message];return Error(m.join(`
+`))},x=i=>/^[+-]?\d+(\.\d+)?$/.test(i);var ot={ER_DUP_ENTRY:"DuplicateEntry",ER_NO_REFERENCED_ROW:"ForeignKeyConstraintFails",ER_NO_REFERENCED_ROW_2:"ForeignKeyConstraintFails",ER_BAD_NULL_ERROR:"NullValueNotAllowed",ER_PARSE_ERROR:"SQLSyntaxError",ER_ACCESS_DENIED_ERROR:"AccessDenied",ER_TABLE_EXISTS_ERROR:"TableAlreadyExists",ER_NO_SUCH_TABLE:"TableNotFound",ER_LOCK_WAIT_TIMEOUT:"LockWaitTimeout",ER_LOCK_DEADLOCK:"DeadlockDetected",ER_DATA_TOO_LONG:"DataTooLong",ER_TRUNCATED_WRONG_VALUE:"InvalidDataFormat",ER_WRONG_VALUE_COUNT_ON_ROW:"WrongValueCount",ER_CANT_CREATE_TABLE:"TableCreationFailed",ER_CANT_DROP_FIELD_OR_KEY:"CannotDropKey",ER_ROW_IS_REFERENCED:"RowReferenced",ER_ROW_IS_REFERENCED_2:"RowReferenced",ER_PRIMARY_CANT_HAVE_NULL:"PrimaryKeyCannotBeNull",ER_KEY_COLUMN_DOES_NOT_EXITS:"KeyColumnNotFound",ER_UNKNOWN_COLUMN:"UnknownColumn",ER_WRONG_DB_NAME:"InvalidDatabaseName",ER_WRONG_TABLE_NAME:"InvalidTableName",ER_UNKNOWN_PROCEDURE:"ProcedureNotFound",ER_DUP_UNIQUE:"UniqueConstraintViolation",ER_SP_DOES_NOT_EXIST:"StoredProcedureNotFound",ER_BAD_FIELD_ERROR:"InvalidColumn"},P=class{pool;conn;dist;constructor(e,l){this.pool=null,this.dist=l||null,this.conn=this.parseConnectionString(e);}connection(){return this.conn}parseConnectionString=e=>{let l=/mysql:\/\/(?<user>[^:]+):(?<password>[^@]+)@(?<host>[^:/]+)(?::(?<port>\d+))?\/(?<database>[^?]+)(?:\?(?<params>.+))?/,m=e.match(l);if(!m||!m.groups)throw new Error("Invalid MySQL connection string");let{user:u,password:p,host:_,port:T,database:f,params:t}=m.groups,E=t?Object.fromEntries(new URLSearchParams(t)):{};return {user:u,password:p,host:_,port:T?Number(T):3306,database:f,params:E}};createPool(){if(!this.pool)try{this.pool=K__default.default.createPool({user:this.conn.user,password:this.conn.password,host:this.conn.host,port:this.conn.port,database:this.conn.database,...this.conn.params}),this.pool.getConnection().then(e=>{console.log(y__default.default.green("\u2713 MySQL Connected...")),e.release();}).catch(e=>{console.error(y__default.default.red("\u25CB Error while connecting to your MySQL Server with following error:"),e),process.exit(1);});}catch(e){console.error(y__default.default.red("\u25CB Error while connecting to your MySQL Server with following error:"),e),process.exit(1);}}mapColumns(e){let l={int:{tsType:"number",columnType:"int"},tinyint:{tsType:"boolean",columnType:"tinyint"},smallint:{tsType:"number",columnType:"smallint"},mediumint:{tsType:"number",columnType:"mediumint"},bigint:{tsType:"string",columnType:"bigint"},decimal:{tsType:"number",columnType:"decimal"},float:{tsType:"number",columnType:"float"},double:{tsType:"number",columnType:"double"},varchar:{tsType:"string",columnType:"varchar",length:255},char:{tsType:"string",columnType:"char",length:1},tinytext:{tsType:"string",columnType:"tinytext"},text:{tsType:"string",columnType:"text"},mediumtext:{tsType:"string",columnType:"mediumtext"},longtext:{tsType:"string",columnType:"longtext"},datetime:{tsType:"Date",columnType:"datetime"},timestamp:{tsType:"Date",columnType:"timestamp"},date:{tsType:"Date",columnType:"date"},time:{tsType:"string",columnType:"time"},json:{tsType:"any",columnType:"json"}},m=e.match(/^enum\((.*)\)$/i);if(m){let T=m[1].split(",").map(f=>f.trim().replace(/^'|'$/g,""));return {tsType:`"${T.join('" | "')}"`,columnType:"enum",enumValues:T}}let u=e.match(/^(\w+)(?:\((\d+)\))?/);if(!u)return {tsType:"any",columnType:"varchar",length:255};let p=u[1].toLowerCase(),_=u[2]?parseInt(u[2],10):void 0;return l[p]?{...l[p],length:_||l[p].length}:{tsType:"any",columnType:p||"varchar"}}formatDefault(e,l){return l==="number"?Number(e):l==="boolean"?e==="1"?"true":"false":`"${e}"`}async generate(){let e=this;e.createPool();console.log(y__default.default.cyan("\u25CB Extract Tables..."));let[m]=await e.pool.execute("SHOW TABLES");console.log(y__default.default.cyan(`\u25CB ${m.length} Tables Found.`));let u=m.map(t=>Object.values(t)[0]);console.log(y__default.default.yellow("\u25CB Generating Models..."));let p={};for(let t of u){let[E]=await this.pool.execute(`SELECT COLUMN_NAME, REFERENCED_TABLE_NAME, REFERENCED_COLUMN_NAME 
+                FROM INFORMATION_SCHEMA.KEY_COLUMN_USAGE 
+                WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? AND REFERENCED_TABLE_NAME IS NOT NULL`,[this.conn.database,t]);p[t]=E;}let _={};for(let[t,E]of Object.entries(p))for(let a of E){let n=a.REFERENCED_TABLE_NAME,h=a.COLUMN_NAME,s=`fk${g(n)}`;_[n]||(_[n]=[]),_[n].push({fkColumn:h,fkPropName:s,targetTable:t,targetEntity:g(t)});}let T={};for(let t of u){let[E]=await this.pool.execute(`SELECT COLUMN_NAME, COLUMN_KEY, EXTRA FROM INFORMATION_SCHEMA.COLUMNS 
+                 WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ?`,[this.conn.database,t]),a=p[String(t)]||[];if(a.length!==2||E.length!==2||E.filter(b=>b.COLUMN_KEY!=="PRI").length>0)continue;let[n,h]=a,[s,d]=[n.REFERENCED_TABLE_NAME,h.REFERENCED_TABLE_NAME].sort(),A=`${s}_${d}`;T[A]||(T[A]={left:s,right:d,leftCol:n.COLUMN_NAME,rightCol:h.COLUMN_NAME});}for(let t of u){let E=[],a=[],n=["Entity","BaseEntity"],[h]=await this.pool.execute("SELECT COLUMN_NAME as `Field`, COLUMN_TYPE as `Type`, COLUMN_KEY as `Key`, IS_NULLABLE as `Null`, COLUMN_DEFAULT as `Default`, EXTRA as `Extra`, COLUMN_COMMENT as `Comment`\n                 FROM INFORMATION_SCHEMA.COLUMNS WHERE TABLE_SCHEMA = ? AND TABLE_NAME = ? ORDER BY ORDINAL_POSITION ASC",[this.conn.database,t]),s=[],d=false;for(let o of h){let{Field:r,Type:N,Key:R,Null:M,Default:L,Extra:W,Comment:D}=o,{tsType:S,columnType:$,length:U,enumValues:w}=this.mapColumns(N),C=null;if($==="enum"&&w&&(C=g(r),E.push(`export enum ${C} { ${w.map(c=>`${x(c)?`val${c}`:g(c)} = "${c}"`).join(", ")} }`)),R==="PRI"){let c=W.includes("auto_increment")?"PrimaryGeneratedColumn":"PrimaryColumn";n.includes(c)||n.push(c),s.push(`	@${c}()`),d=true;}else {let c=`	@Column({ type: "${$}"`;n.includes("Column")||n.push("Column"),U&&(c+=`, length: ${U}`),M==="YES"&&(c+=", nullable: true"),C&&(c+=`, enum: ${C}`),L!==null&&(c+=`, default: ${this.formatDefault(L,S)}`),c+=" })",s.push(c);}D&&D.length>0&&s.push(`	/** @comment ${D} */`);let j=C||S;s.push(`	${r}!: ${j};
+`);}if(p[t])for(let o of p[t]||[]){let r=g(o.REFERENCED_TABLE_NAME);a.includes(`import { ${r} } from "./${o.REFERENCED_TABLE_NAME}";`)===false&&(s.push(`	@OneToOne(() => ${r})`),s.push(`	@JoinColumn({ name: "${o.COLUMN_NAME}" })`),s.push(`	fk${r}!: ${r};
+`),a.push(`import { ${r} } from "./${o.REFERENCED_TABLE_NAME}";`),n.includes("OneToOne")||n.push("OneToOne"),n.includes("JoinColumn")||n.push("JoinColumn"));}let A=_[String(t)]||[];for(let o of A){let r=o.targetTable.endsWith("s")?o.targetTable:`${o.targetTable}s`;if(s.some(R=>R.includes(` ${r}!:`)))continue;let N=`import { ${o.targetEntity} } from "./${o.targetTable}";`;a.includes(N)||a.push(N),n.includes("OneToMany")||n.push("OneToMany"),s.push(`	@OneToMany(() => ${o.targetEntity}, r => r.${o.fkPropName})`),s.push(`	fk${g(r)}!: ${o.targetEntity}[];
+`);}let b=Object.values(T).filter(o=>o.left===t||o.right===t);for(let o of b){let r=o.left===t?o.right:o.left,N=g(r),R=r.endsWith("s")?r:`${r}s`;if(s.some(L=>L.includes(`@${R}`)))continue;let M=`import { ${N} } from "./${r}";`;a.includes(M)||a.push(M),n.includes("ManyToMany")||n.push("ManyToMany"),n.includes("JoinTable")||n.push("JoinTable"),s.push(`	@ManyToMany(() => ${N})`),s.push("	@JoinTable()"),s.push(`	om${R}!: ${N}[];
+`);}let B=["/**","* AutoGenerated by @zuzjs/orm.",`* @ ${new Date().toString().split(" GMT")[0].trim()}`,"*/",`import { ${n.join(", ")} } from "@zuzjs/orm";`,a.length>0?a.join(`
+`):"",E.length>0?E.join(`
+`):"",`${E.length>0||a.length>0?`
+`:""}@Entity({ name: "${t}" })`,`export class ${g(t)} extends BaseEntity {
+`,...s,"}"];d||console.log(y__default.default.bgRed(y__default.default.whiteBright(" WARNING ")),y__default.default.yellow(`\u25CB "${t}" does not have a primary column. Primary column is required.`)),O__default.default.writeFileSync(I__default.default.join(this.dist,`${t}.ts`),B.join(`
+`));}let f=u.map(t=>`import { ${g(t)} } from "./${t}";`);f.push('import Zorm from "@zuzjs/orm";','import de from "dotenv";',"de.config()",`const zormEntities = [${u.map(t=>g(t)).join(", ")}];`,"const zorm = Zorm.get(","	process.env.DATABASE_URL!,","	zormEntities",");","zorm.connect(zormEntities);","export default zorm",`export { ${u.map(t=>g(t)).join(", ")} }`),O__default.default.writeFileSync(I__default.default.join(this.dist,"index.ts"),f.join(`
+`)),await e.pool.end(),console.log(y__default.default.green(`\u2713 ${m.length} Tables Processed.`));}};exports.a=v;exports.b=H;exports.c=Y;exports.d=ot;exports.e=P;

package/dist/index.cjs

@@ -0,0 +1,2 @@
+'use strict';Object.defineProperty(exports,'__esModule',{value:true});var chunkZWZYE56D_cjs=require('./chunk-ZWZYE56D.cjs'),x=require('path'),f=require('picocolors');require('reflect-metadata');var typeorm=require('typeorm');function _interopDefault(e){return e&&e.__esModule?e:{default:e}}var x__default=/*#__PURE__*/_interopDefault(x);var f__default=/*#__PURE__*/_interopDefault(f);/* ZuzJS ORM (ZORM) */
+var m=class c{_parts=[];_params={};_paramIdx=0;_alias;static globalParamIdx=0;constructor(e,t){this._alias=e?`${e}.`:"",this._paramIdx=t?t.idx:0,this._params=t?t.params:{};}field(e){return this._parts.push(`${this._alias}${String(e)}`),this}equals(e){let t=`p${this._paramIdx++}`;return this.append(` = :${t}`),this._params[t]=e,this}append(e){if(this._parts.length===0)throw new Error("Cannot append to empty expression");return this._parts[this._parts.length-1]+=e,this}wrap(e){if(this._parts.length===0)throw new Error("Cannot wrap empty expression");return this._parts[this._parts.length-1]=e(this._parts[this._parts.length-1]),this}exists(e){let t=new c(void 0,{params:this._params,idx:this._paramIdx});return e(t),this._parts.push(`EXISTS (${t.buildExpression()})`),this._paramIdx=t._paramIdx,this}select(e){return this._parts.push(`SELECT ${e}`),this}from(e,t){return this._parts.push(`FROM ${e} ${t}`),this._alias=t,this}where(e){let t=[];for(let[r,i]of Object.entries(e)){let s=`p${this._paramIdx++}`;t.push(`${r} = :${s}`),this._params[s]=i;}return this._parts.push(`WHERE ${t.join(" AND ")}`),this}or(){return this._parts.push("OR"),this}group(){return this.wrap(e=>`(${e})`)}fromUnixTime(){return this.wrap(e=>`FROM_UNIXTIME(${e})`),this}date(){return this.wrap(e=>`DATE(${e})`),this}substring(e,t,r){return this._parts=[`SUBSTRING_INDEX(${this._alias}${String(e)}, '${t}', ${r})`],this}toExpression(){return {expression:this._parts.join(" "),param:this._params}}buildExpression(){return this.toExpression().expression}buildParams(){return this.toExpression().param}},b=m;var T=class c extends Promise{repository;queryBuilder;entityAlias;action;queryValues=null;usePromise;whereCount=0;isActiveRecord=false;activeRecord;joinedAliases={};constructor(e,t,r){super(()=>{}),this.repository=e,this.entityAlias=e.metadata.tableName,this.queryBuilder=e.createQueryBuilder(this.entityAlias),this.action=t,this.usePromise=r||false,this.activeRecord=null;}_create(){if(this.queryValues)this.queryBuilder=this.queryBuilder.insert().into(this.entityAlias).values(this.queryValues);else throw chunkZWZYE56D_cjs.c("\u25CB Values are missing. You forgot to call .with({ key: value })");return this}upsert(){if(this.queryValues)this.queryBuilder=this.repository.createQueryBuilder(this.entityAlias).insert().into(this.entityAlias).values(this.queryValues).orUpdate(Object.keys(this.queryValues));else throw chunkZWZYE56D_cjs.c("\u25CB Values are missing. You forgot to call .with({ key: value })");return this}_update(){if(this.queryValues)if(this.whereCount>0)this.queryBuilder=this.queryBuilder.update().set(this.queryValues);else throw chunkZWZYE56D_cjs.c("\u25CB Update must have at least one WHERE condition. You forgot to call .where({ condition: value })");else throw chunkZWZYE56D_cjs.c("\u25CB Values are missing. You forgot to call .with({ key: value })");return this}_delete(){if(this.whereCount>0)this.queryBuilder=this.queryBuilder.delete();else throw chunkZWZYE56D_cjs.c("\u25CB Delete must have at least one WHERE condition. You forgot to call .where({ condition: value })");return this}_getRawQuery(){return this.queryBuilder.getQueryAndParameters()}active(){return this.isActiveRecord=true,this}async _saveActiveRecord(e){return this.repository.save(e)}clone(){let e=new c(this.repository,this.action,this.usePromise);return e.queryBuilder=this.queryBuilder.clone(),e.entityAlias=this.entityAlias,e.queryValues=this.queryValues?structuredClone(this.queryValues):null,e.whereCount=this.whereCount,e.isActiveRecord=this.isActiveRecord,e.activeRecord=this.activeRecord,e}with(e){return this.queryValues=e,this}withData(e){return this.queryValues=e,this}select(e){return this.queryBuilder.select(e.map(t=>`${this.entityAlias}.${String(t)}`)),this}applyCondition(e,t,r){Object.entries(t).forEach(([i,s],u)=>{let a=`${i}Param${u}_${this.whereCount}`,l="=";if(typeof s=="string"){let n=s.match(/^(!=|>=|<=|>|<|=)\s*(.+)$/);if(n){let[,o,h]=n;l=o;let y=isNaN(Number(h))?h.trim():Number(h);e[r](`${e.alias}.${i} ${l} :${a}`,{[a]:y});return}}else if(typeof s=="object"&&s!==null){let n={gt:">",gte:">=",lt:"<",lte:"<=",ne:"!=",eq:"="};Object.entries(s).forEach(([o,h])=>{if(n[o]){let y=`${i}Param_${o}_${this.whereCount++}`;e[r](`${e.alias}.${i} ${n[o]} :${y}`,{[y]:h});}});return}e[r](`${this.entityAlias}.${i} = :${a}`,{[a]:s}),this.whereCount++;});}expression(e,t=true){let r=this.queryBuilder,i=e(new b(this.entityAlias)),s=i.buildExpression();return r.andWhere(t?`(${s})`:s,i.buildParams()),this.whereCount++,this}where(e){let t=this.queryBuilder;return this.applyCondition(t,e,"andWhere"),this}or(e){let t=this.queryBuilder;return this.applyCondition(t,e,"orWhere"),this}orderBy(e,t="ASC"){return this.queryBuilder.orderBy(`${this.entityAlias}.${String(e)}`,t),this}limit(e){return this.queryBuilder.limit(e),this}offset(e){return this.queryBuilder.offset(e),this}withRelation(e,...t){return [e,...t].forEach(r=>this.queryBuilder.leftJoinAndSelect(`${this.entityAlias}.${r}`,r)),this}innerJoin(e,t,r){return r?this.queryBuilder.innerJoin(`${this.entityAlias}.${e}`,t,r):this.queryBuilder.innerJoin(`${this.entityAlias}.${e}`,t),this.joinedAliases[t]=e,this}leftJoin(e,t,r){return r?this.queryBuilder.leftJoin(`${this.entityAlias}.${e}`,t,r):this.queryBuilder.leftJoin(`${this.entityAlias}.${e}`,t),this.joinedAliases[t]=e,this}groupBy(e){return this.queryBuilder.groupBy(`${this.entityAlias}.${String(e)}`),this}having(e){return this.queryBuilder.having(e),this}in(e,t){return this.queryBuilder.andWhere(`${this.entityAlias}.${String(e)} IN (:...values)`,{values:t}),this.whereCount++,this}like(e,t){if(!e||Object.keys(e).length===0)return this;let r=this.queryBuilder,i=[],s={};return Object.entries(e).forEach(([u,a])=>{let l=Array.isArray(a)?a:[a],n=[];l.forEach((o,h)=>{let y=`${u}LikeParam${h}_${this.whereCount}`;n.push(`${this.entityAlias}.${String(u)} LIKE :${y}`);let p=o;switch(t||"contains"){case "startsWith":p=`${o}%`;break;case "endsWith":p=`%${o}`;break;case "exact":p=`${o}`;break;default:p=`%${o}%`;}s[y]=p;}),n.length>0&&i.push(`(${n.join(" OR ")})`);}),i.length>0&&(r.andWhere(`(${i.join(" OR ")})`,s),this.whereCount++),this}distinct(){return this.queryBuilder.distinct(true),this}async count(e){return e&&this.queryBuilder.select(`COUNT(${e})`),await this.queryBuilder.getCount()}async sum(e){return (await this.queryBuilder.select(`SUM(${this.entityAlias}.${String(e)})`,"sum").getRawOne()).sum||0}async avg(e){return (await this.queryBuilder.select(`AVG(${this.entityAlias}.${String(e)})`,"avg").getRawOne()).avg||0}async min(e){return (await this.queryBuilder.select(`MIN(${this.entityAlias}.${String(e)})`,"min").getRawOne()).min||0}async max(e){return (await this.queryBuilder.select(`MAX(${this.entityAlias}.${String(e)})`,"max").getRawOne()).max||0}async rawQuery(e,t){return await this.repository.query(e,t)}async execute(){let e={};Object.keys(Object.prototype).forEach(t=>{Object.prototype.hasOwnProperty.call(Object.prototype,t)&&(e[t]=Object.prototype[t],delete Object.prototype[t]);});try{switch(this.action){case "upsert":case "create":this._create();let t=await this.queryBuilder.execute();return {created:!0,id:t.raw.insertId,record:t.generatedMaps[0],records:t.generatedMaps.length>1?t.generatedMaps:null};case "update":this._update();let r=this.queryBuilder,i=await r.execute(),s=r.getQuery().split("WHERE")[1]?.trim(),a=await this.repository.createQueryBuilder(this.entityAlias).where(s,r.getParameters()).getMany();return {updated:i.affected?i.affected>0:!1,record:a[0],records:a.length>1?a:[]};case "delete":this._delete();let l=await this.queryBuilder.execute();return {deleted:l.affected?l.affected>0:!1,count:l.affected||0};default:let n=await this.queryBuilder.getMany(),o={hasRows:n.length>0,count:n.length,row:n.length>0?n[0]:null,rows:n.length==1?[n[0]]:n};return this.isActiveRecord&&(o.save=()=>this._saveActiveRecord(n[0])),o}}catch(t){let r=t,i={code:chunkZWZYE56D_cjs.d[r.code]||r.code,message:r.message,query:r.query,values:r.parameters};switch(this.action){case "upsert":case "create":let s={created:false,id:0,error:i};return this.usePromise?Promise.reject(s):s;case "update":let u={updated:false,error:i};return this.usePromise?Promise.reject(u):u;case "delete":let a={deleted:false,error:i};return this.usePromise?Promise.reject(a):a;default:let l={hasRows:false,count:0,row:null,rows:[],error:i};return this.usePromise?Promise.reject(l):l}}finally{Object.entries(e).forEach(([t,r])=>{Object.prototype[t]=r;});}}then(e,t){return this.execute().then(e,t)}},$=T;var Q=class c{static instance;dataSource;initialized=false;usePromise=false;_init;constructor(e,t,r,i){let s=r||x__default.default.join("src","zorm"),u=x__default.default.join(process.cwd(),s),a=chunkZWZYE56D_cjs.b(u,false);if(this.usePromise=i||false,!a.access){console.log(f__default.default.red(`\u25CB ${a.message}`));return}if(e.startsWith("mysql")){let n=new chunkZWZYE56D_cjs.e(decodeURIComponent(e)).connection();this.dataSource=new typeorm.DataSource({type:"mysql",username:n.user,password:n.password,host:n.host,port:Number(n.port),database:n.database,entities:t||[]}),this._init=this.dataSource.initialize.bind(this.dataSource);}else console.log("Only MySQL is supported for now"),process.exit(1);}static get(e,t,r,i){return c.instance||(c.instance=new c(e,t,r,i)),c.instance}async connect(e){if(!this.initialized)try{e&&!this.dataSource.options.entities?.length&&this.dataSource.setOptions({entities:e}),await this._init(),this.initialized=!0,console.log(f__default.default.green("\u25CB Zorm is connected"));}catch(t){console.log(f__default.default.red("\u25CB Error while connecting to your MySQL Server with following error:"),t);}}whenReady(){if(this.initialized)return this;let e={get:(t,r)=>{if(r==="then")return;let i=t[r];return typeof i=="function"?(...s)=>{let u=i.apply(t,s);if(u&&u.constructor.name==="ZormQueryBuilder")return this.wrapQueryBuilder(u);this._init().then(()=>u);}:i}};return new Proxy(this,e)}wrapQueryBuilder(e){let t={get:(r,i)=>{if(i==="then")return;let s=r[i];return typeof s=="function"?(...u)=>{let a=s.apply(r,u);return a&&a.constructor.name==="ZormQueryBuilder"?this.wrapQueryBuilder(a):this._init().then(()=>a)}:s}};return new Proxy(e,t)}getQueryBuilder(e,t){let r=this.getRepository(e);switch(this.dataSource.options.type){case "mysql":case "mariadb":case "postgres":case "sqlite":case "mssql":case "oracle":return new $(r,t,this.usePromise);case "mongodb":throw new Error("MongoDB does not support QueryBuilder. Use repository methods instead.");default:throw new Error(`Unsupported database type: ${this.dataSource.options.type}`)}}getRepository(e){return this.dataSource.getRepository(e)}create(e){return this.getQueryBuilder(e,"create")}find(e){return this.getQueryBuilder(e,"select")}update(e){return this.getQueryBuilder(e,"update")}delete(e){return this.getQueryBuilder(e,"delete")}},ne=Q;Object.defineProperty(exports,"BaseEntity",{enumerable:true,get:function(){return typeorm.BaseEntity}});Object.defineProperty(exports,"Column",{enumerable:true,get:function(){return typeorm.Column}});Object.defineProperty(exports,"Entity",{enumerable:true,get:function(){return typeorm.Entity}});Object.defineProperty(exports,"JoinColumn",{enumerable:true,get:function(){return typeorm.JoinColumn}});Object.defineProperty(exports,"ManyToMany",{enumerable:true,get:function(){return typeorm.ManyToMany}});Object.defineProperty(exports,"ManyToOne",{enumerable:true,get:function(){return typeorm.ManyToOne}});Object.defineProperty(exports,"OneToMany",{enumerable:true,get:function(){return typeorm.OneToMany}});Object.defineProperty(exports,"OneToOne",{enumerable:true,get:function(){return typeorm.OneToOne}});Object.defineProperty(exports,"PrimaryColumn",{enumerable:true,get:function(){return typeorm.PrimaryColumn}});Object.defineProperty(exports,"PrimaryGeneratedColumn",{enumerable:true,get:function(){return typeorm.PrimaryGeneratedColumn}});exports.default=ne;

package/dist/index.d.cts

@@ -0,0 +1,386 @@
+import { ObjectLiteral, Repository, MixedList, EntitySchema, EntityTarget } from 'typeorm';
+export { BaseEntity, Column, Entity, JoinColumn, ManyToMany, ManyToOne, OneToMany, OneToOne, PrimaryColumn, PrimaryGeneratedColumn } from 'typeorm';
+import { QueryResult as QueryResult$1 } from 'mysql2';
+import { QueryDeepPartialEntity } from 'typeorm/query-builder/QueryPartialEntity';
+
+type dynamicObject = {
+    [x: string]: any;
+};
+interface ModelGenerator {
+    generate: () => void;
+    connection: () => ConnectionDetails;
+    mapColumns: (sqlType: string) => void;
+}
+type ConnectionDetails = {
+    host: string;
+    port: string | number;
+    user: string;
+    password: string;
+    database: string;
+    params: dynamicObject;
+};
+type QueryAction = "create" | "upsert" | "select" | "update" | "delete";
+type QueryResult = InsertQueryResult | SelectQueryResult | UpdateQueryResult | DeleteQueryResult;
+/**
+ * Defines supported comparison operators for filtering queries.
+ * Enables IntelliSense support in `.where()` conditions.
+ *
+ * @template T The type of the value being compared (e.g., number, string, Date).
+ */
+type WhereOperators<T> = {
+    /**
+     * Greater than (`>`) operator.
+     *
+     * @example
+     * query.where({ age: { gt: 18 } }) // WHERE age > 18
+     */
+    gt?: T;
+    /**
+     * Greater than or equal to (`>=`) operator.
+     *
+     * @example
+     * query.where({ price: { gte: 100 } }) // WHERE price >= 100
+     */
+    gte?: T;
+    /**
+     * Less than (`<`) operator.
+     *
+     * @example
+     * query.where({ age: { lt: 30 } }) // WHERE age < 30
+     */
+    lt?: T;
+    /**
+     * Less than or equal to (`<=`) operator.
+     *
+     * @example
+     * query.where({ date: { lte: '2024-01-01' } }) // WHERE date <= '2024-01-01'
+     */
+    lte?: T;
+    /**
+     * Not equal (`!=`) operator.
+     *
+     * @example
+     * query.where({ status: { ne: 'inactive' } }) // WHERE status != 'inactive'
+     */
+    ne?: T;
+    /**
+     * Equal (`=`) operator.
+     * This is typically unnecessary since `.where({ key: value })` already handles equality.
+     *
+     * @example
+     * query.where({ id: { eq: 1 } }) // WHERE id = 1
+     */
+    eq?: T;
+};
+type PartialConditions<T> = Partial<Record<keyof T, string | number | boolean | WhereOperators<any>>>;
+type QueryError = {
+    code: number | string;
+    message: string;
+    query: string;
+    values: string[];
+};
+type InsertQueryResult = {
+    created: boolean;
+    id?: number;
+    record?: ObjectLiteral;
+    records?: ObjectLiteral[];
+    error?: QueryError;
+};
+type SelectQueryResult = {
+    hasRows: boolean;
+    count?: number;
+    row?: any;
+    rows?: any[];
+    error?: QueryError;
+    save?: () => void;
+};
+type UpdateQueryResult = {
+    updated: boolean;
+    record?: ObjectLiteral;
+    records?: ObjectLiteral[];
+    error?: QueryError;
+};
+type DeleteQueryResult = {
+    deleted: boolean;
+    count: number;
+    error?: QueryError;
+};
+
+declare class ZormExprBuilder<T extends ObjectLiteral> {
+    private _parts;
+    private _params;
+    private _paramIdx;
+    private _alias;
+    private static globalParamIdx;
+    constructor(alias?: string, parent?: {
+        params: Record<string, any>;
+        idx: number;
+    });
+    field(col: keyof T | string): this;
+    equals(value: any): this;
+    append(extra: string): this;
+    wrap(wrapper: (expr: string) => string): this;
+    exists(sub: (q: ZormExprBuilder<T>) => ZormExprBuilder<T>): this;
+    select(expr: string): this;
+    from(table: string, alias: string): this;
+    where(cond: Record<string, any>): this;
+    or(): this;
+    group(): this;
+    fromUnixTime(): this;
+    date(): this;
+    substring(column: keyof T | string, delimiter: string, index: number): this;
+    toExpression(): {
+        expression: string;
+        param: Record<string, any>;
+    };
+    buildExpression(): string;
+    buildParams(): Record<string, any>;
+}
+
+declare class ZormQueryBuilder<T extends ObjectLiteral, R = QueryResult$1> extends Promise<R> {
+    private repository;
+    private queryBuilder;
+    private entityAlias;
+    private action;
+    private queryValues;
+    private usePromise;
+    private whereCount;
+    private isActiveRecord;
+    private activeRecord;
+    private joinedAliases;
+    constructor(repository: Repository<T>, _action: QueryAction, _usePromise?: boolean);
+    _create(): this;
+    upsert(): this;
+    _update(): this;
+    _delete(): this;
+    _getRawQuery(): [string, any[]];
+    active(): this;
+    _saveActiveRecord(activeRecord: T): Promise<T | null>;
+    clone(): ZormQueryBuilder<T, R>;
+    /**
+     * Sets the values for an insert or update query.
+     * @param data - The data to be inserted or updated.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    with(data: QueryDeepPartialEntity<T> | QueryDeepPartialEntity<T[]>): this;
+    /**
+     * Sets the values for an insert or update query.
+     * @param data - The data to be inserted or updated.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    withData(data: QueryDeepPartialEntity<T> | QueryDeepPartialEntity<T[]>): this;
+    /**
+     * Specifies the fields to be selected in a select query.
+     * @param fields - The fields to be selected.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    select(fields: (keyof T)[]): this;
+    private applyCondition;
+    /**
+     * Adds a custom expression-based WHERE clause using a fluent builder.
+     * @param fn - A callback that receives a ZormExprBuilder and returns an expression + param.
+     */
+    expression(exprFn: (q: ZormExprBuilder<T>) => ZormExprBuilder<T>, 
+    /** Add parentheses group to built expression */
+    group?: boolean): this;
+    /**
+     * Adds a WHERE condition to the query.
+     * @param condition - The condition to be added.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    where(condition: PartialConditions<T>): this;
+    /**
+     * Adds an OR condition to the query.
+     * @param condition - The condition to be added.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    or(condition: PartialConditions<T>): this;
+    /**
+     * Adds an ORDER BY clause to the query.
+     * @param field - The field to order by.
+     * @param direction - The direction of the order (ASC or DESC).
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    orderBy(field: keyof T, direction?: "ASC" | "DESC"): this;
+    /**
+     * Adds a LIMIT clause to the query.
+     * @param n - The maximum number of records to return.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    limit(n: number): this;
+    /**
+     * Adds an OFFSET clause to the query.
+     * @param n - The number of records to skip.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    offset(n: number): this;
+    /**
+     * Adds relations to be included in the query.
+     * @param relations - The relations to be included.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    withRelation(rel: string, ...more: string[]): this;
+    /**
+     * Adds an INNER JOIN clause to the query.
+     * @param relation - The relation to join.
+     * @param alias - The alias for the joined relation.
+     * @param condition - Optional condition for the join.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    innerJoin(relation: string, alias: string, condition?: string): this;
+    /**
+     * Adds a LEFT JOIN clause to the query.
+     * @param relation - The relation to join.
+     * @param alias - The alias for the joined relation.
+     * @param condition - Optional condition for the join.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    leftJoin(relation: string, alias: string, condition?: string): this;
+    /**
+     * Adds a GROUP BY clause to the query.
+     * @param field - The field to group by.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    groupBy(field: keyof T): this;
+    /**
+     * Adds a HAVING clause to the query.
+     * @param condition - The condition for the HAVING clause.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    having(condition: string): this;
+    /**
+     * Adds an IN clause to the query.
+     * @param field - The field to check.
+     * @param values - The values for the IN clause.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    in(field: keyof T, values: any[]): this;
+    /**
+     * Adds a LIKE condition to the query, supporting both single and multiple values.
+     * If an array is provided, it uses OR conditions between them.
+     * @param field - The field to apply the LIKE condition on.
+     * @param value - A string or an array of strings to match.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    like(conditions: Partial<Record<keyof T, string | string[]>>, mode: "contains" | "startsWith" | "endsWith" | "exact"): this;
+    /**
+     * Adds a DISTINCT clause to the query.
+     * @returns The current instance of ZormQueryBuilder.
+     */
+    distinct(): this;
+    count(field?: keyof T): Promise<number>;
+    sum(field: keyof T): Promise<number>;
+    avg(field: keyof T): Promise<number>;
+    min(field: keyof T): Promise<number>;
+    max(field: keyof T): Promise<number>;
+    /**
+     * Executes a raw SQL query.
+     * @param sql - The raw SQL query.
+     * @param params - Optional parameters for the query.
+     * @returns A promise that resolves with the query result.
+     */
+    rawQuery(sql: string, params?: any): Promise<any>;
+    /**
+     * Executes the query and returns the result.
+     * @returns A promise that resolves with the query result.
+     */
+    execute(): Promise<R>;
+    /**
+     * Handles the fulfillment and rejection of the promise.
+     * @param onfulfilled - The callback to execute when the promise is fulfilled.
+     * @param onrejected - The callback to execute when the promise is rejected.
+     * @returns A promise that resolves with the result of the callback.
+     */
+    then<TResult1 = R, TResult2 = never>(onfulfilled?: ((value: R) => TResult1 | PromiseLike<TResult1>) | null, onrejected?: ((reason: any) => TResult2 | PromiseLike<TResult2>) | null): Promise<TResult1 | TResult2>;
+}
+
+/**
+ * Zorm is a lightweight ORM wrapper around TypeORM with support for MySQL.
+ */
+declare class Zorm {
+    /**
+     * Singleton instance of Zorm.
+     * @private
+     */
+    private static instance;
+    /**
+     * TypeORM DataSource instance.
+     * @private
+     */
+    private dataSource;
+    /**
+     * Flag to track if the connection is initialized.
+     * @private
+     */
+    private initialized;
+    /**
+     * Determines whether to use Promises for queries.
+     * @private
+     */
+    private usePromise;
+    private _init;
+    /**
+     * Private constructor to enforce singleton pattern.
+     * @param {string} connectionString - The database connection string.
+     * @param {string | null} [entitiesPath] - Path to the entities directory.
+     * @param {boolean} [usePromise] - Whether to use Promises for queries.
+     * @private
+     */
+    private constructor();
+    /**
+     * Returns the singleton instance of Zorm.
+     * @param {string} connectionString - The database connection string.
+     * @param {string | null} [entitiesPath] - Path to the entities directory.
+     * @param {boolean} [usePromise] - Whether to use Promises for queries.
+     * @returns {Zorm} The singleton instance of Zorm.
+     */
+    static get(connectionString: string, entities?: MixedList<string | Function | EntitySchema<any>>, entitiesPath?: string | null, usePromise?: boolean): Zorm;
+    /**
+     * Connects to the database and initializes entities.
+     * @param {MixedList<string | Function | EntitySchema<any>>} entities - List of entity schemas.
+     * @returns {Promise<void>} Resolves when the connection is initialized.
+     */
+    connect(entities?: MixedList<string | Function | EntitySchema<any>>): Promise<void>;
+    whenReady<T = this>(): T;
+    private wrapQueryBuilder;
+    /**
+     * Returns the appropriate QueryBuilder based on the database type.
+     * @param {EntityTarget<T>} entity - The entity target.
+     * @param {QueryAction} action - The query action type.
+     * @returns {ZormQueryBuilder<T, R>} Query builder instance.
+     * @private
+     */
+    private getQueryBuilder;
+    /**
+     * Retrieves the repository for a given entity.
+     * @param {EntityTarget<T>} entity - The entity target.
+     * @returns {Repository<T>} The repository instance.
+     */
+    getRepository<T extends ObjectLiteral>(entity: EntityTarget<T>): Repository<T>;
+    /**
+     * Creates a new record in the database.
+     * @param {EntityTarget<T>} entity - The entity target.
+     * @returns {ZormQueryBuilder<T, InsertQueryResult>} The query builder instance.
+     */
+    create<T extends ObjectLiteral>(entity: EntityTarget<T>): ZormQueryBuilder<T, InsertQueryResult>;
+    /**
+     * Finds records in the database.
+     * @param {EntityTarget<T>} entity - The entity target.
+     * @returns {ZormQueryBuilder<T, SelectQueryResult>} The query builder instance.
+     */
+    find<T extends ObjectLiteral>(entity: EntityTarget<T>): ZormQueryBuilder<T, SelectQueryResult>;
+    /**
+     * Updates records in the database.
+     * @param {EntityTarget<T>} entity - The entity target.
+     * @returns {ZormQueryBuilder<T, UpdateQueryResult>} The query builder instance.
+     */
+    update<T extends ObjectLiteral>(entity: EntityTarget<T>): ZormQueryBuilder<T, UpdateQueryResult>;
+    /**
+     * Deletes records from the database.
+     * @param {EntityTarget<T>} entity - The entity target.
+     * @returns {ZormQueryBuilder<T, DeleteQueryResult>} The query builder instance.
+     */
+    delete<T extends ObjectLiteral>(entity: EntityTarget<T>): ZormQueryBuilder<T, DeleteQueryResult>;
+}
+
+export { type ConnectionDetails, type DeleteQueryResult, type InsertQueryResult, type ModelGenerator, type PartialConditions, type QueryAction, type QueryError, type QueryResult, type SelectQueryResult, type UpdateQueryResult, type WhereOperators, Zorm as default, type dynamicObject };