duckdb-tinyorm 1.0.44 → 2.0.1

package/README.md

@@ -1,80 +1,420 @@
-# DuckDB Tiny ORM
+# 🦆 DuckDB TinyORM
 
-Usage:
+A lightweight, TypeScript-friendly ORM designed specifically for DuckDB, focusing on simplicity and ease of use.
+
+## 📋 Table of Contents
+
+- [🦆 DuckDB TinyORM](#-duckdb-tinyorm)
+  - [📋 Table of Contents](#-table-of-contents)
+  - [📥 Installation](#-installation)
+  - [🚀 Quick Start](#-quick-start)
+  - [✨ Core Features](#-core-features)
+  - [🏗️ Entity Definition](#️-entity-definition)
+    - [🔧 Column Options](#-column-options)
+  - [📚 Repository Pattern](#-repository-pattern)
+  - [💾 Data Operations](#-data-operations)
+    - [✏️ Create](#️-create)
+    - [🔍 Read](#-read)
+    - [🔄 Update](#-update)
+    - [🗑️ Delete](#️-delete)
+  - [🔧 Query Builder](#-query-builder)
+  - [🔒 Transactions](#-transactions)
+  - [📊 Data Export](#-data-export)
+  - [🧠 Advanced Usage](#-advanced-usage)
+    - [🛠️ Custom Repositories](#️-custom-repositories)
+    - [⚙️ DuckDB Database Configuration](#️-duckdb-database-configuration)
+  - [📘 API Reference](#-api-reference)
+    - [🏷️ Decorators](#️-decorators)
+    - [🔙 Legacy Decorators (backward compatibility)](#-legacy-decorators-backward-compatibility)
+    - [🧰 Repository Methods](#-repository-methods)
+  - [📜 License](#-license)
+
+## 📥 Installation
+
+```bash
+npm install duckdb-tinyorm
+# or
+yarn add duckdb-tinyorm
+```
+
+DuckDB TinyORM requires `reflect-metadata` for decorator support:
+
+```bash
+npm install reflect-metadata
+# or
+yarn add reflect-metadata
+```
+
+Make sure to import `reflect-metadata` at the beginning of your application:
 
 ```typescript
 import 'reflect-metadata';
-import { DuckDbRepository, Entity, Repository, DataTypeDecorator, BaseRepository, Id ,DuckDbLocation, DuckDbConfig } from 'duckdb-tinyorm';
+```
 
+## 🚀 Quick Start
 
+```typescript
+import 'reflect-metadata';
+import { 
+  DuckDbRepository, 
+  Entity, 
+  Column, 
+  Repository, 
+  BaseRepository, 
+  DuckDbLocation 
+} from 'duckdb-tinyorm';
 
-//create instance in memory or use File, if File is specfied need to specify the filename
-const duckDbRepository: DuckDbRepository = DuckDbRepository.getInstances({name: 'default', location: DuckDbLocation.Memory, filename: undefined})
+// Initialize DuckDB repository (in-memory)
+const duckDbRepository = DuckDbRepository.getInstances({
+  name: 'default',
+  location: DuckDbLocation.Memory
+});
 
-@Entity
-export class Subject {
+// Define your entity
+@Entity({ name: 'products' })
+class Product {
+  @Column({
+    type: 'INTEGER',
+    primaryKey: true,
+    autoIncrement: true
+  })
+  Id!: number;
+  
+  @Column({
+    type: 'VARCHAR',
+    notNull: true
+  })
+  Name!: string;
+  
+  @Column({
+    type: 'DOUBLE',
+    notNull: true
+  })
+  Price!: number;
+  
+  constructor(name: string = "", price: number = 0) {
+    this.Name = name;
+    this.Price = price;
+  }
+}
+
+// Create a repository for your entity
+@Repository(Product)
+class ProductRepository extends BaseRepository<Product, number> {
+  constructor() {
+    super(duckDbRepository);
+  }
+}
 
-    constructor(id: string = "", name?: string, description?: string, year: number = (new Date()).getFullYear()) {
-        this.Id = id;
-        this.Name = name;
-        this.Description = description;
-        this.Year = year;
-    }
+// Use the repository
+async function main() {
+  const productRepo = new ProductRepository();
+  await productRepo.init(); // Initialize the repository (creates the table)
+  
+  // Create and save a new product
+  const product = new Product("Laptop", 999.99);
+  const savedProduct = await productRepo.save(product);
+  console.log(`Created product with ID: ${savedProduct.Id}`);
+  
+  // Query products
+  const allProducts = await productRepo.findAll();
+  console.table(allProducts);
+}
+
+main();
+```
 
-    @Id()
-    @DataTypeDecorator('VARCHAR')
-    Id: string ;
+## ✨ Core Features
 
-    @DataTypeDecorator('VARCHAR')
-    Name?: string;
+- 🚀 **Modern TypeScript Support**: Full TypeScript integration with decorators
+- 🗃️ **Entity-Relationship Mapping**: Map your classes to DuckDB tables
+- 📚 **Repository Pattern**: Type-safe data access operations
+- 📝 **SQL Generation**: Automatic SQL query generation
+- 🔒 **Transaction Support**: ACID-compliant transaction handling
+- 🔍 **Query Builder**: Fluent API for building complex queries
+- 📊 **Data Export**: Export data to CSV, JSON, and Parquet formats
+- 📄 **Pagination**: Built-in support for paginating large datasets
 
+## 🏗️ Entity Definition
 
-    @DataTypeDecorator('VARCHAR')
-    Description?: string;
+Entities represent tables in your database. Use decorators to define your entity schema:
 
+```typescript
+@Entity({ name: 'subjects' }) // Optional table name (defaults to class name)
+export class Subject {
+  @Column({
+    type: 'INTEGER',
+    primaryKey: true,
+    autoIncrement: true
+  })
+  Id!: number;
 
-    @DataTypeDecorator('INT')
-    Year: number;
+  @Column({
+    type: 'VARCHAR',
+    notNull: true,
+    unique: true
+  })
+  Code!: string;
 
+  @Column({
+    type: 'VARCHAR',
+    notNull: true
+  })
+  Name!: string;
+
+  @Column({
+    type: 'TEXT'
+  })
+  Description?: string;
+
+  @Column({
+    type: 'INT',
+    defaultValue: new Date().getFullYear(),
+    check: 'Year >= 2000'
+  })
+  Year!: number;
+
+  constructor(code: string = "", name: string = "", description?: string, year: number = new Date().getFullYear()) {
+    this.Code = code;
+    this.Name = name;
+    this.Description = description;
+    this.Year = year;
+  }
 }
+```
+
+### 🔧 Column Options
 
+- 📊 `type`: SQL data type ('INTEGER', 'VARCHAR', 'DOUBLE', etc.)
+- 🔑 `primaryKey`: Defines a primary key column
+- 🔢 `autoIncrement`: Auto-increments the column value
+- ⚠️ `notNull`: Adds NOT NULL constraint
+- 🎯 `unique`: Adds UNIQUE constraint
+- 🏷️ `defaultValue`: Sets a default value
+- ✅ `check`: Adds a CHECK constraint
+
+## 📚 Repository Pattern
+
+Repositories provide data access operations for entities:
+
+```typescript
 @Repository(Subject)
-class SubjectRepository extends BaseRepository<Subject, string> {
-    constructor() {
-        super(duckDbRepository);
-    }
+class SubjectRepository extends BaseRepository<Subject, number> {
+  constructor() {
+    super(duckDbRepository);
+  }
+  
+  // Add custom methods specific to this entity
+  async findByCode(code: string): Promise<Subject | null> {
+    const query = `SELECT * FROM main.${this.tableName} WHERE Code='${code}'`;
+    const result = await this.repository.executeQuery(query);
+    return result.length > 0 ? result[0] : null;
+  }
 }
+```
 
+## 💾 Data Operations
 
-async function test() {
-    const subjectRepository = new SubjectRepository();
-    await subjectRepository.init();
+### ✏️ Create
 
-    const subject1 = new Subject('JB', "Java Basic", "Java Basic", 2024);
-    const subject2 = new Subject('OOP', "Java OOP", "Java Object Oriented Programming", 2024);
+```typescript
+const subject = new Subject('CS101', 'Computer Science', 'Introduction to CS', 2024);
+const savedSubject = await subjectRepository.save(subject);
+console.log(`Created with ID: ${savedSubject.Id}`);
+
+// Bulk insert
+const subjects = [
+  new Subject('CS102', 'Data Structures', 'Advanced data structures', 2024),
+  new Subject('CS103', 'Algorithms', 'Algorithm design', 2024)
+];
+await subjectRepository.saveAll(subjects);
+```
+
+### 🔍 Read
+
+```typescript
+// Find by ID
+const subject = await subjectRepository.findById(1);
 
+// Find all
+const allSubjects = await subjectRepository.findAll();
 
-    //save records (as for now just insert a new record)
-    await subjectRepository.save(subject1);
-    await subjectRepository.save(subject2);
+// Find with criteria
+const subjects2024 = await subjectRepository.findBy({ Year: 2024 }, ["Year"]);
 
-    //find all records
-    const result = await subjectRepository.findAll();
-    console.table(result);
+// Pagination
+const page = await subjectRepository.findWithPagination({ page: 0, size: 10 });
+console.log(`Found ${page.totalElements} subjects across ${page.totalPages} pages`);
+```
 
-    //find records by primary key
-    const subjectFound1: Subject = await subjectRepository.findById("JB");
-    console.info(subjectFound1);
-    const subjectFound2: Subject = await subjectRepository.findById("OOP");
-    console.info(subjectFound2);
+### 🔄 Update
 
-    //delete one record by primary key
+```typescript
+subject.Description = "Updated description";
+await subjectRepository.save(subject);
+```
 
-    await subjectRepository.removeById("JB");
+### 🗑️ Delete
 
-    const amenities = await subjectRepository.findBy({ Year: 2024 }, ["Year"]);
-    console.table(amenities);
+```typescript
+// Delete by ID
+await subjectRepository.removeById(1);
+
+// Custom delete method
+await subjectRepository.removeByCode("CS101");
+
+// Delete all
+await subjectRepository.removeAll();
+```
+
+## 🔧 Query Builder
+
+Build complex queries with the fluent query builder API:
+
+```typescript
+const queryBuilder = await subjectRepository.createQueryBuilder();
+const query = queryBuilder
+  .select(['Id', 'Name', 'Year'])
+  .where('Year = 2024')
+  .andWhere('Name LIKE \'%Science%\'')
+  .orderBy('Name', 'ASC')
+  .limit(5)
+  .offset(10)
+  .getQuery();
+
+const results = await duckDbRepository.executeQuery(query);
+```
+
+## 🔒 Transactions
+
+Handle multiple operations in a transaction:
+
+```typescript
+await subjectRepository.withTransaction(async (transaction) => {
+  const subject1 = new Subject('MATH101', 'Mathematics', 'Basic math', 2024);
+  const subject2 = new Subject('PHYS101', 'Physics', 'Basic physics', 2024);
+  
+  await subjectRepository.save(subject1);
+  await subjectRepository.save(subject2);
+  
+  // If any operation throws an error, the transaction will roll back
+  // Otherwise, it will commit automatically
+});
+```
+
+## 📊 Data Export
+
+Export your data to various formats:
+
+```typescript
+// Export table to CSV
+await subjectRepository.exportData({
+  format: 'csv',
+  fileName: 'subjects.csv',
+  csvOptions: {
+    header: true,
+    delimiter: ','
+  }
+});
+
+// Export query results to JSON
+const query = `SELECT * FROM main.subjects WHERE Year = 2024`;
+await subjectRepository.exportQuery(query, {
+  format: 'json',
+  fileName: 'subjects-2024.json',
+  jsonOptions: {
+    pretty: true
+  }
+});
+
+// Export table to Parquet
+await duckDbRepository.exportTable('subjects', {
+  format: 'parquet',
+  fileName: 'subjects.parquet',
+  parquetOptions: {
+    compression: 'ZSTD'
+  }
+});
+```
+
+## 🧠 Advanced Usage
+
+### 🛠️ Custom Repositories
+
+Extend the base repository with custom methods:
+
+```typescript
+@Repository(Subject)
+class SubjectRepository extends BaseRepository<Subject, number> {
+  constructor() {
+    super(duckDbRepository);
+  }
+  
+  async findByCodeAndYear(code: string, year: number): Promise<Subject | null> {
+    const query = `SELECT * FROM main.${this.tableName} WHERE Code='${code}' AND Year=${year}`;
+    const result = await this.repository.executeQuery(query);
+    return result.length > 0 ? result[0] : null;
+  }
+  
+  async findActive(): Promise<Subject[]> {
+    const currentYear = new Date().getFullYear();
+    return this.findBy({ Year: currentYear }, ["Year"]);
+  }
 }
+```
+
+### ⚙️ DuckDB Database Configuration
+
+```typescript
+// In-memory database
+const inMemoryDb = DuckDbRepository.getInstances({
+  name: 'default',
+  location: DuckDbLocation.Memory
+});
 
-test();
+// File-based database
+const fileDb = DuckDbRepository.getInstances({
+  name: 'production',
+  location: DuckDbLocation.File,
+  filename: './data/mydb.db'
+});
 ```
+
+## 📘 API Reference
+
+### 🏷️ Decorators
+
+- 🏢 `@Entity(options?)`: Defines a class as an entity
+- 📝 `@Column(options)`: Defines a property as a column
+- 🗂️ `@Repository(entityClass)`: Defines a repository for an entity
+
+### 🔙 Legacy Decorators (backward compatibility)
+
+- 📋 `@DataTypeDecorator(type)`: Defines a column type `@Column()`
+- 🔑 `@Id()`: Defines a primary key
+- 🎯 `@Unique()`: Adds a unique constraint
+- ⚠️ `@NotNull()`: Adds a NOT NULL constraint
+- 🏷️ `@Default(value)`: Sets a default value
+- ✅ `@Check(constraint)`: Adds a CHECK constraint
+- 🔢 `@AutoIncrement()`: Sets column as auto-increment
+
+### 🧰 Repository Methods
+
+- 🚀 `init()`: Initializes the repository and creates the table
+- 💾 `save(entity)`: Saves an entity (insert or update)
+- 📦 `saveAll(entities)`: Saves multiple entities
+- 📋 `findAll()`: Retrieves all entities
+- 🔍 `findById(id)`: Retrieves an entity by ID
+- ⚡ `findByIdOrThrow(id)`: Retrieves an entity by ID or throws an error
+- 🔎 `findBy(criteria, columns)`: Retrieves entities matching criteria
+- 📄 `findWithPagination(pageable)`: Retrieves entities with pagination
+- 🗑️ `removeById(id)`: Deletes an entity by ID
+- 🧹 `removeAll()`: Deletes all entities
+- 🔧 `createQueryBuilder()`: Creates a query builder
+- 🔄 `withTransaction(callback)`: Executes operations within a transaction
+- 📊 `exportData(options)`: Exports table data
+- 📈 `exportQuery(query, options)`: Exports query results
+
+## 📜 License
+
+MIT

package/dist/constants/data-type.decorator.d.ts

@@ -1,6 +1,25 @@
 import 'reflect-metadata';
+export interface ColumnOptions {
+    type?: string;
+    notNull?: boolean;
+    unique?: boolean;
+    defaultValue?: any;
+    check?: string;
+    primaryKey?: boolean;
+    autoIncrement?: boolean;
+}
+export declare function Column(options?: ColumnOptions): PropertyDecorator;
 export declare function DataTypeDecorator(dataType: string): PropertyDecorator;
 export declare function Id(): PropertyDecorator;
 export declare function Unique(): PropertyDecorator;
-export declare function Entity(target: Function): void;
+export declare function NotNull(): PropertyDecorator;
+export declare function Default(value: any): PropertyDecorator;
+export declare function Check(constraint: string): PropertyDecorator;
+export declare function AutoIncrement(): PropertyDecorator;
+export interface TableOptions {
+    name?: string;
+    schema?: string;
+}
+export declare function Entity(): ClassDecorator;
+export declare function Entity(options: TableOptions): ClassDecorator;
 export declare function Repository(entity: new () => any): (target: Function) => void;

package/dist/constants/data-type.decorator.js

@@ -1,13 +1,19 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.Column = Column;
 exports.DataTypeDecorator = DataTypeDecorator;
 exports.Id = Id;
 exports.Unique = Unique;
+exports.NotNull = NotNull;
+exports.Default = Default;
+exports.Check = Check;
+exports.AutoIncrement = AutoIncrement;
 exports.Entity = Entity;
 exports.Repository = Repository;
 /* eslint-disable @typescript-eslint/no-explicit-any */
 require("reflect-metadata");
-function DataTypeDecorator(dataType) {
+// Column decorator with options
+function Column(options = {}) {
     return function (target, propertyKey) {
         let propertyValue;
         const descriptor = Object.getOwnPropertyDescriptor(target, propertyKey);
@@ -20,7 +26,7 @@ function DataTypeDecorator(dataType) {
             Object.defineProperty(target, propertyKey, descriptor);
         }
         else {
-            // If the property doesn't exist, create it with the specified data type
+            // If the property doesn't exist, create it
             Object.defineProperty(target, propertyKey, {
                 value: propertyValue,
                 writable: true,
@@ -28,25 +34,67 @@ function DataTypeDecorator(dataType) {
                 configurable: true,
             });
         }
-        // Set the data type as metadata using Reflect.defineMetadata
-        Reflect.defineMetadata('FieldType', dataType, target, propertyKey);
+        // Set all options as metadata
+        if (options.type) {
+            Reflect.defineMetadata('FieldType', options.type, target, propertyKey);
+        }
+        if (options.primaryKey) {
+            Reflect.defineMetadata('PrimaryKey', true, target, propertyKey);
+        }
+        if (options.unique) {
+            Reflect.defineMetadata('Unique', true, target, propertyKey);
+        }
+        if (options.notNull) {
+            Reflect.defineMetadata('NotNull', true, target, propertyKey);
+        }
+        if (options.defaultValue !== undefined) {
+            Reflect.defineMetadata('DefaultValue', options.defaultValue, target, propertyKey);
+        }
+        if (options.check) {
+            Reflect.defineMetadata('Check', options.check, target, propertyKey);
+        }
+        if (options.autoIncrement) {
+            Reflect.defineMetadata('AutoIncrement', true, target, propertyKey);
+        }
     };
 }
+// Legacy decorators for backward compatibility
+function DataTypeDecorator(dataType) {
+    return Column({ type: dataType });
+}
 function Id() {
-    return function (target, propertyKey) {
-        Reflect.defineMetadata('PrimaryKey', true, target, propertyKey);
-    };
+    return Column({ primaryKey: true });
 }
 function Unique() {
-    return function (target, propertyKey) {
-        Reflect.defineMetadata('Unique', true, target, propertyKey);
-    };
+    return Column({ unique: true });
+}
+function NotNull() {
+    return Column({ notNull: true });
+}
+function Default(value) {
+    return Column({ defaultValue: value });
+}
+function Check(constraint) {
+    return Column({ check: constraint });
 }
-function Entity(target) {
-    // Add metadata to the class using the 'entityType' key
-    Reflect.defineMetadata('entityType', target, target);
+function AutoIncrement() {
+    return Column({ autoIncrement: true });
+}
+function Entity(options) {
+    return function (target) {
+        // Add metadata to the class
+        Reflect.defineMetadata('entityType', target, target);
+        // Add table name if provided
+        if (options?.name) {
+            Reflect.defineMetadata('TableName', options.name, target);
+        }
+        // Add schema if provided
+        if (options?.schema) {
+            Reflect.defineMetadata('Schema', options.schema, target);
+        }
+    };
 }
-// Apply this decorator to the repository class, not the entity
+// Repository decorator
 function Repository(entity) {
     return function (target) {
         Reflect.defineMetadata('entityType', entity, target);

package/dist/constants/data-type.decorator.js.map

@@ -1 +1 @@
-{"version":3,"file":"data-type.decorator.js","sourceRoot":"","sources":["../../src/constants/data-type.decorator.ts"],"names":[],"mappings":";;AAGA,8CAyBC;AAGD,gBAIC;AAED,wBAIC;AAGD,wBAGC;AAGD,gCAIC;AAtDD,uDAAuD;AACvD,4BAA0B;AAE1B,SAAgB,iBAAiB,CAAC,QAAgB;IAC9C,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,IAAI,aAAkB,CAAC;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,WAAqB,CAAC,CAAC;QAElF,IAAI,UAAU,EAAE,CAAC;YACb,2DAA2D;YAC3D,UAAU,CAAC,KAAK,GAAG,aAAa,CAAC;YACjC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC3B,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC;YAC7B,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;YAC/B,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACJ,wEAAwE;YACxE,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;gBACvC,KAAK,EAAE,aAAa;gBACpB,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;aACrB,CAAC,CAAC;QACP,CAAC;QAED,6DAA6D;QAC7D,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,QAAQ,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACvE,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,EAAE;IACd,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IACpE,CAAC,CAAC;AACN,CAAC;AAED,SAAgB,MAAM;IAClB,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;IAChE,CAAC,CAAC;AACN,CAAC;AAGD,SAAgB,MAAM,CAAC,MAAgB;IACnC,uDAAuD;IACvD,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;AACzD,CAAC;AAED,+DAA+D;AAC/D,SAAgB,UAAU,CAAC,MAAqB;IAC5C,OAAO,UAAU,MAAgB;QAC7B,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC,CAAC;AACN,CAAC"}
+{"version":3,"file":"data-type.decorator.js","sourceRoot":"","sources":["../../src/constants/data-type.decorator.ts"],"names":[],"mappings":";;AAeA,wBA6CC;AAGD,8CAEC;AAED,gBAEC;AAED,wBAEC;AAED,0BAEC;AAED,0BAEC;AAED,sBAEC;AAED,sCAEC;AAUD,wBAeC;AAGD,gCAIC;AAzHD,uDAAuD;AACvD,4BAA0B;AAa1B,gCAAgC;AAChC,SAAgB,MAAM,CAAC,UAAyB,EAAE;IAC9C,OAAO,UAAU,MAAW,EAAE,WAA4B;QACtD,IAAI,aAAkB,CAAC;QACvB,MAAM,UAAU,GAAG,MAAM,CAAC,wBAAwB,CAAC,MAAM,EAAE,WAAqB,CAAC,CAAC;QAElF,IAAI,UAAU,EAAE,CAAC;YACb,2DAA2D;YAC3D,UAAU,CAAC,KAAK,GAAG,aAAa,CAAC;YACjC,UAAU,CAAC,QAAQ,GAAG,IAAI,CAAC;YAC3B,UAAU,CAAC,UAAU,GAAG,IAAI,CAAC;YAC7B,UAAU,CAAC,YAAY,GAAG,IAAI,CAAC;YAC/B,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE,UAAU,CAAC,CAAC;QAC3D,CAAC;aAAM,CAAC;YACJ,2CAA2C;YAC3C,MAAM,CAAC,cAAc,CAAC,MAAM,EAAE,WAAW,EAAE;gBACvC,KAAK,EAAE,aAAa;gBACpB,QAAQ,EAAE,IAAI;gBACd,UAAU,EAAE,IAAI;gBAChB,YAAY,EAAE,IAAI;aACrB,CAAC,CAAC;QACP,CAAC;QAED,8BAA8B;QAC9B,IAAI,OAAO,CAAC,IAAI,EAAE,CAAC;YACf,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAC3E,CAAC;QACD,IAAI,OAAO,CAAC,UAAU,EAAE,CAAC;YACrB,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACpE,CAAC;QACD,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;YACjB,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QAChE,CAAC;QACD,IAAI,OAAO,CAAC,OAAO,EAAE,CAAC;YAClB,OAAO,CAAC,cAAc,CAAC,SAAS,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACjE,CAAC;QACD,IAAI,OAAO,CAAC,YAAY,KAAK,SAAS,EAAE,CAAC;YACrC,OAAO,CAAC,cAAc,CAAC,cAAc,EAAE,OAAO,CAAC,YAAY,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACtF,CAAC;QACD,IAAI,OAAO,CAAC,KAAK,EAAE,CAAC;YAChB,OAAO,CAAC,cAAc,CAAC,OAAO,EAAE,OAAO,CAAC,KAAK,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACxE,CAAC;QACD,IAAI,OAAO,CAAC,aAAa,EAAE,CAAC;YACxB,OAAO,CAAC,cAAc,CAAC,eAAe,EAAE,IAAI,EAAE,MAAM,EAAE,WAAW,CAAC,CAAC;QACvE,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED,+CAA+C;AAC/C,SAAgB,iBAAiB,CAAC,QAAgB;IAC9C,OAAO,MAAM,CAAC,EAAE,IAAI,EAAE,QAAQ,EAAE,CAAC,CAAC;AACtC,CAAC;AAED,SAAgB,EAAE;IACd,OAAO,MAAM,CAAC,EAAE,UAAU,EAAE,IAAI,EAAE,CAAC,CAAC;AACxC,CAAC;AAED,SAAgB,MAAM;IAClB,OAAO,MAAM,CAAC,EAAE,MAAM,EAAE,IAAI,EAAE,CAAC,CAAC;AACpC,CAAC;AAED,SAAgB,OAAO;IACnB,OAAO,MAAM,CAAC,EAAE,OAAO,EAAE,IAAI,EAAE,CAAC,CAAC;AACrC,CAAC;AAED,SAAgB,OAAO,CAAC,KAAU;IAC9B,OAAO,MAAM,CAAC,EAAE,YAAY,EAAE,KAAK,EAAE,CAAC,CAAC;AAC3C,CAAC;AAED,SAAgB,KAAK,CAAC,UAAkB;IACpC,OAAO,MAAM,CAAC,EAAE,KAAK,EAAE,UAAU,EAAE,CAAC,CAAC;AACzC,CAAC;AAED,SAAgB,aAAa;IACzB,OAAO,MAAM,CAAC,EAAE,aAAa,EAAE,IAAI,EAAE,CAAC,CAAC;AAC3C,CAAC;AAUD,SAAgB,MAAM,CAAC,OAAsB;IACzC,OAAO,UAAU,MAAgB;QAC7B,4BAA4B;QAC5B,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;QAErD,6BAA6B;QAC7B,IAAI,OAAO,EAAE,IAAI,EAAE,CAAC;YAChB,OAAO,CAAC,cAAc,CAAC,WAAW,EAAE,OAAO,CAAC,IAAI,EAAE,MAAM,CAAC,CAAC;QAC9D,CAAC;QAED,yBAAyB;QACzB,IAAI,OAAO,EAAE,MAAM,EAAE,CAAC;YAClB,OAAO,CAAC,cAAc,CAAC,QAAQ,EAAE,OAAO,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;QAC7D,CAAC;IACL,CAAC,CAAC;AACN,CAAC;AAED,uBAAuB;AACvB,SAAgB,UAAU,CAAC,MAAqB;IAC5C,OAAO,UAAU,MAAgB;QAC7B,OAAO,CAAC,cAAc,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;IACzD,CAAC,CAAC;AACN,CAAC"}

package/dist/errors/orm-errors.d.ts

@@ -0,0 +1,27 @@
+export declare class OrmBaseError extends Error {
+    constructor(message: string);
+}
+export declare class ConnectionError extends OrmBaseError {
+    constructor(entityName: string);
+}
+export declare class EntityNotFoundError extends OrmBaseError {
+    constructor(entityName: string, id: any);
+}
+export declare class PrimaryKeyError extends OrmBaseError {
+    constructor(message: string);
+}
+export declare class TableCreationError extends OrmBaseError {
+    constructor(tableName: string, originalError?: Error);
+}
+export declare class QueryExecutionError extends OrmBaseError {
+    constructor(query: string, originalError?: Error);
+}
+export declare class TransactionError extends OrmBaseError {
+    constructor(operation: string, originalError?: Error);
+}
+export declare class ValidationError extends OrmBaseError {
+    constructor(entityName: string, propertyName: string, value: any, constraint: string);
+}
+export declare class MigrationError extends OrmBaseError {
+    constructor(version: string, operation: string, originalError?: Error);
+}