@aui.io/aui-client 3.1.0 → 3.1.1

package/README.md

@@ -80,7 +80,6 @@ import { ApolloEnvironment } from '@aui.io/aui-client';
 ApolloEnvironment.Gcp = {
     base: 'https://api-v3.aui.io/apollo-api-v2',        // REST
     production: 'wss://api-v3.aui.io/apollo-api-v2',    // WebSocket
-    local: 'ws://localhost:8000',                       // WebSocket (local)
 };
 ```
 
@@ -145,8 +144,9 @@ socket.on('message', (msg) => {
 socket.on('error', (err) => console.error('WS error:', err));
 socket.on('close', (event) => console.log('Closed:', event.code));
 
-// Send a turn
+// Send a turn (type is required on the WS submit frame)
 socket.sendSubmitMessage({
+    type: 'message',
     agent_id: agentId,
     user_id: 'end-user-123',
     text: 'Hello over WebSocket',
@@ -156,6 +156,14 @@ socket.sendSubmitMessage({
 socket.close();
 ```
 
+> **Notes**
+> - `socket.on(event, handler)` registers a **single** handler per event — calling it
+>   again for the same event replaces the previous handler rather than adding one.
+> - The socket type is exported as `SessionSocket` (`import { SessionSocket } from '@aui.io/aui-client'`).
+> - Request timeouts are **per call** via `timeoutInSeconds` on a request's options; there
+>   is no client-wide default timeout. Pass it on slow calls, e.g.
+>   `client.threads.listThreads({ filters: {} }, { timeoutInSeconds: 120 })`.
+
 ## Key Context Helpers
 
 After the first request (or an explicit `getContext()`), scope resolved from the key is available:
@@ -172,13 +180,17 @@ client.organizationId;
 
 ## Error Handling
 
+`ApolloError` (the base API error) and `ApolloTimeoutError` are exported at the top
+level. The per-status errors (e.g. `UnprocessableEntityError`) live under the `Apollo`
+namespace.
+
 ```typescript
-import { ApolloError, UnprocessableEntityError } from '@aui.io/aui-client';
+import { ApolloError, Apollo } from '@aui.io/aui-client';
 
 try {
     await client.agents.getAgent('missing-id');
 } catch (error) {
-    if (error instanceof UnprocessableEntityError) {
+    if (error instanceof Apollo.UnprocessableEntityError) {
         console.error('Validation failed:', error.body);
     } else if (error instanceof ApolloError) {
         console.error('API error:', error.statusCode, error.body);
@@ -196,6 +208,7 @@ The SDK ships full type definitions. Models are namespaced under `Apollo`:
 import { ApolloClient, Apollo } from '@aui.io/aui-client';
 
 const req: Apollo.SubmitMessageRequest = {
+    type: 'message',
     agent_id: 'agent-123',
     user_id: 'end-user-123',
     text: 'Typed request',

package/dist/cjs/ApolloClientWrapper.js

@@ -58,6 +58,16 @@ const SESSION_WS_PATH = "/messaging/v1/session";
 // The v2 messaging server negotiates this subprotocol on the WS upgrade; the
 // connection is rejected without it. Fern emits protocols: [], so we set it here.
 const WS_SUBPROTOCOL = "aui-websocket";
+// Fern injects SDK-telemetry headers (X-Fern-*) on every request. The API doesn't need
+// them, and in the browser each custom header triggers a CORS preflight that fails unless
+// the gateway allow-lists it. Passing null strips them (mergeHeaders deletes null values).
+const STRIPPED_SDK_HEADERS = {
+    "X-Fern-Language": null,
+    "X-Fern-SDK-Name": null,
+    "X-Fern-SDK-Version": null,
+    "X-Fern-Runtime": null,
+    "X-Fern-Runtime-Version": null,
+};
 // Publishable-key exchange + token caching. Kept as a standalone object so the header
 // suppliers can close over it — a subclass may not touch `this` before super() runs.
 class Auth {
@@ -144,7 +154,7 @@ class ApolloClient extends Client_js_1.ApolloClient {
         const auth = new Auth(env.base, options.publishableKey, options.organizationApiKey);
         super({
             environment: env,
-            headers: Object.assign({}, (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
+            headers: Object.assign(Object.assign({}, STRIPPED_SDK_HEADERS), (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
         });
         this._tokenAuth = auth;
         this._env = env;

package/dist/cjs/Client.js

@@ -61,8 +61,8 @@ class ApolloClient {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: (0, headers_js_1.mergeHeaders)({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@aui.io/aui-client",
-                "X-Fern-SDK-Version": "3.1.0",
-                "User-Agent": "@aui.io/aui-client/3.1.0",
+                "X-Fern-SDK-Version": "3.1.1",
+                "User-Agent": "@aui.io/aui-client/3.1.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/cjs/api/resources/session/client/Socket.d.ts

@@ -4,7 +4,7 @@ export declare namespace SessionSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Apollo.SubmitMessageRequest | Apollo.ResumeRequest;
+    type Response = Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;
@@ -33,10 +33,8 @@ export declare class SessionSocket {
      * ```
      */
     on<T extends keyof SessionSocket.EventHandlers>(event: T, callback: SessionSocket.EventHandlers[T]): void;
-    sendThreadAnnouncement(message: Apollo.ThreadEnvelope): void;
-    sendAgentMessage(message: Apollo.MessageEnvelope): void;
-    sendForwardedEvent(message: Apollo.EventEnvelope): void;
-    sendErrorFrame(message: Apollo.ErrorEnvelope): void;
+    sendSubmitMessage(message: Apollo.SubmitMessageRequest): void;
+    sendResume(message: Apollo.ResumeRequest): void;
     /** Connect to the websocket and register event handlers. */
     connect(): SessionSocket;
     /** Close the websocket and unregister event handlers. */
@@ -48,5 +46,5 @@ export declare class SessionSocket {
     /** Send a binary payload to the websocket. */
     protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
     /** Send a JSON payload to the websocket. */
-    protected sendJson(payload: Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope): void;
+    protected sendJson(payload: Apollo.SubmitMessageRequest | Apollo.ResumeRequest): void;
 }

package/dist/cjs/api/resources/session/client/Socket.js

@@ -90,19 +90,11 @@ class SessionSocket {
     on(event, callback) {
         this.eventHandlers[event] = callback;
     }
-    sendThreadAnnouncement(message) {
+    sendSubmitMessage(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
-    sendAgentMessage(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendForwardedEvent(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendErrorFrame(message) {
+    sendResume(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }

package/dist/cjs/exports.d.ts

@@ -6,3 +6,4 @@
  * `export * from "./exports.js"`.
  */
 export * from "./core/exports.js";
+export { SessionSocket } from "./api/resources/session/client/Socket.js";

package/dist/cjs/exports.js

@@ -21,4 +21,9 @@ var __exportStar = (this && this.__exportStar) || function(m, exports) {
     for (var p in m) if (p !== "default" && !Object.prototype.hasOwnProperty.call(exports, p)) __createBinding(exports, m, p);
 };
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.SessionSocket = void 0;
 __exportStar(require("./core/exports.js"), exports);
+// The generated session resource doesn't re-export its socket class, so consumers
+// couldn't name the type returned by `client.connect()`. Surface it at the package root.
+var Socket_js_1 = require("./api/resources/session/client/Socket.js");
+Object.defineProperty(exports, "SessionSocket", { enumerable: true, get: function () { return Socket_js_1.SessionSocket; } });

package/dist/cjs/version.d.ts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.1.0";
+export declare const SDK_VERSION = "3.1.1";

package/dist/cjs/version.js

@@ -1,4 +1,4 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.SDK_VERSION = void 0;
-exports.SDK_VERSION = "3.1.0";
+exports.SDK_VERSION = "3.1.1";

package/dist/esm/ApolloClientWrapper.mjs

@@ -22,6 +22,16 @@ const SESSION_WS_PATH = "/messaging/v1/session";
 // The v2 messaging server negotiates this subprotocol on the WS upgrade; the
 // connection is rejected without it. Fern emits protocols: [], so we set it here.
 const WS_SUBPROTOCOL = "aui-websocket";
+// Fern injects SDK-telemetry headers (X-Fern-*) on every request. The API doesn't need
+// them, and in the browser each custom header triggers a CORS preflight that fails unless
+// the gateway allow-lists it. Passing null strips them (mergeHeaders deletes null values).
+const STRIPPED_SDK_HEADERS = {
+    "X-Fern-Language": null,
+    "X-Fern-SDK-Name": null,
+    "X-Fern-SDK-Version": null,
+    "X-Fern-Runtime": null,
+    "X-Fern-Runtime-Version": null,
+};
 // Publishable-key exchange + token caching. Kept as a standalone object so the header
 // suppliers can close over it — a subclass may not touch `this` before super() runs.
 class Auth {
@@ -108,7 +118,7 @@ export class ApolloClient extends _GeneratedClient {
         const auth = new Auth(env.base, options.publishableKey, options.organizationApiKey);
         super({
             environment: env,
-            headers: Object.assign({}, (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
+            headers: Object.assign(Object.assign({}, STRIPPED_SDK_HEADERS), (auth.hasCredential ? { Authorization: () => __awaiter(this, void 0, void 0, function* () { return `Bearer ${yield auth.getToken()}`; }) } : {})),
         });
         this._tokenAuth = auth;
         this._env = env;

package/dist/esm/Client.mjs

@@ -25,8 +25,8 @@ export class ApolloClient {
         this._options = Object.assign(Object.assign({}, _options), { logging: core.logging.createLogger(_options === null || _options === void 0 ? void 0 : _options.logging), headers: mergeHeaders({
                 "X-Fern-Language": "JavaScript",
                 "X-Fern-SDK-Name": "@aui.io/aui-client",
-                "X-Fern-SDK-Version": "3.1.0",
-                "User-Agent": "@aui.io/aui-client/3.1.0",
+                "X-Fern-SDK-Version": "3.1.1",
+                "User-Agent": "@aui.io/aui-client/3.1.1",
                 "X-Fern-Runtime": core.RUNTIME.type,
                 "X-Fern-Runtime-Version": core.RUNTIME.version,
             }, _options === null || _options === void 0 ? void 0 : _options.headers) });

package/dist/esm/api/resources/session/client/Socket.d.mts

@@ -4,7 +4,7 @@ export declare namespace SessionSocket {
     interface Args {
         socket: core.ReconnectingWebSocket;
     }
-    type Response = Apollo.SubmitMessageRequest | Apollo.ResumeRequest;
+    type Response = Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope;
     type EventHandlers = {
         open?: () => void;
         message?: (message: Response) => void;
@@ -33,10 +33,8 @@ export declare class SessionSocket {
      * ```
      */
     on<T extends keyof SessionSocket.EventHandlers>(event: T, callback: SessionSocket.EventHandlers[T]): void;
-    sendThreadAnnouncement(message: Apollo.ThreadEnvelope): void;
-    sendAgentMessage(message: Apollo.MessageEnvelope): void;
-    sendForwardedEvent(message: Apollo.EventEnvelope): void;
-    sendErrorFrame(message: Apollo.ErrorEnvelope): void;
+    sendSubmitMessage(message: Apollo.SubmitMessageRequest): void;
+    sendResume(message: Apollo.ResumeRequest): void;
     /** Connect to the websocket and register event handlers. */
     connect(): SessionSocket;
     /** Close the websocket and unregister event handlers. */
@@ -48,5 +46,5 @@ export declare class SessionSocket {
     /** Send a binary payload to the websocket. */
     protected sendBinary(payload: ArrayBufferLike | Blob | ArrayBufferView): void;
     /** Send a JSON payload to the websocket. */
-    protected sendJson(payload: Apollo.ThreadEnvelope | Apollo.MessageEnvelope | Apollo.EventEnvelope | Apollo.ErrorEnvelope): void;
+    protected sendJson(payload: Apollo.SubmitMessageRequest | Apollo.ResumeRequest): void;
 }

package/dist/esm/api/resources/session/client/Socket.mjs

@@ -54,19 +54,11 @@ export class SessionSocket {
     on(event, callback) {
         this.eventHandlers[event] = callback;
     }
-    sendThreadAnnouncement(message) {
+    sendSubmitMessage(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }
-    sendAgentMessage(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendForwardedEvent(message) {
-        this.assertSocketIsOpen();
-        this.sendJson(message);
-    }
-    sendErrorFrame(message) {
+    sendResume(message) {
         this.assertSocketIsOpen();
         this.sendJson(message);
     }

package/dist/esm/exports.d.mts

@@ -6,3 +6,4 @@
  * `export * from "./exports.mjs"`.
  */
 export * from "./core/exports.mjs";
+export { SessionSocket } from "./api/resources/session/client/Socket.mjs";

package/dist/esm/exports.mjs

@@ -6,3 +6,6 @@
  * `export * from "./exports.mjs"`.
  */
 export * from "./core/exports.mjs";
+// The generated session resource doesn't re-export its socket class, so consumers
+// couldn't name the type returned by `client.connect()`. Surface it at the package root.
+export { SessionSocket } from "./api/resources/session/client/Socket.mjs";

package/dist/esm/version.d.mts

@@ -1 +1 @@
-export declare const SDK_VERSION = "3.1.0";
+export declare const SDK_VERSION = "3.1.1";

package/dist/esm/version.mjs

@@ -1 +1 @@
-export const SDK_VERSION = "3.1.0";
+export const SDK_VERSION = "3.1.1";

package/package.json

@@ -1,6 +1,6 @@
 {
     "name": "@aui.io/aui-client",
-    "version": "3.1.0",
+    "version": "3.1.1",
     "private": false,
     "repository": "github:aui-io/aui-client-typescript",
     "type": "commonjs",