@mrxsys/mrx-core 2.3.3-canary-20250514-a17e993

package/CHANGELOG.md

@@ -0,0 +1,45 @@
+
+## v2.3.3-canary-20250514-a17e993
+
+[compare changes](https://github.com/MRX-Systems/MRX-Core/compare/v2.3.3-canary-20250514-ce5e64c...v2.3.3-canary-20250514-a17e993)
+
+### 🔧 Fixes
+
+- **🔧:** [Remove t.ts] ([253a76bd](https://github.com/MRX-Systems/MRX-Core/commit/253a76bd))
+
+### 🧹 Refactors
+
+- **🧹:** [remove unused color enum exports] ([9daea580](https://github.com/MRX-Systems/MRX-Core/commit/9daea580))
+- **🧹:** [Refactor file structure, export, comments] ([f7e58962](https://github.com/MRX-Systems/MRX-Core/commit/f7e58962))
+- **🧹:** [rename package and update metadata] ([a4a081ce](https://github.com/MRX-Systems/MRX-Core/commit/a4a081ce))
+
+### 📖 Documentation
+
+- **📖:** [enhance HTTP status code documentation and structure] ([c6e65b86](https://github.com/MRX-Systems/MRX-Core/commit/c6e65b86))
+- **📖:** [update WhereClause interface documentation] ([a8a40f58](https://github.com/MRX-Systems/MRX-Core/commit/a8a40f58))
+- **📖:** [enhance Transaction type documentation] ([bc19f4c8](https://github.com/MRX-Systems/MRX-Core/commit/bc19f4c8))
+- **📖:** [update async iterable interface documentation] ([f42d90b1](https://github.com/MRX-Systems/MRX-Core/commit/f42d90b1))
+- **📖:** [improve documentation for QueryOptionsExtendPagination] ([304258f5](https://github.com/MRX-Systems/MRX-Core/commit/304258f5))
+- **📖:** [clarify throwIfNoResult and transaction properties] ([3fa97eaa](https://github.com/MRX-Systems/MRX-Core/commit/3fa97eaa))
+- **📖:** [update OrderBy type documentation for clarity] ([4b6366e6](https://github.com/MRX-Systems/MRX-Core/commit/4b6366e6))
+- **📖:** [add remarks for MssqlEventLog interface clarity] ([84ffca77](https://github.com/MRX-Systems/MRX-Core/commit/84ffca77))
+- **📖:** [Add detailed documentation for plugins] ([f2019ea8](https://github.com/MRX-Systems/MRX-Core/commit/f2019ea8))
+
+### 📦 Build
+
+- **📦:** [update @types/bun dependency version] ([94db9e9a](https://github.com/MRX-Systems/MRX-Core/commit/94db9e9a))
+- **📦:** [update docs script in package.json] ## Refactoring - Updated the "docs" script in package.json to include the tsconfig file. ([6727b000](https://github.com/MRX-Systems/MRX-Core/commit/6727b000))
+
+### 🌊 Types
+
+- **🌊:** [refine advanced search type definitions and examples] ([f1d9a5fb](https://github.com/MRX-Systems/MRX-Core/commit/f1d9a5fb))
+
+### 🦉 Chore
+
+- **🦉:** V2.3.3-canary-20250514-764de87 ([79956e3c](https://github.com/MRX-Systems/MRX-Core/commit/79956e3c))
+
+### ❤️ Contributors
+
+- Ruby <necrelox@proton.me>
+- Github-actions <necrelox@proton.me>
+

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2025 MRX Systems
+
+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,20 @@
+# 📦 Core
+
+> ONLY FOR BUN
+
+## 📌 Table of contents
+
+- [📦 Core](#-core)
+  - [📌 Table of contents](#-table-of-contents)
+  - [⚖️ License](#-license)
+  - [📧 Contact](#-contact)
+
+## ⚖️ License
+
+Distributed under the MIT License. See LICENSE for more information.
+
+## 📧 Contact
+
+Mail - [dev@mrxsys.com](mailto:dev@mrxsys.com)
+
+[Project link](https://github.com/MRX-Systems/MRX-Core)

package/dist/chunk-0pft81dh.js

@@ -0,0 +1,2 @@
+var b={invalidEnvironment:"core.error.util.invalid_environment"};
+export{b as e};

package/dist/chunk-6sa6shm6.js

@@ -0,0 +1,2 @@
+var{randomUUIDv7:g}=globalThis.Bun;class j extends Error{cause;_uuid=g();_date=new Date;_key;_httpStatusCode;constructor(f){super(f?.message);super.name="CoreError",this.cause=f?.cause,this._key=f?.key||"",this._httpStatusCode=f?.httpStatusCode||500}get uuid(){return this._uuid}get date(){return this._date}get key(){return this._key}get httpStatusCode(){return this._httpStatusCode}}
+export{j as _};

package/dist/chunk-7map0v4a.js

@@ -0,0 +1,2 @@
+var x=(g)=>typeof g==="string"&&new Date(g).toString()!=="Invalid Date";var A=(g)=>{let h={[Symbol.asyncIterator]:()=>({next(){return new Promise((i,q)=>{let w=()=>{g.off("data",k),g.off("end",D),g.off("error",I)},k=(S)=>{w(),i({value:S,done:!1})},D=()=>{w(),i({value:void 0,done:!0})},I=(S)=>{w(),q(S)};g.on("data",k),g.on("end",D),g.on("error",I)})}})};return g[Symbol.asyncIterator]=h[Symbol.asyncIterator],g};
+export{x as Y,A as Z};

package/dist/chunk-dppgkz92.js

@@ -0,0 +1,2 @@
+var f={mssqlConnectionError:"core.error.mssql.database.connection_error",mssqlDisconnectError:"core.error.mssql.database.disconnect_error",mssqlNotConnected:"core.error.mssql.database.not_connected",mssqlNoResult:"core.error.mssql.database.no_result",mssqlQueryError:"core.error.mssql.database.query_error",mssqlDatabaseAccessDenied:"core.error.mssql.database.access_denied",mssqlDatabaseAuthorizationFailed:"core.error.mssql.database.authorization_failed",mssqlDatabaseSyntaxError:"core.error.mssql.database.syntax_error",mssqlDatabaseColumnNotFound:"core.error.mssql.database.column_not_found",mssqlTableNotFound:"core.error.mssql.database.table_not_found",mssqlDatabaseAmbiguousColumn:"core.error.mssql.database.ambiguous_column",mssqlDatabaseDuplicateKey:"core.error.mssql.database.duplicate_key",mssqlDatabaseForeignKeyViolation:"core.error.mssql.database.foreign_key_violation",mssqlDatabaseUniqueConstraintViolation:"core.error.mssql.database.unique_constraint_violation",mssqlDatabaseDeadlockDetected:"core.error.mssql.database.deadlock_detected",mssqlDatabaseResourceLocked:"core.error.mssql.database.resource_locked",mssqlDatabaseTransactionAborted:"core.error.mssql.database.transaction_aborted",mssqlDatabaseInsufficientMemory:"core.error.mssql.database.insufficient_memory",mssqlDatabaseInsufficientStorage:"core.error.mssql.database.insufficient_storage",mssqlDatabaseQueryTimeout:"core.error.mssql.database.query_timeout",mssqlDatabaseTransactionLogFull:"core.error.mssql.database.transaction_log_full",mssqlDatabaseDataTooLarge:"core.error.mssql.database.data_too_large",mssqlDatabasePermissionDenied:"core.error.mssql.database.permission_denied",mssqlDatabaseIdentityInsertNotAllowed:"core.error.mssql.database.identity_insert_not_allowed",mssqlDatabaseCannotUpdateIdentityColumn:"core.error.mssql.database.cannot_update_identity_column"};var v={0:f.mssqlQueryError,4060:f.mssqlDatabaseAccessDenied,18452:f.mssqlDatabaseAuthorizationFailed,18456:f.mssqlDatabaseAuthorizationFailed,102:f.mssqlDatabaseSyntaxError,207:f.mssqlDatabaseColumnNotFound,208:f.mssqlTableNotFound,209:f.mssqlDatabaseAmbiguousColumn,2627:f.mssqlDatabaseDuplicateKey,547:f.mssqlDatabaseForeignKeyViolation,2601:f.mssqlDatabaseUniqueConstraintViolation,1205:f.mssqlDatabaseDeadlockDetected,1222:f.mssqlDatabaseResourceLocked,3928:f.mssqlDatabaseTransactionAborted,701:f.mssqlDatabaseInsufficientMemory,1105:f.mssqlDatabaseInsufficientStorage,8645:f.mssqlDatabaseQueryTimeout,9002:f.mssqlDatabaseTransactionLogFull,8152:f.mssqlDatabaseDataTooLarge,229:f.mssqlDatabasePermissionDenied,544:f.mssqlDatabaseIdentityInsertNotAllowed,8102:f.mssqlDatabaseCannotUpdateIdentityColumn};
+export{f as $,v as aa};

package/dist/chunk-kn1300vm.js

@@ -0,0 +1,2 @@
+function l(x,z){return z in x}function a(x){return Array.isArray(x)}function e(x){return typeof x==="bigint"}function Q(x){return typeof x==="boolean"}function xx(x){return x instanceof globalThis.Date}function W(x){return typeof x==="number"}function q(x){return typeof x==="object"&&x!==null}function Ex(x){return x instanceof globalThis.RegExp}function B(x){return typeof x==="string"}function qx(x){return x instanceof globalThis.Uint8Array}function wx(x){return x===void 0}class Y extends Error{constructor(x){super(x)}}var G=Symbol.for("TypeBox.Transform"),Z=Symbol.for("TypeBox.Readonly"),J=Symbol.for("TypeBox.Optional"),_=Symbol.for("TypeBox.Hint"),w=Symbol.for("TypeBox.Kind");function Jx(x){return q(x)&&x[J]==="Optional"}function $(x){return E(x,"Any")}function D(x){return E(x,"Argument")}function F(x){return E(x,"Array")}function P(x){return E(x,"AsyncIterator")}function V(x){return E(x,"BigInt")}function h(x){return E(x,"Boolean")}function C(x){return E(x,"Computed")}function H(x){return E(x,"Constructor")}function M(x){return E(x,"Date")}function T(x){return E(x,"Function")}function N(x){return E(x,"Integer")}function S(x){return E(x,"Intersect")}function c(x){return E(x,"Iterator")}function E(x,z){return q(x)&&w in x&&x[w]===z}function j(x){return E(x,"Literal")}function L(x){return E(x,"MappedKey")}function b(x){return E(x,"MappedResult")}function k(x){return E(x,"Never")}function g(x){return E(x,"Not")}function p(x){return E(x,"Null")}function R(x){return E(x,"Number")}function U(x){return E(x,"Object")}function A(x){return E(x,"Promise")}function o(x){return E(x,"Record")}function m(x){return E(x,"Ref")}function y(x){return E(x,"RegExp")}function r(x){return E(x,"String")}function t(x){return E(x,"Symbol")}function O(x){return E(x,"TemplateLiteral")}function f(x){return E(x,"This")}function Qx(x){return q(x)&&G in x}function K(x){return E(x,"Tuple")}function d(x){return E(x,"Undefined")}function i(x){return E(x,"Union")}function n(x){return E(x,"Uint8Array")}function I(x){return E(x,"Unknown")}function s(x){return E(x,"Unsafe")}function v(x){return E(x,"Void")}function u(x){return q(x)&&w in x&&B(x[w])}function Wx(x){return $(x)||D(x)||F(x)||h(x)||V(x)||P(x)||C(x)||H(x)||M(x)||T(x)||N(x)||S(x)||c(x)||j(x)||L(x)||b(x)||k(x)||g(x)||p(x)||R(x)||U(x)||A(x)||o(x)||m(x)||y(x)||r(x)||t(x)||O(x)||f(x)||K(x)||d(x)||i(x)||n(x)||I(x)||s(x)||v(x)||u(x)}
+export{l as q,a as r,e as s,Q as t,xx as u,W as v,q as w,Ex as x,B as y,qx as z,wx as A,Y as B,G as C,Z as D,J as E,_ as F,w as G,Jx as H,F as I,S as J,b as K,k as L,U as M,o as N,Qx as O,K as P,d as Q,i as R,u as S,Wx as T};

package/dist/chunk-nntk6mwx.js

@@ -0,0 +1,2 @@
+var f={jwtSignError:"core.error.elysia.jwt_sign_error",jwtSecretNotFound:"core.error.elysia.jwt_secret_not_found",rateLimitExceeded:"core.error.elysia.rate_limit_exceeded",dynamicDatabaseKeyNotFound:"core.error.elysia.dynamic_database_key_not_found",needAdvancedSearch:"core.error.elysia.need_advanced_search"};var m={ok:200,created:201,accepted:202,nonAuthoritativeInformation:203,noContent:204,resetContent:205,partialContent:206,multiStatus:207,alreadyReported:208,imUsed:226,multipleChoices:300,movedPermanently:301,found:302,seeOther:303,notModified:304,useProxy:305,temporaryRedirect:307,permanentRedirect:308,badRequest:400,unauthorized:401,paymentRequired:402,forbidden:403,notFound:404,methodNotAllowed:405,notAcceptable:406,proxyAuthenticationRequired:407,requestTimeout:408,conflict:409,gone:410,lengthRequired:411,preconditionFailed:412,payloadTooLarge:413,uriTooLong:414,unsupportedMediaType:415,rangeNotSatisfiable:416,expectationFailed:417,imATeapot:418,misdirectedRequest:421,unprocessableEntity:422,locked:423,failedDependency:424,tooEarly:425,upgradeRequired:426,preconditionRequired:428,tooManyRequests:429,requestHeaderFieldsTooLarge:431,unavailableForLegalReasons:451,internalServerError:500,notImplemented:501,badGateway:502,serviceUnavailable:503,gatewayTimeout:504,httpVersionNotSupported:505,variantAlsoNegotiates:506,insufficientStorage:507,loopDetected:508,notExtended:510,networkAuthenticationRequired:511};
+export{f as da,m as ea};

package/dist/chunk-rr6e20n5.js

@@ -0,0 +1,2 @@
+var e=Object.defineProperty;var f=(c,a)=>{for(var b in a)e(c,b,{get:a[b],enumerable:!0,configurable:!0,set:(d)=>a[b]=()=>d})};
+export{f as ha};

package/dist/chunk-s3xqwymw.js

@@ -0,0 +1,2 @@
+var b={smtpConnectionError:"core.error.mailer.smtp.connection_error",smtpNotConnected:"core.error.mailer.smtp.not_connected",smtpAlreadyConnected:"core.error.mailer.smtp.already_connected"};
+export{b};

package/dist/chunk-t411e41y.js

@@ -0,0 +1,2 @@
+import{Y as _,Z as A}from"./chunk-7map0v4a.js";import{_ as U}from"./chunk-6sa6shm6.js";import{$ as X,aa as Z}from"./chunk-dppgkz92.js";import{PassThrough as x}from"stream";var $={$eq:(j,z,G)=>j.where(z,G),$neq:(j,z,G)=>j.whereNot(z,G),$lt:(j,z,G)=>j.where(z,"<",G),$lte:(j,z,G)=>j.where(z,"<=",G),$gt:(j,z,G)=>j.where(z,">",G),$gte:(j,z,G)=>j.where(z,">=",G),$in:(j,z,G)=>j.whereIn(z,G),$nin:(j,z,G)=>j.whereNotIn(z,G),$between:(j,z,G)=>j.whereBetween(z,G),$nbetween:(j,z,G)=>j.whereNotBetween(z,G),$like:(j,z,G)=>{let H=`%${G}%`;if(_(G))return j.whereRaw(`CONVERT(VARCHAR, ${z}, 23) LIKE ?`,[H]);return j.whereLike(z,H)},$nlike:(j,z,G)=>{let H=`%${G}%`;if(_(G))return j.whereRaw(`CONVERT(VARCHAR, ${z}, 23) NOT LIKE ?`,[H]);return j.whereRaw(`${z} NOT LIKE ?`,[H])},$isNull:(j,z,G)=>G?j.whereNull(z):j.whereNotNull(z)};class R{_knex;_table;constructor(j,z){this._knex=j,this._table=z}findStream(j){let z=this._knex(this._table.name).select(j?.selectedFields??"*");if(j?.advancedSearch)this._applySearch(z,j.advancedSearch);let G=[j?.orderBy?.[0]||this._table.primaryKey[0],j?.orderBy?.[1]||"asc"];z.orderBy(G[0],G[1]);let H=z.stream(),L=new x({objectMode:!0,...j?.transform&&{transform:j.transform}});return H.on("error",(M)=>{let J=M?.number||0;L.emit("error",new U({key:Z[J]??X.mssqlQueryError,message:"An error occurred while streaming the query results.",cause:{query:z.toSQL().sql,error:M}}))}),H.pipe(L),A(L)}async find(j){let z=this._knex(this._table.name).select(j?.selectedFields??"*");if(j?.advancedSearch)this._applySearch(z,j.advancedSearch);let G=[j?.orderBy?.[0]||this._table.primaryKey[0],j?.orderBy?.[1]||"asc"],H=j?.limit||100,L=j?.offset||0;return z.orderBy(G[0],G[1]).limit(H).offset(L),this._executeQuery(z,j?.throwIfNoResult)}async findOne(j){let z=this._knex(this._table.name).select(j?.selectedFields??"*");if(j?.advancedSearch)this._applySearch(z,j.advancedSearch);let G=[j?.orderBy?.[0]||this._table.primaryKey[0],j?.orderBy?.[1]||"asc"];return z.orderBy(G[0],G[1]),this._executeQuery(z,j?.throwIfNoResult).then((H)=>H[0])}async count(j){let z=this._knex(this._table.name).count({count:"*"});if(j?.advancedSearch)this._applySearch(z,j.advancedSearch);return this._executeQuery(z,j?.throwIfNoResult).then((G)=>G[0].count)}async insert(j,z){let G=this._knex(this._table.name).insert(j).returning(z?.selectedFields??"*");return this._executeQuery(G)}async update(j,z){let G=this._knex(this._table.name).update(j).returning(z?.selectedFields??"*");if(z?.advancedSearch)this._applySearch(G,z.advancedSearch);return this._executeQuery(G)}async delete(j){let z=this._knex(this._table.name).delete().returning(j?.selectedFields??"*");if(j?.advancedSearch)this._applySearch(z,j.advancedSearch);return this._executeQuery(z)}_applySearch(j,z){let G=(H,L)=>{for(let[M,J]of Object.entries(L))if(this._isComplexQuery(J)){let Q=J;for(let[O,W]of Object.entries(Q))if(O in $){let Y=$[O];Y(H,M,W)}}else if(M==="$q"&&(typeof J==="string"||typeof J==="number")){for(let Q of this._table.fields)if(J)H.orWhere(Q,"like",`%${J}%`)}else if(M==="$q"&&typeof J==="object"&&"selectedFields"in J){let{selectedFields:Q,value:O}=J,W=typeof O==="number",Y=W?"=":"like",F=W?O:`%${O}%`;Q.forEach((P)=>{H.orWhere(P,Y,F)})}else{if(typeof J==="object"&&Object.keys(J).length===0)continue;H.where(M,J)}};if(Array.isArray(z))z.reduce((H,L)=>H.orWhere((M)=>this._applySearch(M,L)),j);else G(j,z)}_handleError(j,z){if(j instanceof U)throw j;let G=j?.number||0;throw new U({key:Z[G]??X.mssqlQueryError,message:"An error occurred while executing the query.",cause:{query:z.toSQL().sql,error:j}})}_isComplexQuery(j){let z=new Set(["$eq","$neq","$lt","$lte","$gt","$gte","$in","$nin","$between","$nbetween","$like","$nlike","$isNull"]);return Boolean(j&&typeof j==="object"&&!Array.isArray(j)&&Object.keys(j).some((G)=>z.has(G)))}async _executeQuery(j,z=!1){try{let G=await j;if(z&&G.length===0)throw new U({key:X.mssqlNoResult,message:"No records found matching the specified query options.",cause:{query:j.toSQL().sql}});return G}catch(G){return this._handleError(G,j)}}}
+export{$ as W,R as X};

package/dist/chunk-wggj590m.js

@@ -0,0 +1,2 @@
+import{X}from"./chunk-t411e41y.js";import{_ as O}from"./chunk-6sa6shm6.js";import{$ as J}from"./chunk-dppgkz92.js";import{ba as W,ca as P}from"./chunk-yeyzc9n2.js";import $ from"events";class V extends ${_databaseName;_fields=[];_name;_primaryKey;constructor(w,F,z,H){super();this._databaseName=w,this._name=F,this._fields=z,this._primaryKey=H}get databaseName(){return this._databaseName}get name(){return this._name}get fields(){return this._fields}get primaryKey(){return this._primaryKey}}import{EventEmitter as A}from"events";import B from"knex";class D extends A{_isConnected=!1;_databaseName;_tables=new Map;_repositories=new Map;_db;_pulse;constructor(w){super();this._databaseName=w.databaseName,this._pulse=w.pulse??!1,this._db=B({client:"mssql",debug:w.debug??!0,acquireConnectionTimeout:w.connectionTimeout??20000,log:{debug:(F)=>{if(w.debug){let z=this._extractTablesFromSqlQuery(F.sql),H={database:w.databaseName,tables:z,queryUuid:F.__knexQueryUid,method:F.method,sql:F.sql,bindings:F.bindings};this.emit(W.log,H)}}},connection:{database:w.databaseName,host:w.host,port:w.port,user:w.user,password:w.password,options:{encrypt:w.encrypt??!0},bigNumberStrings:!1},pool:{min:w.poolMin??2,max:w.poolMax??10}})}async connect(){try{if(await this._introspectDatabase(),this._isConnected=!0,this._pulse)this._addEventKnex()}catch(w){throw new O({key:J.mssqlConnectionError,message:`Failed to connect to the database: "${this._databaseName}".`,cause:w})}}async disconnect(){if(!this._isConnected)throw new O({key:J.mssqlNotConnected,message:`Database "${this._databaseName}" is not connected.`});try{await this._db.destroy(),this._isConnected=!1}catch(w){throw new O({key:J.mssqlDisconnectError,message:`Failed to disconnect from the database: "${this._databaseName}".`,cause:w})}}getRepository(w,F){if(!this._isConnected)throw new O({key:J.mssqlNotConnected,message:`Database "${this._databaseName}" is not connected.`});if(!this._tables.has(w))throw new O({key:J.mssqlTableNotFound,message:`Table not found: "${w}".`,cause:{table:w}});let z=this._repositories.get(w);if(F){let H=this._tables.get(w);if(z&&z instanceof F)return z;return z=new F(this._db,H),this._repositories.set(w,z),z}return this._repositories.get(w)}getTable(w){if(!this._isConnected)throw new O({key:J.mssqlNotConnected,message:`Database "${this._databaseName}" is not connected.`});if(!this._tables.has(w))throw new O({key:J.mssqlTableNotFound,message:`Table not found: "${w}".`,cause:{table:w}});return this._tables.get(w)}get databaseName(){return this._databaseName}get tables(){return this._tables}get repositories(){return this._repositories}get isConnected(){return this._isConnected}get db(){if(!this._isConnected)throw new O({key:J.mssqlNotConnected,message:`Database "${this._databaseName}" is not connected.`});return this._db}async _introspectDatabase(){(await this._db.from({c:"information_schema.columns"}).select("c.table_name as tableName").select(this._db.raw("STRING_AGG(c.column_name, ',') AS fields")).select("pk.primaryKeyColumn as primaryKeyColumn").select("pk.primaryKeyType as primaryKeyType").leftJoin(this._db.from({tc:"information_schema.table_constraints"}).join({kcu:"information_schema.key_column_usage"},"tc.constraint_name","kcu.constraint_name").join({col:"information_schema.columns"},(z)=>{z.on("col.table_name","=","kcu.table_name").andOn("col.column_name","=","kcu.column_name")}).where("tc.constraint_type","PRIMARY KEY").groupBy("tc.table_name","kcu.column_name","col.data_type").select("tc.table_name as tableName").select("kcu.column_name as primaryKeyColumn").select("col.data_type as primaryKeyType").as("pk"),"c.table_name","pk.tableName").groupBy("c.table_name","pk.primaryKeyColumn","pk.primaryKeyType")).reduce((z,{tableName:H,fields:Q,primaryKeyColumn:Y,primaryKeyType:Z})=>{let _=Z==="int"?"NUMBER":"STRING";return z.set(H,{fields:Q.split(","),primaryKey:[Y,_]}),z},new Map).forEach((z,H)=>{let Q=new V(this._databaseName,H,z.fields,z.primaryKey);this._tables.set(H,Q),this._repositories.set(H,new X(this._db,Q))})}_extractTablesFromSqlQuery(w){let F=/(?:update|insert\s+into|delete\s+from|from|join|with)\s+\[?([^\]\s]+)\]?/gi,z=[...w.matchAll(F)].map((H)=>H[1]);return Array.from(new Set(z))}_handleQueryResponse(w,F){let z=this._extractTablesFromSqlQuery(F.sql),H=this._tables.get(z[0]);switch(F.method){case"select":H?.emit(P.selected,w);break;case"insert":H?.emit(P.created,w);break;case"update":H?.emit(P.updated,w);break;case"delete":H?.emit(P.deleted,w);break;default:break}}_handleQueryError(w,F){this.emit("query:error",w,F)}_addEventKnex(){this._db.on("query-error",this._handleQueryError.bind(this)),this._db.on("query-response",this._handleQueryResponse.bind(this))}}
+export{V as U,D as V};

package/dist/chunk-xcz2fxzt.js

@@ -0,0 +1,2 @@
+import{t as e}from"elysia";var o=e.Object({message:e.String({description:"Message",example:"Microservice Information"}),content:e.Object({author:e.String({description:"Author",example:"Ruby"}),name:e.String({description:"Name",example:"API"}),version:e.String({description:"Version",example:"1.0.0"}),description:e.String({description:"Description",example:"Is a microservice that provides a RESTful API for the application."})})});import{t as i}from"elysia";var s=i.Object({message:i.String({description:"Message",example:"pong"})});
+export{o as fa,s as ga};

package/dist/chunk-yeyzc9n2.js

@@ -0,0 +1,2 @@
+var e={log:"log"};var d={selected:"selected",created:"created",updated:"updated",deleted:"deleted"};
+export{e as ba,d as ca};

package/dist/database/enums/databaseKeyError.d.ts

@@ -0,0 +1,56 @@
+/**
+ * Database error key is a list of errors in the database context.
+ * Each property represents a specific MSSQL error scenario.
+ */
+export declare const databaseKeyError: {
+    /** Error when failing to connect to MSSQL database. */
+    readonly mssqlConnectionError: "core.error.mssql.database.connection_error";
+    /** Error when disconnecting from MSSQL database. */
+    readonly mssqlDisconnectError: "core.error.mssql.database.disconnect_error";
+    /** Error when MSSQL database is not connected. */
+    readonly mssqlNotConnected: "core.error.mssql.database.not_connected";
+    /** Error when no result is returned from MSSQL query. */
+    readonly mssqlNoResult: "core.error.mssql.database.no_result";
+    /** Error when a query fails in MSSQL database. */
+    readonly mssqlQueryError: "core.error.mssql.database.query_error";
+    /** Error when access to MSSQL database is denied. */
+    readonly mssqlDatabaseAccessDenied: "core.error.mssql.database.access_denied";
+    /** Error when MSSQL database authorization fails. */
+    readonly mssqlDatabaseAuthorizationFailed: "core.error.mssql.database.authorization_failed";
+    /** Error when there is a syntax error in MSSQL database. */
+    readonly mssqlDatabaseSyntaxError: "core.error.mssql.database.syntax_error";
+    /** Error when a column is not found in MSSQL database. */
+    readonly mssqlDatabaseColumnNotFound: "core.error.mssql.database.column_not_found";
+    /** Error when a table is not found in MSSQL database. */
+    readonly mssqlTableNotFound: "core.error.mssql.database.table_not_found";
+    /** Error when there is an ambiguous column in MSSQL database. */
+    readonly mssqlDatabaseAmbiguousColumn: "core.error.mssql.database.ambiguous_column";
+    /** Error when there is a duplicate key in MSSQL database. */
+    readonly mssqlDatabaseDuplicateKey: "core.error.mssql.database.duplicate_key";
+    /** Error when there is a foreign key violation in MSSQL database. */
+    readonly mssqlDatabaseForeignKeyViolation: "core.error.mssql.database.foreign_key_violation";
+    /** Error when a unique constraint is violated in MSSQL database. */
+    readonly mssqlDatabaseUniqueConstraintViolation: "core.error.mssql.database.unique_constraint_violation";
+    /** Error when a deadlock is detected in MSSQL database. */
+    readonly mssqlDatabaseDeadlockDetected: "core.error.mssql.database.deadlock_detected";
+    /** Error when a resource is locked in MSSQL database. */
+    readonly mssqlDatabaseResourceLocked: "core.error.mssql.database.resource_locked";
+    /** Error when a transaction is aborted in MSSQL database. */
+    readonly mssqlDatabaseTransactionAborted: "core.error.mssql.database.transaction_aborted";
+    /** Error when there is insufficient memory in MSSQL database. */
+    readonly mssqlDatabaseInsufficientMemory: "core.error.mssql.database.insufficient_memory";
+    /** Error when there is insufficient storage in MSSQL database. */
+    readonly mssqlDatabaseInsufficientStorage: "core.error.mssql.database.insufficient_storage";
+    /** Error when a query times out in MSSQL database. */
+    readonly mssqlDatabaseQueryTimeout: "core.error.mssql.database.query_timeout";
+    /** Error when the transaction log is full in MSSQL database. */
+    readonly mssqlDatabaseTransactionLogFull: "core.error.mssql.database.transaction_log_full";
+    /** Error when data is too large for MSSQL database. */
+    readonly mssqlDatabaseDataTooLarge: "core.error.mssql.database.data_too_large";
+    /** Error when permission is denied in MSSQL database. */
+    readonly mssqlDatabasePermissionDenied: "core.error.mssql.database.permission_denied";
+    /** Error when identity insert is not allowed in MSSQL database. */
+    readonly mssqlDatabaseIdentityInsertNotAllowed: "core.error.mssql.database.identity_insert_not_allowed";
+    /** Error when updating identity column is not allowed in MSSQL database. */
+    readonly mssqlDatabaseCannotUpdateIdentityColumn: "core.error.mssql.database.cannot_update_identity_column";
+};

package/dist/database/enums/index.d.ts

@@ -0,0 +1,2 @@
+export * from './databaseKeyError';
+export * from './mssqlErrorCode';

package/dist/database/enums/index.js

@@ -0,0 +1,2 @@
+// @bun
+import{$ as f,aa as m}from"../../chunk-dppgkz92.js";import"../../chunk-rr6e20n5.js";export{m as mssqlErrorCode,f as databaseKeyError};

package/dist/database/enums/mssqlErrorCode.d.ts

@@ -0,0 +1,25 @@
+/** MSSQL error codes with their corresponding error key. */
+export declare const mssqlErrorCode: {
+    readonly 0: "core.error.mssql.database.query_error";
+    readonly 4060: "core.error.mssql.database.access_denied";
+    readonly 18452: "core.error.mssql.database.authorization_failed";
+    readonly 18456: "core.error.mssql.database.authorization_failed";
+    readonly 102: "core.error.mssql.database.syntax_error";
+    readonly 207: "core.error.mssql.database.column_not_found";
+    readonly 208: "core.error.mssql.database.table_not_found";
+    readonly 209: "core.error.mssql.database.ambiguous_column";
+    readonly 2627: "core.error.mssql.database.duplicate_key";
+    readonly 547: "core.error.mssql.database.foreign_key_violation";
+    readonly 2601: "core.error.mssql.database.unique_constraint_violation";
+    readonly 1205: "core.error.mssql.database.deadlock_detected";
+    readonly 1222: "core.error.mssql.database.resource_locked";
+    readonly 3928: "core.error.mssql.database.transaction_aborted";
+    readonly 701: "core.error.mssql.database.insufficient_memory";
+    readonly 1105: "core.error.mssql.database.insufficient_storage";
+    readonly 8645: "core.error.mssql.database.query_timeout";
+    readonly 9002: "core.error.mssql.database.transaction_log_full";
+    readonly 8152: "core.error.mssql.database.data_too_large";
+    readonly 229: "core.error.mssql.database.permission_denied";
+    readonly 544: "core.error.mssql.database.identity_insert_not_allowed";
+    readonly 8102: "core.error.mssql.database.cannot_update_identity_column";
+};

package/dist/database/events/index.d.ts

@@ -0,0 +1,2 @@
+export * from './mssqlEvent';
+export * from './tableEvent';

package/dist/database/events/index.js

@@ -0,0 +1,2 @@
+// @bun
+import{ba as f,ca as m}from"../../chunk-yeyzc9n2.js";import"../../chunk-rr6e20n5.js";export{m as tableEvent,f as mssqlEvent};

package/dist/database/events/mssqlEvent.d.ts

@@ -0,0 +1,3 @@
+export declare const mssqlEvent: {
+    readonly log: "log";
+};

package/dist/database/events/tableEvent.d.ts

@@ -0,0 +1,6 @@
+export declare const tableEvent: {
+    readonly selected: "selected";
+    readonly created: "created";
+    readonly updated: "updated";
+    readonly deleted: "deleted";
+};

package/dist/database/index.d.ts

@@ -0,0 +1,5 @@
+export * from './enums';
+export * from './events';
+export * from './mssql';
+export * from './table';
+export type * from './types';

package/dist/database/index.js

@@ -0,0 +1,2 @@
+// @bun
+import"./enums/index.js";import"./events/index.js";import{U as s,V as a}from"../chunk-wggj590m.js";import"../chunk-t411e41y.js";import"../chunk-7map0v4a.js";import"../chunk-6sa6shm6.js";import{$ as f,aa as m}from"../chunk-dppgkz92.js";import{ba as x,ca as y}from"../chunk-yeyzc9n2.js";import"../chunk-rr6e20n5.js";export{y as tableEvent,x as mssqlEvent,m as mssqlErrorCode,f as databaseKeyError,s as Table,a as MSSQL};

package/dist/database/mssql.d.ts

@@ -0,0 +1,163 @@
+import { EventEmitter } from 'events';
+import { type Knex } from 'knex';
+import { Repository } from '../repository/repository';
+import { Table } from './table';
+import type { MSSQLDatabaseOptions } from './types/mssqlDatabaseOption';
+/**
+ * Manages the connection with an MSSQL database.
+ * The class extends {@link EventEmitter}.
+ *
+ * - Emits events for logging and table operations.
+ * - Automatically generates repositories and tables for CRUD operations.
+ * - Allows custom repository implementations per table.
+ *
+ * Example usage:
+ * ```typescript
+ * const mssql = new MSSQL(options);
+ * await mssql.connect();
+ * const users = await mssql.getRepository('users').find();
+ * ```
+ */
+export declare class MSSQL extends EventEmitter {
+    /**
+     * Indicates whether the database is connected.
+     */
+    private _isConnected;
+    /**
+     * The name of the database.
+     */
+    private readonly _databaseName;
+    /**
+     * A map of tables in the database.
+     * @see {@link Table}
+     */
+    private readonly _tables;
+    /**
+     * A map of repositories for each table.
+     * @see {@link Repository}
+     */
+    private readonly _repositories;
+    /**
+     * The Knex instance for the database connection.
+     * @see {@link Knex}
+     * @see https://knexjs.org/
+     */
+    private readonly _db;
+    /**
+     * Indicates whether to add basic event listeners for all tables.
+     * @default false
+     */
+    private readonly _pulse;
+    /**
+     * Create a new instance of `MSSQL` with the specified options.
+     * @param options - The configuration options for the MSSQL database connection.
+     * @see {@link MSSQLDatabaseOptions}
+     */
+    constructor(options: MSSQLDatabaseOptions);
+    /**
+     * Establishes a connection to the MSSQL database.
+     *
+     * If the connection is successful, introspection is performed to retrieve information about tables, columns(fields), and primary keys.
+     * This information is used to create instances of {@link Table} and {@link Repository} for each table in the database.
+     *
+     * @throws ({@link CoreError}) Thrown if an error occurs during the connection process. ({@link databaseKeyError.mssqlConnectionError})
+     */
+    connect(): Promise<void>;
+    /**
+     * Closes the connection to the MSSQL database.
+     *
+     * @throws ({@link CoreError}) Thrown if the database is not connected. ({@link databaseKeyError.mssqlNotConnected})
+     * @throws ({@link CoreError}) Thrown if an error occurs during the disconnection process. ({@link databaseKeyError.mssqlDisconnectError})
+     */
+    disconnect(): Promise<void>;
+    /**
+     * Retrieves a repository for a specific table.
+     *
+     * @param tableName - The name of the table to retrieve the repository for.
+     * @param customRepository - Optional custom repository class to use for the table. The class must extend {@link Repository}.
+     *
+     * @throws ({@link CoreError}) Thrown if the database is not connected. ({@link databaseKeyError.mssqlNotConnected})
+     * @throws ({@link CoreError}) Thrown if the specified table is not found. ({@link databaseKeyError.mssqlTableNotFound})
+     *
+     * @template TModel - The type of the model for the repository.
+     * @template TRepo - The repository to retrieve extends {@link Repository}.
+     *
+     * @returns The {@link Repository} for the specified table.
+     */
+    getRepository<TModel, TRepo extends Repository<TModel>>(tableName: string, customRepository: new (knex: Knex, table: Table) => TRepo): TRepo;
+    getRepository<TModel = unknown>(tableName: string): Repository<TModel>;
+    /**
+     * Retrieves a table by name.
+     *
+     * @param tableName - The name of the table to retrieve.
+     *
+     * @throws ({@link CoreError}) Thrown if the database is not connected. ({@link databaseKeyError.mssqlNotConnected})
+     * @throws ({@link CoreError}) Thrown if the specified table is not found. ({@link databaseKeyError.mssqlTableNotFound})
+     *
+     * @returns The {@link Table} object for the specified table.
+    */
+    getTable(tableName: string): Table;
+    /**
+     * Retrieves the name of the database.
+     *
+     * @returns The name of the database.
+     */
+    get databaseName(): string;
+    /**
+     * Retrieves the map of tables in the database.
+     *
+     * @returns A map of table names to {@link Table} instances.
+     */
+    get tables(): Map<string, Table>;
+    /**
+     * Retrieves the map of repositories for each table.
+     *
+     * @returns A map of table names to {@link Repository} instances.
+     */
+    get repositories(): Map<string, Repository>;
+    /**
+     * Indicates whether the database is connected.
+     *
+     * @returns `true` if the database is connected, `false` otherwise.
+     */
+    get isConnected(): boolean;
+    /**
+     * Retrieves the Knex instance for the database connection.
+     *
+     * @throws ({@link CoreError}) Thrown if the database is not connected. ({@link databaseKeyError.mssqlNotConnected})
+     *
+     * @returns The {@link Knex} instance for the database connection.
+     */
+    get db(): Knex;
+    /**
+     * Introspects the database to retrieve information about tables, columns(fields), and primary keys.
+     * Creates instances of {@link Table} and {@link Repository} for each table in the database.
+     */
+    private _introspectDatabase;
+    /**
+     * Extracts table names from a SQL query.
+     *
+     * @param sql - The SQL query string to extract table names from.
+     *
+     * @returns An array of table names found in the SQL query.
+     */
+    private _extractTablesFromSqlQuery;
+    /**
+     * Handles the response from a query and emits the appropriate event based on the method.
+     *
+     * @param response - The response from the query.
+     * @param obj - The query object containing the method and SQL query string.
+     */
+    private _handleQueryResponse;
+    /**
+     * Handles an error from a query and emits the `query:error` event.
+     *
+     * @param error - The error that occurred during the query.
+     * @param query - The query object containing the method and SQL query string.
+     */
+    private _handleQueryError;
+    /**
+     * Adds event listeners to the Knex instance to handle query responses and errors.
+     */
+    private _addEventKnex;
+}

package/dist/database/table.d.ts

@@ -0,0 +1,58 @@
+import EventEmitter from 'events';
+/**
+ * Represents a database table and provides access to its metadata (name, fields, primary key).
+ *
+ * - Emits events for table operations (e.g., SELECTED, CREATED, UPDATED, DELETED).
+ * - Used for query construction and event handling in the database layer.
+ *
+ * Example:
+ * ```typescript
+ * const table = new Table('db', 'users', ['id', 'name'], ['id', 'NUMBER']);
+ * table.on('SELECTED', data => console.log(data));
+ * ```
+ */
+export declare class Table extends EventEmitter {
+    /**
+     * The name of the database that this table belongs to.
+     */
+    private readonly _databaseName;
+    /**
+     * The fields (columns) of the table.
+     */
+    private readonly _fields;
+    /**
+     * The name of the table.
+     */
+    private readonly _name;
+    /**
+     * The primary key of the table, represented as a tuple of field name and type.
+     * The type can be either 'NUMBER' or 'STRING'.
+     */
+    private readonly _primaryKey;
+    /**
+     * Creates an instance of the Table class.
+     *
+     * @param databaseName - The name of the database that this table belongs to.
+     * @param tableName - The name of the table.
+     * @param fields - The fields (columns) of the table.
+     * @param primaryKey - The primary key of the table, represented as a tuple of field name and type.
+     */
+    constructor(databaseName: string, tableName: string, fields: string[], primaryKey: [string, 'NUMBER' | 'STRING']);
+    /**
+     * Gets the name of the database that this table belongs to.
+     */
+    get databaseName(): string;
+    /**
+     * Gets the name of the table.
+     */
+    get name(): string;
+    /**
+     * Gets the fields (columns) of the table.
+     */
+    get fields(): string[];
+    /**
+     * Gets the primary key of the table, represented as a tuple of field name and type.
+     * The type can be either 'NUMBER' or 'STRING'.
+     */
+    get primaryKey(): [string, 'NUMBER' | 'STRING'];
+}

package/dist/database/types/index.d.ts

@@ -0,0 +1,2 @@
+export type * from './mssqlDatabaseOption';
+export type * from './mssqlEventLog';

package/dist/database/types/index.js

@@ -0,0 +1 @@
+// @bun

package/dist/database/types/mssqlDatabaseOption.d.ts

@@ -0,0 +1,92 @@
+/**
+ * Options to configure the MSSQL database connection.
+ *
+ * @example
+ * ```typescript
+ * const options: MSSQLDatabaseOptions = {
+ *   databaseName: 'my_database',
+ *   host: 'localhost',
+ *   port: 1433,
+ *   user: 'sa',
+ *   password: 'Password123',
+ *   encrypt: true,
+ *   poolMin: 5,
+ *   poolMax: 20,
+ *   debug: true,
+ *   pulse: true
+ * };
+ * ```
+ */
+export interface MSSQLDatabaseOptions {
+    /** The name of the database to connect to. */
+    databaseName: string;
+    /** The host of the database server. */
+    host: string;
+    /** The port number for the database connection. */
+    port: number;
+    /** The username for authenticating with the database. */
+    user: string;
+    /** The password for authenticating with the database. */
+    password: string;
+    /**
+     * Whether to encrypt the database connection.
+     * When enabled, communication between the client and server will be encrypted,
+     * providing increased security but potentially slight performance impact.
+     *
+     * @defaultValue true
+     */
+    encrypt?: boolean;
+    /**
+     * Minimum number of connections in the connection pool.
+     * This represents the minimum number of connections that will be maintained in the pool,
+     * even when there is no activity. Higher values can reduce connection latency
+     * but increase resource usage.
+     *
+     * @defaultValue 2
+     */
+    poolMin?: number;
+    /**
+     * Maximum number of connections in the connection pool.
+     * This limits how many concurrent connections can be established to the database.
+     * Setting this too low might cause connection timeouts during high load,
+     * while setting it too high might overload the database server.
+     *
+     * @defaultValue 10
+     */
+    poolMax?: number;
+    /**
+     * The timeout in milliseconds for acquiring a connection.
+     * If a connection cannot be acquired within this timeframe, an error will be thrown.
+     *
+     * @defaultValue 20000
+     */
+    connectionTimeout?: number;
+    /**
+     * Enables debug mode for logging database operations.
+     * When enabled, all SQL queries will be logged with their parameters,
+     * which is valuable for development but may impact performance.
+     *
+     * @defaultValue false
+     */
+    debug?: boolean;
+    /**
+     * If set to true, adds basic event listeners for all tables.
+     * This automatically sets up event listeners to track database operations
+     * (select, create, update, delete) for all tables, allowing for easy monitoring
+     * and event-driven programming.
+     *
+     * [TODO] - Change this section when working on the AND-169 ticket.
+     *
+     * @defaultValue false
+     * @example
+     * ```typescript
+     * const mssql = new MSSQL(options);
+     * await mssql.connect();
+     * // SELECTED, CREATED, UPDATED, DELETED
+     * mssql.table('table_name').on(EVENT_TABLE.SELECTED, (data: unknown) => {
+     *    console.log(data); // data is the response from the query
+     * });
+     * ```
+     */
+    pulse?: boolean;
+}