Skip to content

AccessService

katanakit-js / AccessService

Defined in: core/services/access.service.ts:272

AccessService - Singleton facade con Strategy Pattern.

Centraliza el control de acceso (roles y capacidades) delegando el algoritmo concreto en una IAccessStrategy intercambiable. Por defecto usa HierarchicalAccessStrategy.

// Uso con la estrategia por defecto (jerárquica)
AccessService.getInstance().useCan({ id: 1, roles: ["admin"] }, "members:manage");
// Cambiar a estrategia plana en runtime
AccessService.getInstance().useSetStrategy(new FlatAccessStrategy());
useCan(subject, capability): boolean;

Defined in: core/services/access.service.ts:358

Whether the subject may perform a capability (delegado a la estrategia activa).

Parameter Type
subject { [key: string]: unknown; id: string | number; roles: string[]; }
subject.id? string | number
subject.roles? string[]
capability string

boolean


useCapabilitiesFor(role): string[];

Defined in: core/services/access.service.ts:329

Effective capabilities of a role (delegado a la estrategia activa).

Parameter Type
role string

string[]


useGetStrategy(): IAccessStrategy;

Defined in: core/services/access.service.ts:322

Returns the currently active strategy.

IAccessStrategy


useHasRole(subject, role): boolean;

Defined in: core/services/access.service.ts:351

Exact role membership - no hierarchy involved.

Parameter Type
subject { [key: string]: unknown; id: string | number; roles: string[]; }
subject.id? string | number
subject.roles? string[]
role string

boolean


useRegisterRole(definition): void;

Defined in: core/services/access.service.ts:336

Registers (or replaces) a role definition (delegado a la estrategia activa).

Parameter Type
definition { capabilities: string[]; label: string; rank: number; slug: string; }
definition.capabilities? string[]
definition.label? string
definition.rank? number
definition.slug? string

void


useResetRoles(): void;

Defined in: core/services/access.service.ts:341

Restores the built-in role registry (delegado a la estrategia activa).

void


useRoles(): {
capabilities: string[];
label: string;
rank: number;
slug: string;
}[];

Defined in: core/services/access.service.ts:346

Lists every registered role definition (delegado a la estrategia activa).

{ capabilities: string[]; label: string; rank: number; slug: string; }[]


useSetStrategy(strategy): void;

Defined in: core/services/access.service.ts:317

Intercambia la estrategia de acceso en runtime (Strategy Pattern).

Parameter Type Description
strategy IAccessStrategy La nueva estrategia a utilizar.

void


static create(strategy?): AccessService;

Defined in: core/services/access.service.ts:308

Crea una instancia NO-singleton con una estrategia específica. Útil para tests o para aislar varios contextos de acceso.

Parameter Type Description
strategy? IAccessStrategy Estrategia a inyectar.

AccessService

Una nueva instancia de AccessService.

const flatAccess = AccessService.create(new FlatAccessStrategy());

static getInstance(): AccessService;

Defined in: core/services/access.service.ts:289

Obtiene la instancia única del AccessService (Singleton).

AccessService

La instancia única de AccessService.