koa-files 4.1.7 → 5.0.0

package/cjs/utils/path.cjs

@@ -1,7 +1,8 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme
@@ -9,7 +10,7 @@
 
 'use strict';
 
-const path = require('path');
+const node_path = require('node:path');
 
 /**
  * @module path
@@ -36,9 +37,9 @@ function hasTrailingSlash(path) {
  * @param path The path to check.
  * @param root The root path.
  */
-function isOutRoot(path$1, root) {
-  path$1 = path.relative(root, path$1);
-  return /\.\.(?:[\\/]|$)/.test(path$1) || path.isAbsolute(path$1);
+function isOutRoot(path, root) {
+  path = node_path.relative(root, path);
+  return /\.\.(?:[\\/]|$)/.test(path) || node_path.isAbsolute(path);
 }
 
 exports.hasTrailingSlash = hasTrailingSlash;

package/cjs/utils/type.cjs

@@ -1,7 +1,8 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme

package/esm/ReadStream.d.ts

@@ -1,9 +1,8 @@
 /**
  * @module ReadStream
  */
-import { PathLike } from 'fs';
-import { Readable } from 'stream';
 import { Range } from './utils/http.js';
+import { Readable } from 'node:stream';
 import { FileSystem } from './utils/fs.js';
 export interface Options {
   fs: FileSystem;
@@ -13,67 +12,26 @@ interface Callback {
   (error?: Error | null): void;
 }
 export declare class ReadStream extends Readable {
-  private readonly fs;
-  private readonly path;
-  private readonly ranges;
-  private bytesRead;
-  private fd;
-  private reading;
-  private currentRangeIndex;
-  private readState;
+  #private;
   /**
    * @constructor
    * @param path The file path.
    * @param ranges The ranges to read.
    * @param options The stream options.
    */
-  constructor(path: PathLike, ranges: Range[], options: Options);
+  constructor(path: string, ranges: Range[], options: Options);
   /**
    * @override
    * @method _construct
    * @param callback The callback.
    */
   _construct(callback: Callback): void;
-  /**
-   * @private
-   * @method getRange
-   */
-  private getRange;
-  /**
-   * @private
-   * @method getPadding
-   * @param range The current range.
-   */
-  private getPadding;
-  /**
-   * @private
-   * @method readPadding
-   * @param fd The file descriptor.
-   * @param range The current range.
-   * @param size The number of bytes to read.
-   */
-  private readPadding;
-  /**
-   * @private
-   * @method readFileRange
-   * @param fd The file descriptor.
-   * @param range The current range.
-   * @param size The number of bytes to read.
-   */
-  private readFileRange;
   /**
    * @override
    * @method _read
    * @param size The number of bytes to read.
    */
   _read(size: number): void;
-  /**
-   * @private
-   * @method dispose
-   * @param error The error.
-   * @param callback The callback.
-   */
-  private dispose;
   /**
    * @override
    * @method _destroy

package/esm/ReadStream.js

@@ -1,20 +1,29 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme
  */
 
-import { Buffer } from 'buffer';
-import { Readable } from 'stream';
+import { Buffer } from 'node:buffer';
+import { Readable } from 'node:stream';
 
 /**
  * @module ReadStream
  */
 const DISPOSE_EVENT = Symbol('dispose');
 class ReadStream extends Readable {
+  #path;
+  #fs;
+  #ranges;
+  #bytesRead = 0;
+  #fd = null;
+  #reading = false;
+  #currentRangeIndex = 0;
+  #readState = 0 /* ReadState.PREFIX */;
   /**
    * @constructor
    * @param path The file path.
@@ -24,14 +33,9 @@ class ReadStream extends Readable {
   constructor(path, ranges, options) {
     const { fs, highWaterMark } = options;
     super({ highWaterMark });
-    this.bytesRead = 0;
-    this.fd = null;
-    this.reading = false;
-    this.currentRangeIndex = 0;
-    this.readState = 0 /* ReadState.PREFIX */;
-    this.fs = fs;
-    this.path = path;
-    this.ranges = ranges;
+    this.#fs = fs;
+    this.#path = path;
+    this.#ranges = ranges;
   }
   /**
    * @override
@@ -39,27 +43,27 @@ class ReadStream extends Readable {
    * @param callback The callback.
    */
   _construct(callback) {
-    this.fs.open(this.path, 'r', (openError, fd) => {
+    this.#fs.open(this.#path, 'r', (openError, fd) => {
       if (openError == null) {
-        this.fd = fd;
+        this.#fd = fd;
       }
       callback(openError);
     });
   }
   /**
    * @private
-   * @method getRange
+   * @method #getRange
    */
-  getRange() {
-    return this.ranges[this.currentRangeIndex];
+  #getRange() {
+    return this.#ranges[this.#currentRangeIndex];
   }
   /**
    * @private
-   * @method getPadding
+   * @method #getPadding
    * @param range The current range.
    */
-  getPadding(range) {
-    switch (this.readState) {
+  #getPadding(range) {
+    switch (this.#readState) {
       case 0 /* ReadState.PREFIX */:
         return range.prefix;
       case 2 /* ReadState.SUFFIX */:
@@ -68,42 +72,42 @@ class ReadStream extends Readable {
   }
   /**
    * @private
-   * @method readPadding
+   * @method #readPadding
    * @param fd The file descriptor.
    * @param range The current range.
    * @param size The number of bytes to read.
    */
-  readPadding(fd, range, size) {
+  #readPadding(fd, range, size) {
     let bytesRead = 0;
-    const padding = this.getPadding(range);
+    const padding = this.#getPadding(range);
     // If padding exists.
     if (padding != null) {
       const { length } = padding;
-      const begin = this.bytesRead;
+      const begin = this.#bytesRead;
       if (begin < length) {
         bytesRead = Math.min(size, length - begin);
         const end = begin + bytesRead;
         this.push(padding.subarray(begin, end));
-        this.bytesRead = end;
+        this.#bytesRead = end;
       }
     }
     // If no padding or read completed.
     if (bytesRead < size) {
-      this.bytesRead = 0;
+      this.#bytesRead = 0;
       // Change read state.
-      switch (this.readState) {
+      switch (this.#readState) {
         case 0 /* ReadState.PREFIX */:
-          this.readState = 1 /* ReadState.RANGE */;
-          this.readFileRange(fd, range, size - bytesRead);
+          this.#readState = 1 /* ReadState.RANGE */;
+          this.#readFileRange(fd, range, size - bytesRead);
           break;
         case 2 /* ReadState.SUFFIX */:
-          this.currentRangeIndex++;
-          this.readState = 0 /* ReadState.PREFIX */;
-          const nextRange = this.getRange();
+          this.#currentRangeIndex++;
+          this.#readState = 0 /* ReadState.PREFIX */;
+          const nextRange = this.#getRange();
           if (nextRange == null) {
             this.push(null);
           } else {
-            this.readPadding(fd, nextRange, size - bytesRead);
+            this.#readPadding(fd, nextRange, size - bytesRead);
           }
           break;
       }
@@ -111,23 +115,23 @@ class ReadStream extends Readable {
   }
   /**
    * @private
-   * @method readFileRange
+   * @method #readFileRange
    * @param fd The file descriptor.
    * @param range The current range.
    * @param size The number of bytes to read.
    */
-  readFileRange(fd, range, size) {
+  #readFileRange(fd, range, size) {
     const { length } = range;
-    const { bytesRead } = this;
+    const bytesRead = this.#bytesRead;
     // File range not finished.
     if (bytesRead < length) {
-      this.reading = true;
+      this.#reading = true;
       const bytesToRead = Math.min(size, length - bytesRead);
       const buffer = Buffer.allocUnsafeSlow(bytesToRead);
       const position = range.offset + bytesRead;
       // Read file range.
-      this.fs.read(fd, buffer, 0, bytesToRead, position, (readError, bytesRead, buffer) => {
-        this.reading = false;
+      this.#fs.read(fd, buffer, 0, bytesToRead, position, (readError, bytesRead, buffer) => {
+        this.#reading = false;
         // Tell ._destroy() that it's safe to close the fd now.
         if (this.destroyed) {
           this.emit(DISPOSE_EVENT, readError);
@@ -137,19 +141,19 @@ class ReadStream extends Readable {
           this.destroy(new RangeError('invalid read operation'));
         } else {
           this.push(buffer);
-          this.bytesRead += bytesRead;
+          this.#bytesRead += bytesRead;
           // file range read completed.
           if (bytesRead < size) {
-            this.bytesRead = 0;
-            this.readState = 2 /* ReadState.SUFFIX */;
-            this.readPadding(fd, range, size - bytesRead);
+            this.#bytesRead = 0;
+            this.#readState = 2 /* ReadState.SUFFIX */;
+            this.#readPadding(fd, range, size - bytesRead);
           }
         }
       });
     } else {
-      this.bytesRead = 0;
-      this.readState = 2 /* ReadState.SUFFIX */;
-      this.readPadding(fd, range, size);
+      this.#bytesRead = 0;
+      this.#readState = 2 /* ReadState.SUFFIX */;
+      this.#readPadding(fd, range, size);
     }
   }
   /**
@@ -158,21 +162,21 @@ class ReadStream extends Readable {
    * @param size The number of bytes to read.
    */
   _read(size) {
-    if (!this.reading) {
-      const { fd } = this;
-      const range = this.getRange();
+    if (!this.#reading) {
+      const fd = this.#fd;
+      const range = this.#getRange();
       // If fd or range is null, finish stream.
       if (fd == null || range == null) {
         this.push(null);
       } else {
         // Read bytes from range.
-        switch (this.readState) {
+        switch (this.#readState) {
           case 0 /* ReadState.PREFIX */:
           case 2 /* ReadState.SUFFIX */:
-            this.readPadding(fd, range, size);
+            this.#readPadding(fd, range, size);
             break;
           case 1 /* ReadState.RANGE */:
-            this.readFileRange(fd, range, size);
+            this.#readFileRange(fd, range, size);
             break;
         }
       }
@@ -180,17 +184,17 @@ class ReadStream extends Readable {
   }
   /**
    * @private
-   * @method dispose
+   * @method #dispose
    * @param error The error.
    * @param callback The callback.
    */
-  dispose(error, callback) {
-    const { fd } = this;
+  #dispose(error, callback) {
+    const fd = this.#fd;
     if (fd != null) {
-      this.fd = null;
+      this.#fd = null;
       // Close the fd.
-      this.fs.close(fd, closeError => {
-        callback(error !== null && error !== void 0 ? error : closeError);
+      this.#fs.close(fd, closeError => {
+        callback(error ?? closeError);
       });
     } else {
       callback(error);
@@ -204,12 +208,12 @@ class ReadStream extends Readable {
    */
   _destroy(error, callback) {
     // Wait I/O completion.
-    if (this.reading) {
+    if (this.#reading) {
       this.once(DISPOSE_EVENT, disposeError => {
-        this.dispose(error !== null && error !== void 0 ? error : disposeError, callback);
+        this.#dispose(error ?? disposeError, callback);
       });
     } else {
-      this.dispose(error, callback);
+      this.#dispose(error, callback);
     }
   }
 }

package/esm/Service.d.ts

@@ -2,7 +2,7 @@
  * @module Service
  */
 import { Context } from 'koa';
-import { Stats } from 'fs';
+import { Stats } from 'node:fs';
 import { FileSystem } from './utils/fs.js';
 interface Headers {
   [key: string]: string | string[];
@@ -29,8 +29,7 @@ export interface Options {
  * @class Service
  */
 export declare class Service {
-  private readonly root;
-  private readonly options;
+  #private;
   /**
    * @constructor
    * @description Create file service.
@@ -38,15 +37,6 @@ export declare class Service {
    * @param options The file service options.
    */
   constructor(root: string, options?: Options);
-  /**
-   * @private
-   * @method setupHeaders
-   * @description Setup headers.
-   * @param context The koa context.
-   * @param path The file path.
-   * @param stats The file stats.
-   */
-  private setupHeaders;
   /**
    * @public
    * @method respond

package/esm/Service.js

@@ -1,18 +1,19 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme
  */
 
 import createETag from 'etag';
-import fs from 'fs';
+import fs from 'node:fs';
 import { ReadStream } from './ReadStream.js';
 import { isFunction } from './utils/type.js';
 import { stat } from './utils/fs.js';
-import { resolve, extname, join } from 'path';
+import { resolve, extname, join } from 'node:path';
 import { unixify, isOutRoot, hasTrailingSlash } from './utils/path.js';
 import { decodeURI, isConditionalGET, isPreconditionFailed, parseRanges } from './utils/http.js';
 
@@ -23,6 +24,8 @@ import { decodeURI, isConditionalGET, isPreconditionFailed, parseRanges } from '
  * @class Service
  */
 class Service {
+  #root;
+  #options;
   /**
    * @constructor
    * @description Create file service.
@@ -30,26 +33,26 @@ class Service {
    * @param options The file service options.
    */
   constructor(root, options = {}) {
-    var _a;
-    this.root = unixify(resolve(root));
+    this.#root = unixify(resolve(root));
     const { ignore, headers, highWaterMark = 65536 } = options;
-    this.options = Object.assign(Object.assign({}, options), {
-      fs: (_a = options.fs) !== null && _a !== void 0 ? _a : fs,
+    this.#options = {
+      ...options,
+      fs: options.fs ?? fs,
       ignore: isFunction(ignore) ? ignore : () => false,
       headers: isFunction(headers) ? headers : () => headers,
       highWaterMark: isFunction(highWaterMark) ? highWaterMark : () => highWaterMark
-    });
+    };
   }
   /**
    * @private
-   * @method setupHeaders
+   * @method #setupHeaders
    * @description Setup headers.
    * @param context The koa context.
    * @param path The file path.
    * @param stats The file stats.
    */
-  async setupHeaders({ response }, path, stats) {
-    const { options } = this;
+  async #setupHeaders({ response }, path, stats) {
+    const options = this.#options;
     // Set status.
     response.status = 200;
     // Set Content-Type.
@@ -105,7 +108,7 @@ class Service {
       return context.throw(400);
     }
     // Get service root.
-    const { root } = this;
+    const root = this.#root;
     // Get file path.
     const path = unixify(join(root, pathname));
     // Malicious path (403).
@@ -113,7 +116,7 @@ class Service {
       return false;
     }
     // Get options.
-    const { options } = this;
+    const options = this.#options;
     // Is ignore path or file (403).
     if (await options.ignore(path)) {
       return false;
@@ -134,7 +137,7 @@ class Service {
     // Koa response.
     const { response } = context;
     // Setup headers.
-    await this.setupHeaders(context, path, stats);
+    await this.#setupHeaders(context, path, stats);
     // Conditional get support.
     if (isConditionalGET(context)) {
       // Request precondition failed.

package/esm/index.js

@@ -1,7 +1,8 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme
@@ -20,7 +21,7 @@ import { Service } from './Service.js';
  */
 function server(root, options) {
   const service = new Service(root, options);
-  if (options === null || options === void 0 ? void 0 : options.defer) {
+  if (options?.defer) {
     return async (context, next) => {
       await next();
       await service.respond(context);

package/esm/utils/fs.d.ts

@@ -1,12 +1,24 @@
 /**
  * @module fs
  */
-import fs, { Stats } from 'fs';
+import { PathLike, Stats } from 'node:fs';
+type Position = number | bigint | null;
+type OpenMode = string | number | undefined;
+interface Callback<T extends unknown[] = []> {
+  (error?: Error | null, ...rest: T): void;
+}
 export interface FileSystem {
-  stat: typeof fs.stat;
-  open: typeof fs.open;
-  read: typeof fs.read;
-  close: typeof fs.close;
+  close(fd: number, callback?: Callback): void;
+  read<T extends ArrayBufferView>(
+    fd: number,
+    buffer: T,
+    offset: number,
+    length: number,
+    position: Position,
+    callback: Callback<[bytesRead: number, buffer: T]>
+  ): void;
+  stat(path: PathLike, callback: Callback<[stats: Stats]>): void;
+  open(path: PathLike, flags: OpenMode, callback: Callback<[fd: number]>): void;
 }
 /**
  * @function stat
@@ -15,3 +27,4 @@ export interface FileSystem {
  * @param path The file path.
  */
 export declare function stat(fs: FileSystem, path: string): Promise<Stats | null>;
+export {};

package/esm/utils/fs.js

@@ -1,7 +1,8 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme

package/esm/utils/hash.js

@@ -1,13 +1,14 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme
  */
 
-import { getRandomValues } from 'crypto';
+import { getRandomValues } from 'node:crypto';
 
 /**
  * @module hash

package/esm/utils/http.d.ts

@@ -1,9 +1,9 @@
 /**
  * @module http
  */
-import { Stats } from 'fs';
 import { Context } from 'koa';
-import { Buffer } from 'buffer';
+import { Stats } from 'node:fs';
+import { Buffer } from 'node:buffer';
 export interface Range {
   offset: number;
   length: number;

package/esm/utils/http.js

@@ -1,14 +1,15 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme
  */
 
-import { Buffer } from 'buffer';
 import { generate } from './hash.js';
+import { Buffer } from 'node:buffer';
 import parseRange from 'range-parser';
 
 /**
@@ -24,7 +25,7 @@ const SINGLE_ETAG_RE = /^(?:W\/)?"[ !#-\x7E\x80-\xFF]+"$/;
 function decodeURI(URI) {
   try {
     return decodeURIComponent(URI);
-  } catch (_a) {
+  } catch {
     return -1;
   }
 }
@@ -156,7 +157,9 @@ function parseRanges(context, stats) {
             const length = end - start + 1;
             const head = index > 0 ? '\r\n' : '';
             const contentRange = `Content-Range: bytes ${start}-${end}/${size}`;
-            const prefix = Buffer.from(`${head}--${boundary}\r\n${contentType}\r\n${contentRange}\r\n\r\n`);
+            const prefix = Buffer.from(
+              `${head}--${boundary}\r\n${contentType}\r\n${contentRange}\r\n\r\n`
+            );
             // Compute Content-Length
             contentLength += prefix.length + length;
             // Cache range.

package/esm/utils/path.js

@@ -1,13 +1,14 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme
  */
 
-import { relative, isAbsolute } from 'path';
+import { relative, isAbsolute } from 'node:path';
 
 /**
  * @module path

package/esm/utils/type.js

@@ -1,7 +1,8 @@
 /**
+ * @module koa-files
  * @package koa-files
  * @license MIT
- * @version 4.1.7
+ * @version 5.0.0
  * @author nuintun <nuintun@qq.com>
  * @description A static files serving middleware for koa.
  * @see https://github.com/nuintun/koa-files#readme