@httpland/compression-middleware 1.0.0-beta.1

package/script/deps/deno.land/x/vary@1.0.0/mod.js

@@ -0,0 +1,113 @@
+"use strict";
+/*!
+ * Based on https://github.com/jshttp/vary/blob/master/index.js
+ * Copyright(c) 2014-2017 Douglas Christopher Wilson
+ * Copyright(c) 2020 Henry Zhuang
+ * MIT Licensed
+ */
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vary = exports.append = void 0;
+/**
+ * RegExp to match field-name in RFC 7230 sec 3.2
+ *
+ * field-name    = token
+ * token         = 1*tchar
+ * tchar         = "!" / "#" / "$" / "%" / "&" / "'" / "*"
+ *               / "+" / "-" / "." / "^" / "_" / "`" / "|" / "~"
+ *               / DIGIT / ALPHA
+ *               ; any VCHAR, except delimiters
+ */
+const FIELD_NAME_REGEXP = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
+/**
+ * Append a field to a vary header.
+ *
+ * @param {String} header
+ * @param {String|Array} field
+ * @return {String}
+ * @public
+ */
+function append(header, field) {
+    // if (typeof header !== 'string') {
+    //   throw new TypeError('header argument is required')
+    // }
+    // if (!field) {
+    //   throw new TypeError('field argument is required')
+    // }
+    // existing, unspecified vary
+    if (header === "*") {
+        return header;
+    }
+    // get fields array
+    const fields = !Array.isArray(field) ? parse(String(field)) : field;
+    // assert on invalid field names
+    for (let j = 0; j < fields.length; j++) {
+        if (!FIELD_NAME_REGEXP.test(fields[j])) {
+            throw new TypeError(`field argument contains an invalid header name \`${fields[j]}\``);
+        }
+    }
+    // enumerate current values
+    let val = header;
+    const vals = parse(header.toLowerCase());
+    // unspecified vary
+    if (fields.indexOf("*") !== -1 || vals.indexOf("*") !== -1) {
+        return "*";
+    }
+    for (let i = 0; i < fields.length; i++) {
+        const fld = fields[i].toLowerCase();
+        // append value (case-preserving)
+        if (vals.indexOf(fld) === -1) {
+            vals.push(fld);
+            val = val ? val + ", " + fields[i] : fields[i];
+        }
+    }
+    return val;
+}
+exports.append = append;
+/**
+ * Parse a vary header into an array.
+ *
+ * @param {String} header
+ * @return {Array}
+ * @private
+ */
+function parse(header) {
+    let end = 0;
+    const list = [];
+    let start = 0;
+    // gather tokens
+    for (let i = 0, len = header.length; i < len; i++) {
+        switch (header.charCodeAt(i)) {
+            case 0x20: /*   */
+                if (start === end) {
+                    start = end = i + 1;
+                }
+                break;
+            case 0x2c: /* , */
+                list.push(header.substring(start, end));
+                start = end = i + 1;
+                break;
+            default:
+                end = i + 1;
+                break;
+        }
+    }
+    // final token
+    list.push(header.substring(start, end));
+    return list;
+}
+/**
+ * Mark that a request is varied on a header field.
+ *
+ * @param {Headers} header
+ * @param {String|Array} field
+ * @public
+ */
+function vary(header, field) {
+    // get existing header
+    let val = header.get("vary") || "";
+    // set new header
+    if ((val = append(val, field))) {
+        header.set("vary", val);
+    }
+}
+exports.vary = vary;

package/script/deps.js

@@ -0,0 +1,22 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.vary = exports.compressible = exports.isNull = exports.parseMediaType = exports.acceptsEncodings = exports.RepresentationHeader = exports.ContentNegotiationHeader = exports.CachingHeader = void 0;
+var http_utils_1 = require("@httpland/http-utils");
+Object.defineProperty(exports, "CachingHeader", { enumerable: true, get: function () { return http_utils_1.CachingHeader; } });
+Object.defineProperty(exports, "ContentNegotiationHeader", { enumerable: true, get: function () { return http_utils_1.ContentNegotiationHeader; } });
+Object.defineProperty(exports, "RepresentationHeader", { enumerable: true, get: function () { return http_utils_1.RepresentationHeader; } });
+var negotiation_js_1 = require("./deps/deno.land/std@0.180.0/http/negotiation.js");
+Object.defineProperty(exports, "acceptsEncodings", { enumerable: true, get: function () { return negotiation_js_1.acceptsEncodings; } });
+var mod_js_1 = require("./deps/deno.land/std@0.180.0/media_types/mod.js");
+Object.defineProperty(exports, "parseMediaType", { enumerable: true, get: function () { return mod_js_1.parseMediaType; } });
+var isxx_1 = require("isxx");
+Object.defineProperty(exports, "isNull", { enumerable: true, get: function () { return isxx_1.isNull; } });
+var compressible_1 = require("compressible");
+Object.defineProperty(exports, "compressible", { enumerable: true, get: function () { return __importDefault(compressible_1).default; } });
+var mod_js_2 = require("./deps/deno.land/x/vary@1.0.0/mod.js");
+Object.defineProperty(exports, "vary", { enumerable: true, get: function () { return mod_js_2.vary; } });

package/script/encoders/deflate.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Deflate = void 0;
+const utils_js_1 = require("./utils.js");
+function encodeDeflate(stream) {
+    return stream.pipeThrough(new CompressionStream(utils_js_1.Format.Deflate));
+}
+/** Encoder for `deflate` */
+exports.Deflate = {
+    encoding: utils_js_1.Format.Deflate,
+    encode: encodeDeflate,
+};

package/script/encoders/gzip.js

@@ -0,0 +1,14 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Gzip = void 0;
+const utils_js_1 = require("./utils.js");
+function encodeGzip(stream) {
+    return stream.pipeThrough(new CompressionStream(utils_js_1.Format.Gzip));
+}
+/** Encoder for `gzip` */
+exports.Gzip = {
+    encoding: utils_js_1.Format.Gzip,
+    encode: encodeGzip,
+};

package/script/encoders/utils.js

@@ -0,0 +1,10 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Format = void 0;
+var Format;
+(function (Format) {
+    Format["Gzip"] = "gzip";
+    Format["Deflate"] = "deflate";
+})(Format = exports.Format || (exports.Format = {}));

package/script/middleware.js

@@ -0,0 +1,61 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.fromEncoders = exports.flat = exports.compression = void 0;
+const deps_js_1 = require("./deps.js");
+const transform_js_1 = require("./transform.js");
+const gzip_js_1 = require("./encoders/gzip.js");
+const deflate_js_1 = require("./encoders/deflate.js");
+const DefaultEncoders = [gzip_js_1.Gzip, deflate_js_1.Deflate];
+/** Create HTTP content compression middleware.
+ *
+ * @example
+ * ```ts
+ * import { compression } from "https://deno.land/x/compression_middleware@$VERSION/mod.ts";
+ * import { assertEquals } from "https://deno.land/std/testing/asserts.ts";
+ *
+ * const middleware = compression();
+ * const request = new Request("test:", {
+ *   headers: {
+ *     "accept-encoding": "deflate;q=0.5, gzip;q=1.0, deflate-raw;q=0.3",
+ *   },
+ * });
+ *
+ * const response = await middleware(
+ *   request,
+ *   () => new Response("<body>"),
+ * );
+ *
+ * assertEquals(await response.text(), "<gzip:body>");
+ * assertEquals(response.headers.get("content-encoding"), "gzip");
+ * ```
+ */
+function compression(encoders) {
+    const encodingMap = {
+        ...fromEncoders(DefaultEncoders),
+        ...Array.isArray(encoders) ? fromEncoders(encoders) : encoders,
+    };
+    const encodings = Object.keys(encodingMap);
+    return async (request, next) => {
+        const encoding = (0, deps_js_1.acceptsEncodings)(request, ...encodings, IDENTITY);
+        const response = await next(request);
+        (0, deps_js_1.vary)(response.headers, deps_js_1.ContentNegotiationHeader.AcceptEncoding);
+        if (!encoding || encoding === IDENTITY)
+            return response;
+        const encode = encodingMap[encoding];
+        if (!encode)
+            return response;
+        return (0, transform_js_1.withContentEncoding)(response, { encode, encoding });
+    };
+}
+exports.compression = compression;
+function flat(encoder) {
+    return [encoder.encoding, encoder.encode];
+}
+exports.flat = flat;
+function fromEncoders(encoders) {
+    return Object.fromEntries(encoders.map(flat));
+}
+exports.fromEncoders = fromEncoders;
+const IDENTITY = "identity";

package/script/mod.js

@@ -0,0 +1,7 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.compression = void 0;
+var middleware_js_1 = require("./middleware.js");
+Object.defineProperty(exports, "compression", { enumerable: true, get: function () { return middleware_js_1.compression; } });

package/script/package.json

@@ -0,0 +1,3 @@
+{
+  "type": "commonjs"
+}

package/script/transform.js

@@ -0,0 +1,27 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.withContentEncoding = void 0;
+const deps_js_1 = require("./deps.js");
+const utils_js_1 = require("./utils.js");
+/** Response with `Content-Encoding` header. */
+async function withContentEncoding(response, context) {
+    const contentType = response.headers.get(deps_js_1.RepresentationHeader.ContentType);
+    const cacheControl = response.headers.get(deps_js_1.CachingHeader.CacheControl);
+    if ((0, deps_js_1.isNull)(contentType) ||
+        response.headers.has(deps_js_1.RepresentationHeader.ContentEncoding) ||
+        !response.body ||
+        response.bodyUsed ||
+        (!(0, deps_js_1.isNull)(cacheControl) && (0, utils_js_1.isNoTransform)(cacheControl)))
+        return response;
+    const [mediaType] = (0, deps_js_1.parseMediaType)(contentType);
+    const isCompressible = (0, deps_js_1.compressible)(mediaType);
+    if (!isCompressible)
+        return response;
+    const bodyInit = await context.encode(response.body);
+    const newResponse = await (0, utils_js_1.reCalcContentLength)(new Response(bodyInit, response));
+    newResponse.headers.set(deps_js_1.RepresentationHeader.ContentEncoding, context.encoding);
+    return newResponse;
+}
+exports.withContentEncoding = withContentEncoding;

package/script/types.js

@@ -0,0 +1,4 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });

package/script/utils.js

@@ -0,0 +1,24 @@
+"use strict";
+// Copyright 2023-latest the httpland authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.reCalcContentLength = exports.isNoTransform = void 0;
+const deps_js_1 = require("./deps.js");
+const ReNoTransform = /(?:^|,)\s*?no-transform\s*?(?:,|$)/;
+function isNoTransform(input) {
+    return ReNoTransform.test(input);
+}
+exports.isNoTransform = isNoTransform;
+async function reCalcContentLength(response) {
+    if (response.bodyUsed ||
+        !response.headers.has(deps_js_1.RepresentationHeader.ContentLength))
+        return response;
+    const length = await response
+        .clone()
+        .arrayBuffer()
+        .then((buffer) => buffer.byteLength)
+        .then(String);
+    response.headers.set(deps_js_1.RepresentationHeader.ContentLength, length);
+    return response;
+}
+exports.reCalcContentLength = reCalcContentLength;

package/types/deps/deno.land/std@0.180.0/http/_negotiation/common.d.ts

@@ -0,0 +1,37 @@
+/*!
+ * Adapted directly from negotiator at https://github.com/jshttp/negotiator/
+ * which is licensed as follows:
+ *
+ * (The MIT License)
+ *
+ * Copyright (c) 2012-2014 Federico Romero
+ * Copyright (c) 2012-2014 Isaac Z. Schlueter
+ * Copyright (c) 2014-2015 Douglas Christopher Wilson
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * 'Software'), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+export interface Specificity {
+    i: number;
+    o?: number;
+    q: number;
+    s?: number;
+}
+export declare function compareSpecs(a: Specificity, b: Specificity): number;
+export declare function isQuality(spec: Specificity): boolean;

package/types/deps/deno.land/std@0.180.0/http/_negotiation/encoding.d.ts

@@ -0,0 +1,33 @@
+/*!
+ * Adapted directly from negotiator at https://github.com/jshttp/negotiator/
+ * which is licensed as follows:
+ *
+ * (The MIT License)
+ *
+ * Copyright (c) 2012-2014 Federico Romero
+ * Copyright (c) 2012-2014 Isaac Z. Schlueter
+ * Copyright (c) 2014-2015 Douglas Christopher Wilson
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * 'Software'), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+/** Given an `Accept-Encoding` string, parse out the encoding returning a
+ * negotiated encoding based on the `provided` encodings otherwise just a
+ * prioritized array of encodings. */
+export declare function preferredEncodings(accept: string, provided?: string[]): string[];

package/types/deps/deno.land/std@0.180.0/http/_negotiation/language.d.ts

@@ -0,0 +1,30 @@
+/*!
+ * Adapted directly from negotiator at https://github.com/jshttp/negotiator/
+ * which is licensed as follows:
+ *
+ * (The MIT License)
+ *
+ * Copyright (c) 2012-2014 Federico Romero
+ * Copyright (c) 2012-2014 Isaac Z. Schlueter
+ * Copyright (c) 2014-2015 Douglas Christopher Wilson
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * 'Software'), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+export declare function preferredLanguages(accept?: string, provided?: string[]): string[];

package/types/deps/deno.land/std@0.180.0/http/_negotiation/media_type.d.ts

@@ -0,0 +1,30 @@
+/*!
+ * Adapted directly from negotiator at https://github.com/jshttp/negotiator/
+ * which is licensed as follows:
+ *
+ * (The MIT License)
+ *
+ * Copyright (c) 2012-2014 Federico Romero
+ * Copyright (c) 2012-2014 Isaac Z. Schlueter
+ * Copyright (c) 2014-2015 Douglas Christopher Wilson
+ *
+ * Permission is hereby granted, free of charge, to any person obtaining
+ * a copy of this software and associated documentation files (the
+ * 'Software'), to deal in the Software without restriction, including
+ * without limitation the rights to use, copy, modify, merge, publish,
+ * distribute, sublicense, and/or sell copies of the Software, and to
+ * permit persons to whom the Software is furnished to do so, subject to
+ * the following conditions:
+ *
+ * The above copyright notice and this permission notice shall be
+ * included in all copies or substantial portions of the Software.
+ *
+ * THE SOFTWARE IS PROVIDED 'AS IS', WITHOUT WARRANTY OF ANY KIND,
+ * EXPRESS OR IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF
+ * MERCHANTABILITY, FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT.
+ * IN NO EVENT SHALL THE AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY
+ * CLAIM, DAMAGES OR OTHER LIABILITY, WHETHER IN AN ACTION OF CONTRACT,
+ * TORT OR OTHERWISE, ARISING FROM, OUT OF OR IN CONNECTION WITH THE
+ * SOFTWARE OR THE USE OR OTHER DEALINGS IN THE SOFTWARE.
+ */
+export declare function preferredMediaTypes(accept?: string | null, provided?: string[]): string[];

package/types/deps/deno.land/std@0.180.0/http/negotiation.d.ts

@@ -0,0 +1,126 @@
+export type Request = {
+    headers: {
+        get(key: string): string | null;
+    };
+};
+/**
+ * Returns an array of media types accepted by the request, in order of
+ * preference. If there are no media types supplied in the request, then any
+ * media type selector will be returned.
+ *
+ * @example
+ * ```ts
+ * import { accepts } from "https://deno.land/std@$STD_VERSION/http/negotiation.ts";
+ *
+ * const req = new Request("https://example.com/", {
+ *   headers: {
+ *     "accept":
+ *       "text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, *\/*;q=0.8",
+ *   },
+ * });
+ *
+ * console.log(accepts(req));
+ * // [
+ * //   "text/html",
+ * //   "application/xhtml+xml",
+ * //   "image/webp",
+ * //   "application/xml",
+ * //   "*\/*",
+ * // ]
+ * ```
+ */
+export declare function accepts(request: Request): string[];
+/**
+ * For a given set of media types, return the best match accepted in the
+ * request. If no media type matches, then the function returns `undefined`.
+ *
+ *  @example
+ * ```ts
+ * import { accepts } from "https://deno.land/std@$STD_VERSION/http/negotiation.ts";
+ *
+ * const req = new Request("https://example.com/", {
+ *   headers: {
+ *     "accept":
+ *       "text/html, application/xhtml+xml, application/xml;q=0.9, image/webp, *\/*;q=0.8",
+ *   },
+ * });
+ *
+ * accepts(req, "text/html", "image/webp"); // "text/html";
+ * ```
+ */
+export declare function accepts(request: Request, ...types: string[]): string | undefined;
+/**
+ * Returns an array of content encodings accepted by the request, in order of
+ * preference. If there are no encoding supplied in the request, then `["*"]`
+ * is returned, implying any encoding is accepted.
+ *
+ * @example
+ * ```ts
+ * import { acceptsEncodings } from "https://deno.land/std@$STD_VERSION/http/negotiation.ts";
+ *
+ * const req = new Request("https://example.com/", {
+ *   headers: { "accept-encoding": "deflate, gzip;q=1.0, *;q=0.5" },
+ * });
+ *
+ * acceptsEncodings(req); // ["deflate", "gzip", "*"]
+ * ```
+ */
+export declare function acceptsEncodings(request: Request): string[];
+/**
+ * For a given set of content encodings, return the best match accepted in the
+ * request. If no content encodings match, then the function returns
+ * `undefined`.
+ *
+ * **NOTE:** You should always supply `identity` as one of the encodings
+ * to ensure that there is a match when the `Accept-Encoding` header is part
+ * of the request.
+ *
+ * @example
+ * ```ts
+ * import { acceptsEncodings } from "https://deno.land/std@$STD_VERSION/http/negotiation.ts";
+ *
+ * const req = new Request("https://example.com/", {
+ *   headers: { "accept-encoding": "deflate, gzip;q=1.0, *;q=0.5" },
+ * });
+ *
+ * acceptsEncodings(req, "gzip", "identity"); // "gzip"
+ * ```
+ */
+export declare function acceptsEncodings(request: Request, ...encodings: string[]): string | undefined;
+/**
+ * Returns an array of languages accepted by the request, in order of
+ * preference. If there are no languages supplied in the request, then `["*"]`
+ * is returned, imply any language is accepted.
+ *
+ * @example
+ * ```ts
+ * import { acceptsLanguages } from "https://deno.land/std@$STD_VERSION/http/negotiation.ts";
+ *
+ * const req = new Request("https://example.com/", {
+ *   headers: {
+ *     "accept-language": "fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5",
+ *   },
+ * });
+ *
+ * acceptsLanguages(req); // ["fr-CH", "fr", "en", "de", "*"]
+ * ```
+ */
+export declare function acceptsLanguages(request: Request): string[];
+/**
+ * For a given set of languages, return the best match accepted in the request.
+ * If no languages match, then the function returns `undefined`.
+ *
+ * @example
+ * ```ts
+ * import { acceptsLanguages } from "https://deno.land/std@$STD_VERSION/http/negotiation.ts";
+ *
+ * const req = new Request("https://example.com/", {
+ *   headers: {
+ *     "accept-language": "fr-CH, fr;q=0.9, en;q=0.8, de;q=0.7, *;q=0.5",
+ *   },
+ * });
+ *
+ * acceptsLanguages(req, "en-gb", "en-us", "en"); // "en"
+ * ```
+ */
+export declare function acceptsLanguages(request: Request, ...langs: string[]): string | undefined;