koa-files 2.3.7 → 3.0.0

package/esm/Send.js

@@ -1,367 +0,0 @@
-/**
- * @package koa-files
- * @license MIT
- * @version 2.3.7
- * @author nuintun <nuintun@qq.com>
- * @description A static files serving middleware for koa.
- * @see https://github.com/nuintun/koa-files#readme
- */
-
-import etag from 'etag';
-import destroy from 'destroy';
-import fs from 'fs';
-import { PassThrough } from 'stream';
-import parseRange from 'range-parser';
-import { resolve, extname, join } from 'path';
-import { unixify, isETagFresh, isETag, boundaryGenerator, decodeURI, isOutRoot, fstat, hasTrailingSlash } from './utils.js';
-
-/**
- * @module Send
- * @license MIT
- * @author nuintun
- */
-/**
- * @class Send
- */
-class Send {
-    /**
-     * @constructor
-     * @param {string} root
-     * @param {Options} options
-     */
-    constructor(root, options = {}) {
-        this.options = options;
-        this.root = unixify(resolve(root));
-    }
-    /**
-     * @method isConditionalGET
-     * @param {Context} context
-     * @returns {boolean}
-     */
-    isConditionalGET(context) {
-        const { request } = context;
-        return !!(request.get('If-Match') ||
-            request.get('If-None-Match') ||
-            request.get('If-Modified-Since') ||
-            request.get('if-Unmodified-Since'));
-    }
-    /**
-     * @method isPreconditionFailure
-     * @param {Context} context
-     * @returns {boolean}
-     */
-    isPreconditionFailure(context) {
-        const { request, response } = context;
-        // If-Match
-        const match = request.get('If-Match');
-        if (match) {
-            const etag = response.get('ETag');
-            return !etag || (match !== '*' && !isETagFresh(match, etag));
-        }
-        // If-Unmodified-Since
-        const unmodifiedSince = Date.parse(request.get('If-Unmodified-Since'));
-        if (!isNaN(unmodifiedSince)) {
-            const lastModified = Date.parse(response.get('Last-Modified'));
-            return isNaN(lastModified) || lastModified > unmodifiedSince;
-        }
-        return false;
-    }
-    /**
-     * @method isRangeFresh
-     * @param {Context} context
-     * @returns {boolean}
-     */
-    isRangeFresh(context) {
-        const { request, response } = context;
-        const ifRange = request.get('If-Range');
-        // No If-Range
-        if (!ifRange) {
-            return true;
-        }
-        // If-Range as etag
-        if (isETag(ifRange)) {
-            const etag = response.get('ETag');
-            return !!(etag && isETagFresh(ifRange, etag));
-        }
-        // If-Range as modified date
-        const lastModified = response.get('Last-Modified');
-        return Date.parse(lastModified) <= Date.parse(ifRange);
-    }
-    /**
-     * @method isIgnore
-     * @param {string} path
-     * @returns {boolean}
-     */
-    isIgnore(path) {
-        const { ignore } = this.options;
-        return (typeof ignore === 'function' ? ignore(path) : false) === true;
-    }
-    /**
-     * @method parseRange
-     * @param {Context} context
-     * @param {Stats} stats
-     * @returns {Ranges}
-     */
-    parseRange(context, stats) {
-        const { size } = stats;
-        const { request } = context;
-        // Content-Length
-        let contentLength = size;
-        // Ranges
-        const ranges = [];
-        // Range support
-        if (this.options.acceptRanges !== false) {
-            const range = request.get('Range');
-            // Range fresh
-            if (range && this.isRangeFresh(context)) {
-                // Parse range -1 -2 or []
-                const parsed = parseRange(size, range, { combine: true });
-                // -1 signals an unsatisfiable range
-                // -2 signals a malformed header string
-                if (parsed === -1 || parsed === -2) {
-                    return parsed;
-                }
-                // Ranges ok, support multiple ranges
-                if (parsed.type === 'bytes') {
-                    // Set 206 status
-                    context.status = 206;
-                    // Multiple ranges
-                    if (parsed.length > 1) {
-                        // Reset content-length
-                        contentLength = 0;
-                        // Range boundary
-                        const boundary = `<${boundaryGenerator()}>`;
-                        const suffix = `\r\n--${boundary}--\r\n`;
-                        const contentType = `Content-Type: ${context.type}`;
-                        context.type = `multipart/byteranges; boundary=${boundary}`;
-                        // Map ranges
-                        parsed.forEach(({ start, end }, index) => {
-                            // The first prefix boundary no \r\n
-                            const prefixHead = index > 0 ? '\r\n' : '';
-                            const contentRange = `Content-Range: bytes ${start}-${end}/${size}`;
-                            const prefix = `${prefixHead}--${boundary}\r\n${contentType}\r\n${contentRange}\r\n\r\n`;
-                            // Compute content-length
-                            contentLength += end - start + 1 + Buffer.byteLength(prefix);
-                            // Cache range
-                            ranges.push({ start, end, prefix });
-                        });
-                        // The last add suffix boundary
-                        ranges[ranges.length - 1].suffix = suffix;
-                        // Compute content-length
-                        contentLength += Buffer.byteLength(suffix);
-                    }
-                    else {
-                        const { start, end } = parsed[0];
-                        context.set('Content-Range', `bytes ${start}-${end}/${size}`);
-                        // Compute content-length
-                        contentLength = end - start + 1;
-                        // Cache range
-                        ranges.push({ start, end });
-                    }
-                }
-            }
-        }
-        // Set Content-Length
-        context.length = contentLength;
-        return ranges.length ? ranges : [{ start: 0 }];
-    }
-    /**
-     * @method setupHeaders
-     * @param {Context} context
-     * @param {string} path
-     * @param {Stats} stats
-     */
-    setupHeaders(context, path, stats) {
-        const { options } = this;
-        const { toString } = Object.prototype;
-        const { acceptRanges, cacheControl, lastModified } = options;
-        // Set status
-        context.status = 200;
-        // Set Content-Type
-        context.type = extname(path);
-        // ETag
-        if (options.etag !== false) {
-            // Set ETag
-            context.set('ETag', etag(stats));
-        }
-        // Accept-Ranges
-        if (acceptRanges !== false) {
-            // Set Accept-Ranges
-            context.set('Accept-Ranges', 'bytes');
-        }
-        // Last-Modified
-        if (lastModified !== false) {
-            // Set mtime utc string
-            context.set('Last-Modified', stats.mtime.toUTCString());
-        }
-        // Cache-Control
-        if (cacheControl && toString.call(cacheControl) === '[object String]') {
-            // Set Cache-Control
-            context.set('Cache-Control', cacheControl);
-        }
-    }
-    /**
-     * @method read
-     * @param {string} path
-     * @param {Range} range
-     * @param {PassThrough} buffer
-     * @param {boolean} end
-     * @returns {Promise<true>}
-     */
-    read(path, range, buffer, end) {
-        return new Promise((resolve, reject) => {
-            // Create file stream
-            const file = fs.createReadStream(path, range);
-            // File read stream open
-            if (range.prefix) {
-                file.once('open', () => {
-                    // Write prefix boundary
-                    buffer.write(range.prefix);
-                });
-            }
-            // File read stream error
-            file.once('error', error => {
-                // Unpipe
-                file.unpipe(buffer);
-                // Destroy file stream
-                destroy(file);
-                // Reject
-                reject(error);
-            });
-            // File read stream end
-            if (range.suffix) {
-                file.once('end', () => {
-                    // Push suffix boundary
-                    buffer.write(range.suffix);
-                });
-            }
-            // File read stream close
-            file.once('close', () => {
-                // Unpipe
-                file.unpipe(buffer);
-                // Destroy file stream
-                destroy(file);
-                // Resolve
-                resolve(true);
-            });
-            // Write data to buffer
-            file.pipe(buffer, { end });
-        });
-    }
-    /**
-     * @method send
-     * @param {Context} context
-     * @param {string} path
-     * @param {Range[]} ranges
-     */
-    async send(context, path, ranges) {
-        // Ranges count
-        let count = ranges.length;
-        // Set stream body, highWaterMark 64kb
-        const stream = new PassThrough({ highWaterMark: 65536 });
-        // Set response body
-        context.body = stream;
-        // Read file ranges
-        try {
-            for (const range of ranges) {
-                await this.read(path, range, stream, --count === 0);
-            }
-        }
-        catch (error) {
-            // End stream when read exception
-            stream.end();
-        }
-    }
-    /**
-     * @method response
-     * @param {Context} context
-     * @returns {Promise<boolean>}
-     */
-    async response(context) {
-        const { root } = this;
-        // Only support GET and HEAD (405)
-        if (context.method !== 'GET' && context.method !== 'HEAD') {
-            return false;
-        }
-        // Get path of file
-        const pathname = decodeURI(context.path);
-        const path = pathname === -1 ? pathname : unixify(join(root, pathname));
-        // Path -1 or null byte(s)
-        if (path === -1 || path.includes('\0')) {
-            return context.throw(400);
-        }
-        // Malicious path (403)
-        if (isOutRoot(path, root)) {
-            return false;
-        }
-        // Is ignore path or file (403)
-        if (this.isIgnore(path)) {
-            return false;
-        }
-        // File stats
-        let stats;
-        // Get file stats
-        try {
-            stats = await fstat(path);
-        }
-        catch (error) {
-            // 404 | 500
-            return false;
-        }
-        // File not exist (404 | 500)
-        if (!stats) {
-            return false;
-        }
-        // Is directory (403)
-        if (stats.isDirectory()) {
-            return false;
-        }
-        // Not a directory but has trailing slash (404)
-        if (hasTrailingSlash(path)) {
-            return false;
-        }
-        // Setup headers
-        this.setupHeaders(context, path, stats);
-        // Conditional get support
-        if (this.isConditionalGET(context)) {
-            // Request precondition failure
-            if (this.isPreconditionFailure(context)) {
-                return context.throw(412);
-            }
-            // Request fresh (304)
-            if (context.fresh) {
-                // Set status
-                context.status = 304;
-                // Set body null
-                context.body = null;
-                return true;
-            }
-        }
-        // Head request
-        if (context.method === 'HEAD') {
-            // Set content-length
-            context.length = stats.size;
-            // Set body null
-            context.body = null;
-            return true;
-        }
-        // Parsed ranges
-        const ranges = this.parseRange(context, stats);
-        // 416
-        if (ranges === -1) {
-            // Set content-range
-            context.set('Content-Range', `bytes */${stats.size}`);
-            // Unsatisfiable 416
-            return context.throw(416);
-        }
-        // 400
-        if (ranges === -2) {
-            return context.throw(400);
-        }
-        // Send file
-        this.send(context, path, ranges);
-        return true;
-    }
-}
-
-export { Send as default };

package/esm/utils.js

@@ -1,139 +0,0 @@
-/**
- * @package koa-files
- * @license MIT
- * @version 2.3.7
- * @author nuintun <nuintun@qq.com>
- * @description A static files serving middleware for koa.
- * @see https://github.com/nuintun/koa-files#readme
- */
-
-import fs from 'fs';
-import { relative, isAbsolute } from 'path';
-
-/**
- * @module utils
- * @license MIT
- * @author nuintun
- */
-const CHARS = Array.from('0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz');
-/**
- * @function isOutRoot
- * @description Test path is out of bound of root
- * @param {string} path
- * @param {string} root
- * @returns {boolean}
- */
-function isOutRoot(path, root) {
-    path = relative(root, path);
-    return /\.\.(?:[\\/]|$)/.test(path) || isAbsolute(path);
-}
-/**
- * @function unixify
- * @description Convert path separators to posix/unix-style forward slashes
- * @param {string} path
- * @returns {string}
- */
-function unixify(path) {
-    return path.replace(/\\/g, '/');
-}
-/**
- * @function decodeURI
- * @description Decode URI component.
- * @param {string} URI
- * @returns {string|-1}
- */
-function decodeURI(URI) {
-    try {
-        return decodeURIComponent(URI);
-    }
-    catch (error) {
-        return -1;
-    }
-}
-/**
- * @function boundaryGenerator
- * @description Create boundary
- * @returns {string}
- */
-function boundaryGenerator() {
-    let boundary = '';
-    // Create boundary
-    for (let i = 0; i < 38; i++) {
-        boundary += CHARS[Math.floor(Math.random() * 62)];
-    }
-    // Return boundary
-    return boundary;
-}
-/**
- * @function fstat
- * @param {string} path
- * @returns {Promise<Stats>}
- */
-function fstat(path) {
-    return new Promise((resolve, reject) => {
-        fs.stat(path, (error, stats) => {
-            error ? reject(error) : resolve(stats);
-        });
-    });
-}
-/**
- * @function hasTrailingSlash
- * @param {string} path
- * @returns {boolean}
- */
-function hasTrailingSlash(path) {
-    return /\/$/.test(path);
-}
-/**
- * @function parseTokens
- * @description Parse a HTTP tokens.
- * @param {string[]} value
- */
-function parseTokens(value) {
-    let end = 0;
-    let start = 0;
-    let tokens = [];
-    // gather tokens
-    for (let i = 0, length = value.length; i < length; i++) {
-        switch (value.charCodeAt(i)) {
-            case 0x20:
-                // ' '
-                if (start === end) {
-                    start = end = i + 1;
-                }
-                break;
-            case 0x2c:
-                // ','
-                tokens.push(value.substring(start, end));
-                start = end = i + 1;
-                break;
-            default:
-                end = i + 1;
-                break;
-        }
-    }
-    // final token
-    tokens.push(value.substring(start, end));
-    return tokens;
-}
-/**
- * @function isETagFresh
- * @param {string} match
- * @param {string} etag
- * @returns {boolean}
- */
-function isETagFresh(match, etag) {
-    return parseTokens(match).some(match => {
-        return match === etag || match === 'W/' + etag || 'W/' + match === etag;
-    });
-}
-/**
- * @function isETag
- * @param {string} etag
- * @returns {boolean}
- */
-function isETag(etag) {
-    return /(?:W\/)?"(?:[ !#-\x7E\x80-\xFF]*|\r\n[\t ]|\\.)*"/.test(etag);
-}
-
-export { boundaryGenerator, decodeURI, fstat, hasTrailingSlash, isETag, isETagFresh, isOutRoot, parseTokens, unixify };

package/types/Send.d.ts

@@ -1,86 +0,0 @@
-/**
- * @module Send
- * @license MIT
- * @author nuintun
- */
-import { Context } from 'koa';
-export interface Options {
-    etag?: boolean;
-    cacheControl?: string;
-    acceptRanges?: boolean;
-    lastModified?: boolean;
-    ignore?: (path: string) => boolean;
-}
-/**
- * @class Send
- */
-export default class Send {
-    private root;
-    private options;
-    /**
-     * @constructor
-     * @param {string} root
-     * @param {Options} options
-     */
-    constructor(root: string, options?: Options);
-    /**
-     * @method isConditionalGET
-     * @param {Context} context
-     * @returns {boolean}
-     */
-    private isConditionalGET;
-    /**
-     * @method isPreconditionFailure
-     * @param {Context} context
-     * @returns {boolean}
-     */
-    private isPreconditionFailure;
-    /**
-     * @method isRangeFresh
-     * @param {Context} context
-     * @returns {boolean}
-     */
-    private isRangeFresh;
-    /**
-     * @method isIgnore
-     * @param {string} path
-     * @returns {boolean}
-     */
-    private isIgnore;
-    /**
-     * @method parseRange
-     * @param {Context} context
-     * @param {Stats} stats
-     * @returns {Ranges}
-     */
-    private parseRange;
-    /**
-     * @method setupHeaders
-     * @param {Context} context
-     * @param {string} path
-     * @param {Stats} stats
-     */
-    private setupHeaders;
-    /**
-     * @method read
-     * @param {string} path
-     * @param {Range} range
-     * @param {PassThrough} buffer
-     * @param {boolean} end
-     * @returns {Promise<true>}
-     */
-    private read;
-    /**
-     * @method send
-     * @param {Context} context
-     * @param {string} path
-     * @param {Range[]} ranges
-     */
-    private send;
-    /**
-     * @method response
-     * @param {Context} context
-     * @returns {Promise<boolean>}
-     */
-    response(context: Context): Promise<boolean>;
-}

package/types/utils.d.ts

@@ -1,66 +0,0 @@
-/**
- * @module utils
- * @license MIT
- * @author nuintun
- */
-/// <reference types="node" />
-import { Stats } from 'fs';
-/**
- * @function isOutRoot
- * @description Test path is out of bound of root
- * @param {string} path
- * @param {string} root
- * @returns {boolean}
- */
-export declare function isOutRoot(path: string, root: string): boolean;
-/**
- * @function unixify
- * @description Convert path separators to posix/unix-style forward slashes
- * @param {string} path
- * @returns {string}
- */
-export declare function unixify(path: string): string;
-/**
- * @function decodeURI
- * @description Decode URI component.
- * @param {string} URI
- * @returns {string|-1}
- */
-export declare function decodeURI(URI: string): string | -1;
-/**
- * @function boundaryGenerator
- * @description Create boundary
- * @returns {string}
- */
-export declare function boundaryGenerator(): string;
-/**
- * @function fstat
- * @param {string} path
- * @returns {Promise<Stats>}
- */
-export declare function fstat(path: string): Promise<Stats>;
-/**
- * @function hasTrailingSlash
- * @param {string} path
- * @returns {boolean}
- */
-export declare function hasTrailingSlash(path: string): boolean;
-/**
- * @function parseTokens
- * @description Parse a HTTP tokens.
- * @param {string[]} value
- */
-export declare function parseTokens(value: string): string[];
-/**
- * @function isETagFresh
- * @param {string} match
- * @param {string} etag
- * @returns {boolean}
- */
-export declare function isETagFresh(match: string, etag: string): boolean;
-/**
- * @function isETag
- * @param {string} etag
- * @returns {boolean}
- */
-export declare function isETag(etag: string): boolean;