Gateway outbox worker, MQ wrap, thirdweb adapter updates, and SolaceNet docs.
Made-with: Cursor
This commit is contained in:
11
docs/solacenet/GATEWAY_ADAPTER_LIFECYCLE.md
Normal file
11
docs/solacenet/GATEWAY_ADAPTER_LIFECYCLE.md
Normal file
@@ -0,0 +1,11 @@
|
||||
# Gateway rail adapter lifecycle (DI policy)
|
||||
|
||||
**Gap:** PG-GW-W01 (singleton vs per-request).
|
||||
|
||||
**Policy (until superseded by performance review):**
|
||||
|
||||
1. **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.
|
||||
2. **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.
|
||||
3. **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`.
|
||||
Reference in New Issue
Block a user