Bun + Hono + SQLite

Thin Hono fetch adapter over the private checkout kernel with in-memory Bun SQLite.

@paykernel/example-bun-hono-sqlite is a private workspace host (private: true). It is not @paykernel/integration-hono and is not published. The checkout kernel owns checkout, inbox, and reconciliation. This package only maps HTTP.

Source: examples/bun-hono-sqlite (README).

Mapping

createHonoCheckoutApp builds a Hono from createCheckoutHandlers + honoWebhook. Imports and Stripe route as in source:

import { Hono } from "hono";
import { honoWebhook } from "@paykernel/integration-hono";
import {
  checkoutJsonResponse,
  createCheckoutHandlers,
  createPaymentInputFromUnknown,
  gatewayPaymentIdFromUnknown,
  readRequestJson,
  type CheckoutHttpOptions,
  type CheckoutKernel,
} from "@paykernel/example-checkout-kernel";

app.post(
  "/webhooks/stripe",
  honoWebhook({
    gateway: kernel.webhook.gateway,
    client: kernel.webhook.client,
    engine: kernel.webhook.engine,
    handler: kernel.webhook.handler,
  }),
);

honoWebhook reads c.req.raw with request.text() and calls processWebhookHttp. Do not use c.req.json() (or any body parser) on /webhooks/stripe. Stripe HMAC needs the original bytes.

Fulfillment is only kernel.webhook.handler after the inbox claim. Never fulfill in onWebhookVerified.

HTTP status comes from the kernel / mapInboxOutcome, not from @paykernel/webhooks.

`:memory:` is process-local

createCheckoutKernel() (no storeFactory) uses createBunSqliteStoresInMemory from @paykernel/store-sqlite/bun and then migrateSqliteAdapter. That database is single-host and one process. It is not multi-host and must not be shared across machines. Memory stores are non-production.

Routes

Method	Path	Notes
`POST`	`/payments`	`readRequestJson` → `createPayment`. Invalid JSON → `400 { "error": "invalid_json" }`.
`POST`	`/webhooks/stripe`	`honoWebhook` (raw body + `stripe-signature`).
`GET`	`/orders/:orderId`	Order book. Missing → `404`.
`POST`	`/internal/reconcile`	Test hook. Unauthenticated. Do not deploy.
`POST`	`/internal/provider-paid`	Test hook. Unauthenticated. Do not deploy.
`GET`	`/internal/create-count`	Test hook. Unauthenticated. Do not deploy.

Failure paths (shared suite runCheckoutHttpScenarios("hono", …)): bad Stripe signature → 400 unpaid; rewritten JSON body → 400; concurrent redelivery → 200 or 503 and one fulfill; fulfillThrows → 500 unpaid; indeterminate create does not call createPayment again. Full table: Checkout kernel.

Run

From this directory:

bun test

From the monorepo root:

bun test examples/bun-hono-sqlite

Tests construct createHonoCheckoutApp(kernel) and call app.fetch. They do not start a listener.

Optional listen (enableTestHooks stays off):

bun src/index.ts

PORT defaults to 3000. Bun.serve({ fetch: (req) => app.fetch(req) }). Do not deploy this example as-is.

Checkout kernel · Hono integration · SQLite store · Webhooks