@versori/run 0.0.1-alpha.1 → 0.0.1-alpha.3

package/esm/deps/jsr.io/@std/http/1.0.13/_negotiation/language.js

@@ -0,0 +1,113 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+/*!
+ * 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.
+ */
+import { compareSpecs, isQuality } from "./common.js";
+const SIMPLE_LANGUAGE_REGEXP = /^\s*([^\s\-;]+)(?:-([^\s;]+))?\s*(?:;(.*))?$/;
+function parseLanguage(str, i) {
+    const match = SIMPLE_LANGUAGE_REGEXP.exec(str);
+    if (!match) {
+        return undefined;
+    }
+    const [, prefix, suffix] = match;
+    if (!prefix) {
+        return undefined;
+    }
+    const full = suffix !== undefined ? `${prefix}-${suffix}` : prefix;
+    let q = 1;
+    if (match[3]) {
+        const params = match[3].split(";");
+        for (const param of params) {
+            const [key, value] = param.trim().split("=");
+            if (key === "q" && value) {
+                q = parseFloat(value);
+                break;
+            }
+        }
+    }
+    return { prefix, suffix, full, i, o: undefined, q, s: undefined };
+}
+function parseAcceptLanguage(accept) {
+    const accepts = accept.split(",");
+    const result = [];
+    for (const [i, accept] of accepts.entries()) {
+        const language = parseLanguage(accept.trim(), i);
+        if (language) {
+            result.push(language);
+        }
+    }
+    return result;
+}
+function specify(language, spec, i) {
+    const p = parseLanguage(language, i);
+    if (!p) {
+        return undefined;
+    }
+    let s = 0;
+    if (spec.full.toLowerCase() === p.full.toLowerCase()) {
+        s |= 4;
+    }
+    else if (spec.prefix.toLowerCase() === p.prefix.toLowerCase()) {
+        s |= 2;
+    }
+    else if (spec.full.toLowerCase() === p.prefix.toLowerCase()) {
+        s |= 1;
+    }
+    else if (spec.full !== "*") {
+        return;
+    }
+    return { i, o: spec.i, q: spec.q, s };
+}
+function getLanguagePriority(language, accepted, index) {
+    let priority = { i: -1, o: -1, q: 0, s: 0 };
+    for (const accepts of accepted) {
+        const spec = specify(language, accepts, index);
+        if (spec &&
+            ((priority.s ?? 0) - (spec.s ?? 0) || priority.q - spec.q ||
+                (priority.o ?? 0) - (spec.o ?? 0)) < 0) {
+            priority = spec;
+        }
+    }
+    return priority;
+}
+export function preferredLanguages(accept = "*", provided) {
+    const accepts = parseAcceptLanguage(accept);
+    if (!provided) {
+        return accepts
+            .filter(isQuality)
+            .sort(compareSpecs)
+            .map((spec) => spec.full);
+    }
+    const priorities = provided
+        .map((type, index) => getLanguagePriority(type, accepts, index));
+    return priorities
+        .filter(isQuality)
+        .sort(compareSpecs)
+        .map((priority) => provided[priorities.indexOf(priority)]);
+}

package/esm/deps/jsr.io/@std/http/1.0.13/_negotiation/media_type.d.ts

@@ -0,0 +1,31 @@
+/*!
+ * 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[];
+//# sourceMappingURL=media_type.d.ts.map

package/esm/deps/jsr.io/@std/http/1.0.13/_negotiation/media_type.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"media_type.d.ts","sourceRoot":"","sources":["../../../../../../../src/deps/jsr.io/@std/http/1.0.13/_negotiation/media_type.ts"],"names":[],"mappings":"AACA;;;;;;;;;;;;;;;;;;;;;;;;;;;;GA4BG;AAiJH,wBAAgB,mBAAmB,CACjC,MAAM,CAAC,EAAE,MAAM,GAAG,IAAI,EACtB,QAAQ,CAAC,EAAE,MAAM,EAAE,GAClB,MAAM,EAAE,CAkBV"}

package/esm/deps/jsr.io/@std/http/1.0.13/_negotiation/media_type.js

@@ -0,0 +1,140 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+/*!
+ * 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.
+ */
+import { compareSpecs, isQuality } from "./common.js";
+const simpleMediaTypeRegExp = /^\s*([^\s\/;]+)\/([^;\s]+)\s*(?:;(.*))?$/;
+function splitKeyValuePair(str) {
+    const [key, value] = str.split("=");
+    return [key.toLowerCase(), value];
+}
+function parseMediaType(str, i) {
+    const match = simpleMediaTypeRegExp.exec(str);
+    if (!match) {
+        return;
+    }
+    const [, type, subtype, parameters] = match;
+    if (!type || !subtype) {
+        return;
+    }
+    const params = Object.create(null);
+    let q = 1;
+    if (parameters) {
+        const kvps = parameters.split(";").map((p) => p.trim()).map(splitKeyValuePair);
+        for (const [key, val] of kvps) {
+            const value = val && val[0] === `"` && val[val.length - 1] === `"`
+                ? val.slice(1, val.length - 1)
+                : val;
+            if (key === "q" && value) {
+                q = parseFloat(value);
+                break;
+            }
+            params[key] = value;
+        }
+    }
+    return { type, subtype, params, i, o: undefined, q, s: undefined };
+}
+function parseAccept(accept) {
+    const accepts = accept.split(",").map((p) => p.trim());
+    const mediaTypes = [];
+    for (const [index, accept] of accepts.entries()) {
+        const mediaType = parseMediaType(accept.trim(), index);
+        if (mediaType) {
+            mediaTypes.push(mediaType);
+        }
+    }
+    return mediaTypes;
+}
+function getFullType(spec) {
+    return `${spec.type}/${spec.subtype}`;
+}
+function specify(type, spec, index) {
+    const p = parseMediaType(type, index);
+    if (!p) {
+        return;
+    }
+    let s = 0;
+    if (spec.type.toLowerCase() === p.type.toLowerCase()) {
+        s |= 4;
+    }
+    else if (spec.type !== "*") {
+        return;
+    }
+    if (spec.subtype.toLowerCase() === p.subtype.toLowerCase()) {
+        s |= 2;
+    }
+    else if (spec.subtype !== "*") {
+        return;
+    }
+    const keys = Object.keys(spec.params);
+    if (keys.length) {
+        if (keys.every((key) => (spec.params[key] ?? "").toLowerCase() ===
+            (p.params[key] ?? "").toLowerCase())) {
+            s |= 1;
+        }
+        else {
+            return;
+        }
+    }
+    return {
+        i: index,
+        o: spec.o,
+        q: spec.q,
+        s,
+    };
+}
+function getMediaTypePriority(type, accepted, index) {
+    let priority = { o: -1, q: 0, s: 0, i: index };
+    for (const accepts of accepted) {
+        const spec = specify(type, accepts, index);
+        if (spec &&
+            ((priority.s ?? 0) - (spec.s ?? 0) ||
+                (priority.q ?? 0) - (spec.q ?? 0) ||
+                (priority.o ?? 0) - (spec.o ?? 0)) < 0) {
+            priority = spec;
+        }
+    }
+    return priority;
+}
+export function preferredMediaTypes(accept, provided) {
+    const accepts = parseAccept(accept === undefined ? "*/*" : accept ?? "");
+    if (!provided) {
+        return accepts
+            .filter(isQuality)
+            .sort(compareSpecs)
+            .map(getFullType);
+    }
+    const priorities = provided.map((type, index) => {
+        return getMediaTypePriority(type, accepts, index);
+    });
+    return priorities
+        .filter(isQuality)
+        .sort(compareSpecs)
+        .map((priority) => provided[priorities.indexOf(priority)]);
+}

package/esm/deps/jsr.io/@std/http/1.0.13/etag.d.ts

@@ -0,0 +1,148 @@
+/**
+ * Just the part of {@linkcode Deno.FileInfo} that is required to calculate an `ETag`,
+ * so partial or user generated file information can be passed.
+ */
+export interface FileInfo {
+    /** The last modification time of the file. This corresponds to the `mtime`
+     * field from `stat` on Linux/Mac OS and `ftLastWriteTime` on Windows. This
+     * may not be available on all platforms. */
+    mtime: Date | null;
+    /** The size of the file, in bytes. */
+    size: number;
+}
+/** Options for {@linkcode eTag}. */
+export interface ETagOptions {
+    /**
+     * A digest algorithm to use to calculate the etag.
+     *
+     * @default {"SHA-256"}
+     */
+    algorithm?: AlgorithmIdentifier;
+    /**
+     * Override the default behavior of calculating the `ETag`, either forcing
+     * a tag to be labelled weak or not.
+     *
+     * Defaults to `true` when the entity is a `FileInfo` and `false` otherwise.
+     */
+    weak?: boolean;
+}
+/**
+ * Calculate an ETag for string or `Uint8Array` entities. This returns a
+ * {@linkcode https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag#etag_value | strong tag}
+ * of the form `"<ascii chars>"`, which guarantees the byte-for-byte equality of the resource.
+ *
+ * You can optionally set true to the `weak` option to get a weak tag.
+ *
+ * @example Usage
+ * ```ts
+ * import { eTag } from "@std/http/etag";
+ * import { assert } from "@std/assert";
+ *
+ * const body = "hello deno!";
+ *
+ * const etag = await eTag(body);
+ * assert(etag);
+ *
+ * const res = new Response(body, { headers: { etag } });
+ * ```
+ *
+ * @param entity The entity to get the ETag for.
+ * @param options Various additional options.
+ * @returns The calculated ETag.
+ */
+export declare function eTag(entity: string | Uint8Array, options?: ETagOptions): Promise<string>;
+/**
+ * Calculate an ETag for file information entity. This returns a
+ * {@linkcode https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag#w | weak tag}
+ * of the form `W\"<ascii chars>"`, which guarantees the equivalence of the resource,
+ * not the byte-for-byte equality.
+ *
+ * @example Usage
+ * ```ts
+ * import { eTag } from "@std/http/etag";
+ * import { assert } from "@std/assert";
+ *
+ * const fileInfo = await Deno.stat("README.md");
+ *
+ * const etag = await eTag(fileInfo);
+ * assert(etag);
+ *
+ * using file = await Deno.open("README.md");
+ *
+ * const res = new Response(file.readable, { headers: { etag } });
+ * ```
+ *
+ * @param entity The entity to get the ETag for.
+ * @param options Various additional options.
+ * @returns The calculated ETag.
+ */
+export declare function eTag(entity: FileInfo, options?: ETagOptions): Promise<string | undefined>;
+/** A helper function that takes the value from the `If-Match` header and a
+ * calculated etag for the target. By using strong comparison, return `true` if
+ * the values match, otherwise `false`.
+ *
+ * See MDN's [`If-Match`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match)
+ * article for more information on how to use this function.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import {
+ *   eTag,
+ *   ifMatch,
+ * } from "@std/http/etag";
+ * import { assert } from "@std/assert";
+ *
+ * const body = "hello deno!";
+ *
+ * Deno.serve(async (req) => {
+ *   const ifMatchValue = req.headers.get("if-match");
+ *   const etag = await eTag(body);
+ *   assert(etag);
+ *   if (!ifMatchValue || ifMatch(ifMatchValue, etag)) {
+ *     return new Response(body, { status: 200, headers: { etag } });
+ *   } else {
+ *     return new Response(null, { status: 412, statusText: "Precondition Failed"});
+ *   }
+ * });
+ * ```
+ *
+ * @param value the If-Match header value.
+ * @param etag the ETag to check against.
+ * @returns whether or not the parameters match.
+ */
+export declare function ifMatch(value: string | null, etag: string | undefined): boolean;
+/** A helper function that takes the value from the `If-None-Match` header and
+ * a calculated etag for the target entity and returns `false` if the etag for
+ * the entity matches the supplied value, otherwise `true`.
+ *
+ * See MDN's [`If-None-Match`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-None-Match)
+ * article for more information on how to use this function.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import {
+ *   eTag,
+ *   ifNoneMatch,
+ * } from "@std/http/etag";
+ * import { assert } from "@std/assert";
+ *
+ * const body = "hello deno!";
+ *
+ * Deno.serve(async (req) => {
+ *   const ifNoneMatchValue = req.headers.get("if-none-match");
+ *   const etag = await eTag(body);
+ *   assert(etag);
+ *   if (!ifNoneMatch(ifNoneMatchValue, etag)) {
+ *     return new Response(null, { status: 304, headers: { etag } });
+ *   } else {
+ *     return new Response(body, { status: 200, headers: { etag } });
+ *   }
+ * });
+ * ```
+ *
+ * @param value the If-None-Match header value.
+ * @param etag the ETag to check against.
+ * @returns whether or not the parameters do not match.
+ */
+export declare function ifNoneMatch(value: string | null, etag: string | undefined): boolean;
+//# sourceMappingURL=etag.d.ts.map

package/esm/deps/jsr.io/@std/http/1.0.13/etag.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"etag.d.ts","sourceRoot":"","sources":["../../../../../../src/deps/jsr.io/@std/http/1.0.13/etag.ts"],"names":[],"mappings":"AAkBA;;;GAGG;AACH,MAAM,WAAW,QAAQ;IACvB;;gDAE4C;IAC5C,KAAK,EAAE,IAAI,GAAG,IAAI,CAAC;IACnB,sCAAsC;IACtC,IAAI,EAAE,MAAM,CAAC;CACd;AAMD,oCAAoC;AACpC,MAAM,WAAW,WAAW;IAC1B;;;;OAIG;IACH,SAAS,CAAC,EAAE,mBAAmB,CAAC;IAEhC;;;;;OAKG;IACH,IAAI,CAAC,EAAE,OAAO,CAAC;CAChB;AA0CD;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,MAAM,GAAG,UAAU,EAC3B,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,CAAC,CAAC;AACnB;;;;;;;;;;;;;;;;;;;;;;;;GAwBG;AACH,wBAAsB,IAAI,CACxB,MAAM,EAAE,QAAQ,EAChB,OAAO,CAAC,EAAE,WAAW,GACpB,OAAO,CAAC,MAAM,GAAG,SAAS,CAAC,CAAC;AAiB/B;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,OAAO,CACrB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAUT;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;GAgCG;AACH,wBAAgB,WAAW,CACzB,KAAK,EAAE,MAAM,GAAG,IAAI,EACpB,IAAI,EAAE,MAAM,GAAG,SAAS,GACvB,OAAO,CAYT"}

package/esm/deps/jsr.io/@std/http/1.0.13/etag.js

@@ -0,0 +1,135 @@
+// Copyright 2018-2025 the Deno authors. MIT license.
+// This module is browser compatible.
+/**
+ * Provides functions for dealing with and matching ETags, including
+ * {@linkcode eTag} to calculate an etag for a given entity,
+ * {@linkcode ifMatch} for validating if an ETag matches against a `If-Match`
+ * header and {@linkcode ifNoneMatch} for validating an Etag against an
+ * `If-None-Match` header.
+ *
+ * See further information on the `ETag` header on
+ * {@link https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/ETag | MDN}.
+ *
+ * @module
+ */
+import { encodeBase64 as base64Encode } from "../../encoding/1.0.7/base64.js";
+const encoder = new TextEncoder();
+const DEFAULT_ALGORITHM = "SHA-256";
+function isFileInfo(value) {
+    return Boolean(value && typeof value === "object" && "mtime" in value && "size" in value);
+}
+async function calcEntity(entity, { algorithm = DEFAULT_ALGORITHM }) {
+    // a short circuit for zero length entities
+    if (entity.length === 0) {
+        return `0-47DEQpj8HBSa+/TImW+5JCeuQeR`;
+    }
+    if (typeof entity === "string") {
+        entity = encoder.encode(entity);
+    }
+    const hash = base64Encode(await crypto.subtle.digest(algorithm, entity))
+        .substring(0, 27);
+    return `${entity.length.toString(16)}-${hash}`;
+}
+async function calcFileInfo(fileInfo, { algorithm = DEFAULT_ALGORITHM }) {
+    if (fileInfo.mtime) {
+        const hash = base64Encode(await crypto.subtle.digest(algorithm, encoder.encode(fileInfo.mtime.toJSON()))).substring(0, 27);
+        return `${fileInfo.size.toString(16)}-${hash}`;
+    }
+}
+export async function eTag(entity, options = {}) {
+    const weak = options.weak ?? isFileInfo(entity);
+    const tag = await (isFileInfo(entity)
+        ? calcFileInfo(entity, options)
+        : calcEntity(entity, options));
+    return tag ? weak ? `W/"${tag}"` : `"${tag}"` : undefined;
+}
+const STAR_REGEXP = /^\s*\*\s*$/;
+const COMMA_REGEXP = /\s*,\s*/;
+/** A helper function that takes the value from the `If-Match` header and a
+ * calculated etag for the target. By using strong comparison, return `true` if
+ * the values match, otherwise `false`.
+ *
+ * See MDN's [`If-Match`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-Match)
+ * article for more information on how to use this function.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import {
+ *   eTag,
+ *   ifMatch,
+ * } from "@std/http/etag";
+ * import { assert } from "@std/assert";
+ *
+ * const body = "hello deno!";
+ *
+ * Deno.serve(async (req) => {
+ *   const ifMatchValue = req.headers.get("if-match");
+ *   const etag = await eTag(body);
+ *   assert(etag);
+ *   if (!ifMatchValue || ifMatch(ifMatchValue, etag)) {
+ *     return new Response(body, { status: 200, headers: { etag } });
+ *   } else {
+ *     return new Response(null, { status: 412, statusText: "Precondition Failed"});
+ *   }
+ * });
+ * ```
+ *
+ * @param value the If-Match header value.
+ * @param etag the ETag to check against.
+ * @returns whether or not the parameters match.
+ */
+export function ifMatch(value, etag) {
+    // Weak tags cannot be matched and return false.
+    if (!value || !etag || etag.startsWith("W/")) {
+        return false;
+    }
+    if (STAR_REGEXP.test(value)) {
+        return true;
+    }
+    const tags = value.split(COMMA_REGEXP);
+    return tags.includes(etag);
+}
+/** A helper function that takes the value from the `If-None-Match` header and
+ * a calculated etag for the target entity and returns `false` if the etag for
+ * the entity matches the supplied value, otherwise `true`.
+ *
+ * See MDN's [`If-None-Match`](https://developer.mozilla.org/en-US/docs/Web/HTTP/Headers/If-None-Match)
+ * article for more information on how to use this function.
+ *
+ * @example Usage
+ * ```ts ignore
+ * import {
+ *   eTag,
+ *   ifNoneMatch,
+ * } from "@std/http/etag";
+ * import { assert } from "@std/assert";
+ *
+ * const body = "hello deno!";
+ *
+ * Deno.serve(async (req) => {
+ *   const ifNoneMatchValue = req.headers.get("if-none-match");
+ *   const etag = await eTag(body);
+ *   assert(etag);
+ *   if (!ifNoneMatch(ifNoneMatchValue, etag)) {
+ *     return new Response(null, { status: 304, headers: { etag } });
+ *   } else {
+ *     return new Response(body, { status: 200, headers: { etag } });
+ *   }
+ * });
+ * ```
+ *
+ * @param value the If-None-Match header value.
+ * @param etag the ETag to check against.
+ * @returns whether or not the parameters do not match.
+ */
+export function ifNoneMatch(value, etag) {
+    if (!value || !etag) {
+        return true;
+    }
+    if (STAR_REGEXP.test(value)) {
+        return false;
+    }
+    etag = etag.startsWith("W/") ? etag.slice(2) : etag;
+    const tags = value.split(COMMA_REGEXP).map((tag) => tag.startsWith("W/") ? tag.slice(2) : tag);
+    return !tags.includes(etag);
+}