{ "schemaVersion": "2.0", "id": 89, "name": "@probitas-test/client-connectrpc", "variant": "project", "kind": 1, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC client for [Probitas](https://github.com/probitas-test/probitas) scenario testing framework.\n\nThis package provides a ConnectRPC-based client with Server Reflection support,\ndesigned for integration testing of gRPC and Connect protocol services.\n\n## Features\n\n- **Protocol Support**: Connect, gRPC, and gRPC-Web protocols\n- **Server Reflection**: Auto-discover services and methods at runtime\n- **TLS Support**: Configure secure connections with custom certificates\n- **Duration Tracking**: Built-in timing for performance monitoring\n- **Error Handling**: Test error responses without throwing exceptions\n- **Resource Management**: Implements " }, { "kind": "code", "text": "`AsyncDisposable`" }, { "kind": "text", "text": " for proper cleanup\n\n## Installation\n\n" }, { "kind": "code", "text": "```bash\nnpm install @probitas-test/client-connectrpc\n```" }, { "kind": "text", "text": "\n\n## Quick Start\n\n" }, { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\n// Create client (uses reflection by default)\nconst client = createConnectRpcClient({\n url: \"http://localhost:50051\",\n});\n\n// Discover services via reflection\nconst services = await client.reflection.listServices();\nconsole.log(\"Available services:\", services);\n\n// Get service info\nconst info = await client.reflection.getServiceInfo(\"echo.EchoService\");\nconsole.log(\"Methods:\", info.methods);\n\n// Call a method\nconst response = await client.call(\n \"echo.EchoService\",\n \"echo\",\n { message: \"Hello!\" }\n);\nconsole.log(response.data);\n\nawait client.close();\n```" }, { "kind": "text", "text": "\n\n## Testing Error Responses\n\n" }, { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\nconst client = createConnectRpcClient({ url: \"http://localhost:50051\" });\n\n// Test error responses without throwing\nconst errorResponse = await client.call(\n \"echo.EchoService\",\n \"echo\",\n { invalid: true },\n { throwOnError: false }\n);\n\nif (!errorResponse.ok) {\n console.log(\"Error code:\", errorResponse.statusCode); // INVALID_ARGUMENT = 3\n}\nawait client.close();\n```" }, { "kind": "text", "text": "\n\n## Using with " }, { "kind": "code", "text": "`using`" }, { "kind": "text", "text": " Statement\n\n" }, { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\nawait using client = createConnectRpcClient({ url: \"http://localhost:50051\" });\n\nconst res = await client.call(\"echo.EchoService\", \"echo\", { message: \"test\" });\nconsole.log(res.data);\n// Client automatically closed when block exits\n```" }, { "kind": "text", "text": "\n\n## Related Packages\n\n| Package | Description |\n|---------|-------------|\n| [" }, { "kind": "code", "text": "`@probitas-test/client`" }, { "kind": "text", "text": "](https://www.npmjs.com/package/@probitas-test/client) | Core utilities and types |\n| [" }, { "kind": "code", "text": "`@probitas-test/client-grpc`" }, { "kind": "text", "text": "](https://www.npmjs.com/package/@probitas-test/client-grpc) | gRPC client (wrapper with " }, { "kind": "code", "text": "`protocol: \"grpc\"`" }, { "kind": "text", "text": ") |\n\n## Links\n\n- [GitHub Repository](https://github.com/probitas-test/probitas-packages)\n- [Probitas Framework](https://github.com/probitas-test/probitas)\n- [ConnectRPC](https://connectrpc.com/)" } ] }, "children": [ { "id": 182, "name": "ConnectRpcError", "variant": "declaration", "kind": 128, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Error class for ConnectRPC/gRPC errors.\n\nUse " }, { "kind": "code", "text": "`statusCode`" }, { "kind": "text", "text": " to distinguish between different gRPC error codes." } ] }, "children": [ { "id": 183, "name": "constructor", "variant": "declaration", "kind": 512, "flags": {}, "signatures": [ { "id": 184, "name": "ConnectRpcError", "variant": "signature", "kind": 16384, "flags": {}, "parameters": [ { "id": 185, "name": "message", "variant": "param", "kind": 32768, "flags": {}, "type": { "type": "intrinsic", "name": "string" } }, { "id": 186, "name": "statusCode", "variant": "param", "kind": 32768, "flags": {}, "type": { "type": "reference", "target": 164, "name": "ConnectRpcStatusCode", "package": "@probitas-test/client-connectrpc" } }, { "id": 187, "name": "statusMessage", "variant": "param", "kind": 32768, "flags": {}, "type": { "type": "intrinsic", "name": "string" } }, { "id": 188, "name": "options", "variant": "param", "kind": 32768, "flags": { "isOptional": true }, "type": { "type": "reference", "target": 179, "name": "ConnectRpcErrorOptions", "package": "@probitas-test/client-connectrpc" } } ], "type": { "type": "reference", "target": 182, "name": "ConnectRpcError", "package": "@probitas-test/client-connectrpc" }, "overwrites": { "type": "reference", "target": -1, "name": "ClientError.constructor", "package": "@probitas-test/client" } } ], "overwrites": { "type": "reference", "target": -1, "name": "ClientError.constructor", "package": "@probitas-test/client" } }, { "id": 194, "name": "details", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "typeOperator", "operator": "readonly", "target": { "type": "array", "elementType": { "type": "reference", "target": 176, "name": "ErrorDetail", "package": "@probitas-test/client-connectrpc" } } } }, { "id": 190, "name": "kind", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": "connectrpc" }, "defaultValue": "...", "overwrites": { "type": "reference", "target": -1, "name": "ClientError.kind" } }, { "id": 193, "name": "metadata", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "union", "types": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" }, { "type": "literal", "value": null } ] } }, { "id": 189, "name": "name", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "intrinsic", "name": "string" }, "defaultValue": "\"ConnectRpcError\"", "overwrites": { "type": "reference", "target": -1, "name": "ClientError.name" } }, { "id": 191, "name": "statusCode", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": 164, "name": "ConnectRpcStatusCode", "package": "@probitas-test/client-connectrpc" } }, { "id": 192, "name": "statusMessage", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "intrinsic", "name": "string" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/errors.d.ts", "qualifiedName": "ClientError" }, "name": "ClientError", "package": "@probitas-test/client" } ] }, { "id": 169, "name": "ConnectRpcNetworkError", "variant": "declaration", "kind": 128, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Error thrown when a network-level failure occurs.\n\nThis error indicates that the request could not be processed by the server\ndue to network issues (connection refused, DNS resolution failure, timeout, etc.).\nUnlike ConnectRpcError, this error means the server was never reached." } ] }, "children": [ { "id": 170, "name": "constructor", "variant": "declaration", "kind": 512, "flags": {}, "signatures": [ { "id": 171, "name": "ConnectRpcNetworkError", "variant": "signature", "kind": 16384, "flags": {}, "parameters": [ { "id": 172, "name": "message", "variant": "param", "kind": 32768, "flags": {}, "type": { "type": "intrinsic", "name": "string" } }, { "id": 173, "name": "options", "variant": "param", "kind": 32768, "flags": { "isOptional": true }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es2022.error.d.ts", "qualifiedName": "ErrorOptions" }, "name": "ErrorOptions", "package": "typescript" } } ], "type": { "type": "reference", "target": 169, "name": "ConnectRpcNetworkError", "package": "@probitas-test/client-connectrpc" }, "overwrites": { "type": "reference", "target": -1, "name": "ClientError.constructor", "package": "@probitas-test/client" } } ], "overwrites": { "type": "reference", "target": -1, "name": "ClientError.constructor", "package": "@probitas-test/client" } }, { "id": 175, "name": "kind", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": "connectrpc" }, "defaultValue": "...", "overwrites": { "type": "reference", "target": -1, "name": "ClientError.kind" } }, { "id": 174, "name": "name", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "intrinsic", "name": "string" }, "defaultValue": "\"ConnectRpcNetworkError\"", "overwrites": { "type": "reference", "target": -1, "name": "ClientError.name" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/errors.d.ts", "qualifiedName": "ClientError" }, "name": "ClientError", "package": "@probitas-test/client" } ] }, { "id": 280, "name": "ConnectRpcClient", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC client interface.\n\n## Field Name Conventions\n\nThis client automatically handles field name conversion between protobuf and JavaScript:\n\n- **Request fields**: Accept both " }, { "kind": "code", "text": "`snake_case`" }, { "kind": "text", "text": " (protobuf style) and " }, { "kind": "code", "text": "`camelCase`" }, { "kind": "text", "text": " (JavaScript style)\n- **Response fields**: Converted to JavaScript conventions based on response type:\n - " }, { "kind": "code", "text": "`response.data`" }, { "kind": "text", "text": ": Plain JSON object with " }, { "kind": "code", "text": "`camelCase`" }, { "kind": "text", "text": " field names (no " }, { "kind": "code", "text": "`$typeName`" }, { "kind": "text", "text": ")\n - " }, { "kind": "code", "text": "`response.raw`" }, { "kind": "text", "text": ": Original protobuf Message object with all metadata (includes " }, { "kind": "code", "text": "`$typeName`" }, { "kind": "text", "text": ")" } ], "blockTags": [ { "tag": "@example", "content": [ { "kind": "code", "text": "```ts\nconst client = createConnectRpcClient({ url: \"http://localhost:50051\" });\n\n// Request: Both formats work\nawait client.call(\"echo.Echo\", \"echoWithDelay\", {\n message: \"hello\",\n delayMs: 100, // camelCase (recommended)\n // delay_ms: 100, // snake_case also works\n});\n\n// Response: data is JSON, raw is protobuf Message\nconst response = await client.call(\"echo.Echo\", \"echo\", { message: \"test\" });\nconsole.log(response.data); // { message: \"test\", metadata: {...} }\nconsole.log(response.raw); // { $typeName: \"echo.EchoResponse\", message: \"test\", ... }\n```" } ] } ] }, "children": [ { "id": 281, "name": "config", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Client configuration" } ] }, "type": { "type": "reference", "target": 105, "name": "ConnectRpcClientConfig", "package": "@probitas-test/client-connectrpc" } }, { "id": 282, "name": "reflection", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Reflection API (only available when schema: \"reflection\")" } ] }, "type": { "type": "reference", "target": 267, "name": "ReflectionApi", "package": "@probitas-test/client-connectrpc" } }, { "id": 304, "name": "bidiStream", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 305, "name": "bidiStream", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Make a bidirectional streaming RPC call." } ] }, "typeParameters": [ { "id": 306, "name": "TRequest", "variant": "typeParam", "kind": 131072, "flags": {} } ], "parameters": [ { "id": 307, "name": "serviceName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Service name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 308, "name": "methodName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Method name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 309, "name": "requests", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Async iterable of request messages" } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es2018.asynciterable.d.ts", "qualifiedName": "AsyncIterable" }, "typeArguments": [ { "type": "reference", "target": 306, "name": "TRequest", "package": "@probitas-test/client-connectrpc", "refersToTypeParameter": true } ], "name": "AsyncIterable", "package": "typescript" } }, { "id": 310, "name": "options", "variant": "param", "kind": 32768, "flags": { "isOptional": true }, "comment": { "summary": [ { "kind": "text", "text": "Call options" } ] }, "type": { "type": "reference", "target": 117, "name": "ConnectRpcOptions", "package": "@probitas-test/client-connectrpc" } } ], "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es2018.asynciterable.d.ts", "qualifiedName": "AsyncIterable" }, "typeArguments": [ { "type": "reference", "target": 313, "name": "ConnectRpcResponse", "package": "@probitas-test/client-connectrpc" } ], "name": "AsyncIterable", "package": "typescript" } } ] }, { "id": 283, "name": "call", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 284, "name": "call", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Make a unary RPC call." } ] }, "typeParameters": [ { "id": 285, "name": "TRequest", "variant": "typeParam", "kind": 131072, "flags": {} } ], "parameters": [ { "id": 286, "name": "serviceName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Service name (e.g., \"echo.EchoService\")" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 287, "name": "methodName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Method name (e.g., \"echo\")" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 288, "name": "request", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Request message" } ] }, "type": { "type": "reference", "target": 285, "name": "TRequest", "package": "@probitas-test/client-connectrpc", "refersToTypeParameter": true } }, { "id": 289, "name": "options", "variant": "param", "kind": 32768, "flags": { "isOptional": true }, "comment": { "summary": [ { "kind": "text", "text": "Call options" } ] }, "type": { "type": "reference", "target": 117, "name": "ConnectRpcOptions", "package": "@probitas-test/client-connectrpc" } } ], "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Promise" }, "typeArguments": [ { "type": "reference", "target": 313, "name": "ConnectRpcResponse", "package": "@probitas-test/client-connectrpc" } ], "name": "Promise", "package": "typescript" } } ] }, { "id": 297, "name": "clientStream", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 298, "name": "clientStream", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Make a client streaming RPC call." } ] }, "typeParameters": [ { "id": 299, "name": "TRequest", "variant": "typeParam", "kind": 131072, "flags": {} } ], "parameters": [ { "id": 300, "name": "serviceName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Service name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 301, "name": "methodName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Method name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 302, "name": "requests", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Async iterable of request messages" } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es2018.asynciterable.d.ts", "qualifiedName": "AsyncIterable" }, "typeArguments": [ { "type": "reference", "target": 299, "name": "TRequest", "package": "@probitas-test/client-connectrpc", "refersToTypeParameter": true } ], "name": "AsyncIterable", "package": "typescript" } }, { "id": 303, "name": "options", "variant": "param", "kind": 32768, "flags": { "isOptional": true }, "comment": { "summary": [ { "kind": "text", "text": "Call options" } ] }, "type": { "type": "reference", "target": 117, "name": "ConnectRpcOptions", "package": "@probitas-test/client-connectrpc" } } ], "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Promise" }, "typeArguments": [ { "type": "reference", "target": 313, "name": "ConnectRpcResponse", "package": "@probitas-test/client-connectrpc" } ], "name": "Promise", "package": "typescript" } } ] }, { "id": 311, "name": "close", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 312, "name": "close", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Close the client connection." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Promise" }, "typeArguments": [ { "type": "intrinsic", "name": "void" } ], "name": "Promise", "package": "typescript" } } ] }, { "id": 290, "name": "serverStream", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 291, "name": "serverStream", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Make a server streaming RPC call." } ] }, "typeParameters": [ { "id": 292, "name": "TRequest", "variant": "typeParam", "kind": 131072, "flags": {} } ], "parameters": [ { "id": 293, "name": "serviceName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Service name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 294, "name": "methodName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Method name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 295, "name": "request", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Request message" } ] }, "type": { "type": "reference", "target": 292, "name": "TRequest", "package": "@probitas-test/client-connectrpc", "refersToTypeParameter": true } }, { "id": 296, "name": "options", "variant": "param", "kind": 32768, "flags": { "isOptional": true }, "comment": { "summary": [ { "kind": "text", "text": "Call options" } ] }, "type": { "type": "reference", "target": 117, "name": "ConnectRpcOptions", "package": "@probitas-test/client-connectrpc" } } ], "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es2018.asynciterable.d.ts", "qualifiedName": "AsyncIterable" }, "typeArguments": [ { "type": "reference", "target": 313, "name": "ConnectRpcResponse", "package": "@probitas-test/client-connectrpc" } ], "name": "AsyncIterable", "package": "typescript" } } ] } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.esnext.disposable.d.ts", "qualifiedName": "AsyncDisposable" }, "name": "AsyncDisposable", "package": "typescript" } ] }, { "id": 105, "name": "ConnectRpcClientConfig", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Configuration for creating a ConnectRPC client." } ] }, "children": [ { "id": 108, "name": "httpVersion", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "HTTP version to use." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\n\"2\"\n```" } ] } ] }, "type": { "type": "reference", "target": 92, "name": "HttpVersion", "package": "@probitas-test/client-connectrpc" } }, { "id": 110, "name": "metadata", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Default metadata to send with every request." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "HeadersInit" }, "name": "HeadersInit", "package": "typescript" } }, { "id": 107, "name": "protocol", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Protocol to use." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\n\"grpc\"\n```" } ] } ] }, "type": { "type": "reference", "target": 91, "name": "ConnectProtocol", "package": "@probitas-test/client-connectrpc" } }, { "id": 116, "name": "retry", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Retry configuration." } ] }, "type": { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/types.d.ts", "qualifiedName": "RetryOptions" }, "name": "RetryOptions", "package": "@probitas-test/client" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonOptions.retry" } }, { "id": 111, "name": "schema", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Schema resolution configuration.\n- \"reflection\": Use Server Reflection to discover services dynamically (default)\n- string: Path to FileDescriptorSet binary file (from " }, { "kind": "code", "text": "`buf build --output set.binpb`" }, { "kind": "text", "text": ")\n- Uint8Array: FileDescriptorSet binary data\n- FileDescriptorSet: Pre-parsed FileDescriptorSet message object" } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\n\"reflection\"\n```" } ] } ] }, "type": { "type": "union", "types": [ { "type": "intrinsic", "name": "string" }, { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Uint8Array" }, "typeArguments": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "ArrayBufferLike" }, "name": "ArrayBufferLike", "package": "typescript" } ], "name": "Uint8Array", "package": "typescript" }, { "type": "reference", "target": { "packageName": "@bufbuild/protobuf", "packagePath": "dist/esm/wkt/google/protobuf/descriptor_pb.d.ts", "qualifiedName": "FileDescriptorSet" }, "name": "FileDescriptorSet", "package": "@bufbuild/protobuf" } ] } }, { "id": 115, "name": "signal", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "AbortSignal for cancellation." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "AbortSignal" }, "name": "AbortSignal", "package": "typescript" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonOptions.signal" } }, { "id": 113, "name": "throwOnError", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether to throw ConnectRpcError on non-OK responses (code !== 0) or failures.\nCan be overridden per-request via ConnectRpcOptions.throwOnError." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\nfalse\n```" } ] } ] }, "type": { "type": "intrinsic", "name": "boolean" } }, { "id": 114, "name": "timeout", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Timeout in milliseconds." } ] }, "type": { "type": "intrinsic", "name": "number" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonOptions.timeout" } }, { "id": 109, "name": "tls", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "TLS configuration. If not provided, uses insecure credentials." } ] }, "type": { "type": "reference", "target": 93, "name": "TlsConfig", "package": "@probitas-test/client-connectrpc" } }, { "id": 106, "name": "url", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Server URL for ConnectRPC connections.\n\nCan be a URL string or a connection configuration object." } ], "blockTags": [ { "tag": "@example", "name": "String URL", "content": [ { "kind": "code", "text": "```ts\nimport type { ConnectRpcClientConfig } from \"@probitas-test/client-connectrpc\";\nconst config: ConnectRpcClientConfig = { url: \"http://localhost:50051\" };\n```" } ] }, { "tag": "@example", "name": "Connection config object", "content": [ { "kind": "code", "text": "```ts\nimport type { ConnectRpcClientConfig } from \"@probitas-test/client-connectrpc\";\nconst config: ConnectRpcClientConfig = {\n url: { host: \"grpc.example.com\", port: 443, protocol: \"https\" },\n};\n```" } ] } ] }, "type": { "type": "union", "types": [ { "type": "intrinsic", "name": "string" }, { "type": "reference", "target": 98, "name": "ConnectRpcConnectionConfig", "package": "@probitas-test/client-connectrpc" } ] } }, { "id": 112, "name": "useBinaryFormat", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether to use binary format for messages." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\ntrue\n```" } ] } ] }, "type": { "type": "intrinsic", "name": "boolean" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/types.d.ts", "qualifiedName": "CommonOptions" }, "name": "CommonOptions", "package": "@probitas-test/client" } ] }, { "id": 98, "name": "ConnectRpcConnectionConfig", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC connection configuration.\n\nExtends CommonConnectionConfig with ConnectRPC-specific options." } ] }, "children": [ { "id": 101, "name": "host", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Hostname or IP address." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\n\"localhost\"\n```" } ] } ] }, "type": { "type": "intrinsic", "name": "string" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonConnectionConfig.host" } }, { "id": 104, "name": "password", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Password for authentication." } ] }, "type": { "type": "intrinsic", "name": "string" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonConnectionConfig.password" } }, { "id": 100, "name": "path", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Service path prefix." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\n\"\"\n```" } ] } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 102, "name": "port", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Port number. Each service has its own default." } ] }, "type": { "type": "intrinsic", "name": "number" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonConnectionConfig.port" } }, { "id": 99, "name": "protocol", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Protocol to use." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\n\"http\"\n```" } ] } ] }, "type": { "type": "union", "types": [ { "type": "literal", "value": "http" }, { "type": "literal", "value": "https" } ] } }, { "id": 103, "name": "username", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Username for authentication." } ] }, "type": { "type": "intrinsic", "name": "string" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonConnectionConfig.username" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/types.d.ts", "qualifiedName": "CommonConnectionConfig" }, "name": "CommonConnectionConfig", "package": "@probitas-test/client" } ] }, { "id": 179, "name": "ConnectRpcErrorOptions", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Options for ConnectRpcError construction." } ] }, "children": [ { "id": 181, "name": "details", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Rich error details from google.rpc.Status." } ] }, "type": { "type": "union", "types": [ { "type": "typeOperator", "operator": "readonly", "target": { "type": "array", "elementType": { "type": "reference", "target": 176, "name": "ErrorDetail", "package": "@probitas-test/client-connectrpc" } } }, { "type": "literal", "value": null } ] } }, { "id": 180, "name": "metadata", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Headers/metadata from the ConnectRPC response." } ] }, "type": { "type": "union", "types": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" }, { "type": "literal", "value": null } ] } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es2022.error.d.ts", "qualifiedName": "ErrorOptions" }, "name": "ErrorOptions", "package": "typescript" } ] }, { "id": 117, "name": "ConnectRpcOptions", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Options for individual ConnectRPC calls." } ] }, "children": [ { "id": 118, "name": "metadata", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Metadata to send with the request." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "HeadersInit" }, "name": "HeadersInit", "package": "typescript" } }, { "id": 122, "name": "retry", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Retry configuration." } ] }, "type": { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/types.d.ts", "qualifiedName": "RetryOptions" }, "name": "RetryOptions", "package": "@probitas-test/client" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonOptions.retry" } }, { "id": 121, "name": "signal", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "AbortSignal for cancellation." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "AbortSignal" }, "name": "AbortSignal", "package": "typescript" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonOptions.signal" } }, { "id": 119, "name": "throwOnError", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether to throw ConnectRpcError on non-OK responses (code !== 0) or failures.\nOverrides ConnectRpcClientConfig.throwOnError." } ], "blockTags": [ { "tag": "@default", "content": [ { "kind": "code", "text": "```ts\nfalse (inherited from client config if not specified)\n```" } ] } ] }, "type": { "type": "intrinsic", "name": "boolean" } }, { "id": 120, "name": "timeout", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Timeout in milliseconds." } ] }, "type": { "type": "intrinsic", "name": "number" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "CommonOptions.timeout" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/types.d.ts", "qualifiedName": "CommonOptions" }, "name": "CommonOptions", "package": "@probitas-test/client" } ] }, { "id": 315, "name": "ConnectRpcResponseError", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC response with gRPC error (statusCode !== 0).\n\nThe server processed the request but returned an error status." } ] }, "children": [ { "id": 325, "name": "data", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "No data for error responses." } ] }, "type": { "type": "literal", "value": null }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.data", "package": "@probitas-test/client-connectrpc" } }, { "id": 327, "name": "duration", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Response time in milliseconds." } ] }, "type": { "type": "intrinsic", "name": "number" }, "inheritedFrom": { "type": "reference", "target": 340, "name": "ConnectRpcResponseBase.duration", "package": "@probitas-test/client-connectrpc" } }, { "id": 319, "name": "error", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Error information (null if successful).\n\nContains:\n- ConnectRpcError for gRPC errors\n- ConnectRpcNetworkError/AbortError/TimeoutError for failures" } ] }, "type": { "type": "reference", "target": 182, "name": "ConnectRpcError", "package": "@probitas-test/client-connectrpc" }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.error", "package": "@probitas-test/client-connectrpc" } }, { "id": 322, "name": "headers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Response headers." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } }, { "id": 326, "name": "kind", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Result kind discriminator.\n\nAlways " }, { "kind": "code", "text": "`\"connectrpc\"`" }, { "kind": "text", "text": " for ConnectRPC responses. Use this in switch statements\nfor type-safe narrowing of union types." } ] }, "type": { "type": "literal", "value": "connectrpc" }, "inheritedFrom": { "type": "reference", "target": 339, "name": "ConnectRpcResponseBase.kind", "package": "@probitas-test/client-connectrpc" } }, { "id": 318, "name": "ok", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether the request was successful.\n\n- " }, { "kind": "code", "text": "`true`" }, { "kind": "text", "text": ": statusCode === 0 (OK)\n- " }, { "kind": "code", "text": "`false`" }, { "kind": "text", "text": ": gRPC error or request failure" } ] }, "type": { "type": "literal", "value": false }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.ok", "package": "@probitas-test/client-connectrpc" } }, { "id": 317, "name": "processed", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether the request was processed by the server.\n\n- " }, { "kind": "code", "text": "`true`" }, { "kind": "text", "text": ": Server responded (success or gRPC error)\n- " }, { "kind": "code", "text": "`false`" }, { "kind": "text", "text": ": Request failed before processing (network error, connection refused)" } ] }, "type": { "type": "literal", "value": true }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.processed", "package": "@probitas-test/client-connectrpc" } }, { "id": 324, "name": "raw", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Raw ConnectError." } ] }, "type": { "type": "reference", "target": { "packageName": "@connectrpc/connect", "packagePath": "dist/esm/connect-error.d.ts", "qualifiedName": "ConnectError" }, "name": "ConnectError", "package": "@connectrpc/connect" }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.raw", "package": "@probitas-test/client-connectrpc" } }, { "id": 320, "name": "statusCode", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "gRPC status code (1-16)." } ] }, "type": { "type": "reference", "target": 164, "name": "ConnectRpcStatusCode", "package": "@probitas-test/client-connectrpc" } }, { "id": 321, "name": "statusMessage", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Status message describing the error." } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 323, "name": "trailers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Response trailers (sent at end of RPC)." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } } ], "typeParameters": [ { "id": 316, "name": "T", "variant": "typeParam", "kind": 131072, "flags": {}, "default": { "type": "intrinsic", "name": "any" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client-connectrpc", "packagePath": "response.ts", "qualifiedName": "ConnectRpcResponseBase" }, "typeArguments": [ { "type": "reference", "target": 316, "name": "T", "package": "@probitas-test/client-connectrpc", "qualifiedName": "ConnectRpcResponseError.T", "refersToTypeParameter": true } ], "name": "ConnectRpcResponseBase", "package": "@probitas-test/client-connectrpc" } ] }, { "id": 204, "name": "ConnectRpcResponseErrorParams", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Parameters for creating an error ConnectRpcResponse." } ] }, "children": [ { "id": 209, "name": "duration", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "intrinsic", "name": "number" } }, { "id": 205, "name": "error", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": { "packageName": "@connectrpc/connect", "packagePath": "dist/esm/connect-error.d.ts", "qualifiedName": "ConnectError" }, "name": "ConnectError", "package": "@connectrpc/connect" } }, { "id": 207, "name": "headers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } }, { "id": 206, "name": "rpcError", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": 182, "name": "ConnectRpcError", "package": "@probitas-test/client-connectrpc" } }, { "id": 208, "name": "trailers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } } ] }, { "id": 328, "name": "ConnectRpcResponseFailure", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Failed ConnectRPC request (network error, connection refused, etc.).\n\nThe request did not reach gRPC processing." } ] }, "children": [ { "id": 338, "name": "data", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "No data (request didn't reach server)." } ] }, "type": { "type": "literal", "value": null }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.data", "package": "@probitas-test/client-connectrpc" } }, { "id": 340, "name": "duration", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Response time in milliseconds." } ] }, "type": { "type": "intrinsic", "name": "number" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.duration" } }, { "id": 332, "name": "error", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Error information (null if successful).\n\nContains:\n- ConnectRpcError for gRPC errors\n- ConnectRpcNetworkError/AbortError/TimeoutError for failures" } ] }, "type": { "type": "reference", "target": 195, "name": "ConnectRpcFailureError", "package": "@probitas-test/client-connectrpc" }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.error", "package": "@probitas-test/client-connectrpc" } }, { "id": 335, "name": "headers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Response headers (null for failures)." } ] }, "type": { "type": "literal", "value": null } }, { "id": 339, "name": "kind", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Result kind discriminator.\n\nAlways " }, { "kind": "code", "text": "`\"connectrpc\"`" }, { "kind": "text", "text": " for ConnectRPC responses. Use this in switch statements\nfor type-safe narrowing of union types." } ] }, "type": { "type": "literal", "value": "connectrpc" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.kind" } }, { "id": 331, "name": "ok", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether the request was successful.\n\n- " }, { "kind": "code", "text": "`true`" }, { "kind": "text", "text": ": statusCode === 0 (OK)\n- " }, { "kind": "code", "text": "`false`" }, { "kind": "text", "text": ": gRPC error or request failure" } ] }, "type": { "type": "literal", "value": false }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.ok", "package": "@probitas-test/client-connectrpc" } }, { "id": 330, "name": "processed", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether the request was processed by the server.\n\n- " }, { "kind": "code", "text": "`true`" }, { "kind": "text", "text": ": Server responded (success or gRPC error)\n- " }, { "kind": "code", "text": "`false`" }, { "kind": "text", "text": ": Request failed before processing (network error, connection refused)" } ] }, "type": { "type": "literal", "value": false }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.processed", "package": "@probitas-test/client-connectrpc" } }, { "id": 337, "name": "raw", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "No raw response (request didn't reach server)." } ] }, "type": { "type": "literal", "value": null }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.raw", "package": "@probitas-test/client-connectrpc" } }, { "id": 333, "name": "statusCode", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Status code (null for network failures)." } ] }, "type": { "type": "literal", "value": null } }, { "id": 334, "name": "statusMessage", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Status message (null for network failures)." } ] }, "type": { "type": "literal", "value": null } }, { "id": 336, "name": "trailers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Response trailers (null for failures)." } ] }, "type": { "type": "literal", "value": null } } ], "typeParameters": [ { "id": 329, "name": "T", "variant": "typeParam", "kind": 131072, "flags": {}, "default": { "type": "intrinsic", "name": "any" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client-connectrpc", "packagePath": "response.ts", "qualifiedName": "ConnectRpcResponseBase" }, "typeArguments": [ { "type": "reference", "target": 329, "name": "T", "package": "@probitas-test/client-connectrpc", "qualifiedName": "ConnectRpcResponseFailure.T", "refersToTypeParameter": true } ], "name": "ConnectRpcResponseBase", "package": "@probitas-test/client-connectrpc" } ] }, { "id": 210, "name": "ConnectRpcResponseFailureParams", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Parameters for creating a failure ConnectRpcResponse." } ] }, "children": [ { "id": 212, "name": "duration", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "intrinsic", "name": "number" } }, { "id": 211, "name": "error", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": 195, "name": "ConnectRpcFailureError", "package": "@probitas-test/client-connectrpc" } } ] }, { "id": 341, "name": "ConnectRpcResponseSuccess", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Successful ConnectRPC response (statusCode === 0)." } ] }, "children": [ { "id": 351, "name": "data", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Response data as plain JavaScript object (JSON representation)." } ] }, "type": { "type": "union", "types": [ { "type": "reference", "target": 342, "name": "T", "package": "@probitas-test/client-connectrpc", "qualifiedName": "ConnectRpcResponseSuccess.T", "refersToTypeParameter": true }, { "type": "literal", "value": null } ] }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.data", "package": "@probitas-test/client-connectrpc" } }, { "id": 353, "name": "duration", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Response time in milliseconds." } ] }, "type": { "type": "intrinsic", "name": "number" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.duration" } }, { "id": 345, "name": "error", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Error information (null if successful).\n\nContains:\n- ConnectRpcError for gRPC errors\n- ConnectRpcNetworkError/AbortError/TimeoutError for failures" } ] }, "type": { "type": "literal", "value": null }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.error", "package": "@probitas-test/client-connectrpc" } }, { "id": 348, "name": "headers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Response headers." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } }, { "id": 352, "name": "kind", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true, "isInherited": true }, "comment": { "summary": [ { "kind": "text", "text": "Result kind discriminator.\n\nAlways " }, { "kind": "code", "text": "`\"connectrpc\"`" }, { "kind": "text", "text": " for ConnectRPC responses. Use this in switch statements\nfor type-safe narrowing of union types." } ] }, "type": { "type": "literal", "value": "connectrpc" }, "inheritedFrom": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.kind" } }, { "id": 344, "name": "ok", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether the request was successful.\n\n- " }, { "kind": "code", "text": "`true`" }, { "kind": "text", "text": ": statusCode === 0 (OK)\n- " }, { "kind": "code", "text": "`false`" }, { "kind": "text", "text": ": gRPC error or request failure" } ] }, "type": { "type": "literal", "value": true }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.ok", "package": "@probitas-test/client-connectrpc" } }, { "id": 343, "name": "processed", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether the request was processed by the server.\n\n- " }, { "kind": "code", "text": "`true`" }, { "kind": "text", "text": ": Server responded (success or gRPC error)\n- " }, { "kind": "code", "text": "`false`" }, { "kind": "text", "text": ": Request failed before processing (network error, connection refused)" } ] }, "type": { "type": "literal", "value": true }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.processed", "package": "@probitas-test/client-connectrpc" } }, { "id": 350, "name": "raw", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Raw protobuf Message object." } ] }, "type": { "type": "intrinsic", "name": "unknown" }, "overwrites": { "type": "reference", "target": -1, "name": "ConnectRpcResponseBase.raw", "package": "@probitas-test/client-connectrpc" } }, { "id": 346, "name": "statusCode", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "gRPC status code (always 0 for success)." } ] }, "type": { "type": "literal", "value": 0 } }, { "id": 347, "name": "statusMessage", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Status message (null for successful responses)." } ] }, "type": { "type": "literal", "value": null } }, { "id": 349, "name": "trailers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Response trailers (sent at end of RPC)." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } } ], "typeParameters": [ { "id": 342, "name": "T", "variant": "typeParam", "kind": 131072, "flags": {}, "default": { "type": "intrinsic", "name": "any" } } ], "extendedTypes": [ { "type": "reference", "target": { "packageName": "@probitas-test/client-connectrpc", "packagePath": "response.ts", "qualifiedName": "ConnectRpcResponseBase" }, "typeArguments": [ { "type": "reference", "target": 342, "name": "T", "package": "@probitas-test/client-connectrpc", "qualifiedName": "ConnectRpcResponseSuccess.T", "refersToTypeParameter": true } ], "name": "ConnectRpcResponseBase", "package": "@probitas-test/client-connectrpc" } ] }, { "id": 197, "name": "ConnectRpcResponseSuccessParams", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Parameters for creating a successful ConnectRpcResponse." } ] }, "children": [ { "id": 203, "name": "duration", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "intrinsic", "name": "number" } }, { "id": 201, "name": "headers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } }, { "id": 199, "name": "response", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "union", "types": [ { "type": "reference", "target": 198, "name": "T", "package": "@probitas-test/client-connectrpc", "qualifiedName": "ConnectRpcResponseSuccessParams.T", "refersToTypeParameter": true }, { "type": "literal", "value": null } ] } }, { "id": 200, "name": "schema", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "union", "types": [ { "type": "reference", "target": { "packageName": "@bufbuild/protobuf", "packagePath": "dist/esm/descriptors.d.ts", "qualifiedName": "DescMessage" }, "name": "DescMessage", "package": "@bufbuild/protobuf" }, { "type": "literal", "value": null } ] } }, { "id": 202, "name": "trailers", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } } ], "typeParameters": [ { "id": 198, "name": "T", "variant": "typeParam", "kind": 131072, "flags": {}, "default": { "type": "intrinsic", "name": "any" } } ] }, { "id": 176, "name": "ErrorDetail", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Rich error detail from google.rpc.Status.\n\nConnectRPC errors can include structured details encoded in error responses.\nThese details follow the google.protobuf.Any format with a type URL and value." } ] }, "children": [ { "id": 177, "name": "typeUrl", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Type URL identifying the error detail type.\nCommon types include:\n- \"type.googleapis.com/google.rpc.BadRequest\"\n- \"type.googleapis.com/google.rpc.DebugInfo\"\n- \"type.googleapis.com/google.rpc.RetryInfo\"\n- \"type.googleapis.com/google.rpc.QuotaFailure\"" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 178, "name": "value", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Decoded error detail value.\nThe structure depends on the typeUrl." } ] }, "type": { "type": "intrinsic", "name": "unknown" } } ] }, { "id": 126, "name": "MethodInfo", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Method information from reflection." } ] }, "children": [ { "id": 132, "name": "idempotent", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Whether the method is idempotent" } ] }, "type": { "type": "intrinsic", "name": "boolean" } }, { "id": 130, "name": "inputType", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Input message type name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 129, "name": "kind", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Method kind" } ] }, "type": { "type": "union", "types": [ { "type": "literal", "value": "unary" }, { "type": "literal", "value": "server_streaming" }, { "type": "literal", "value": "client_streaming" }, { "type": "literal", "value": "bidi_streaming" } ] } }, { "id": 128, "name": "localName", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Local name (camelCase)" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 127, "name": "name", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Method name (e.g., \"Echo\")" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 131, "name": "outputType", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Output message type name" } ] }, "type": { "type": "intrinsic", "name": "string" } } ] }, { "id": 267, "name": "ReflectionApi", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Reflection API for ConnectRPC client.\nOnly available when client is created with schema: \"reflection\"." } ] }, "children": [ { "id": 268, "name": "enabled", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Check if reflection is enabled." } ] }, "type": { "type": "intrinsic", "name": "boolean" } }, { "id": 271, "name": "getServiceInfo", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 272, "name": "getServiceInfo", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Get detailed information about a specific service." } ], "blockTags": [ { "tag": "@throws", "content": [ { "kind": "text", "text": "Error if reflection is not enabled" } ] } ] }, "parameters": [ { "id": 273, "name": "serviceName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Fully qualified service name (e.g., \"echo.EchoService\")" } ] }, "type": { "type": "intrinsic", "name": "string" } } ], "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Promise" }, "typeArguments": [ { "type": "reference", "target": 133, "name": "ServiceDetail", "package": "@probitas-test/client-connectrpc" } ], "name": "Promise", "package": "typescript" } } ] }, { "id": 277, "name": "hasService", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 278, "name": "hasService", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Check if a service exists." } ], "blockTags": [ { "tag": "@throws", "content": [ { "kind": "text", "text": "Error if reflection is not enabled" } ] } ] }, "parameters": [ { "id": 279, "name": "serviceName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Fully qualified service name" } ] }, "type": { "type": "intrinsic", "name": "string" } } ], "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Promise" }, "typeArguments": [ { "type": "intrinsic", "name": "boolean" } ], "name": "Promise", "package": "typescript" } } ] }, { "id": 274, "name": "listMethods", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 275, "name": "listMethods", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Get methods for a specific service." } ], "blockTags": [ { "tag": "@throws", "content": [ { "kind": "text", "text": "Error if reflection is not enabled" } ] } ] }, "parameters": [ { "id": 276, "name": "serviceName", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Fully qualified service name" } ] }, "type": { "type": "intrinsic", "name": "string" } } ], "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Promise" }, "typeArguments": [ { "type": "array", "elementType": { "type": "reference", "target": 126, "name": "MethodInfo", "package": "@probitas-test/client-connectrpc" } } ], "name": "Promise", "package": "typescript" } } ] }, { "id": 269, "name": "listServices", "variant": "declaration", "kind": 2048, "flags": {}, "signatures": [ { "id": 270, "name": "listServices", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "List all available services on the server." } ], "blockTags": [ { "tag": "@throws", "content": [ { "kind": "text", "text": "Error if reflection is not enabled" } ] } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Promise" }, "typeArguments": [ { "type": "array", "elementType": { "type": "reference", "target": 123, "name": "ServiceInfo", "package": "@probitas-test/client-connectrpc" } } ], "name": "Promise", "package": "typescript" } } ] } ] }, { "id": 133, "name": "ServiceDetail", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Detailed service information." } ] }, "children": [ { "id": 135, "name": "fullName", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Fully qualified service name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 138, "name": "methods", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "All methods" } ] }, "type": { "type": "typeOperator", "operator": "readonly", "target": { "type": "array", "elementType": { "type": "reference", "target": 126, "name": "MethodInfo", "package": "@probitas-test/client-connectrpc" } } } }, { "id": 134, "name": "name", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Service name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 136, "name": "packageName", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Package name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 137, "name": "protoFile", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Proto file name" } ] }, "type": { "type": "intrinsic", "name": "string" } } ] }, { "id": 123, "name": "ServiceInfo", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Service information from reflection." } ] }, "children": [ { "id": 125, "name": "file", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Proto file name" } ] }, "type": { "type": "intrinsic", "name": "string" } }, { "id": 124, "name": "name", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Fully qualified service name (e.g., \"echo.EchoService\")" } ] }, "type": { "type": "intrinsic", "name": "string" } } ] }, { "id": 93, "name": "TlsConfig", "variant": "declaration", "kind": 256, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "TLS configuration for ConnectRPC connections." } ] }, "children": [ { "id": 95, "name": "clientCert", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Client certificate (PEM format)." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Uint8Array" }, "typeArguments": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "ArrayBufferLike" }, "name": "ArrayBufferLike", "package": "typescript" } ], "name": "Uint8Array", "package": "typescript" } }, { "id": 96, "name": "clientKey", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Client private key (PEM format)." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Uint8Array" }, "typeArguments": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "ArrayBufferLike" }, "name": "ArrayBufferLike", "package": "typescript" } ], "name": "Uint8Array", "package": "typescript" } }, { "id": 97, "name": "insecure", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Skip server certificate verification (use only for testing)." } ] }, "type": { "type": "intrinsic", "name": "boolean" } }, { "id": 94, "name": "rootCerts", "variant": "declaration", "kind": 1024, "flags": { "isOptional": true, "isReadonly": true }, "comment": { "summary": [ { "kind": "text", "text": "Root CA certificate (PEM format)." } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "Uint8Array" }, "typeArguments": [ { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.es5.d.ts", "qualifiedName": "ArrayBufferLike" }, "name": "ArrayBufferLike", "package": "typescript" } ], "name": "Uint8Array", "package": "typescript" } } ] }, { "id": 91, "name": "ConnectProtocol", "variant": "declaration", "kind": 2097152, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Protocol to use for ConnectRPC transport." } ] }, "type": { "type": "union", "types": [ { "type": "literal", "value": "connect" }, { "type": "literal", "value": "grpc" }, { "type": "literal", "value": "grpc-web" } ] } }, { "id": 196, "name": "ConnectRpcErrorType", "variant": "declaration", "kind": 2097152, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC error type union.\n\nContains either:\n- ConnectRpcError: gRPC error returned by the server\n- ConnectRpcNetworkError: Network-level failure before reaching the server" } ] }, "type": { "type": "union", "types": [ { "type": "reference", "target": 182, "name": "ConnectRpcError", "package": "@probitas-test/client-connectrpc" }, { "type": "reference", "target": 169, "name": "ConnectRpcNetworkError", "package": "@probitas-test/client-connectrpc" } ] } }, { "id": 195, "name": "ConnectRpcFailureError", "variant": "declaration", "kind": 2097152, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Error types that indicate the operation was not processed.\nThese are errors that occur before the request reaches the server." } ] }, "type": { "type": "union", "types": [ { "type": "reference", "target": 169, "name": "ConnectRpcNetworkError", "package": "@probitas-test/client-connectrpc" }, { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/errors.d.ts", "qualifiedName": "AbortError" }, "name": "AbortError", "package": "@probitas-test/client" }, { "type": "reference", "target": { "packageName": "@probitas-test/client", "packagePath": "dist/errors.d.ts", "qualifiedName": "TimeoutError" }, "name": "TimeoutError", "package": "@probitas-test/client" } ] } }, { "id": 313, "name": "ConnectRpcResponse", "variant": "declaration", "kind": 2097152, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC response union type.\n\nUse " }, { "kind": "code", "text": "`processed`" }, { "kind": "text", "text": " to distinguish between server responses and failures:\n- " }, { "kind": "code", "text": "`processed === true`" }, { "kind": "text", "text": ": Server responded (Success or Error)\n- " }, { "kind": "code", "text": "`processed === false`" }, { "kind": "text", "text": ": Request failed (Failure)\n\nUse " }, { "kind": "code", "text": "`ok`" }, { "kind": "text", "text": " to check for success:\n- " }, { "kind": "code", "text": "`ok === true`" }, { "kind": "text", "text": ": Success (statusCode === 0)\n- " }, { "kind": "code", "text": "`ok === false`" }, { "kind": "text", "text": ": Error or Failure" } ] }, "typeParameters": [ { "id": 314, "name": "T", "variant": "typeParam", "kind": 131072, "flags": {}, "default": { "type": "intrinsic", "name": "any" } } ], "type": { "type": "union", "types": [ { "type": "reference", "target": 341, "typeArguments": [ { "type": "reference", "target": 314, "name": "T", "package": "@probitas-test/client-connectrpc", "refersToTypeParameter": true } ], "name": "ConnectRpcResponseSuccess", "package": "@probitas-test/client-connectrpc" }, { "type": "reference", "target": 315, "typeArguments": [ { "type": "reference", "target": 314, "name": "T", "package": "@probitas-test/client-connectrpc", "refersToTypeParameter": true } ], "name": "ConnectRpcResponseError", "package": "@probitas-test/client-connectrpc" }, { "type": "reference", "target": 328, "typeArguments": [ { "type": "reference", "target": 314, "name": "T", "package": "@probitas-test/client-connectrpc", "refersToTypeParameter": true } ], "name": "ConnectRpcResponseFailure", "package": "@probitas-test/client-connectrpc" } ] } }, { "id": 164, "name": "ConnectRpcStatusCode", "variant": "declaration", "kind": 2097152, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC/gRPC status code type.\nDerived from ConnectRpcStatus values." } ] }, "type": { "type": "indexedAccess", "indexType": { "type": "typeOperator", "operator": "keyof", "target": { "type": "query", "queryType": { "type": "reference", "target": 145, "name": "ConnectRpcStatus", "package": "@probitas-test/client-connectrpc" } } }, "objectType": { "type": "query", "queryType": { "type": "reference", "target": 145, "name": "ConnectRpcStatus", "package": "@probitas-test/client-connectrpc" } } } }, { "id": 90, "name": "FileDescriptorSet", "variant": "declaration", "kind": 2097152, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "FileDescriptorSet message type from @bufbuild/protobuf.\nThis is the decoded protobuf message containing file descriptors." } ] }, "type": { "type": "reference", "target": { "packageName": "@bufbuild/protobuf", "packagePath": "dist/esm/types.d.ts", "qualifiedName": "MessageShape" }, "typeArguments": [ { "type": "query", "queryType": { "type": "reference", "target": { "packageName": "@bufbuild/protobuf", "packagePath": "dist/esm/wkt/google/protobuf/descriptor_pb.d.ts", "qualifiedName": "FileDescriptorSetSchema" }, "name": "FileDescriptorSetSchema", "package": "@bufbuild/protobuf", "preferValues": true } } ], "name": "MessageShape", "package": "@bufbuild/protobuf" } }, { "id": 92, "name": "HttpVersion", "variant": "declaration", "kind": 2097152, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "HTTP version for transport." } ] }, "type": { "type": "union", "types": [ { "type": "literal", "value": "1.1" }, { "type": "literal", "value": "2" } ] } }, { "id": 145, "name": "ConnectRpcStatus", "variant": "declaration", "kind": 32, "flags": { "isConst": true }, "comment": { "summary": [ { "kind": "text", "text": "ConnectRPC/gRPC status codes.\nThese codes are used by both gRPC and ConnectRPC protocols." } ] }, "type": { "type": "reflection", "declaration": { "id": 146, "name": "__type", "variant": "declaration", "kind": 65536, "flags": {}, "children": [ { "id": 157, "name": "ABORTED", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 10 }, "defaultValue": "10" }, { "id": 153, "name": "ALREADY_EXISTS", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 6 }, "defaultValue": "6" }, { "id": 148, "name": "CANCELLED", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 1 }, "defaultValue": "1" }, { "id": 162, "name": "DATA_LOSS", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 15 }, "defaultValue": "15" }, { "id": 151, "name": "DEADLINE_EXCEEDED", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 4 }, "defaultValue": "4" }, { "id": 156, "name": "FAILED_PRECONDITION", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 9 }, "defaultValue": "9" }, { "id": 160, "name": "INTERNAL", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 13 }, "defaultValue": "13" }, { "id": 150, "name": "INVALID_ARGUMENT", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 3 }, "defaultValue": "3" }, { "id": 152, "name": "NOT_FOUND", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 5 }, "defaultValue": "5" }, { "id": 147, "name": "OK", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 0 }, "defaultValue": "0" }, { "id": 158, "name": "OUT_OF_RANGE", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 11 }, "defaultValue": "11" }, { "id": 154, "name": "PERMISSION_DENIED", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 7 }, "defaultValue": "7" }, { "id": 155, "name": "RESOURCE_EXHAUSTED", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 8 }, "defaultValue": "8" }, { "id": 163, "name": "UNAUTHENTICATED", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 16 }, "defaultValue": "16" }, { "id": 161, "name": "UNAVAILABLE", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 14 }, "defaultValue": "14" }, { "id": 159, "name": "UNIMPLEMENTED", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 12 }, "defaultValue": "12" }, { "id": 149, "name": "UNKNOWN", "variant": "declaration", "kind": 1024, "flags": { "isReadonly": true }, "type": { "type": "literal", "value": 2 }, "defaultValue": "2" } ] } }, "defaultValue": "..." }, { "id": 264, "name": "createConnectRpcClient", "variant": "declaration", "kind": 64, "flags": {}, "signatures": [ { "id": 265, "name": "createConnectRpcClient", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Create a new ConnectRPC client instance.\n\nThe client supports multiple protocols (Connect, gRPC, gRPC-Web) and provides\nServer Reflection for runtime service discovery without compile-time code generation." } ], "blockTags": [ { "tag": "@returns", "content": [ { "kind": "text", "text": "A new ConnectRPC client instance" } ] }, { "tag": "@example", "name": "Basic usage with reflection", "content": [ { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\nconst client = createConnectRpcClient({\n url: \"http://localhost:50051\",\n});\n\n// Call a method\nconst response = await client.call(\n \"echo.EchoService\",\n \"echo\",\n { message: \"Hello!\" }\n);\nconsole.log(response.data);\n\nawait client.close();\n```" } ] }, { "tag": "@example", "name": "Service discovery with reflection", "content": [ { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\nconst client = createConnectRpcClient({\n url: \"http://localhost:50051\",\n});\n\n// Discover available services\nconst services = await client.reflection.listServices();\nconsole.log(\"Services:\", services);\n\n// Get method information\nconst info = await client.reflection.getServiceInfo(\"echo.EchoService\");\nconsole.log(\"Methods:\", info.methods);\n\nawait client.close();\n```" } ] }, { "tag": "@example", "name": "Using different protocols", "content": [ { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\n// Connect protocol (HTTP/1.1 or HTTP/2)\nconst connectClient = createConnectRpcClient({\n url: \"http://localhost:8080\",\n protocol: \"connect\",\n});\n\n// gRPC protocol (HTTP/2 with binary protobuf)\nconst grpcClient = createConnectRpcClient({\n url: \"http://localhost:50051\",\n protocol: \"grpc\",\n});\n\n// gRPC-Web protocol (for browser compatibility)\nconst grpcWebClient = createConnectRpcClient({\n url: \"http://localhost:8080\",\n protocol: \"grpc-web\",\n});\n\nawait connectClient.close();\nawait grpcClient.close();\nawait grpcWebClient.close();\n```" } ] }, { "tag": "@example", "name": "Using connection config object", "content": [ { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\nconst client = createConnectRpcClient({\n url: {\n host: \"grpc.example.com\",\n port: 443,\n protocol: \"https\",\n },\n});\n\nawait client.close();\n```" } ] }, { "tag": "@example", "name": "Using `await using` for automatic cleanup", "content": [ { "kind": "code", "text": "```ts\nimport { createConnectRpcClient } from \"@probitas-test/client-connectrpc\";\n\nawait using client = createConnectRpcClient({\n url: \"http://localhost:50051\",\n});\n\nconst res = await client.call(\"echo.EchoService\", \"echo\", { message: \"test\" });\n// Client automatically closed when scope exits\n```" } ] } ] }, "parameters": [ { "id": 266, "name": "config", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Client configuration including server URL and protocol options" } ] }, "type": { "type": "reference", "target": 105, "name": "ConnectRpcClientConfig", "package": "@probitas-test/client-connectrpc" } } ], "type": { "type": "reference", "target": 280, "name": "ConnectRpcClient", "package": "@probitas-test/client-connectrpc" } } ] }, { "id": 165, "name": "fromConnectError", "variant": "declaration", "kind": 64, "flags": {}, "signatures": [ { "id": 166, "name": "fromConnectError", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Convert ConnectRPC's ConnectError to ConnectRpcError." } ], "blockTags": [ { "tag": "@returns", "content": [ { "kind": "text", "text": "ConnectRpcError with statusCode for discrimination" } ] } ] }, "parameters": [ { "id": 167, "name": "error", "variant": "param", "kind": 32768, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "The ConnectError from @connectrpc/connect" } ] }, "type": { "type": "reference", "target": { "packageName": "@connectrpc/connect", "packagePath": "dist/esm/connect-error.d.ts", "qualifiedName": "ConnectError" }, "name": "ConnectError", "package": "@connectrpc/connect" } }, { "id": 168, "name": "metadata", "variant": "param", "kind": 32768, "flags": { "isOptional": true }, "comment": { "summary": [ { "kind": "text", "text": "Optional metadata from the response" } ] }, "type": { "type": "reference", "target": { "packageName": "typescript", "packagePath": "lib/lib.dom.d.ts", "qualifiedName": "Headers" }, "name": "Headers", "package": "typescript" } } ], "type": { "type": "reference", "target": 182, "name": "ConnectRpcError", "package": "@probitas-test/client-connectrpc" } } ] }, { "id": 139, "name": "getStatusName", "variant": "declaration", "kind": 64, "flags": {}, "signatures": [ { "id": 140, "name": "getStatusName", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Get the name of a ConnectRPC/gRPC status code." } ], "blockTags": [ { "tag": "@example", "content": [ { "kind": "code", "text": "```typescript\ngetStatusName(0); // \"OK\"\ngetStatusName(5); // \"NOT_FOUND\"\ngetStatusName(16); // \"UNAUTHENTICATED\"\n```" } ] } ] }, "parameters": [ { "id": 141, "name": "code", "variant": "param", "kind": 32768, "flags": {}, "type": { "type": "reference", "target": 164, "name": "ConnectRpcStatusCode", "package": "@probitas-test/client-connectrpc" } } ], "type": { "type": "intrinsic", "name": "string" } } ] }, { "id": 142, "name": "isConnectRpcStatusCode", "variant": "declaration", "kind": 64, "flags": {}, "signatures": [ { "id": 143, "name": "isConnectRpcStatusCode", "variant": "signature", "kind": 4096, "flags": {}, "comment": { "summary": [ { "kind": "text", "text": "Check if a number is a valid ConnectRPC/gRPC status code." } ], "blockTags": [ { "tag": "@example", "content": [ { "kind": "code", "text": "```typescript\nisConnectRpcStatusCode(0); // true\nisConnectRpcStatusCode(16); // true\nisConnectRpcStatusCode(99); // false\n```" } ] } ] }, "parameters": [ { "id": 144, "name": "code", "variant": "param", "kind": 32768, "flags": {}, "type": { "type": "intrinsic", "name": "number" } } ], "type": { "type": "predicate", "name": "code", "asserts": false, "targetType": { "type": "reference", "target": 164, "name": "ConnectRpcStatusCode", "package": "@probitas-test/client-connectrpc" } } } ] } ], "packageName": "@probitas-test/client-connectrpc", "packageVersion": "0.7.2" }