Files

defiQUG ae744e4be4 Gateway outbox worker, MQ wrap, thirdweb adapter updates, and SolaceNet docs.

Made-with: Cursor

2026-04-12 06:11:37 -07:00

Gateway rail adapter lifecycle (DI policy)

Gap: PG-GW-W01 (singleton vs per-request).

Policy (until superseded by performance review):

HTTP (/api/v1/gateway/rails/*) — createGatewayRailAdapter(id) returns a new instance per request after registry lookup. Do not cache adapter instances on the Express router.
Long-lived workers — if a worker holds a connector with sockets or session state, that worker process owns one instance per adapterId; document in the worker module.
Secrets — initialize(config, secretsRef) is the hook for KMS/HSM-backed config; REST routes still pass {} until per-rail secrets routing is implemented.

Related: gateway-adapter-registry.ts, gateway.routes.ts.