@lanaqi/rsr 0.0.1-rc.0

package/dist/access/voter.d.ts

@@ -0,0 +1,156 @@
+import type { AccessPermission } from './common';
+/**
+ * 访问投票器
+ */
+export interface AccessVoter {
+    /**
+     * 进行投票
+     * @param term 条件
+     * @param have 拥有
+     */
+    vote(term: Set<AccessPermission>, have: Set<AccessPermission>): boolean;
+}
+/**
+ * 缓存投票器（抽象类）
+ */
+export declare abstract class CacheVoter implements AccessVoter {
+    /**
+     * 缓存映射
+     * @private
+     */
+    private readonly cache;
+    /**
+     * 构造函数
+     */
+    protected constructor();
+    /**
+     * 缓存键
+     * @param term 条件
+     * @param have 拥有
+     * @private
+     */
+    private cacheKey;
+    /**
+     * 执行投票
+     * @param term 条件
+     * @param have 拥有
+     * @protected
+     */
+    protected abstract execVote(term: Set<AccessPermission>, have: Set<AccessPermission>): boolean;
+    /**
+     * 清理缓存
+     */
+    clearCache(): void;
+    /**
+     * 进行投票
+     * @param term 条件
+     * @param have 拥有
+     */
+    vote(term: Set<AccessPermission>, have: Set<AccessPermission>): boolean;
+}
+/**
+ * 简单投票器
+ */
+export declare class SimpleVoter extends CacheVoter {
+    /**
+     * 包含全部
+     * @private
+     */
+    private all;
+    /**
+     * 构造函数
+     * @param all 包含全部
+     */
+    constructor(all?: boolean);
+    /**
+     * 设置包含全部
+     * @param all 包含全部
+     */
+    setAll(all: boolean): void;
+    /**
+     * 执行投票
+     * @param term 条件
+     * @param have 拥有
+     * @protected
+     */
+    protected execVote(term: Set<AccessPermission>, have: Set<AccessPermission>): boolean;
+}
+/**
+ * 关系解析器
+ */
+export type RelationResolver = (relation: string) => string;
+/**
+ * 原始关系解析器
+ * @param relation 层级关系
+ */
+export declare const OriginRelationResolver: (relation: string) => string;
+/**
+ * 层级投票器
+ */
+export declare class HierarchyVoter extends CacheVoter {
+    /**
+     * 层级映射
+     * @private
+     */
+    private readonly mapping;
+    /**
+     * 层级关系：a>b;b>c;c>d;e>f;f>g
+     * @private
+     */
+    private relation;
+    /**
+     * 包含全部
+     * @private
+     */
+    private all;
+    /**
+     * 关系解析器
+     * @private
+     */
+    private resolver;
+    /**
+     * 构造函数
+     * @param resolver 关系解析器
+     * @param relation 层级关系：a>b;b>c;c>d;e>f;f>g
+     * @param all 包含全部
+     */
+    constructor(resolver: RelationResolver, relation: string, all?: boolean);
+    /**
+     * 设置包含全部
+     * @param all 包含全部
+     */
+    setAll(all: boolean): void;
+    /**
+     * 重置层级关系
+     * @param relation 层级关系
+     */
+    resetRelation(relation: string): void;
+    /**
+     * 重置关系解析器
+     * @param resolver 关系解析器
+     */
+    resetResolver(resolver: RelationResolver): void;
+    /**
+     * 初始化层级
+     * @private
+     */
+    private initHierarchy;
+    /**
+     * p1 包含 p2
+     * @param p1 权限1
+     * @param p2 权限2
+     * @private
+     */
+    private includePermission;
+    /**
+     * 执行投票
+     * @param term 条件
+     * @param have 拥有
+     * @protected
+     */
+    protected execVote(term: Set<AccessPermission>, have: Set<AccessPermission>): boolean;
+    /**
+     * 获取层级关系
+     */
+    getRelation(): string;
+}

package/dist/addons/index.d.ts

@@ -0,0 +1,4 @@
+/**
+ * 微应用插件
+ */
+export * from './micro';

package/dist/addons/micro.d.ts

@@ -0,0 +1,53 @@
+import { AbstractAddon, type AccessContext, type AccessManager, type AccessPath, type AccessResource } from '../access';
+/**
+ * MicroApp 插件实现
+ */
+export declare class MicroAppAddon extends AbstractAddon {
+    /**
+     * 层级连接忽略
+     */
+    static readonly HIERARCHY_JOIN_IGNORE: string;
+    /**
+     * 层级连接合并
+     */
+    static readonly HIERARCHY_JOIN_MERGE: string;
+    /**
+     * 层级连接父级
+     */
+    static readonly HIERARCHY_JOIN_PARENT: string;
+    /**
+     * 微连接
+     */
+    private microJoin;
+    /**
+     * 基础路径连接
+     * @private
+     */
+    private readonly basenameJoin;
+    /**
+     * 层级连接
+     * @private
+     */
+    private readonly hierarchyJoin;
+    /**
+     * 构造函数
+     * @param basenameJoin 基础路径连接
+     * @param hierarchyJoin 层级连接
+     */
+    constructor(basenameJoin: boolean, hierarchyJoin: string);
+    /**
+     * 守护之前
+     * @param context 上下文
+     * @param manager 管理器
+     * @param currentPath 当前路径
+     * @param currentResource 当前资源
+     * @override
+     */
+    guardBefore(context: AccessContext, manager: AccessManager, currentPath: AccessPath, currentResource: AccessResource | null): void;
+}
+/**
+ * MicroApp 插件函数
+ * @param basenameJoin 基础路径连接
+ * @param hierarchyJoin 层级连接
+ */
+export declare const microAppAddon: (basenameJoin?: boolean, hierarchyJoin?: string) => MicroAppAddon;

package/dist/bridge.d.ts

@@ -0,0 +1,8 @@
+/**
+ * 桥接引用的函数和钩子
+ */
+export { matchPath, useBlocker, useLocation, useNavigate } from 'react-router-dom';
+/**
+ * 桥接引用的类型
+ */
+export type { PathPattern, NavigateFunction, NavigateOptions, To, Path } from 'react-router-dom';

package/dist/builder/blocker.d.ts

@@ -0,0 +1,24 @@
+import { type AccessBlocker } from '../access';
+import type { AccessBuilder } from './builder';
+/**
+ * 访问阻断器构建器
+ */
+export declare class AccessBlockerBuilder implements AccessBuilder<AccessBlocker> {
+    /**
+     * 是否多阻断器
+     * @private
+     */
+    private _multi?;
+    /**
+     * 标记多阻断器
+     */
+    multi(): AccessBlockerBuilder;
+    /**
+     * 标记单阻断器
+     */
+    single(): AccessBlockerBuilder;
+    /**
+     * 构建
+     */
+    build(): AccessBlocker;
+}

package/dist/builder/builder.d.ts

@@ -0,0 +1,9 @@
+/**
+ * 访问构建器
+ */
+export interface AccessBuilder<Type> {
+    /**
+     * 构建
+     */
+    build(): Type;
+}

package/dist/builder/context.d.ts

@@ -0,0 +1,112 @@
+import { type AccessContext, type AccessMatcher, type AccessNavigator, type AccessRecorder, type AccessResource, type AccessStorer, type AccessValidator, type AccessVoter } from '../access';
+import type { NavigateFunction } from '../bridge';
+import type { AccessBuilder } from './builder';
+import { AccessMatcherBuilder } from './matcher';
+import { AccessNavigatorBuilder } from './navigator';
+import { AccessRecorderBuilder } from './recorder';
+import { AccessResourceBuilder } from './resource';
+import { AccessStorerBuilder } from './storer';
+import { AccessVoterBuilder } from './voter';
+/**
+ * 访问上下文构建器
+ */
+export declare class AccessContextBuilder implements AccessBuilder<AccessContext> {
+    /**
+     * 记录器
+     * @private
+     */
+    private _recorder?;
+    /**
+     * 投票器
+     * @private
+     */
+    private _voter?;
+    /**
+     * 存储器
+     * @private
+     */
+    private _storer?;
+    /**
+     * 匹配器
+     * @private
+     */
+    private _matcher?;
+    /**
+     * 导航器
+     * @private
+     */
+    private _navigator?;
+    /**
+     * 层级
+     * @private
+     */
+    private _hierarchy?;
+    /**
+     * 认证验证器
+     * @private
+     */
+    private _validator?;
+    /**
+     * 资源集合
+     * @private
+     */
+    private readonly _resources;
+    /**
+     * 导航函数
+     * @private
+     */
+    private _navigate?;
+    /**
+     * 设置记录器
+     * @param recorder 记录器
+     */
+    recorder(recorder: AccessRecorder | ((builder: AccessRecorderBuilder) => AccessRecorder)): AccessContextBuilder;
+    /**
+     * 设置投票器
+     * @param voter 投票器或投票构建器
+     */
+    voter(voter: AccessVoter | ((builder: AccessVoterBuilder) => AccessVoter)): AccessContextBuilder;
+    /**
+     * 设置存储器
+     * @param storer 存储器或存储构建器
+     */
+    storer(storer: AccessStorer | ((builder: AccessStorerBuilder) => AccessStorer)): AccessContextBuilder;
+    /**
+     * 设置匹配器
+     * @param matcher 匹配器或匹配构建器
+     */
+    matcher(matcher: AccessMatcher | ((builder: AccessMatcherBuilder) => AccessMatcher)): AccessContextBuilder;
+    /**
+     * 设置导航器
+     * @param navigator 导航器或导航构建器
+     */
+    navigator(navigator: AccessNavigator | ((builder: AccessNavigatorBuilder) => AccessNavigator)): AccessContextBuilder;
+    /**
+     * 设置层级
+     * @param hierarchy 层级：a>b;b>c;c>d;e>f;f>g
+     */
+    hierarchy(hierarchy: string): AccessContextBuilder;
+    /**
+     * 设置认证验证器
+     * @param validator 认证验证器
+     */
+    validator(validator: AccessValidator): AccessContextBuilder;
+    /**
+     * 添加资源
+     * @param builder 资源构建器
+     */
+    resource(builder: (builder: AccessResourceBuilder) => AccessResource): AccessContextBuilder;
+    /**
+     * 设置导航函数
+     * @param navigate 导航函数
+     */
+    navigate(navigate: NavigateFunction): AccessContextBuilder;
+    /**
+     * 默认资源集合
+     */
+    drs(): AccessContextBuilder;
+    /**
+     * 构建
+     */
+    build(): AccessContext;
+}

package/dist/builder/guarder.d.ts

@@ -0,0 +1,54 @@
+import { type AccessAddons, type AccessContext, type AccessManager, type AccessProvider } from '../access';
+import type { NavigateFunction } from '../bridge';
+import type { AccessBuilder } from './builder';
+import { AccessContextBuilder } from './context';
+import { AccessManagerBuilder } from './manager';
+/**
+ * 访问守护器构建器
+ */
+export declare class AccessGuarderBuilder implements AccessBuilder<AccessProvider> {
+    /**
+     * 上下文
+     * @private
+     */
+    private _context?;
+    /**
+     * 管理器
+     * @private
+     */
+    private _manager?;
+    /**
+     * 插件集合
+     * @private
+     */
+    private readonly _addons;
+    /**
+     * 导航函数
+     * @private
+     */
+    private _navigate?;
+    /**
+     * 设置上下文
+     * @param context 上下文
+     */
+    context(context: AccessContext | ((builder: AccessContextBuilder) => AccessContext)): AccessGuarderBuilder;
+    /**
+     * 设置管理器
+     * @param manager 管理器
+     */
+    manager(manager: AccessManager | ((builder: AccessManagerBuilder) => AccessManager)): AccessGuarderBuilder;
+    /**
+     * 设置插件集合
+     * @param addons 插件集合
+     */
+    addons(...addons: AccessAddons): AccessGuarderBuilder;
+    /**
+     * 设置导航函数
+     * @param navigate 导航函数
+     */
+    navigate(navigate: NavigateFunction): AccessGuarderBuilder;
+    /**
+     * 构建
+     */
+    build(): AccessProvider;
+}

package/dist/builder/handler.d.ts

@@ -0,0 +1,21 @@
+import { type AccessHandler, type BehaveConfig } from '../access';
+import type { AccessBuilder } from './builder';
+/**
+ * 访问处理器构建器
+ */
+export declare class AccessHandlerBuilder implements AccessBuilder<AccessHandler> {
+    /**
+     * 行为配置
+     * @private
+     */
+    private _config?;
+    /**
+     * 设置行为配置
+     * @param config 行为配置
+     */
+    config(config: BehaveConfig): AccessHandlerBuilder;
+    /**
+     * 构建
+     */
+    build(): AccessHandler;
+}

package/dist/builder/index.d.ts

@@ -0,0 +1,48 @@
+/**
+ * 访问构建器
+ */
+export * from './builder';
+/**
+ * 访问记录器构建器
+ */
+export * from './recorder';
+/**
+ * 访问投票器构建器
+ */
+export * from './voter';
+/**
+ * 访问存储器构建器
+ */
+export * from './storer';
+/**
+ * 访问资源构建器
+ */
+export * from './resource';
+/**
+ * 访问匹配器构建器
+ */
+export * from './matcher';
+/**
+ * 访问导航器构建器
+ */
+export * from './navigator';
+/**
+ * 访问上下文构建器
+ */
+export * from './context';
+/**
+ * 访问处理器构建器
+ */
+export * from './handler';
+/**
+ * 访问阻断器构建器
+ */
+export * from './blocker';
+/**
+ * 访问管理器构建器
+ */
+export * from './manager';
+/**
+ * 访问守护器构建器
+ */
+export * from './guarder';

package/dist/builder/manager.d.ts

@@ -0,0 +1,55 @@
+import { type AccessBlocker, type AccessHandler, type AccessManager, type BehaveConfig } from '../access';
+import { AccessBlockerBuilder } from './blocker';
+import type { AccessBuilder } from './builder';
+import { AccessHandlerBuilder } from './handler';
+/**
+ * 访问管理器构建器
+ */
+export declare class AccessManagerBuilder implements AccessBuilder<AccessManager> {
+    /**
+     * 是否禁用
+     */
+    private _disabled;
+    /**
+     * 处理器
+     * @private
+     */
+    private _handler?;
+    /**
+     * 阻断器
+     * @private
+     */
+    private _blocker?;
+    /**
+     * 行为配置
+     * @private
+     */
+    private _behave?;
+    /**
+     * 设置已禁用
+     */
+    disabled(): AccessManagerBuilder;
+    /**
+     * 设置处理器
+     * @param handler 处理器或处理构建器
+     */
+    handler(handler: AccessHandler | ((builder: AccessHandlerBuilder) => AccessHandler)): AccessManagerBuilder;
+    /**
+     * 设置阻断器
+     * @param blocker 阻断器或阻断构建器
+     */
+    blocker(blocker: AccessBlocker | ((builder: AccessBlockerBuilder) => AccessBlocker)): AccessManagerBuilder;
+    /**
+     * 设置行为配置
+     * @param behave 行为配置
+     */
+    behave(behave: BehaveConfig): AccessManagerBuilder;
+    /**
+     * 默认行为配置
+     */
+    dbc(): AccessManagerBuilder;
+    /**
+     * 构建
+     */
+    build(): AccessManager;
+}

package/dist/builder/matcher.d.ts

@@ -0,0 +1,37 @@
+import { type AccessMatcher, type AccessResource, type AccessResources } from '../access';
+import type { AccessBuilder } from './builder';
+import { AccessResourceBuilder, type AccessResourceConfig, type AccessResourceConfigs } from './resource';
+/**
+ * 访问匹配器构建器
+ */
+export declare class AccessMatcherBuilder implements AccessBuilder<AccessMatcher> {
+    /**
+     * 资源集合
+     * @private
+     */
+    private readonly _resources;
+    /**
+     * 添加资源配置
+     * @param config 资源配置
+     */
+    config(config: AccessResourceConfig): AccessMatcherBuilder;
+    /**
+     * 添加资源配置集合
+     * @param configs 资源配置集合
+     */
+    configs(...configs: AccessResourceConfigs): AccessMatcherBuilder;
+    /**
+     * 添加资源
+     * @param builder 资源构建器
+     */
+    resource(builder: (builder: AccessResourceBuilder) => AccessResource): AccessMatcherBuilder;
+    /**
+     * 添加资源集合
+     * @param resources 资源集合
+     */
+    resources(resources: AccessResources): AccessMatcherBuilder;
+    /**
+     * 构建
+     */
+    build(): AccessMatcher;
+}

package/dist/builder/navigator.d.ts

@@ -0,0 +1,22 @@
+import { type AccessNavigator } from '../access';
+import type { NavigateFunction } from '../bridge';
+import type { AccessBuilder } from './builder';
+/**
+ * 访问导航器构建器
+ */
+export declare class AccessNavigatorBuilder implements AccessBuilder<AccessNavigator> {
+    /**
+     * 导航函数
+     * @private
+     */
+    private _navigate?;
+    /**
+     * 设置导航函数
+     * @param navigate 导航函数
+     */
+    navigate(navigate: NavigateFunction): AccessNavigatorBuilder;
+    /**
+     * 构建
+     */
+    build(): AccessNavigator;
+}

package/dist/builder/recorder.d.ts

@@ -0,0 +1,11 @@
+import { type AccessRecorder } from '../access';
+import type { AccessBuilder } from './builder';
+/**
+ * 访问记录器构建器
+ */
+export declare class AccessRecorderBuilder implements AccessBuilder<AccessRecorder> {
+    /**
+     * 构建
+     */
+    build(): AccessRecorder;
+}