@file-viewer/asset-installer 3.2.0 → 3.2.1

package/README.en.md

@@ -1,6 +1,6 @@
 # @file-viewer/asset-installer
 
-Runtime package version 3.2.0.
+Runtime package version 3.2.1.
 
 Usage and API documentation: https://doc.file-viewer.app/
 

package/README.md

@@ -1,6 +1,6 @@
 # @file-viewer/asset-installer
 
-Runtime package version 3.2.0.
+Runtime package version 3.2.1.
 
 Usage and API documentation: https://doc.file-viewer.app/
 

package/dist/index.d.ts

@@ -15,6 +15,7 @@ export interface CapabilityAssetReceiptFile {
     path: string;
     size: number;
     sha256: string;
+    /** managed includes a path shared by two File Viewer asset owners. */
     ownership: 'managed' | 'shared';
 }
 export interface CapabilityAssetReceipt {
@@ -100,6 +101,7 @@ export declare function uninstallFileViewerCapabilityAssetPack(targetDirInput: s
     targetDir: string;
     removedFiles: string[];
 }>;
+/** Shared implementation for the stable bin shipped by each independent asset-owner package. */
 export declare function runFileViewerAssetPackCli(packRootInput: string, args: string[]): Promise<{
     help: true;
     text: string;

package/dist/index.js

@@ -48,6 +48,7 @@ const nearestExistingParent = async (path) => {
         }
     }
 };
+/** Resolve through the nearest existing ancestor once, then keep every later path inside that canonical root. */
 const prepareTargetDir = async (targetDirInput) => {
     const requested = resolve(targetDirInput);
     const { existing, missing } = await nearestExistingParent(requested);
@@ -183,6 +184,7 @@ const parseLockState = async (path) => {
 };
 const restoreQuarantinedLock = async (quarantinePath, originalPath) => {
     try {
+        // An atomic no-replace restore cannot overwrite a newer claimant.
         await link(quarantinePath, originalPath);
         await rm(quarantinePath, { force: true });
     }
@@ -221,6 +223,7 @@ const reclaimStaleAuxiliaryLock = async (targetDir, path) => {
                 await restoreQuarantinedLock(quarantinePath, path);
             }
             catch {
+                // Keep the quarantined inode and fail closed if another process won.
             }
         }
         throw error;
@@ -284,6 +287,9 @@ const quarantineStaleAssetLock = async (targetDir, lockPath) => {
         try {
             if (!(await parseLockState(lockPath)).stale)
                 return false;
+            // The reaper claim ensures no second stale branch can race this rename.
+            // New contenders may create a fresh lock after the rename, but cleanup only
+            // touches the uniquely named quarantined inode.
             await rename(lockPath, quarantinePath);
             await rm(quarantinePath, { force: true });
             return true;
@@ -1032,6 +1038,7 @@ export async function uninstallFileViewerCapabilityAssetPack(targetDirInput, own
         await releaseAssetLock(lock);
     }
 }
+/** Shared implementation for the stable bin shipped by each independent asset-owner package. */
 export async function runFileViewerAssetPackCli(packRootInput, args) {
     const packRoot = resolve(packRootInput);
     const packageJson = JSON.parse((await readNoFollow(resolve(packRoot, 'package.json'))).toString('utf8'));

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@file-viewer/asset-installer",
-  "version": "3.2.0",
+  "version": "3.2.1",
   "private": false,
   "type": "module",
   "description": "Small transactional installer shared by independently shipped File Viewer capability asset packs.",