@via-profit/ability 3.4.0 → 3.5.0

package/package.json

@@ -1,73 +1,74 @@
-{
-  "name": "@via-profit/ability",
-  "support": "https://via-profit.ru",
-  "version": "3.4.0",
-  "description": "Via-Profit Ability service",
-  "keywords": [
-    "ability",
-    "access",
-    "via-profit"
-  ],
-  "main": "./dist/index.js",
-  "engines": {
-    "node": ">= 17.0.0",
-    "npm": ">= 8.19.3"
-  },
-  "files": [
-    "dist",
-    "README.md",
-    "LICENSE",
-    "CHANGELOG.md",
-    "CONTRIBUTING.md",
-    "SECURITY.md"
-  ],
-  "scripts": {
-    "build": "rollup -c",
-    "build:dev": "cross-env NODE_ENV=development rollup -c -w",
-    "bench": "npm run build && node ./bench/benchmark.js",
-    "test": "jest",
-    "lint": "tsc --noEmit && eslint --fix .",
-    "pretty": "prettier --write ./src"
-  },
-  "repository": {
-    "type": "git",
-    "url": "https://github.com/via-profit/ability.git"
-  },
-  "author": {
-    "name": "Via Profit",
-    "url": "https://dev.via-profit.ru"
-  },
-  "contributors": [
-    "Vasily Novosad <delhsmail@gmail.com>",
-    "Pavel Natalin <trubonru@gmail.com>"
-  ],
-  "license": "MIT",
-  "devDependencies": {
-    "@eslint/js": "^9.13.0",
-    "@jagi/jest-transform-graphql": "^1.0.2",
-    "@jest/types": "^29.6.3",
-    "@rollup/plugin-alias": "^6.0.0",
-    "@rollup/plugin-commonjs": "^29.0.2",
-    "@rollup/plugin-node-resolve": "^16.0.3",
-    "@rollup/plugin-typescript": "^12.3.0",
-    "@types/jest": "^29.5.13",
-    "@types/node": "^22.7.7",
-    "@types/nodemon": "^1.19.6",
-    "concurrently": "^9.0.1",
-    "cross-env": "^7.0.3",
-    "eslint": "^9.13.0",
-    "globals": "^15.11.0",
-    "jest": "^29.7.0",
-    "jest-transform-graphql": "^2.1.0",
-    "nodemon": "^3.1.7",
-    "prettier": "^3.3.3",
-    "rollup": "^4.60.0",
-    "rollup-plugin-copy": "^3.5.0",
-    "tinybench": "^6.0.0",
-    "ts-jest": "^29.2.5",
-    "ts-loader": "^9.5.1",
-    "ts-node": "^10.9.2",
-    "typescript": "^5.6.3",
-    "typescript-eslint": "^8.10.0"
-  }
-}
+{
+  "name": "@via-profit/ability",
+  "support": "https://via-profit.ru",
+  "version": "3.5.0",
+  "description": "Via-Profit Ability service",
+  "keywords": [
+    "ability",
+    "access",
+    "via-profit"
+  ],
+  "main": "./dist/index.js",
+  "engines": {
+    "node": ">= 17.0.0",
+    "npm": ">= 8.19.3"
+  },
+  "files": [
+    "dist",
+    "README.md",
+    "LICENSE",
+    "CHANGELOG.md",
+    "CONTRIBUTING.md",
+    "SECURITY.md"
+  ],
+  "scripts": {
+    "build": "rollup -c",
+    "build:dev": "cross-env NODE_ENV=development rollup -c -w",
+    "bench": "npm run build && node ./bench/benchmark.js",
+    "test": "jest",
+    "lint": "tsc --noEmit && eslint --fix .",
+    "pretty": "prettier --write ./src"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/via-profit/ability.git"
+  },
+  "author": {
+    "name": "Via Profit",
+    "url": "https://dev.via-profit.ru"
+  },
+  "contributors": [
+    "Vasily Novosad <delhsmail@gmail.com>",
+    "Pavel Natalin <trubonru@gmail.com>"
+  ],
+  "license": "MIT",
+  "devDependencies": {
+    "@eslint/js": "^10.0.1",
+    "@jagi/jest-transform-graphql": "^1.0.2",
+    "@jest/types": "^30.3.0",
+    "@rollup/plugin-alias": "^6.0.0",
+    "@rollup/plugin-commonjs": "^29.0.2",
+    "@rollup/plugin-node-resolve": "^16.0.3",
+    "@rollup/plugin-typescript": "^12.3.0",
+    "@types/jest": "^30.0.0",
+    "@types/node": "^25.5.0",
+    "concurrently": "^9.2.1",
+    "cross-env": "^10.1.0",
+    "eslint": "^10.1.0",
+    "eslint-plugin-jest": "^29.15.1",
+    "globals": "^17.4.0",
+    "jest": "^30.3.0",
+    "jest-transform-graphql": "^2.1.0",
+    "nodemon": "^3.1.14",
+    "prettier": "^3.8.1",
+    "rollup": "^4.60.1",
+    "rollup-plugin-copy": "^3.5.0",
+    "rollup-plugin-dts": "^6.4.1",
+    "tinybench": "^6.0.0",
+    "ts-jest": "^29.4.9",
+    "ts-loader": "^9.5.4",
+    "ts-node": "^10.9.2",
+    "typescript": "^6.0.2",
+    "typescript-eslint": "^8.58.0"
+  }
+}

package/dist/cache/AbilityCacheAdapter.d.ts

@@ -1,8 +0,0 @@
-export interface AbilityCacheAdapter {
-    get<T = unknown>(key: string): Promise<T | undefined>;
-    set<T = unknown>(key: string, value: T, ttlSeconds?: number): Promise<void>;
-    serialize<T = unknown>(input: T): string;
-    delete(key: string): Promise<void>;
-    clear(): Promise<void>;
-    deleteByPrefix(prefix: string): Promise<void>;
-}

package/dist/cache/AbilityInMemoryCache.d.ts

@@ -1,12 +0,0 @@
-import { AbilityCacheAdapter } from '../cache/AbilityCacheAdapter';
-export declare class AbilityInMemoryCache implements AbilityCacheAdapter {
-    private store;
-    get<T>(key: string): Promise<T | undefined>;
-    set<T>(key: string, value: T, ttlSeconds?: number): Promise<void>;
-    serialize(input: unknown): string;
-    delete(key: string): Promise<void>;
-    clear(): Promise<void>;
-    deleteByPrefix(prefix: string): Promise<void>;
-    private fastHash;
-    private stableStringify;
-}

package/dist/core/AbilityCode.d.ts

@@ -1,8 +0,0 @@
-export declare class AbilityCode<Code extends string | number> {
-    _code: Code;
-    constructor(code: Code);
-    get code(): Code;
-    isEqual(compareWith: AbilityCode<Code> | null): boolean;
-    isNotEqual(compareWith: AbilityCode<Code> | null): boolean;
-}
-export default AbilityCode;

package/dist/core/AbilityCompare.d.ts

@@ -1,7 +0,0 @@
-import AbilityCode from './AbilityCode';
-export type AbilityCompareCodeType = 'and' | 'or';
-export declare class AbilityCompare extends AbilityCode<AbilityCompareCodeType> {
-    static and: AbilityCompare;
-    static or: AbilityCompare;
-}
-export default AbilityCompare;

package/dist/core/AbilityCondition.d.ts

@@ -1,23 +0,0 @@
-import AbilityCode from './AbilityCode';
-export type AbilityConditionCodeType = '=' | '<>' | '>' | '<' | '>=' | '<=' | 'in' | 'not in' | 'contains' | 'not contains' | 'length greater than' | 'length less than' | 'length equals' | 'always' | 'never';
-export type AbilityConditionLiteralType = 'equals' | 'not_equals' | 'contains' | 'no_contains' | 'in' | 'not_in' | 'greater_than' | 'less_than' | 'less_or_equal' | 'greater_or_equal' | 'length_greater_than' | 'length_less_than' | 'length_equals' | 'always' | 'never';
-export declare class AbilityCondition extends AbilityCode<AbilityConditionCodeType> {
-    static equals: AbilityCondition;
-    static not_equals: AbilityCondition;
-    static greater_than: AbilityCondition;
-    static less_than: AbilityCondition;
-    static less_or_equal: AbilityCondition;
-    static greater_or_equal: AbilityCondition;
-    static in: AbilityCondition;
-    static not_in: AbilityCondition;
-    static contains: AbilityCondition;
-    static not_contains: AbilityCondition;
-    static length_greater_than: AbilityCondition;
-    static length_less_than: AbilityCondition;
-    static length_equals: AbilityCondition;
-    static always: AbilityCondition;
-    static never: AbilityCondition;
-    static fromLiteral(literal: AbilityConditionLiteralType): AbilityCondition;
-    get literal(): AbilityConditionLiteralType;
-}
-export default AbilityCondition;

package/dist/core/AbilityError.d.ts

@@ -1,6 +0,0 @@
-export declare class AbilityError extends Error {
-    constructor(message: string);
-}
-export declare class AbilityParserError extends Error {
-    constructor(message: string);
-}

package/dist/core/AbilityExplain.d.ts

@@ -1,27 +0,0 @@
-import AbilityRule from './AbilityRule';
-import AbilityRuleSet from '../core/AbilityRuleSet';
-import AbilityPolicy from '../core/AbilityPolicy';
-import AbilityMatch from '../core/AbilityMatch';
-export type AbilityExplainConfig = {
-    readonly type: AbilityExplainType;
-    readonly name: string;
-    readonly match: AbilityMatch;
-};
-export declare class AbilityExplain {
-    readonly type: AbilityExplainType;
-    readonly children: AbilityExplain[];
-    readonly name: string;
-    readonly match: AbilityMatch;
-    constructor(config: AbilityExplainConfig, children?: AbilityExplain[]);
-    toString(indent?: number): string;
-}
-export declare class AbilityExplainRule extends AbilityExplain {
-    constructor(rule: AbilityRule);
-}
-export declare class AbilityExplainRuleSet extends AbilityExplain {
-    constructor(ruleSet: AbilityRuleSet);
-}
-export declare class AbilityExplainPolicy extends AbilityExplain {
-    constructor(policy: AbilityPolicy);
-}
-export type AbilityExplainType = 'policy' | 'rule' | 'ruleSet';

package/dist/core/AbilityMatch.d.ts

@@ -1,8 +0,0 @@
-import AbilityCode from './AbilityCode';
-export type AbilityMatchCodeType = 'pending' | 'match' | 'mismatch';
-export declare class AbilityMatch extends AbilityCode<AbilityMatchCodeType> {
-    static pending: AbilityMatch;
-    static match: AbilityMatch;
-    static mismatch: AbilityMatch;
-}
-export default AbilityMatch;

package/dist/core/AbilityParser.d.ts

@@ -1,61 +0,0 @@
-import AbilityPolicy from './AbilityPolicy';
-export type Primitive = string | number | boolean | null | undefined;
-export type NestedDict<T = Primitive> = {
-    [key: string]: NestedDict<T> | T;
-};
-export type ResourceObject = Record<string, unknown>;
-export type ResourcesMap = Record<string, ResourceObject>;
-export declare class AbilityParser {
-    /**
-     * Sets a value in a nested object structure based on a dot/bracket notation path.
-     * @param object - The target object to modify.
-     * @param path - The path to the property in dot/bracket notation.
-     * @param value - The value to set at the specified path.
-     */
-    static setValueDotValue<T extends Primitive>(object: NestedDict<T>, path: string, value: T): void;
-    /**
-     * Generates TypeScript type definitions based on the provided policies.
-     * @param policies - An array of AbilityPolicy instances.
-     * @returns A generated type definitions.
-     */
-    static generateTypeDefs(policies: readonly AbilityPolicy[]): string;
-    /**
-     * Determines TypeScript type based on the rule
-     * @param rule - The rule to analyze
-     * @returns TypeScript type as string
-     */
-    private static determineTypeFromRule;
-    /**
-     * Gets TypeScript type for array values
-     * @param resource - The resource value to analyze
-     * @returns TypeScript array type as string
-     */
-    private static getArrayType;
-    /**
-     * Gets primitive TypeScript type for a value
-     * @param value - The value to analyze
-     * @returns TypeScript primitive type as string
-     */
-    private static getPrimitiveType;
-    /**
-     * Builds nested structure from flat paths
-     * Example: 'user.profile.name' -> { user: { profile: { name: 'string' } } }
-     * @param flatStructure - Flat structure with dot notation paths
-     * @returns Nested object structure
-     */
-    private static buildNestedStructure;
-    /**
-     * Formats type structure into a string
-     * @param structure - Nested type structure
-     * @returns Formatted TypeScript type definition string
-     */
-    private static formatTypeDefinitions;
-    /**
-     * Recursively formats nested object
-     * @param obj - Object to format
-     * @param indent - Current indentation level
-     * @returns Formatted string
-     */
-    private static formatNestedObject;
-}
-export default AbilityParser;

package/dist/core/AbilityPolicy.d.ts

@@ -1,79 +0,0 @@
-import AbilityRuleSet, { AbilityRuleSetConfig } from './AbilityRuleSet';
-import AbilityMatch from './AbilityMatch';
-import AbilityCompare, { AbilityCompareCodeType } from './AbilityCompare';
-import AbilityPolicyEffect, { AbilityPolicyEffectCodeType } from './AbilityPolicyEffect';
-import { AbilityExplain } from './AbilityExplain';
-import { ResourceObject } from './AbilityTypeGenerator';
-export type AbilityPolicyConfig = {
-    readonly permission: string;
-    readonly effect: AbilityPolicyEffectCodeType;
-    readonly compareMethod: AbilityCompareCodeType;
-    readonly ruleSet: readonly AbilityRuleSetConfig[];
-    readonly id: string;
-    readonly name: string;
-};
-export type AbilityPolicyConstructorProps = {
-    id: string;
-    name: string;
-    permission: string;
-    effect: AbilityPolicyEffect;
-    compareMethod?: AbilityCompare;
-};
-export declare class AbilityPolicy<Resource extends ResourceObject = Record<string, unknown>, Environment = unknown> {
-    matchState: AbilityMatch;
-    /**
-     * List of rules
-     */
-    ruleSet: AbilityRuleSet<Resource, Environment>[];
-    /**
-     * Policy effect
-     */
-    effect: AbilityPolicyEffect;
-    /**
-     * Rules compare method.\
-     * For the «and» method the rule will be permitted if all\
-     * rules will be returns «permit» status and for the «or» - if\
-     * one of the rules returns as «permit»
-     */
-    compareMethod: AbilityCompare;
-    /**
-     * Policy name
-     */
-    name: string;
-    /**
-     * Policy ID
-     */
-    id: string;
-    /**
-     * Running the `enforce` or `resolve` method
-     * will select only those from all passed policies that fall under the specified permission key.
-     */
-    permission: string;
-    constructor(params: AbilityPolicyConstructorProps);
-    /**
-     * Add rule set to the policy
-     * @param ruleSet - The rule set to add
-     */
-    addRuleSet(ruleSet: AbilityRuleSet<Resource, Environment>): this;
-    /**
-     * Add rule set to the policy
-     * @param ruleSets - The array of rule set to add
-     */
-    addRuleSets(ruleSets: readonly AbilityRuleSet<Resource, Environment>[]): this;
-    /**
-     * Check if the policy is matched
-     * @param resource - The resource to check
-     * @param environment - The user environment object
-     */
-    check(resource: Resource, environment?: Environment): Promise<AbilityMatch>;
-    explain(): AbilityExplain;
-    copyWith(props: Partial<{
-        id: string;
-        name: string;
-        permission: string;
-        effect: AbilityPolicyEffect;
-        compareMethod: AbilityCompare;
-        ruleSet: AbilityRuleSet<Resource, Environment>[];
-    }>): AbilityPolicy<Resource, Environment>;
-}
-export default AbilityPolicy;

package/dist/core/AbilityPolicyEffect.d.ts

@@ -1,7 +0,0 @@
-import AbilityCode from './AbilityCode';
-export type AbilityPolicyEffectCodeType = 'deny' | 'permit';
-export declare class AbilityPolicyEffect extends AbilityCode<AbilityPolicyEffectCodeType> {
-    static deny: AbilityPolicyEffect;
-    static permit: AbilityPolicyEffect;
-}
-export default AbilityPolicyEffect;

package/dist/core/AbilityResolver.d.ts

@@ -1,35 +0,0 @@
-import AbilityPolicy from './AbilityPolicy';
-import { AbilityResult } from './AbilityResult';
-import { ResourcesMap } from './AbilityTypeGenerator';
-import { AbilityCacheAdapter } from '../cache/AbilityCacheAdapter';
-export type AbilityResolverOptions = {
-    readonly cache?: AbilityCacheAdapter | null;
-};
-export declare class AbilityResolver<Resources extends ResourcesMap, Environment = unknown> {
-    private policies;
-    private readonly cache?;
-    constructor(
-    /**
-     * `Important!` The incorrect Resources type was intentionally passed to AbilityPolicy so that TypeScript could suggest the name of the permission and the structure of its resource in the parse method.
-     */
-    policyOrListOfPolicies: readonly AbilityPolicy<Resources>[] | AbilityPolicy<Resources>, options?: AbilityResolverOptions);
-    /**
-     * Resolve policy for the resource and permission key
-     *
-     * @param permission - Permission key
-     * @param resource - Resource
-     * @param environment
-     */
-    resolve<Permission extends keyof Resources>(permission: Permission, resource: Resources[Permission], environment?: Environment): Promise<AbilityResult<Resources[Permission]>>;
-    enforce<Permission extends keyof Resources>(permission: Permission, resource: Resources[Permission], environment?: Environment): Promise<void | never>;
-    /**
-     * Check if the permission key is contained in another permission key
-     * @param permissionA - The first permission to check
-     * @param permissionB - The second permission to check
-     */
-    static isInPermissionContain(permissionA: string, permissionB: string): boolean;
-    private makeCacheKey;
-    invalidatePolicy(policyId: string): Promise<void>;
-    invalidateCache(): Promise<void>;
-}
-export default AbilityResolver;

package/dist/core/AbilityResult.d.ts

@@ -1,27 +0,0 @@
-import { AbilityExplain } from './AbilityExplain';
-import { ResourceObject } from './AbilityTypeGenerator';
-import AbilityPolicy from './AbilityPolicy';
-import AbilityPolicyEffect from './AbilityPolicyEffect';
-export declare class AbilityResult<Resource extends ResourceObject = Record<string, unknown>> {
-    /**
-     * Already checked policies (after call the policy.check())
-     */
-    readonly policies: readonly AbilityPolicy<Resource>[];
-    constructor(policies: readonly AbilityPolicy<Resource>[]);
-    /**
-     * Returns a list of explanations for each policy involved in the ability evaluation.
-     * Each item describes how a specific policy contributed to the final permission result.
-     *
-     * Useful for debugging, logging, or building UI tools that visualize permission logic.
-     */
-    explain(): readonly AbilityExplain[];
-    getLastMatchedPolicy(): AbilityPolicy<Resource> | null;
-    isAllowed(): boolean;
-    isDenied(): boolean;
-    /**
-     * Get the last effect of the policy
-     *
-     * @returns {AbilityPolicyEffect | null}
-     */
-    getLastEffectOfMatchedPolicy(): AbilityPolicyEffect | null;
-}

package/dist/core/AbilityRule.d.ts

@@ -1,83 +0,0 @@
-import AbilityMatch from './AbilityMatch';
-import AbilityCondition, { AbilityConditionCodeType } from './AbilityCondition';
-export type AbilityRuleConfig = {
-    readonly id?: string | null;
-    readonly name?: string | null;
-    /**
-     * Subject key path like a 'user.name'
-     */
-    readonly subject: string;
-    /**
-     * Resource key path like a 'user.name' or value
-     */
-    readonly resource: string | number | boolean | null | (string | number | boolean | null)[];
-    readonly condition: AbilityConditionCodeType;
-};
-export type AbilityRuleConstructorProps = Omit<AbilityRuleConfig, 'condition'> & {
-    readonly condition: AbilityCondition;
-};
-/**
- * Represents a rule that defines a condition to be checked against a subject and resource.
- */
-export declare class AbilityRule<Resources extends object = object, Environment = unknown> {
-    /**
-     * Subject key path like a 'user.name'
-     */
-    subject: string;
-    /**
-     * Resource key path like a 'user.name' or value
-     */
-    resource: AbilityRuleConfig['resource'];
-    condition: AbilityCondition;
-    name: string;
-    id: string;
-    state: AbilityMatch;
-    /**
-     * Creates an instance of AbilityRule.
-     * @param {string} params.id - The unique identifier of the rule.
-     * @param {string} params.name - The name of the rule.
-     * @param {AbilityCondition} params.condition - The condition to evaluate.
-     * @param {string} params.subject - The subject of the rule.
-     * @param {string} params.resource - The resource to compare against.
-     * @param params
-     */
-    constructor(params: AbilityRuleConstructorProps);
-    /**
-     * Check if the rule is matched
-     * @param resource - The resource to check
-     * @param environment
-     */
-    check(resource: Resources | null, environment?: Environment): Promise<AbilityMatch>;
-    /**
-     * Extract values from the resourceData
-     * @param resourceData - The resourceData to extract values from
-     * @param environment - Environment data
-     */
-    extractValues(resourceData: Resources | null, environment?: Environment | null): [AbilityRuleConfig['resource'] | undefined, AbilityRuleConfig['resource'] | undefined];
-    /**
-     * Get the value of the object by dot notation
-     * @param resource - The object to get the value from
-     * @param desc - The dot notation string
-     */
-    getDotNotationValue<T = unknown>(resource: unknown, desc: string): T | undefined;
-    toString(): string;
-    copyWith(props: Partial<{
-        id: string | null;
-        name: string | null;
-        subject: string;
-        resource: AbilityRuleConfig['resource'];
-        condition: AbilityCondition;
-    }>): AbilityRule<Resources, Environment>;
-    static equals<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static notEquals<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static contains<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static notContains<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static notIn<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static in<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static notEqual<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static lessThan<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static lessOrEqual<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static moreThan<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-    static moreOrEqual<Resources extends object = object, Environment = unknown>(subject: string, resource: AbilityRuleConfig['resource']): AbilityRule<Resources, Environment>;
-}
-export default AbilityRule;

package/dist/core/AbilityRuleSet.d.ts

@@ -1,51 +0,0 @@
-import AbilityRule, { AbilityRuleConfig } from './AbilityRule';
-import AbilityCompare, { AbilityCompareCodeType } from './AbilityCompare';
-import AbilityMatch from './AbilityMatch';
-import { ResourceObject } from './AbilityTypeGenerator';
-export type AbilityRuleSetConfig = {
-    readonly id?: string | null;
-    readonly name?: string | null;
-    readonly compareMethod: AbilityCompareCodeType;
-    readonly rules: readonly AbilityRuleConfig[];
-};
-export type AbilityRuleSetConstructorProps = {
-    readonly id?: string | null;
-    readonly name?: string | null;
-    readonly compareMethod: AbilityCompare;
-};
-export declare class AbilityRuleSet<Resources extends ResourceObject = Record<string, unknown>, Environment = unknown> {
-    state: AbilityMatch;
-    /**
-     * List of rules
-     */
-    rules: AbilityRule<Resources, Environment>[];
-    /**
-     * Rules compare method.\
-     * For the «and» method the rule will be permitted if all\
-     * rules will be returns «permit» status and for the «or» - if\
-     * one of the rules returns as «permit»
-     */
-    compareMethod: AbilityCompare;
-    /**
-     * Group name
-     */
-    name: string;
-    /**
-     * Group ID
-     */
-    id: string;
-    constructor(params: AbilityRuleSetConstructorProps);
-    addRule(rule: AbilityRule<Resources, Environment>): this;
-    addRules(rules: AbilityRule<Resources, Environment>[]): this;
-    check(resources: Resources | null, environment?: Environment): Promise<AbilityMatch>;
-    toString(): string;
-    copyWith(props: Partial<{
-        id: string | null;
-        name: string | null;
-        compareMethod: AbilityCompare;
-        rules: AbilityRule<Resources, Environment>[];
-    }>): AbilityRuleSet<Resources, Environment>;
-    static and(rules: AbilityRule[]): AbilityRuleSet<Record<string, unknown>, unknown>;
-    static or(rules: AbilityRule[]): AbilityRuleSet<Record<string, unknown>, unknown>;
-}
-export default AbilityRuleSet;