服務呼叫

一次內部 unary 呼叫是幾個小元件的組合。@go-like/client 把 Discovery 快照交給 Selector，再透過 Transport 完成一次 fetch。建立 Client 時使用 functional options：

import type { Context } from "@go-like/context"
import {
  newClient,
  withDiscovery,
  withEndpoint,
  withFilter,
  withSelector,
  withTransport,
  type CallRequest
} from "@go-like/client"
import {
  filterLabel,
  filterVersion,
  newRoundRobinSelector,
  type Discovery,
  type Filter
} from "@go-like/registry"
import type { Transport } from "@go-like/transport"

declare const ctx: Context
declare const discovery: Discovery
declare const serviceTransport: Transport
declare const requestBytes: Uint8Array

const client = newClient(
  withDiscovery(discovery),
  withEndpoint("discovery:///orders"),
  withSelector(newRoundRobinSelector()),
  withTransport(serviceTransport)
)
const filters: readonly Filter[] = [filterVersion("v1"), filterLabel("zone", "a")]
const request: CallRequest = {
  service: "orders",
  endpoint: "get",
  headers: { "content-type": "application/json" },
  body: requestBytes
}
const reply = await client.call(ctx, request, withFilter(...filters))
void reply

Filter、filterVersion(...) 與 filterLabel(...) 都屬於 Registry 根入口；Filter 會在 Selector.select 前依宣告順序執行。直連目標要在建構時使用 newClient(withTransport(serviceTransport), withEndpoint(serviceAddress))；withEndpoint(...) 會略過 Discovery，但仍經過與發現快照相同的 Selector。設定 Discovery 的 Client 要同時使用 withEndpoint("discovery:///<name>") 與 withDiscovery(discovery)，再依服務名稱延遲建立 watcher，並從最新完整快照選擇節點。只有確認操作可安全重播，或已經明確核准後，才以 withRetry(...) 設定有限 attempts、失敗分類與可選 backoff；每次獲准的 retry 都會從最新快照重新選擇，預設每次 call 只嘗試一次。不再使用 Client 時呼叫 client.close(ctx)。closeTimeout(...) 只限制邏輯 Transport Client 的清理時間，實體連線重用由 Transport 與 runtime 負責。

@go-like/server 把業務 handler 對應到 Transport，並公開實際 bind 位址。用 transport(...)、address(...)、middleware(...) 與 listenOption(...) 建構 Server，再於啟動前透過 server.registerHandler(...) 註冊 route；listenOption(...) 會把 provider 專屬 ListenOption 傳給 Transport.listen。endpoint(ctx) 與 start(ctx) 共用同一次真實 bind。設定為 newApp(registrar(registry), server(serviceServer)) 的 Core App，會把這個 endpoint 當成應用程式的 ServiceInstance 統一發布與撤銷。

每次 unary attempt 都會把 client-side TransportInfo 注入交給 Transport 的 Context，內容包含實際 target、穩定的 service/endpoint operation 與真實 wire headers。Server 會在呼叫業務 handler 前注入對應的 server-side 值。Client 與 Server 透過有界且規範的 Go-Like-Metadata envelope 編碼多值 Context metadata；Transport provider 只需將它當成不透明的 Fetch header。propagateToClientContext(...) 只會依照明確的 exact 或 prefix allowlist，把 server metadata 傳到下游。

呼叫會等待 feedback，以及邏輯 Transport Client 歸還 pool 或依需要關閉。成功 client 預設可以重用，poolSize(0) 才會停用保留。收到 response 後若清理失敗，AggregateError.cause 保留 response，errors 依序保存清理錯誤，不會因此重播業務呼叫。不再使用 owner 時呼叫 client.close(ctx)。

服務呼叫 ​

服務呼叫