tspace-mysql 1.8.8-beta.2 → 1.8.8-beta.3

package/README.md

@@ -7,8 +7,9 @@ tspace-mysql is an Object-Relational Mapping (ORM) tool designed to run seamless
 
 ## Feature
 
-| **Feature**                   | **Description**                                                                                          |
-|-------------------------------|----------------------------------------------------------------------------------------------------------|
+| **Feature**                    | **Description**                                                                                         |
+|--------------------------------|---------------------------------------------------------------------------------------------------------|
+| **Supports Driver**            | MySQL ✅ / MariaDB ✅ / Postgres ✅ MSSQL ⏳ / SQLite3 ⏳ / Oracle ⏳                                |
 | **Query Builder**              | Create flexible queries like `SELECT`, `INSERT`, `UPDATE`, and `DELETE`. You can also use raw SQL.      |
 | **Join Clauses**               | Use `INNER JOIN`, `LEFT JOIN`, `RIGHT JOIN`, and `CROSS JOIN` to combine data from multiple tables.     |
 | **Model**                      | Provides a way to interact with database records as objects in code. You can perform create, read, update, and delete (CRUD) operations. Models also support soft deletes and relationship methods. |
@@ -31,8 +32,20 @@ tspace-mysql is an Object-Relational Mapping (ORM) tool designed to run seamless
 Install with [npm](https://www.npmjs.com/):
 
 ```sh
+# Install tspace-mysql locally for your project
 npm install tspace-mysql --save
-npm install tspace-mysql -g
+
+# Install tspace-mysql globally (optional)
+npm install -g tspace-mysql
+
+# Install database drivers if needed:
+# For MariaDB
+npm install mariadb --save
+
+# For PostgreSQL
+npm install pg --save
+
+# MySQL2 driver is installed by default with tspace-mysql
 ```
 
 ## Basic Usage
@@ -77,6 +90,7 @@ npm install tspace-mysql -g
   - [Union](#union)
   - [More Methods](#more-methods)
 - [Database Transactions](#database-transactions)
+- [Race Condition](#race-condition)
 - [Connection](#connection)
 - [Backup](#backup)
 - [Injection](#injection)
@@ -151,6 +165,9 @@ npm install tspace-mysql -g
 To establish a connection, the recommended method for creating your environment variables is by using a '.env' file. using the following:
 
 ```js
+DB_DRIVER = mysql 
+// DB_DRIVER = mariadb
+// DB_DRIVER = postgres
 DB_HOST = localhost;
 DB_PORT = 3306;
 DB_USERNAME = root;
@@ -1262,14 +1279,14 @@ makeCreateTableStatement()
 Within a database transaction, you can utilize the following:
 
 ```js
-const connection = await new DB().beginTransaction();
+const trx = await new DB().beginTransaction();
 
 try {
   /**
    *
    * @startTransaction start transaction in scopes function
    */
-  await connection.startTransaction();
+  await trx.startTransaction();
 
   const user = await new User()
     .create({
@@ -1278,10 +1295,10 @@ try {
     })
     /**
      *
-     * bind method for make sure this connection has same transaction in connection
-     * @params {Function} connection
+     * bind method for make sure this trx has same transaction in trx
+     * @params {Function} trx
      */
-    .bind(connection)
+    .bind(trx)
     .save();
 
   const posts = await new Post()
@@ -1299,17 +1316,17 @@ try {
         title: `tspace-post3`,
       },
     ])
-    .bind(connection) // don't forget this
+    .bind(trx) // don't forget this
     .save();
 
   /**
    *
    * @commit commit transaction to database
    */
-  // After your use commit if use same connection for actions this transction will auto commit
-  await connection.commit();
+  // After your use commit if use same trx for actions this transction will auto commit
+  await trx.commit();
 
-  // If you need to start a new transaction again, just use wait connection.startTransaction();
+  // If you need to start a new transaction again, just use wait trx.startTransaction();
 
   const postsAfterCommited = await new Post()
     .createMultiple([
@@ -1326,25 +1343,137 @@ try {
         title: `tspace-post3`,
       },
     ])
-    // Using this connection now will auto-commit to the database.
-    .bind(connection) // If you need to perform additional operations, use await connection.startTransaction(); again.
+    // Using this trx now will auto-commit to the database.
+    .bind(trx) // If you need to perform additional operations, use await trx.startTransaction(); again.
     .save();
 
    
-    // Do not perform any operations with this connection.
-    // The transaction has already been committed, and the connection is closed.
+    // Do not perform any operations with this trx.
+    // The transaction has already been committed, and the trx is closed.
     // Just ensure everything is handled at the end of the transaction.
-    await connection.end();
+    await trx.end();
   
 } catch (err) {
   /**
    *
    * @rollback rollback transaction
    */
-  await connection.rollback();
+  await trx.rollback();
 }
 ```
 
+## Race Condition
+
+Within a race condition, you can utilize the following:
+
+```js
+
+import { Model, DB }  from 'tspace-mysql'
+
+class Product extends Model {}
+
+class Order extends Model {}
+
+async function purchaseForUpdate({userId , productId , qty } : { 
+  userId: number;
+  productId: number;
+  qty: number 
+}): Promise<void> {
+  const trx = await DB.beginTransaction()
+  try {
+   
+    await trx.startTransaction()
+
+    const product = await new Product()
+    .where('id',productId)
+    .rowLock('FOR_UPDATE') // don't forget this, lock this product for update
+    .bind(trx)
+    .first()
+
+    if (product == null) throw new Error("Product not found");
+
+    if (product.stock < qty) throw new Error("Not enough stock");
+
+    await new Product()
+    .where('id',productId)
+    .update({
+      stock : `${DB.raw('stock')} - ${qty}`,
+      id: productId
+    })
+    .bind(trx)
+    .save()
+
+    await new Order()
+    .create({
+      user_id : userId,
+      product_id : productId,
+      qty
+    })
+    .bind(trx)
+    .save()
+
+    await trx.commit();
+    console.log(`✅ [FOR UPDATE] User ${userId} purchased ${qty}`);
+
+  } catch (err: any) {
+    await trx.rollback();
+    console.log(`❌ [FOR UPDATE] User ${userId} failed: ${err.message}`);
+  } finally {
+    await trx.end();
+  }
+}
+
+async function simulateRaceConnection(): Promise<void> {
+  const MAX_CONNECTION = 500;
+  const TASKS: Function[] = [];
+  const STOCK = MAX_CONNECTION * 10
+
+  await new Product()
+  .where('id',1)
+  .update({
+    stock : STOCK,
+  })
+  .save()
+
+  const successes : number[] = []
+  const fails     : number[] = []
+  let purchased   : number = 0
+  let outOfStock  : number = 0
+  for (let i = 1; i <= MAX_CONNECTION; i++) {
+    TASKS.push(async () => {
+      const qty = Math.floor(Math.random() * 30) + 1 
+      await purchaseForUpdate({
+        userId : i, 
+        productId : 1 , 
+        qty
+      })
+      .then(_ => {
+        successes.push(1)
+        purchased += qty
+      })
+      .catch(_ => {
+        fails.push(1)
+        outOfStock += qty
+      })
+    });
+  }
+
+  console.log("=== Simulation ===");
+  const start = Date.now();
+  await Promise.all(TASKS.map(v => v()));
+  const end = Date.now();
+  console.log(`USING TIME TO TEST IN ${end - start} ms`)
+  console.log(`ALL STOCK: ${STOCK} qty`)
+  console.log(`✅ [SUCCESS(${successes.length})] [Purchased]: ${purchased} qty`);
+  console.log(`❌ [FAIL(${fails.length})] [OutOfStock]: ${outOfStock} qty`);
+  console.log('======== DONE ============')
+  process.exit(0)
+}
+
+simulateRaceConnection();
+
+```
+
 ## Connection
 
 When establishing a connection, you can specify options as follows:
@@ -3253,6 +3382,7 @@ const schema = {
   username  : Blueprint.varchar(255).notNull(),
   password  : Blueprint.varchar(255).notNull(),
   status    : Blueprint.tinyInt().notNull().default(0),
+  role      : Blueprint.enum('admin','user').default('user'),
   createdAt : Blueprint.timestamp().null(),
   updatedAt : Blueprint.timestamp().null()
 }
@@ -3263,8 +3393,6 @@ class User extends Model<TS>  {
   constructor() {
     super()
     this.useSchema(schema)
-    this.useUUID()
-    this.useTimestamp()
   }
 }
 
@@ -3280,22 +3408,9 @@ const hasColumn     = meta.hasColumn('idx') // false
 const primaryKey    = meta.primaryKey() // 'id'
 const indexes       = meta.indexes() // ['users.email@index']
 const nullable      = meta.nullable() // ['uuid','name','createdAt','updatedAt']
-const defaults      = meta.defaults() // { status : 0 }
-
-console.log({
-  table,
-  column,
-  columnRef,
-  columnTypeOf,
-  columnType,
-  columns,
-  hasColumn,
-  primaryKey,
-  indexes,
-  nullable,
-  defaults
-})
-
+const defaults      = meta.defaults() // { id : null, uuid : null, ..., status : 0, role: 'user' ,..updatedAt : null  }
+const enums         = meta.enums('role') // [ 'admin', 'user' ]
+const enumsObj      = meta.enum('role', { asObject: true }) // { admin: 'admin', user: 'user' }
 ```
 
 ## Repository

package/build/lib/config/index.d.ts

@@ -0,0 +1,28 @@
+export declare const loadOptionsEnvironment: () => {
+    readonly host: string | undefined;
+    readonly port: string | 3306;
+    readonly username: string | undefined;
+    readonly password: string;
+    readonly database: string | undefined;
+};
+declare const _default: Readonly<{
+    readonly DRIVER: string;
+    readonly HOST: string;
+    readonly PORT: string | 3306;
+    readonly USERNAME: string | undefined;
+    readonly PASSWORD: string;
+    readonly DATABASE: string | undefined;
+    readonly CONNECTION_LIMIT: string | 20;
+    readonly QUEUE_LIMIT: string | 0;
+    readonly TIMEOUT: string | number;
+    readonly CHARSET: string;
+    readonly CONNECTION_ERROR: string | false;
+    readonly CONNECTION_SUCCESS: string | false;
+    readonly WAIT_FOR_CONNECTIONS: string | true;
+    readonly DATE_STRINGS: string | false;
+    readonly KEEP_ALIVE_DELAY: string | 0;
+    readonly ENABLE_KEEP_ALIVE: string | true;
+    readonly MULTIPLE_STATEMENTS: string | false;
+    readonly CACHE: string;
+}>;
+export default _default;

package/build/lib/config/index.js

@@ -0,0 +1,89 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.loadOptionsEnvironment = void 0;
+const tools_1 = require("../tools");
+const dotenv_1 = __importDefault(require("dotenv"));
+const environment = () => {
+    const NODE_ENV = process.env?.NODE_ENV;
+    const env = tools_1.Tool.path.join(tools_1.Tool.path.resolve(), '.env');
+    if (NODE_ENV == null)
+        return env;
+    const envWithEnviroment = tools_1.Tool.path.join(tools_1.Tool.path.resolve(), `.env.${NODE_ENV}`);
+    if (tools_1.Tool.fs.existsSync(envWithEnviroment))
+        return envWithEnviroment;
+    return env;
+};
+dotenv_1.default.config({ path: environment() });
+const ENV = process.env;
+const rawEnv = {
+    DRIVER: ENV.DB_DRIVER ?? 'mysql2',
+    HOST: ENV.DB_HOST ?? 'localhost',
+    PORT: ENV.DB_PORT ?? 3306,
+    USERNAME: ENV.DB_USERNAME ?? ENV.DB_USER,
+    PASSWORD: ENV.DB_PASSWORD ?? '',
+    DATABASE: ENV.DB_DATABASE,
+    CONNECTION_LIMIT: ENV.DB_CONNECTION_LIMIT ?? 20,
+    QUEUE_LIMIT: ENV.DB_QUEUE_LIMIT ?? 0,
+    TIMEOUT: ENV.DB_TIMEOUT ?? 1000 * 120,
+    CHARSET: ENV.DB_CHARSET ?? 'utf8mb4',
+    CONNECTION_ERROR: ENV.DB_CONNECTION_ERROR ?? false,
+    CONNECTION_SUCCESS: ENV.DB_CONNECTION_SUCCESS ?? false,
+    WAIT_FOR_CONNECTIONS: ENV.DB_WAIT_FOR_CONNECTIONS ?? true,
+    DATE_STRINGS: ENV.DB_DATE_STRINGS ?? false,
+    KEEP_ALIVE_DELAY: ENV.DB_KEEP_ALIVE_DELAY ?? 0,
+    ENABLE_KEEP_ALIVE: ENV.DB_ENABLE_KEEP_ALIVE ?? true,
+    MULTIPLE_STATEMENTS: ENV.DB_MULTIPLE_STATEMENTS ?? false,
+    CACHE: ENV.DB_CACHE ?? 'memory'
+};
+const parseEnv = (env) => {
+    const parsed = {};
+    for (const [key, value] of Object.entries(env)) {
+        if (value == null)
+            continue;
+        if (value === '') {
+            parsed[key] = value;
+            continue;
+        }
+        if (!isNaN(Number(value))) {
+            (parsed)[key] = Number(value);
+            continue;
+        }
+        if (typeof value === 'string' && (value.toLowerCase() === 'true' || value.toLowerCase() === 'false')) {
+            (parsed)[key] = value.toLowerCase() === 'true';
+            continue;
+        }
+        parsed[key] = value;
+    }
+    return parsed;
+};
+const env = parseEnv(rawEnv);
+const loadOptionsEnvironment = () => {
+    const environment = () => {
+        const NODE_ENV = process.env?.NODE_ENV;
+        const env = tools_1.Tool.path.join(tools_1.Tool.path.resolve(), '.env');
+        if (NODE_ENV == null)
+            return env;
+        const envWithEnviroment = tools_1.Tool.path.join(tools_1.Tool.path.resolve(), `.env.${NODE_ENV}`);
+        if (tools_1.Tool.fs.existsSync(envWithEnviroment))
+            return envWithEnviroment;
+        return env;
+    };
+    dotenv_1.default.config({ path: environment() });
+    const ENV = process.env;
+    const rawEnv = {
+        host: ENV?.DB_HOST || ENV?.TSPACE_HOST,
+        port: ENV?.DB_PORT || ENV?.TSPACE_PORT || 3306,
+        username: ENV?.DB_USERNAME || ENV?.TSPACE_USERNAME,
+        password: ENV?.DB_PASSWORD || ENV?.TSPACE_PASSWORD || '',
+        database: ENV?.DB_DATABASE || ENV?.TSPACE_DATABASE,
+    };
+    //@ts-ignore
+    const env = parseEnv(rawEnv);
+    return Object.freeze(env);
+};
+exports.loadOptionsEnvironment = loadOptionsEnvironment;
+exports.default = Object.freeze(env);
+//# sourceMappingURL=index.js.map

package/build/lib/config/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/config/index.ts"],"names":[],"mappings":"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"}

package/build/lib/constants/index.d.ts

@@ -87,6 +87,7 @@ declare const CONSTANTS: Readonly<{
     ADD_CONSTRAINT: "ADD CONSTRAINT";
     AFTER: "AFTER";
     ALTER_TABLE: "ALTER TABLE";
+    ALTER_COLUMN: "ALTER COLUMN";
     IFNULL: "IFNULL";
     JSON_ARRAY: "JSON_ARRAY";
     JSON_ARRAYAGG: "JSON_ARRAYAGG";
@@ -99,11 +100,17 @@ declare const CONSTANTS: Readonly<{
         hasMany: string;
         belongsTo: string;
         belongsToMany: string;
+        belongsToManySingle: string;
     };
     PATTERN: {
+        maybeSnake_case: string;
         snake_case: string;
         camelCase: string;
     };
+    ROW_LEVEL_LOCK: {
+        update: string;
+        share: string;
+    };
 }>;
 export { CONSTANTS };
 export default CONSTANTS;

package/build/lib/constants/index.js

@@ -90,6 +90,7 @@ const CONSTANTS = Object.freeze({
     ADD_CONSTRAINT: 'ADD CONSTRAINT',
     AFTER: 'AFTER',
     ALTER_TABLE: 'ALTER TABLE',
+    ALTER_COLUMN: 'ALTER COLUMN',
     IFNULL: 'IFNULL',
     JSON_ARRAY: 'JSON_ARRAY',
     JSON_ARRAYAGG: 'JSON_ARRAYAGG',
@@ -101,11 +102,17 @@ const CONSTANTS = Object.freeze({
         hasOne: 'hasOne',
         hasMany: 'hasMany',
         belongsTo: 'belongsTo',
-        belongsToMany: 'belongsToMany'
+        belongsToMany: 'belongsToMany',
+        belongsToManySingle: 'belongsToManySingle'
     },
     PATTERN: {
+        maybeSnake_case: 'maybeSnake_case',
         snake_case: 'snake_case',
         camelCase: 'camelCase'
+    },
+    ROW_LEVEL_LOCK: {
+        update: 'FOR UPDATE',
+        share: 'LOCK IN SHARE MODE'
     }
 });
 exports.CONSTANTS = CONSTANTS;

package/build/lib/constants/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/constants/index.ts"],"names":[],"mappings":";;;AAAA,MAAM,SAAS,GAAG,MAAM,CAAC,MAAM,CAAC;IAC5B,EAAE,EAAG,IAAI;IACT,IAAI,EAAG,MAAM;IACb,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAG,QAAQ;IACjB,OAAO,EAAG,SAAS;IACnB,MAAM,EAAG,QAAQ;IACjB,KAAK,EAAG,OAAO;IACf,OAAO,EAAG,SAAS;IACnB,WAAW,EAAG,aAAa;IAC3B,GAAG,EAAG,KAAK;IACX,IAAI,EAAG,MAAM;IACb,OAAO,EAAE,SAAS;IAClB,WAAW,EAAC,aAAa;IACzB,EAAE,EAAG,IAAI;IACT,IAAI,EAAG,MAAM;IACb,MAAM,EAAG,QAAQ;IACjB,QAAQ,EAAG,UAAU;IACrB,IAAI,EAAG,MAAM;IACb,MAAM,EAAG,QAAQ;IACjB,QAAQ,EAAG,UAAU;IACrB,YAAY,EAAC,cAAc;IAC3B,QAAQ,EAAG,UAAU;IACrB,IAAI,EAAG,MAAM;IACb,GAAG,EAAG,KAAK;IACX,UAAU,EAAG,YAAY;IACzB,SAAS,EAAG,WAAW;IACvB,UAAU,EAAG,YAAY;IACzB,UAAU,EAAG,YAAY;IACzB,EAAE,EAAG,IAAI;IACT,KAAK,EAAG,OAAO;IACf,MAAM,EAAG,QAAQ;IACjB,KAAK,EAAG,OAAO;IACf,GAAG,EAAG,KAAK;IACX,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,EAAE,EAAG,IAAI;IACT,EAAE,EAAG,GAAG;IACR,MAAM,EAAG,IAAI;IACb,EAAE,EAAG,IAAI;IACT,MAAM,EAAG,QAAQ;IACjB,GAAG,EAAE,KAAK;IACV,GAAG,EAAE,KAAK;IACV,GAAG,EAAG,KAAK;IACX,GAAG,EAAG,KAAK;IACX,SAAS,EAAG,WAAW;IACvB,GAAG,EAAE,KAAK;IACV,GAAG,EAAG,OAAO;IACb,EAAE,EAAG,MAAM;IACX,MAAM,EAAG,UAAU;IACnB,KAAK,EAAG,SAAS;IACjB,MAAM,EAAG,SAAS;IAClB,IAAI,EAAG,MAAM;IACb,IAAI,EAAG,MAAM;IACb,IAAI,EAAG,MAAM;IACb,IAAI,EAAG,MAAM;IACb,GAAG,EAAG,KAAK;IACX,gBAAgB,EAAG,kBAAkB;IACrC,MAAM,EAAE,QAAQ;IAChB,MAAM,EAAG,QAAQ;IACjB,MAAM,EAAG,QAAQ;IACjB,MAAM,EAAG,QAAQ;IACjB,MAAM,EAAG,aAAa;IACtB,UAAU,EAAG,YAAY;IACzB,SAAS,EAAE,qBAAqB;IAChC,cAAc,EAAG,gBAAgB;IACjC,eAAe,EAAG,iBAAiB;IACnC,WAAW,EAAE,aAAa;IAC1B,cAAc,EAAI,gBAAgB;IAClC,WAAW,EAAG,aAAa;IAC3B,0BAA0B,EAAG,+BAA+B;IAC5D,YAAY,EAAG,cAAc;IAC7B,uBAAuB,EAAG,4BAA4B;IACtD,YAAY,EAAG,cAAc;IAC7B,MAAM,EAAC,wDAAwD;IAC/D,OAAO,EAAE,SAAS;IAClB,IAAI,EAAG,QAAQ;IACf,cAAc,EAAE,gBAAgB;IAChC,WAAW,EAAG,aAAa;IAC3B,WAAW,EAAG,aAAa;IAC3B,UAAU,EAAG,YAAY;IACzB,SAAS,EAAG,WAAW;IACvB,SAAS,EAAG,WAAW;IACvB,GAAG,EAAG,KAAK;IACX,MAAM,EAAG,QAAQ;IACjB,cAAc,EAAG,gBAAgB;IACjC,KAAK,EAAG,OAAO;IACf,WAAW,EAAG,aAAa;IAC3B,MAAM,EAAG,QAAQ;IACjB,UAAU,EAAG,YAAY;IACzB,aAAa,EAAG,eAAe;IAC/B,WAAW,EAAG,aAAa;IAC3B,KAAK,EAAG,OAAO;IACf,SAAS,EAAG,WAAW;IACvB,IAAI,EAAE,MAAM;IACZ,YAAY,EAAG;QACX,MAAM,EAAG,QAAQ;QACjB,OAAO,EAAG,SAAS;QACnB,SAAS,EAAG,WAAW;QACvB,aAAa,EAAG,eAAe;KAClC;IACD,OAAO,EAAG;QACN,UAAU,EAAG,YAAY;QACzB,SAAS,EAAG,WAAW;KAC1B;CACJ,CAAC,CAAA;AAEO,8BAAS;AAClB,kBAAe,SAAS,CAAA"}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/lib/constants/index.ts"],"names":[],"mappings":"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"}

package/build/lib/core/Abstracts/AbstractBuilder.d.ts

@@ -5,12 +5,15 @@ import type { TPagination, TConstant } from '../../types';
 declare abstract class AbstractBuilder {
     protected $setters: string[];
     protected $utils: TUtils;
+    protected $database: string;
+    protected $driver: string;
     protected $constants: (name?: keyof TConstant) => any;
     protected $state: StateHandler;
     protected $pool: {
         query: Function;
         set: Function;
         get: Function;
+        queryBuilder: Function;
     };
     protected $logger: {
         get: Function;

package/build/lib/core/Abstracts/AbstractBuilder.js

@@ -1,6 +1,10 @@
 "use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.AbstractBuilder = void 0;
+const config_1 = __importDefault(require("../../config"));
 class AbstractBuilder {
     $setters = [
         '$attributes',
@@ -12,12 +16,15 @@ class AbstractBuilder {
         '$relation'
     ];
     $utils;
+    $database = String(config_1.default.DATABASE ?? '');
+    $driver = String(config_1.default.DRIVER ?? 'mysql');
     $constants;
     $state;
     $pool = {
         query: (sql) => { },
         set: (pool) => { },
-        get: () => { }
+        get: () => { },
+        queryBuilder: () => { }
     };
     $logger = {
         get: () => { },

package/build/lib/core/Abstracts/AbstractBuilder.js.map

@@ -1 +1 @@
-{"version":3,"file":"AbstractBuilder.js","sourceRoot":"","sources":["../../../../src/lib/core/Abstracts/AbstractBuilder.ts"],"names":[],"mappings":";;;AAOA,MAAe,eAAe;IAEhB,QAAQ,GAAG;QACjB,aAAa;QACb,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,WAAW;KACd,CAAA;IAES,MAAM,CAAU;IAEhB,UAAU,CAAoC;IAE9C,MAAM,CAAgB;IAEtB,KAAK,GAA2D;QACtE,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,GAAE,CAAC;QAC1B,GAAG,EAAE,CAAC,IAAU,EAAE,EAAE,GAAE,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;KAChB,CAAA;IAES,OAAO,GAA8G;QAC3H,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE,GAAE,CAAC;QAC3B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK;KAC3C,CAAA;IAES,WAAW,CAA6B;CA0FrD;AAES,0CAAe;AACzB,kBAAe,eAAe,CAAA"}
+{"version":3,"file":"AbstractBuilder.js","sourceRoot":"","sources":["../../../../src/lib/core/Abstracts/AbstractBuilder.ts"],"names":[],"mappings":";;;;;;AAGA,0DAA4C;AAK5C,MAAe,eAAe;IAEhB,QAAQ,GAAG;QACjB,aAAa;QACb,SAAS;QACT,QAAQ;QACR,YAAY;QACZ,OAAO;QACP,QAAQ;QACR,WAAW;KACd,CAAA;IAES,MAAM,CAAU;IAEhB,SAAS,GAAY,MAAM,CAAC,gBAAM,CAAC,QAAQ,IAAI,EAAE,CAAC,CAAA;IAClD,OAAO,GAAY,MAAM,CAAC,gBAAM,CAAC,MAAM,IAAI,OAAO,CAAC,CAAA;IAEnD,UAAU,CAAoC;IAE9C,MAAM,CAAgB;IAEtB,KAAK,GAAmF;QAC9F,KAAK,EAAE,CAAC,GAAW,EAAE,EAAE,GAAE,CAAC;QAC1B,GAAG,EAAE,CAAC,IAAU,EAAE,EAAE,GAAE,CAAC;QACvB,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,YAAY,EAAE,GAAG,EAAE,GAAE,CAAC;KACzB,CAAA;IAES,OAAO,GAA8G;QAC3H,GAAG,EAAE,GAAG,EAAE,GAAE,CAAC;QACb,GAAG,EAAE,CAAC,KAAc,EAAE,EAAE,GAAE,CAAC;QAC3B,KAAK,EAAE,GAAG,EAAE,GAAE,CAAC;QACf,KAAK,EAAE,CAAC,KAAc,EAAE,EAAE,CAAC,IAAI,IAAI,KAAK;KAC3C,CAAA;IAES,WAAW,CAA6B;CA0FrD;AAES,0CAAe;AACzB,kBAAe,eAAe,CAAA"}

package/build/lib/core/Abstracts/AbstractDB.d.ts

@@ -1,5 +1,5 @@
 import Builder from '../Builder';
-import type { TConnection, TConnectionOptions, TConnectionTransaction } from '../../types';
+import type { TPoolConnected, TConnectionOptions, TConnectionTransaction } from '../../types';
 declare abstract class AbstractDB extends Builder {
     abstract beginTransaction(): Promise<TConnectionTransaction>;
     abstract generateUUID(): string;
@@ -15,7 +15,7 @@ declare abstract class AbstractDB extends Builder {
         when: string;
         then: string;
     }[], final?: string): string | [];
-    abstract getConnection(options: TConnectionOptions): Promise<TConnection>;
+    abstract getConnection(options: TConnectionOptions): Promise<TPoolConnected>;
 }
 export { AbstractDB };
 export default AbstractDB;

package/build/lib/core/Blueprint.d.ts

@@ -1,9 +1,10 @@
 import { Model } from "./Model";
+type NoType = {};
 /**
  * Class 'Blueprint' is used to make the schema for table
  * @example
  *   import { Schema , Blueprint }  from 'tspace-mysql'
-import sql from '../../../build/lib/core/SqlLike';
+ *   import sql from '../../../build/lib/core/SqlLike';
  *   await new Schema().table('users',{
  *      id          : Blueprint.int().notNull().primary().autoIncrement(),
  *      name        : Blueprint.varchar(255).default('my name'),
@@ -15,13 +16,15 @@ import sql from '../../../build/lib/core/SqlLike';
  *      deleted_at  : Blueprint.timestamp().null()
  *   })
  */
-declare class Blueprint<T = any> {
+declare class Blueprint<T = any, S = NoType> {
+    private _default;
     private _enum;
     private _type;
     private _attributes;
     private _foreignKey;
     private _index;
     private _column;
+    private _isVirtual;
     private _sql;
     private _valueType;
     /**
@@ -427,7 +430,6 @@ declare class Blueprint<T = any> {
      * @return {Blueprint<T>} Blueprint
      */
     index(name?: string): Blueprint<T>;
-    bindColumn(column: string): this;
     get sql(): {
         select?: string | undefined;
         where?: string | undefined;
@@ -440,6 +442,9 @@ declare class Blueprint<T = any> {
     get foreignKey(): Record<string, any> | null;
     get indexKey(): string | null;
     get valueType(): DateConstructor | NumberConstructor | StringConstructor | BooleanConstructor;
+    get valueEnum(): string[];
+    get valueDefault(): unknown;
+    get isVirtual(): boolean;
     private _addAssignType;
     private _addAssignAttribute;
 }

package/build/lib/core/Blueprint.js

@@ -5,7 +5,7 @@ exports.Blueprint = void 0;
  * Class 'Blueprint' is used to make the schema for table
  * @example
  *   import { Schema , Blueprint }  from 'tspace-mysql'
-import sql from '../../../build/lib/core/SqlLike';
+ *   import sql from '../../../build/lib/core/SqlLike';
  *   await new Schema().table('users',{
  *      id          : Blueprint.int().notNull().primary().autoIncrement(),
  *      name        : Blueprint.varchar(255).default('my name'),
@@ -18,12 +18,14 @@ import sql from '../../../build/lib/core/SqlLike';
  *   })
  */
 class Blueprint {
+    _default = null;
     _enum = [];
     _type = "INT";
     _attributes = [];
     _foreignKey = null;
     _index = null;
     _column = null;
+    _isVirtual = false;
     _sql = null;
     _valueType;
     /**
@@ -41,6 +43,7 @@ class Blueprint {
      */
     virtualColumn(sql) {
         const instance = new Blueprint();
+        instance._isVirtual = true;
         if (typeof sql === "object" && sql !== null) {
             instance._sql = sql;
             return instance;
@@ -575,13 +578,16 @@ class Blueprint {
     default(value) {
         if (typeof value === 'boolean') {
             this._addAssignAttribute(`DEFAULT ${value ? 1 : 0}`);
+            this._default = value ? 1 : 0;
             return this;
         }
         if (typeof value === 'number') {
             this._addAssignAttribute(`DEFAULT ${value}`);
+            this._default = value;
             return this;
         }
         this._addAssignAttribute(`DEFAULT '${value}'`);
+        this._default = `${value}`;
         return this;
     }
     /**
@@ -590,8 +596,7 @@ class Blueprint {
      * @return {Blueprint<T>} Blueprint
      */
     defaultValue(value) {
-        this.default(value);
-        return this;
+        return this.default(value);
     }
     /**
      * Assign attributes 'default currentTimestamp' in table
@@ -655,10 +660,6 @@ class Blueprint {
         this._index = name;
         return this;
     }
-    bindColumn(column) {
-        this._column = column;
-        return this;
-    }
     get sql() {
         return this._sql;
     }
@@ -680,6 +681,15 @@ class Blueprint {
     get valueType() {
         return this._valueType;
     }
+    get valueEnum() {
+        return this._enum;
+    }
+    get valueDefault() {
+        return this._default;
+    }
+    get isVirtual() {
+        return this._isVirtual;
+    }
     _addAssignType(type) {
         this._type = type;
         return this;