@rdlabo/workers-hono-kit 0.1.0

package/dist/firebase/remote-verifier.js

@@ -0,0 +1,44 @@
+import { createRemoteJWKSet } from 'jose';
+import { IdentityToolkit } from './identity-toolkit';
+import { JoseFirebaseVerifier, SECURETOKEN_JWK_URL } from './jose-firebase-verifier';
+/**
+ * 本番用の便宜ファクトリ。`createRemoteJWKSet` で Google securetoken の公開鍵を取り、
+ * `JoseFirebaseVerifier` を返す。トークン検証のみ用途（getUser/deleteUser は不要 = Identity Toolkit 無し）。
+ *
+ * JWKS は URL 固定なので isolate 内で 1 度だけ生成して共有し（jose が内部メモリにキャッシュ）、
+ * verifier は projectId ごとにメモ化する。winecode の旧 `verifyFirebaseIdToken`（module-level JWKS）の
+ * キャッシュ挙動を保つための置換。
+ */
+let jwks;
+const verifiers = new Map();
+export function createRemoteFirebaseVerifier(projectId) {
+    jwks ??= createRemoteJWKSet(new URL(SECURETOKEN_JWK_URL));
+    let verifier = verifiers.get(projectId);
+    if (!verifier) {
+        verifier = new JoseFirebaseVerifier({ projectId, keyResolver: jwks });
+        verifiers.set(projectId, verifier);
+    }
+    return verifier;
+}
+let saVerifierCache = null;
+/**
+ * サービスアカウント JSON から検証器を作る便宜ファクトリ（receptray/tipsys hono の `firebaseFor` 相当）。
+ * `getUser`/`deleteUser` のため `IdentityToolkit` を内包する点が `createRemoteFirebaseVerifier` との違い。
+ * SA JSON 文字列をキーに isolate 内で 1 つだけキャッシュ（秘密が変わったときだけ再生成）し、
+ * JWKS は `createRemoteFirebaseVerifier` と共有する。
+ */
+export function createServiceAccountVerifier(serviceAccountJson) {
+    if (saVerifierCache?.key !== serviceAccountJson) {
+        jwks ??= createRemoteJWKSet(new URL(SECURETOKEN_JWK_URL));
+        const sa = JSON.parse(serviceAccountJson);
+        saVerifierCache = {
+            key: serviceAccountJson,
+            verifier: new JoseFirebaseVerifier({
+                projectId: sa.project_id,
+                keyResolver: jwks,
+                identity: new IdentityToolkit(sa),
+            }),
+        };
+    }
+    return saVerifierCache.verifier;
+}

package/dist/http/app-env.d.ts

@@ -0,0 +1,19 @@
+export type AppEnv = 'development' | 'production';
+/**
+ * 実行環境（development / production）を解決する。フリート共通の判定。
+ *
+ * NestJS `/api` は実行時 FS の `.git` 有無で判定し「git が throw → catch → 本番」としていた。
+ * Workers は実行時に FS / child_process が無いため同じ手は使えない。代わりに dev シグナルを
+ * **コミット済みの起動コマンド**に置く: `wrangler dev --var APP_ENV:development`（`deploy` は無注入）。
+ * よって `env.APP_ENV === 'development'` の時だけ development、それ以外（注入無し＝本番デプロイ）は
+ * production に倒す。これは `/api` の「absence/catch = 本番（安全側）」と同じ意味論。
+ *
+ * `env` 由来なので fetch / scheduled どちらの文脈でも使え、リクエストヘッダ由来でないため詐称されない。
+ */
+export declare function resolveAppEnv(env: {
+    APP_ENV?: string;
+} | null | undefined): AppEnv;
+/** production 判定のショートハンド。 */
+export declare const isProductionEnv: (env: {
+    APP_ENV?: string;
+} | null | undefined) => boolean;

package/dist/http/app-env.js

@@ -0,0 +1,16 @@
+/**
+ * 実行環境（development / production）を解決する。フリート共通の判定。
+ *
+ * NestJS `/api` は実行時 FS の `.git` 有無で判定し「git が throw → catch → 本番」としていた。
+ * Workers は実行時に FS / child_process が無いため同じ手は使えない。代わりに dev シグナルを
+ * **コミット済みの起動コマンド**に置く: `wrangler dev --var APP_ENV:development`（`deploy` は無注入）。
+ * よって `env.APP_ENV === 'development'` の時だけ development、それ以外（注入無し＝本番デプロイ）は
+ * production に倒す。これは `/api` の「absence/catch = 本番（安全側）」と同じ意味論。
+ *
+ * `env` 由来なので fetch / scheduled どちらの文脈でも使え、リクエストヘッダ由来でないため詐称されない。
+ */
+export function resolveAppEnv(env) {
+    return env?.APP_ENV === 'development' ? 'development' : 'production';
+}
+/** production 判定のショートハンド。 */
+export const isProductionEnv = (env) => resolveAppEnv(env) === 'production';

package/dist/http/app-info.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from 'hono';
+/** クライアントアプリのメタ情報（NestJS の x-amz-meta-* ヘッダ由来。3 repo 共通）。 */
+export interface AppInfo {
+    version: string | null;
+    uuid: string | null;
+}
+/**
+ * `x-amz-meta-version` / `x-amz-meta-uuid` ヘッダから AppInfo を読む。
+ * auth middleware が per-request で c.set('appInfo', ...) する値（3 repo で同一仕様）。
+ */
+export declare const getAppInfo: (c: Context) => AppInfo;

package/dist/http/app-info.js

@@ -0,0 +1,8 @@
+/**
+ * `x-amz-meta-version` / `x-amz-meta-uuid` ヘッダから AppInfo を読む。
+ * auth middleware が per-request で c.set('appInfo', ...) する値（3 repo で同一仕様）。
+ */
+export const getAppInfo = (c) => ({
+    version: c.req.header('x-amz-meta-version') ?? null,
+    uuid: c.req.header('x-amz-meta-uuid') ?? null,
+});

package/dist/http/http-status.d.ts

@@ -0,0 +1,62 @@
+/**
+ * NestJS `@nestjs/common` の HttpStatus enum と同一。フリート（NestJS → Hono 移植）で
+ * ステータスコードを Nest と同じ名前で参照するための共通定数。`/api` のレスポンス status と
+ * バイト一致させる際の単一の参照元にする。
+ */
+export declare enum HttpStatus {
+    CONTINUE = 100,
+    SWITCHING_PROTOCOLS = 101,
+    PROCESSING = 102,
+    EARLYHINTS = 103,
+    OK = 200,
+    CREATED = 201,
+    ACCEPTED = 202,
+    NON_AUTHORITATIVE_INFORMATION = 203,
+    NO_CONTENT = 204,
+    RESET_CONTENT = 205,
+    PARTIAL_CONTENT = 206,
+    MULTI_STATUS = 207,
+    ALREADY_REPORTED = 208,
+    CONTENT_DIFFERENT = 210,
+    AMBIGUOUS = 300,
+    MOVED_PERMANENTLY = 301,
+    FOUND = 302,
+    SEE_OTHER = 303,
+    NOT_MODIFIED = 304,
+    TEMPORARY_REDIRECT = 307,
+    PERMANENT_REDIRECT = 308,
+    BAD_REQUEST = 400,
+    UNAUTHORIZED = 401,
+    PAYMENT_REQUIRED = 402,
+    FORBIDDEN = 403,
+    NOT_FOUND = 404,
+    METHOD_NOT_ALLOWED = 405,
+    NOT_ACCEPTABLE = 406,
+    PROXY_AUTHENTICATION_REQUIRED = 407,
+    REQUEST_TIMEOUT = 408,
+    CONFLICT = 409,
+    GONE = 410,
+    LENGTH_REQUIRED = 411,
+    PRECONDITION_FAILED = 412,
+    PAYLOAD_TOO_LARGE = 413,
+    URI_TOO_LONG = 414,
+    UNSUPPORTED_MEDIA_TYPE = 415,
+    REQUESTED_RANGE_NOT_SATISFIABLE = 416,
+    EXPECTATION_FAILED = 417,
+    I_AM_A_TEAPOT = 418,
+    MISDIRECTED = 421,
+    UNPROCESSABLE_ENTITY = 422,
+    LOCKED = 423,
+    FAILED_DEPENDENCY = 424,
+    PRECONDITION_REQUIRED = 428,
+    TOO_MANY_REQUESTS = 429,
+    UNRECOVERABLE_ERROR = 456,
+    INTERNAL_SERVER_ERROR = 500,
+    NOT_IMPLEMENTED = 501,
+    BAD_GATEWAY = 502,
+    SERVICE_UNAVAILABLE = 503,
+    GATEWAY_TIMEOUT = 504,
+    HTTP_VERSION_NOT_SUPPORTED = 505,
+    INSUFFICIENT_STORAGE = 507,
+    LOOP_DETECTED = 508
+}

package/dist/http/http-status.js

@@ -0,0 +1,63 @@
+/**
+ * NestJS `@nestjs/common` の HttpStatus enum と同一。フリート（NestJS → Hono 移植）で
+ * ステータスコードを Nest と同じ名前で参照するための共通定数。`/api` のレスポンス status と
+ * バイト一致させる際の単一の参照元にする。
+ */
+export var HttpStatus;
+(function (HttpStatus) {
+    HttpStatus[HttpStatus["CONTINUE"] = 100] = "CONTINUE";
+    HttpStatus[HttpStatus["SWITCHING_PROTOCOLS"] = 101] = "SWITCHING_PROTOCOLS";
+    HttpStatus[HttpStatus["PROCESSING"] = 102] = "PROCESSING";
+    HttpStatus[HttpStatus["EARLYHINTS"] = 103] = "EARLYHINTS";
+    HttpStatus[HttpStatus["OK"] = 200] = "OK";
+    HttpStatus[HttpStatus["CREATED"] = 201] = "CREATED";
+    HttpStatus[HttpStatus["ACCEPTED"] = 202] = "ACCEPTED";
+    HttpStatus[HttpStatus["NON_AUTHORITATIVE_INFORMATION"] = 203] = "NON_AUTHORITATIVE_INFORMATION";
+    HttpStatus[HttpStatus["NO_CONTENT"] = 204] = "NO_CONTENT";
+    HttpStatus[HttpStatus["RESET_CONTENT"] = 205] = "RESET_CONTENT";
+    HttpStatus[HttpStatus["PARTIAL_CONTENT"] = 206] = "PARTIAL_CONTENT";
+    HttpStatus[HttpStatus["MULTI_STATUS"] = 207] = "MULTI_STATUS";
+    HttpStatus[HttpStatus["ALREADY_REPORTED"] = 208] = "ALREADY_REPORTED";
+    HttpStatus[HttpStatus["CONTENT_DIFFERENT"] = 210] = "CONTENT_DIFFERENT";
+    HttpStatus[HttpStatus["AMBIGUOUS"] = 300] = "AMBIGUOUS";
+    HttpStatus[HttpStatus["MOVED_PERMANENTLY"] = 301] = "MOVED_PERMANENTLY";
+    HttpStatus[HttpStatus["FOUND"] = 302] = "FOUND";
+    HttpStatus[HttpStatus["SEE_OTHER"] = 303] = "SEE_OTHER";
+    HttpStatus[HttpStatus["NOT_MODIFIED"] = 304] = "NOT_MODIFIED";
+    HttpStatus[HttpStatus["TEMPORARY_REDIRECT"] = 307] = "TEMPORARY_REDIRECT";
+    HttpStatus[HttpStatus["PERMANENT_REDIRECT"] = 308] = "PERMANENT_REDIRECT";
+    HttpStatus[HttpStatus["BAD_REQUEST"] = 400] = "BAD_REQUEST";
+    HttpStatus[HttpStatus["UNAUTHORIZED"] = 401] = "UNAUTHORIZED";
+    HttpStatus[HttpStatus["PAYMENT_REQUIRED"] = 402] = "PAYMENT_REQUIRED";
+    HttpStatus[HttpStatus["FORBIDDEN"] = 403] = "FORBIDDEN";
+    HttpStatus[HttpStatus["NOT_FOUND"] = 404] = "NOT_FOUND";
+    HttpStatus[HttpStatus["METHOD_NOT_ALLOWED"] = 405] = "METHOD_NOT_ALLOWED";
+    HttpStatus[HttpStatus["NOT_ACCEPTABLE"] = 406] = "NOT_ACCEPTABLE";
+    HttpStatus[HttpStatus["PROXY_AUTHENTICATION_REQUIRED"] = 407] = "PROXY_AUTHENTICATION_REQUIRED";
+    HttpStatus[HttpStatus["REQUEST_TIMEOUT"] = 408] = "REQUEST_TIMEOUT";
+    HttpStatus[HttpStatus["CONFLICT"] = 409] = "CONFLICT";
+    HttpStatus[HttpStatus["GONE"] = 410] = "GONE";
+    HttpStatus[HttpStatus["LENGTH_REQUIRED"] = 411] = "LENGTH_REQUIRED";
+    HttpStatus[HttpStatus["PRECONDITION_FAILED"] = 412] = "PRECONDITION_FAILED";
+    HttpStatus[HttpStatus["PAYLOAD_TOO_LARGE"] = 413] = "PAYLOAD_TOO_LARGE";
+    HttpStatus[HttpStatus["URI_TOO_LONG"] = 414] = "URI_TOO_LONG";
+    HttpStatus[HttpStatus["UNSUPPORTED_MEDIA_TYPE"] = 415] = "UNSUPPORTED_MEDIA_TYPE";
+    HttpStatus[HttpStatus["REQUESTED_RANGE_NOT_SATISFIABLE"] = 416] = "REQUESTED_RANGE_NOT_SATISFIABLE";
+    HttpStatus[HttpStatus["EXPECTATION_FAILED"] = 417] = "EXPECTATION_FAILED";
+    HttpStatus[HttpStatus["I_AM_A_TEAPOT"] = 418] = "I_AM_A_TEAPOT";
+    HttpStatus[HttpStatus["MISDIRECTED"] = 421] = "MISDIRECTED";
+    HttpStatus[HttpStatus["UNPROCESSABLE_ENTITY"] = 422] = "UNPROCESSABLE_ENTITY";
+    HttpStatus[HttpStatus["LOCKED"] = 423] = "LOCKED";
+    HttpStatus[HttpStatus["FAILED_DEPENDENCY"] = 424] = "FAILED_DEPENDENCY";
+    HttpStatus[HttpStatus["PRECONDITION_REQUIRED"] = 428] = "PRECONDITION_REQUIRED";
+    HttpStatus[HttpStatus["TOO_MANY_REQUESTS"] = 429] = "TOO_MANY_REQUESTS";
+    HttpStatus[HttpStatus["UNRECOVERABLE_ERROR"] = 456] = "UNRECOVERABLE_ERROR";
+    HttpStatus[HttpStatus["INTERNAL_SERVER_ERROR"] = 500] = "INTERNAL_SERVER_ERROR";
+    HttpStatus[HttpStatus["NOT_IMPLEMENTED"] = 501] = "NOT_IMPLEMENTED";
+    HttpStatus[HttpStatus["BAD_GATEWAY"] = 502] = "BAD_GATEWAY";
+    HttpStatus[HttpStatus["SERVICE_UNAVAILABLE"] = 503] = "SERVICE_UNAVAILABLE";
+    HttpStatus[HttpStatus["GATEWAY_TIMEOUT"] = 504] = "GATEWAY_TIMEOUT";
+    HttpStatus[HttpStatus["HTTP_VERSION_NOT_SUPPORTED"] = 505] = "HTTP_VERSION_NOT_SUPPORTED";
+    HttpStatus[HttpStatus["INSUFFICIENT_STORAGE"] = 507] = "INSUFFICIENT_STORAGE";
+    HttpStatus[HttpStatus["LOOP_DETECTED"] = 508] = "LOOP_DETECTED";
+})(HttpStatus || (HttpStatus = {}));

package/dist/http/nest-error.d.ts

@@ -0,0 +1,72 @@
+import type { Context, Env } from 'hono';
+import type { ContentfulStatusCode } from 'hono/utils/http-status';
+/**
+ * NestJS の既定例外フィルタが付ける reason phrase（フリート共通 = receptray/winecode/foodlabel の
+ * REASON_PHRASE / DEFAULT_MESSAGES と同一）。3 repo がそれぞれ手書きしていたものを一本化する。
+ */
+export declare const NEST_REASON_PHRASES: Record<number, string>;
+/** 想定外エラーの通報先に渡す文脈（request id 相関など）。フリート共通の最小形。 */
+export interface ErrorReportContext {
+    requestId?: string;
+}
+/**
+ * 想定外エラーの通報関数（Sentry 等）の型。各 repo の container.reportError がこの形。
+ * `createNestErrorHandler({ onUnhandledError })` に `(err, c) => reporter(err, { requestId: c.get('requestId') })`
+ * の形で差し込む。Sentry 呼び出し自体は各 repo（@sentry/cloudflare は workers-hono-kit に持ち込まない）。
+ */
+export type ErrorReporter = (error: unknown, context?: ErrorReportContext) => void;
+/** http エラーとみなされた値から status / message / body を読むための最小形。 */
+interface HttpErrorLike {
+    status: ContentfulStatusCode;
+    message: string;
+    /** repo 固有 body の脱出口（winecode の HttpError.body 相当）。あればそのまま render する。 */
+    body?: unknown;
+}
+export interface NestErrorHandlerOptions<E extends Env = Env> {
+    /** reason phrase map。既定 `NEST_REASON_PHRASES`。 */
+    reasonPhrases?: Record<number, string>;
+    /**
+     * `error` フィールドを省いて `{ statusCode, message }` のみ返す status。既定 `[401]`
+     * （NestJS の generic `HttpException(msg, 401)` は `error` を持たない）。
+     */
+    bareStatuses?: readonly number[];
+    /**
+     * 非 bare body のフィールド順序。既定 `'statusCode-first'`（= NestJS canonical / receptray・winecode）。
+     * **foodlabel は `'message-first'`** を指定して `{ message, error, statusCode }` の byte-parity を保つ。
+     */
+    fieldOrder?: 'statusCode-first' | 'message-first';
+    /**
+     * reasonPhrases に無い（かつ bare でない）status の `error` フォールバック。既定 `undefined`
+     * （= reason 無しなら `error` を省く）。**winecode は `'Error'`** を指定し、全 status で `error` を必ず出す
+     * （NestJS 既定例外フィルタの「error は常に存在」を忠実再現）。
+     */
+    fallbackReason?: string;
+    /**
+     * http エラー判定。既定は hono の `HTTPException`。
+     * **winecode は独自 `HttpError` を使う**ため `(e) => e instanceof HttpError` を渡す。
+     */
+    isHttpError?: (err: unknown) => err is HttpErrorLike;
+    /**
+     * http エラーでない（= 想定外）エラーを 500 で返す前に呼ぶフック（Sentry 通報など）。
+     * **receptray は `container.reportError?.(err, { requestId })`** を差し込む。例外は握り潰す。
+     */
+    onUnhandledError?: (err: unknown, c: Context<E>) => void;
+    /** 想定外エラー時の 500 body。既定 `{ statusCode: 500, message: 'Internal server error' }`。 */
+    internalServerErrorBody?: unknown;
+}
+/**
+ * NestJS の例外フィルタ相当の Hono `onError` ハンドラを作る（フリート共通）。
+ * - http エラー（既定 `HTTPException`）→ Nest 形 body にマップ。`body` を持つ場合はそれを verbatim で返す。
+ * - bareStatuses（既定 401）は `error` フィールド無し。
+ * - それ以外（想定外エラー）→ `onUnhandledError` 通報 + `console.error` + 500。
+ *
+ * `app.onError(createNestErrorHandler(...))` の形で使う。各 repo の parity 差異（body 順序・
+ * エラー型・通報フック）は options で吸収し、本体の分岐ロジックは共有する。
+ */
+export declare function createNestErrorHandler<E extends Env = Env>(options?: NestErrorHandlerOptions<E>): (err: Error, c: Context<E>) => Response;
+/**
+ * Express/Nest 既定の未マッチルート 404 body を返す `notFound` ハンドラ。
+ * `app.notFound(nestNotFoundHandler)` で使う（receptray/winecode は未実装の parity ギャップ）。
+ */
+export declare function nestNotFoundHandler(c: Context): Response;
+export {};

package/dist/http/nest-error.js

@@ -0,0 +1,65 @@
+/**
+ * NestJS の既定例外フィルタが付ける reason phrase（フリート共通 = receptray/winecode/foodlabel の
+ * REASON_PHRASE / DEFAULT_MESSAGES と同一）。3 repo がそれぞれ手書きしていたものを一本化する。
+ */
+export const NEST_REASON_PHRASES = {
+    400: 'Bad Request',
+    401: 'Unauthorized',
+    403: 'Forbidden',
+    404: 'Not Found',
+};
+/**
+ * hono の `HTTPException` を **構造的に**判定する（`instanceof` ではない）。workers-hono-kit は consumer に
+ * symlink 同梱されるため、workers-hono-kit が解決する `hono` と consumer の `hono` が別インスタンスになり得る
+ * （別コピーの HTTPException は `instanceof` で一致しない）。`getResponse()` と数値 `status` を持つかで
+ * 判定すればモジュール境界をまたいでも、prod バンドルでも安定する。
+ */
+const isHTTPException = (err) => err instanceof Error &&
+    typeof err.getResponse === 'function' &&
+    typeof err.status === 'number';
+/**
+ * NestJS の例外フィルタ相当の Hono `onError` ハンドラを作る（フリート共通）。
+ * - http エラー（既定 `HTTPException`）→ Nest 形 body にマップ。`body` を持つ場合はそれを verbatim で返す。
+ * - bareStatuses（既定 401）は `error` フィールド無し。
+ * - それ以外（想定外エラー）→ `onUnhandledError` 通報 + `console.error` + 500。
+ *
+ * `app.onError(createNestErrorHandler(...))` の形で使う。各 repo の parity 差異（body 順序・
+ * エラー型・通報フック）は options で吸収し、本体の分岐ロジックは共有する。
+ */
+export function createNestErrorHandler(options = {}) {
+    const { reasonPhrases = NEST_REASON_PHRASES, bareStatuses = [401], fieldOrder = 'statusCode-first', isHttpError = isHTTPException, onUnhandledError, internalServerErrorBody = { statusCode: 500, message: 'Internal server error' }, fallbackReason, } = options;
+    return (err, c) => {
+        if (isHttpError(err)) {
+            // repo 固有 body の脱出口（winecode）。
+            if (err.body !== undefined) {
+                return c.json(err.body, err.status);
+            }
+            // reasonPhrases[status] は型上 string だが noUncheckedIndexedAccess 無効のため実際は未定義になり得る。
+            // 未登録 status の fallbackReason フォールバックは意図的。
+            // eslint-disable-next-line @typescript-eslint/no-unnecessary-condition
+            const reason = bareStatuses.includes(err.status) ? undefined : (reasonPhrases[err.status] ?? fallbackReason);
+            if (reason === undefined) {
+                return c.json({ statusCode: err.status, message: err.message }, err.status);
+            }
+            const body = fieldOrder === 'message-first'
+                ? { message: err.message, error: reason, statusCode: err.status }
+                : { statusCode: err.status, message: err.message, error: reason };
+            return c.json(body, err.status);
+        }
+        try {
+            onUnhandledError?.(err, c);
+        }
+        catch {
+            // 通報はエラーレスポンスの挙動を変えてはならない。
+        }
+        console.error(err);
+        return c.json(internalServerErrorBody, 500);
+    };
+}
+/**
+ * Express/Nest 既定の未マッチルート 404 body を返す `notFound` ハンドラ。
+ * `app.notFound(nestNotFoundHandler)` で使う（receptray/winecode は未実装の parity ギャップ）。
+ */
+export function nestNotFoundHandler(c) {
+    return c.json({ message: `Cannot ${c.req.method} ${new URL(c.req.url).pathname}`, error: 'Not Found', statusCode: 404 }, 404);
+}

package/dist/http/user-protocol.d.ts

@@ -0,0 +1,11 @@
+import type { Context } from 'hono';
+/** クライアントの IP / UA（NestJS の @UserProtocol デコレータ相当）。 */
+export interface IUserProtocol {
+    ipAddress: string | null;
+    userAgent: string | null;
+}
+/**
+ * Hono Context からクライアント IP / UA を取得する。Cloudflare は実 IP を `CF-Connecting-IP` に入れる
+ * （`X-Forwarded-For` はフォールバック）。未取得は null（DB の nullable カラムにそのまま入る）。
+ */
+export declare const getUserProtocol: (c: Context) => IUserProtocol;

package/dist/http/user-protocol.js

@@ -0,0 +1,8 @@
+/**
+ * Hono Context からクライアント IP / UA を取得する。Cloudflare は実 IP を `CF-Connecting-IP` に入れる
+ * （`X-Forwarded-For` はフォールバック）。未取得は null（DB の nullable カラムにそのまま入る）。
+ */
+export const getUserProtocol = (c) => ({
+    ipAddress: c.req.header('cf-connecting-ip') ?? c.req.header('x-forwarded-for') ?? null,
+    userAgent: c.req.header('user-agent') ?? null,
+});

package/dist/index.d.ts

@@ -0,0 +1,30 @@
+export { finalizeResponse } from './middleware/finalize-response';
+export { validate, createSentryValidate } from './middleware/validation';
+export type { ValidateOptions, ValidationTarget, ZodErrorLike, SentryLike, SentryScopeLike, } from './middleware/validation';
+export { zNum, zNumNullable, zNumOptional, zNumWithDefault } from './middleware/zod-coerce';
+export { createAuthMiddleware } from './middleware/auth';
+export type { AuthMiddlewareOptions } from './middleware/auth';
+export { getUserProtocol } from './http/user-protocol';
+export type { IUserProtocol } from './http/user-protocol';
+export { getAppInfo } from './http/app-info';
+export type { AppInfo } from './http/app-info';
+export { resolveAppEnv, isProductionEnv } from './http/app-env';
+export type { AppEnv } from './http/app-env';
+export { HttpStatus } from './http/http-status';
+export { createNestErrorHandler, nestNotFoundHandler, NEST_REASON_PHRASES } from './http/nest-error';
+export type { NestErrorHandlerOptions, ErrorReportContext, ErrorReporter } from './http/nest-error';
+export { KVCache } from './cache/kv-cache';
+export type { KVNamespace, KVCacheOptions } from './cache/kv-cache';
+export { createStripeClient, verifyStripeWebhook } from './stripe/client';
+export type { CreateStripeClientOptions } from './stripe/client';
+export { retryWhenDeadlock } from './db/retry';
+export { createAiGatewayProvider } from './ai/gateway';
+export type { AiGatewayConfig, AiGatewayProvider, AiGatewayBinding, AiGateway, AiGatewayOptions } from './ai/gateway';
+export { getAuthenticationSecret } from './aws/secrets-manager';
+export type { AwsSecretsOptions } from './aws/secrets-manager';
+export { getCloudFrontSignedUrl } from './aws/cloudfront';
+export type { DecodedIdToken, FirebaseVerifier } from './firebase/firebase-verifier';
+export { JoseFirebaseVerifier, SECURETOKEN_JWK_URL } from './firebase/jose-firebase-verifier';
+export { IdentityToolkit } from './firebase/identity-toolkit';
+export type { ServiceAccount } from './firebase/identity-toolkit';
+export { createRemoteFirebaseVerifier, createServiceAccountVerifier } from './firebase/remote-verifier';

package/dist/index.js

@@ -0,0 +1,28 @@
+// @rdlabo/workers-hono-kit — フリート共通のインフラ層ヘルパ（receptray / winecode / foodlabel）。
+// ドメイン・DB・各 repo 固有の parity 差異（auth エラー status/body、secretId、Secret スキーマ）は
+// 各 repo 側に残し、ここには「設定注入で汎用化できるインフラ」だけを置く。
+// middleware
+export { finalizeResponse } from './middleware/finalize-response';
+export { validate, createSentryValidate } from './middleware/validation';
+export { zNum, zNumNullable, zNumOptional, zNumWithDefault } from './middleware/zod-coerce';
+export { createAuthMiddleware } from './middleware/auth';
+// http
+export { getUserProtocol } from './http/user-protocol';
+export { getAppInfo } from './http/app-info';
+export { resolveAppEnv, isProductionEnv } from './http/app-env';
+export { HttpStatus } from './http/http-status';
+export { createNestErrorHandler, nestNotFoundHandler, NEST_REASON_PHRASES } from './http/nest-error';
+// cache
+export { KVCache } from './cache/kv-cache';
+// stripe
+export { createStripeClient, verifyStripeWebhook } from './stripe/client';
+// db
+export { retryWhenDeadlock } from './db/retry';
+// ai
+export { createAiGatewayProvider } from './ai/gateway';
+// aws
+export { getAuthenticationSecret } from './aws/secrets-manager';
+export { getCloudFrontSignedUrl } from './aws/cloudfront';
+export { JoseFirebaseVerifier, SECURETOKEN_JWK_URL } from './firebase/jose-firebase-verifier';
+export { IdentityToolkit } from './firebase/identity-toolkit';
+export { createRemoteFirebaseVerifier, createServiceAccountVerifier } from './firebase/remote-verifier';

package/dist/middleware/auth.d.ts

@@ -0,0 +1,36 @@
+import type { Context, Env, MiddlewareHandler } from 'hono';
+import type { ContentfulStatusCode } from 'hono/utils/http-status';
+import type { AppInfo } from '../http/app-info';
+export interface AuthMiddlewareOptions<E extends Env, Verified, Id = unknown> {
+    /** ID トークンを載せるヘッダ。既定 `'x-amz-security-token'`（フリート共通）。 */
+    tokenHeader?: string;
+    /** 生トークンを検証して record/decoded を返す。無効なら throw / reject すること。 */
+    verify: (token: string, c: Context<E>) => Promise<Verified>;
+    /**
+     * DB userId を解決（必要なら新規作成）する。**省略すると token-only**（検証のみ・login 用）になる。
+     * create-on-miss（`getUserIdFromFirebase(...).catch(() => createUser(...))`）は repo 側でここに合成する。
+     */
+    resolveUserId?: (verified: Verified, c: Context<E>, appInfo: AppInfo) => Promise<Id>;
+    /** 検証結果を c.var に載せる。repo 固有の var 名（`decodedToken` / `userRecord` / `userProtocol` 等）を注入する。 */
+    setContext: (c: Context<E>, data: {
+        verified: Verified;
+        appInfo: AppInfo;
+        userId?: Id;
+    }) => void;
+    /**
+     * 失敗時の挙動。既定は `throw new HTTPException(failureStatus, { message: failureMessage })`
+     * （foodlabel/receptray と同形）。**winecode は `c.json(BODY, n)` を返す**ため上書きする。
+     */
+    onFailure?: (err: unknown, c: Context<E>) => Response;
+    /** 既定 onFailure の status。既定 `403`（token-only の 401 等は repo が上書き）。 */
+    failureStatus?: ContentfulStatusCode;
+    /** 既定 onFailure の message。既定 `'Forbidden resource'`。 */
+    failureMessage?: string;
+}
+/**
+ * NestJS の AuthGuard / TokenGuard 相当の認証 middleware を作る（フリート共通）。
+ * スケルトン（ヘッダ読取 → verify → getAppInfo → resolveUserId → setContext、失敗で console.error +
+ * onFailure）を共有し、repo 固有部分（verify / userId 解決 / var 名 / 失敗レスポンス）だけ注入させる。
+ * `resolveUserId` を省けば token-only middleware になる。
+ */
+export declare function createAuthMiddleware<E extends Env = Env, Verified = unknown, Id = unknown>(options: AuthMiddlewareOptions<E, Verified, Id>): MiddlewareHandler<E>;

package/dist/middleware/auth.js

@@ -0,0 +1,30 @@
+import { HTTPException } from 'hono/http-exception';
+import { getAppInfo } from '../http/app-info';
+/**
+ * NestJS の AuthGuard / TokenGuard 相当の認証 middleware を作る（フリート共通）。
+ * スケルトン（ヘッダ読取 → verify → getAppInfo → resolveUserId → setContext、失敗で console.error +
+ * onFailure）を共有し、repo 固有部分（verify / userId 解決 / var 名 / 失敗レスポンス）だけ注入させる。
+ * `resolveUserId` を省けば token-only middleware になる。
+ */
+export function createAuthMiddleware(options) {
+    const { tokenHeader = 'x-amz-security-token', verify, resolveUserId, setContext, onFailure, failureStatus = 403, failureMessage = 'Forbidden resource', } = options;
+    return async (c, next) => {
+        try {
+            const token = c.req.header(tokenHeader) ?? '';
+            const verified = await verify(token, c);
+            const appInfo = getAppInfo(c);
+            const userId = resolveUserId ? await resolveUserId(verified, c, appInfo) : undefined;
+            setContext(c, { verified, appInfo, userId });
+        }
+        catch (e) {
+            // Nest guard が false → ForbiddenException('Forbidden resource')。原因をログし、既定では throw して
+            // app.onError に Nest 形 body を描かせる（repo は onFailure で return 形に上書き可能）。
+            console.error(e);
+            if (onFailure) {
+                return onFailure(e, c);
+            }
+            throw new HTTPException(failureStatus, { message: failureMessage });
+        }
+        await next();
+    };
+}

package/dist/middleware/finalize-response.d.ts

@@ -0,0 +1,2 @@
+import type { MiddlewareHandler } from 'hono';
+export declare function finalizeResponse(): MiddlewareHandler;

package/dist/middleware/finalize-response.js

@@ -0,0 +1,53 @@
+/**
+ * レスポンス最終化ミドルウェア。Express/Nest（移植元 `../api`）との byte 一致のため 2 点を行う
+ * （フリート共通仕様 = receptray/winecode hono と同一）:
+ *
+ * 1. **JSON の charset**: Express の res.json は `application/json; charset=utf-8` を返すが、
+ *    Hono の c.json は `application/json`（charset 無し）なので合わせる。
+ * 2. **weak ETag**: Express/`etag` パッケージ互換の
+ *    `W/"<byteLength(16進)>-<sha1(body)をbase64して先頭27文字>"`。Express(=Nest) は GET 等のレスポンスに
+ *    既定で付与するため、hono/etag の独自形式ではなく Express の算法に厳密一致させる。
+ *
+ * SSE（text/event-stream）はストリームを buffer できないため両方スキップ。
+ */
+async function weakEtag(body) {
+    const digest = await crypto.subtle.digest('SHA-1', body);
+    const bytes = new Uint8Array(digest);
+    let bin = '';
+    for (const b of bytes) {
+        bin += String.fromCharCode(b);
+    }
+    const b64 = btoa(bin).substring(0, 27);
+    return `W/"${body.byteLength.toString(16)}-${b64}"`;
+}
+export function finalizeResponse() {
+    return async (c, next) => {
+        await next();
+        const status = c.res.status;
+        const contentType = c.res.headers.get('content-type') ?? '';
+        // SSE / ストリームは触らない。
+        if (contentType.includes('text/event-stream')) {
+            return;
+        }
+        // charset 補正対象（JSON で charset 未指定なら付与）。
+        const needsCharset = contentType === 'application/json';
+        // ETag 対象（Express は 204/304 では付けない・既存 ETag は尊重）。
+        const needsEtag = status !== 204 && status !== 304 && !c.res.headers.has('etag') && !!c.res.body;
+        if (!needsCharset && !needsEtag) {
+            return;
+        }
+        const headers = new Headers(c.res.headers);
+        if (needsCharset) {
+            headers.set('content-type', 'application/json; charset=utf-8');
+        }
+        if (needsEtag) {
+            const buf = await c.res.clone().arrayBuffer();
+            headers.set('ETag', await weakEtag(buf));
+            c.res = new Response(buf, { status, statusText: c.res.statusText, headers });
+        }
+        else {
+            // body を読まずヘッダだけ差し替え。
+            c.res = new Response(c.res.body, { status, statusText: c.res.statusText, headers });
+        }
+    };
+}