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

package/esm/deps/deno.land/x/oak@v17.1.4/body.js

@@ -0,0 +1,236 @@
+// Copyright 2018-2025 the oak authors. All rights reserved. MIT license.
+var __classPrivateFieldSet = (this && this.__classPrivateFieldSet) || function (receiver, state, value, kind, f) {
+    if (kind === "m") throw new TypeError("Private method is not writable");
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a setter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot write private member to an object whose class did not declare it");
+    return (kind === "a" ? f.call(receiver, value) : f ? f.value = value : state.set(receiver, value)), value;
+};
+var __classPrivateFieldGet = (this && this.__classPrivateFieldGet) || function (receiver, state, kind, f) {
+    if (kind === "a" && !f) throw new TypeError("Private accessor was defined without a getter");
+    if (typeof state === "function" ? receiver !== state || !f : !state.has(receiver)) throw new TypeError("Cannot read private member from an object whose class did not declare it");
+    return kind === "m" ? f : kind === "a" ? f.call(receiver) : f ? f.value : state.get(receiver);
+};
+var _Body_body, _Body_memo, _Body_memoType, _Body_headers, _Body_request, _Body_reviver, _Body_type, _Body_used;
+/**
+ * Contains the oak abstraction to represent a request {@linkcode Body}.
+ *
+ * This is not normally used directly by end users.
+ *
+ * @module
+ */
+import { createHttpError, matches, parseFormData, Status } from "./deps.js";
+const KNOWN_BODY_TYPES = [
+    ["binary", ["image", "audio", "application/octet-stream"]],
+    ["form", ["urlencoded"]],
+    ["form-data", ["multipart"]],
+    ["json", ["json", "application/*+json", "application/csp-report"]],
+    ["text", ["text"]],
+];
+async function readBlob(body, type) {
+    if (!body) {
+        return new Blob(undefined, type ? { type } : undefined);
+    }
+    const chunks = [];
+    for await (const chunk of body) {
+        chunks.push(chunk);
+    }
+    return new Blob(chunks, type ? { type } : undefined);
+}
+/** An object which encapsulates information around a request body. */
+export class Body {
+    constructor(serverRequest, reviver) {
+        _Body_body.set(this, void 0);
+        _Body_memo.set(this, null);
+        _Body_memoType.set(this, null);
+        _Body_headers.set(this, void 0);
+        _Body_request.set(this, void 0);
+        _Body_reviver.set(this, void 0);
+        _Body_type.set(this, void 0);
+        _Body_used.set(this, false);
+        if (serverRequest.request) {
+            __classPrivateFieldSet(this, _Body_request, serverRequest.request, "f");
+        }
+        else {
+            __classPrivateFieldSet(this, _Body_headers, serverRequest.headers, "f");
+            __classPrivateFieldSet(this, _Body_body, serverRequest.getBody(), "f");
+        }
+        __classPrivateFieldSet(this, _Body_reviver, reviver, "f");
+    }
+    /** Is `true` if the request might have a body, otherwise `false`.
+     *
+     * **WARNING** this is an unreliable API. In HTTP/2 in many situations you
+     * cannot determine if a request has a body or not unless you attempt to read
+     * the body, due to the streaming nature of HTTP/2. As of Deno 1.16.1, for
+     * HTTP/1.1, Deno also reflects that behavior.  The only reliable way to
+     * determine if a request has a body or not is to attempt to read the body.
+     */
+    get has() {
+        return !!(__classPrivateFieldGet(this, _Body_request, "f") ? __classPrivateFieldGet(this, _Body_request, "f").body : __classPrivateFieldGet(this, _Body_body, "f"));
+    }
+    /** Exposes the "raw" `ReadableStream` of the body. */
+    get stream() {
+        return __classPrivateFieldGet(this, _Body_request, "f") ? __classPrivateFieldGet(this, _Body_request, "f").body : __classPrivateFieldGet(this, _Body_body, "f");
+    }
+    /** Returns `true` if the body has been consumed yet, otherwise `false`. */
+    get used() {
+        return __classPrivateFieldGet(this, _Body_request, "f")?.bodyUsed ?? !!__classPrivateFieldGet(this, _Body_used, "f");
+    }
+    /** Return the body to be reused as BodyInit. */
+    async init() {
+        if (!this.has) {
+            return null;
+        }
+        return await __classPrivateFieldGet(this, _Body_memo, "f") ?? this.stream;
+    }
+    /** Reads a body to the end and resolves with the value as an
+     * {@linkcode ArrayBuffer} */
+    async arrayBuffer() {
+        if (__classPrivateFieldGet(this, _Body_memoType, "f") === "arrayBuffer") {
+            return __classPrivateFieldGet(this, _Body_memo, "f");
+        }
+        else if (__classPrivateFieldGet(this, _Body_memoType, "f")) {
+            throw new TypeError("Body already used as a different type.");
+        }
+        __classPrivateFieldSet(this, _Body_memoType, "arrayBuffer", "f");
+        if (__classPrivateFieldGet(this, _Body_request, "f")) {
+            return __classPrivateFieldSet(this, _Body_memo, __classPrivateFieldGet(this, _Body_request, "f").arrayBuffer(), "f");
+        }
+        __classPrivateFieldSet(this, _Body_used, true, "f");
+        return __classPrivateFieldSet(this, _Body_memo, (await readBlob(__classPrivateFieldGet(this, _Body_body, "f"))).arrayBuffer(), "f");
+    }
+    /** Reads a body to the end and resolves with the value as a
+     * {@linkcode Blob}. */
+    blob() {
+        if (__classPrivateFieldGet(this, _Body_memoType, "f") === "blob") {
+            return __classPrivateFieldGet(this, _Body_memo, "f");
+        }
+        else if (__classPrivateFieldGet(this, _Body_memoType, "f")) {
+            throw new TypeError("Body already used as a different type.");
+        }
+        __classPrivateFieldSet(this, _Body_memoType, "blob", "f");
+        if (__classPrivateFieldGet(this, _Body_request, "f")) {
+            return __classPrivateFieldSet(this, _Body_memo, __classPrivateFieldGet(this, _Body_request, "f").blob(), "f");
+        }
+        __classPrivateFieldSet(this, _Body_used, true, "f");
+        return __classPrivateFieldSet(this, _Body_memo, readBlob(__classPrivateFieldGet(this, _Body_body, "f"), __classPrivateFieldGet(this, _Body_headers, "f")?.get("content-type")), "f");
+    }
+    /** Reads a body as a URL encoded form, resolving the value as
+     * {@linkcode URLSearchParams}. */
+    async form() {
+        const text = await this.text();
+        return new URLSearchParams(text);
+    }
+    /** Reads a body to the end attempting to parse the body as a set of
+     * {@linkcode FormData}. */
+    formData() {
+        if (__classPrivateFieldGet(this, _Body_memoType, "f") === "formData") {
+            return __classPrivateFieldGet(this, _Body_memo, "f");
+        }
+        else if (__classPrivateFieldGet(this, _Body_memoType, "f")) {
+            throw new TypeError("Body already used as a different type.");
+        }
+        __classPrivateFieldSet(this, _Body_memoType, "formData", "f");
+        if (__classPrivateFieldGet(this, _Body_request, "f")) {
+            return __classPrivateFieldSet(this, _Body_memo, __classPrivateFieldGet(this, _Body_request, "f").formData(), "f");
+        }
+        __classPrivateFieldSet(this, _Body_used, true, "f");
+        if (__classPrivateFieldGet(this, _Body_body, "f") && __classPrivateFieldGet(this, _Body_headers, "f")) {
+            const contentType = __classPrivateFieldGet(this, _Body_headers, "f").get("content-type");
+            if (contentType) {
+                return __classPrivateFieldSet(this, _Body_memo, parseFormData(contentType, __classPrivateFieldGet(this, _Body_body, "f")), "f");
+            }
+        }
+        throw createHttpError(Status.BadRequest, "Missing content type.");
+    }
+    /** Reads a body to the end attempting to parse the body as a JSON value.
+     *
+     * If a JSON reviver has been assigned, it will be used to parse the body.
+     */
+    // deno-lint-ignore no-explicit-any
+    async json() {
+        try {
+            return JSON.parse(await this.text(), __classPrivateFieldGet(this, _Body_reviver, "f"));
+        }
+        catch (err) {
+            if (err instanceof Error) {
+                throw createHttpError(Status.BadRequest, err.message);
+            }
+            throw createHttpError(Status.BadRequest, JSON.stringify(err));
+        }
+    }
+    /** Reads the body to the end resolving with a string. */
+    async text() {
+        if (__classPrivateFieldGet(this, _Body_memoType, "f") === "text") {
+            return __classPrivateFieldGet(this, _Body_memo, "f");
+        }
+        else if (__classPrivateFieldGet(this, _Body_memoType, "f")) {
+            throw new TypeError("Body already used as a different type.");
+        }
+        __classPrivateFieldSet(this, _Body_memoType, "text", "f");
+        if (__classPrivateFieldGet(this, _Body_request, "f")) {
+            return __classPrivateFieldSet(this, _Body_memo, __classPrivateFieldGet(this, _Body_request, "f").text(), "f");
+        }
+        __classPrivateFieldSet(this, _Body_used, true, "f");
+        return __classPrivateFieldSet(this, _Body_memo, (await readBlob(__classPrivateFieldGet(this, _Body_body, "f"))).text(), "f");
+    }
+    /** Attempts to determine what type of the body is to help determine how best
+     * to attempt to decode the body. This performs analysis on the supplied
+     * `Content-Type` header of the request.
+     *
+     * **Note** these are not authoritative and should only be used as guidance.
+     *
+     * There is the ability to provide custom types when attempting to discern
+     * the type. Custom types are provided in the format of an object where the
+     * key is on of {@linkcode BodyType} and the value is an array of media types
+     * to attempt to match. Values supplied will be additive to known media types.
+     *
+     * The returned value is one of the following:
+     *
+     * - `"binary"` - The body appears to be binary data and should be consumed as
+     *   an array buffer, readable stream or blob.
+     * - `"form"` - The value appears to be an URL encoded form and should be
+     *   consumed as a form (`URLSearchParams`).
+     * - `"form-data"` - The value appears to be multipart form data and should be
+     *   consumed as form data.
+     * - `"json"` - The value appears to be JSON data and should be consumed as
+     *   decoded JSON.
+     * - `"text"` - The value appears to be text data and should be consumed as
+     *   text.
+     * - `"unknown"` - Either there is no body or the body type could not be
+     *   determined.
+     */
+    type(customMediaTypes) {
+        if (__classPrivateFieldGet(this, _Body_type, "f") && !customMediaTypes) {
+            return __classPrivateFieldGet(this, _Body_type, "f");
+        }
+        customMediaTypes = customMediaTypes ?? {};
+        const headers = __classPrivateFieldGet(this, _Body_request, "f")?.headers ?? __classPrivateFieldGet(this, _Body_headers, "f");
+        const contentType = headers?.get("content-type");
+        if (contentType) {
+            for (const [bodyType, knownMediaTypes] of KNOWN_BODY_TYPES) {
+                const customTypes = customMediaTypes[bodyType] ?? [];
+                if (matches(contentType, [...knownMediaTypes, ...customTypes])) {
+                    __classPrivateFieldSet(this, _Body_type, bodyType, "f");
+                    return __classPrivateFieldGet(this, _Body_type, "f");
+                }
+            }
+        }
+        return __classPrivateFieldSet(this, _Body_type, "unknown", "f");
+    }
+    [(_Body_body = new WeakMap(), _Body_memo = new WeakMap(), _Body_memoType = new WeakMap(), _Body_headers = new WeakMap(), _Body_request = new WeakMap(), _Body_reviver = new WeakMap(), _Body_type = new WeakMap(), _Body_used = new WeakMap(), Symbol.for("Deno.customInspect"))](inspect) {
+        const { has, used } = this;
+        return `${this.constructor.name} ${inspect({ has, used })}`;
+    }
+    [Symbol.for("nodejs.util.inspect.custom")](depth, 
+    // deno-lint-ignore no-explicit-any
+    options, inspect) {
+        if (depth < 0) {
+            return options.stylize(`[${this.constructor.name}]`, "special");
+        }
+        const newOptions = Object.assign({}, options, {
+            depth: options.depth === null ? null : options.depth - 1,
+        });
+        const { has, used } = this;
+        return `${options.stylize(this.constructor.name, "special")} ${inspect({ has, used }, newOptions)}`;
+    }
+}

package/esm/deps/deno.land/x/oak@v17.1.4/context.d.ts

@@ -0,0 +1,163 @@
+/**
+ * Contains the {@linkcode Context} class which is the context that is provided
+ * to middleware.
+ *
+ * Typically this is not used directly by end users except when creating
+ * re-usable middleware.
+ *
+ * @module
+ */
+import type { Application, State } from "./application.js";
+import { type ErrorStatus, type HttpErrorOptions, SecureCookieMap, type ServerSentEventTarget, type ServerSentEventTargetOptions } from "./deps.js";
+import { Request } from "./request.js";
+import { Response } from "./response.js";
+import { type SendOptions } from "./send.js";
+import type { ServerRequest, UpgradeWebSocketOptions } from "./types.js";
+/** Options that can be supplied when creating a {@linkcode Context} */
+export interface ContextOptions<S extends AS = State, AS extends State = Record<string, any>> {
+    jsonBodyReplacer?: (key: string, value: unknown, context: Context<S>) => unknown;
+    jsonBodyReviver?: (key: string, value: unknown, context: Context<S>) => unknown;
+    secure?: boolean;
+}
+/** Options that can be supplied when using the `.send()` method. */
+export interface ContextSendOptions extends SendOptions {
+    /** The filename to send, which will be resolved based on the other options.
+     * If this property is omitted, the current context's `.request.url.pathname`
+     * will be used. */
+    path?: string;
+}
+/** Provides context about the current request and response to middleware
+ * functions, and the current instance being processed is the first argument
+ * provided a {@linkcode Middleware} function.
+ *
+ * _Typically this is only used as a type annotation and shouldn't be
+ * constructed directly._
+ *
+ * ### Example
+ *
+ * ```ts
+ * import { Application, Context } from "jsr:@oak/oak/";
+ *
+ * const app = new Application();
+ *
+ * app.use((ctx) => {
+ *   // information about the request is here:
+ *   ctx.request;
+ *   // information about the response is here:
+ *   ctx.response;
+ *   // the cookie store is here:
+ *   ctx.cookies;
+ * });
+ *
+ * // Needs a type annotation because it cannot be inferred.
+ * function mw(ctx: Context) {
+ *   // process here...
+ * }
+ *
+ * app.use(mw);
+ * ```
+ *
+ * @template S the state which extends the application state (`AS`)
+ * @template AS the type of the state derived from the application
+ */
+export declare class Context<S extends AS = State, AS extends State = Record<string, any>> {
+    #private;
+    /** A reference to the current application. */
+    app: Application<AS>;
+    /** An object which allows access to cookies, mediating both the request and
+     * response. */
+    cookies: SecureCookieMap;
+    /** Is `true` if the current connection is upgradeable to a web socket.
+     * Otherwise the value is `false`.  Use `.upgrade()` to upgrade the connection
+     * and return the web socket. */
+    get isUpgradable(): boolean;
+    /** Determines if the request should be responded to.  If `false` when the
+     * middleware completes processing, the response will not be sent back to the
+     * requestor.  Typically this is used if the middleware will take over low
+     * level processing of requests and responses, for example if using web
+     * sockets.  This automatically gets set to `false` when the context is
+     * upgraded to a web socket via the `.upgrade()` method.
+     *
+     * The default is `true`. */
+    respond: boolean;
+    /** An object which contains information about the current request. */
+    request: Request;
+    /** An object which contains information about the response that will be sent
+     * when the middleware finishes processing. */
+    response: Response;
+    /** If the the current context has been upgraded, then this will be set to
+     * with the current web socket, otherwise it is `undefined`. */
+    get socket(): WebSocket | undefined;
+    /** The object to pass state to front-end views.  This can be typed by
+     * supplying the generic state argument when creating a new app.  For
+     * example:
+     *
+     * ```ts
+     * const app = new Application<{ foo: string }>();
+     * ```
+     *
+     * Or can be contextually inferred based on setting an initial state object:
+     *
+     * ```ts
+     * const app = new Application({ state: { foo: "bar" } });
+     * ```
+     *
+     * On each request/response cycle, the context's state is cloned from the
+     * application state. This means changes to the context's `.state` will be
+     * dropped when the request drops, but "defaults" can be applied to the
+     * application's state.  Changes to the application's state though won't be
+     * reflected until the next request in the context's state.
+     */
+    state: S;
+    constructor(app: Application<AS>, serverRequest: ServerRequest, state: S, { secure, jsonBodyReplacer, jsonBodyReviver, }?: ContextOptions<S, AS>);
+    /** Asserts the condition and if the condition fails, creates an HTTP error
+     * with the provided status (which defaults to `500`).  The error status by
+     * default will be set on the `.response.status`.
+     *
+     * Because of limitation of TypeScript, any assertion type function requires
+     * specific type annotations, so the {@linkcode Context} type should be used
+     * even if it can be inferred from the context.
+     *
+     * ### Example
+     *
+     * ```ts
+     * import { Context, Status } from "jsr:@oak/oak/";
+     *
+     * export function mw(ctx: Context) {
+     *   const body = ctx.request.body();
+     *   ctx.assert(body.type === "json", Status.NotAcceptable);
+     *   // process the body and send a response...
+     * }
+     * ```
+     */
+    assert(condition: unknown, errorStatus?: ErrorStatus, message?: string, props?: Record<string, unknown> & Omit<HttpErrorOptions, "status">): asserts condition;
+    /** Asynchronously fulfill a response with a file from the local file
+     * system.
+     *
+     * If the `options.path` is not supplied, the file to be sent will default
+     * to this `.request.url.pathname`.
+     *
+     * Requires Deno read permission. */
+    send(options: ContextSendOptions): Promise<string | undefined>;
+    /** Convert the connection to stream events, resolving with an event target
+     * for sending server sent events.  Events dispatched on the returned target
+     * will be sent to the client and be available in the client's `EventSource`
+     * that initiated the connection.
+     *
+     * Invoking this will cause the a response to be sent to the client
+     * immediately to initialize the stream of events, and therefore any further
+     * changes to the response, like headers will not reach the client.
+     */
+    sendEvents(options?: ServerSentEventTargetOptions): Promise<ServerSentEventTarget>;
+    /** Create and throw an HTTP Error, which can be used to pass status
+     * information which can be caught by other middleware to send more
+     * meaningful error messages back to the client.  The passed error status will
+     * be set on the `.response.status` by default as well.
+     */
+    throw(errorStatus: ErrorStatus, message?: string, props?: Record<string, unknown>): never;
+    /** Take the current request and upgrade it to a web socket, resolving with
+     * the a web standard `WebSocket` object. This will set `.respond` to
+     * `false`.  If the socket cannot be upgraded, this method will throw. */
+    upgrade(options?: UpgradeWebSocketOptions): WebSocket;
+}
+//# sourceMappingURL=context.d.ts.map

package/esm/deps/deno.land/x/oak@v17.1.4/context.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"context.d.ts","sourceRoot":"","sources":["../../../../../src/deps/deno.land/x/oak@v17.1.4/context.ts"],"names":[],"mappings":"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"}