@mtkruto/node 0.2.43 → 0.2.45

package/script/deps/jsr.io/@std/media-types/1.0.3/content_type.js

@@ -0,0 +1,61 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.contentType = void 0;
+const parse_media_type_js_1 = require("./parse_media_type.js");
+const get_charset_js_1 = require("./get_charset.js");
+const format_media_type_js_1 = require("./format_media_type.js");
+const type_by_extension_js_1 = require("./type_by_extension.js");
+/**
+ * Returns the full `Content-Type` or `Content-Disposition` header value for the
+ * given extension or media type.
+ *
+ * The function will treat the `extensionOrType` as a media type when it
+ * contains a `/`, otherwise it will process it as an extension, with or without
+ * the leading `.`.
+ *
+ * Returns `undefined` if unable to resolve the media type.
+ *
+ * @typeParam T Type of the extension or media type to resolve.
+ *
+ * @param extensionOrType The extension or media type to resolve.
+ *
+ * @returns The full `Content-Type` or `Content-Disposition` header value, or
+ * `undefined` if unable to resolve the media type.
+ *
+ * @example Usage
+ * ```ts
+ * import { contentType } from "@std/media-types/content-type";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(contentType(".json"), "application/json; charset=UTF-8");
+ * assertEquals(contentType("text/html"), "text/html; charset=UTF-8");
+ * assertEquals(contentType("text/html; charset=UTF-8"), "text/html; charset=UTF-8");
+ * assertEquals(contentType("txt"), "text/plain; charset=UTF-8");
+ * assertEquals(contentType("foo"), undefined);
+ * assertEquals(contentType("file.json"), undefined);
+ * ```
+ */
+function contentType(extensionOrType) {
+    try {
+        const [mediaType, params = {}] = extensionOrType.includes("/")
+            ? (0, parse_media_type_js_1.parseMediaType)(extensionOrType)
+            : [(0, type_by_extension_js_1.typeByExtension)(extensionOrType), undefined];
+        if (!mediaType) {
+            return undefined;
+        }
+        if (!("charset" in params)) {
+            const charset = (0, get_charset_js_1.getCharset)(mediaType);
+            if (charset) {
+                params.charset = charset;
+            }
+        }
+        return (0, format_media_type_js_1.formatMediaType)(mediaType, params);
+    }
+    catch {
+        // just swallow returning undefined
+    }
+    return undefined;
+}
+exports.contentType = contentType;

package/script/deps/jsr.io/@std/media-types/1.0.3/extension.d.ts

@@ -0,0 +1,24 @@
+/**
+ * Returns the most relevant extension for the given media type, or `undefined`
+ * if no extension can be found.
+ *
+ * Extensions are returned without a leading `.`.
+ *
+ * @param type The media type to get the extension for.
+ *
+ * @returns The extension for the given media type, or `undefined` if no
+ * extension is found.
+ *
+ * @example Usage
+ * ```ts
+ * import { extension } from "@std/media-types/extension";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(extension("text/plain"), "txt");
+ * assertEquals(extension("application/json"), "json");
+ * assertEquals(extension("text/html; charset=UTF-8"), "html");
+ * assertEquals(extension("application/foo"), undefined);
+ * ```
+ */
+export declare function extension(type: string): string | undefined;
+//# sourceMappingURL=extension.d.ts.map

package/script/deps/jsr.io/@std/media-types/1.0.3/extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"extension.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/media-types/1.0.3/extension.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;GAqBG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAE1D"}

package/script/deps/jsr.io/@std/media-types/1.0.3/extension.js

@@ -0,0 +1,32 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.extension = void 0;
+const all_extensions_js_1 = require("./all_extensions.js");
+/**
+ * Returns the most relevant extension for the given media type, or `undefined`
+ * if no extension can be found.
+ *
+ * Extensions are returned without a leading `.`.
+ *
+ * @param type The media type to get the extension for.
+ *
+ * @returns The extension for the given media type, or `undefined` if no
+ * extension is found.
+ *
+ * @example Usage
+ * ```ts
+ * import { extension } from "@std/media-types/extension";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(extension("text/plain"), "txt");
+ * assertEquals(extension("application/json"), "json");
+ * assertEquals(extension("text/html; charset=UTF-8"), "html");
+ * assertEquals(extension("application/foo"), undefined);
+ * ```
+ */
+function extension(type) {
+    return (0, all_extensions_js_1.allExtensions)(type)?.[0];
+}
+exports.extension = extension;

package/script/deps/jsr.io/@std/media-types/1.0.3/format_media_type.d.ts

@@ -0,0 +1,33 @@
+/**
+ * Serializes the media type and the optional parameters as a media type
+ * conforming to {@link https://www.rfc-editor.org/rfc/rfc2045.html | RFC 2045} and
+ * {@link https://www.rfc-editor.org/rfc/rfc2616.html | RFC 2616}.
+ *
+ * The type and parameter names are written in lower-case.
+ *
+ * When any of the arguments results in a standard violation then the return
+ * value will be an empty string (`""`).
+ *
+ * @param type The media type to serialize.
+ * @param param Optional parameters to serialize.
+ *
+ * @returns The serialized media type.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { formatMediaType } from "@std/media-types/format-media-type";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(formatMediaType("text/plain"), "text/plain");
+ * ```
+ *
+ * @example With parameters
+ * ```ts
+ * import { formatMediaType } from "@std/media-types/format-media-type";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(formatMediaType("text/plain", { charset: "UTF-8" }), "text/plain; charset=UTF-8");
+ * ```
+ */
+export declare function formatMediaType(type: string, param?: Record<string, string> | Iterable<[string, string]>): string;
+//# sourceMappingURL=format_media_type.d.ts.map

package/script/deps/jsr.io/@std/media-types/1.0.3/format_media_type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"format_media_type.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/media-types/1.0.3/format_media_type.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA8BG;AACH,wBAAgB,eAAe,CAC7B,IAAI,EAAE,MAAM,EACZ,KAAK,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,QAAQ,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,GAC1D,MAAM,CA8CR"}

package/script/deps/jsr.io/@std/media-types/1.0.3/format_media_type.js

@@ -0,0 +1,81 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.formatMediaType = void 0;
+const _util_js_1 = require("./_util.js");
+/**
+ * Serializes the media type and the optional parameters as a media type
+ * conforming to {@link https://www.rfc-editor.org/rfc/rfc2045.html | RFC 2045} and
+ * {@link https://www.rfc-editor.org/rfc/rfc2616.html | RFC 2616}.
+ *
+ * The type and parameter names are written in lower-case.
+ *
+ * When any of the arguments results in a standard violation then the return
+ * value will be an empty string (`""`).
+ *
+ * @param type The media type to serialize.
+ * @param param Optional parameters to serialize.
+ *
+ * @returns The serialized media type.
+ *
+ * @example Basic usage
+ * ```ts
+ * import { formatMediaType } from "@std/media-types/format-media-type";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(formatMediaType("text/plain"), "text/plain");
+ * ```
+ *
+ * @example With parameters
+ * ```ts
+ * import { formatMediaType } from "@std/media-types/format-media-type";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(formatMediaType("text/plain", { charset: "UTF-8" }), "text/plain; charset=UTF-8");
+ * ```
+ */
+function formatMediaType(type, param) {
+    let serializedMediaType = "";
+    const [major = "", sub] = type.split("/");
+    if (!sub) {
+        if (!(0, _util_js_1.isToken)(type)) {
+            return "";
+        }
+        serializedMediaType += type.toLowerCase();
+    }
+    else {
+        if (!(0, _util_js_1.isToken)(major) || !(0, _util_js_1.isToken)(sub)) {
+            return "";
+        }
+        serializedMediaType += `${major.toLowerCase()}/${sub.toLowerCase()}`;
+    }
+    if (param) {
+        param = (0, _util_js_1.isIterator)(param) ? Object.fromEntries(param) : param;
+        const attrs = Object.keys(param);
+        attrs.sort();
+        for (const attribute of attrs) {
+            if (!(0, _util_js_1.isToken)(attribute)) {
+                return "";
+            }
+            const value = param[attribute];
+            serializedMediaType += `; ${attribute.toLowerCase()}`;
+            const needEnc = (0, _util_js_1.needsEncoding)(value);
+            if (needEnc) {
+                serializedMediaType += "*";
+            }
+            serializedMediaType += "=";
+            if (needEnc) {
+                serializedMediaType += `utf-8''${encodeURIComponent(value)}`;
+                continue;
+            }
+            if ((0, _util_js_1.isToken)(value)) {
+                serializedMediaType += value;
+                continue;
+            }
+            serializedMediaType += `"${value.replace(/["\\]/gi, (m) => `\\${m}`)}"`;
+        }
+    }
+    return serializedMediaType;
+}
+exports.formatMediaType = formatMediaType;

package/script/deps/jsr.io/@std/media-types/1.0.3/get_charset.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Given a media type or header value, identify the encoding charset. If the
+ * charset cannot be determined, the function returns `undefined`.
+ *
+ * @param type The media type or header value to get the charset for.
+ *
+ * @returns The charset for the given media type or header value, or `undefined`
+ * if the charset cannot be determined.
+ *
+ * @example Usage
+ * ```ts
+ * import { getCharset } from "@std/media-types/get-charset";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(getCharset("text/plain"), "UTF-8");
+ * assertEquals(getCharset("application/foo"), undefined);
+ * assertEquals(getCharset("application/news-checkgroups"), "US-ASCII");
+ * assertEquals(getCharset("application/news-checkgroups; charset=UTF-8"), "UTF-8");
+ * ```
+ */
+export declare function getCharset(type: string): string | undefined;
+//# sourceMappingURL=get_charset.d.ts.map

package/script/deps/jsr.io/@std/media-types/1.0.3/get_charset.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get_charset.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/media-types/1.0.3/get_charset.ts"],"names":[],"mappings":"AAOA;;;;;;;;;;;;;;;;;;;GAmBG;AACH,wBAAgB,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAiB3D"}

package/script/deps/jsr.io/@std/media-types/1.0.3/get_charset.js

@@ -0,0 +1,47 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.getCharset = void 0;
+const parse_media_type_js_1 = require("./parse_media_type.js");
+const _db_js_1 = require("./_db.js");
+/**
+ * Given a media type or header value, identify the encoding charset. If the
+ * charset cannot be determined, the function returns `undefined`.
+ *
+ * @param type The media type or header value to get the charset for.
+ *
+ * @returns The charset for the given media type or header value, or `undefined`
+ * if the charset cannot be determined.
+ *
+ * @example Usage
+ * ```ts
+ * import { getCharset } from "@std/media-types/get-charset";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(getCharset("text/plain"), "UTF-8");
+ * assertEquals(getCharset("application/foo"), undefined);
+ * assertEquals(getCharset("application/news-checkgroups"), "US-ASCII");
+ * assertEquals(getCharset("application/news-checkgroups; charset=UTF-8"), "UTF-8");
+ * ```
+ */
+function getCharset(type) {
+    try {
+        const [mediaType, params] = (0, parse_media_type_js_1.parseMediaType)(type);
+        if (params?.charset) {
+            return params.charset;
+        }
+        const entry = _db_js_1.db[mediaType];
+        if (entry?.charset) {
+            return entry.charset;
+        }
+        if (mediaType.startsWith("text/")) {
+            return "UTF-8";
+        }
+    }
+    catch {
+        // just swallow errors, returning undefined
+    }
+    return undefined;
+}
+exports.getCharset = getCharset;

package/script/deps/jsr.io/@std/media-types/1.0.3/parse_media_type.d.ts

@@ -0,0 +1,31 @@
+/**
+ * Parses the media type and any optional parameters, per
+ * {@link https://www.rfc-editor.org/rfc/rfc1521.html | RFC 1521}.
+ *
+ * Media types are the values in `Content-Type` and `Content-Disposition`
+ * headers. On success the function returns a tuple where the first element is
+ * the media type and the second element is the optional parameters or
+ * `undefined` if there are none.
+ *
+ * The function will throw if the parsed value is invalid.
+ *
+ * The returned media type will be normalized to be lower case, and returned
+ * params keys will be normalized to lower case, but preserves the casing of
+ * the value.
+ *
+ * @param type The media type to parse.
+ *
+ * @returns A tuple where the first element is the media type and the second
+ * element is the optional parameters or `undefined` if there are none.
+ *
+ * @example Usage
+ * ```ts
+ * import { parseMediaType } from "@std/media-types/parse-media-type";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(parseMediaType("application/JSON"), ["application/json", undefined]);
+ * assertEquals(parseMediaType("text/html; charset=UTF-8"), ["text/html", { charset: "UTF-8" }]);
+ * ```
+ */
+export declare function parseMediaType(type: string): [mediaType: string, params: Record<string, string> | undefined];
+//# sourceMappingURL=parse_media_type.d.ts.map

package/script/deps/jsr.io/@std/media-types/1.0.3/parse_media_type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"parse_media_type.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/media-types/1.0.3/parse_media_type.ts"],"names":[],"mappings":"AAMA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AACH,wBAAgB,cAAc,CAC5B,IAAI,EAAE,MAAM,GACX,CAAC,SAAS,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,SAAS,CAAC,CAuFjE"}

package/script/deps/jsr.io/@std/media-types/1.0.3/parse_media_type.js

@@ -0,0 +1,118 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.parseMediaType = void 0;
+const _util_js_1 = require("./_util.js");
+const SEMICOLON_REGEXP = /^\s*;\s*$/;
+/**
+ * Parses the media type and any optional parameters, per
+ * {@link https://www.rfc-editor.org/rfc/rfc1521.html | RFC 1521}.
+ *
+ * Media types are the values in `Content-Type` and `Content-Disposition`
+ * headers. On success the function returns a tuple where the first element is
+ * the media type and the second element is the optional parameters or
+ * `undefined` if there are none.
+ *
+ * The function will throw if the parsed value is invalid.
+ *
+ * The returned media type will be normalized to be lower case, and returned
+ * params keys will be normalized to lower case, but preserves the casing of
+ * the value.
+ *
+ * @param type The media type to parse.
+ *
+ * @returns A tuple where the first element is the media type and the second
+ * element is the optional parameters or `undefined` if there are none.
+ *
+ * @example Usage
+ * ```ts
+ * import { parseMediaType } from "@std/media-types/parse-media-type";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(parseMediaType("application/JSON"), ["application/json", undefined]);
+ * assertEquals(parseMediaType("text/html; charset=UTF-8"), ["text/html", { charset: "UTF-8" }]);
+ * ```
+ */
+function parseMediaType(type) {
+    const [base] = type.split(";");
+    const mediaType = base.toLowerCase().trim();
+    const params = {};
+    // Map of base parameter name -> parameter name -> value
+    // for parameters containing a '*' character.
+    const continuation = new Map();
+    type = type.slice(base.length);
+    while (type.length) {
+        type = type.trimStart();
+        if (type.length === 0) {
+            break;
+        }
+        const [key, value, rest] = (0, _util_js_1.consumeMediaParam)(type);
+        if (!key) {
+            if (SEMICOLON_REGEXP.test(rest)) {
+                // ignore trailing semicolons
+                break;
+            }
+            throw new TypeError(`Cannot parse media type: invalid parameter "${type}"`);
+        }
+        let pmap = params;
+        const [baseName, rest2] = key.split("*");
+        if (baseName && rest2 !== undefined) {
+            if (!continuation.has(baseName)) {
+                continuation.set(baseName, {});
+            }
+            pmap = continuation.get(baseName);
+        }
+        if (key in pmap) {
+            throw new TypeError("Cannot parse media type: duplicate key");
+        }
+        pmap[key] = value;
+        type = rest;
+    }
+    // Stitch together any continuations or things with stars
+    // (i.e. RFC 2231 things with stars: "foo*0" or "foo*")
+    let str = "";
+    for (const [key, pieceMap] of continuation) {
+        const singlePartKey = `${key}*`;
+        const type = pieceMap[singlePartKey];
+        if (type) {
+            const decv = (0, _util_js_1.decode2331Encoding)(type);
+            if (decv) {
+                params[key] = decv;
+            }
+            continue;
+        }
+        str = "";
+        let valid = false;
+        for (let n = 0;; n++) {
+            const simplePart = `${key}*${n}`;
+            let type = pieceMap[simplePart];
+            if (type) {
+                valid = true;
+                str += type;
+                continue;
+            }
+            const encodedPart = `${simplePart}*`;
+            type = pieceMap[encodedPart];
+            if (!type) {
+                break;
+            }
+            valid = true;
+            if (n === 0) {
+                const decv = (0, _util_js_1.decode2331Encoding)(type);
+                if (decv) {
+                    str += decv;
+                }
+            }
+            else {
+                const decv = decodeURI(type);
+                str += decv;
+            }
+        }
+        if (valid) {
+            params[key] = str;
+        }
+    }
+    return [mediaType, Object.keys(params).length ? params : undefined];
+}
+exports.parseMediaType = parseMediaType;

package/script/deps/jsr.io/@std/media-types/1.0.3/type_by_extension.d.ts

@@ -0,0 +1,25 @@
+/**
+ * Returns the media type associated with the file extension, or `undefined` if
+ * no media type is found.
+ *
+ * Values are normalized to lower case and matched irrespective of a leading
+ * `.`.
+ *
+ * @param extension The file extension to get the media type for.
+ *
+ * @returns The media type associated with the file extension, or `undefined` if
+ * no media type is found.
+ *
+ * @example Usage
+ * ```ts
+ * import { typeByExtension } from "@std/media-types/type-by-extension";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(typeByExtension("js"), "text/javascript");
+ * assertEquals(typeByExtension(".HTML"), "text/html");
+ * assertEquals(typeByExtension("foo"), undefined);
+ * assertEquals(typeByExtension("file.json"), undefined);
+ * ```
+ */
+export declare function typeByExtension(extension: string): string | undefined;
+//# sourceMappingURL=type_by_extension.d.ts.map

package/script/deps/jsr.io/@std/media-types/1.0.3/type_by_extension.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"type_by_extension.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/media-types/1.0.3/type_by_extension.ts"],"names":[],"mappings":"AAKA;;;;;;;;;;;;;;;;;;;;;;GAsBG;AACH,wBAAgB,eAAe,CAAC,SAAS,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAIrE"}

package/script/deps/jsr.io/@std/media-types/1.0.3/type_by_extension.js

@@ -0,0 +1,35 @@
+"use strict";
+// Copyright 2018-2024 the Deno authors. All rights reserved. MIT license.
+// This module is browser compatible.
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.typeByExtension = void 0;
+const _db_js_1 = require("./_db.js");
+/**
+ * Returns the media type associated with the file extension, or `undefined` if
+ * no media type is found.
+ *
+ * Values are normalized to lower case and matched irrespective of a leading
+ * `.`.
+ *
+ * @param extension The file extension to get the media type for.
+ *
+ * @returns The media type associated with the file extension, or `undefined` if
+ * no media type is found.
+ *
+ * @example Usage
+ * ```ts
+ * import { typeByExtension } from "@std/media-types/type-by-extension";
+ * import { assertEquals } from "@std/assert";
+ *
+ * assertEquals(typeByExtension("js"), "text/javascript");
+ * assertEquals(typeByExtension(".HTML"), "text/html");
+ * assertEquals(typeByExtension("foo"), undefined);
+ * assertEquals(typeByExtension("file.json"), undefined);
+ * ```
+ */
+function typeByExtension(extension) {
+    extension = extension.startsWith(".") ? extension.slice(1) : extension;
+    // @ts-ignore Work around https://github.com/denoland/dnt/issues/148
+    return _db_js_1.types.get(extension.toLowerCase());
+}
+exports.typeByExtension = typeByExtension;