@velajs/studio-protocol

Shared wire types, constants and boundary validators for Studio host, server and UI.

Protocol v2 introduces StudioConnection, validated with parseStudioConnection, and StudioCapabilities.operations. api.authorizeTryIt replaces in-process api.tryit: it authorizes the local host to execute actual Worker HTTP. TryItRequest and TryItResponse are validated at the host/browser boundary. Model descriptors include supports.bulkWrites for adapters with transaction support.

parseStudioResponse(op, value) validates every result against the operation's concrete Zod schema. parseStudioRpcResponse(op, value) also checks the envelope, operation identity, metadata and error fields. The browser client uses these parsers before exposing typed results; callers cannot choose an arbitrary result type. Dynamic model rows and OpenAPI documents retain their declared unknown data.

Protocol v4 names a module's visibility flag global (was isGlobal) in app.modules, as ModuleMetadata and DynamicModule do. Protocol v3 labeled the default provider lifetime default instead of singleton in app.modules and app.entrypoints. Upgrade host, server and UI together. There is no compatibility path for an earlier protocol version.

License

MIT