a collection of lightweight TypeScript packages for AT Protocol, the protocol powering Bluesky
atproto
bluesky
typescript
npm
docs(xrpc-server): clarify UnknownOperationContext.input semantics
explain that `input` is only populated for declared lex JSON bodies.
blob-input procedures get `undefined` here; the handler reads
`request.body` as a stream.
+8
+8
packages/servers/xrpc-server/lib/main/types/operation.ts
+8
packages/servers/xrpc-server/lib/main/types/operation.ts
···
12
12
import type { Literal, Promisable } from '../../types/misc.ts';
13
13
import type { JSONResponse } from '../response.ts';
14
14
15
+
/**
16
+
* untyped variant of {@link QueryContext} / {@link ProcedureContext}.
17
+
*
18
+
* `input` is set only when the lexicon declares a `lex` input body and the
19
+
* request JSON parsed successfully. for blob inputs (and for procedures that
20
+
* declare no input at all) it is `undefined`; handlers that expect a blob
21
+
* should stream from `request.body` directly.
22
+
*/
15
23
export type UnknownOperationContext = {
16
24
request: Request;
17
25
signal: AbortSignal;