accio-orm 0.1.0

package/dist/decorators/Table.js

@@ -0,0 +1,21 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Table = Table;
+exports.getTableName = getTableName;
+require("reflect-metadata");
+const TABLE_NAME_KEY = Symbol('table:name');
+/**
+ * Decorator to mark a class as a database table
+ * @param tableName - The name of the database table
+ */
+function Table(tableName) {
+    return function (target) {
+        Reflect.defineMetadata(TABLE_NAME_KEY, tableName, target);
+    };
+}
+/**
+ * helper to retrieve the table name from a class
+ */
+function getTableName(target) {
+    return Reflect.getMetadata(TABLE_NAME_KEY, target);
+}

package/dist/examples/test-connection.d.ts

@@ -0,0 +1 @@
+export {};

package/dist/examples/test-connection.js

@@ -0,0 +1,36 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+const Connection_1 = require("@/connection/Connection");
+async function testConnection() {
+    console.log('creating connection...');
+    const db = (0, Connection_1.connect)({
+        host: 'localhost',
+        database: 'accio_db',
+        user: 'accio_db',
+        password: 'accio_db'
+    });
+    console.log('testing connection...');
+    const isConnected = await db.testConnection();
+    if (isConnected) {
+        console.log('✅ connection successfull');
+        const result = await db.query('SELECT NOW()');
+        console.log('current time from database:', result.rows[0].now);
+        await db.query(`
+      CREATE TABLE IF NOT EXISTS test_table (
+        if SERIAL PRIMARY KEY,
+        name TEXT
+      )
+    `);
+        console.log('✅ created test table');
+        await db.query('INSERT INTO test_table (name) VALUES ($1)', ['Test User']);
+        console.log('✅ inserted test data');
+        const users = await db.query('SELECT * FROM test_table');
+        console.log('✅ query resylts:', users.rows);
+    }
+    else {
+        console.log('❌ connection failed');
+    }
+    await db.close();
+    console.log('connection closed');
+}
+testConnection().catch(console.error);

package/dist/examples/test-decorators.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/examples/test-decorators.js

@@ -0,0 +1,40 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const Column_1 = require("@/decorators/Column");
+const Column_2 = require("@/decorators/Column");
+const PrimaryColumn_1 = require("@/decorators/PrimaryColumn");
+const Table_1 = require("@/decorators/Table");
+const Table_2 = require("@/decorators/Table");
+let User = class User {
+};
+__decorate([
+    (0, PrimaryColumn_1.PrimaryColumn)(),
+    __metadata("design:type", Number)
+], User.prototype, "id", void 0);
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", String)
+], User.prototype, "name", void 0);
+__decorate([
+    (0, Column_1.Column)({ name: 'user_age' }),
+    __metadata("design:type", Number)
+], User.prototype, "age", void 0);
+__decorate([
+    (0, Column_1.Column)({ nullable: false }),
+    __metadata("design:type", String)
+], User.prototype, "email", void 0);
+User = __decorate([
+    (0, Table_1.Table)('users')
+], User);
+console.log('Table name:', (0, Table_2.getTableName)(User));
+console.log('Columns:', (0, Column_2.getColumns)(User));

package/dist/examples/test-metadata.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/examples/test-metadata.js

@@ -0,0 +1,110 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const Column_1 = require("../decorators/Column");
+const PrimaryColumn_1 = require("../decorators/PrimaryColumn");
+const Table_1 = require("../decorators/Table");
+const MetadataStorage_1 = require("../metadata/MetadataStorage");
+// Valid entity
+let User = class User {
+};
+__decorate([
+    (0, PrimaryColumn_1.PrimaryColumn)(),
+    __metadata("design:type", Number)
+], User.prototype, "id", void 0);
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", String)
+], User.prototype, "name", void 0);
+__decorate([
+    (0, Column_1.Column)({ name: 'user_age' }),
+    __metadata("design:type", Number)
+], User.prototype, "age", void 0);
+User = __decorate([
+    (0, Table_1.Table)('users')
+], User);
+// Test valid entity
+console.log('=== Testing Valid Entity ===');
+const userMetadata = MetadataStorage_1.MetadataStorage.getEntityMetadata(User);
+console.log('Table:', userMetadata.tableName);
+console.log('Primary Column:', userMetadata.primaryColumn);
+console.log('All Columns:');
+userMetadata.columns.forEach((col) => {
+    console.log(`  - ${col.propertyKey} → ${col.columnName} (primary: ${col.isPrimary})`);
+});
+// Test convenience methods
+console.log('\n=== Convenience Methods ===');
+console.log('Table name:', MetadataStorage_1.MetadataStorage.getTableName(User));
+console.log('Primary column:', MetadataStorage_1.MetadataStorage.getPrimaryColumn(User));
+// Test validation errors
+console.log('\n=== Testing Validation Errors ===');
+// Missing @Table
+class NoTable {
+}
+__decorate([
+    (0, PrimaryColumn_1.PrimaryColumn)(),
+    __metadata("design:type", Number)
+], NoTable.prototype, "id", void 0);
+try {
+    MetadataStorage_1.MetadataStorage.getEntityMetadata(NoTable);
+}
+catch (error) {
+    console.log('✓ Caught missing @Table:', error.message);
+}
+// No columns
+let NoColumns = class NoColumns {
+};
+NoColumns = __decorate([
+    (0, Table_1.Table)('empty')
+], NoColumns);
+try {
+    MetadataStorage_1.MetadataStorage.getEntityMetadata(NoColumns);
+}
+catch (error) {
+    console.log('✓ Caught no columns:', error.message);
+}
+// No primary key
+let NoPrimaryKey = class NoPrimaryKey {
+};
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", String)
+], NoPrimaryKey.prototype, "name", void 0);
+NoPrimaryKey = __decorate([
+    (0, Table_1.Table)('no_pk')
+], NoPrimaryKey);
+try {
+    MetadataStorage_1.MetadataStorage.getEntityMetadata(NoPrimaryKey);
+}
+catch (error) {
+    console.log('✓ Caught no primary key:', error.message);
+}
+// Multiple primary keys
+let MultiplePrimaryKeys = class MultiplePrimaryKeys {
+};
+__decorate([
+    (0, PrimaryColumn_1.PrimaryColumn)(),
+    __metadata("design:type", Number)
+], MultiplePrimaryKeys.prototype, "id", void 0);
+__decorate([
+    (0, PrimaryColumn_1.PrimaryColumn)(),
+    __metadata("design:type", Number)
+], MultiplePrimaryKeys.prototype, "userId", void 0);
+MultiplePrimaryKeys = __decorate([
+    (0, Table_1.Table)('multi_pk')
+], MultiplePrimaryKeys);
+try {
+    MetadataStorage_1.MetadataStorage.getEntityMetadata(MultiplePrimaryKeys);
+}
+catch (error) {
+    console.log('✓ Caught multiple primary keys:', error.message);
+}

package/dist/examples/test-querybuilder.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/examples/test-querybuilder.js

@@ -0,0 +1,142 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const Connection_1 = require("../connection/Connection");
+const Column_1 = require("../decorators/Column");
+const PrimaryColumn_1 = require("../decorators/PrimaryColumn");
+const Table_1 = require("../decorators/Table");
+let User = class User {
+};
+__decorate([
+    (0, PrimaryColumn_1.PrimaryColumn)(),
+    __metadata("design:type", Number)
+], User.prototype, "id", void 0);
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", String)
+], User.prototype, "name", void 0);
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", Number)
+], User.prototype, "age", void 0);
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", String)
+], User.prototype, "city", void 0);
+User = __decorate([
+    (0, Table_1.Table)('users')
+], User);
+async function testQueryBuilder() {
+    console.log('=== Testing QueryBuilder ===\n');
+    const db = (0, Connection_1.connect)({
+        host: 'localhost',
+        database: 'accio_db',
+        user: 'accio_db',
+        password: 'accio_db'
+    });
+    const userRepo = db.getRepository(User);
+    try {
+        // Setup: Insert test data
+        console.log('Setting up test data...');
+        const testUsers = [
+            { name: 'Alice', age: 25, city: 'NYC' },
+            { name: 'Bob', age: 30, city: 'LA' },
+            { name: 'Charlie', age: 25, city: 'NYC' },
+            { name: 'Diana', age: 35, city: 'Chicago' },
+            { name: 'Eve', age: 25, city: 'LA' }
+        ];
+        for (const userData of testUsers) {
+            const user = new User();
+            Object.assign(user, userData);
+            await userRepo.insert(user);
+        }
+        console.log('✓ Inserted test data\n');
+        // Test 1: Simple WHERE
+        console.log('1. Simple WHERE (age = 25)');
+        const query1 = userRepo.where({ age: 25 });
+        console.log('SQL:', query1.toSQL());
+        const result1 = await query1.find();
+        console.log('✓ Results:', result1.length, 'users');
+        result1.forEach((u) => console.log(`  - ${u.name}, ${u.age}, ${u.city}`));
+        // Test 2: Multiple WHERE (AND)
+        console.log('\n2. Multiple WHERE (age = 25 AND city = NYC)');
+        const query2 = userRepo.where({ age: 25 }).where({ city: 'NYC' });
+        console.log('SQL:', query2.toSQL());
+        const result2 = await query2.find();
+        console.log('✓ Results:', result2.length, 'users');
+        result2.forEach((u) => console.log(`  - ${u.name}, ${u.age}, ${u.city}`));
+        // Test 3: ORDER BY
+        console.log('\n3. ORDER BY age DESC');
+        const query3 = userRepo.where({ city: 'NYC' }).orderBy('age', 'DESC');
+        console.log('SQL:', query3.toSQL());
+        const result3 = await query3.find();
+        console.log('✓ Results:');
+        result3.forEach((u) => console.log(`  - ${u.name}, ${u.age}, ${u.city}`));
+        // Test 4: LIMIT
+        console.log('\n4. LIMIT 2');
+        const query4 = userRepo.where({ age: 25 }).limit(2);
+        console.log('SQL:', query4.toSQL());
+        const result4 = await query4.find();
+        console.log('✓ Results:', result4.length, 'users');
+        result4.forEach((u) => console.log(`  - ${u.name}, ${u.age}, ${u.city}`));
+        // Test 5: OFFSET
+        console.log('\n5. OFFSET 1 LIMIT 2');
+        const query5 = userRepo.where({ age: 25 }).offset(1).limit(2);
+        console.log('SQL:', query5.toSQL());
+        const result5 = await query5.find();
+        console.log('✓ Results:', result5.length, 'users');
+        result5.forEach((u) => console.log(`  - ${u.name}, ${u.age}, ${u.city}`));
+        // Test 6: findOne
+        console.log('\n6. findOne (first user in NYC)');
+        const query6 = userRepo.where({ city: 'NYC' });
+        console.log('SQL:', query6.toSQL());
+        const result6 = await query6.findOne();
+        console.log('✓ Result:', result6);
+        // Test 7: count
+        console.log('\n7. count (age = 25)');
+        const count = await userRepo.where({ age: 25 }).count();
+        console.log('✓ Count:', count);
+        // Test 8: exists
+        console.log('\n8. exists (city = Seattle)');
+        const exists = await userRepo.where({ city: 'Seattle' }).exists();
+        console.log('✓ Exists:', exists);
+        // Test 9: IN clause (array values)
+        console.log('\n9. IN clause (city IN [NYC, LA])');
+        const query9 = userRepo.where({ city: ['NYC', 'LA'] });
+        console.log('SQL:', query9.toSQL());
+        const result9 = await query9.find();
+        console.log('✓ Results:', result9.length, 'users');
+        result9.forEach((u) => console.log(`  - ${u.name}, ${u.age}, ${u.city}`));
+        // Test 10: Complex query
+        console.log('\n10. Complex query (age IN [25, 30] AND city = NYC, ORDER BY name)');
+        const query10 = userRepo
+            .where({ age: [25, 30] })
+            .where({ city: 'NYC' })
+            .orderBy('name', 'ASC');
+        console.log('SQL:', query10.toSQL());
+        const result10 = await query10.find();
+        console.log('✓ Results:', result10.length, 'users');
+        result10.forEach((u) => console.log(`  - ${u.name}, ${u.age}, ${u.city}`));
+    }
+    catch (error) {
+        console.error('Error:', error);
+    }
+    finally {
+        // Cleanup: Delete test data
+        console.log('\nCleaning up...');
+        await db.query('TRUNCATE TABLE users RESTART IDENTITY');
+        console.log('✓ Cleaned up');
+        await db.close();
+        console.log('Connection closed');
+    }
+}
+testQueryBuilder().catch(console.error);

package/dist/examples/test-repository.d.ts

@@ -0,0 +1 @@
+import 'reflect-metadata';

package/dist/examples/test-repository.js

@@ -0,0 +1,111 @@
+"use strict";
+var __decorate = (this && this.__decorate) || function (decorators, target, key, desc) {
+    var c = arguments.length, r = c < 3 ? target : desc === null ? desc = Object.getOwnPropertyDescriptor(target, key) : desc, d;
+    if (typeof Reflect === "object" && typeof Reflect.decorate === "function") r = Reflect.decorate(decorators, target, key, desc);
+    else for (var i = decorators.length - 1; i >= 0; i--) if (d = decorators[i]) r = (c < 3 ? d(r) : c > 3 ? d(target, key, r) : d(target, key)) || r;
+    return c > 3 && r && Object.defineProperty(target, key, r), r;
+};
+var __metadata = (this && this.__metadata) || function (k, v) {
+    if (typeof Reflect === "object" && typeof Reflect.metadata === "function") return Reflect.metadata(k, v);
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+require("reflect-metadata");
+const Connection_1 = require("../connection/Connection");
+const Column_1 = require("../decorators/Column");
+const PrimaryColumn_1 = require("../decorators/PrimaryColumn");
+const Table_1 = require("../decorators/Table");
+let User = class User {
+};
+__decorate([
+    (0, PrimaryColumn_1.PrimaryColumn)(),
+    __metadata("design:type", Number)
+], User.prototype, "id", void 0);
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", String)
+], User.prototype, "name", void 0);
+__decorate([
+    (0, Column_1.Column)(),
+    __metadata("design:type", Number)
+], User.prototype, "age", void 0);
+User = __decorate([
+    (0, Table_1.Table)('users')
+], User);
+async function testRepository() {
+    console.log('=== Testing Repository ===\n');
+    // Connect to database
+    const db = (0, Connection_1.connect)({
+        host: 'localhost',
+        database: 'accio_db',
+        user: 'accio_db',
+        password: 'accio_db'
+    });
+    // Get repository
+    const userRepo = db.getRepository(User);
+    try {
+        // Test 1: Insert a new user
+        console.log('1. Testing INSERT...');
+        const newUser = new User();
+        newUser.name = 'Alice';
+        newUser.age = 25;
+        const savedUser = await userRepo.insert(newUser);
+        console.log('✓ Inserted user:', savedUser);
+        // Test 2: Find by ID
+        console.log('\n2. Testing FIND BY ID...');
+        const foundUser = await userRepo.findById(savedUser.id);
+        console.log('✓ Found user:', foundUser);
+        // Test 3: Update
+        console.log('\n3. Testing UPDATE...');
+        if (foundUser) {
+            foundUser.age = 26;
+            const updatedUser = await userRepo.update(foundUser);
+            console.log('✓ Updated user:', updatedUser);
+        }
+        // Test 4: Save (should update since ID exists)
+        console.log('\n4. Testing SAVE (update)...');
+        if (foundUser) {
+            foundUser.name = 'Alice Updated';
+            const savedAgain = await userRepo.save(foundUser);
+            console.log('✓ Saved user:', savedAgain);
+        }
+        // Test 5: Save (should insert since no ID)
+        console.log('\n5. Testing SAVE (insert)...');
+        const anotherUser = new User();
+        anotherUser.name = 'Bob';
+        anotherUser.age = 30;
+        const insertedViaSave = await userRepo.save(anotherUser);
+        console.log('✓ Inserted via save:', insertedViaSave);
+        // Test 6: Find all
+        console.log('\n6. Testing FIND ALL...');
+        const allUsers = await userRepo.findAll();
+        console.log(`✓ Found ${allUsers.length} users:`, allUsers);
+        // Test 7: Count
+        console.log('\n7. Testing COUNT...');
+        const count = await userRepo.count();
+        console.log(`✓ Total users: ${count}`);
+        // Test 8: Exists
+        console.log('\n8. Testing EXISTS...');
+        const exists = await userRepo.exists(savedUser.id);
+        console.log(`✓ User ${savedUser.id} exists:`, exists);
+        const notExists = await userRepo.exists(99999);
+        console.log(`✓ User 99999 exists:`, notExists);
+        // Test 9: Delete
+        console.log('\n9. Testing DELETE...');
+        await userRepo.delete(savedUser);
+        console.log('✓ Deleted user');
+        const deletedUser = await userRepo.findById(savedUser.id);
+        console.log('✓ User after delete:', deletedUser);
+        // Test 10: Delete by ID
+        console.log('\n10. Testing DELETE BY ID...');
+        await userRepo.deleteById(insertedViaSave.id);
+        console.log('✓ Deleted by ID');
+    }
+    catch (error) {
+        console.error('Error:', error);
+    }
+    finally {
+        await db.close();
+        console.log('\nConnection closed');
+    }
+}
+testRepository().catch(console.error);

package/dist/index.d.ts

@@ -0,0 +1,9 @@
+export { connect, Connection } from './connection/Connection';
+export { ConnectionConfig } from './connection/types';
+export { Column, ColumnMetadata, ColumnOptions } from './decorators/Column';
+export { PrimaryColumn } from './decorators/PrimaryColumn';
+export { Table } from './decorators/Table';
+export { Repository } from './repository/Repository';
+export { QueryBuilder } from './query/QueryBuilder';
+export { MetadataStorage } from './metadata/MetadataStorage';
+export { EntityMetadata } from './metadata/types';

package/dist/index.js

@@ -0,0 +1,23 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataStorage = exports.QueryBuilder = exports.Repository = exports.Table = exports.PrimaryColumn = exports.Column = exports.Connection = exports.connect = void 0;
+// Connection
+var Connection_1 = require("./connection/Connection");
+Object.defineProperty(exports, "connect", { enumerable: true, get: function () { return Connection_1.connect; } });
+Object.defineProperty(exports, "Connection", { enumerable: true, get: function () { return Connection_1.Connection; } });
+// Decorators
+var Column_1 = require("./decorators/Column");
+Object.defineProperty(exports, "Column", { enumerable: true, get: function () { return Column_1.Column; } });
+var PrimaryColumn_1 = require("./decorators/PrimaryColumn");
+Object.defineProperty(exports, "PrimaryColumn", { enumerable: true, get: function () { return PrimaryColumn_1.PrimaryColumn; } });
+var Table_1 = require("./decorators/Table");
+Object.defineProperty(exports, "Table", { enumerable: true, get: function () { return Table_1.Table; } });
+// Repository
+var Repository_1 = require("./repository/Repository");
+Object.defineProperty(exports, "Repository", { enumerable: true, get: function () { return Repository_1.Repository; } });
+// Query Builder
+var QueryBuilder_1 = require("./query/QueryBuilder");
+Object.defineProperty(exports, "QueryBuilder", { enumerable: true, get: function () { return QueryBuilder_1.QueryBuilder; } });
+// Metadata
+var MetadataStorage_1 = require("./metadata/MetadataStorage");
+Object.defineProperty(exports, "MetadataStorage", { enumerable: true, get: function () { return MetadataStorage_1.MetadataStorage; } });

package/dist/metadata/MetadataStorage.d.ts

@@ -0,0 +1,30 @@
+import { type ColumnMetadata } from '@/decorators/Column';
+import type { EntityConstructor, EntityMetadata } from './types';
+export declare class MetadataStorage {
+    private static metadataCache;
+    /**
+     * Extract all metadata from an entity class
+     * @param entityClass - The entity class to extract metadata from
+     * @returns complete entity metadata
+     * @throws Error if entity is missing required decorators
+     */
+    static getEntityMetadata(entityClass: EntityConstructor): EntityMetadata;
+    /**
+     * Validate that an entity has all required metadata
+     * @param entityClass - the entity class to validate
+     * @returns true if valid, throws error otherwise
+     */
+    static validateEntity(entityClass: EntityConstructor): boolean;
+    /**
+     *
+     * @param entityClass
+     * @returns get the table name
+     */
+    static getTableName(entityCLass: EntityConstructor): string;
+    static getColumns(entityClass: EntityConstructor): ColumnMetadata[];
+    static getPrimaryColumn(entityClass: EntityConstructor): ColumnMetadata;
+    /**
+     * Clear the metadata cache (useful for testing)
+     */
+    static clearCache(): void;
+}

package/dist/metadata/MetadataStorage.js

@@ -0,0 +1,82 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.MetadataStorage = void 0;
+const Column_1 = require("@/decorators/Column");
+const Table_1 = require("@/decorators/Table");
+class MetadataStorage {
+    /**
+     * Extract all metadata from an entity class
+     * @param entityClass - The entity class to extract metadata from
+     * @returns complete entity metadata
+     * @throws Error if entity is missing required decorators
+     */
+    static getEntityMetadata(entityClass) {
+        if (this.metadataCache.has(entityClass)) {
+            return this.metadataCache.get(entityClass);
+        }
+        const tableName = (0, Table_1.getTableName)(entityClass);
+        if (!tableName) {
+            throw new Error(`Entity ${entityClass.name} is missing @Table decorator.
+        Did you forget to add @Table('table_name') to the class?
+        `);
+        }
+        const columns = (0, Column_1.getColumns)(entityClass);
+        if (columns.length === 0) {
+            throw new Error(`Entity ${entityClass.name} has no columns defined.
+        Did you forget to add @Column() or @PrimaryColumn() decorators?`);
+        }
+        const primaryColumns = columns.filter((col) => col.isPrimary);
+        if (primaryColumns.length === 0) {
+            throw new Error(`Entity ${entityClass.name} has no primary key defined.
+        Add @PrimaryColumn() to one of your properties.`);
+        }
+        if (primaryColumns.length > 1) {
+            throw new Error(`Entity ${entityClass.name} has multiple primary keys:
+        ${primaryColumns.map((c) => c.propertyKey).join(', ')}.
+        Only one primary key is supported.`);
+        }
+        const primaryColumn = primaryColumns[0];
+        const metadata = {
+            tableName,
+            columns,
+            primaryColumn
+        };
+        this.metadataCache.set(entityClass, metadata);
+        return metadata;
+    }
+    /**
+     * Validate that an entity has all required metadata
+     * @param entityClass - the entity class to validate
+     * @returns true if valid, throws error otherwise
+     */
+    static validateEntity(entityClass) {
+        this.getEntityMetadata(entityClass);
+        return true;
+    }
+    /**
+     *
+     * @param entityClass
+     * @returns get the table name
+     */
+    static getTableName(entityCLass) {
+        return this.getEntityMetadata(entityCLass).tableName;
+    }
+    static getColumns(entityClass) {
+        return this.getEntityMetadata(entityClass).columns;
+    }
+    static getPrimaryColumn(entityClass) {
+        const metadata = this.getEntityMetadata(entityClass);
+        if (!metadata.primaryColumn) {
+            throw new Error(`Entity ${entityClass.name} has no primary key`);
+        }
+        return metadata.primaryColumn;
+    }
+    /**
+     * Clear the metadata cache (useful for testing)
+     */
+    static clearCache() {
+        this.metadataCache.clear();
+    }
+}
+exports.MetadataStorage = MetadataStorage;
+MetadataStorage.metadataCache = new Map();

package/dist/metadata/types.d.ts

@@ -0,0 +1,7 @@
+import type { ColumnMetadata } from '@/decorators/Column';
+export interface EntityMetadata {
+    tableName: string;
+    columns: ColumnMetadata[];
+    primaryColumn?: ColumnMetadata;
+}
+export type EntityConstructor<T = object> = new (...args: unknown[]) => T;

package/dist/metadata/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });