CallContext

Defined in: src/types.ts:109

Extended context with authentication info, available to handlers.

Extends

• LogContext

Properties

auth

readonly auth: AuthContext;

Defined in: src/types.ts:112

Authenticated principal for this call; AuthContext.anonymous when the request was not authenticated.

---

cookies

readonly cookies: ReadonlyMap<string, string>;

Defined in: src/types.ts:137

Incoming request cookies. Empty for non-HTTP transports.

---

externalizationEnabled?

readonly optional externalizationEnabled?: boolean;

Defined in: src/types.ts:133

True iff the server has an externalisation backend wired up.

---

kind?

readonly optional kind?: TransportKind;

Defined in: src/types.ts:116

Coarse identifier of the bound transport, or undefined until the server begins serving (the value is committed by the lifecycle hook on the very first request).

---

remainingExternalizedResponseBytes?

readonly optional remainingExternalizedResponseBytes?: number;

Defined in: src/types.ts:131

External-channel bytes left this iteration. Always a hard cap — externalised uploads have no escape valve like producer continuation tokens. Undefined when no cap is configured or externalisation is disabled.

---

remainingResponseBytes?

readonly optional remainingResponseBytes?: number;

Defined in: src/types.ts:124

Wire body bytes the framework will accept this iteration before triggering a continuation token (producer streams) or strict-fail with an EXCEPTION batch (unary / stream-exchange). Snapshot at collector construction; not live. undefined when no cap is configured or the transport doesn’t expose one (stdio).

---

session

readonly session: unknown;

Defined in: src/types.ts:153

Live sticky-session state object, or null when no session is bound to this request. HTTP-only — other transports always return null.

---

sessionId

readonly sessionId: string | null;

Defined in: src/types.ts:160

Opaque 24-char-hex session ID, or null when no session is bound. Survives closeSession so post-close access-log records still carry the id.

Methods

clientLog()

clientLog(
   level,
   message,
   extra?): void;

Defined in: src/types.ts:66

Emit a client-directed log message (sent as a zero-row log batch on the wire). level is a severity label such as "info", "warning", or "error"; extra carries optional structured string key/value pairs.

Parameters

Parameter	Type
level	string
message	string
extra?	Record<string, string>

Returns

void

Inherited from

LogContext.clientLog

---

closeSession()

closeSession(): void;

Defined in: src/types.ts:171

Invalidate the sticky session bound to this request. Idempotent.

Returns

void

---

deleteCookie()

deleteCookie(name, opts?): void;

Defined in: src/types.ts:147

Queue an unset-cookie directive on the HTTP response. Only valid inside a unary RPC method served over HTTP; throws otherwise.

Parameters

Parameter	Type
name	string
opts?	{ domain?: string; path?: string; }
opts.domain?	string
opts.path?	string

Returns

void

---

openSession()

openSession(state, ttl?): void;

Defined in: src/types.ts:168

Register a sticky session holding state for subsequent requests on this transport. HTTP-only — throws on other transports, on calls without the VGI-Session-Accept: true opt-in header, or when a session is already bound to this request.

Parameters

Parameter	Type
state	unknown
ttl?	number

Returns

void

---

setCookie()

setCookie(
   name,
   value,
   attrs?): void;

Defined in: src/types.ts:142

Queue a Set-Cookie header on the HTTP response. Only valid inside a unary RPC method served over HTTP; throws otherwise.

Parameters

Parameter	Type
name	string
value	string
attrs?	CookieAttrs

Returns

void