@bodhiapp/bodhi-browser-types 0.0.27 → 0.0.29

package/dist/bodhiext.d.ts

@@ -1,4 +1,4 @@
-import { OpenAiApiError, PingResponse, CreateChatCompletionRequest, CreateChatCompletionResponse, CreateChatCompletionStreamResponse } from '@bodhiapp/ts-client';
+import { AppStatus, OpenAiApiError, PingResponse, CreateChatCompletionRequest, CreateChatCompletionResponse, CreateChatCompletionStreamResponse } from '@bodhiapp/ts-client';
 /**
  * HTTP response wrapper - body can be success type OR error type
  * Use isApiErrorResponse() to narrow the type based on status
@@ -25,7 +25,7 @@ export interface StreamChunk {
  */
 export interface ServerStateInfo {
     /** Current application status */
-    status: 'setup' | 'ready' | 'resource_admin' | 'tenant_selection' | 'error' | 'unreachable';
+    status: AppStatus | 'error' | 'unreachable';
     /** Application version */
     version?: string;
     /** Server URL (added by extension) */
@@ -38,39 +38,6 @@ export interface ServerStateInfo {
         param?: string;
     };
 }
-/**
- * API error thrown when server returns HTTP 4xx/5xx
- * Used for streaming responses (non-streaming returns ApiResponse)
- */
-export interface ApiError extends Error {
-    response: {
-        status: number;
-        body: OpenAiApiError;
-        headers?: Record<string, string>;
-    };
-}
-/**
- * Operation error thrown when HTTP request couldn't complete
- * (network unreachable, timeout, extension error)
- */
-export interface OperationError extends Error {
-    error: {
-        message: string;
-        type: string;
-    };
-}
-/**
- * Union of all extension-thrown errors
- */
-export type ExtensionError = ApiError | OperationError;
-/**
- * Type guard: API error (has response field)
- */
-export declare function isApiError(err: unknown): err is ApiError;
-/**
- * Type guard: Operation error (has error field, no response)
- */
-export declare function isOperationError(err: unknown): err is OperationError;
 /**
  * Chat API uses types from @bodhiapp/ts-client.
  * Consumers should import these types directly from @bodhiapp/ts-client:
@@ -91,7 +58,7 @@ export interface ChatCompletionsApi {
      * Create a chat completion
      *
      * Non-streaming: Returns ApiResponse - caller checks status for success/error
-     * Streaming: Yields chunks via AsyncIterable - throws ApiError or OperationError on error
+     * Streaming: Yields chunks via AsyncIterable - throws BodhiApiError or BodhiError on error
      *
      * @param params - Chat completion parameters
      * @returns Non-streaming: Promise<ApiResponse<CreateChatCompletionResponse>>, Streaming: AsyncIterable<CreateChatCompletionStreamResponse>

package/dist/errors.d.ts

@@ -0,0 +1,33 @@
+import { OpenAiApiError } from '@bodhiapp/ts-client';
+import { ApiResponse } from './bodhiext';
+/**
+ * Error codes for BodhiError
+ * Open-ended union allows custom codes via (string & {})
+ */
+export type BodhiErrorCode = 'network_error' | 'timeout_error' | 'extension_error' | 'auth_error' | 'not_initialized' | 'connection_closed' | 'parse_error' | 'api_error' | (string & {});
+/**
+ * Base error class for operational errors
+ * (network unreachable, timeout, extension error, auth error)
+ *
+ * Use `instanceof BodhiError` to detect — no type guards needed.
+ */
+export declare class BodhiError extends Error {
+    readonly code: BodhiErrorCode;
+    constructor(code: BodhiErrorCode, message: string);
+}
+/**
+ * HTTP API error (server returned 4xx/5xx)
+ *
+ * Use `instanceof BodhiApiError` to detect — no type guards needed.
+ * Always has code = 'api_error'.
+ */
+export declare class BodhiApiError extends BodhiError {
+    readonly status: number;
+    readonly body: OpenAiApiError;
+    readonly headers?: Record<string, string>;
+    constructor(status: number, body: OpenAiApiError, message: string, headers?: Record<string, string>);
+}
+/**
+ * Extract response body or throw BodhiApiError if status >= 400
+ */
+export declare function unwrapResponse<T>(response: ApiResponse<T>): T;

package/dist/index.d.ts

@@ -1,5 +1,5 @@
-export type { ApiResponse, StreamChunk, ServerStateInfo, ApiError, OperationError, ExtensionError, ChatCompletionsApi, ChatApi, BodhiExtPublicApi } from './bodhiext';
-export { isApiError, isOperationError } from './bodhiext';
+export type { ApiResponse, StreamChunk, ServerStateInfo, ChatCompletionsApi, ChatApi, BodhiExtPublicApi } from './bodhiext';
+export { BodhiError, BodhiApiError, unwrapResponse, type BodhiErrorCode } from './errors';
 export type { ApiRequest, ApiRequestMessage, OperationErrorResponse, ApiResponseSuccessMessage, OperationErrorResponseMessage, ApiResponseMessage, ErrorMessage, StreamChunkMessage, StreamApiErrorMessage, StreamErrorMessage, StreamMessage, StreamController, SSEChunk, ExtRequest, ExtRequestMessage, ExtError, ExtErrorResponse, ExtResponse, ExtResponseMessage, GetExtensionIdRequest, GetExtensionIdResponse, TestConnectionRequest, TestConnectionResponse, } from './protocol';
 export { MESSAGE_TYPES, isOperationErrorResponse, isApiErrorResponse, isApiSuccessResponse, isStreamChunk, isStreamApiError, isStreamError, isExtError, isOpenAiApiErrorBody, isOperationErrorStructure, } from './protocol';
 export { CONTENT_TYPE_JSON, CONTENT_TYPE_EVENT_STREAM, CONTENT_TYPE_HEADER, HTTP_METHOD_GET, HTTP_METHOD_POST, ENDPOINT_PING, ENDPOINT_CHAT_COMPLETIONS, DEFAULT_API_BASE_URL, DEFAULT_API_TIMEOUT, DEFAULT_STREAM_TIMEOUT, STORAGE_KEY_BACKEND_URL, SSE_DONE_MARKER, SSE_DATA_PREFIX, SSE_CHUNK_DELIMITER, EXT_ACTIONS, ERROR_TYPES, DOCUMENT_STATE_COMPLETE, EVENT_INITIALIZED, BODHI_STREAM_PORT, ORIGIN_WILDCARD, ERROR_MISSING_REQUEST_ID, ERROR_CONNECTION_CLOSED, } from './common';

package/dist/index.js

@@ -1,3 +1,29 @@
+class BodhiError extends Error {
+  constructor(code, message) {
+    super(message);
+    this.code = code;
+    this.name = "BodhiError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+class BodhiApiError extends BodhiError {
+  constructor(status, body, message, headers) {
+    super("api_error", message);
+    this.status = status;
+    this.body = body;
+    this.headers = headers;
+    this.name = "BodhiApiError";
+    Object.setPrototypeOf(this, new.target.prototype);
+  }
+}
+function unwrapResponse(response) {
+  if (response.status >= 400) {
+    const body = response.body;
+    const message = body?.error?.message || `HTTP ${response.status}`;
+    throw new BodhiApiError(response.status, body, message, response.headers);
+  }
+  return response.body;
+}
 function isNonNullObject(value) {
   return value !== null && typeof value === "object";
 }
@@ -39,12 +65,6 @@ function isStreamError(msg) {
 function isExtError(res) {
   return res !== null && typeof res === "object" && "error" in res;
 }
-function isApiError(err) {
-  return err instanceof Error && "response" in err && typeof err.response === "object" && err.response !== null && typeof err.response.status === "number" && "body" in err.response;
-}
-function isOperationError(err) {
-  return err instanceof Error && "error" in err && !("response" in err) && isOperationErrorStructure(err.error);
-}
 const CONTENT_TYPE_JSON = "application/json";
 const CONTENT_TYPE_EVENT_STREAM = "text/event-stream";
 const CONTENT_TYPE_HEADER = "Content-Type";
@@ -77,6 +97,8 @@ const ERROR_MISSING_REQUEST_ID = "Invalid message format: missing requestId or r
 const ERROR_CONNECTION_CLOSED = "Connection closed unexpectedly";
 export {
   BODHI_STREAM_PORT,
+  BodhiApiError,
+  BodhiError,
   CONTENT_TYPE_EVENT_STREAM,
   CONTENT_TYPE_HEADER,
   CONTENT_TYPE_JSON,
@@ -99,15 +121,14 @@ export {
   SSE_DATA_PREFIX,
   SSE_DONE_MARKER,
   STORAGE_KEY_BACKEND_URL,
-  isApiError,
   isApiErrorResponse,
   isApiSuccessResponse,
   isExtError,
   isOpenAiApiErrorBody,
-  isOperationError,
   isOperationErrorResponse,
   isOperationErrorStructure,
   isStreamApiError,
   isStreamChunk,
-  isStreamError
+  isStreamError,
+  unwrapResponse
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@bodhiapp/bodhi-browser-types",
-  "version": "0.0.27",
+  "version": "0.0.29",
   "description": "TypeScript types for Bodhi Browser Extension",
   "type": "module",
   "main": "dist/index.js",