@rdlabo/workers-hono-kit 0.3.5 → 0.3.7

package/README.md

@@ -66,12 +66,16 @@ npm install ai ai-gateway-provider    # createAiGatewayProvider
 | `HttpStatus` | HTTP status enum identical to NestJS `@nestjs/common`. |
 | `createNestErrorHandler(options?)` / `NestErrorHandlerOptions` | `app.onError()` handler that maps a thrown `HTTPException` to the NestJS exception-filter body (`{ statusCode, message, error? }`; `401` omits `error`). Configurable field order, reason phrases, error predicate, and unhandled-error report hook. |
 | `nestNotFoundHandler(c)` | `app.notFound()` handler with the Express/Nest default `{ message: 'Cannot METHOD path', error, statusCode }` 404 body. |
+| `normalizeTrailingSlash(request)` | Strip trailing slash(es) from the request URL before routing (Express/Nest parity). Does **not** 301-redirect — preserves POST/PUT/DELETE bodies. |
 | `NEST_REASON_PHRASES` | `{ 400, 401, 403, 404 }` → NestJS reason phrases. |
 | `createAuthMiddleware(options)` / `AuthMiddlewareOptions` | Factory for a Firebase-token auth middleware: reads the token header, verifies, resolves the DB user id, and stashes the result on the context. Omit `resolveUserId` for a token-only (login) guard. |
 | `ErrorReporter` / `ErrorReportContext` | Types for a `reportError`-style unhandled-error reporter (e.g. wired to Sentry), paired with `createNestErrorHandler`'s `onUnhandledError`. |
 | `createAiGatewayProvider(config)` / `AiGatewayConfig` / `AiGatewayProvider` | Route `@ai-sdk` models through the Cloudflare AI Gateway, via either a Workers `AI` binding or REST credentials (`accountId` / `gateway` / `token`). |
 | `KVCache` / `KVNamespace` / `KVCacheOptions` | Workers-KV cache-aside helper (key `appName+version+table_type_column`, sha256 for string ids, TTL clamped ≥60s). Set `appName` / `version` per application. |
 | `createStripeClient(secret, opts?)` / `verifyStripeWebhook(...)` / `CreateStripeClientOptions` | Workers-native Stripe client (fetch transport) + async webhook verification (SubtleCrypto). `apiVersion` optional (pin to a fixed Stripe API version). |
+| `sendInChunks(queue, messages, chunkSize?)` / `QueueLike` / `QueueSendMessage` | Send queue messages in bounded chunks to stay under the Workers subrequest cap per invocation. |
+| `processBatch(batch, handler, options?)` / `MessageBatchLike` / `QueueMessageLike` / `ProcessBatchOptions` / `ProcessBatchResult` | Process a queue batch with bounded concurrency (consumer-side counterpart to `sendInChunks`). |
+| `ExecutionContextLike` | Minimal `waitUntil`-only Workers execution context shape (for `withMysqlConnections` in worker entry modules without importing `./db`). |
 
 ### Data layer — `@rdlabo/workers-hono-kit/db`
 
@@ -81,6 +85,7 @@ Requires the `drizzle-orm` and `mysql2` peers. Reads run against a replica via r
 | --- | --- |
 | `createHyperdriveDatabase(options)` | `DisposableDatabase` that lazily opens primary/replica connections from Hyperdrive bindings per request; `dispose()` closes them. |
 | `createMysqlDatabase(options)` | Assemble a `Database` from an already-connected Drizzle ORM + replica `QueryRunner`. |
+| `databaseFrom(orm, replica)` | Build a `Database` from an existing Drizzle instance + replica handle. |
 | `Database` / `DisposableDatabase` / `QueryRunner` / `TxOf` | The `read` / `write` / `transaction` API and its supporting types. |
 | `hyperdriveConnectionOptions(hyperdrive, overrides?)` / `HyperdriveLike` / `ExecutionContextLike` | Build mysql2 `createConnection` options from a Hyperdrive binding (`disableEval`, `decimalNumbers`, `timezone '+09:00'` by default). |
 | `withMysqlConnections(...)` | Open primary/replica connections, run a function, close them in `finally` (via `ctx.waitUntil`). |
@@ -88,6 +93,8 @@ Requires the `drizzle-orm` and `mysql2` peers. Reads run against a replica via r
 | `insertIdOf` / `affectedRowsOf` / `insertedIdsOf` / `DzWriteResult` | Extract `insertId` / `affectedRows` (and derive contiguous bulk-insert ids) from a mysql2 write result. |
 | `toJstDate` / `jstTimestampParams` / `jstDatetimeParams` / `jstDateParams` | JST date/time normalization applied at the Drizzle `customType` column boundary. |
 | `DRIZZLE_ORM_OPTIONS` / `honoDrizzleConfig(options)` / `HonoDrizzleConfigOptions` | Shared Drizzle casing (`snake_case`) for both the runtime `drizzle()` call and `drizzle.config.ts`, keeping config ↔ runtime in sync. |
+| `resolveDbSecret(options, secretId?)` / `ResolvedDbSecret` | Resolve RDS-managed or plain DB credentials from AWS Secrets Manager for CI migrate / local tooling. |
+| `baselineMigrations(options)` / `readBaselineEntry(migrationsFolder)` / `BaselineMigrationsOptions` / `BaselineResult` / `BaselineEntry` | Brownfield first-deploy helper: mark an existing `0000_*` migration as applied without re-running DDL. |
 
 ### Testing — `@rdlabo/workers-hono-kit/testing`
 

package/dist/db/connection.d.ts

@@ -1,4 +1,6 @@
 import type { Connection } from 'mysql2/promise';
+import type { ExecutionContextLike } from '../http/execution-context.js';
+export type { ExecutionContextLike } from '../http/execution-context.js';
 /**
  * Minimal structural shape of a Cloudflare Hyperdrive binding.
  *
@@ -40,16 +42,6 @@ export interface HyperdriveLike {
  * @returns a plain options object to pass to mysql2 `createConnection`.
  */
 export declare function hyperdriveConnectionOptions(hyperdrive: HyperdriveLike, extra?: Record<string, unknown>): Record<string, unknown>;
-/**
- * Minimal structural shape of a Workers `ExecutionContext`, limited to `waitUntil`.
- *
- * @remarks
- * Declared structurally to avoid a dependency on `@cloudflare/workers-types`.
- */
-export interface ExecutionContextLike {
-    /** Extend the request's lifetime until `promise` settles (used to close connections after the response). */
-    waitUntil(promise: Promise<unknown>): void;
-}
 /**
  * Open primary and replica connections, run `fn` with them, and close both afterwards.
  *

package/dist/db/index.d.ts

@@ -17,7 +17,7 @@ export type { DzWriteResult } from './write-result.js';
 export { hyperdriveConnectionOptions, withMysqlConnections } from './connection.js';
 export type { HyperdriveLike, ExecutionContextLike } from './connection.js';
 export { toJstDate, jstTimestampParams, jstDatetimeParams, jstDateParams } from './jst.js';
-export { DRIZZLE_ORM_OPTIONS, honoDrizzleConfig } from './orm-config.js';
-export type { HonoDrizzleConfigOptions } from './orm-config.js';
+export { DRIZZLE_ORM_OPTIONS, honoDrizzleConfig, resolveDbSecret } from './orm-config.js';
+export type { HonoDrizzleConfigOptions, ResolvedDbSecret } from './orm-config.js';
 export { baselineMigrations, readBaselineEntry } from './migrate.js';
 export type { BaselineMigrationsOptions, BaselineResult, BaselineEntry } from './migrate.js';

package/dist/db/index.js

@@ -14,5 +14,5 @@ export { createMysqlDatabase, createHyperdriveDatabase, databaseFrom } from './d
 export { insertIdOf, affectedRowsOf, insertedIdsOf } from './write-result.js';
 export { hyperdriveConnectionOptions, withMysqlConnections } from './connection.js';
 export { toJstDate, jstTimestampParams, jstDatetimeParams, jstDateParams } from './jst.js';
-export { DRIZZLE_ORM_OPTIONS, honoDrizzleConfig } from './orm-config.js';
+export { DRIZZLE_ORM_OPTIONS, honoDrizzleConfig, resolveDbSecret } from './orm-config.js';
 export { baselineMigrations, readBaselineEntry } from './migrate.js';

package/dist/db/orm-config.d.ts

@@ -102,3 +102,22 @@ export declare function honoDrizzleConfig(options: HonoDrizzleConfigOptions): {
     out: string;
     casing: "snake_case";
 };
+/** {@link resolveDbSecret} の戻り値（正規化済みの接続情報）。 */
+export interface ResolvedDbSecret {
+    host: string;
+    port: number;
+    dbname: string;
+    username: string;
+    password: string;
+}
+/**
+ * AWS RDS マネージド secret（`DB_SECRET` に入れた JSON 文字列）を解決する。
+ *
+ * @remarks
+ * - `DB_SECRET` 未設定 → `undefined`（ローカル/`db:generate` の正常フォールバック）。
+ * - 設定されている場合は「完全な接続情報」であることを要求し、**不正 JSON / 必須キー欠損は throw**
+ *   （静かに localhost へフォールバックして事故らせない）。`port` のみ欠損時は 3306 を補う。
+ *
+ * `honoDrizzleConfig`（db:migrate）と `workers-hono-kit-db-baseline` bin の双方が同じ解釈を使う。
+ */
+export declare function resolveDbSecret(): ResolvedDbSecret | undefined;

package/dist/db/orm-config.js

@@ -92,8 +92,10 @@ export function honoDrizzleConfig(options) {
  * - `DB_SECRET` 未設定 → `undefined`（ローカル/`db:generate` の正常フォールバック）。
  * - 設定されている場合は「完全な接続情報」であることを要求し、**不正 JSON / 必須キー欠損は throw**
  *   （静かに localhost へフォールバックして事故らせない）。`port` のみ欠損時は 3306 を補う。
+ *
+ * `honoDrizzleConfig`（db:migrate）と `workers-hono-kit-db-baseline` bin の双方が同じ解釈を使う。
  */
-function resolveDbSecret() {
+export function resolveDbSecret() {
     const raw = process.env.DB_SECRET;
     if (!raw) {
         return undefined;

package/dist/http/execution-context.d.ts

@@ -0,0 +1,11 @@
+/**
+ * Minimal structural shape of a Workers `ExecutionContext`, limited to `waitUntil`.
+ *
+ * @remarks
+ * Declared structurally to avoid a dependency on `@cloudflare/workers-types`.
+ * Lives in the root export path so worker entry modules can import it without pulling in `./db`.
+ */
+export interface ExecutionContextLike {
+    /** Extend the request's lifetime until `promise` settles (used to close connections after the response). */
+    waitUntil(promise: Promise<unknown>): void;
+}

package/dist/http/execution-context.js

@@ -0,0 +1 @@
+export {};

package/dist/index.d.ts

@@ -25,6 +25,7 @@ export { HttpStatus } from './http/http-status.js';
 export { createNestErrorHandler, nestNotFoundHandler, NEST_REASON_PHRASES } from './http/nest-error.js';
 export type { NestErrorHandlerOptions, ErrorReportContext, ErrorReporter } from './http/nest-error.js';
 export { normalizeTrailingSlash } from './http/trailing-slash.js';
+export type { ExecutionContextLike } from './http/execution-context.js';
 export { KVCache } from './cache/kv-cache.js';
 export type { KVNamespace, KVCacheOptions } from './cache/kv-cache.js';
 export { createStripeClient, verifyStripeWebhook } from './stripe/client.js';

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@rdlabo/workers-hono-kit",
-  "version": "0.3.5",
+  "version": "0.3.7",
   "private": false,
   "publishConfig": {
     "access": "public"

package/scripts/db-baseline.mjs

@@ -15,6 +15,7 @@
 //   npx workers-hono-kit-db-baseline [--migrations ./drizzle]
 import { createConnection } from 'mysql2/promise';
 import { baselineMigrations } from '../dist/db/migrate.js';
+import { resolveDbSecret } from '../dist/db/index.js';
 
 function arg(name) {
   const i = process.argv.indexOf(`--${name}`);
@@ -22,16 +23,28 @@ function arg(name) {
 }
 
 const migrationsFolder = arg('migrations') ?? process.env.MIGRATIONS_DIR ?? './drizzle';
-const conn = {
-  host: process.env.DB_HOST ?? '127.0.0.1',
-  port: Number(process.env.DB_PORT ?? '3306'),
-  user: process.env.DB_USER ?? 'root',
-  password: process.env.DB_PASSWORD ?? 'root',
-  database: process.env.DB_NAME,
-};
+// db:migrate（honoDrizzleConfig）と同じ DB_SECRET 解釈を共有する。CI/本番は AWS Secrets Manager の
+// RDS マネージド secret を DB_SECRET に渡す運用（不正/欠損は resolveDbSecret が throw）。未設定時は
+// 従来の個別 DB_* env にフォールバック。
+const secret = resolveDbSecret();
+const conn = secret
+  ? {
+      host: secret.host,
+      port: secret.port,
+      user: secret.username,
+      password: secret.password,
+      database: secret.dbname,
+    }
+  : {
+      host: process.env.DB_HOST ?? '127.0.0.1',
+      port: Number(process.env.DB_PORT ?? '3306'),
+      user: process.env.DB_USER ?? 'root',
+      password: process.env.DB_PASSWORD ?? 'root',
+      database: process.env.DB_NAME,
+    };
 
 if (!conn.database) {
-  console.error('[db:baseline] DB_NAME is required.');
+  console.error('[db:baseline] DB_NAME (or DB_SECRET) is required.');
   process.exit(1);
 }
 

package/src/db/connection.ts

@@ -1,5 +1,8 @@
 import { createConnection } from 'mysql2/promise';
 import type { Connection } from 'mysql2/promise';
+import type { ExecutionContextLike } from '../http/execution-context.js';
+
+export type { ExecutionContextLike } from '../http/execution-context.js';
 
 /**
  * Minimal structural shape of a Cloudflare Hyperdrive binding.
@@ -59,17 +62,6 @@ export function hyperdriveConnectionOptions(
   };
 }
 
-/**
- * Minimal structural shape of a Workers `ExecutionContext`, limited to `waitUntil`.
- *
- * @remarks
- * Declared structurally to avoid a dependency on `@cloudflare/workers-types`.
- */
-export interface ExecutionContextLike {
-  /** Extend the request's lifetime until `promise` settles (used to close connections after the response). */
-  waitUntil(promise: Promise<unknown>): void;
-}
-
 /**
  * Open primary and replica connections, run `fn` with them, and close both afterwards.
  *

package/src/db/index.ts

@@ -32,8 +32,8 @@ export type { HyperdriveLike, ExecutionContextLike } from './connection.js';
 
 export { toJstDate, jstTimestampParams, jstDatetimeParams, jstDateParams } from './jst.js';
 
-export { DRIZZLE_ORM_OPTIONS, honoDrizzleConfig } from './orm-config.js';
-export type { HonoDrizzleConfigOptions } from './orm-config.js';
+export { DRIZZLE_ORM_OPTIONS, honoDrizzleConfig, resolveDbSecret } from './orm-config.js';
+export type { HonoDrizzleConfigOptions, ResolvedDbSecret } from './orm-config.js';
 
 export { baselineMigrations, readBaselineEntry } from './migrate.js';
 export type { BaselineMigrationsOptions, BaselineResult, BaselineEntry } from './migrate.js';

package/src/db/orm-config.ts

@@ -128,6 +128,15 @@ export function honoDrizzleConfig(options: HonoDrizzleConfigOptions) {
   };
 }
 
+/** {@link resolveDbSecret} の戻り値（正規化済みの接続情報）。 */
+export interface ResolvedDbSecret {
+  host: string;
+  port: number;
+  dbname: string;
+  username: string;
+  password: string;
+}
+
 /**
  * AWS RDS マネージド secret（`DB_SECRET` に入れた JSON 文字列）を解決する。
  *
@@ -135,8 +144,10 @@ export function honoDrizzleConfig(options: HonoDrizzleConfigOptions) {
  * - `DB_SECRET` 未設定 → `undefined`（ローカル/`db:generate` の正常フォールバック）。
  * - 設定されている場合は「完全な接続情報」であることを要求し、**不正 JSON / 必須キー欠損は throw**
  *   （静かに localhost へフォールバックして事故らせない）。`port` のみ欠損時は 3306 を補う。
+ *
+ * `honoDrizzleConfig`（db:migrate）と `workers-hono-kit-db-baseline` bin の双方が同じ解釈を使う。
  */
-function resolveDbSecret(): { host: string; port: number; dbname: string; username: string; password: string } | undefined {
+export function resolveDbSecret(): ResolvedDbSecret | undefined {
   const raw = process.env.DB_SECRET;
   if (!raw) {
     return undefined;

package/src/http/execution-context.ts

@@ -0,0 +1,11 @@
+/**
+ * Minimal structural shape of a Workers `ExecutionContext`, limited to `waitUntil`.
+ *
+ * @remarks
+ * Declared structurally to avoid a dependency on `@cloudflare/workers-types`.
+ * Lives in the root export path so worker entry modules can import it without pulling in `./db`.
+ */
+export interface ExecutionContextLike {
+  /** Extend the request's lifetime until `promise` settles (used to close connections after the response). */
+  waitUntil(promise: Promise<unknown>): void;
+}

package/src/index.ts

@@ -35,6 +35,7 @@ export { HttpStatus } from './http/http-status.js';
 export { createNestErrorHandler, nestNotFoundHandler, NEST_REASON_PHRASES } from './http/nest-error.js';
 export type { NestErrorHandlerOptions, ErrorReportContext, ErrorReporter } from './http/nest-error.js';
 export { normalizeTrailingSlash } from './http/trailing-slash.js';
+export type { ExecutionContextLike } from './http/execution-context.js';
 
 // cache
 export { KVCache } from './cache/kv-cache.js';