@udibo/oauth2 0.14.0 → 0.15.0

package/esm/deps/jsr.io/@std/encoding/1.0.11/varint.js

@@ -1,209 +0,0 @@
-// Copyright 2018-2026 the Deno authors. MIT license.
-// Copyright 2020 Keith Cirkel. All rights reserved. MIT license.
-// Copyright 2023 Skye "MierenManz". All rights reserved. MIT license.
-/**
- * Utilities for {@link https://protobuf.dev/programming-guides/encoding/#varints Varint} encoding
- * of typed integers. Varint encoding represents integers using a variable number of bytes, with
- * smaller values requiring fewer bytes.
- *
- * ```ts
- * import { encodeVarint, decodeVarint } from "@std/encoding/varint";
- * import { assertEquals } from "@std/assert";
- *
- * const buf = new Uint8Array(10);
- * assertEquals(
- *   encodeVarint(42n, buf),
- *   [new Uint8Array([42]), 1]
- * );
- *
- * assertEquals(
- *   decodeVarint(new Uint8Array([42])),
- *   [ 42n, 1 ]
- * );
- * ```
- *
- * @module
- */
-/**
- * The maximum value of an unsigned 64-bit integer.
- * Equivalent to `2n**64n - 1n`
- */
-export const MaxUint64 = 18446744073709551615n;
-/**
- * The maximum length, in bytes, of a Varint encoded 64-bit integer.
- */
-export const MaxVarintLen64 = 10;
-/**
- * The maximum length, in bytes, of a Varint encoded 32-bit integer.
- */
-export const MaxVarintLen32 = 5;
-const MSB = 0x80;
-const REST = 0x7f;
-const SHIFT = 7;
-const MSBN = 0x80n;
-const SHIFTN = 7n;
-// ArrayBuffer and TypedArray's for "pointer casting"
-const AB = new ArrayBuffer(8);
-const U32_VIEW = new Uint32Array(AB);
-const U64_VIEW = new BigUint64Array(AB);
-/**
- * Given a non empty `buf`, starting at `offset` (default: 0), begin decoding bytes as
- * Varint encoded bytes, for a maximum of 10 bytes (offset + 10). The returned
- * tuple is of the decoded varint 32-bit number, and the new offset with which
- * to continue decoding other data.
- *
- * If a `bigint` in return is undesired, the `decode32` function will return a
- * `number`, but this should only be used in cases where the varint is
- * _assured_ to be 32-bits. If in doubt, use `decode()`.
- *
- * To know how many bytes the Varint took to encode, simply negate `offset`
- * from the returned new `offset`.
- *
- * @param buf The buffer to decode from.
- * @param offset The offset to start decoding from.
- * @returns A tuple of the decoded varint 64-bit number, and the new offset.
- *
- * @example Usage
- * ```ts
- * import { decodeVarint } from "@std/encoding/varint";
- * import { assertEquals } from "@std/assert";
- *
- * const buf = new Uint8Array([0x8E, 0x02]);
- * assertEquals(decodeVarint(buf), [270n, 2]);
- * ```
- */
-export function decodeVarint(buf, offset = 0) {
-    // Clear the last result from the Two's complement view
-    U64_VIEW[0] = 0n;
-    // Setup the initiat state of the function
-    let intermediate = 0;
-    let position = 0;
-    let i = offset;
-    // If the buffer is empty Throw
-    if (buf.length === 0)
-        throw new RangeError("Cannot read empty buffer");
-    let byte;
-    do {
-        // Get a single byte from the buffer
-        byte = buf[i];
-        // 1. Take the lower 7 bits of the byte.
-        // 2. Shift the bits into the correct position.
-        // 3. Bitwise OR it with the intermediate value
-        // QUIRK: in the 5th (and 10th) iteration of this loop it will overflow on the shift.
-        // This causes only the lower 4 bits to be shifted into place and removing the upper 3 bits
-        intermediate |= (byte & 0b01111111) << position;
-        // If position is 28
-        // it means that this iteration needs to be written the the two's complement view
-        // This only happens once due to the `-4` in this branch
-        if (position === 28) {
-            // Write to the view
-            U32_VIEW[0] = intermediate;
-            // set `intermediate` to the remaining 3 bits
-            // We only want the remaining three bits because the other 4 have been "consumed" on line 21
-            intermediate = (byte & 0b01110000) >>> 4;
-            // set `position` to -4 because later 7 will be added, making it 3
-            position = -4;
-        }
-        // Increment the shift position by 7
-        position += 7;
-        // Increment the iterator by 1
-        i++;
-        // Keep going while there is a continuation bit
-    } while ((byte & 0b10000000) === 0b10000000);
-    // subtract the initial offset from `i` to get the bytes read
-    const nRead = i - offset;
-    // If 10 bytes have been read and intermediate has overflown
-    // it means that the varint is malformed
-    // If 11 bytes have been read it means that the varint is malformed
-    // If `i` is bigger than the buffer it means we overread the buffer and the varint is malformed
-    if ((nRead === 10 && intermediate > -1) || nRead === 11 || i > buf.length) {
-        throw new RangeError("Cannot decode the varint input: Malformed or overflow varint");
-    }
-    // Write the intermediate value to the "empty" slot
-    // if the first slot is taken. Take the second slot
-    U32_VIEW[Number(nRead > 4)] = intermediate;
-    return [U64_VIEW[0], i];
-}
-/**
- * Given a `buf`, starting at `offset` (default: 0), begin decoding bytes as
- * Varint encoded bytes, for a maximum of 5 bytes (offset + 5). The returned
- * tuple is of the decoded varint 32-bit number, and the new offset with which
- * to continue decoding other data.
- *
- * Varints are _not 32-bit by default_ so this should only be used in cases
- * where the varint is _assured_ to be 32-bits. If in doubt, use `decode()`.
- *
- * To know how many bytes the Varint took to encode, simply negate `offset`
- * from the returned new `offset`.
- *
- * @param buf The buffer to decode from.
- * @param offset The offset to start decoding from.
- * @returns A tuple of the decoded varint 32-bit number, and the new offset.
- *
- * @example Usage
- * ```ts
- * import { decodeVarint32 } from "@std/encoding/varint";
- * import { assertEquals } from "@std/assert";
- *
- * const buf = new Uint8Array([0x8E, 0x02]);
- * assertEquals(decodeVarint32(buf), [270, 2]);
- * ```
- */
-export function decodeVarint32(buf, offset = 0) {
-    let shift = 0;
-    let decoded = 0;
-    for (let i = offset; i <= Math.min(buf.length, offset + MaxVarintLen32); i += 1, shift += SHIFT) {
-        const byte = buf[i];
-        decoded += (byte & REST) * Math.pow(2, shift);
-        if (!(byte & MSB))
-            return [decoded, i + 1];
-    }
-    throw new RangeError("Cannot decode the varint input: Malformed or overflow varint");
-}
-/**
- * Takes unsigned number `num` and converts it into a Varint encoded
- * `Uint8Array`, returning a tuple consisting of a `Uint8Array` slice of the
- * encoded Varint, and an offset where the Varint encoded bytes end within the
- * `Uint8Array`.
- *
- * If `buf` is not given then a Uint8Array will be created.
- * `offset` defaults to `0`.
- *
- * If passed `buf` then that will be written into, starting at `offset`. The
- * resulting returned `Uint8Array` will be a slice of `buf`. The resulting
- * returned number is effectively `offset + bytesWritten`.
- *
- * @param num The number to encode.
- * @param buf The buffer to write into.
- * @param offset The offset to start writing at.
- * @returns A tuple of the encoded Varint `Uint8Array` and the new offset.
- *
- * @example Usage
- * ```ts
- * import { encodeVarint } from "@std/encoding/varint";
- * import { assertEquals } from "@std/assert";
- *
- * const buf = new Uint8Array(10);
- * assertEquals(encodeVarint(42n, buf), [new Uint8Array([42]), 1]);
- * ```
- */
-// deno-lint-ignore deno-style-guide/exported-function-args-maximum
-export function encodeVarint(num, buf = new Uint8Array(MaxVarintLen64), offset = 0) {
-    num = BigInt(num);
-    if (num < 0n) {
-        throw new RangeError(`Cannot encode the input into varint as it should be non-negative integer: received ${num}`);
-    }
-    if (num > MaxUint64) {
-        throw new RangeError(`Cannot encode the input ${num} into varint as it overflows uint64`);
-    }
-    for (let i = offset; i < buf.length; i += 1) {
-        if (num < MSBN) {
-            buf[i] = Number(num);
-            i += 1;
-            return [buf.slice(offset, i), i];
-        }
-        buf[i] = Number((num & 0xffn) | MSBN);
-        num >>= SHIFTN;
-    }
-    throw new RangeError("Cannot encode the input into varint: the provided buffer is too small");
-}

package/esm/deps/jsr.io/@std/http/1.1.3/status.d.ts

@@ -1,343 +0,0 @@
-/**
- * Contains the {@linkcode STATUS_CODE} object which contains standard HTTP
- * status codes and provides several type guards for handling status codes
- * with type safety.
- *
- * @example The status code and status text
- * ```ts
- * import {
- *   STATUS_CODE,
- *   STATUS_TEXT,
- * } from "@std/http/status";
- *
- * console.log(STATUS_CODE.NotFound); // Returns 404
- * console.log(STATUS_TEXT[STATUS_CODE.NotFound]); // Returns "Not Found"
- * ```
- *
- * @example Checking the status code type
- * ```ts ignore
- * import { isErrorStatus } from "@std/http/status";
- *
- * const res = await fetch("https://example.com/");
- *
- * if (isErrorStatus(res.status)) {
- *   // error handling here...
- * }
- *
- * await res.body?.cancel();
- * ```
- *
- * @module
- */
-export declare const STATUS_CODE: {
-    /** RFC 7231, 6.2.1 */
-    readonly Continue: 100;
-    /** RFC 7231, 6.2.2 */
-    readonly SwitchingProtocols: 101;
-    /** RFC 2518, 10.1 */
-    readonly Processing: 102;
-    /** RFC 8297 **/
-    readonly EarlyHints: 103;
-    /** RFC 7231, 6.3.1 */
-    readonly OK: 200;
-    /** RFC 7231, 6.3.2 */
-    readonly Created: 201;
-    /** RFC 7231, 6.3.3 */
-    readonly Accepted: 202;
-    /** RFC 7231, 6.3.4 */
-    readonly NonAuthoritativeInfo: 203;
-    /** RFC 7231, 6.3.5 */
-    readonly NoContent: 204;
-    /** RFC 7231, 6.3.6 */
-    readonly ResetContent: 205;
-    /** RFC 7233, 4.1 */
-    readonly PartialContent: 206;
-    /** RFC 4918, 11.1 */
-    readonly MultiStatus: 207;
-    /** RFC 5842, 7.1 */
-    readonly AlreadyReported: 208;
-    /** RFC 3229, 10.4.1 */
-    readonly IMUsed: 226;
-    /** RFC 7231, 6.4.1 */
-    readonly MultipleChoices: 300;
-    /** RFC 7231, 6.4.2 */
-    readonly MovedPermanently: 301;
-    /** RFC 7231, 6.4.3 */
-    readonly Found: 302;
-    /** RFC 7231, 6.4.4 */
-    readonly SeeOther: 303;
-    /** RFC 7232, 4.1 */
-    readonly NotModified: 304;
-    /** RFC 7231, 6.4.5 */
-    readonly UseProxy: 305;
-    /** RFC 7231, 6.4.7 */
-    readonly TemporaryRedirect: 307;
-    /** RFC 7538, 3 */
-    readonly PermanentRedirect: 308;
-    /** RFC 7231, 6.5.1 */
-    readonly BadRequest: 400;
-    /** RFC 7235, 3.1 */
-    readonly Unauthorized: 401;
-    /** RFC 7231, 6.5.2 */
-    readonly PaymentRequired: 402;
-    /** RFC 7231, 6.5.3 */
-    readonly Forbidden: 403;
-    /** RFC 7231, 6.5.4 */
-    readonly NotFound: 404;
-    /** RFC 7231, 6.5.5 */
-    readonly MethodNotAllowed: 405;
-    /** RFC 7231, 6.5.6 */
-    readonly NotAcceptable: 406;
-    /** RFC 7235, 3.2 */
-    readonly ProxyAuthRequired: 407;
-    /** RFC 7231, 6.5.7 */
-    readonly RequestTimeout: 408;
-    /** RFC 7231, 6.5.8 */
-    readonly Conflict: 409;
-    /** RFC 7231, 6.5.9 */
-    readonly Gone: 410;
-    /** RFC 7231, 6.5.10 */
-    readonly LengthRequired: 411;
-    /** RFC 7232, 4.2 */
-    readonly PreconditionFailed: 412;
-    /** RFC 7231, 6.5.11 */
-    readonly ContentTooLarge: 413;
-    /** RFC 7231, 6.5.12 */
-    readonly URITooLong: 414;
-    /** RFC 7231, 6.5.13 */
-    readonly UnsupportedMediaType: 415;
-    /** RFC 7233, 4.4 */
-    readonly RangeNotSatisfiable: 416;
-    /** RFC 7231, 6.5.14 */
-    readonly ExpectationFailed: 417;
-    /** RFC 7168, 2.3.3 */
-    readonly Teapot: 418;
-    /** RFC 7540, 9.1.2 */
-    readonly MisdirectedRequest: 421;
-    /** RFC 4918, 11.2 */
-    readonly UnprocessableEntity: 422;
-    /** RFC 4918, 11.3 */
-    readonly Locked: 423;
-    /** RFC 4918, 11.4 */
-    readonly FailedDependency: 424;
-    /** RFC 8470, 5.2 */
-    readonly TooEarly: 425;
-    /** RFC 7231, 6.5.15 */
-    readonly UpgradeRequired: 426;
-    /** RFC 6585, 3 */
-    readonly PreconditionRequired: 428;
-    /** RFC 6585, 4 */
-    readonly TooManyRequests: 429;
-    /** RFC 6585, 5 */
-    readonly RequestHeaderFieldsTooLarge: 431;
-    /** RFC 7725, 3 */
-    readonly UnavailableForLegalReasons: 451;
-    /** RFC 7231, 6.6.1 */
-    readonly InternalServerError: 500;
-    /** RFC 7231, 6.6.2 */
-    readonly NotImplemented: 501;
-    /** RFC 7231, 6.6.3 */
-    readonly BadGateway: 502;
-    /** RFC 7231, 6.6.4 */
-    readonly ServiceUnavailable: 503;
-    /** RFC 7231, 6.6.5 */
-    readonly GatewayTimeout: 504;
-    /** RFC 7231, 6.6.6 */
-    readonly HTTPVersionNotSupported: 505;
-    /** RFC 2295, 8.1 */
-    readonly VariantAlsoNegotiates: 506;
-    /** RFC 4918, 11.5 */
-    readonly InsufficientStorage: 507;
-    /** RFC 5842, 7.2 */
-    readonly LoopDetected: 508;
-    /** RFC 2774, 7 */
-    readonly NotExtended: 510;
-    /** RFC 6585, 6 */
-    readonly NetworkAuthenticationRequired: 511;
-};
-/** An HTTP status code. */
-export type StatusCode = typeof STATUS_CODE[keyof typeof STATUS_CODE];
-/** A record of all the status codes text. */
-export declare const STATUS_TEXT: {
-    readonly 202: "Accepted";
-    readonly 208: "Already Reported";
-    readonly 502: "Bad Gateway";
-    readonly 400: "Bad Request";
-    readonly 409: "Conflict";
-    readonly 100: "Continue";
-    readonly 201: "Created";
-    readonly 103: "Early Hints";
-    readonly 417: "Expectation Failed";
-    readonly 424: "Failed Dependency";
-    readonly 403: "Forbidden";
-    readonly 302: "Found";
-    readonly 504: "Gateway Timeout";
-    readonly 410: "Gone";
-    readonly 505: "HTTP Version Not Supported";
-    readonly 226: "IM Used";
-    readonly 507: "Insufficient Storage";
-    readonly 500: "Internal Server Error";
-    readonly 411: "Length Required";
-    readonly 423: "Locked";
-    readonly 508: "Loop Detected";
-    readonly 405: "Method Not Allowed";
-    readonly 421: "Misdirected Request";
-    readonly 301: "Moved Permanently";
-    readonly 207: "Multi Status";
-    readonly 300: "Multiple Choices";
-    readonly 511: "Network Authentication Required";
-    readonly 204: "No Content";
-    readonly 203: "Non Authoritative Info";
-    readonly 406: "Not Acceptable";
-    readonly 510: "Not Extended";
-    readonly 404: "Not Found";
-    readonly 501: "Not Implemented";
-    readonly 304: "Not Modified";
-    readonly 200: "OK";
-    readonly 206: "Partial Content";
-    readonly 402: "Payment Required";
-    readonly 308: "Permanent Redirect";
-    readonly 412: "Precondition Failed";
-    readonly 428: "Precondition Required";
-    readonly 102: "Processing";
-    readonly 407: "Proxy Auth Required";
-    readonly 413: "Content Too Large";
-    readonly 431: "Request Header Fields Too Large";
-    readonly 408: "Request Timeout";
-    readonly 414: "URI Too Long";
-    readonly 416: "Range Not Satisfiable";
-    readonly 205: "Reset Content";
-    readonly 303: "See Other";
-    readonly 503: "Service Unavailable";
-    readonly 101: "Switching Protocols";
-    readonly 418: "I'm a teapot";
-    readonly 307: "Temporary Redirect";
-    readonly 425: "Too Early";
-    readonly 429: "Too Many Requests";
-    readonly 401: "Unauthorized";
-    readonly 451: "Unavailable For Legal Reasons";
-    readonly 422: "Unprocessable Entity";
-    readonly 415: "Unsupported Media Type";
-    readonly 426: "Upgrade Required";
-    readonly 305: "Use Proxy";
-    readonly 506: "Variant Also Negotiates";
-};
-/** An HTTP status text. */
-export type StatusText = typeof STATUS_TEXT[keyof typeof STATUS_TEXT];
-/** An HTTP status that is a informational (1XX). */
-export type InformationalStatus = typeof STATUS_CODE.Continue | typeof STATUS_CODE.SwitchingProtocols | typeof STATUS_CODE.Processing | typeof STATUS_CODE.EarlyHints;
-/** An HTTP status that is a success (2XX). */
-export type SuccessfulStatus = typeof STATUS_CODE.OK | typeof STATUS_CODE.Created | typeof STATUS_CODE.Accepted | typeof STATUS_CODE.NonAuthoritativeInfo | typeof STATUS_CODE.NoContent | typeof STATUS_CODE.ResetContent | typeof STATUS_CODE.PartialContent | typeof STATUS_CODE.MultiStatus | typeof STATUS_CODE.AlreadyReported | typeof STATUS_CODE.IMUsed;
-/** An HTTP status that is a redirect (3XX). */
-export type RedirectStatus = typeof STATUS_CODE.MultipleChoices | typeof STATUS_CODE.MovedPermanently | typeof STATUS_CODE.Found | typeof STATUS_CODE.SeeOther | typeof STATUS_CODE.UseProxy | typeof STATUS_CODE.TemporaryRedirect | typeof STATUS_CODE.PermanentRedirect;
-/** An HTTP status that is a client error (4XX). */
-export type ClientErrorStatus = typeof STATUS_CODE.BadRequest | typeof STATUS_CODE.Unauthorized | typeof STATUS_CODE.PaymentRequired | typeof STATUS_CODE.Forbidden | typeof STATUS_CODE.NotFound | typeof STATUS_CODE.MethodNotAllowed | typeof STATUS_CODE.NotAcceptable | typeof STATUS_CODE.ProxyAuthRequired | typeof STATUS_CODE.RequestTimeout | typeof STATUS_CODE.Conflict | typeof STATUS_CODE.Gone | typeof STATUS_CODE.LengthRequired | typeof STATUS_CODE.PreconditionFailed | typeof STATUS_CODE.ContentTooLarge | typeof STATUS_CODE.URITooLong | typeof STATUS_CODE.UnsupportedMediaType | typeof STATUS_CODE.RangeNotSatisfiable | typeof STATUS_CODE.ExpectationFailed | typeof STATUS_CODE.Teapot | typeof STATUS_CODE.MisdirectedRequest | typeof STATUS_CODE.UnprocessableEntity | typeof STATUS_CODE.Locked | typeof STATUS_CODE.FailedDependency | typeof STATUS_CODE.UpgradeRequired | typeof STATUS_CODE.PreconditionRequired | typeof STATUS_CODE.TooManyRequests | typeof STATUS_CODE.RequestHeaderFieldsTooLarge | typeof STATUS_CODE.UnavailableForLegalReasons;
-/** An HTTP status that is a server error (5XX). */
-export type ServerErrorStatus = typeof STATUS_CODE.InternalServerError | typeof STATUS_CODE.NotImplemented | typeof STATUS_CODE.BadGateway | typeof STATUS_CODE.ServiceUnavailable | typeof STATUS_CODE.GatewayTimeout | typeof STATUS_CODE.HTTPVersionNotSupported | typeof STATUS_CODE.VariantAlsoNegotiates | typeof STATUS_CODE.InsufficientStorage | typeof STATUS_CODE.LoopDetected | typeof STATUS_CODE.NotExtended | typeof STATUS_CODE.NetworkAuthenticationRequired;
-/** An HTTP status that is an error (4XX and 5XX). */
-export type ErrorStatus = ClientErrorStatus | ServerErrorStatus;
-/**
- * Returns whether the provided number is a valid HTTP status code.
- *
- * @example Usage
- * ```ts
- * import { isStatus } from "@std/http/status";
- * import { assert } from "@std/assert";
- *
- * assert(isStatus(404));
- * ```
- *
- * @param status The status to assert against.
- * @returns Whether or not the provided status is a valid status code.
- */
-export declare function isStatus(status: number): status is StatusCode;
-/**
- * A type guard that determines if the status code is informational.
- *
- * @example Usage
- * ```ts
- * import { isInformationalStatus } from "@std/http/status";
- * import { assert } from "@std/assert";
- *
- * assert(isInformationalStatus(100));
- * ```
- *
- * @param status The status to assert against.
- * @returns Whether or not the provided status is an informational status code.
- */
-export declare function isInformationalStatus(status: number): status is InformationalStatus;
-/**
- * A type guard that determines if the status code is successful.
- *
- * @example Usage
- * ```ts
- * import { isSuccessfulStatus } from "@std/http/status";
- * import { assert } from "@std/assert";
- *
- * assert(isSuccessfulStatus(200));
- * ```
- *
- * @param status The status to assert against.
- * @returns Whether or not the provided status is a successful status code.
- */
-export declare function isSuccessfulStatus(status: number): status is SuccessfulStatus;
-/**
- * A type guard that determines if the status code is a redirection.
- *
- * @example Usage
- * ```ts
- * import { isRedirectStatus } from "@std/http/status";
- * import { assert } from "@std/assert";
- *
- * assert(isRedirectStatus(302));
- * ```
- *
- * @param status The status to assert against.
- * @returns Whether or not the provided status is a redirect status code.
- */
-export declare function isRedirectStatus(status: number): status is RedirectStatus;
-/**
- * A type guard that determines if the status code is a client error.
- *
- * @example Usage
- * ```ts
- * import { isClientErrorStatus } from "@std/http/status";
- * import { assert } from "@std/assert";
- *
- * assert(isClientErrorStatus(404));
- * ```
- *
- * @param status The status to assert against.
- * @returns Whether or not the provided status is a client error status code.
- */
-export declare function isClientErrorStatus(status: number): status is ClientErrorStatus;
-/**
- * A type guard that determines if the status code is a server error.
- *
- * @example Usage
- * ```ts
- * import { isServerErrorStatus } from "@std/http/status";
- * import { assert } from "@std/assert";
- *
- * assert(isServerErrorStatus(502));
- * ```
- *
- * @param status The status to assert against.
- * @returns Whether or not the provided status is a server error status code.
- */
-export declare function isServerErrorStatus(status: number): status is ServerErrorStatus;
-/**
- * A type guard that determines if the status code is an error.
- *
- * @example Usage
- * ```ts
- * import { isErrorStatus } from "@std/http/status";
- * import { assert } from "@std/assert";
- *
- * assert(isErrorStatus(502));
- * ```
- *
- * @param status The status to assert against.
- * @returns Whether or not the provided status is an error status code.
- */
-export declare function isErrorStatus(status: number): status is ErrorStatus;