ac-storage 0.14.1 → 0.15.0

package/dist/index.d.ts

@@ -168,7 +168,7 @@ type AccessTree = {
 };
 type StorageAccessControlEvent = {
     onAccess: (identifier: string, accessType: Accesses) => Promise<IAccessorManager<unknown>>;
-    onRelease: (identifier: string) => Promise<void>;
+    onDestroy: (identifier: string) => Promise<void>;
     onChainDependency: (idDependBy: string, idDependTo: string) => void;
 };
 
@@ -180,9 +180,10 @@ declare class StorageAccessControl {
     copy(oldIdentifier: string, newIdentifier: string, accessType: string): Promise<void>;
     move(oldIdentifier: string, newIdentifier: string, accessType: string): Promise<void>;
     access(identifier: string, accessType: string): Promise<unknown>;
-    release(identifier: string): Promise<void>;
-    releaseDir(identifier: string): Promise<void>;
+    destroy(identifier: string): Promise<void>;
+    destroyDir(identifier: string): Promise<void>;
     getAccessType(identifier: string): string[];
+    validateAccess(identifier: string, accessType: string): Accesses;
     validateDirectoryPath(identifier: string): void;
     private validateAndResolveAccess;
     /**
@@ -212,10 +213,11 @@ declare class DirectoryAccessError extends StorageError {
 }
 
 interface IACStorage extends IACSubStorage {
-    addListener(event: 'release' | 'access', listener: Function): void;
+    addListener(event: 'destroy' | 'access', listener: Function): void;
     register(tree: AccessTree): void;
     addAccessEvent<T extends string, AC>(customId: (T extends AccessType ? never : T), event: AccessorEvent<AC>): void;
     dropAll(): Promise<void>;
+    releaseAll(): Promise<void>;
 }
 interface IACSubStorage {
     subStorage(prefix: string): IACSubStorage;
@@ -223,11 +225,22 @@ interface IACSubStorage {
     accessAsJSON(identifier: string): Promise<IJSONAccessor>;
     accessAsText(identifier: string): Promise<ITextAccessor>;
     accessAsBinary(identifier: string): Promise<IBinaryAccessor>;
+    create(identifier: string, accessType: string): Promise<unknown>;
+    createAsJSON(identifier: string): Promise<IJSONAccessor>;
+    createAsText(identifier: string): Promise<ITextAccessor>;
+    createAsBinary(identifier: string): Promise<IBinaryAccessor>;
+    open(identifier: string, accessType: string): Promise<unknown>;
+    openAsJSON(identifier: string): Promise<IJSONAccessor>;
+    openAsText(identifier: string): Promise<ITextAccessor>;
+    openAsBinary(identifier: string): Promise<IBinaryAccessor>;
     copy(oldIdentifier: string, newIdentifier: string): Promise<void>;
     move(oldIdentifier: string, newIdentifier: string): Promise<void>;
     dropDir(identifier: string): Promise<void>;
     drop(identifier: string): Promise<void>;
     dropAll(): Promise<void>;
+    release(identifier: string): Promise<void>;
+    releaseDir(identifier: string): Promise<void>;
+    releaseAll(): Promise<void>;
     commit(identifier: string): Promise<void>;
     commitAll(): Promise<void>;
 }
@@ -241,8 +254,8 @@ declare class ACStorage implements IACStorage {
     protected eventListeners: {
         access?: Function;
         access_dir?: Function;
-        release?: Function;
-        release_dir?: Function;
+        destroy?: Function;
+        destroy_dir?: Function;
     };
     protected cachePath: string;
     protected noCache: boolean;
@@ -255,8 +268,10 @@ declare class ACStorage implements IACStorage {
     constructor(basePath: string, option?: ACStorageOption);
     protected loadCache(): void;
     protected saveCache(): void;
+    protected getOrCreateAccessorFromAccess(identifier: string, sa: Accesses, mode: 'create' | 'open' | 'access'): Promise<IAccessorManager<unknown>>;
+    protected getOrCreateAccessor(identifier: string, accessType: string, mode: 'create' | 'open' | 'access'): Promise<IAccessorManager<unknown>>;
     protected initAccessControl(): StorageAccessControl;
-    addListener(event: 'release' | 'access', listener: Function): void;
+    addListener(event: 'destroy' | 'access', listener: Function): void;
     register(tree: AccessTree): void;
     addAccessEvent<T extends string, AC>(customId: (T extends AccessType ? never : T), event: AccessorEvent<AC>): void;
     subStorage(identifier: string): IACSubStorage;
@@ -264,19 +279,35 @@ declare class ACStorage implements IACStorage {
     accessAsJSON(identifier: string): Promise<IJSONAccessor>;
     accessAsText(identifier: string): Promise<ITextAccessor>;
     accessAsBinary(identifier: string): Promise<IBinaryAccessor>;
+    create(identifier: string, accessType: string): Promise<unknown>;
+    createAsJSON(identifier: string): Promise<IJSONAccessor>;
+    createAsText(identifier: string): Promise<ITextAccessor>;
+    createAsBinary(identifier: string): Promise<IBinaryAccessor>;
+    open(identifier: string, accessType: string): Promise<unknown>;
+    openAsJSON(identifier: string): Promise<IJSONAccessor>;
+    openAsText(identifier: string): Promise<ITextAccessor>;
+    openAsBinary(identifier: string): Promise<IBinaryAccessor>;
     copy(oldIdentifier: string, newIdentifier: string): Promise<void>;
     move(oldIdentifier: string, newIdentifier: string): Promise<void>;
     protected validateAndGetAccessTypePair(oldIdentifier: string, newIdentifier: string): string;
     dropDir(identifier: string): Promise<void>;
     drop(identifier: string): Promise<void>;
     dropAll(): Promise<void>;
+    release(identifier: string): Promise<void>;
+    releaseDir(identifier: string): Promise<void>;
+    releaseAll(): Promise<void>;
     commit(identifier?: string): Promise<void>;
     commitAll(): Promise<void>;
 }
 
 declare class MemACStorage extends ACStorage {
+    #private;
     constructor();
+    getOrCreateAccessorFromAccess(identifier: string, sa: Accesses, mode: 'create' | 'open' | 'access'): Promise<IAccessorManager<unknown>>;
     initAccessControl(): StorageAccessControl;
+    release(identifier: string): Promise<void>;
+    releaseDir(identifier: string): Promise<void>;
+    releaseAll(): Promise<void>;
 }
 
 export { ACStorage, AccessDeniedError, BinaryAccessor, DirectoryAccessError, MemACStorage, MemBinaryAccessor, MemTextAccessor, NotRegisterError, StorageAccess, StorageAccessControl, StorageAccessError, StorageError, TextAccessor };

package/package.json

@@ -1,45 +1,45 @@
-{
-  "name": "ac-storage",
-  "version": "0.14.1",
-  "main": "./dist/bundle.cjs",
-  "module": "./dist/bundle.mjs",
-  "types": "./dist/index.d.ts",
-  "type": "module",
-  "exports": {
-    ".": {
-      "import": "./dist/bundle.mjs",
-      "require": "./dist/bundle.cjs",
-      "types": "./dist/index.d.ts"
-    }
-  },
-  "license": "MIT",
-  "devDependencies": {
-    "@rollup/plugin-alias": "^5.1.1",
-    "@rollup/plugin-commonjs": "^28.0.2",
-    "@rollup/plugin-json": "^6.1.0",
-    "@rollup/plugin-node-resolve": "^16.0.0",
-    "@rollup/plugin-typescript": "^12.1.2",
-    "@types/jest": "^29.5.14",
-    "@types/node": "^22.10.2",
-    "jest": "^29.7.0",
-    "rollup": "^4.28.1",
-    "rollup-plugin-dts": "^6.1.1",
-    "rollup-plugin-terser": "^7.0.2",
-    "ts-jest": "^29.2.5",
-    "ts-node": "^10.9.2",
-    "tslib": "^2.8.1",
-    "tsx": "^4.19.3",
-    "typescript": "^5.7.2"
-  },
-  "scripts": {
-    "build": "rollup -c",
-    "playground": "tsx src/playground.ts",
-    "test": "jest",
-    "publish-public": "npm publish --access=public"
-  },
-  "dependencies": {
-    "@hve/json-accessor": "^0.6.0",
-    "fast-deep-equal": "^3.1.3",
-    "tree-navigate": "^0.1.1"
-  }
-}
+{
+  "name": "ac-storage",
+  "version": "0.15.0",
+  "main": "./dist/bundle.cjs",
+  "module": "./dist/bundle.mjs",
+  "types": "./dist/index.d.ts",
+  "type": "module",
+  "exports": {
+    ".": {
+      "import": "./dist/bundle.mjs",
+      "require": "./dist/bundle.cjs",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "license": "MIT",
+  "devDependencies": {
+    "@rollup/plugin-alias": "^5.1.1",
+    "@rollup/plugin-commonjs": "^28.0.2",
+    "@rollup/plugin-json": "^6.1.0",
+    "@rollup/plugin-node-resolve": "^16.0.0",
+    "@rollup/plugin-typescript": "^12.1.2",
+    "@types/jest": "^29.5.14",
+    "@types/node": "^22.10.2",
+    "jest": "^29.7.0",
+    "rollup": "^4.28.1",
+    "rollup-plugin-dts": "^6.1.1",
+    "rollup-plugin-terser": "^7.0.2",
+    "ts-jest": "^29.2.5",
+    "ts-node": "^10.9.2",
+    "tslib": "^2.8.1",
+    "tsx": "^4.19.3",
+    "typescript": "^5.7.2"
+  },
+  "scripts": {
+    "build": "rollup -c",
+    "playground": "tsx src/playground.ts",
+    "test": "jest",
+    "publish-public": "npm publish --access=public"
+  },
+  "dependencies": {
+    "@hve/json-accessor": "^0.7.0",
+    "fast-deep-equal": "^3.1.3",
+    "tree-navigate": "^0.1.1"
+  }
+}