Define query patterns once, use everywhere. Clean, type-safe, and composable.
Define where, select, relations, order, and pagination once. Apply anywhere with a simple API.
Full TypeScript support with IDE autocomplete for scope names. Catch typos at compile-time.
Decorator-based syntax keeps your entities clean and your queries readable.
Scopes are resolved at query time with no performance penalty. Just clean code.
Combine multiple scopes intelligently. Smart merging handles where, select, relations, and more.
Works seamlessly with existing TypeORM code. No breaking changes to your current setup.
import { Scopes, DefaultScope, getScopedRepository } from 'typeorm-query-scopes';
@DefaultScope<User>({ where: { isActive: true } })
@Scopes<User, {
verified: any;
admin: any;
withPosts: any;
}>({
verified: { where: { isVerified: true } },
admin: { where: { role: 'admin' } },
withPosts: { relations: { posts: true } }
})
@Entity()
class User {
@PrimaryGeneratedColumn()
id: number;
@Column()
email: string;
@Column()
role: string;
@Column({ default: true })
isActive: boolean;
@Column({ default: false })
isVerified: boolean;
}
// Usage
const userRepo = getScopedRepository(User, dataSource);
// Simple scope
const verified = await userRepo.scope('verified').find();
// Multiple scopes
const verifiedAdmins = await userRepo.scope('verified', 'admin').find();
// With relations
const usersWithPosts = await userRepo.scope('withPosts').find();
// Remove default scope
const allUsers = await userRepo.unscoped().find();npm install typeorm-query-scopesyarn add typeorm-query-scopespnpm add typeorm-query-scopesDRY Principle
Stop repeating the same query patterns. Define once, use everywhere.
Better Maintenance
Change query logic in one place instead of hunting through dozens of files.
Type Safety
Get IDE autocomplete and compile-time validation for scope names.
Beta Release
This is version 1.0.0. The API is stable but may change based on community feedback. Please report any issues on GitHub!