Skip to main content

HonoOptions

@rotorsoft/act-root

@rotorsoft/act-root / act-http/src/hono / HonoOptions

Type Alias: HonoOptions

HonoOptions = object

Defined in: libs/act-http/src/hono/index.ts:102

Per-call options for hono. The host supplies the four seams the package can't make decisions on:

  • actor — auth resolver. Receives the Hono context, returns the Actor that flows onto c.get("actor") for every generated route (via an internal authenticated).
  • stream — stream-id resolver. Receives the action name, the validated body, and the Hono context; returns the target stream. Singleton aggregates return a constant; per-tenant aggregates pull from headers, path, or body.
  • expectedVersion (optional) — optimistic-concurrency resolver. Hosts typically read it from an If-Match header on the request, or from the client's last-known snapshot. Returning undefined skips the check for that call — handy when only some actions are concurrency-sensitive.
  • idempotency (optional) — when set, the route honors Idempotency-Key via withIdempotency. The host supplies the IdempotencyStore; keyFrom defaults to reading the Idempotency-Key header. On a duplicate claim, the route responds 409 Conflict — the contract intentionally doesn't cache the original handler's result, matching the receiver-side "ack the duplicate" semantics.
  • basePath (optional, default "/api") — Hono basePath the routes mount under.

Properties​

actor​

readonly actor: ActorExtractor

Defined in: libs/act-http/src/hono/index.ts:103

basePath?​

readonly optional basePath?: string

Defined in: libs/act-http/src/hono/index.ts:135

expectedVersion?​

readonly optional expectedVersion?: (action_name, input, c) => number | undefined | Promise<number | undefined>

Defined in: libs/act-http/src/hono/index.ts:109

Parameters​

action_name​

string

input​

unknown

c​

Context

Returns​

number | undefined | Promise<number | undefined>

idempotency?​

readonly optional idempotency?: object

Defined in: libs/act-http/src/hono/index.ts:114

keyFrom?​

readonly optional keyFrom?: (c) => string | undefined

Parameters​
c​

Context

Returns​

string | undefined

store​

readonly store: IdempotencyStore

sse?​

readonly optional sse?: SseOptions

Defined in: libs/act-http/src/hono/index.ts:134

Optional SSE wiring. When set, the generator emits one GET <basePath>/sse/<stateName>?stream=<streamId> per unique state name in the registry. The endpoint runs the host actor extractor, looks up the streamId from ?stream=..., opens a text/event-stream, yields the cached state (if any), and forwards every patch published to the shared SseOptions.channel. A heartbeat keeps proxies from idling the connection out; the per-process connection cap returns 503 Service Unavailable (with Retry-After: 1) when full so operators never see silent stalls.

Off by default — most APIs don't expose live state to every client, and opening one is widening both the auth and cost surface.

stream​

readonly stream: (action_name, input, c) => string | Promise<string>

Defined in: libs/act-http/src/hono/index.ts:104

Parameters​

action_name​

string

input​

unknown

c​

Context

Returns​

string | Promise<string>