@rdlabo/workers-hono-kit 0.3.6 → 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/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.6",
+  "version": "0.3.7",
   "private": false,
   "publishConfig": {
     "access": "public"

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/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';