@filebox/core 1.0.10

package/dist/src/cache/cache.d.ts

@@ -0,0 +1,104 @@
+import { CacheOptions, CacheOperation, CacheStatus, ScanOptions } from "./types";
+interface ExtendedCacheOptions extends CacheOptions {
+    fs?: any;
+}
+export declare class Cache {
+    private strategy;
+    private inited;
+    private cacheStatus;
+    private fs;
+    private dependencyManager;
+    private operationsHandler;
+    /**
+     * 创建新的缓存实例
+     * @param options 缓存选项
+     */
+    constructor(options?: ExtendedCacheOptions);
+    /**
+     * 初始化缓存
+     */
+    init(): Promise<Cache>;
+    fullkey(key: string): string;
+    /**
+     * 从缓存中获取值，包含状态检查
+     */
+    get(key: string): Promise<any>;
+    /**
+     * 将值存储到缓存中
+     * @param ttl 可选的生存时间(毫秒)
+     */
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    /**
+     * 从缓存中删除值
+     */
+    del(key: string): Promise<void>;
+    /**
+     * 检查键是否存在于缓存中
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 扫描以特定前缀开头的所有键
+     * @param prefix 前缀字符串
+     * @param opts 扫描选项
+     */
+    scan(prefix: string, opts?: ScanOptions): Promise<string[]>;
+    /**
+     * 关闭/清理缓存资源
+     */
+    close(): Promise<void>;
+    /**
+     * 获取底层策略实例
+     */
+    getStrategy(): import("./types").ICacheStrategy;
+    /**
+     * 标记路径状态
+     * @param path 路径
+     * @param status 状态
+     */
+    markStatus(path: string, status: CacheStatus): Promise<void>;
+    /**
+     * 使子路径缓存无效
+     * 使用前缀匹配扫描找到并标记所有子路径
+     * @param path 父路径
+     */
+    private invalidateChildPaths;
+    /**
+     * 批量标记路径状态
+     * @param pathPattern 路径模式
+     * @param status 状态
+     */
+    markPathsMatching(pathPattern: string, status: CacheStatus): Promise<void>;
+    /**
+     * 标记路径需要刷新
+     */
+    markForRefresh(path: string): Promise<void>;
+    /**
+     * 标记路径已失效
+     */
+    invalidate(path: string): Promise<void>;
+    /**
+     * 调度缓存刷新
+     */
+    private scheduleRefresh;
+    /**
+     * 统一处理缓存操作的接口
+     */
+    handleOperation(op: CacheOperation): Promise<void>;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    mkdir(path: string, data: any): Promise<void>;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    remove(path: any, fs: any): Promise<void>;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    rename(path: any, fs: any, data: any): Promise<void>;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    move(srcPath: any, destPath: any, srcStat: any, tarStat: any, fs: any, data: any): Promise<void>;
+}
+export {};

package/dist/src/cache/dependencies.d.ts

@@ -0,0 +1,60 @@
+/**
+ * 缓存依赖关系管理类接口
+ */
+export interface IDependencyManager {
+    addDependency(key: string, dependency: string): void;
+    addDependencies(key: string, dependencies: string[]): void;
+    addPathHierarchyDependencies(path: string): void;
+    removeDependencies(key: string): void;
+    getDependents(key: string): string[];
+    getDependencies(key: string): string[];
+}
+/**
+ * 缓存依赖关系管理类
+ * 管理缓存项之间的依赖关系
+ */
+export declare class DependencyManager implements IDependencyManager {
+    private cacheDependencies;
+    private cacheReverseDependencies;
+    /**
+     * 添加单个缓存依赖关系
+     * @param key 缓存键
+     * @param dependency 该键依赖的缓存键
+     */
+    addDependency(key: string, dependency: string): void;
+    /**
+     * 添加多个缓存依赖
+     * @param key 缓存键
+     * @param dependencies 依赖列表
+     */
+    addDependencies(key: string, dependencies: string[]): void;
+    /**
+     * 自动创建路径层级依赖关系
+     * 为路径创建与其所有父路径的依赖关系
+     * @param path 路径
+     */
+    addPathHierarchyDependencies(path: string): void;
+    /**
+     * 移除所有与指定键相关的依赖关系
+     * @param key 缓存键
+     */
+    removeDependencies(key: string): void;
+    /**
+     * 获取依赖于指定键的所有缓存键（包括间接依赖）
+     * @param key 缓存键
+     * @returns 依赖于此键的所有键列表
+     */
+    getDependents(key: string): string[];
+    /**
+     * 递归收集所有依赖于指定键的缓存键
+     * @param key 缓存键
+     * @param result 结果集合
+     */
+    private collectDependents;
+    /**
+     * 获取指定键依赖的所有缓存键
+     * @param key 缓存键
+     * @returns 此键依赖的所有键列表
+     */
+    getDependencies(key: string): string[];
+}

package/dist/src/cache/index.d.ts

@@ -0,0 +1,8 @@
+export * from "./types";
+export * from "./strategies";
+export { Cache } from "./cache";
+export { DependencyManager } from "./dependencies";
+export type { IDependencyManager } from "./dependencies";
+export { OperationsHandler } from "./operations";
+import { Cache } from "./cache";
+export default Cache;

package/dist/src/cache/operations.d.ts

@@ -0,0 +1,52 @@
+import { CacheOperation, CacheStatus } from "./types";
+/**
+ * 缓存操作处理类
+ * 处理各种缓存操作（创建、更新、删除、移动、复制、重命名）
+ */
+export declare class OperationsHandler {
+    /**
+     * 处理缓存操作
+     * @param op 操作对象
+     * @param cache 缓存实例接口
+     */
+    handleOperation(op: CacheOperation, cache: {
+        get: (key: string) => Promise<any>;
+        set: (key: string, value: any, ttl?: number) => Promise<void>;
+        markForRefresh: (path: string) => Promise<void>;
+        invalidate: (path: string) => Promise<void>;
+        markPathsMatching: (pathPattern: string, status: CacheStatus) => Promise<void>;
+        markStatus: (path: string, status: CacheStatus) => Promise<void>;
+        fullkey: (path: string) => string;
+        del: (path: string) => Promise<void>;
+        scan: (pathPattern: string, opts?: any) => Promise<string[]>;
+    }): Promise<void>;
+    /**
+     * 处理创建操作
+     */
+    private handleCreate;
+    /**
+     * 处理更新操作
+     */
+    private handleUpdate;
+    /**
+     * 处理删除操作
+     */
+    private handleDelete;
+    /**
+     * 使用前缀匹配扫描进行级联删除
+     * 删除指定路径及其所有子路径的缓存项
+     */
+    private cascadeDeleteWithPrefix;
+    /**
+     * 处理移动操作
+     */
+    private handleMove;
+    /**
+     * 处理复制操作
+     */
+    private handleCopy;
+    /**
+     * 处理重命名操作
+     */
+    private handleRename;
+}

package/dist/src/cache/strategies/index.d.ts

@@ -0,0 +1 @@
+export { LRUCacheStrategy } from "./lru";

package/dist/src/cache/strategies/lru.d.ts

@@ -0,0 +1,15 @@
+import { ICacheStrategy, CacheOptions } from "../types";
+/**
+ * LRU缓存策略实现 (默认本地内存缓存)
+ */
+export declare class LRUCacheStrategy implements ICacheStrategy {
+    private cache;
+    prefix: string;
+    constructor(options?: CacheOptions);
+    private normalize;
+    has(key: string): Promise<boolean>;
+    get(key: string): Promise<any>;
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    del(key: string): Promise<void>;
+    scan(prefix: string): Promise<string[]>;
+}

package/dist/src/cache/types.d.ts

@@ -0,0 +1,79 @@
+/**
+ * 缓存状态枚举
+ */
+export declare enum CacheStatus {
+    VALID = 0,// 缓存有效
+    NEEDS_REFRESH = 1,// 需要刷新但可以暂时使用
+    INVALID = 2
+}
+/**
+ * 缓存操作类型
+ */
+export type CacheOperationType = "create" | "update" | "delete" | "move" | "copy" | "rename";
+/**
+ * 缓存操作接口
+ */
+export interface CacheOperation {
+    type: CacheOperationType;
+    path: string;
+    parentPath?: string;
+    newItem?: any;
+    targetPath?: string;
+    newName?: string;
+    result?: any;
+    fs?: any;
+}
+/**
+ * 缓存策略接口 - 用户可以实现此接口来创建自定义缓存后端
+ */
+export interface ICacheStrategy {
+    /**
+     * 缓存前缀（字符串或函数）
+     */
+    prefix?: string | ((context?: any) => string);
+    /**
+     * 检查键是否存在于缓存中
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 从缓存中获取值
+     */
+    get(key: string): Promise<any>;
+    /**
+     * 将值存储到缓存中
+     * @param ttl 可选的生存时间(毫秒)
+     */
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    /**
+     * 从缓存中删除值
+     */
+    del(key: string): Promise<void>;
+    /**
+     * 扫描以特定前缀开头的所有键
+     */
+    scan(prefix: string): Promise<string[]>;
+    /**
+     * 初始化缓存策略(可选)
+     */
+    init?(): Promise<void>;
+    /**
+     * 关闭/清理缓存资源(可选)
+     */
+    close?(): Promise<void>;
+}
+export interface CacheOptions {
+    max?: number;
+    maxSize?: number;
+    ttl?: number;
+    sizeCalculation?: (value: any, key: string) => number;
+    prefix?: string | ((context?: any) => string);
+    strategy?: ICacheStrategy;
+    enableDependencyCollection?: boolean;
+    fs?: any;
+}
+/**
+ * 缓存扫描选项
+ */
+export interface ScanOptions {
+    includeDependencies?: boolean;
+}

package/dist/src/cache1.d.ts

@@ -0,0 +1,230 @@
+/**
+ * 缓存状态枚举
+ */
+export declare enum CacheStatus {
+    VALID = 0,// 缓存有效
+    NEEDS_REFRESH = 1,// 需要刷新但可以暂时使用
+    INVALID = 2
+}
+/**
+ * 缓存操作类型
+ */
+export type CacheOperationType = "create" | "update" | "delete" | "move" | "copy" | "rename";
+/**
+ * 缓存操作接口
+ */
+export interface CacheOperation {
+    type: CacheOperationType;
+    path: string;
+    parentPath?: string;
+    newItem?: any;
+    targetPath?: string;
+    newName?: string;
+    result?: any;
+    fs?: any;
+}
+/**
+ * 缓存策略接口 - 用户可以实现此接口来创建自定义缓存后端
+ */
+export interface ICacheStrategy {
+    /**
+     * 检查键是否存在于缓存中
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 从缓存中获取值
+     */
+    get(key: string): Promise<any>;
+    /**
+     * 将值存储到缓存中
+     * @param ttl 可选的生存时间(毫秒)
+     */
+    set(key: string, value: any, ttl?: number): Promise<void>;
+    /**
+     * 从缓存中删除值
+     */
+    del(key: string): Promise<void>;
+    /**
+     * 扫描以特定前缀开头的所有键
+     */
+    scan(prefix: string): Promise<string[]>;
+    /**
+     * 初始化缓存策略(可选)
+     */
+    init?(): Promise<void>;
+    /**
+     * 关闭/清理缓存资源(可选)
+     */
+    close?(): Promise<void>;
+}
+export interface CacheOptions {
+    max?: number;
+    maxSize?: number;
+    ttl?: number;
+    sizeCalculation?: (value: any, key: string) => number;
+    prefix?: string;
+    strategy?: ICacheStrategy;
+    enableDependencyCollection?: boolean;
+}
+/**
+ * 主缓存类 - 轻量级门面
+ *
+ * 该类可通过以下方式使用:
+ * 1. 直接实例化: `new Cache(options)`
+ * 2. 单例模式: `Cache.getInstance(options)`
+ * 3. 自定义缓存后端: 传入实现ICacheStrategy接口的对象
+ */
+export declare class Cache {
+    private strategy;
+    private inited;
+    private cacheStatus;
+    private cacheDependencies;
+    private cacheReverseDependencies;
+    private enableDependencyCollection;
+    /**
+     * 创建新的缓存实例
+     * @param options 缓存选项
+     */
+    constructor(options?: CacheOptions);
+    /**
+     * 初始化缓存
+     */
+    init(): Promise<Cache>;
+    /**
+     * 从缓存中获取值，包含状态检查
+     */
+    get(key: string): Promise<any>;
+    /**
+     * 将值存储到缓存中
+     * @param ttl 可选的生存时间(毫秒)
+     * @param dependencies 可选的依赖项列表
+     */
+    set(key: string, value: any, ttl?: number, dependencies?: string[]): Promise<void>;
+    /**
+     * 从缓存中删除值
+     */
+    del(key: string): Promise<void>;
+    /**
+     * 检查键是否存在于缓存中
+     */
+    has(key: string): Promise<boolean>;
+    /**
+     * 扫描以特定前缀开头的所有键
+     * @param prefix 前缀字符串
+     * @param opts 选项 {includeDependencies: boolean} 是否包含依赖此前缀的键
+     */
+    scan(prefix: string, opts?: {
+        includeDependencies?: boolean;
+    }): Promise<string[]>;
+    /**
+     * 关闭/清理缓存资源
+     */
+    close(): Promise<void>;
+    /**
+     * 获取底层策略实例
+     */
+    getStrategy(): ICacheStrategy;
+    /**
+     * 标记路径状态
+     * @param path 路径
+     * @param status 状态
+     */
+    markStatus(path: string, status: CacheStatus): Promise<void>;
+    /**
+     * 批量标记路径状态
+     * @param pathPattern 路径模式
+     * @param status 状态
+     */
+    markPathsMatching(pathPattern: string, status: CacheStatus): Promise<void>;
+    /**
+     * 标记路径需要刷新
+     */
+    markForRefresh(path: string): Promise<void>;
+    /**
+     * 标记路径已失效
+     */
+    invalidate(path: string): Promise<void>;
+    /**
+     * 添加单个缓存依赖关系
+     * @param key 缓存键
+     * @param dependency 该键依赖的缓存键
+     */
+    addDependency(key: string, dependency: string): void;
+    /**
+     * 添加多个缓存依赖
+     * @param key 缓存键
+     * @param dependencies 依赖列表
+     */
+    addDependencies(key: string, dependencies: string[]): void;
+    /**
+     * 移除所有与指定键相关的依赖关系
+     * @param key 缓存键
+     */
+    removeDependencies(key: string): void;
+    /**
+     * 获取依赖于指定键的所有缓存键
+     * @param key 缓存键
+     * @returns 依赖于此键的所有键列表
+     */
+    getDependents(key: string): string[];
+    /**
+     * 获取指定键依赖的所有缓存键
+     * @param key 缓存键
+     * @returns 此键依赖的所有键列表
+     */
+    getDependencies(key: string): string[];
+    /**
+     * 使依赖于指定键的所有缓存项无效
+     * @param key 缓存键
+     */
+    invalidateDependents(key: string): Promise<void>;
+    /**
+     * 调度缓存刷新
+     */
+    private scheduleRefresh;
+    /**
+     * 统一处理缓存操作的接口
+     */
+    handleOperation(op: CacheOperation): Promise<void>;
+    /**
+     * 处理创建操作
+     */
+    private handleCreate;
+    /**
+     * 处理更新操作
+     */
+    private handleUpdate;
+    /**
+     * 处理删除操作
+     */
+    private handleDelete;
+    /**
+     * 处理移动操作
+     */
+    private handleMove;
+    /**
+     * 处理复制操作
+     */
+    private handleCopy;
+    /**
+     * 处理重命名操作
+     */
+    private handleRename;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    mkdir(path: string, data: any): Promise<void>;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    remove(path: any, fs: any): Promise<void>;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    rename(path: any, fs: any, data: any): Promise<void>;
+    /**
+     * @deprecated 使用handleOperation代替
+     */
+    move(srcPath: any, destPath: any, srcStat: any, tarStat: any, fs: any, data: any): Promise<void>;
+}
+export default Cache;

package/dist/src/constant.d.ts

@@ -0,0 +1,2 @@
+export declare const DEFAULT_PREFIX: string;
+export declare const DEFAULT_LIST_CACHE_EXPIRE_TIME: number;

package/dist/src/crypt/eme-cipher.d.ts

@@ -0,0 +1,37 @@
+/**
+ * EME (ECB-Mix-ECB) 加密模式实现
+ * 用于文件名加密，产生更短的密文
+ */
+/**
+ * EME 加密器
+ */
+export declare class EMECipher {
+    private key;
+    private blockSize;
+    private nodeCrypto;
+    constructor(key: Uint8Array);
+    /**
+     * 加密单个块（使用 ECB 模式）
+     */
+    private _encryptBlock;
+    /**
+     * 解密单个块（使用 ECB 模式）
+     */
+    private _decryptBlock;
+    /**
+     * 异或操作
+     */
+    private _xor;
+    /**
+     * GF(2^128) 乘法
+     */
+    private _gfMultiply;
+    /**
+     * 加密数据
+     */
+    encrypt(plaintext: Uint8Array): Promise<Uint8Array>;
+    /**
+     * 解密数据
+     */
+    decrypt(ciphertext: Uint8Array): Promise<Uint8Array>;
+}