refactor(cos): use singular requestFileHandle() instead of requestFileHandles() (#1709)

* refactor: use singular requestFileHandle() instead of requestFileHandles()

Switch to the new singular API as adopted in:
WICG/cross-origin-storage#61

* refactor: use singular requestFileHandle() instead of requestFileHandles()

Switch to the new singular API as adopted in:
WICG/cross-origin-storage#61

Author: tomayac

packages/transformers/src/utils/cache/CrossOriginStorageCache.js

@@ -57,7 +57,7 @@ export class CrossOriginStorage {
             return undefined;
         }
         try {
-            const [handle] = await navigator.crossOriginStorage.requestFileHandles([makeHashDescriptor(hashValue)]);
+            const handle = await navigator.crossOriginStorage.requestFileHandle(makeHashDescriptor(hashValue));
             const blob = await handle.getFile();
             return new Response(blob, {
                 headers: {
@@ -110,7 +110,7 @@ export class CrossOriginStorage {
      * @returns {Promise<void>}
      */
     _storeBlobInCOS = async (blob, hashHex) => {
-        const [handle] = await navigator.crossOriginStorage.requestFileHandles([makeHashDescriptor(hashHex)], {
+        const handle = await navigator.crossOriginStorage.requestFileHandle(makeHashDescriptor(hashHex), {
             create: true,
         });
         const writableStream = await handle.createWritable();

packages/transformers/src/utils/cache/cross-origin-storage.d.ts

@@ -5,15 +5,15 @@
  */
 
 /**
- * Represents the dictionary for hash algorithms and values.
+ * Represents the dictionary for hash algorithm and value.
  */
 interface CrossOriginStorageRequestFileHandleHash {
     value: string;
     algorithm: string;
 }
 
 /**
- * Represents the options for requesting file handles.
+ * Represents the options for requesting a file handle.
  */
 interface CrossOriginStorageRequestFileHandleOptions {
     create?: boolean;
@@ -24,10 +24,10 @@ interface CrossOriginStorageRequestFileHandleOptions {
  * [SecureContext]
  */
 interface CrossOriginStorageManager {
-    requestFileHandles(
-        hashes: CrossOriginStorageRequestFileHandleHash[],
+    requestFileHandle(
+        hash: CrossOriginStorageRequestFileHandleHash,
         options?: CrossOriginStorageRequestFileHandleOptions,
-    ): Promise<FileSystemFileHandle[]>;
+    ): Promise<FileSystemFileHandle>;
 }
 
 /**