@senrijs/senri 0.1.0 → 0.2.0

package/dist/src/errors.js

@@ -1,5 +1,3 @@
-import { suggest } from "./dev/suggest.js";
-import { wantsHtml } from "./dev/render.js";
 // status 付きで投げられるエラー。message はそのままクライアントに見せる前提のもの
 export class HttpError extends Error {
     status;
@@ -43,44 +41,28 @@ export async function handleError(err, c, onError) {
         return new Response("500 Internal Server Error", { status: 500 });
     }
 }
-// 本番では、エラーの中身(DB のパスワードなど)や、ルートの一覧がもれないよう固定の文言だけ返す
-// dev: true のときだけ、開発者向けの詳しい情報を足す
-// validate.ts を import すると循環するので、形で見分ける
-function isValidationError(err) {
-    return err.name === "ValidationError" && typeof err.describe === "function";
+export function senriError(code, error) {
+    return Object.assign(typeof error === "string" ? new Error(error) : error, { code });
 }
-export function defaultOnError(dev) {
-    return (err, c) => {
-        if (err instanceof HttpError) {
-            // バリデーションのエラーは、開発モードでだけ、どこが違うかを返す
-            if (dev && isValidationError(err))
-                return c.text(err.describe());
-            return c.text(err.message);
-        }
-        if (!dev) {
-            return c.text("500 Internal Server Error");
-        }
-        return c.text(`500 Internal Server Error: ${err instanceof Error ? err.message : String(err)}`);
-    };
+// Senri が投げたエラーの code(なければ undefined)
+export function errorCode(err) {
+    const code = err?.code;
+    return typeof code === "string" ? code : undefined;
 }
-export function methodNotAllowed(c, path, methods, dev) {
-    const message = dev
-        ? `405 Method Not Allowed: ${c.req.method} ${path}\n${methods} ならあります`
-        : "405 Method Not Allowed";
-    return new HttpError(405, message, { headers: { allow: methods } });
+// 本番の既定。エラーの中身(DB のパスワードなど)がもれないよう、固定の文言だけ返す
+// (開発モードの詳しい文言とエラーページは @senrijs/senri/dev が差し替える)
+export const defaultOnError = (err, c) => c.text(err instanceof HttpError ? err.message : "500 Internal Server Error");
+export const defaultNotFound = (c) => c.text("404 Not Found");
+export function methodNotAllowed(methods) {
+    return senriError("method_not_allowed", new HttpError(405, "405 Method Not Allowed", { headers: { allow: methods } }));
 }
 // QUERY(RFC 10008)は、検索の条件をボディに入れて送るメソッド。ボディと、その形式(Content-Type)が必須
 // ハンドラーを呼ぶ前に確かめる。どちらも問題なければ null
-export async function checkQueryRequest(c, dev) {
-    if (await isEmptyBody(c)) {
-        return new HttpError(400, dev
-            ? "400 Bad Request: QUERY リクエストにボディがありません\nQUERY は、検索の条件をボディに入れて送るメソッドです"
-            : "400 Bad Request");
-    }
+export async function checkQueryRequest(c) {
+    if (await isEmptyBody(c))
+        return senriError("query_no_body", new HttpError(400, "400 Bad Request"));
     if (!c.req.headers.get("content-type")) {
-        return new HttpError(415, dev
-            ? "415 Unsupported Media Type: QUERY リクエストに Content-Type がありません\nボディの形式を指定してください(例: Content-Type: application/json)"
-            : "415 Unsupported Media Type");
+        return senriError("query_no_type", new HttpError(415, "415 Unsupported Media Type"));
     }
     return null;
 }
@@ -113,24 +95,3 @@ async function isEmptyBody(c) {
         reader.cancel().catch(() => { });
     }
 }
-export function defaultNotFound(routes, dev) {
-    return async (c) => {
-        if (!dev) {
-            return c.text("404 Not Found");
-        }
-        // ブラウザで開いたときは、ルートの一覧付きの404ページ(HTML)にする
-        // ページの HTML は大きいので、本番では読み込まないよう、ここで初めて import() する
-        if (wantsHtml(c.req)) {
-            const { notFoundPage } = await import("./dev/not-found-page.js");
-            return notFoundPage(c, routes);
-        }
-        // ルートと同じく、デコード・正規化したパスで比べる(notFound に来るのはデコードできたリクエストだけ)
-        const path = c.path;
-        let message = `404 Not Found: ${c.req.method} ${path}`;
-        const closest = suggest(routes, path);
-        if (closest) {
-            message += `\nもしかして: ${closest.method} ${closest.path} ?`;
-        }
-        return c.text(message);
-    };
-}

package/dist/src/group.d.ts

@@ -1,7 +1,6 @@
 import type { Handler, Middleware } from "./context.ts";
 import { type ExtractParams, type Simplify } from "./router.ts";
 import { type RouteSchemas, type Validated, type ValidatedParams } from "./validate.ts";
-export declare function routeHandler(path: string, a: Handler | RouteSchemas, b: Handler | undefined): Handler;
 type GroupParams<Prefix extends string, Path extends string> = Simplify<ExtractParams<`${Prefix}/${Path}`>>;
 type GroupMethod<Prefix extends string, V extends object> = {
     <Path extends string>(path: Path, handler: Handler<GroupParams<Prefix, Path>, V>): void;

package/dist/src/group.js

@@ -1,14 +1,6 @@
 import { normalizeMethod, splitPattern } from "./router.js";
-import { checkSchemas, withValidation } from "./validate.js";
-// 2つ目の引数がスキーマなら、確かめてからハンドラーを呼ぶものにする(app.ts と同じ)
-export function routeHandler(path, a, b) {
-    if (typeof a === "function")
-        return a;
-    if (typeof b !== "function")
-        throw new TypeError(`${path}: ハンドラーがありません`);
-    checkSchemas(path, a);
-    return withValidation(a, b);
-}
+import { routeHandler } from "./validate.js";
+import { senriError } from "./errors.js";
 const entries = new WeakMap();
 export function joinPath(...parts) {
     return "/" + parts.flatMap(splitPattern).join("/");
@@ -17,7 +9,7 @@ export function joinPath(...parts) {
 export function groupEntries(router) {
     const list = entries.get(router);
     if (!list)
-        throw new TypeError("app.route() には createRouter() で作ったルーターを渡してください");
+        throw senriError("not_router", new TypeError("Not a router from createRouter()"));
     return list("");
 }
 // V は c.set / c.get で使う変数の型。アプリと同じものを指定する: createRouter<"/admin", Vars>("/admin")
@@ -34,7 +26,7 @@ export function createRouter(prefix) {
             const path = typeof pathOrMw === "string" ? pathOrMw : "/";
             const fn = typeof pathOrMw === "string" ? mw : pathOrMw;
             if (!fn)
-                throw new Error(`router.use("${path}", ...) にミドルウェアがありません`);
+                throw senriError("no_middleware", `Missing middleware: ${path}`);
             items.push({ kind: "entry", entry: { kind: "use", path, mw: fn } });
         },
         get: method("GET"),
@@ -48,18 +40,18 @@ export function createRouter(prefix) {
         on: ((methods, path, a, b) => {
             const list = typeof methods === "string" ? [methods] : methods;
             if (list.length === 0)
-                throw new Error(`router.on(..., "${path}") にメソッドがありません`);
+                throw senriError("no_method", `Missing method: ${path}`);
             const handler = routeHandler(path, a, b);
             for (const m of list) {
                 if (m.toUpperCase() === "ALL")
-                    throw new Error("すべてのメソッドで動かすには all() を使ってください");
+                    throw senriError("on_all", "Use all() for every method");
                 // 名前の確認(CONNECT などの拒否)は、ここで先にしておく(app.route まで待たない)
                 push(normalizeMethod(m), path, handler);
             }
         }),
         route(child) {
             if (!entries.has(child))
-                throw new TypeError("route() には createRouter() で作ったルーターを渡してください");
+                throw senriError("not_router", new TypeError("Not a router from createRouter()"));
             items.push({ kind: "router", router: child });
         },
     };
@@ -67,7 +59,7 @@ export function createRouter(prefix) {
     entries.set(router, (base) => {
         // ルーターが自分自身を(間接的にでも)含んでいると終わらないので止める
         if (seen.has(router))
-            throw new Error(`ルーター ${prefix} が自分自身を含んでいます`);
+            throw senriError("router_cycle", `Router ${prefix} contains itself`);
         seen.add(router);
         try {
             const here = joinPath(base, prefix);

package/dist/src/index.d.ts

@@ -1,11 +1,11 @@
-export { createApp, type App, type AppOptions, type MountableApp } from "./app.ts";
+export { createApp, type App, type AppCore, type AppOptions, type DevHooks, type DevInstalled, type MountableApp, type Resolved, } from "./app.ts";
 export { createRouter, type Router } from "./group.ts";
 export { Context, type BindingsOf, type ExecutionContext, type Handler, type HandlerResult, type Middleware, type Next, type VariablesOf, } from "./context.ts";
 export { HttpError, type ErrorHandler, type NotFoundHandler } from "./errors.ts";
 export { ValidationError, type InferOutput, type RouteSchemas, type StandardIssue, type StandardSchemaV1, type ValidationTarget, } from "./validate.ts";
 export type { CookieOptions } from "./cookie.ts";
 export type { FormBody, FormValue } from "./body.ts";
-export type { Timing } from "./compose.ts";
+export type { Layer, Timing, Trace } from "./compose.ts";
 export { logger, showRoutes } from "./logger.ts";
 export { health, type HealthOptions } from "./health.ts";
 export { cors, type CorsOptions } from "./middleware/cors.ts";

package/dist/src/index.js

@@ -1,4 +1,6 @@
-export { createApp } from "./app.js";
+// @senrijs/senri の入口
+// 開発モード(エラーページ・ダッシュボードなど)は @senrijs/senri/dev、Cookie は @senrijs/senri/cookie、接続元の IP は @senrijs/senri/ip
+export { createApp, } from "./app.js";
 export { createRouter } from "./group.js";
 export { Context, } from "./context.js";
 export { HttpError } from "./errors.js";

package/dist/src/ip.d.ts

@@ -0,0 +1,2 @@
+import { type Context } from "./context.ts";
+export declare function getIp(c: Context): string | null;

package/dist/src/ip.js

@@ -0,0 +1,12 @@
+// @senrijs/senri/ip の入口
+// Context のメソッドにしないのは、使わないアプリのバンドルに入れないため(0.1 の c.ip)
+import { connectionOf } from "./context.js";
+import { clientIp } from "./connection.js";
+// 接続元の IP アドレス。分からなければ null(app.fetch を直接呼んだときなど)
+// - Bun / Deno / Node(senri/node): ランタイムが渡す接続元
+// - Cloudflare Workers: Cloudflare が付ける CF-Connecting-IP
+// X-Forwarded-For などのヘッダーは偽装できるので読まない。プロキシの後ろでは、プロキシが付けるヘッダーを自分で読む
+export function getIp(c) {
+    const { req, info } = connectionOf(c);
+    return clientIp(req, info);
+}

package/dist/src/router.js

@@ -1,4 +1,4 @@
-import { HttpError } from "./errors.js";
+import { HttpError, senriError } from "./errors.js";
 // ルートのパターン("/users/:id")を分割する。末尾スラッシュや連続スラッシュは無視
 export function splitPattern(pattern) {
     return pattern.split("/").filter(Boolean);
@@ -110,10 +110,10 @@ export function checkParamNames(path, segments) {
             continue;
         const name = s.slice(1);
         if (name === "") {
-            throw new Error(`パラメーター名が空です: "${path}"`);
+            throw senriError("param_empty", `Empty parameter name: ${path}`);
         }
         if (seen.has(name)) {
-            throw new Error(`パラメーター名 "${name}" が2回使われています: "${path}"`);
+            throw senriError("param_twice", `Parameter "${name}" used twice: ${path}`);
         }
         seen.add(name);
     }
@@ -125,10 +125,10 @@ const METHOD = /^[!#$%&'*+\-.^_`|~0-9A-Za-z]+$/;
 // - "ALL" は app.all() の印として使っているので、app.on() からは登録させない
 export function normalizeMethod(method) {
     if (!METHOD.test(method))
-        throw new Error(`メソッド名に使えない文字があります: ${JSON.stringify(method)}`);
+        throw senriError("method_invalid", `Invalid method: ${JSON.stringify(method)}`);
     const upper = method.toUpperCase();
     if (upper === "CONNECT" || upper === "TRACE" || upper === "TRACK") {
-        throw new Error(`${upper} メソッドは扱いません(Senri では CONNECT / TRACE / TRACK を登録できません)`);
+        throw senriError("method_unsupported", `${upper} is not supported`);
     }
     return upper;
 }

package/dist/src/runtime.d.ts

@@ -2,3 +2,4 @@ export declare function isWorkers(): boolean;
 export declare function cwd(): string | null;
 export declare function env(name: string): string | undefined;
 export declare function canRead(path: string): boolean;
+export declare function canReadEnv(name: string): boolean;

package/dist/src/runtime.js

@@ -47,3 +47,9 @@ export function canRead(path) {
         return denoAllows({ name: "read", path });
     return true;
 }
+// 環境変数を読めるか。Deno で許可(--allow-env)がないときは false(聞き返しはしない)
+export function canReadEnv(name) {
+    if (g.Deno)
+        return denoAllows({ name: "env", variable: name });
+    return true;
+}

package/dist/src/validate.d.ts

@@ -40,8 +40,7 @@ export declare class ValidationError extends HttpError {
     readonly target: ValidationTarget;
     readonly issues: readonly StandardIssue[];
     constructor(target: ValidationTarget, issues: readonly StandardIssue[]);
-    describe(): string;
 }
-export declare function checkSchemas(path: string, schemas: RouteSchemas): void;
 export declare function withValidation(schemas: RouteSchemas, handler: Handler): Handler;
+export declare function routeHandler(path: string, a: Handler | RouteSchemas, b: Handler | undefined): Handler;
 export {};

package/dist/src/validate.js

@@ -7,9 +7,10 @@
 // - body: c.body() の結果(Content-Type に合わせて読んだもの)。通れば c.valid("body") で読める
 // どれかが通らなければ、ハンドラーは呼ばずに 400 にする(ValidationError)
 import { setValidated } from "./context.js";
-import { HttpError } from "./errors.js";
+import { HttpError, senriError } from "./errors.js";
 // バリデーションに通らなかった。issues はスキーマのライブラリが返したもの
 // app.onError で受けて、自分の形(JSON など)で返すこともできる
+// (開発モードの「どこが違うか」の一覧は @senrijs/senri/dev が組み立てる)
 export class ValidationError extends HttpError {
     target;
     issues;
@@ -20,49 +21,6 @@ export class ValidationError extends HttpError {
         this.target = target;
         this.issues = issues;
     }
-    // 開発モードで返す、どこが違うかの一覧
-    describe() {
-        const lines = this.issues.map((issue) => {
-            const path = issuePath(issue);
-            return `- ${path ? `${path}: ` : ""}${issue.message}`;
-        });
-        return [`400 Bad Request: ${LABEL[this.target]}が、スキーマに合いません`, ...lines].join("\n");
-    }
-}
-const LABEL = {
-    params: "パスパラメーター",
-    query: "クエリ",
-    body: "ボディ",
-};
-// ["user", 0, "name"] → "user[0].name"
-function issuePath(issue) {
-    let out = "";
-    for (const part of issue.path ?? []) {
-        const key = typeof part === "object" ? part.key : part;
-        if (typeof key === "number")
-            out += `[${key}]`;
-        else
-            out += out ? `.${String(key)}` : String(key);
-    }
-    return out;
-}
-// ArkType のスキーマは関数なので、オブジェクトでも関数でもよい
-function isSchema(value) {
-    return (typeof value === "object" || typeof value === "function") && value !== null && "~standard" in value;
-}
-// スキーマを確かめておく(書き間違いに、登録した時点で気づけるように)
-export function checkSchemas(path, schemas) {
-    if (typeof schemas !== "object" || schemas === null) {
-        throw new TypeError(`${path}: 2つ目の引数には { params, query, body } のスキーマかハンドラーを渡してください`);
-    }
-    for (const [key, schema] of Object.entries(schemas)) {
-        if (key !== "params" && key !== "query" && key !== "body") {
-            throw new TypeError(`${path}: スキーマに渡せるのは params / query / body だけです("${key}" は使えません)`);
-        }
-        if (schema !== undefined && !isSchema(schema)) {
-            throw new TypeError(`${path}: ${key} が Standard Schema のスキーマではありません(Zod・Valibot・ArkType などのスキーマを渡してください)`);
-        }
-    }
 }
 async function run(schema, target, value) {
     const result = await schema["~standard"].validate(value);
@@ -85,3 +43,13 @@ export function withValidation(schemas, handler) {
         return handler(validParams, c);
     };
 }
+// app.get(path, handler) と app.get(path, { params, query, body }, handler) のどちらか
+// 2つ目の引数がスキーマなら、確かめてからハンドラーを呼ぶものにする
+// (スキーマの書き間違いは、開発モードで登録した時点で知らせる。@senrijs/senri/dev の validation.ts)
+export function routeHandler(path, a, b) {
+    if (typeof a === "function")
+        return a;
+    if (typeof b !== "function")
+        throw senriError("no_handler", `Missing handler: ${path}`);
+    return withValidation(a, b);
+}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@senrijs/senri",
-  "version": "0.1.0",
+  "version": "0.2.0",
   "description": "Web 標準の Request / Response で書かれた、小さな Web フレームワーク。Bun・Deno・Node.js・Cloudflare Workers で動く",
   "license": "MIT",
   "author": "ibuki-hum4",
@@ -35,6 +35,18 @@
       "types": "./dist/src/index.d.ts",
       "import": "./dist/src/index.js"
     },
+    "./dev": {
+      "types": "./dist/src/dev/index.d.ts",
+      "import": "./dist/src/dev/index.js"
+    },
+    "./cookie": {
+      "types": "./dist/src/cookie.d.ts",
+      "import": "./dist/src/cookie.js"
+    },
+    "./ip": {
+      "types": "./dist/src/ip.d.ts",
+      "import": "./dist/src/ip.js"
+    },
     "./node": {
       "types": "./dist/adapters/node/index.d.ts",
       "import": "./dist/adapters/node/index.js"
@@ -54,23 +66,27 @@
   "scripts": {
     "build": "tsc -p tsconfig.build.json",
     "build:pages": "vite build -c ui/vite.config.ts && node scripts/build-pages.ts",
-    "typecheck": "bun run build && bun check && bun check -p test && bun check -p test/node && bun check -p adapters/node && bun check -p examples/bun && bun check -p examples/node && bun check -p scripts && deno check examples/deno/index.ts && bun check -p adapters/serve && bun check -p adapters/static && bun check -p ui",
+    "typecheck": "bun run build && bun check && bun check -p test && bun check -p test/exact && bun check -p test/node && bun check -p adapters/node && bun check -p examples/bun && bun check -p examples/node && bun check -p scripts && deno check examples/deno/index.ts && bun check -p adapters/serve && bun check -p adapters/static && bun check -p ui",
     "dev": "bun --watch examples/bun/index.ts",
     "test": "bun test",
     "test:node": "bun run build && node --test --test-timeout=5000 \"test/node/**/*.test.ts\"",
-    "smoke": "node scripts/smoke.ts"
+    "smoke": "node scripts/smoke.ts",
+    "browser": "node scripts/browser.ts",
+    "size": "bun scripts/size.ts"
   },
   "devDependencies": {
     "@types/bun": "latest",
     "@types/node": "^26.6.5",
     "@vitejs/plugin-vue": "6.0.10",
     "arktype": "2.2.8",
+    "playwright": "1.64.0",
     "typescript": "^7",
     "valibot": "1.5.0",
     "vite": "8.3.5",
     "vite-plugin-singlefile": "2.3.4",
     "vue": "3.5.44",
     "workerd": "1.20261010.1",
+    "wrangler": "4.149.0",
     "zod": "4.6.6"
   }
 }

package/dist/src/dev/runtime.d.ts

@@ -1,3 +0,0 @@
-export declare function cwd(): string | null;
-export declare function env(name: string): string | undefined;
-export declare function canRead(path: string): boolean;

package/dist/src/dev/runtime.js

@@ -1,45 +0,0 @@
-// 開発用ページで使う、ランタイムごとに違う処理(カレントディレクトリ、環境変数、ファイルの読み込み権限)
-//
-// Deno は、許可されていない環境変数やファイルを読もうとすると、ターミナルで「許可しますか?」と聞いてきて
-// その間リクエストが止まってしまう。なので先に permissions.querySync() で「許可済みか」だけを確かめ、
-// 許可されていなければ読まずにあきらめる(聞き返しはしない)
-const g = globalThis;
-function denoAllows(desc) {
-    try {
-        return g.Deno.permissions.querySync(desc).state === "granted";
-    }
-    catch {
-        return false;
-    }
-}
-// スラッシュ区切りのカレントディレクトリ。分からなければ null
-export function cwd() {
-    try {
-        // Deno 2 には process もあるが、権限の確認をしたいので Deno を先に見る
-        // 全体({ name: "read" })で聞くと、--allow-read=. のように範囲を絞ったときに "prompt" になってしまう。
-        // カレントディレクトリが読めればよいので、"." で聞く
-        if (g.Deno)
-            return denoAllows({ name: "read", path: "." }) ? g.Deno.cwd().replaceAll("\\", "/") : null;
-        if (g.process)
-            return g.process.cwd().replaceAll("\\", "/");
-    }
-    catch {
-        // 読めなければあきらめる
-    }
-    return null;
-}
-export function env(name) {
-    try {
-        if (g.Deno)
-            return denoAllows({ name: "env", variable: name }) ? g.Deno.env.get(name) : undefined;
-        return g.process?.env[name];
-    }
-    catch {
-        return undefined;
-    }
-}
-export function canRead(path) {
-    if (g.Deno)
-        return denoAllows({ name: "read", path });
-    return true;
-}