@usetoki/toki 0.1.1

package/dist/request.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"request.js","sourceRoot":"","sources":["../ts/request.ts"],"names":[],"mappings":"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"}

package/dist/response.d.ts

@@ -0,0 +1,33 @@
+import type { NativeResponse } from "./native.js";
+import type { HandlerResult, StreamResponse, StreamSource, TokiResponse } from "./types.js";
+type StagedHeaders = ReadonlyArray<readonly [string, string]>;
+export declare function isTokiResponse(value: unknown): value is TokiResponse;
+export declare function isStreamResponse(value: unknown): value is StreamResponse;
+/** Wrap an already-serialized JSON string as a response (schema serialization path). */
+export declare function jsonResponse(serialized: string, status?: number): TokiResponse;
+/** Build a fully-specified branded response (for middleware crafting its own). */
+export declare function rawResponse(status: number, contentType: string, body: string | Uint8Array, headers?: ReadonlyArray<readonly [string, string]>): TokiResponse;
+/** Builders for the common response shapes. */
+export declare const reply: {
+    readonly text: (body: string, status?: number) => TokiResponse;
+    readonly html: (body: string, status?: number) => TokiResponse;
+    readonly json: <T>(data: T, status?: number) => TokiResponse;
+    readonly empty: (status?: number) => TokiResponse;
+    readonly redirect: (location: string, status?: number) => TokiResponse;
+    readonly bytes: (data: Uint8Array, contentType?: string, status?: number) => TokiResponse;
+    /**
+     * Chunked streaming response. `source` is an async/sync iterable or Node `Readable`;
+     * each chunk (bytes or utf-8 string) is written as it arrives. SSE: set
+     * `contentType: "text/event-stream"`.
+     */
+    readonly stream: (source: StreamSource, options?: {
+        status?: number;
+        contentType?: string;
+        headers?: ReadonlyArray<readonly [string, string]>;
+    }) => StreamResponse;
+};
+/** String becomes text/plain; any other plain value becomes JSON. */
+export declare function normalize(result: HandlerResult): TokiResponse;
+/** Flatten a handler result into the engine's wire shape, prepending staged headers. */
+export declare function toNative(result: HandlerResult, staged?: StagedHeaders): NativeResponse;
+export {};

package/dist/response.js

@@ -0,0 +1,92 @@
+const TOKI_RESPONSE = Symbol.for("toki.response");
+const TOKI_STREAM = Symbol.for("toki.stream");
+export function isTokiResponse(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[TOKI_RESPONSE] === true);
+}
+export function isStreamResponse(value) {
+    return (typeof value === "object" &&
+        value !== null &&
+        value[TOKI_STREAM] === true);
+}
+/** Wrap an already-serialized JSON string as a response (schema serialization path). */
+export function jsonResponse(serialized, status = 200) {
+    return {
+        status,
+        contentType: JSON_TYPE,
+        headers: [],
+        body: serialized,
+        [TOKI_RESPONSE]: true,
+    };
+}
+/** Build a fully-specified branded response (for middleware crafting its own). */
+export function rawResponse(status, contentType, body, headers = []) {
+    return make(status, contentType, body, headers);
+}
+const TEXT = "text/plain; charset=utf-8";
+const HTML = "text/html; charset=utf-8";
+const JSON_TYPE = "application/json; charset=utf-8";
+function make(status, contentType, body, headers = []) {
+    return { status, contentType, headers, body, [TOKI_RESPONSE]: true };
+}
+/** Builders for the common response shapes. */
+export const reply = {
+    text(body, status = 200) {
+        return make(status, TEXT, body);
+    },
+    html(body, status = 200) {
+        return make(status, HTML, body);
+    },
+    json(data, status = 200) {
+        return make(status, JSON_TYPE, JSON.stringify(data));
+    },
+    empty(status = 204) {
+        return make(status, TEXT, "");
+    },
+    redirect(location, status = 302) {
+        return make(status, TEXT, "", [["Location", location]]);
+    },
+    bytes(data, contentType = "application/octet-stream", status = 200) {
+        return make(status, contentType, data);
+    },
+    /**
+     * Chunked streaming response. `source` is an async/sync iterable or Node `Readable`;
+     * each chunk (bytes or utf-8 string) is written as it arrives. SSE: set
+     * `contentType: "text/event-stream"`.
+     */
+    stream(source, options = {}) {
+        return {
+            status: options.status ?? 200,
+            contentType: options.contentType ?? "application/octet-stream",
+            headers: options.headers ?? [],
+            source,
+            [TOKI_STREAM]: true,
+        };
+    },
+};
+/** String becomes text/plain; any other plain value becomes JSON. */
+export function normalize(result) {
+    if (typeof result === "string") {
+        return reply.text(result);
+    }
+    if (isTokiResponse(result)) {
+        return result;
+    }
+    return reply.json(result);
+}
+/** Flatten a handler result into the engine's wire shape, prepending staged headers. */
+export function toNative(result, staged = []) {
+    const response = normalize(result);
+    let headers = "";
+    // staged first: on a single-valued conflict the response's own header wins (written last)
+    for (const [name, value] of staged) {
+        headers += `${name}: ${value}\r\n`;
+    }
+    headers += `Content-Type: ${response.contentType}\r\n`;
+    for (const [name, value] of response.headers) {
+        headers += `${name}: ${value}\r\n`;
+    }
+    return { status: response.status, headers, body: response.body };
+}
+//# sourceMappingURL=response.js.map

package/dist/response.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"response.js","sourceRoot":"","sources":["../ts/response.ts"],"names":[],"mappings":"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"}

package/dist/schema.d.ts

@@ -0,0 +1,45 @@
+/** Custom error messages: one for the whole field, or per failing keyword. */
+export interface ErrorMessages {
+    type?: string;
+    enum?: string;
+    minLength?: string;
+    maxLength?: string;
+    pattern?: string;
+    format?: string;
+    minimum?: string;
+    maximum?: string;
+    additionalProperties?: string;
+    /** Generic message, or one per required property name. */
+    required?: string | Record<string, string>;
+}
+export interface JSONSchema {
+    type?: "object" | "array" | "string" | "number" | "integer" | "boolean" | "null";
+    properties?: Record<string, JSONSchema>;
+    required?: string[];
+    items?: JSONSchema;
+    enum?: ReadonlyArray<unknown>;
+    /** Allow `null` in addition to `type`. */
+    nullable?: boolean;
+    additionalProperties?: boolean;
+    minimum?: number;
+    maximum?: number;
+    minLength?: number;
+    maxLength?: number;
+    pattern?: string;
+    format?: "email" | "uuid" | "date-time" | "uri";
+    default?: unknown;
+    /** Override the message(s) emitted when this schema fails. */
+    errorMessage?: string | ErrorMessages;
+}
+/** Per-route schema. `response` keys by status code. */
+export interface RouteSchema {
+    body?: JSONSchema;
+    query?: JSONSchema;
+    params?: JSONSchema;
+    headers?: JSONSchema;
+    response?: Record<number, JSONSchema>;
+}
+/** Validates `value` against `schema`, returning human-readable error messages (empty = valid). */
+export declare function validate(schema: JSONSchema, value: unknown, path?: string): string[];
+/** schema-driven serialize: emits only declared props, falls back to JSON.stringify when type unknown */
+export declare function serialize(schema: JSONSchema, value: unknown): string;

package/dist/schema.js

@@ -0,0 +1,179 @@
+// A compact JSON Schema subset for request validation and response serialization.
+// Dependency-free; covers the shapes real APIs use. Not a full draft implementation.
+/** custom message for a failed keyword, else fallback */
+function messageFor(schema, keyword, fallback) {
+    const em = schema.errorMessage;
+    if (typeof em === "string")
+        return em;
+    if (em && typeof em === "object") {
+        const m = em[keyword];
+        if (typeof m === "string")
+            return m;
+    }
+    return fallback;
+}
+const FORMATS = {
+    email: /^[^\s@]+@[^\s@]+\.[^\s@]+$/,
+    uuid: /^[0-9a-f]{8}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{4}-[0-9a-f]{12}$/i,
+    "date-time": /^\d{4}-\d{2}-\d{2}T\d{2}:\d{2}:\d{2}(\.\d+)?(Z|[+-]\d{2}:\d{2})?$/,
+    uri: /^[a-z][a-z0-9+.-]*:/i,
+};
+/** Validates `value` against `schema`, returning human-readable error messages (empty = valid). */
+export function validate(schema, value, path = "") {
+    const errors = [];
+    check(schema, value, path || "value", errors);
+    return errors;
+}
+function check(schema, value, path, errors) {
+    if (value === null) {
+        if (schema.nullable || schema.type === "null") {
+            return;
+        }
+    }
+    if (schema.enum && !schema.enum.some((e) => e === value)) {
+        errors.push(messageFor(schema, "enum", `${path} must be one of ${JSON.stringify(schema.enum)}`));
+        return;
+    }
+    switch (schema.type) {
+        case "object":
+            checkObject(schema, value, path, errors);
+            break;
+        case "array":
+            checkArray(schema, value, path, errors);
+            break;
+        case "string":
+            checkString(schema, value, path, errors);
+            break;
+        case "number":
+        case "integer":
+            checkNumber(schema, value, path, errors);
+            break;
+        case "boolean":
+            if (typeof value !== "boolean")
+                errors.push(messageFor(schema, "type", `${path} must be a boolean`));
+            break;
+        default:
+            break;
+    }
+}
+// required-property message: generic override, per-property map, or fallback
+function requiredMessage(schema, key, fallback) {
+    const em = schema.errorMessage;
+    if (typeof em === "string")
+        return em;
+    if (em && typeof em === "object" && em.required !== undefined) {
+        if (typeof em.required === "string")
+            return em.required;
+        return em.required[key] ?? fallback;
+    }
+    return fallback;
+}
+function checkObject(schema, value, path, errors) {
+    if (typeof value !== "object" || value === null || Array.isArray(value)) {
+        errors.push(messageFor(schema, "type", `${path} must be an object`));
+        return;
+    }
+    const obj = value;
+    for (const key of schema.required ?? []) {
+        if (!(key in obj)) {
+            errors.push(requiredMessage(schema, key, `${path}.${key} is required`));
+        }
+    }
+    if (schema.properties) {
+        for (const [key, sub] of Object.entries(schema.properties)) {
+            if (key in obj) {
+                check(sub, obj[key], `${path}.${key}`, errors);
+            }
+        }
+        if (schema.additionalProperties === false) {
+            for (const key of Object.keys(obj)) {
+                if (!(key in schema.properties)) {
+                    errors.push(messageFor(schema, "additionalProperties", `${path}.${key} is not allowed`));
+                }
+            }
+        }
+    }
+}
+function checkArray(schema, value, path, errors) {
+    if (!Array.isArray(value)) {
+        errors.push(messageFor(schema, "type", `${path} must be an array`));
+        return;
+    }
+    if (schema.items) {
+        value.forEach((item, i) => check(schema.items, item, `${path}[${i}]`, errors));
+    }
+}
+function checkString(schema, value, path, errors) {
+    if (typeof value !== "string") {
+        errors.push(messageFor(schema, "type", `${path} must be a string`));
+        return;
+    }
+    if (schema.minLength !== undefined && value.length < schema.minLength) {
+        errors.push(messageFor(schema, "minLength", `${path} must be at least ${schema.minLength} characters`));
+    }
+    if (schema.maxLength !== undefined && value.length > schema.maxLength) {
+        errors.push(messageFor(schema, "maxLength", `${path} must be at most ${schema.maxLength} characters`));
+    }
+    if (schema.pattern && !new RegExp(schema.pattern).test(value)) {
+        errors.push(messageFor(schema, "pattern", `${path} must match ${schema.pattern}`));
+    }
+    if (schema.format && FORMATS[schema.format] && !FORMATS[schema.format].test(value)) {
+        errors.push(messageFor(schema, "format", `${path} must be a valid ${schema.format}`));
+    }
+}
+function checkNumber(schema, value, path, errors) {
+    if (typeof value !== "number" || Number.isNaN(value)) {
+        errors.push(messageFor(schema, "type", `${path} must be a number`));
+        return;
+    }
+    if (schema.type === "integer" && !Number.isInteger(value)) {
+        errors.push(messageFor(schema, "type", `${path} must be an integer`));
+    }
+    if (schema.minimum !== undefined && value < schema.minimum) {
+        errors.push(messageFor(schema, "minimum", `${path} must be >= ${schema.minimum}`));
+    }
+    if (schema.maximum !== undefined && value > schema.maximum) {
+        errors.push(messageFor(schema, "maximum", `${path} must be <= ${schema.maximum}`));
+    }
+}
+/** schema-driven serialize: emits only declared props, falls back to JSON.stringify when type unknown */
+export function serialize(schema, value) {
+    if (value === null || value === undefined) {
+        return "null";
+    }
+    switch (schema.type) {
+        case "object": {
+            if (typeof value !== "object")
+                return "null";
+            const obj = value;
+            let out = "{";
+            let first = true;
+            for (const [key, sub] of Object.entries(schema.properties ?? {})) {
+                if (obj[key] === undefined) {
+                    continue;
+                }
+                if (!first)
+                    out += ",";
+                out += `${JSON.stringify(key)}:${serialize(sub, obj[key])}`;
+                first = false;
+            }
+            return out + "}";
+        }
+        case "array": {
+            if (!Array.isArray(value))
+                return "[]";
+            const item = schema.items ?? {};
+            return `[${value.map((v) => serialize(item, v)).join(",")}]`;
+        }
+        case "string":
+            return JSON.stringify(String(value));
+        case "integer":
+        case "number":
+            return Number.isFinite(value) ? String(value) : "null";
+        case "boolean":
+            return value ? "true" : "false";
+        default:
+            return JSON.stringify(value);
+    }
+}
+//# sourceMappingURL=schema.js.map

package/dist/schema.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"schema.js","sourceRoot":"","sources":["../ts/schema.ts"],"names":[],"mappings":"AAAA,kFAAkF;AAClF,qFAAqF;AAqCrF,yDAAyD;AACzD,SAAS,UAAU,CAAC,MAAkB,EAAE,OAA4B,EAAE,QAAgB;IACpF,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC;IAC/B,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,EAAE,CAAC;QACjC,MAAM,CAAC,GAAG,EAAE,CAAC,OAAO,CAAC,CAAC;QACtB,IAAI,OAAO,CAAC,KAAK,QAAQ;YAAE,OAAO,CAAC,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAWD,MAAM,OAAO,GAA2B;IACtC,KAAK,EAAE,4BAA4B;IACnC,IAAI,EAAE,iEAAiE;IACvE,WAAW,EAAE,mEAAmE;IAChF,GAAG,EAAE,sBAAsB;CAC5B,CAAC;AAEF,mGAAmG;AACnG,MAAM,UAAU,QAAQ,CAAC,MAAkB,EAAE,KAAc,EAAE,IAAI,GAAG,EAAE;IACpE,MAAM,MAAM,GAAa,EAAE,CAAC;IAC5B,KAAK,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,IAAI,OAAO,EAAE,MAAM,CAAC,CAAC;IAC9C,OAAO,MAAM,CAAC;AAChB,CAAC;AAED,SAAS,KAAK,CAAC,MAAkB,EAAE,KAAc,EAAE,IAAY,EAAE,MAAgB;IAC/E,IAAI,KAAK,KAAK,IAAI,EAAE,CAAC;QACnB,IAAI,MAAM,CAAC,QAAQ,IAAI,MAAM,CAAC,IAAI,KAAK,MAAM,EAAE,CAAC;YAC9C,OAAO;QACT,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,IAAI,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,KAAK,KAAK,CAAC,EAAE,CAAC;QACzD,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,mBAAmB,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,IAAI,CAAC,EAAE,CAAC,CACpF,CAAC;QACF,OAAO;IACT,CAAC;IACD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ;YACX,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,OAAO;YACV,UAAU,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACxC,MAAM;QACR,KAAK,QAAQ;YACX,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,QAAQ,CAAC;QACd,KAAK,SAAS;YACZ,WAAW,CAAC,MAAM,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,CAAC,CAAC;YACzC,MAAM;QACR,KAAK,SAAS;YACZ,IAAI,OAAO,KAAK,KAAK,SAAS;gBAC5B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC,CAAC;YACvE,MAAM;QACR;YACE,MAAM;IACV,CAAC;AACH,CAAC;AAED,6EAA6E;AAC7E,SAAS,eAAe,CAAC,MAAkB,EAAE,GAAW,EAAE,QAAgB;IACxE,MAAM,EAAE,GAAG,MAAM,CAAC,YAAY,CAAC;IAC/B,IAAI,OAAO,EAAE,KAAK,QAAQ;QAAE,OAAO,EAAE,CAAC;IACtC,IAAI,EAAE,IAAI,OAAO,EAAE,KAAK,QAAQ,IAAI,EAAE,CAAC,QAAQ,KAAK,SAAS,EAAE,CAAC;QAC9D,IAAI,OAAO,EAAE,CAAC,QAAQ,KAAK,QAAQ;YAAE,OAAO,EAAE,CAAC,QAAQ,CAAC;QACxD,OAAO,EAAE,CAAC,QAAQ,CAAC,GAAG,CAAC,IAAI,QAAQ,CAAC;IACtC,CAAC;IACD,OAAO,QAAQ,CAAC;AAClB,CAAC;AAED,SAAS,WAAW,CAAC,MAAkB,EAAE,KAAc,EAAE,IAAY,EAAE,MAAgB;IACrF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QACxE,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,oBAAoB,CAAC,CAAC,CAAC;QACrE,OAAO;IACT,CAAC;IACD,MAAM,GAAG,GAAG,KAAgC,CAAC;IAC7C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,QAAQ,IAAI,EAAE,EAAE,CAAC;QACxC,IAAI,CAAC,CAAC,GAAG,IAAI,GAAG,CAAC,EAAE,CAAC;YAClB,MAAM,CAAC,IAAI,CAAC,eAAe,CAAC,MAAM,EAAE,GAAG,EAAE,GAAG,IAAI,IAAI,GAAG,cAAc,CAAC,CAAC,CAAC;QAC1E,CAAC;IACH,CAAC;IACD,IAAI,MAAM,CAAC,UAAU,EAAE,CAAC;QACtB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;YAC3D,IAAI,GAAG,IAAI,GAAG,EAAE,CAAC;gBACf,KAAK,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,EAAE,GAAG,IAAI,IAAI,GAAG,EAAE,EAAE,MAAM,CAAC,CAAC;YACjD,CAAC;QACH,CAAC;QACD,IAAI,MAAM,CAAC,oBAAoB,KAAK,KAAK,EAAE,CAAC;YAC1C,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC;gBACnC,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,UAAU,CAAC,EAAE,CAAC;oBAChC,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,sBAAsB,EAAE,GAAG,IAAI,IAAI,GAAG,iBAAiB,CAAC,CAAC,CAAC;gBAC3F,CAAC;YACH,CAAC;QACH,CAAC;IACH,CAAC;AACH,CAAC;AAED,SAAS,UAAU,CAAC,MAAkB,EAAE,KAAc,EAAE,IAAY,EAAE,MAAgB;IACpF,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,KAAK,EAAE,CAAC;QACjB,KAAK,CAAC,OAAO,CAAC,CAAC,IAAI,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,CAAC,MAAM,CAAC,KAAmB,EAAE,IAAI,EAAE,GAAG,IAAI,IAAI,CAAC,GAAG,EAAE,MAAM,CAAC,CAAC,CAAC;IAC/F,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAkB,EAAE,KAAc,EAAE,IAAY,EAAE,MAAgB;IACrF,IAAI,OAAO,KAAK,KAAK,QAAQ,EAAE,CAAC;QAC9B,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,qBAAqB,MAAM,CAAC,SAAS,aAAa,CAAC,CAC3F,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,SAAS,KAAK,SAAS,IAAI,KAAK,CAAC,MAAM,GAAG,MAAM,CAAC,SAAS,EAAE,CAAC;QACtE,MAAM,CAAC,IAAI,CACT,UAAU,CAAC,MAAM,EAAE,WAAW,EAAE,GAAG,IAAI,oBAAoB,MAAM,CAAC,SAAS,aAAa,CAAC,CAC1F,CAAC;IACJ,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,IAAI,CAAC,IAAI,MAAM,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QAC9D,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,MAAM,CAAC,MAAM,IAAI,OAAO,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,CAAC,MAAM,CAAC,MAAM,CAAE,CAAC,IAAI,CAAC,KAAK,CAAC,EAAE,CAAC;QACpF,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,QAAQ,EAAE,GAAG,IAAI,oBAAoB,MAAM,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC;IACxF,CAAC;AACH,CAAC;AAED,SAAS,WAAW,CAAC,MAAkB,EAAE,KAAc,EAAE,IAAY,EAAE,MAAgB;IACrF,IAAI,OAAO,KAAK,KAAK,QAAQ,IAAI,MAAM,CAAC,KAAK,CAAC,KAAK,CAAC,EAAE,CAAC;QACrD,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,mBAAmB,CAAC,CAAC,CAAC;QACpE,OAAO;IACT,CAAC;IACD,IAAI,MAAM,CAAC,IAAI,KAAK,SAAS,IAAI,CAAC,MAAM,CAAC,SAAS,CAAC,KAAK,CAAC,EAAE,CAAC;QAC1D,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,MAAM,EAAE,GAAG,IAAI,qBAAqB,CAAC,CAAC,CAAC;IACxE,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;IACD,IAAI,MAAM,CAAC,OAAO,KAAK,SAAS,IAAI,KAAK,GAAG,MAAM,CAAC,OAAO,EAAE,CAAC;QAC3D,MAAM,CAAC,IAAI,CAAC,UAAU,CAAC,MAAM,EAAE,SAAS,EAAE,GAAG,IAAI,eAAe,MAAM,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC;IACrF,CAAC;AACH,CAAC;AAED,yGAAyG;AACzG,MAAM,UAAU,SAAS,CAAC,MAAkB,EAAE,KAAc;IAC1D,IAAI,KAAK,KAAK,IAAI,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;QAC1C,OAAO,MAAM,CAAC;IAChB,CAAC;IACD,QAAQ,MAAM,CAAC,IAAI,EAAE,CAAC;QACpB,KAAK,QAAQ,CAAC,CAAC,CAAC;YACd,IAAI,OAAO,KAAK,KAAK,QAAQ;gBAAE,OAAO,MAAM,CAAC;YAC7C,MAAM,GAAG,GAAG,KAAgC,CAAC;YAC7C,IAAI,GAAG,GAAG,GAAG,CAAC;YACd,IAAI,KAAK,GAAG,IAAI,CAAC;YACjB,KAAK,MAAM,CAAC,GAAG,EAAE,GAAG,CAAC,IAAI,MAAM,CAAC,OAAO,CAAC,MAAM,CAAC,UAAU,IAAI,EAAE,CAAC,EAAE,CAAC;gBACjE,IAAI,GAAG,CAAC,GAAG,CAAC,KAAK,SAAS,EAAE,CAAC;oBAC3B,SAAS;gBACX,CAAC;gBACD,IAAI,CAAC,KAAK;oBAAE,GAAG,IAAI,GAAG,CAAC;gBACvB,GAAG,IAAI,GAAG,IAAI,CAAC,SAAS,CAAC,GAAG,CAAC,IAAI,SAAS,CAAC,GAAG,EAAE,GAAG,CAAC,GAAG,CAAC,CAAC,EAAE,CAAC;gBAC5D,KAAK,GAAG,KAAK,CAAC;YAChB,CAAC;YACD,OAAO,GAAG,GAAG,GAAG,CAAC;QACnB,CAAC;QACD,KAAK,OAAO,CAAC,CAAC,CAAC;YACb,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,KAAK,CAAC;gBAAE,OAAO,IAAI,CAAC;YACvC,MAAM,IAAI,GAAG,MAAM,CAAC,KAAK,IAAI,EAAE,CAAC;YAChC,OAAO,IAAI,KAAK,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,SAAS,CAAC,IAAI,EAAE,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,CAAC;QAC/D,CAAC;QACD,KAAK,QAAQ;YACX,OAAO,IAAI,CAAC,SAAS,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC;QACvC,KAAK,SAAS,CAAC;QACf,KAAK,QAAQ;YACX,OAAO,MAAM,CAAC,QAAQ,CAAC,KAAe,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,CAAC;QACnE,KAAK,SAAS;YACZ,OAAO,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,OAAO,CAAC;QAClC;YACE,OAAO,IAAI,CAAC,SAAS,CAAC,KAAK,CAAC,CAAC;IACjC,CAAC;AACH,CAAC"}

package/dist/static.d.ts

@@ -0,0 +1,20 @@
+import type { StaticEntry } from "./native.js";
+/** Options for {@link Toki.static}. */
+export interface StaticOptions {
+    /** `Cache-Control` for served files. Default `"public, max-age=3600"`. */
+    cacheControl?: string;
+    /** Index file served for a directory URL, or `false` to disable. Default `"index.html"`. */
+    index?: string | false;
+    /** Skip files larger than this many bytes (they stay in memory). Default 50 MiB. */
+    maxFileBytes?: number;
+    /** Pre-compress compressible files. Default `true`. */
+    compress?: boolean;
+    /** Only compress files at least this many bytes. Default 1024. */
+    compressMinBytes?: number;
+    /** gzip level (0–9). Default 9 (best — computed once at startup). */
+    gzipLevel?: number;
+    /** brotli quality (0–11). Default 11 (best — computed once at startup). */
+    brotliQuality?: number;
+}
+/** Builds static entries for `dir` served under `urlPrefix`; files read into memory once and pre-compressed at startup. */
+export declare function buildStaticEntries(urlPrefix: string, dir: string, options?: StaticOptions): StaticEntry[];

package/dist/static.js

@@ -0,0 +1,105 @@
+import { readdirSync, readFileSync, statSync } from "node:fs";
+import { extname, join, relative, sep } from "node:path";
+import { brotliCompressSync, constants, gzipSync } from "node:zlib";
+const DEFAULTS = {
+    cacheControl: "public, max-age=3600",
+    index: "index.html",
+    maxFileBytes: 50 * 1024 * 1024,
+    compress: true,
+    compressMinBytes: 1024,
+    gzipLevel: 9,
+    brotliQuality: 11,
+};
+// startup compression hint only; actual MIME is resolved natively
+const COMPRESSIBLE_EXTS = new Set([
+    "html",
+    "htm",
+    "css",
+    "js",
+    "mjs",
+    "cjs",
+    "json",
+    "jsonld",
+    "webmanifest",
+    "map",
+    "xml",
+    "xhtml",
+    "xsl",
+    "svg",
+    "svgz",
+    "txt",
+    "md",
+    "markdown",
+    "csv",
+    "ics",
+    "wasm",
+    "atom",
+    "rss",
+]);
+/** Builds static entries for `dir` served under `urlPrefix`; files read into memory once and pre-compressed at startup. */
+export function buildStaticEntries(urlPrefix, dir, options = {}) {
+    const config = { ...DEFAULTS, ...options };
+    const prefix = urlPrefix.endsWith("/") ? urlPrefix.slice(0, -1) : urlPrefix;
+    const entries = [];
+    for (const abs of walk(dir)) {
+        const stats = statSync(abs);
+        if (stats.size > config.maxFileBytes) {
+            continue;
+        }
+        const rel = relative(dir, abs).split(sep).join("/");
+        const url = `${prefix}/${rel}`;
+        const body = readFileSync(abs);
+        const ext = extname(abs).slice(1).toLowerCase();
+        const variants = compressFile(ext, body, config);
+        const entry = {
+            path: url,
+            body,
+            mtimeMs: stats.mtimeMs,
+            cacheControl: config.cacheControl,
+            ...variants,
+        };
+        entries.push(entry);
+        // index file also answers its dir URL, with and without trailing slash
+        if (config.index && abs.endsWith(`${sep}${config.index}`)) {
+            const dirUrl = url.slice(0, url.length - (config.index.length + 1)) || "/";
+            entries.push({ ...entry, path: dirUrl });
+            if (dirUrl !== "/") {
+                entries.push({ ...entry, path: `${dirUrl}/` });
+            }
+        }
+    }
+    return entries;
+}
+// gzip/brotli variants; drop any that don't actually shrink the body
+function compressFile(ext, body, config) {
+    if (!config.compress || !COMPRESSIBLE_EXTS.has(ext) || body.length < config.compressMinBytes) {
+        return {};
+    }
+    const out = {};
+    const gzip = gzipSync(body, { level: config.gzipLevel });
+    if (gzip.length < body.length) {
+        out.gzip = gzip;
+    }
+    const brotli = brotliCompressSync(body, {
+        params: {
+            [constants.BROTLI_PARAM_QUALITY]: config.brotliQuality,
+            [constants.BROTLI_PARAM_SIZE_HINT]: body.length,
+        },
+    });
+    if (brotli.length < body.length) {
+        out.brotli = brotli;
+    }
+    return out;
+}
+function* walk(dir) {
+    for (const item of readdirSync(dir, { withFileTypes: true })) {
+        const abs = join(dir, item.name);
+        if (item.isDirectory()) {
+            yield* walk(abs);
+        }
+        else if (item.isFile()) {
+            yield abs;
+        }
+    }
+}
+//# sourceMappingURL=static.js.map

package/dist/static.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"static.js","sourceRoot":"","sources":["../ts/static.ts"],"names":[],"mappings":"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"}

package/dist/types.d.ts

@@ -0,0 +1,88 @@
+import type { TokiRequest } from "./request.js";
+import type { RouteSchema } from "./schema.js";
+/** Methods toki routes natively. Any token is accepted via {@link Toki.route}. */
+export type RouteMethod = "GET" | "POST" | "PUT" | "PATCH" | "DELETE" | "HEAD" | "OPTIONS";
+/** A plain value a handler may return; it is sent as JSON (validated by the response schema). */
+export type JsonResult = Record<string, unknown> | unknown[] | number | boolean | null;
+/** Handler response; build with {@link reply}. Engine adds the status line, `Content-Length`, `Connection`. */
+export interface TokiResponse {
+    readonly status: number;
+    readonly contentType: string;
+    /** Extra headers beyond `Content-Type`, e.g. `Set-Cookie` or `Location`. */
+    readonly headers: ReadonlyArray<readonly [name: string, value: string]>;
+    /** Text or raw bytes (e.g. an image or a compressed payload). */
+    readonly body: string | Uint8Array;
+}
+/** Bytes (or UTF-8 strings) a streaming response yields over time. */
+export type StreamSource = AsyncIterable<Uint8Array | string> | Iterable<Uint8Array | string>;
+/**
+ * Streaming response (`reply.stream`): head, then each chunk via `Transfer-Encoding: chunked`.
+ * Bypasses response hooks and serialization — no materialized body.
+ */
+export interface StreamResponse {
+    readonly status: number;
+    readonly contentType: string;
+    readonly headers: ReadonlyArray<readonly [name: string, value: string]>;
+    readonly source: StreamSource;
+}
+/** A handler's result: a response, a stream, a string (`reply.text`), or a value sent as JSON. */
+export type HandlerResult = TokiResponse | StreamResponse | string | JsonResult;
+/** A request handler. May be synchronous or `async`. */
+export type Handler = (req: TokiRequest) => HandlerResult | Promise<HandlerResult>;
+/** Per-route options: validation schema and route-scoped hooks. */
+export interface RouteOptions {
+    schema?: RouteSchema;
+    preValidation?: Middleware | Middleware[];
+    preHandler?: Middleware | Middleware[];
+    preSerialization?: SerializationHook | SerializationHook[];
+    /** Arbitrary per-route data, reachable via `req` decorators or hooks. */
+    config?: Record<string, unknown>;
+}
+/** App lifecycle callbacks (`onReady` at listen, `onClose` at shutdown). */
+export type LifecycleHook = () => void | Promise<void>;
+/** Options passed to `register`. `prefix` mounts the plugin's routes under a path. */
+export interface PluginOptions {
+    prefix?: string;
+    [key: string]: unknown;
+}
+/** Pre-handler step. Return a response to short-circuit (skips handler + remaining steps); nothing to continue. */
+export type Middleware = (req: TokiRequest) => HandlerResult | void | Promise<HandlerResult | void>;
+/** Runs after the handler; may replace the response by returning a new one. */
+export type ResponseHook = (req: TokiRequest, res: TokiResponse) => HandlerResult | void | Promise<HandlerResult | void>;
+/** Runs on a plain handler return (not a built `reply`), just before JSON encoding. Returns the payload to serialize. */
+export type SerializationHook = (req: TokiRequest, payload: unknown) => unknown | Promise<unknown>;
+/** Handles an error thrown anywhere in the pipeline. */
+export type ErrorHandler = (req: TokiRequest, error: unknown) => HandlerResult;
+/** Runs when a request exceeds `requestTimeoutMs` (the engine then replies `408`). */
+export type TimeoutHook = (req: TokiRequest) => void | Promise<void>;
+/** Parses a raw request body (by content type) into a value, for `req.parseBody()`. */
+export type BodyParser = (req: TokiRequest, body: Uint8Array) => unknown | Promise<unknown>;
+/** A registered content-type parser: a content-type test and the parser to run. */
+export interface ContentTypeParserEntry {
+    readonly test: (contentType: string) => boolean;
+    readonly parser: BodyParser;
+}
+/** Lifecycle hook points. `preParsing` runs right after `onRequest`; `preValidation`
+ * runs before schema validation; `preSerialization` runs before a plain value is
+ * JSON-encoded; `onSend` runs after `onResponse`, last before the bytes go out;
+ * `onTimeout` runs when a request exceeds `requestTimeoutMs`. */
+export type HookName = "onRequest" | "preParsing" | "preValidation" | "preHandler" | "preSerialization" | "onResponse" | "onSend" | "onTimeout";
+/** Minimal structured logger. */
+export interface Logger {
+    debug(message: string, fields?: Record<string, unknown>): void;
+    info(message: string, fields?: Record<string, unknown>): void;
+    warn(message: string, fields?: Record<string, unknown>): void;
+    error(message: string, fields?: Record<string, unknown>): void;
+    child(bindings: Record<string, unknown>): Logger;
+}
+export type LogLevel = "debug" | "info" | "warn" | "error";
+export interface TokiOptions {
+    /** A {@link Logger}, a level for the built-in console logger, or `false`/omitted for silence. */
+    logger?: Logger | LogLevel | false;
+    /** Reply `408` (and run `onTimeout` hooks) if an async handler runs longer than this (ms). 0/omitted = off. */
+    requestTimeoutMs?: number;
+}
+/** Returned by `listen`; `close()` stops the server. */
+export interface ListenHandle {
+    close(): void;
+}

package/dist/types.js

@@ -0,0 +1,2 @@
+export {};
+//# sourceMappingURL=types.js.map

package/dist/types.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"types.js","sourceRoot":"","sources":["../ts/types.ts"],"names":[],"mappings":""}