@raiyyan/brisk 0.0.0-stage → 0.1.0

package/dist/src/cli/templates/project.d.ts

@@ -0,0 +1,24 @@
+import type { PackageManager } from "../system.ts";
+export declare const PACKAGE = "@raiyyan/brisk";
+export declare const IMPORTS_MARKER = "// @brisk:imports";
+export declare const CONTROLLERS_MARKER = "// @brisk:controllers";
+export declare const REGISTRY = "src/features/index.ts";
+/** What `brisk init` was asked to set up. */
+export interface InitOptions {
+    db: "none" | "sqlite" | "postgres";
+    auth: boolean;
+    docker: boolean;
+    ci: boolean;
+    web: boolean;
+    pm: PackageManager;
+}
+/** Everything a set of options adds to a project. */
+export interface Plan {
+    files: Record<string, string>;
+    dependencies: string[];
+    devDependencies: string[];
+    scripts: Record<string, string>;
+}
+/** Composes the base project with every chosen option. */
+export declare function projectPlan(options: InitOptions): Plan;
+//# sourceMappingURL=project.d.ts.map

package/dist/src/cli/templates/project.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.d.ts","sourceRoot":"","sources":["../../../../src/cli/templates/project.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,cAAc,CAAC;AAKnD,eAAO,MAAM,OAAO,mBAAmB,CAAC;AACxC,eAAO,MAAM,cAAc,sBAAsB,CAAC;AAClD,eAAO,MAAM,kBAAkB,0BAA0B,CAAC;AAC1D,eAAO,MAAM,QAAQ,0BAA0B,CAAC;AAEhD,6CAA6C;AAC7C,MAAM,WAAW,WAAW;IAC1B,EAAE,EAAE,MAAM,GAAG,QAAQ,GAAG,UAAU,CAAC;IACnC,IAAI,EAAE,OAAO,CAAC;IACd,MAAM,EAAE,OAAO,CAAC;IAChB,EAAE,EAAE,OAAO,CAAC;IACZ,GAAG,EAAE,OAAO,CAAC;IACb,EAAE,EAAE,cAAc,CAAC;CACpB;AAED,qDAAqD;AACrD,MAAM,WAAW,IAAI;IACnB,KAAK,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;IAC9B,YAAY,EAAE,MAAM,EAAE,CAAC;IACvB,eAAe,EAAE,MAAM,EAAE,CAAC;IAC1B,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC;CACjC;AAED,0DAA0D;AAC1D,wBAAgB,WAAW,CAAC,OAAO,EAAE,WAAW,GAAG,IAAI,CA+BtD"}

package/dist/src/cli/templates/project.js

@@ -0,0 +1,166 @@
+import { authFiles } from "./auth.js";
+import { databaseFiles } from "./database.js";
+import { dockerFiles } from "./docker.js";
+export const PACKAGE = "@raiyyan/brisk";
+export const IMPORTS_MARKER = "// @brisk:imports";
+export const CONTROLLERS_MARKER = "// @brisk:controllers";
+export const REGISTRY = "src/features/index.ts";
+/** Composes the base project with every chosen option. */
+export function projectPlan(options) {
+    const plan = {
+        files: {
+            "src/env.ts": envTemplate(options),
+            "src/app.ts": appTemplate(options),
+            "src/main.ts": mainTemplate,
+            [REGISTRY]: registryTemplate,
+            ".env.example": envExample(options),
+            "tsconfig.json": tsconfigTemplate,
+            "vitest.config.ts": vitestTemplate(options),
+            ".gitignore": "node_modules\n.env\ncoverage\n*.db\n*.db-*\n",
+        },
+        dependencies: [PACKAGE],
+        devDependencies: ["typescript", "@types/node", "vitest"],
+        scripts: {
+            dev: "node --watch src/main.ts",
+            start: "node src/main.ts",
+            typecheck: "tsc --noEmit",
+            test: "vitest run",
+            brisk: "brisk",
+        },
+    };
+    if (options.db !== "none")
+        merge(plan, databaseFiles(options.db));
+    if (options.auth)
+        merge(plan, authFiles());
+    if (options.docker || options.ci)
+        merge(plan, dockerFiles(options));
+    if (options.web) {
+        plan.files["public/.gitkeep"] = "";
+        plan.dependencies.push("express", "cors", "express-rate-limit");
+        plan.devDependencies.push("@types/express", "@types/cors", "pino-pretty");
+    }
+    return plan;
+}
+function merge(plan, extra) {
+    Object.assign(plan.files, extra.files);
+    plan.dependencies.push(...(extra.dependencies ?? []));
+    plan.devDependencies.push(...(extra.devDependencies ?? []));
+    Object.assign(plan.scripts, extra.scripts);
+}
+function envTemplate({ db, auth, web }) {
+    const lines = [
+        `  NODE_ENV: z.enum(["development", "test", "production"]).default("development"),`,
+        `  PORT: z.coerce.number().int().positive().default(3000),`,
+        `  LOG_LEVEL: z.enum(["fatal", "error", "warn", "info", "debug", "trace", "silent"]).default("info"),`,
+    ];
+    if (db === "sqlite")
+        lines.push(`  DATABASE_PATH: z.string().min(1).default("data.db"),`);
+    if (db === "postgres") {
+        lines.push(`  DATABASE_URL: z.url(),`, `  DATABASE_POOL_SIZE: z.coerce.number().int().positive().default(10),`);
+    }
+    if (auth) {
+        lines.push(`  /** HMAC key for access tokens: 32+ random characters (\`openssl rand -base64 48\`). */`, `  AUTH_SECRET: z.string().min(32),`, `  AUTH_TOKEN_TTL_SECONDS: z.coerce.number().int().positive().default(3600),`);
+    }
+    if (web) {
+        lines.push(`  /** Browser origin allowed to call the API, such as http://localhost:5173. */`, `  WEB_ORIGIN: z.url().default("http://localhost:5173"),`, `  RATE_LIMIT_PER_MINUTE: z.coerce.number().int().positive().default(300),`);
+    }
+    return `import { defineEnv, z } from "${PACKAGE}";
+
+export const env = defineEnv({
+${lines.join("\n")}
+});
+`;
+}
+function envExample({ db, auth, web }) {
+    const lines = ["NODE_ENV=development", "PORT=3000", "LOG_LEVEL=info"];
+    if (db === "sqlite")
+        lines.push("DATABASE_PATH=data.db");
+    if (db === "postgres")
+        lines.push("DATABASE_URL=postgres://app:app@localhost:5432/app");
+    if (auth)
+        lines.push("AUTH_SECRET=replace-with-32-or-more-random-characters");
+    if (web)
+        lines.push("WEB_ORIGIN=http://localhost:5173");
+    return `${lines.join("\n")}\n`;
+}
+function appTemplate({ db, web }) {
+    const imports = [`import { createLogger, defineApp } from "${PACKAGE}";`];
+    if (web) {
+        imports.push(`import cors from "cors";`, `import express from "express";`, `import { rateLimit } from "express-rate-limit";`);
+    }
+    if (db !== "none")
+        imports.push(`import { uniqueViolation } from "./database/errors.ts";`);
+    imports.push(`import { env } from "./env.ts";`, `import { controllers } from "./features/index.ts";`);
+    const options = [
+        `  prefix: "/api",`,
+        `  controllers,`,
+        `  logger: createLogger({`,
+        `    level: env.NODE_ENV === "test" ? "silent" : env.LOG_LEVEL,`,
+        ...(web ? [`    pretty: env.NODE_ENV === "development",`] : []),
+        `  }),`,
+        `  openapi: { title: "API", version: "0.1.0" },`,
+        `  errors: {`,
+        ...(db === "none" ? [] : [`    mappers: [uniqueViolation],`]),
+        `    exposeInternal: env.NODE_ENV === "development",`,
+        `  },`,
+    ];
+    if (web) {
+        options.push(`  configureExpress: (expressApp) => {`, `    expressApp.use(cors({ origin: env.WEB_ORIGIN, credentials: true }));`, `    // Behind a proxy, set http: { trustProxy } so the limit applies per client, not per proxy.`, `    expressApp.use(rateLimit({ windowMs: 60_000, limit: env.RATE_LIMIT_PER_MINUTE, standardHeaders: "draft-8", legacyHeaders: false }));`, `    expressApp.use("/static", express.static("public", { maxAge: "1h" }));`, `  },`);
+    }
+    return `${imports.join("\n")}
+
+export const app = defineApp({
+${options.join("\n")}
+});
+
+/** The API's type, for a frontend's typed client: \`createClient<Api>(manifest, { baseUrl })\`. */
+export type Api = typeof app;
+`;
+}
+const mainTemplate = `import { app } from "./app.ts";
+import { env } from "./env.ts";
+
+await app.listen(env.PORT);
+`;
+const registryTemplate = `${IMPORTS_MARKER}
+
+/** Every controller by name. The names are the typed client's top level: \`api.users.get(...)\`. */
+export const controllers = {
+  ${CONTROLLERS_MARKER}
+};
+`;
+const tsconfigTemplate = `${JSON.stringify({
+    compilerOptions: {
+        target: "es2024",
+        module: "nodenext",
+        moduleResolution: "nodenext",
+        strict: true,
+        exactOptionalPropertyTypes: true,
+        noUncheckedIndexedAccess: true,
+        noEmit: true,
+        allowImportingTsExtensions: true,
+        verbatimModuleSyntax: true,
+        erasableSyntaxOnly: true,
+        skipLibCheck: true,
+        types: ["node"],
+    },
+    include: ["src", "test", "vitest.config.ts"],
+}, null, 2)}\n`;
+function vitestTemplate({ db, auth }) {
+    const env = [`NODE_ENV: "test"`];
+    if (db === "sqlite")
+        env.push(`DATABASE_PATH: ":memory:"`);
+    if (db === "postgres")
+        env.push(`DATABASE_URL: "postgres://app:app@localhost:5432/app_test"`);
+    if (auth)
+        env.push(`AUTH_SECRET: "test-secret-that-is-at-least-32-characters-long"`);
+    return `import { defineConfig } from "vitest/config";
+
+export default defineConfig({
+  test: {
+    env: { ${env.join(", ")} },
+  },
+});
+`;
+}
+//# sourceMappingURL=project.js.map

package/dist/src/cli/templates/project.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"project.js","sourceRoot":"","sources":["../../../../src/cli/templates/project.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,MAAM,WAAW,CAAC;AACtC,OAAO,EAAE,aAAa,EAAE,MAAM,eAAe,CAAC;AAC9C,OAAO,EAAE,WAAW,EAAE,MAAM,aAAa,CAAC;AAE1C,MAAM,CAAC,MAAM,OAAO,GAAG,gBAAgB,CAAC;AACxC,MAAM,CAAC,MAAM,cAAc,GAAG,mBAAmB,CAAC;AAClD,MAAM,CAAC,MAAM,kBAAkB,GAAG,uBAAuB,CAAC;AAC1D,MAAM,CAAC,MAAM,QAAQ,GAAG,uBAAuB,CAAC;AAoBhD,0DAA0D;AAC1D,MAAM,UAAU,WAAW,CAAC,OAAoB;IAC9C,MAAM,IAAI,GAAS;QACjB,KAAK,EAAE;YACL,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC;YAClC,YAAY,EAAE,WAAW,CAAC,OAAO,CAAC;YAClC,aAAa,EAAE,YAAY;YAC3B,CAAC,QAAQ,CAAC,EAAE,gBAAgB;YAC5B,cAAc,EAAE,UAAU,CAAC,OAAO,CAAC;YACnC,eAAe,EAAE,gBAAgB;YACjC,kBAAkB,EAAE,cAAc,CAAC,OAAO,CAAC;YAC3C,YAAY,EAAE,8CAA8C;SAC7D;QACD,YAAY,EAAE,CAAC,OAAO,CAAC;QACvB,eAAe,EAAE,CAAC,YAAY,EAAE,aAAa,EAAE,QAAQ,CAAC;QACxD,OAAO,EAAE;YACP,GAAG,EAAE,0BAA0B;YAC/B,KAAK,EAAE,kBAAkB;YACzB,SAAS,EAAE,cAAc;YACzB,IAAI,EAAE,YAAY;YAClB,KAAK,EAAE,OAAO;SACf;KACF,CAAC;IACF,IAAI,OAAO,CAAC,EAAE,KAAK,MAAM;QAAE,KAAK,CAAC,IAAI,EAAE,aAAa,CAAC,OAAO,CAAC,EAAE,CAAC,CAAC,CAAC;IAClE,IAAI,OAAO,CAAC,IAAI;QAAE,KAAK,CAAC,IAAI,EAAE,SAAS,EAAE,CAAC,CAAC;IAC3C,IAAI,OAAO,CAAC,MAAM,IAAI,OAAO,CAAC,EAAE;QAAE,KAAK,CAAC,IAAI,EAAE,WAAW,CAAC,OAAO,CAAC,CAAC,CAAC;IACpE,IAAI,OAAO,CAAC,GAAG,EAAE,CAAC;QAChB,IAAI,CAAC,KAAK,CAAC,iBAAiB,CAAC,GAAG,EAAE,CAAC;QACnC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,SAAS,EAAE,MAAM,EAAE,oBAAoB,CAAC,CAAC;QAChE,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,gBAAgB,EAAE,aAAa,EAAE,aAAa,CAAC,CAAC;IAC5E,CAAC;IACD,OAAO,IAAI,CAAC;AACd,CAAC;AAED,SAAS,KAAK,CAAC,IAAU,EAAE,KAAoB;IAC7C,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,KAAK,EAAE,KAAK,CAAC,KAAK,CAAC,CAAC;IACvC,IAAI,CAAC,YAAY,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,YAAY,IAAI,EAAE,CAAC,CAAC,CAAC;IACtD,IAAI,CAAC,eAAe,CAAC,IAAI,CAAC,GAAG,CAAC,KAAK,CAAC,eAAe,IAAI,EAAE,CAAC,CAAC,CAAC;IAC5D,MAAM,CAAC,MAAM,CAAC,IAAI,CAAC,OAAO,EAAE,KAAK,CAAC,OAAO,CAAC,CAAC;AAC7C,CAAC;AAED,SAAS,WAAW,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAe;IACjD,MAAM,KAAK,GAAG;QACZ,mFAAmF;QACnF,2DAA2D;QAC3D,sGAAsG;KACvG,CAAC;IACF,IAAI,EAAE,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,wDAAwD,CAAC,CAAC;IAC1F,IAAI,EAAE,KAAK,UAAU,EAAE,CAAC;QACtB,KAAK,CAAC,IAAI,CACR,0BAA0B,EAC1B,uEAAuE,CACxE,CAAC;IACJ,CAAC;IACD,IAAI,IAAI,EAAE,CAAC;QACT,KAAK,CAAC,IAAI,CACR,2FAA2F,EAC3F,oCAAoC,EACpC,6EAA6E,CAC9E,CAAC;IACJ,CAAC;IACD,IAAI,GAAG,EAAE,CAAC;QACR,KAAK,CAAC,IAAI,CACR,iFAAiF,EACjF,yDAAyD,EACzD,2EAA2E,CAC5E,CAAC;IACJ,CAAC;IACD,OAAO,iCAAiC,OAAO;;;EAG/C,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC;;CAEjB,CAAC;AACF,CAAC;AAED,SAAS,UAAU,CAAC,EAAE,EAAE,EAAE,IAAI,EAAE,GAAG,EAAe;IAChD,MAAM,KAAK,GAAG,CAAC,sBAAsB,EAAE,WAAW,EAAE,gBAAgB,CAAC,CAAC;IACtE,IAAI,EAAE,KAAK,QAAQ;QAAE,KAAK,CAAC,IAAI,CAAC,uBAAuB,CAAC,CAAC;IACzD,IAAI,EAAE,KAAK,UAAU;QAAE,KAAK,CAAC,IAAI,CAAC,oDAAoD,CAAC,CAAC;IACxF,IAAI,IAAI;QAAE,KAAK,CAAC,IAAI,CAAC,uDAAuD,CAAC,CAAC;IAC9E,IAAI,GAAG;QAAE,KAAK,CAAC,IAAI,CAAC,kCAAkC,CAAC,CAAC;IACxD,OAAO,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,CAAC,IAAI,CAAC;AACjC,CAAC;AAED,SAAS,WAAW,CAAC,EAAE,EAAE,EAAE,GAAG,EAAe;IAC3C,MAAM,OAAO,GAAG,CAAC,4CAA4C,OAAO,IAAI,CAAC,CAAC;IAC1E,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CACV,0BAA0B,EAC1B,gCAAgC,EAChC,iDAAiD,CAClD,CAAC;IACJ,CAAC;IACD,IAAI,EAAE,KAAK,MAAM;QAAE,OAAO,CAAC,IAAI,CAAC,yDAAyD,CAAC,CAAC;IAC3F,OAAO,CAAC,IAAI,CAAC,iCAAiC,EAAE,oDAAoD,CAAC,CAAC;IAEtG,MAAM,OAAO,GAAG;QACd,mBAAmB;QACnB,gBAAgB;QAChB,0BAA0B;QAC1B,gEAAgE;QAChE,GAAG,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,6CAA6C,CAAC,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/D,OAAO;QACP,gDAAgD;QAChD,aAAa;QACb,GAAG,CAAC,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,EAAE,CAAC,CAAC,CAAC,CAAC,iCAAiC,CAAC,CAAC;QAC7D,qDAAqD;QACrD,MAAM;KACP,CAAC;IACF,IAAI,GAAG,EAAE,CAAC;QACR,OAAO,CAAC,IAAI,CACV,uCAAuC,EACvC,0EAA0E,EAC1E,iGAAiG,EACjG,0IAA0I,EAC1I,4EAA4E,EAC5E,MAAM,CACP,CAAC;IACJ,CAAC;IACD,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;;;EAG5B,OAAO,CAAC,IAAI,CAAC,IAAI,CAAC;;;;;CAKnB,CAAC;AACF,CAAC;AAED,MAAM,YAAY,GAAG;;;;CAIpB,CAAC;AAEF,MAAM,gBAAgB,GAAG,GAAG,cAAc;;;;IAItC,kBAAkB;;CAErB,CAAC;AAEF,MAAM,gBAAgB,GAAG,GAAG,IAAI,CAAC,SAAS,CACxC;IACE,eAAe,EAAE;QACf,MAAM,EAAE,QAAQ;QAChB,MAAM,EAAE,UAAU;QAClB,gBAAgB,EAAE,UAAU;QAC5B,MAAM,EAAE,IAAI;QACZ,0BAA0B,EAAE,IAAI;QAChC,wBAAwB,EAAE,IAAI;QAC9B,MAAM,EAAE,IAAI;QACZ,0BAA0B,EAAE,IAAI;QAChC,oBAAoB,EAAE,IAAI;QAC1B,kBAAkB,EAAE,IAAI;QACxB,YAAY,EAAE,IAAI;QAClB,KAAK,EAAE,CAAC,MAAM,CAAC;KAChB;IACD,OAAO,EAAE,CAAC,KAAK,EAAE,MAAM,EAAE,kBAAkB,CAAC;CAC7C,EACD,IAAI,EACJ,CAAC,CACF,IAAI,CAAC;AAEN,SAAS,cAAc,CAAC,EAAE,EAAE,EAAE,IAAI,EAAe;IAC/C,MAAM,GAAG,GAAG,CAAC,kBAAkB,CAAC,CAAC;IACjC,IAAI,EAAE,KAAK,QAAQ;QAAE,GAAG,CAAC,IAAI,CAAC,2BAA2B,CAAC,CAAC;IAC3D,IAAI,EAAE,KAAK,UAAU;QAAE,GAAG,CAAC,IAAI,CAAC,4DAA4D,CAAC,CAAC;IAC9F,IAAI,IAAI;QAAE,GAAG,CAAC,IAAI,CAAC,gEAAgE,CAAC,CAAC;IACrF,OAAO;;;;aAII,GAAG,CAAC,IAAI,CAAC,IAAI,CAAC;;;CAG1B,CAAC;AACF,CAAC"}

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;AA0C9F,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,143 @@
+/**
+ * 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(/\/+$/, "");
+    return async (input = {}, init = {}) => {
+        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 hasBody = input.body !== undefined;
+        if (hasBody && !headers.has("content-type"))
+            headers.set("content-type", "application/json");
+        const res = await send(base + toPath(path, input.params ?? {}) + toQuery(input.query), {
+            ...init,
+            method,
+            headers,
+            body: hasBody ? JSON.stringify(input.body) : null,
+        });
+        if (!res.ok)
+            throw new ApiError(res.status, await readBody(res));
+        if (!isJson(res))
+            return res.status === 204 ? undefined : res;
+        return readBody(res);
+    };
+}
+/** 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 } 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,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"}

package/dist/src/config/logger.js

@@ -0,0 +1,31 @@
+import { pino } from "pino";
+import { defineToken } from "../di/container.js";
+/**
+ * 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 const Logger = /* @__PURE__ */ defineToken("Logger", () => pino({ level: "silent" }));
+/**
+ * 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 function createLogger({ level = "info", pretty = false } = {}) {
+    return pretty
+        ? pino({
+            level,
+            transport: { target: "pino-pretty", options: { colorize: true, translateTime: "HH:MM:ss" } },
+        })
+        : pino({ level });
+}
+//# sourceMappingURL=logger.js.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"logger.js","sourceRoot":"","sources":["../../../src/config/logger.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,IAAI,EAA6B,MAAM,MAAM,CAAC;AACvD,OAAO,EAAE,WAAW,EAAE,MAAM,oBAAoB,CAAC;AAKjD;;;;;;;;;;GAUG;AACH,MAAM,CAAC,MAAM,MAAM,GAAG,eAAe,CAAC,WAAW,CAAS,QAAQ,EAAE,GAAG,EAAE,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,QAAQ,EAAE,CAAC,CAAC,CAAC;AAUrG;;;;;;;GAOG;AACH,MAAM,UAAU,YAAY,CAAC,EAAE,KAAK,GAAG,MAAM,EAAE,MAAM,GAAG,KAAK,EAAE,GAAkB,EAAE;IACjF,OAAO,MAAM;QACX,CAAC,CAAC,IAAI,CAAC;YACH,KAAK;YACL,SAAS,EAAE,EAAE,MAAM,EAAE,aAAa,EAAE,OAAO,EAAE,EAAE,QAAQ,EAAE,IAAI,EAAE,aAAa,EAAE,UAAU,EAAE,EAAE;SAC7F,CAAC;QACJ,CAAC,CAAC,IAAI,CAAC,EAAE,KAAK,EAAE,CAAC,CAAC;AACtB,CAAC"}