@o11y-one/sdk 0.1.0 → 0.1.1

package/README.md

@@ -16,7 +16,7 @@ import { O11yClient, classify } from "@o11y-one/sdk";
 import { AgenticEvaluationService } from "@o11y-one/api-agentic/o11y_one/agentic/v1/evaluation_pb";
 
 const o11y = new O11yClient({
-  baseUrl: "https://api.o11y.one",
+  baseUrl: "https://grpc.o11y.one",
   credential: process.env.O11Y_API_KEY, // o11y_mach.<selector>.<secret>
   orgId: process.env.O11Y_ORG_ID,
 });
@@ -76,9 +76,11 @@ JWT and a machine credential presented there is rejected.
 
 ## Runtime support
 
-The default transport is Connect over HTTP via `@connectrpc/connect-web`, which
-needs only a spec-compatible `fetch`. That covers browsers, Node 26, Deno, Bun
-and Cloudflare Workers. `@connectrpc/connect-node` is a dependency for callers
-who want the Node-specific HTTP/2 transport and construct it themselves; pass
-the resulting transport's options through `ClientOptions` or build your own
-transport and install `credentialInterceptor()` on it.
+The default transport is gRPC-web via `@connectrpc/connect-web`, which needs
+only a spec-compatible `fetch`. That covers browsers, Node 26, Deno, Bun and
+Cloudflare Workers. `@connectrpc/connect-node` is a dependency for callers who
+want the Node-specific HTTP/2 transport and construct it themselves; pass the
+resulting transport's options through `ClientOptions` or build your own
+transport and install `credentialInterceptor()` on it. The API serves gRPC and
+gRPC-web only, so a transport you build must speak one of those, not the
+Connect protocol.

package/dist/client.d.ts

@@ -9,11 +9,11 @@
  * rot the first time a field is added upstream.
  */
 import { type Client, type Interceptor, type Transport } from "@connectrpc/connect";
-import { type ConnectTransportOptions } from "@connectrpc/connect-web";
+import { type GrpcWebTransportOptions } from "@connectrpc/connect-web";
 import type { DescService } from "@bufbuild/protobuf";
 export interface ClientOptions {
     /**
-     * Base URL of the O11y One Connect endpoint, e.g. `https://api.o11y.one`.
+     * Base URL of the O11y One gRPC endpoint, e.g. `https://grpc.o11y.one`.
      * No trailing path — connect-es appends `/<package>.<Service>/<Method>`.
      */
     baseUrl: string;
@@ -39,7 +39,7 @@ export interface ClientOptions {
      * `typeof globalThis.fetch`, which would force the DOM lib into this package's
      * compilation for the sake of one type and drag every DOM global in with it.
      */
-    fetch?: ConnectTransportOptions["fetch"];
+    fetch?: GrpcWebTransportOptions["fetch"];
 }
 /**
  * An interceptor that stamps the credential and scoping headers onto every
@@ -70,14 +70,16 @@ export declare function credentialInterceptor(options: {
     tenantId?: string;
 }): Interceptor;
 /**
- * Build a Connect transport with the credential interceptor installed.
+ * Build a gRPC-web transport with the credential interceptor installed.
  *
- * Protocol note: Connect over HTTP, not gRPC. It is the protocol o11y-web
- * already speaks and the one that survives proxies and CI egress rules without
- * HTTP/2 prior knowledge. `createConnectTransport` from `@connectrpc/connect-web`
- * works in browsers, in Node 26 (whose global fetch is sufficient), and in
- * Workers; `@connectrpc/connect-node` is a dependency only for callers who need
- * the Node-specific HTTP/2 transport and reach for it themselves.
+ * Protocol note: gRPC-web, not Connect. The API serves gRPC and gRPC-web and
+ * does not speak the Connect protocol; gRPC-web is the one of the two that
+ * needs no HTTP/2 prior knowledge, so it survives proxies and CI egress rules,
+ * and it is what o11y-web speaks. `createGrpcWebTransport` from
+ * `@connectrpc/connect-web` works in browsers, in Node 26 (whose global fetch
+ * is sufficient), and in Workers; `@connectrpc/connect-node` is a dependency
+ * only for callers who need the Node-specific HTTP/2 transport and reach for it
+ * themselves.
  */
 export declare function createTransport(options: ClientOptions): Transport;
 /**

package/dist/client.js

@@ -9,7 +9,7 @@
  * rot the first time a field is added upstream.
  */
 import { createClient } from "@connectrpc/connect";
-import { createConnectTransport, } from "@connectrpc/connect-web";
+import { createGrpcWebTransport, } from "@connectrpc/connect-web";
 import { assertLooksLikeMachineCredential, CREDENTIAL_HEADER, ORG_ID_HEADER, TENANT_ID_HEADER, } from "./auth.js";
 /**
  * An interceptor that stamps the credential and scoping headers onto every
@@ -52,17 +52,19 @@ export function credentialInterceptor(options) {
     };
 }
 /**
- * Build a Connect transport with the credential interceptor installed.
+ * Build a gRPC-web transport with the credential interceptor installed.
  *
- * Protocol note: Connect over HTTP, not gRPC. It is the protocol o11y-web
- * already speaks and the one that survives proxies and CI egress rules without
- * HTTP/2 prior knowledge. `createConnectTransport` from `@connectrpc/connect-web`
- * works in browsers, in Node 26 (whose global fetch is sufficient), and in
- * Workers; `@connectrpc/connect-node` is a dependency only for callers who need
- * the Node-specific HTTP/2 transport and reach for it themselves.
+ * Protocol note: gRPC-web, not Connect. The API serves gRPC and gRPC-web and
+ * does not speak the Connect protocol; gRPC-web is the one of the two that
+ * needs no HTTP/2 prior knowledge, so it survives proxies and CI egress rules,
+ * and it is what o11y-web speaks. `createGrpcWebTransport` from
+ * `@connectrpc/connect-web` works in browsers, in Node 26 (whose global fetch
+ * is sufficient), and in Workers; `@connectrpc/connect-node` is a dependency
+ * only for callers who need the Node-specific HTTP/2 transport and reach for it
+ * themselves.
  */
 export function createTransport(options) {
-    return createConnectTransport({
+    return createGrpcWebTransport({
         baseUrl: options.baseUrl,
         // Binary wire format: smaller, and it round-trips proto3 field presence
         // without the JSON mapping's ambiguities.

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@o11y-one/sdk",
-  "version": "0.1.0",
+  "version": "0.1.1",
   "description": "Hand-written client wrapper over @o11y-one/api-agentic: transport construction, credential injection, and the O11y One error taxonomy.",
   "license": "Apache-2.0",
   "type": "module",
@@ -19,7 +19,7 @@
     "@connectrpc/connect": "^2.2.0",
     "@connectrpc/connect-node": "^2.2.0",
     "@connectrpc/connect-web": "^2.2.0",
-    "@o11y-one/api-agentic": "0.1.0"
+    "@o11y-one/api-agentic": "0.1.1"
   },
   "devDependencies": {
     "typescript": "^7.0.2"