SAService ArchitectDocumentation

/

DocumentationFramework

Reference

Framework

Business extension APIs exposed by generated services in every supported language runtime.

Go

Extension modelGo services use `github.com/gorundebug/servicelib`. Generated graph assembly owns runtime wiring; application code supplies typed business implementations through preserved maker functions.func Make<Name>(ctx context.Context, env environment.ServiceEnvironment) (*<Name>, error)Operator functionsOperator contracts invoked by generated Go streams. Implement only the contract selected by the stream type in the designer.Map | Filter | FlatMap | KeyBy | Process | Join | MultiJoin | Delay | CaseRuntime values and outputsCore Go values passed into makers, operators, and endpoint handlers. These are the stable application-facing handles to the generated runtime.Context + Stream + Collector + EnvironmentEndpoint handlersSource and sink endpoint contracts for Go. The exact generated signature follows connector type, endpoint direction, protocol mode, input type, result type, and error type.Begin -> consume -> correlate/respond -> end

C++ userver

Extension modelC++ userver services use `cppservicelib`. Generated graph assembly owns runtime wiring; application code supplies typed business implementations through preserved maker functions.userver::engine::TaskWithResult<std::unique_ptr<Name>> MakeName(servicelib::Context, servicelib::IServiceEnvironment&)Operator functionsOperator contracts invoked by generated C++ userver streams. Implement only the contract selected by the stream type in the designer.Map | Filter | FlatMap | KeyBy | Process | Join | MultiJoin | Delay | CaseRuntime values and outputsCore C++ userver values passed into makers, operators, and endpoint handlers. These are the stable application-facing handles to the generated runtime.Context + Stream + Collector + EnvironmentEndpoint handlersSource and sink endpoint contracts for C++ userver. The exact generated signature follows connector type, endpoint direction, protocol mode, input type, result type, and error type.Begin -> consume -> correlate/respond -> end

C++ Coro

Extension modelC++ Coro services use cppcoroservicelib. Generated graph assembly owns runtime wiring; application code supplies typed business implementations through preserved maker functions.boost::asio::awaitable<std::unique_ptr<Name>> MakeName(servicelib::Context, servicelib::IServiceEnvironment&)Operator functionsOperator contracts invoked by generated C++ Coro streams. Implement only the contract selected by the stream type in the designer.Map | Filter | FlatMap | KeyBy | Process | Join | MultiJoin | Delay | CaseRuntime values and outputsCore C++ Coro values passed into makers, operators, and endpoint handlers. These are the stable application-facing handles to the generated runtime.Context + Stream + Collector + EnvironmentEndpoint handlersSource and sink endpoint contracts for C++ Coro. The exact generated signature follows connector type, endpoint direction, protocol mode, input type, result type, and error type.Begin -> consume -> correlate/respond -> end

Python

Extension modelPython services use `pyservicelib_gorundebug`. Generated graph assembly owns runtime wiring; application code supplies typed business implementations through preserved maker functions.async def make_<name>(ctx: Context, environment: ServiceEnvironment) -> <Name>Operator functionsOperator contracts invoked by generated Python streams. Implement only the contract selected by the stream type in the designer.Map | Filter | FlatMap | KeyBy | Process | Join | MultiJoin | Delay | CaseRuntime values and outputsCore Python values passed into makers, operators, and endpoint handlers. These are the stable application-facing handles to the generated runtime.Context + Stream + Collector + EnvironmentEndpoint handlersSource and sink endpoint contracts for Python. The exact generated signature follows connector type, endpoint direction, protocol mode, input type, result type, and error type.Begin -> consume -> correlate/respond -> end

Rust

Extension modelRust services use `servicelib` crate from `rustservicelib`. Generated graph assembly owns runtime wiring; application code supplies typed business implementations through preserved maker functions.pub async fn make_<name>(context: MessageContext, environment: RuntimeEnvironment) -> RuntimeResult<<Name>>Operator functionsOperator contracts invoked by generated Rust streams. Implement only the contract selected by the stream type in the designer.Map | Filter | FlatMap | KeyBy | Process | Join | MultiJoin | Delay | CaseRuntime values and outputsCore Rust values passed into makers, operators, and endpoint handlers. These are the stable application-facing handles to the generated runtime.Context + Stream + Collector + EnvironmentEndpoint handlersSource and sink endpoint contracts for Rust. The exact generated signature follows connector type, endpoint direction, protocol mode, input type, result type, and error type.Begin -> consume -> correlate/respond -> end

TypeScript

Extension modelTypeScript services use `@gorundebug/tsservicelib`. Generated graph assembly owns runtime wiring; application code supplies typed business implementations through preserved maker functions.export async function make<Name>(context: MessageContext, environment: RuntimeEnvironment): Promise<<Name>>Operator functionsOperator contracts invoked by generated TypeScript streams. Implement only the contract selected by the stream type in the designer.Map | Filter | FlatMap | KeyBy | Process | Join | MultiJoin | Delay | CaseRuntime values and outputsCore TypeScript values passed into makers, operators, and endpoint handlers. These are the stable application-facing handles to the generated runtime.Context + Stream + Collector + EnvironmentEndpoint handlersSource and sink endpoint contracts for TypeScript. The exact generated signature follows connector type, endpoint direction, protocol mode, input type, result type, and error type.Begin -> consume -> correlate/respond -> end