@raiyyan/brisk 0.0.0-stage → 0.2.0

package/dist/src/cli/render.js

@@ -0,0 +1,101 @@
+import { existsSync, readdirSync, readFileSync, writeFileSync } from "node:fs";
+import { join, relative } from "node:path";
+import { CliError, write } from "./system.js";
+/** A template file whose text is added to an existing file: `<target>.<marker>.insert`. */
+const INSERT = /^(?<target>.+)\.(?<marker>[\w-]+)\.insert$/;
+/**
+ * Renders the project's own `templates/<kind>/` for `names`. Every file is copied with its path and contents
+ * rendered; `{{kebab}}`, `{{camel}}`, `{{pascal}}`, `{{snake}}`, `{{entity}}` and `{{entityCamel}}` are the
+ * tokens. A file named `<target>.<marker>.insert` is not copied: its text goes into the existing `<target>`,
+ * right before the line that holds `@brisk:<marker>`.
+ *
+ * Everything is checked before anything is written: an unknown token, a file that already exists, or a
+ * missing marker stops the run with nothing changed.
+ */
+export function renderTemplates(root, kind, names) {
+    const plan = planTemplates(join(root, "templates", kind), names, root);
+    for (const path of plan.files.keys()) {
+        if (existsSync(join(root, path)))
+            throw new CliError(`${path} already exists`);
+    }
+    const updates = new Map();
+    for (const { target, marker, text } of plan.inserts) {
+        const path = join(root, target);
+        if (!existsSync(path))
+            throw new CliError(`templates/${kind} adds to ${target}, which does not exist`);
+        updates.set(target, insertBefore(updates.get(target) ?? readFileSync(path, "utf8"), marker, text, target));
+    }
+    for (const [path, content] of plan.files)
+        write(join(root, path), content);
+    for (const [path, content] of updates)
+        writeFileSync(join(root, path), content);
+    return {
+        created: [...plan.files.keys()].map((path) => join(root, path)),
+        updated: [...updates.keys()].map((path) => join(root, path)),
+    };
+}
+/** Renders a template folder in memory: the files it creates and the text it adds, nothing written. */
+export function planTemplates(dir, names, root) {
+    if (!existsSync(dir)) {
+        throw new CliError(`This project has no ${relative(root, dir)}/ to generate from.${listKinds(root)} ` +
+            "Templates are files in your project: copy them from a starter at " +
+            "https://github.com/MohammadRaiyyan/brisk/tree/main/starters, or write your own.");
+    }
+    const tokens = tokensFor(names);
+    const plan = { files: new Map(), inserts: [] };
+    for (const source of walk(dir)) {
+        const path = render(relative(dir, source), tokens, source);
+        const content = render(readFileSync(source, "utf8"), tokens, source);
+        const insert = INSERT.exec(path)?.groups;
+        if (insert?.["target"] && insert["marker"]) {
+            plan.inserts.push({ target: insert["target"], marker: insert["marker"], text: content });
+        }
+        else {
+            plan.files.set(path, content);
+        }
+    }
+    return plan;
+}
+function tokensFor(names) {
+    return {
+        kebab: names.kebab,
+        camel: names.camel,
+        pascal: names.pascal,
+        snake: names.kebab.replaceAll("-", "_"),
+        entity: names.entity,
+        entityCamel: names.entity.charAt(0).toLowerCase() + names.entity.slice(1),
+    };
+}
+function render(text, tokens, source) {
+    return text.replace(/\{\{\s*(\w+)\s*\}\}/g, (match, name) => {
+        const value = tokens[name];
+        if (value === undefined) {
+            throw new CliError(`Unknown token ${match} in ${source}; known: ${Object.keys(tokens)
+                .map((key) => `{{${key}}}`)
+                .join(" ")}`);
+        }
+        return value;
+    });
+}
+/** Adds `text` on its own lines right before the line holding `@brisk:<marker>`. */
+function insertBefore(source, marker, text, file) {
+    const lines = source.split("\n");
+    const at = lines.findIndex((line) => line.includes(`@brisk:${marker}`));
+    if (at === -1)
+        throw new CliError(`${file} has no line with "@brisk:${marker}" to add to`);
+    lines.splice(at, 0, ...text.replace(/\n$/, "").split("\n"));
+    return lines.join("\n");
+}
+function walk(dir) {
+    return readdirSync(dir, { withFileTypes: true })
+        .toSorted((a, b) => a.name.localeCompare(b.name))
+        .flatMap((entry) => (entry.isDirectory() ? walk(join(dir, entry.name)) : [join(dir, entry.name)]));
+}
+function listKinds(root) {
+    const templates = join(root, "templates");
+    if (!existsSync(templates))
+        return "";
+    const kinds = readdirSync(templates, { withFileTypes: true }).filter((entry) => entry.isDirectory());
+    return kinds.length === 0 ? "" : ` Available: ${kinds.map((entry) => entry.name).join(", ")}.`;
+}
+//# sourceMappingURL=render.js.map

package/dist/src/cli/render.js.map

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

package/dist/src/cli/system.d.ts

@@ -0,0 +1,35 @@
+import { z } from "zod";
+/** The framework's package name, as apps depend on it. */
+export declare const PACKAGE = "@raiyyan/brisk";
+/** An error the CLI reports as a message and exit code 1, without a stack trace. */
+export declare class CliError extends Error {
+}
+/** Where the CLI prints, and how it asks; tests pass their own. */
+export interface CliIo {
+    log(message: string): void;
+    error(message: string): void;
+    /** Asks a question and resolves with the answer; absent when the CLI must not prompt. */
+    ask?: (question: string) => Promise<string>;
+}
+export type PackageManager = "pnpm" | "npm" | "yarn";
+/** The package manager that ran the CLI, else the one whose lockfile is present, else npm. */
+export declare function detectPackageManager(root: string): PackageManager;
+/** Runs a command in `root` with its output shown, as a person would type it. */
+export declare function run(command: readonly string[], root: string): void;
+/** Writes a file, creating its folder. */
+export declare function write(path: string, content: string): string;
+/**
+ * Runs the project's own formatter on the written files, so generated code matches the codebase, and returns
+ * the line to print. A failing formatter is reported, never fatal: the files are already written and valid.
+ */
+export declare function format(root: string, files: readonly string[]): string | undefined;
+export declare const PackageJson: z.ZodObject<{
+    type: z.ZodOptional<z.ZodString>;
+    scripts: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    dependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+    devDependencies: z.ZodOptional<z.ZodRecord<z.ZodString, z.ZodString>>;
+}, z.core.$loose>;
+export type PackageJson = z.infer<typeof PackageJson>;
+/** Reads `package.json`, or an empty one when it does not exist. */
+export declare function readPackageJson(root: string): PackageJson;
+//# sourceMappingURL=system.d.ts.map

package/dist/src/cli/system.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"system.d.ts","sourceRoot":"","sources":["../../../src/cli/system.ts"],"names":[],"mappings":"AAGA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,0DAA0D;AAC1D,eAAO,MAAM,OAAO,mBAAmB,CAAC;AAExC,oFAAoF;AACpF,qBAAa,QAAS,SAAQ,KAAK;CAAG;AAEtC,mEAAmE;AACnE,MAAM,WAAW,KAAK;IACpB,GAAG,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC3B,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,IAAI,CAAC;IAC7B,yFAAyF;IACzF,GAAG,CAAC,EAAE,CAAC,QAAQ,EAAE,MAAM,KAAK,OAAO,CAAC,MAAM,CAAC,CAAC;CAC7C;AAED,MAAM,MAAM,cAAc,GAAG,MAAM,GAAG,KAAK,GAAG,MAAM,CAAC;AAErD,8FAA8F;AAC9F,wBAAgB,oBAAoB,CAAC,IAAI,EAAE,MAAM,GAAG,cAAc,CAOjE;AAED,iFAAiF;AACjF,wBAAgB,GAAG,CAAC,OAAO,EAAE,SAAS,MAAM,EAAE,EAAE,IAAI,EAAE,MAAM,GAAG,IAAI,CAIlE;AAED,0CAA0C;AAC1C,wBAAgB,KAAK,CAAC,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,MAAM,CAI3D;AAQD;;;GAGG;AACH,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,KAAK,EAAE,SAAS,MAAM,EAAE,GAAG,MAAM,GAAG,SAAS,CAejF;AAED,eAAO,MAAM,WAAW;;;;;iBAKtB,CAAC;AAEH,MAAM,MAAM,WAAW,GAAG,CAAC,CAAC,KAAK,CAAC,OAAO,WAAW,CAAC,CAAC;AAEtD,oEAAoE;AACpE,wBAAgB,eAAe,CAAC,IAAI,EAAE,MAAM,GAAG,WAAW,CAQzD"}

package/dist/src/cli/system.js

@@ -0,0 +1,81 @@
+import { execFileSync } from "node:child_process";
+import { existsSync, mkdirSync, readFileSync, writeFileSync } from "node:fs";
+import { dirname, join } from "node:path";
+import { z } from "zod";
+/** The framework's package name, as apps depend on it. */
+export const PACKAGE = "@raiyyan/brisk";
+/** An error the CLI reports as a message and exit code 1, without a stack trace. */
+export class CliError extends Error {
+}
+/** The package manager that ran the CLI, else the one whose lockfile is present, else npm. */
+export function detectPackageManager(root) {
+    const agent = process.env["npm_config_user_agent"] ?? "";
+    if (agent.startsWith("pnpm"))
+        return "pnpm";
+    if (agent.startsWith("yarn"))
+        return "yarn";
+    if (existsSync(join(root, "pnpm-lock.yaml")))
+        return "pnpm";
+    if (existsSync(join(root, "yarn.lock")))
+        return "yarn";
+    return "npm";
+}
+/** Runs a command in `root` with its output shown, as a person would type it. */
+export function run(command, root) {
+    const [bin, ...args] = command;
+    if (!bin)
+        return;
+    execFileSync(bin, args, { cwd: root, stdio: "inherit" });
+}
+/** Writes a file, creating its folder. */
+export function write(path, content) {
+    mkdirSync(dirname(path), { recursive: true });
+    writeFileSync(path, content);
+    return path;
+}
+const FORMATTERS = [
+    { bin: "oxfmt", args: [] },
+    { bin: "prettier", args: ["--write", "--log-level", "silent"] },
+    { bin: "biome", args: ["format", "--write"] },
+];
+/**
+ * Runs the project's own formatter on the written files, so generated code matches the codebase, and returns
+ * the line to print. A failing formatter is reported, never fatal: the files are already written and valid.
+ */
+export function format(root, files) {
+    for (let dir = root;; dir = dirname(dir)) {
+        for (const { bin, args } of FORMATTERS) {
+            const path = join(dir, "node_modules/.bin", bin);
+            if (existsSync(path)) {
+                try {
+                    execFileSync(path, [...args, ...files], { cwd: root, stdio: "ignore" });
+                    return `formatted with ${bin}`;
+                }
+                catch {
+                    return `${bin} failed on the generated files; run it yourself`;
+                }
+            }
+        }
+        if (dirname(dir) === dir)
+            return undefined;
+    }
+}
+export const PackageJson = z.looseObject({
+    type: z.string().optional(),
+    scripts: z.record(z.string(), z.string()).optional(),
+    dependencies: z.record(z.string(), z.string()).optional(),
+    devDependencies: z.record(z.string(), z.string()).optional(),
+});
+/** Reads `package.json`, or an empty one when it does not exist. */
+export function readPackageJson(root) {
+    const path = join(root, "package.json");
+    if (!existsSync(path))
+        return {};
+    try {
+        return PackageJson.parse(JSON.parse(readFileSync(path, "utf8")));
+    }
+    catch {
+        throw new CliError("package.json is not valid JSON; fix it and run the command again.");
+    }
+}
+//# sourceMappingURL=system.js.map

package/dist/src/cli/system.js.map

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

package/dist/src/client/client.d.ts

@@ -0,0 +1,64 @@
+import type { ApiOf, Client, Manifest } from "../http/routes.ts";
+/** Options for {@link createClient}. */
+export interface ClientOptions {
+    /** Origin of the API, such as `https://api.example.com` or `http://127.0.0.1:3000`. */
+    baseUrl: string;
+    /** Headers for every request, such as `authorization`; a function is called per request. */
+    headers?: Record<string, string> | (() => Record<string, string> | Promise<Record<string, string>>);
+    /** The fetch to use. Default: the global `fetch`. */
+    fetch?: typeof fetch;
+}
+/** An app as the client sees it: its route manifest, plus its types. */
+interface AppLike {
+    readonly manifest: Manifest;
+    readonly "~controllers"?: unknown;
+}
+/**
+ * A non-2xx response. Carries brisk's error body (`code`, `message`, `details`, `requestId`) when the server
+ * sent one, so callers branch on `error.code` instead of parsing messages.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await api.users.create({ body });
+ * } catch (error) {
+ *   if (error instanceof ApiError && error.code === "EMAIL_TAKEN") showEmailTaken();
+ *   else throw error;
+ * }
+ * ```
+ */
+export declare class ApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    readonly details: unknown;
+    readonly requestId: string | undefined;
+    /** The parsed response body, whatever its shape. */
+    readonly body: unknown;
+    constructor(status: number, body: unknown);
+}
+/**
+ * Creates a typed client for an app's routes: `api.users.get({ params: { id } })` resolves to the route's output
+ * and rejects with {@link ApiError} on a non-2xx response.
+ *
+ * In Node, pass the app or a running instance. In a browser, pass the manifest that `brisk client` writes,
+ * with the app's type, so the server's code never reaches the bundle.
+ *
+ * @example
+ * ```ts
+ * // web/src/api.ts
+ * import { createClient } from "@raiyyan/brisk/client";
+ * import type { Api } from "../../server/src/app.ts";
+ * import { manifest } from "./api.manifest.ts"; // generated by `brisk client`
+ *
+ * export const api = createClient<Api>(manifest, { baseUrl: import.meta.env.VITE_API_URL });
+ * const user = await api.users.get({ params: { id } });
+ * ```
+ */
+export declare function createClient<A extends AppLike>(app: A, options: ClientOptions): Client<ApiOf<A>>;
+export declare function createClient<T>(manifest: Manifest, options: ClientOptions): Client<ApiOf<T>>;
+/** Fills `:name`, `*name` and optional `{...}` groups from `params`, encoding every segment. */
+export declare function toPath(path: string, params: Record<string, unknown>): string;
+/** `{ tag: ["a", "b"], page: 2 }` gives `?tag=a&tag=b&page=2`; `undefined` and `null` are left out. */
+export declare function toQuery(query: Record<string, unknown> | undefined): string;
+export {};
+//# sourceMappingURL=client.d.ts.map

package/dist/src/client/client.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"client.d.ts","sourceRoot":"","sources":["../../../src/client/client.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,KAAK,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,mBAAmB,CAAC;AAEjE,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,uFAAuF;IACvF,OAAO,EAAE,MAAM,CAAC;IAChB,4FAA4F;IAC5F,OAAO,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,CAAC,MAAM,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,CAAC;IACpG,qDAAqD;IACrD,KAAK,CAAC,EAAE,OAAO,KAAK,CAAC;CACtB;AAED,wEAAwE;AACxE,UAAU,OAAO;IACf,QAAQ,CAAC,QAAQ,EAAE,QAAQ,CAAC;IAC5B,QAAQ,CAAC,cAAc,CAAC,EAAE,OAAO,CAAC;CACnC;AAED;;;;;;;;;;;;;GAaG;AACH,qBAAa,QAAS,SAAQ,KAAK;IACjC,QAAQ,CAAC,MAAM,EAAE,MAAM,CAAC;IACxB,QAAQ,CAAC,IAAI,EAAE,MAAM,CAAC;IACtB,QAAQ,CAAC,OAAO,EAAE,OAAO,CAAC;IAC1B,QAAQ,CAAC,SAAS,EAAE,MAAM,GAAG,SAAS,CAAC;IACvC,oDAAoD;IACpD,QAAQ,CAAC,IAAI,EAAE,OAAO,CAAC;IAEvB,YAAY,MAAM,EAAE,MAAM,EAAE,IAAI,EAAE,OAAO,EASxC;CACF;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,YAAY,CAAC,CAAC,SAAS,OAAO,EAAE,GAAG,EAAE,CAAC,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAClG,wBAAgB,YAAY,CAAC,CAAC,EAAE,QAAQ,EAAE,QAAQ,EAAE,OAAO,EAAE,aAAa,GAAG,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,CAAC;AAuE9F,gGAAgG;AAChG,wBAAgB,MAAM,CAAC,IAAI,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,MAAM,CAY5E;AAED,uGAAuG;AACvG,wBAAgB,OAAO,CAAC,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,SAAS,GAAG,MAAM,CAU1E"}

package/dist/src/client/client.js

@@ -0,0 +1,170 @@
+/**
+ * A non-2xx response. Carries brisk's error body (`code`, `message`, `details`, `requestId`) when the server
+ * sent one, so callers branch on `error.code` instead of parsing messages.
+ *
+ * @example
+ * ```ts
+ * try {
+ *   await api.users.create({ body });
+ * } catch (error) {
+ *   if (error instanceof ApiError && error.code === "EMAIL_TAKEN") showEmailTaken();
+ *   else throw error;
+ * }
+ * ```
+ */
+export class ApiError extends Error {
+    status;
+    code;
+    details;
+    requestId;
+    /** The parsed response body, whatever its shape. */
+    body;
+    constructor(status, body) {
+        const error = errorBody(body);
+        super(error?.message ?? `Request failed with status ${status}`);
+        this.name = "ApiError";
+        this.status = status;
+        this.code = error?.code ?? "HTTP_ERROR";
+        this.details = error?.details;
+        this.requestId = error?.requestId;
+        this.body = body;
+    }
+}
+export function createClient(source, options) {
+    const manifest = isAppLike(source) ? source.manifest : source;
+    return build(manifest, options);
+}
+function build(manifest, options) {
+    const client = {};
+    for (const [name, entry] of Object.entries(manifest)) {
+        client[name] = isEndpoint(entry) ? endpoint(entry[0], entry[1], options) : build(entry, options);
+    }
+    return Object.freeze(client);
+}
+function endpoint(method, path, options) {
+    const send = options.fetch ?? fetch;
+    const base = options.baseUrl.replace(/\/+$/, "");
+    const request = async (input, init, raw) => {
+        const shared = typeof options.headers === "function" ? await options.headers() : options.headers;
+        const headers = new Headers(init.headers);
+        for (const [name, value] of Object.entries({ ...shared, ...input.headers }))
+            headers.set(name, value);
+        const body = encode(input.body, raw);
+        if (typeof body === "string" && !raw && !headers.has("content-type")) {
+            headers.set("content-type", "application/json");
+        }
+        return send(base + toPath(path, input.params ?? {}) + toQuery(input.query), {
+            ...init,
+            method,
+            headers,
+            body,
+        });
+    };
+    const call = async (input = {}, init = {}) => {
+        const res = await request(input, init, false);
+        if (!res.ok)
+            throw new ApiError(res.status, await readBody(res));
+        if (!isJson(res))
+            return res.status === 204 ? undefined : res;
+        return readBody(res);
+    };
+    return Object.assign(call, {
+        raw: (input = {}, init = {}) => request(input, init, true),
+    });
+}
+/**
+ * The body as `fetch` takes it. Files, forms, bytes and streams go as they are, so the browser sets their
+ * content type and multipart boundary; a string goes as it is only through `raw`; everything else is JSON.
+ */
+function encode(body, raw) {
+    if (body === undefined)
+        return null;
+    if (body instanceof FormData ||
+        body instanceof Blob ||
+        body instanceof URLSearchParams ||
+        body instanceof ArrayBuffer ||
+        ArrayBuffer.isView(body) ||
+        body instanceof ReadableStream) {
+        // oxlint-disable-next-line typescript/no-unsafe-type-assertion -- each of these is a fetch request body
+        return body;
+    }
+    if (raw && typeof body === "string")
+        return body;
+    return JSON.stringify(body);
+}
+/** Fills `:name`, `*name` and optional `{...}` groups from `params`, encoding every segment. */
+export function toPath(path, params) {
+    const filled = path.replace(/\{([^{}]*)\}/g, (_group, inner) => {
+        const names = [...inner.matchAll(/[:*]([\w$]+)/g)].map((match) => match[1] ?? "");
+        return names.every((name) => params[name] !== undefined) ? inner : "";
+    });
+    return filled.replace(/([:*])([\w$]+)/g, (_match, kind, name) => {
+        const value = params[name];
+        if (value === undefined)
+            throw new TypeError(`Missing path parameter "${name}" for ${path}`);
+        if (kind === "*" && Array.isArray(value))
+            return value.map((part) => encodeURIComponent(stringify(part))).join("/");
+        return encodeURIComponent(stringify(value));
+    });
+}
+/** `{ tag: ["a", "b"], page: 2 }` gives `?tag=a&tag=b&page=2`; `undefined` and `null` are left out. */
+export function toQuery(query) {
+    if (!query)
+        return "";
+    const search = new URLSearchParams();
+    for (const [key, value] of Object.entries(query)) {
+        for (const item of Array.isArray(value) ? value : [value]) {
+            if (item !== undefined && item !== null)
+                search.append(key, stringify(item));
+        }
+    }
+    const text = search.toString();
+    return text === "" ? "" : `?${text}`;
+}
+/** A path or query value as text: primitives as themselves, a `Date` as ISO, anything else as JSON. */
+function stringify(value) {
+    if (typeof value === "string")
+        return value;
+    if (typeof value === "number" || typeof value === "boolean" || typeof value === "bigint")
+        return value.toString();
+    if (value instanceof Date)
+        return value.toISOString();
+    return JSON.stringify(value);
+}
+const JSON_TYPE = /^application\/(?:[\w.-]+\+)?json\b/i;
+function isJson(res) {
+    return JSON_TYPE.test(res.headers.get("content-type") ?? "");
+}
+async function readBody(res) {
+    const text = await res.text();
+    if (text === "")
+        return undefined;
+    if (!isJson(res))
+        return text;
+    const parsed = JSON.parse(text);
+    return parsed;
+}
+function errorBody(body) {
+    if (typeof body !== "object" || body === null || !("error" in body))
+        return undefined;
+    const { error } = body;
+    if (typeof error !== "object" || error === null)
+        return undefined;
+    if (!("code" in error) || typeof error.code !== "string")
+        return undefined;
+    if (!("message" in error) || typeof error.message !== "string")
+        return undefined;
+    return {
+        code: error.code,
+        message: error.message,
+        details: "details" in error ? error.details : undefined,
+        requestId: "requestId" in error && typeof error.requestId === "string" ? error.requestId : undefined,
+    };
+}
+function isAppLike(source) {
+    return "manifest" in source && typeof source.manifest === "object" && !Array.isArray(source.manifest);
+}
+function isEndpoint(entry) {
+    return Array.isArray(entry);
+}
+//# sourceMappingURL=client.js.map

package/dist/src/client/client.js.map

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

package/dist/src/client/index.d.ts

@@ -0,0 +1,8 @@
+/**
+ * The typed client. Safe in browsers: it imports no server code, only types.
+ *
+ * @module
+ */
+export { ApiError, createClient, type ClientOptions } from "./client.ts";
+export type { ApiOf, Call, Client, Jsonify, Manifest, RawBody } from "../http/routes.ts";
+//# sourceMappingURL=index.d.ts.map

package/dist/src/client/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAE,KAAK,aAAa,EAAE,MAAM,aAAa,CAAC;AACzE,YAAY,EAAE,KAAK,EAAE,IAAI,EAAE,MAAM,EAAE,OAAO,EAAE,QAAQ,EAAE,OAAO,EAAE,MAAM,mBAAmB,CAAC"}

package/dist/src/client/index.js

@@ -0,0 +1,7 @@
+/**
+ * The typed client. Safe in browsers: it imports no server code, only types.
+ *
+ * @module
+ */
+export { ApiError, createClient } from "./client.js";
+//# sourceMappingURL=index.js.map

package/dist/src/client/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/client/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,OAAO,EAAE,QAAQ,EAAE,YAAY,EAAsB,MAAM,aAAa,CAAC"}

package/dist/src/config/env.d.ts

@@ -0,0 +1,28 @@
+import { z } from "zod";
+/** Options for {@link defineEnv}. */
+export interface DefineEnvOptions {
+    /** Dotenv file loaded into `process.env` when present. Default `.env`. */
+    file?: string;
+    /** An object to validate instead of `process.env`. Failures then throw instead of exiting. */
+    source?: Record<string, string | undefined>;
+}
+/**
+ * Validates the environment once, at import, and returns it as a frozen, typed object. Loads `.env` first when
+ * the file exists. On failure it prints every invalid variable and exits, so the app never starts
+ * half-configured; under `NODE_ENV=test`, or with `source`, it throws instead.
+ *
+ * Variables are strings: use `z.coerce.number()` for numbers and `z.stringbool()` for booleans. Never
+ * `z.coerce.boolean()`, which reads `"false"` as `true`.
+ *
+ * @example
+ * ```ts
+ * export const env = defineEnv({
+ *   PORT: z.coerce.number().default(3000),
+ *   DATABASE_URL: z.url(),
+ *   LOG_LEVEL: z.enum(["debug", "info", "warn"]).default("info"),
+ * });
+ * env.PORT; // number
+ * ```
+ */
+export declare function defineEnv<T extends z.ZodRawShape>(shape: T, options?: DefineEnvOptions): Readonly<z.output<z.ZodObject<T>>>;
+//# sourceMappingURL=env.d.ts.map

package/dist/src/config/env.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.d.ts","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,qCAAqC;AACrC,MAAM,WAAW,gBAAgB;IAC/B,0EAA0E;IAC1E,IAAI,CAAC,EAAE,MAAM,CAAC;IACd,8FAA8F;IAC9F,MAAM,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,GAAG,SAAS,CAAC,CAAC;CAC7C;AAED;;;;;;;;;;;;;;;;;GAiBG;AACH,wBAAgB,SAAS,CAAC,CAAC,SAAS,CAAC,CAAC,WAAW,EAC/C,KAAK,EAAE,CAAC,EACR,OAAO,GAAE,gBAAqB,GAC7B,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,SAAS,CAAC,CAAC,CAAC,CAAC,CAAC,CAYpC"}

package/dist/src/config/env.js

@@ -0,0 +1,35 @@
+import { existsSync } from "node:fs";
+import { z } from "zod";
+/**
+ * Validates the environment once, at import, and returns it as a frozen, typed object. Loads `.env` first when
+ * the file exists. On failure it prints every invalid variable and exits, so the app never starts
+ * half-configured; under `NODE_ENV=test`, or with `source`, it throws instead.
+ *
+ * Variables are strings: use `z.coerce.number()` for numbers and `z.stringbool()` for booleans. Never
+ * `z.coerce.boolean()`, which reads `"false"` as `true`.
+ *
+ * @example
+ * ```ts
+ * export const env = defineEnv({
+ *   PORT: z.coerce.number().default(3000),
+ *   DATABASE_URL: z.url(),
+ *   LOG_LEVEL: z.enum(["debug", "info", "warn"]).default("info"),
+ * });
+ * env.PORT; // number
+ * ```
+ */
+export function defineEnv(shape, options = {}) {
+    const file = options.file ?? ".env";
+    if (!options.source && existsSync(file))
+        process.loadEnvFile(file);
+    const result = z.object(shape).safeParse(options.source ?? process.env);
+    if (result.success)
+        return Object.freeze(result.data);
+    const lines = result.error.issues.map((issue) => `  - ${issue.path.join(".")}: ${issue.message}`);
+    const message = `Invalid environment variables:\n${lines.join("\n")}`;
+    if (options.source || process.env["NODE_ENV"] === "test")
+        throw new Error(message);
+    console.error(`\n${message}\n\nCheck your .env file (see .env.example).\n`);
+    return process.exit(1);
+}
+//# sourceMappingURL=env.js.map

package/dist/src/config/env.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"env.js","sourceRoot":"","sources":["../../../src/config/env.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,SAAS,CAAC;AACrC,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAUxB;;;;;;;;;;;;;;;;;GAiBG;AACH,MAAM,UAAU,SAAS,CACvB,KAAQ,EACR,OAAO,GAAqB,EAAE;IAE9B,MAAM,IAAI,GAAG,OAAO,CAAC,IAAI,IAAI,MAAM,CAAC;IACpC,IAAI,CAAC,OAAO,CAAC,MAAM,IAAI,UAAU,CAAC,IAAI,CAAC;QAAE,OAAO,CAAC,WAAW,CAAC,IAAI,CAAC,CAAC;IAEnE,MAAM,MAAM,GAAG,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,CAAC;IACxE,IAAI,MAAM,CAAC,OAAO;QAAE,OAAO,MAAM,CAAC,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,CAAC;IAEtD,MAAM,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,GAAG,CAAC,CAAC,KAAK,EAAE,EAAE,CAAC,OAAO,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,KAAK,CAAC,OAAO,EAAE,CAAC,CAAC;IAClG,MAAM,OAAO,GAAG,mCAAmC,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,EAAE,CAAC;IACtE,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,GAAG,CAAC,UAAU,CAAC,KAAK,MAAM;QAAE,MAAM,IAAI,KAAK,CAAC,OAAO,CAAC,CAAC;IACnF,OAAO,CAAC,KAAK,CAAC,KAAK,OAAO,gDAAgD,CAAC,CAAC;IAC5E,OAAO,OAAO,CAAC,IAAI,CAAC,CAAC,CAAC,CAAC;AACzB,CAAC"}

package/dist/src/config/logger.d.ts

@@ -0,0 +1,32 @@
+import { type Logger as PinoLogger } from "pino";
+/** A pino logger. In a handler, prefer `ctx.log`: it adds the request id to every line. */
+export type Logger = PinoLogger;
+/**
+ * The app's logger, as a token to inject. An app provides its `logger` option. A container you build yourself,
+ * as in a unit test, gets a silent logger, so services that log need no setup there.
+ *
+ * @example
+ * ```ts
+ * export class Mailer {
+ *   readonly #log = inject(Logger);
+ * }
+ * ```
+ */
+export declare const Logger: import("../di/container.ts").InjectionToken<Logger>;
+/** Options for {@link createLogger}. */
+export interface LoggerOptions {
+    /** The lowest level written: `trace`, `debug`, `info`, `warn`, `error`, `fatal` or `silent`. Default `info`. */
+    level?: string;
+    /** Colored, human-readable lines for local development. Needs the optional `pino-pretty` package. */
+    pretty?: boolean;
+}
+/**
+ * Creates a pino logger for an app's `logger` option: JSON lines, or pretty output in development.
+ *
+ * @example
+ * ```ts
+ * defineApp({ logger: createLogger({ level: env.LOG_LEVEL, pretty: env.NODE_ENV === "development" }) });
+ * ```
+ */
+export declare function createLogger({ level, pretty }?: LoggerOptions): Logger;
+//# sourceMappingURL=logger.d.ts.map

package/dist/src/config/logger.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"logger.d.ts","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAQ,KAAK,MAAM,IAAI,UAAU,EAAE,MAAM,MAAM,CAAC;AAGvD,2FAA2F;AAC3F,MAAM,MAAM,MAAM,GAAG,UAAU,CAAC;AAEhC;;;;;;;;;;GAUG;AACH,eAAO,MAAM,MAAM,qDAAiF,CAAC;AAErG,wCAAwC;AACxC,MAAM,WAAW,aAAa;IAC5B,gHAAgH;IAChH,KAAK,CAAC,EAAE,MAAM,CAAC;IACf,qGAAqG;IACrG,MAAM,CAAC,EAAE,OAAO,CAAC;CAClB;AAED;;;;;;;GAOG;AACH,wBAAgB,YAAY,CAAC,EAAE,KAAc,EAAE,MAAc,EAAE,GAAE,aAAkB,GAAG,MAAM,CAO3F"}