@rpal/orm 1.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 paljs
+
+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/dist/core/src/container.js

@@ -0,0 +1,125 @@
+import 'reflect-metadata';
+import { Scope, DEFAULT_SCOPE } from './scope';
+import { InjectionToken } from './token';
+import { getInjectableMetadata, getConstructorParams } from './decorators';
+export class PalCircularDependencyError extends Error {
+    constructor(path) {
+        super(`Circular dependency detected: ${path}`);
+        this.name = 'PalCircularDependencyError';
+    }
+}
+export class PalDependencyNotFoundError extends Error {
+    constructor(token, index, target) {
+        super(`Cannot resolve dependency "${getTokenName(token)}" at index ${index} in ${target.name || 'Unknown'} constructor`);
+        this.name = 'PalDependencyNotFoundError';
+    }
+}
+function getTokenName(token) {
+    if (token instanceof InjectionToken)
+        return token.name;
+    if (typeof token === 'string')
+        return token;
+    if (typeof token === 'symbol')
+        return String(token);
+    return token.name || 'Unknown';
+}
+export class PalContainer {
+    constructor(parent) {
+        this.registrations = new Map();
+        this.resolutionStack = [];
+        this.singletonCache = new Map();
+        this.parent = parent;
+    }
+    provide(token, provider) {
+        const reg = this.createRegistration(token, provider);
+        this.registrations.set(token, reg);
+        return this;
+    }
+    createRegistration(token, provider) {
+        const scope = provider.scope ?? DEFAULT_SCOPE;
+        if ('useValue' in provider) {
+            return { token, factory: () => provider.useValue, scope: Scope.Singleton, instance: provider.useValue };
+        }
+        if ('useClass' in provider) {
+            return { token, factory: (ctx) => this.resolveClass(provider.useClass, ctx), scope };
+        }
+        if ('useFactory' in provider) {
+            return { token, factory: (ctx) => provider.useFactory(ctx), scope };
+        }
+        throw new Error('Provider must have useValue, useClass, or useFactory');
+    }
+    get(token) {
+        if (this.resolutionStack.includes(token)) {
+            const path = [...this.resolutionStack, token].map(getTokenName).join(' -> ');
+            throw new PalCircularDependencyError(path);
+        }
+        const registration = this.findRegistration(token);
+        if (!registration) {
+            if (token instanceof Function && getInjectableMetadata(token)) {
+                return this.resolveClass(token, this);
+            }
+            throw new PalDependencyNotFoundError(token, 0, token);
+        }
+        return this.resolve(registration);
+    }
+    has(token) {
+        return this.findRegistration(token) !== undefined;
+    }
+    createChild() {
+        return new PalContainer(this);
+    }
+    override(token, provider) {
+        this.registrations.set(token, this.createRegistration(token, provider));
+        return this;
+    }
+    reset() {
+        this.registrations.clear();
+        this.singletonCache.clear();
+    }
+    findRegistration(token) {
+        return this.registrations.get(token) ?? this.parent?.findRegistration(token);
+    }
+    resolve(registration) {
+        if (registration.scope === Scope.Singleton && registration.instance !== undefined) {
+            return registration.instance;
+        }
+        if (registration.scope === Scope.Singleton) {
+            const instance = registration.factory(this);
+            registration.instance = instance;
+            return instance;
+        }
+        return registration.factory(this);
+    }
+    resolveClass(klass, ctx) {
+        this.resolutionStack.push(klass);
+        try {
+            const paramMeta = getConstructorParams(klass);
+            const args = paramMeta.map((param) => {
+                if (param.token && ctx.has(param.token)) {
+                    return param.optional && !ctx.has(param.token) ? undefined : ctx.get(param.token);
+                }
+                if (ctx.has(param.type)) {
+                    return ctx.get(param.type);
+                }
+                if (param.type === Object)
+                    return undefined;
+                try {
+                    return this.resolveClass(param.type, ctx);
+                }
+                catch {
+                    return undefined;
+                }
+            });
+            return new klass(...args);
+        }
+        finally {
+            this.resolutionStack.pop();
+        }
+    }
+}
+export function createPal(parent) {
+    return new PalContainer(parent);
+}
+export const Pal = {
+    create: createPal,
+};

package/dist/core/src/decorators.js

@@ -0,0 +1,59 @@
+import 'reflect-metadata';
+import { DEFAULT_SCOPE } from './scope';
+import { INJECTABLE_METADATA_KEY, INJECTABLE_CONSTRUCTOR_KEY } from './interface';
+const paramsCache = new WeakMap();
+export function Injectable(options) {
+    return (target) => {
+        Reflect.defineMetadata(INJECTABLE_METADATA_KEY, {
+            scope: options?.scope ?? DEFAULT_SCOPE,
+            token: options?.token,
+        }, target);
+    };
+}
+export function Inject(token, type, opts = {}) {
+    return (target, _key, index) => {
+        const inferredType = type || getParamType(target, index);
+        if (!inferredType) {
+            console.warn(`@Inject: Could not determine type for parameter ${index}. Provide it explicitly.`);
+        }
+        storeParamMeta(target, index, { type: inferredType, token, optional: opts.optional });
+    };
+}
+export function Optional() {
+    return (target, _key, index) => {
+        const type = getParamType(target, index);
+        const existing = getParamMeta(target, index);
+        storeParamMeta(target, index, { type, optional: true, token: existing?.token });
+    };
+}
+function getParamType(target, index) {
+    const paramTypes = Reflect.getMetadata('design:paramtypes', target) || [];
+    return paramTypes[index];
+}
+function getParamMeta(target, index) {
+    const params = getConstructorParams(target);
+    return params[index];
+}
+function storeParamMeta(target, index, meta) {
+    const params = Reflect.getOwnMetadata(INJECTABLE_CONSTRUCTOR_KEY, target) || [];
+    params[index] = meta;
+    Reflect.defineMetadata(INJECTABLE_CONSTRUCTOR_KEY, params, target);
+}
+export function getInjectableMetadata(target) {
+    return Reflect.getOwnMetadata(INJECTABLE_METADATA_KEY, target);
+}
+export function getConstructorParams(target) {
+    const cached = paramsCache.get(target);
+    if (cached)
+        return cached;
+    const params = Reflect.getOwnMetadata(INJECTABLE_CONSTRUCTOR_KEY, target) || [];
+    if (!params.length) {
+        const paramTypes = Reflect.getMetadata('design:paramtypes', target) || [];
+        return paramTypes.map((type, index) => ({ type }));
+    }
+    paramsCache.set(target, params);
+    return params;
+}
+export function getInjectionMetadata(target) {
+    return getConstructorParams(target).map(p => ({ token: p.token || p.type, optional: p.optional }));
+}

package/dist/core/src/index.js

@@ -0,0 +1,14 @@
+export * from './scope';
+export * from './token';
+export * from './decorators';
+export * from './interface';
+export * from './container';
+export * from './test-container';
+import { Pal, PalContainer, createPal, PalCircularDependencyError, PalDependencyNotFoundError } from './container';
+import { PalTestContainer } from './test-container';
+export { Pal as default };
+export const Container = PalContainer;
+export const TestContainer = PalTestContainer;
+export const createContainer = createPal;
+export const CircularDependencyError = PalCircularDependencyError;
+export const DependencyNotFoundError = PalDependencyNotFoundError;

package/dist/core/src/interface.js

@@ -0,0 +1,3 @@
+export const INJECTABLE_METADATA_KEY = Symbol('injectable:metadata');
+export const INJECT_METADATA_KEY = Symbol('inject:metadata');
+export const INJECTABLE_CONSTRUCTOR_KEY = Symbol('injectable:constructor');

package/dist/core/src/scope.js

@@ -0,0 +1,6 @@
+export const Scope = {
+    Singleton: 'singleton',
+    Transient: 'transient',
+    Scoped: 'scoped',
+};
+export const DEFAULT_SCOPE = Scope.Singleton;

package/dist/core/src/test-container.js

@@ -0,0 +1,52 @@
+import { PalContainer } from './container';
+export class PalTestContainer extends PalContainer {
+    constructor() {
+        super(...arguments);
+        this.snapshots = [];
+    }
+    static create() {
+        return new PalTestContainer();
+    }
+    snapshot() {
+        this.snapshots.push({
+            registrations: new Map(this.getRegistrations()),
+            singletons: new Map(this.getSingletons()),
+        });
+    }
+    restore() {
+        const snap = this.snapshots.pop();
+        if (!snap)
+            return;
+        this.restoreFrom(snap);
+    }
+    reset() {
+        super.reset();
+        this.snapshots = [];
+    }
+    clearSnapshots() {
+        this.snapshots = [];
+    }
+    mock(token, mockValue) {
+        const mock = new Proxy({}, {
+            get(_, prop) {
+                if (prop === 'then' || prop === 'catch')
+                    return undefined;
+                if (typeof prop === 'symbol')
+                    return undefined;
+                return mockValue?.[prop] ?? (() => mock);
+            },
+        });
+        this.override(token, { useValue: mock });
+        return mock;
+    }
+    getRegistrations() {
+        return this.registrations;
+    }
+    getSingletons() {
+        return this.singletonCache;
+    }
+    restoreFrom(snap) {
+        this.registrations = snap.registrations;
+        this.singletonCache = snap.singletons;
+    }
+}

package/dist/core/src/token.js

@@ -0,0 +1,6 @@
+export class InjectionToken {
+    constructor(name) {
+        this.name = name;
+        this.toString = () => `InjectionToken(${name})`;
+    }
+}

package/dist/demo.js

@@ -0,0 +1,113 @@
+import 'reflect-metadata';
+import { Pal } from '@paljs/core';
+import { UserRepositoryToken, registerRepositories, } from './index';
+console.log('═══════════════════════════════════════════════════');
+console.log('           @paljs/orm Demo                        ');
+console.log('═══════════════════════════════════════════════════\n');
+async function main() {
+    // ─────────────────────────────────────────────────────────────
+    // SETUP: Create container and register repositories
+    // ─────────────────────────────────────────────────────────────
+    console.log('🔧 Setting up DI container with repositories...\n');
+    const container = Pal.create();
+    registerRepositories(container);
+    const userRepo = container.get(UserRepositoryToken);
+    // ─────────────────────────────────────────────────────────────
+    // CREATE: Add some users
+    // ─────────────────────────────────────────────────────────────
+    console.log('📝 CREATE Users:');
+    const user1 = await userRepo.create({
+        name: 'John Doe',
+        email: 'john@example.com',
+        password: 'secret123',
+        role: 'admin',
+        status: 'active',
+    });
+    console.log('Created:', user1.name, '-', user1.email);
+    const user2 = await userRepo.create({
+        name: 'Jane Smith',
+        email: 'jane@example.com',
+        role: 'user',
+        status: 'active',
+    });
+    console.log('Created:', user2.name, '-', user2.email);
+    const user3 = await userRepo.create({
+        name: 'Bob Wilson',
+        email: 'bob@example.com',
+        role: 'guest',
+        status: 'pending',
+    });
+    console.log('Created:', user3.name, '-', user3.email);
+    // ─────────────────────────────────────────────────────────────
+    // READ: Query users
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n📖 READ Users:');
+    const foundUser = await userRepo.findById(user1.id);
+    console.log('Find by ID:', foundUser?.name);
+    const byEmail = await userRepo.findByEmail('jane@example.com');
+    console.log('Find by email:', byEmail?.name);
+    console.log('Admins:', (await userRepo.findByRole('admin')).map((u) => u.name));
+    console.log('Users:', (await userRepo.findByRole('user')).map((u) => u.name));
+    console.log('Guests:', (await userRepo.findByRole('guest')).map((u) => u.name));
+    console.log('Active users:', (await userRepo.findActive()).map((u) => u.name));
+    console.log('\nPagination example:');
+    const page1 = await userRepo.findMany({ pagination: { skip: 0, take: 2 } });
+    console.log('Page 1 (2 items):', page1.data.map((u) => u.name));
+    console.log('Total count:', page1.total);
+    // ─────────────────────────────────────────────────────────────
+    // UPDATE: Modify users
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n✏️ UPDATE Users:');
+    const updated = await userRepo.update(user3.id, {
+        status: 'active',
+        role: 'user'
+    });
+    console.log('Updated Bob:', updated?.name, '- Status:', updated?.status, '- Role:', updated?.role);
+    // ─────────────────────────────────────────────────────────────
+    // DELETE: Remove users
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n🗑️ DELETE Users:');
+    const deleted = await userRepo.delete(user2.id);
+    console.log('Deleted Jane:', deleted ? 'YES' : 'NO');
+    const jane = await userRepo.findByEmail('jane@example.com');
+    console.log('Jane still exists:', jane ? 'YES (bug!)' : 'NO (correct)');
+    // ─────────────────────────────────────────────────────────────
+    // UTILITY: Count and exists
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n📊 UTILITY Methods:');
+    console.log('Total users:', await userRepo.count());
+    console.log('Active users:', await userRepo.count({ status: 'active' }));
+    console.log('Email exists (john@example.com):', await userRepo.emailExists('john@example.com'));
+    console.log('Email exists (jane@example.com):', await userRepo.emailExists('jane@example.com'));
+    // ─────────────────────────────────────────────────────────────
+    // ADVANCED: Upsert
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n🔄 UPSERT (Insert or Update):');
+    const newUserData = {
+        name: 'New User',
+        email: 'newuser@example.com',
+        role: 'user',
+        status: 'active',
+    };
+    await userRepo.upsert('custom-id', newUserData, { name: 'Updated User' });
+    const upserted = await userRepo.findById('custom-id');
+    console.log('Upserted:', upserted?.name, '- ID:', upserted?.id);
+    await userRepo.upsert('custom-id', newUserData, { name: 'Updated via Upsert' });
+    const updatedViaUpsert = await userRepo.findById('custom-id');
+    console.log('Updated via upsert:', updatedViaUpsert?.name);
+    // ─────────────────────────────────────────────────────────────
+    // Summary
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n' + '═'.repeat(50));
+    console.log('✅ @paljs/orm Demo Complete!');
+    console.log('═'.repeat(50));
+    console.log('\nKey Concepts Demonstrated:');
+    console.log('  • Repository Pattern for data access');
+    console.log('  • BaseRepository with common CRUD operations');
+    console.log('  • Custom repository extensions (UserRepository)');
+    console.log('  • Pagination and sorting support');
+    console.log('  • Upsert operations');
+    console.log('  • DI integration with @paljs/core');
+    console.log('\n');
+}
+main().catch(console.error);

package/dist/index.js

@@ -0,0 +1,14 @@
+import 'reflect-metadata';
+export * from './types';
+export * from './repository';
+export * from './user.repository';
+import { InjectionToken, Scope } from '@paljs/core';
+import { UserRepository } from './user.repository';
+export const UserRepositoryToken = new InjectionToken('user-repository');
+export const OrmConfigToken = new InjectionToken('orm-config');
+export function registerRepositories(container) {
+    container.provide(UserRepositoryToken, {
+        useClass: UserRepository,
+        scope: Scope.Singleton,
+    });
+}

package/dist/orm/src/demo.js

@@ -0,0 +1,113 @@
+import 'reflect-metadata';
+import { Pal } from '@paljs/core';
+import { UserRepositoryToken, registerRepositories, } from './index';
+console.log('═══════════════════════════════════════════════════');
+console.log('           @paljs/orm Demo                        ');
+console.log('═══════════════════════════════════════════════════\n');
+async function main() {
+    // ─────────────────────────────────────────────────────────────
+    // SETUP: Create container and register repositories
+    // ─────────────────────────────────────────────────────────────
+    console.log('🔧 Setting up DI container with repositories...\n');
+    const container = Pal.create();
+    registerRepositories(container);
+    const userRepo = container.get(UserRepositoryToken);
+    // ─────────────────────────────────────────────────────────────
+    // CREATE: Add some users
+    // ─────────────────────────────────────────────────────────────
+    console.log('📝 CREATE Users:');
+    const user1 = await userRepo.create({
+        name: 'John Doe',
+        email: 'john@example.com',
+        password: 'secret123',
+        role: 'admin',
+        status: 'active',
+    });
+    console.log('Created:', user1.name, '-', user1.email);
+    const user2 = await userRepo.create({
+        name: 'Jane Smith',
+        email: 'jane@example.com',
+        role: 'user',
+        status: 'active',
+    });
+    console.log('Created:', user2.name, '-', user2.email);
+    const user3 = await userRepo.create({
+        name: 'Bob Wilson',
+        email: 'bob@example.com',
+        role: 'guest',
+        status: 'pending',
+    });
+    console.log('Created:', user3.name, '-', user3.email);
+    // ─────────────────────────────────────────────────────────────
+    // READ: Query users
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n📖 READ Users:');
+    const foundUser = await userRepo.findById(user1.id);
+    console.log('Find by ID:', foundUser?.name);
+    const byEmail = await userRepo.findByEmail('jane@example.com');
+    console.log('Find by email:', byEmail?.name);
+    console.log('Admins:', (await userRepo.findByRole('admin')).map((u) => u.name));
+    console.log('Users:', (await userRepo.findByRole('user')).map((u) => u.name));
+    console.log('Guests:', (await userRepo.findByRole('guest')).map((u) => u.name));
+    console.log('Active users:', (await userRepo.findActive()).map((u) => u.name));
+    console.log('\nPagination example:');
+    const page1 = await userRepo.findMany({ pagination: { skip: 0, take: 2 } });
+    console.log('Page 1 (2 items):', page1.data.map((u) => u.name));
+    console.log('Total count:', page1.total);
+    // ─────────────────────────────────────────────────────────────
+    // UPDATE: Modify users
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n✏️ UPDATE Users:');
+    const updated = await userRepo.update(user3.id, {
+        status: 'active',
+        role: 'user'
+    });
+    console.log('Updated Bob:', updated?.name, '- Status:', updated?.status, '- Role:', updated?.role);
+    // ─────────────────────────────────────────────────────────────
+    // DELETE: Remove users
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n🗑️ DELETE Users:');
+    const deleted = await userRepo.delete(user2.id);
+    console.log('Deleted Jane:', deleted ? 'YES' : 'NO');
+    const jane = await userRepo.findByEmail('jane@example.com');
+    console.log('Jane still exists:', jane ? 'YES (bug!)' : 'NO (correct)');
+    // ─────────────────────────────────────────────────────────────
+    // UTILITY: Count and exists
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n📊 UTILITY Methods:');
+    console.log('Total users:', await userRepo.count());
+    console.log('Active users:', await userRepo.count({ status: 'active' }));
+    console.log('Email exists (john@example.com):', await userRepo.emailExists('john@example.com'));
+    console.log('Email exists (jane@example.com):', await userRepo.emailExists('jane@example.com'));
+    // ─────────────────────────────────────────────────────────────
+    // ADVANCED: Upsert
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n🔄 UPSERT (Insert or Update):');
+    const newUserData = {
+        name: 'New User',
+        email: 'newuser@example.com',
+        role: 'user',
+        status: 'active',
+    };
+    await userRepo.upsert('custom-id', newUserData, { name: 'Updated User' });
+    const upserted = await userRepo.findById('custom-id');
+    console.log('Upserted:', upserted?.name, '- ID:', upserted?.id);
+    await userRepo.upsert('custom-id', newUserData, { name: 'Updated via Upsert' });
+    const updatedViaUpsert = await userRepo.findById('custom-id');
+    console.log('Updated via upsert:', updatedViaUpsert?.name);
+    // ─────────────────────────────────────────────────────────────
+    // Summary
+    // ─────────────────────────────────────────────────────────────
+    console.log('\n' + '═'.repeat(50));
+    console.log('✅ @paljs/orm Demo Complete!');
+    console.log('═'.repeat(50));
+    console.log('\nKey Concepts Demonstrated:');
+    console.log('  • Repository Pattern for data access');
+    console.log('  • BaseRepository with common CRUD operations');
+    console.log('  • Custom repository extensions (UserRepository)');
+    console.log('  • Pagination and sorting support');
+    console.log('  • Upsert operations');
+    console.log('  • DI integration with @paljs/core');
+    console.log('\n');
+}
+main().catch(console.error);

package/dist/orm/src/index.js

@@ -0,0 +1,14 @@
+import 'reflect-metadata';
+export * from './types';
+export * from './repository';
+export * from './user.repository';
+import { InjectionToken, Scope } from '@paljs/core';
+import { UserRepository } from './user.repository';
+export const UserRepositoryToken = new InjectionToken('user-repository');
+export const OrmConfigToken = new InjectionToken('orm-config');
+export function registerRepositories(container) {
+    container.provide(UserRepositoryToken, {
+        useClass: UserRepository,
+        scope: Scope.Singleton,
+    });
+}

package/dist/orm/src/repository.js

@@ -0,0 +1,114 @@
+export class BaseRepository {
+    constructor() {
+        this.collection = new Map();
+    }
+    async findById(id) {
+        return this.collection.get(id) || null;
+    }
+    async findOne(where) {
+        for (const item of this.collection.values()) {
+            if (this.matches(item, where))
+                return item;
+        }
+        return null;
+    }
+    async findMany(options) {
+        let results = Array.from(this.collection.values());
+        if (options?.where) {
+            results = results.filter(item => this.matches(item, options.where));
+        }
+        if (options?.sort) {
+            results = this.sort(results, options.sort);
+        }
+        const total = results.length;
+        const skip = options?.pagination?.skip ?? options?.pagination?.offset ?? 0;
+        const take = options?.pagination?.take ?? options?.pagination?.limit ?? total;
+        results = results.slice(skip, skip + take);
+        return { data: results, total, skip, take };
+    }
+    async findAll(where) {
+        if (!where)
+            return Array.from(this.collection.values());
+        return Array.from(this.collection.values()).filter(item => this.matches(item, where));
+    }
+    async create(data) {
+        const entity = this.toEntity(data);
+        this.collection.set(entity.id, entity);
+        return entity;
+    }
+    async createMany(data) {
+        return Promise.all(data.map(d => this.create(d)));
+    }
+    async update(id, data) {
+        const existing = this.collection.get(id);
+        if (!existing)
+            return null;
+        const updateData = this.toUpdateData(data);
+        const filteredUpdate = {};
+        for (const [key, value] of Object.entries(updateData)) {
+            if (value !== undefined) {
+                filteredUpdate[key] = value;
+            }
+        }
+        const updated = {
+            ...existing,
+            ...filteredUpdate,
+            updatedAt: new Date(),
+        };
+        this.collection.set(id, updated);
+        return updated;
+    }
+    async upsert(id, createData, updateData) {
+        const existing = await this.findById(id);
+        if (existing) {
+            return (await this.update(id, updateData));
+        }
+        const entity = { ...createData };
+        const created = await this.create(entity);
+        this.collection.delete(created.id);
+        const withId = { ...created, id };
+        this.collection.set(id, withId);
+        return withId;
+    }
+    async delete(id) {
+        return this.collection.delete(id);
+    }
+    async deleteMany(ids) {
+        let count = 0;
+        for (const id of ids) {
+            if (this.collection.delete(id))
+                count++;
+        }
+        return count;
+    }
+    async count(where) {
+        if (!where)
+            return this.collection.size;
+        return Array.from(this.collection.values()).filter(item => this.matches(item, where)).length;
+    }
+    async exists(where) {
+        return (await this.findOne(where)) !== null;
+    }
+    matches(item, where) {
+        return Object.entries(where).every(([key, value]) => item[key] === value);
+    }
+    sort(items, sort) {
+        return [...items].sort((a, b) => {
+            const aVal = a[sort.field];
+            const bVal = b[sort.field];
+            if (aVal === bVal || aVal === undefined || bVal === undefined) {
+                if (aVal === undefined && bVal === undefined)
+                    return 0;
+                return aVal === undefined ? 1 : -1;
+            }
+            const cmp = aVal < bVal ? -1 : 1;
+            return sort.order === 'desc' ? -cmp : cmp;
+        });
+    }
+    generateId() {
+        return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    }
+    clear() {
+        this.collection.clear();
+    }
+}

package/dist/orm/src/types.js

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

package/dist/orm/src/user.repository.js

@@ -0,0 +1,43 @@
+import { BaseRepository } from './repository';
+export class UserRepository extends BaseRepository {
+    toEntity(data) {
+        const now = new Date();
+        return {
+            id: this.generateId(),
+            name: data.name,
+            email: data.email,
+            password: data.password,
+            avatar: data.avatar,
+            status: data.status || 'pending',
+            role: data.role || 'user',
+            createdAt: now,
+        };
+    }
+    toUpdateData(data) {
+        return {
+            name: data.name,
+            email: data.email,
+            password: data.password,
+            avatar: data.avatar,
+            status: data.status,
+            role: data.role,
+        };
+    }
+    async findByEmail(email) {
+        return this.findOne({ email });
+    }
+    async findByRole(role) {
+        return this.findAll({ role });
+    }
+    async findActive() {
+        return this.findAll({ status: 'active' });
+    }
+    async emailExists(email, excludeId) {
+        const user = await this.findByEmail(email);
+        if (!user)
+            return false;
+        if (excludeId && user.id === excludeId)
+            return false;
+        return true;
+    }
+}

package/dist/repository.js

@@ -0,0 +1,114 @@
+export class BaseRepository {
+    constructor() {
+        this.collection = new Map();
+    }
+    async findById(id) {
+        return this.collection.get(id) || null;
+    }
+    async findOne(where) {
+        for (const item of this.collection.values()) {
+            if (this.matches(item, where))
+                return item;
+        }
+        return null;
+    }
+    async findMany(options) {
+        let results = Array.from(this.collection.values());
+        if (options?.where) {
+            results = results.filter(item => this.matches(item, options.where));
+        }
+        if (options?.sort) {
+            results = this.sort(results, options.sort);
+        }
+        const total = results.length;
+        const skip = options?.pagination?.skip ?? options?.pagination?.offset ?? 0;
+        const take = options?.pagination?.take ?? options?.pagination?.limit ?? total;
+        results = results.slice(skip, skip + take);
+        return { data: results, total, skip, take };
+    }
+    async findAll(where) {
+        if (!where)
+            return Array.from(this.collection.values());
+        return Array.from(this.collection.values()).filter(item => this.matches(item, where));
+    }
+    async create(data) {
+        const entity = this.toEntity(data);
+        this.collection.set(entity.id, entity);
+        return entity;
+    }
+    async createMany(data) {
+        return Promise.all(data.map(d => this.create(d)));
+    }
+    async update(id, data) {
+        const existing = this.collection.get(id);
+        if (!existing)
+            return null;
+        const updateData = this.toUpdateData(data);
+        const filteredUpdate = {};
+        for (const [key, value] of Object.entries(updateData)) {
+            if (value !== undefined) {
+                filteredUpdate[key] = value;
+            }
+        }
+        const updated = {
+            ...existing,
+            ...filteredUpdate,
+            updatedAt: new Date(),
+        };
+        this.collection.set(id, updated);
+        return updated;
+    }
+    async upsert(id, createData, updateData) {
+        const existing = await this.findById(id);
+        if (existing) {
+            return (await this.update(id, updateData));
+        }
+        const entity = { ...createData };
+        const created = await this.create(entity);
+        this.collection.delete(created.id);
+        const withId = { ...created, id };
+        this.collection.set(id, withId);
+        return withId;
+    }
+    async delete(id) {
+        return this.collection.delete(id);
+    }
+    async deleteMany(ids) {
+        let count = 0;
+        for (const id of ids) {
+            if (this.collection.delete(id))
+                count++;
+        }
+        return count;
+    }
+    async count(where) {
+        if (!where)
+            return this.collection.size;
+        return Array.from(this.collection.values()).filter(item => this.matches(item, where)).length;
+    }
+    async exists(where) {
+        return (await this.findOne(where)) !== null;
+    }
+    matches(item, where) {
+        return Object.entries(where).every(([key, value]) => item[key] === value);
+    }
+    sort(items, sort) {
+        return [...items].sort((a, b) => {
+            const aVal = a[sort.field];
+            const bVal = b[sort.field];
+            if (aVal === bVal || aVal === undefined || bVal === undefined) {
+                if (aVal === undefined && bVal === undefined)
+                    return 0;
+                return aVal === undefined ? 1 : -1;
+            }
+            const cmp = aVal < bVal ? -1 : 1;
+            return sort.order === 'desc' ? -cmp : cmp;
+        });
+    }
+    generateId() {
+        return `${Date.now()}-${Math.random().toString(36).slice(2, 9)}`;
+    }
+    clear() {
+        this.collection.clear();
+    }
+}

package/dist/types.js

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

package/dist/user.repository.js

@@ -0,0 +1,43 @@
+import { BaseRepository } from './repository';
+export class UserRepository extends BaseRepository {
+    toEntity(data) {
+        const now = new Date();
+        return {
+            id: this.generateId(),
+            name: data.name,
+            email: data.email,
+            password: data.password,
+            avatar: data.avatar,
+            status: data.status || 'pending',
+            role: data.role || 'user',
+            createdAt: now,
+        };
+    }
+    toUpdateData(data) {
+        return {
+            name: data.name,
+            email: data.email,
+            password: data.password,
+            avatar: data.avatar,
+            status: data.status,
+            role: data.role,
+        };
+    }
+    async findByEmail(email) {
+        return this.findOne({ email });
+    }
+    async findByRole(role) {
+        return this.findAll({ role });
+    }
+    async findActive() {
+        return this.findAll({ status: 'active' });
+    }
+    async emailExists(email, excludeId) {
+        const user = await this.findByEmail(email);
+        if (!user)
+            return false;
+        if (excludeId && user.id === excludeId)
+            return false;
+        return true;
+    }
+}

package/package.json

@@ -0,0 +1,30 @@
+{
+  "name": "@rpal/orm",
+  "version": "1.0.0",
+  "description": "ORM utilities and decorators for PalJS",
+  "license": "MIT",
+  "main": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/paljs/paljs.git"
+  },
+  "files": [
+    "dist"
+  ],
+  "dependencies": {
+    "@rpal/core": "^1.0.0"
+  },
+  "peerDependencies": {
+    "reflect-metadata": "^0.2.0"
+  },
+  "devDependencies": {
+    "tsx": "^4.0.0",
+    "vitest": "^3.0.0"
+  },
+  "scripts": {
+    "build": "tsc -p tsconfig.json",
+    "dev": "tsx src/demo.ts",
+    "test": "vitest run"
+  }
+}