@theia/filesystem 1.47.1 → 1.48.1

package/lib/common/filesystem-watcher-protocol.d.ts

@@ -1,72 +1,72 @@
-import { RpcServer } from '@theia/core';
-import { FileChangeType } from './files';
-export { FileChangeType };
-export declare const FileSystemWatcherService: unique symbol;
-/**
- * Singleton implementation of the watch server.
- *
- * Since multiple clients all make requests to this service, we need to track those individually via a `clientId`.
- */
-export interface FileSystemWatcherService extends RpcServer<FileSystemWatcherServiceClient> {
-    /**
-     * @param clientId arbitrary id used to identify a client.
-     * @param uri the path to watch.
-     * @param options optional parameters.
-     * @returns promise to a unique `number` handle for this request.
-     */
-    watchFileChanges(clientId: number, uri: string, options?: WatchOptions): Promise<number>;
-    /**
-     * @param watcherId handle mapping to a previous `watchFileChanges` request.
-     */
-    unwatchFileChanges(watcherId: number): Promise<void>;
-}
-export interface FileSystemWatcherServiceClient {
-    /** Listen for change events emitted by the watcher. */
-    onDidFilesChanged(event: DidFilesChangedParams): void;
-    /** The watcher can crash in certain conditions. */
-    onError(event: FileSystemWatcherErrorParams): void;
-}
-export interface DidFilesChangedParams {
-    /** Clients to route the events to. */
-    clients?: number[];
-    /** FileSystem changes that occurred. */
-    changes: FileChange[];
-}
-export interface FileSystemWatcherErrorParams {
-    /** Clients to route the events to. */
-    clients: number[];
-    /** The uri that originated the error. */
-    uri: string;
-}
-export declare const FileSystemWatcherServer: unique symbol;
-export interface FileSystemWatcherServer extends RpcServer<FileSystemWatcherClient> {
-    /**
-     * Start file watching for the given param.
-     * Resolve when watching is started.
-     * Return a watcher id.
-     */
-    watchFileChanges(uri: string, options?: WatchOptions): Promise<number>;
-    /**
-     * Stop file watching for the given id.
-     * Resolve when watching is stopped.
-     */
-    unwatchFileChanges(watcherId: number): Promise<void>;
-}
-export interface FileSystemWatcherClient {
-    /**
-     * Notify when files under watched uris are changed.
-     */
-    onDidFilesChanged(event: DidFilesChangedParams): void;
-    /**
-     * Notify when unable to watch files because of Linux handle limit.
-     */
-    onError(): void;
-}
-export interface WatchOptions {
-    ignored: string[];
-}
-export interface FileChange {
-    uri: string;
-    type: FileChangeType;
-}
+import { RpcServer } from '@theia/core';
+import { FileChangeType } from './files';
+export { FileChangeType };
+export declare const FileSystemWatcherService: unique symbol;
+/**
+ * Singleton implementation of the watch server.
+ *
+ * Since multiple clients all make requests to this service, we need to track those individually via a `clientId`.
+ */
+export interface FileSystemWatcherService extends RpcServer<FileSystemWatcherServiceClient> {
+    /**
+     * @param clientId arbitrary id used to identify a client.
+     * @param uri the path to watch.
+     * @param options optional parameters.
+     * @returns promise to a unique `number` handle for this request.
+     */
+    watchFileChanges(clientId: number, uri: string, options?: WatchOptions): Promise<number>;
+    /**
+     * @param watcherId handle mapping to a previous `watchFileChanges` request.
+     */
+    unwatchFileChanges(watcherId: number): Promise<void>;
+}
+export interface FileSystemWatcherServiceClient {
+    /** Listen for change events emitted by the watcher. */
+    onDidFilesChanged(event: DidFilesChangedParams): void;
+    /** The watcher can crash in certain conditions. */
+    onError(event: FileSystemWatcherErrorParams): void;
+}
+export interface DidFilesChangedParams {
+    /** Clients to route the events to. */
+    clients?: number[];
+    /** FileSystem changes that occurred. */
+    changes: FileChange[];
+}
+export interface FileSystemWatcherErrorParams {
+    /** Clients to route the events to. */
+    clients: number[];
+    /** The uri that originated the error. */
+    uri: string;
+}
+export declare const FileSystemWatcherServer: unique symbol;
+export interface FileSystemWatcherServer extends RpcServer<FileSystemWatcherClient> {
+    /**
+     * Start file watching for the given param.
+     * Resolve when watching is started.
+     * Return a watcher id.
+     */
+    watchFileChanges(uri: string, options?: WatchOptions): Promise<number>;
+    /**
+     * Stop file watching for the given id.
+     * Resolve when watching is stopped.
+     */
+    unwatchFileChanges(watcherId: number): Promise<void>;
+}
+export interface FileSystemWatcherClient {
+    /**
+     * Notify when files under watched uris are changed.
+     */
+    onDidFilesChanged(event: DidFilesChangedParams): void;
+    /**
+     * Notify when unable to watch files because of Linux handle limit.
+     */
+    onError(): void;
+}
+export interface WatchOptions {
+    ignored: string[];
+}
+export interface FileChange {
+    uri: string;
+    type: FileChangeType;
+}
 //# sourceMappingURL=filesystem-watcher-protocol.d.ts.map

package/lib/common/filesystem-watcher-protocol.js

@@ -1,21 +1,21 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2017 TypeFox and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileSystemWatcherServer = exports.FileSystemWatcherService = void 0;
-exports.FileSystemWatcherService = Symbol('FileSystemWatcherServer2');
-exports.FileSystemWatcherServer = Symbol('FileSystemWatcherServer');
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileSystemWatcherServer = exports.FileSystemWatcherService = void 0;
+exports.FileSystemWatcherService = Symbol('FileSystemWatcherServer2');
+exports.FileSystemWatcherServer = Symbol('FileSystemWatcherServer');
 //# sourceMappingURL=filesystem-watcher-protocol.js.map

package/lib/common/filesystem.d.ts

@@ -1,23 +1,23 @@
-export declare namespace FileAccess {
-    namespace Constants {
-        /**
-         * Flag indicating that the file is visible to the calling process.
-         * This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
-         */
-        const F_OK: number;
-        /**
-         * Flag indicating that the file can be read by the calling process.
-         */
-        const R_OK: number;
-        /**
-         * Flag indicating that the file can be written by the calling process.
-         */
-        const W_OK: number;
-        /**
-         * Flag indicating that the file can be executed by the calling process.
-         * This has no effect on Windows (will behave like `FileAccess.F_OK`).
-         */
-        const X_OK: number;
-    }
-}
+export declare namespace FileAccess {
+    namespace Constants {
+        /**
+         * Flag indicating that the file is visible to the calling process.
+         * This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
+         */
+        const F_OK: number;
+        /**
+         * Flag indicating that the file can be read by the calling process.
+         */
+        const R_OK: number;
+        /**
+         * Flag indicating that the file can be written by the calling process.
+         */
+        const W_OK: number;
+        /**
+         * Flag indicating that the file can be executed by the calling process.
+         * This has no effect on Windows (will behave like `FileAccess.F_OK`).
+         */
+        const X_OK: number;
+    }
+}
 //# sourceMappingURL=filesystem.d.ts.map

package/lib/common/filesystem.js

@@ -1,43 +1,43 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2017 TypeFox and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.FileAccess = void 0;
-var FileAccess;
-(function (FileAccess) {
-    let Constants;
-    (function (Constants) {
-        /**
-         * Flag indicating that the file is visible to the calling process.
-         * This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
-         */
-        Constants.F_OK = 0;
-        /**
-         * Flag indicating that the file can be read by the calling process.
-         */
-        Constants.R_OK = 4;
-        /**
-         * Flag indicating that the file can be written by the calling process.
-         */
-        Constants.W_OK = 2;
-        /**
-         * Flag indicating that the file can be executed by the calling process.
-         * This has no effect on Windows (will behave like `FileAccess.F_OK`).
-         */
-        Constants.X_OK = 1;
-    })(Constants = FileAccess.Constants || (FileAccess.Constants = {}));
-})(FileAccess = exports.FileAccess || (exports.FileAccess = {}));
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.FileAccess = void 0;
+var FileAccess;
+(function (FileAccess) {
+    let Constants;
+    (function (Constants) {
+        /**
+         * Flag indicating that the file is visible to the calling process.
+         * This is useful for determining if a file exists, but says nothing about rwx permissions. Default if no mode is specified.
+         */
+        Constants.F_OK = 0;
+        /**
+         * Flag indicating that the file can be read by the calling process.
+         */
+        Constants.R_OK = 4;
+        /**
+         * Flag indicating that the file can be written by the calling process.
+         */
+        Constants.W_OK = 2;
+        /**
+         * Flag indicating that the file can be executed by the calling process.
+         * This has no effect on Windows (will behave like `FileAccess.F_OK`).
+         */
+        Constants.X_OK = 1;
+    })(Constants = FileAccess.Constants || (FileAccess.Constants = {}));
+})(FileAccess = exports.FileAccess || (exports.FileAccess = {}));
 //# sourceMappingURL=filesystem.js.map

package/lib/common/index.d.ts

@@ -1,3 +1,3 @@
-export * from './filesystem';
-export * from './filesystem-utils';
+export * from './filesystem';
+export * from './filesystem-utils';
 //# sourceMappingURL=index.d.ts.map

package/lib/common/index.js

@@ -1,21 +1,21 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2017 TypeFox and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-Object.defineProperty(exports, "__esModule", { value: true });
-const tslib_1 = require("tslib");
-(0, tslib_1.__exportStar)(require("./filesystem"), exports);
-(0, tslib_1.__exportStar)(require("./filesystem-utils"), exports);
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2017 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+Object.defineProperty(exports, "__esModule", { value: true });
+const tslib_1 = require("tslib");
+(0, tslib_1.__exportStar)(require("./filesystem"), exports);
+(0, tslib_1.__exportStar)(require("./filesystem-utils"), exports);
 //# sourceMappingURL=index.js.map

package/lib/common/io.d.ts

@@ -1,20 +1,20 @@
-import URI from '@theia/core/lib/common/uri';
-import { BinaryBuffer } from '@theia/core/lib/common//buffer';
-import { CancellationToken } from '@theia/core/lib/common/cancellation';
-import { FileSystemProviderWithOpenReadWriteCloseCapability, FileReadStreamOptions } from './files';
-import { WriteableStream, ErrorTransformer, DataTransformer } from '@theia/core/lib/common/stream';
-export interface CreateReadStreamOptions extends FileReadStreamOptions {
-    /**
-     * The size of the buffer to use before sending to the stream.
-     */
-    bufferSize: number;
-    /**
-     * Allows to massage any possibly error that happens during reading.
-     */
-    errorTransformer?: ErrorTransformer;
-}
-/**
- * A helper to read a file from a provider with open/read/close capability into a stream.
- */
-export declare function readFileIntoStream<T>(provider: FileSystemProviderWithOpenReadWriteCloseCapability, resource: URI, target: WriteableStream<T>, transformer: DataTransformer<BinaryBuffer, T>, options: CreateReadStreamOptions, token: CancellationToken): Promise<void>;
+import URI from '@theia/core/lib/common/uri';
+import { BinaryBuffer } from '@theia/core/lib/common//buffer';
+import { CancellationToken } from '@theia/core/lib/common/cancellation';
+import { FileSystemProviderWithOpenReadWriteCloseCapability, FileReadStreamOptions } from './files';
+import { WriteableStream, ErrorTransformer, DataTransformer } from '@theia/core/lib/common/stream';
+export interface CreateReadStreamOptions extends FileReadStreamOptions {
+    /**
+     * The size of the buffer to use before sending to the stream.
+     */
+    bufferSize: number;
+    /**
+     * Allows to massage any possibly error that happens during reading.
+     */
+    errorTransformer?: ErrorTransformer;
+}
+/**
+ * A helper to read a file from a provider with open/read/close capability into a stream.
+ */
+export declare function readFileIntoStream<T>(provider: FileSystemProviderWithOpenReadWriteCloseCapability, resource: URI, target: WriteableStream<T>, transformer: DataTransformer<BinaryBuffer, T>, options: CreateReadStreamOptions, token: CancellationToken): Promise<void>;
 //# sourceMappingURL=io.d.ts.map

package/lib/common/io.js

@@ -1,111 +1,111 @@
-"use strict";
-// *****************************************************************************
-// Copyright (C) 2020 TypeFox and others.
-//
-// This program and the accompanying materials are made available under the
-// terms of the Eclipse Public License v. 2.0 which is available at
-// http://www.eclipse.org/legal/epl-2.0.
-//
-// This Source Code may also be made available under the following Secondary
-// Licenses when the conditions for such availability set forth in the Eclipse
-// Public License v. 2.0 are satisfied: GNU General Public License, version 2
-// with the GNU Classpath Exception which is available at
-// https://www.gnu.org/software/classpath/license.html.
-//
-// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
-// *****************************************************************************
-/*---------------------------------------------------------------------------------------------
- *  Copyright (c) Microsoft Corporation. All rights reserved.
- *  Licensed under the MIT License. See License.txt in the project root for license information.
- *--------------------------------------------------------------------------------------------*/
-// based on https://github.com/microsoft/vscode/blob/04c36be045a94fee58e5f8992d3e3fd980294a84/src/vs/platform/files/common/io.ts
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.readFileIntoStream = void 0;
-const buffer_1 = require("@theia/core/lib/common//buffer");
-const cancellation_1 = require("@theia/core/lib/common/cancellation");
-const files_1 = require("./files");
-/**
- * A helper to read a file from a provider with open/read/close capability into a stream.
- */
-async function readFileIntoStream(provider, resource, target, transformer, options, token) {
-    let error = undefined;
-    try {
-        await doReadFileIntoStream(provider, resource, target, transformer, options, token);
-    }
-    catch (err) {
-        error = err;
-    }
-    finally {
-        if (error && options.errorTransformer) {
-            error = options.errorTransformer(error);
-        }
-        target.end(error);
-    }
-}
-exports.readFileIntoStream = readFileIntoStream;
-async function doReadFileIntoStream(provider, resource, target, transformer, options, token) {
-    // Check for cancellation
-    throwIfCancelled(token);
-    // open handle through provider
-    const handle = await provider.open(resource, { create: false });
-    // Check for cancellation
-    throwIfCancelled(token);
-    try {
-        let totalBytesRead = 0;
-        let bytesRead = 0;
-        let allowedRemainingBytes = (options && typeof options.length === 'number') ? options.length : undefined;
-        let buffer = buffer_1.BinaryBuffer.alloc(Math.min(options.bufferSize, typeof allowedRemainingBytes === 'number' ? allowedRemainingBytes : options.bufferSize));
-        let posInFile = options && typeof options.position === 'number' ? options.position : 0;
-        let posInBuffer = 0;
-        do {
-            // read from source (handle) at current position (pos) into buffer (buffer) at
-            // buffer position (posInBuffer) up to the size of the buffer (buffer.byteLength).
-            bytesRead = await provider.read(handle, posInFile, buffer.buffer, posInBuffer, buffer.byteLength - posInBuffer);
-            posInFile += bytesRead;
-            posInBuffer += bytesRead;
-            totalBytesRead += bytesRead;
-            if (typeof allowedRemainingBytes === 'number') {
-                allowedRemainingBytes -= bytesRead;
-            }
-            // when buffer full, create a new one and emit it through stream
-            if (posInBuffer === buffer.byteLength) {
-                await target.write(transformer(buffer));
-                buffer = buffer_1.BinaryBuffer.alloc(Math.min(options.bufferSize, typeof allowedRemainingBytes === 'number' ? allowedRemainingBytes : options.bufferSize));
-                posInBuffer = 0;
-            }
-        } while (bytesRead > 0 && (typeof allowedRemainingBytes !== 'number' || allowedRemainingBytes > 0) && throwIfCancelled(token) && throwIfTooLarge(totalBytesRead, options));
-        // wrap up with last buffer (also respect maxBytes if provided)
-        if (posInBuffer > 0) {
-            let lastChunkLength = posInBuffer;
-            if (typeof allowedRemainingBytes === 'number') {
-                lastChunkLength = Math.min(posInBuffer, allowedRemainingBytes);
-            }
-            target.write(transformer(buffer.slice(0, lastChunkLength)));
-        }
-    }
-    catch (error) {
-        throw (0, files_1.ensureFileSystemProviderError)(error);
-    }
-    finally {
-        await provider.close(handle);
-    }
-}
-function throwIfCancelled(token) {
-    if (token.isCancellationRequested) {
-        throw (0, cancellation_1.cancelled)();
-    }
-    return true;
-}
-function throwIfTooLarge(totalBytesRead, options) {
-    // Return early if file is too large to load and we have configured limits
-    if (options === null || options === void 0 ? void 0 : options.limits) {
-        if (typeof options.limits.memory === 'number' && totalBytesRead > options.limits.memory) {
-            throw (0, files_1.createFileSystemProviderError)('To open a file of this size, you need to restart and allow it to use more memory', files_1.FileSystemProviderErrorCode.FileExceedsMemoryLimit);
-        }
-        if (typeof options.limits.size === 'number' && totalBytesRead > options.limits.size) {
-            throw (0, files_1.createFileSystemProviderError)('File is too large to open', files_1.FileSystemProviderErrorCode.FileTooLarge);
-        }
-    }
-    return true;
-}
+"use strict";
+// *****************************************************************************
+// Copyright (C) 2020 TypeFox and others.
+//
+// This program and the accompanying materials are made available under the
+// terms of the Eclipse Public License v. 2.0 which is available at
+// http://www.eclipse.org/legal/epl-2.0.
+//
+// This Source Code may also be made available under the following Secondary
+// Licenses when the conditions for such availability set forth in the Eclipse
+// Public License v. 2.0 are satisfied: GNU General Public License, version 2
+// with the GNU Classpath Exception which is available at
+// https://www.gnu.org/software/classpath/license.html.
+//
+// SPDX-License-Identifier: EPL-2.0 OR GPL-2.0-only WITH Classpath-exception-2.0
+// *****************************************************************************
+/*---------------------------------------------------------------------------------------------
+ *  Copyright (c) Microsoft Corporation. All rights reserved.
+ *  Licensed under the MIT License. See License.txt in the project root for license information.
+ *--------------------------------------------------------------------------------------------*/
+// based on https://github.com/microsoft/vscode/blob/04c36be045a94fee58e5f8992d3e3fd980294a84/src/vs/platform/files/common/io.ts
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.readFileIntoStream = void 0;
+const buffer_1 = require("@theia/core/lib/common//buffer");
+const cancellation_1 = require("@theia/core/lib/common/cancellation");
+const files_1 = require("./files");
+/**
+ * A helper to read a file from a provider with open/read/close capability into a stream.
+ */
+async function readFileIntoStream(provider, resource, target, transformer, options, token) {
+    let error = undefined;
+    try {
+        await doReadFileIntoStream(provider, resource, target, transformer, options, token);
+    }
+    catch (err) {
+        error = err;
+    }
+    finally {
+        if (error && options.errorTransformer) {
+            error = options.errorTransformer(error);
+        }
+        target.end(error);
+    }
+}
+exports.readFileIntoStream = readFileIntoStream;
+async function doReadFileIntoStream(provider, resource, target, transformer, options, token) {
+    // Check for cancellation
+    throwIfCancelled(token);
+    // open handle through provider
+    const handle = await provider.open(resource, { create: false });
+    // Check for cancellation
+    throwIfCancelled(token);
+    try {
+        let totalBytesRead = 0;
+        let bytesRead = 0;
+        let allowedRemainingBytes = (options && typeof options.length === 'number') ? options.length : undefined;
+        let buffer = buffer_1.BinaryBuffer.alloc(Math.min(options.bufferSize, typeof allowedRemainingBytes === 'number' ? allowedRemainingBytes : options.bufferSize));
+        let posInFile = options && typeof options.position === 'number' ? options.position : 0;
+        let posInBuffer = 0;
+        do {
+            // read from source (handle) at current position (pos) into buffer (buffer) at
+            // buffer position (posInBuffer) up to the size of the buffer (buffer.byteLength).
+            bytesRead = await provider.read(handle, posInFile, buffer.buffer, posInBuffer, buffer.byteLength - posInBuffer);
+            posInFile += bytesRead;
+            posInBuffer += bytesRead;
+            totalBytesRead += bytesRead;
+            if (typeof allowedRemainingBytes === 'number') {
+                allowedRemainingBytes -= bytesRead;
+            }
+            // when buffer full, create a new one and emit it through stream
+            if (posInBuffer === buffer.byteLength) {
+                await target.write(transformer(buffer));
+                buffer = buffer_1.BinaryBuffer.alloc(Math.min(options.bufferSize, typeof allowedRemainingBytes === 'number' ? allowedRemainingBytes : options.bufferSize));
+                posInBuffer = 0;
+            }
+        } while (bytesRead > 0 && (typeof allowedRemainingBytes !== 'number' || allowedRemainingBytes > 0) && throwIfCancelled(token) && throwIfTooLarge(totalBytesRead, options));
+        // wrap up with last buffer (also respect maxBytes if provided)
+        if (posInBuffer > 0) {
+            let lastChunkLength = posInBuffer;
+            if (typeof allowedRemainingBytes === 'number') {
+                lastChunkLength = Math.min(posInBuffer, allowedRemainingBytes);
+            }
+            target.write(transformer(buffer.slice(0, lastChunkLength)));
+        }
+    }
+    catch (error) {
+        throw (0, files_1.ensureFileSystemProviderError)(error);
+    }
+    finally {
+        await provider.close(handle);
+    }
+}
+function throwIfCancelled(token) {
+    if (token.isCancellationRequested) {
+        throw (0, cancellation_1.cancelled)();
+    }
+    return true;
+}
+function throwIfTooLarge(totalBytesRead, options) {
+    // Return early if file is too large to load and we have configured limits
+    if (options === null || options === void 0 ? void 0 : options.limits) {
+        if (typeof options.limits.memory === 'number' && totalBytesRead > options.limits.memory) {
+            throw (0, files_1.createFileSystemProviderError)('To open a file of this size, you need to restart and allow it to use more memory', files_1.FileSystemProviderErrorCode.FileExceedsMemoryLimit);
+        }
+        if (typeof options.limits.size === 'number' && totalBytesRead > options.limits.size) {
+            throw (0, files_1.createFileSystemProviderError)('File is too large to open', files_1.FileSystemProviderErrorCode.FileTooLarge);
+        }
+    }
+    return true;
+}
 //# sourceMappingURL=io.js.map