import { SmrtCollection } from '@happyvertical/smrt-core';
import { Role } from '../models/Role.js';
import { RolePermissionPatternMatrix, SeedRolePermissionsOptions } from './RolePermissionCollection.js';
export interface SeedSystemRolesOptions extends Omit<SeedRolePermissionsOptions, 'catalog'> {
    permissionMatrix?: RolePermissionPatternMatrix;
    seedPermissions?: boolean;
    /**
     * System role slugs to flag `inheritsToDescendants: true` (opt-in
     * hierarchical membership inheritance, e.g. `['owner', 'admin']` for
     * organizational hierarchies). Additive and idempotent: listed slugs are
     * flagged on create and on already-seeded roles, but omitting a slug never
     * unsets a previously flagged role — unflag explicitly via a role update.
     * Unknown slugs throw (a typo here would silently withhold intended
     * authority). Default: no role inherits.
     */
    inheritsToDescendants?: string[];
}
/**
 * Collection for managing Role objects
 */
export declare class RoleCollection extends SmrtCollection<Role> {
    static readonly _itemClass: typeof Role;
    /**
     * Find all system roles (tenantId is null)
     */
    findSystemRoles(): Promise<Role[]>;
    /**
     * Find roles available for a tenant (system + tenant-specific)
     */
    findByTenant(tenantId: string): Promise<Role[]>;
    /**
     * Find tenant-specific roles only
     */
    findTenantRoles(tenantId: string): Promise<Role[]>;
    /**
     * Find role by slug within a tenant context
     */
    findBySlug(slug: string, tenantId?: string): Promise<Role | null>;
    /** Find a built-in system role only; tenant slug collisions never match. */
    findSystemRoleBySlug(slug: string): Promise<Role | null>;
    /**
     * Seed default system roles
     */
    seedSystemRoles(options?: SeedSystemRolesOptions): Promise<Role[]>;
}
//# sourceMappingURL=RoleCollection.d.ts.map