@bodhiapp/bodhi-js-react-core 0.0.11

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
package/README.md ADDED
@@ -0,0 +1,34 @@
1
+ # @bodhiapp/bodhi-js-react
2
+
3
+ React bindings for Bodhi Browser SDK.
4
+
5
+ ## Installation
6
+
7
+ ```bash
8
+ npm install @bodhiapp/bodhi-js-react
9
+ ```
10
+
11
+ ## Usage
12
+
13
+ ```typescript
14
+ import { BodhiProvider, useBodhi } from '@bodhiapp/bodhi-js-react';
15
+ import { WebUIClient } from '@bodhiapp/bodhi-js';
16
+
17
+ const client = new WebUIClient('your-client-id');
18
+
19
+ function App() {
20
+ return (
21
+ <BodhiProvider client={client}>
22
+ <YourComponents />
23
+ </BodhiProvider>
24
+ );
25
+ }
26
+ ```
27
+
28
+ ## Documentation
29
+
30
+ See [bodhi-browser/bodhi-js-sdk](https://github.com/BodhiSearch/bodhi-browser/tree/main/bodhi-js-sdk) for complete documentation.
31
+
32
+ ## License
33
+
34
+ MIT
@@ -0,0 +1,201 @@
1
+ import { OpenAiApiError, PingResponse, CreateChatCompletionRequest, CreateChatCompletionResponse, CreateChatCompletionStreamResponse } from '@bodhiapp/ts-client';
2
+ /**
3
+ * HTTP response wrapper - body can be success type OR error type
4
+ * Use isApiErrorResponse() to narrow the type based on status
5
+ */
6
+ export interface ApiResponse<T = unknown> {
7
+ body: T | OpenAiApiError;
8
+ status: number;
9
+ headers: Record<string, string>;
10
+ }
11
+ /**
12
+ * Stream chunk returned by sendStreamRequest
13
+ *
14
+ * This is the chunk structure yielded by the ReadableStream from sendStreamRequest.
15
+ * Different from StreamChunkMessage which is the internal message wrapper.
16
+ */
17
+ export interface StreamChunk {
18
+ body: unknown;
19
+ headers?: Record<string, string>;
20
+ status?: number;
21
+ done?: boolean;
22
+ }
23
+ /**
24
+ * Server state information returned by /bodhi/v1/info endpoint
25
+ */
26
+ export interface ServerStateInfo {
27
+ /** Current application status */
28
+ status: 'setup' | 'ready' | 'resource-admin' | 'error' | 'unreachable';
29
+ /** Application version */
30
+ version?: string;
31
+ /** Server URL (added by extension) */
32
+ url?: string;
33
+ /** Error details if status is 'error' or 'unreachable' */
34
+ error?: {
35
+ message: string;
36
+ type?: string;
37
+ code?: string;
38
+ param?: string;
39
+ };
40
+ }
41
+ /**
42
+ * API error thrown when server returns HTTP 4xx/5xx
43
+ * Used for streaming responses (non-streaming returns ApiResponse)
44
+ */
45
+ export interface ApiError extends Error {
46
+ response: {
47
+ status: number;
48
+ body: OpenAiApiError;
49
+ headers?: Record<string, string>;
50
+ };
51
+ }
52
+ /**
53
+ * Operation error thrown when HTTP request couldn't complete
54
+ * (network unreachable, timeout, extension error)
55
+ */
56
+ export interface OperationError extends Error {
57
+ error: {
58
+ message: string;
59
+ type: string;
60
+ };
61
+ }
62
+ /**
63
+ * Union of all extension-thrown errors
64
+ */
65
+ export type ExtensionError = ApiError | OperationError;
66
+ /**
67
+ * Type guard: API error (has response field)
68
+ */
69
+ export declare function isApiError(err: unknown): err is ApiError;
70
+ /**
71
+ * Type guard: Operation error (has error field, no response)
72
+ */
73
+ export declare function isOperationError(err: unknown): err is OperationError;
74
+ /**
75
+ * Chat API uses types from @bodhiapp/ts-client.
76
+ * Consumers should import these types directly from @bodhiapp/ts-client:
77
+ * - ChatCompletionRequestMessage
78
+ * - ChatCompletionResponseMessage
79
+ * - CreateChatCompletionRequest
80
+ * - CreateChatCompletionResponse
81
+ * - CreateChatCompletionStreamResponse
82
+ * - ChatChoice
83
+ * - ChatChoiceStream
84
+ * - ChatCompletionStreamResponseDelta
85
+ */
86
+ /**
87
+ * Chat completions API interface
88
+ */
89
+ export interface ChatCompletionsApi {
90
+ /**
91
+ * Create a chat completion
92
+ *
93
+ * Non-streaming: Returns ApiResponse - caller checks status for success/error
94
+ * Streaming: Yields chunks via AsyncIterable - throws ApiError or OperationError on error
95
+ *
96
+ * @param params - Chat completion parameters
97
+ * @returns Non-streaming: Promise<ApiResponse<CreateChatCompletionResponse>>, Streaming: AsyncIterable<CreateChatCompletionStreamResponse>
98
+ */
99
+ create(params: CreateChatCompletionRequest & {
100
+ stream?: false;
101
+ }): Promise<ApiResponse<CreateChatCompletionResponse>>;
102
+ create(params: CreateChatCompletionRequest & {
103
+ stream: true;
104
+ }): AsyncIterable<CreateChatCompletionStreamResponse>;
105
+ create(params: CreateChatCompletionRequest): Promise<ApiResponse<CreateChatCompletionResponse>> | AsyncIterable<CreateChatCompletionStreamResponse>;
106
+ }
107
+ /**
108
+ * Chat API namespace
109
+ */
110
+ export interface ChatApi {
111
+ completions: ChatCompletionsApi;
112
+ }
113
+ /**
114
+ * Public window.bodhiext interface
115
+ *
116
+ * This interface defines all methods available to web pages through window.bodhiext.
117
+ * The extension creates this interface in inject.ts and attaches it to the window object.
118
+ */
119
+ export interface BodhiExtPublicApi {
120
+ /**
121
+ * Send a generic API request through the extension to the backend server.
122
+ *
123
+ * @template TReq - Request body type (inferred from body parameter)
124
+ * @template TRes - Response body type (must be specified explicitly)
125
+ * @param method - HTTP method (GET, POST, PUT, DELETE, etc.)
126
+ * @param endpoint - API endpoint path (e.g., '/v1/chat/completions')
127
+ * @param body - Optional request body (will be JSON stringified)
128
+ * @param headers - Optional additional headers
129
+ * @returns Promise resolving to ApiResponse with body, headers, and status
130
+ */
131
+ sendApiRequest<TReq = unknown, TRes = unknown>(method: string, endpoint: string, body?: TReq, headers?: Record<string, string>): Promise<ApiResponse<TRes>>;
132
+ /**
133
+ * Send a streaming API request through the extension.
134
+ *
135
+ * Used for SSE (Server-Sent Events) endpoints like streaming chat completions.
136
+ * Returns a ReadableStream that yields StreamChunk objects.
137
+ *
138
+ * @template TReq - Request body type (inferred from body parameter)
139
+ * @param method - HTTP method (typically POST for streaming)
140
+ * @param endpoint - API endpoint path (e.g., '/v1/chat/completions')
141
+ * @param body - Optional request body
142
+ * @param headers - Optional additional headers
143
+ * @returns ReadableStream yielding StreamChunk objects
144
+ */
145
+ sendStreamRequest<TReq = unknown>(method: string, endpoint: string, body?: TReq, headers?: Record<string, string>): ReadableStream<StreamChunk>;
146
+ /**
147
+ * Send a generic extension request.
148
+ *
149
+ * Used for extension-specific operations like test_connection, get_extension_id, etc.
150
+ * This is a low-level API for extension capabilities.
151
+ *
152
+ * @param action - Extension action name (e.g., 'test_connection')
153
+ * @param params - Optional action parameters
154
+ * @returns Promise resolving to action-specific response
155
+ */
156
+ sendExtRequest(action: string, params?: any): Promise<any>;
157
+ /**
158
+ * Simple health check to verify extension connectivity.
159
+ *
160
+ * Returns ApiResponse - caller should check status to determine success/error.
161
+ * On success (2xx), body is PingResponse. On error (4xx/5xx), body is OpenAiApiError.
162
+ *
163
+ * @returns Promise resolving to ApiResponse<PingResponse>
164
+ */
165
+ ping(): Promise<ApiResponse<PingResponse>>;
166
+ /**
167
+ * Get server state information from /bodhi/v1/info endpoint.
168
+ *
169
+ * Returns the current status of the backend server including
170
+ * whether it's in setup mode, ready, or has errors.
171
+ *
172
+ * @returns Promise resolving to ServerStateInfo
173
+ */
174
+ serverState(): Promise<ServerStateInfo>;
175
+ /**
176
+ * OpenAI-compatible chat API.
177
+ *
178
+ * Provides chat completion functionality compatible with OpenAI's API structure.
179
+ */
180
+ chat: ChatApi;
181
+ /**
182
+ * Get the extension ID.
183
+ *
184
+ * The extension ID is fetched asynchronously during initialization.
185
+ * This method returns a promise that resolves to the extension ID once available.
186
+ *
187
+ * @returns Promise resolving to the extension ID string
188
+ */
189
+ getExtensionId(): Promise<string>;
190
+ }
191
+ /**
192
+ * Window augmentation for TypeScript
193
+ *
194
+ * Declares the optional bodhiext property on the Window interface.
195
+ * This allows TypeScript code to access window.bodhiext with proper typing.
196
+ */
197
+ declare global {
198
+ interface Window {
199
+ bodhiext?: BodhiExtPublicApi;
200
+ }
201
+ }
@@ -0,0 +1,37 @@
1
+ /**
2
+ * Shared constants for Bodhi Browser Extension
3
+ *
4
+ * Constants used by both inject.ts and background/content.ts scripts,
5
+ * or common to the entire extension.
6
+ */
7
+ export declare const CONTENT_TYPE_JSON = "application/json";
8
+ export declare const CONTENT_TYPE_EVENT_STREAM = "text/event-stream";
9
+ export declare const CONTENT_TYPE_HEADER = "Content-Type";
10
+ export declare const HTTP_METHOD_GET = "GET";
11
+ export declare const HTTP_METHOD_POST = "POST";
12
+ export declare const ENDPOINT_PING = "/ping";
13
+ export declare const ENDPOINT_CHAT_COMPLETIONS = "/v1/chat/completions";
14
+ export declare const DEFAULT_API_BASE_URL = "http://localhost:1135";
15
+ export declare const DEFAULT_API_TIMEOUT = 10000;
16
+ export declare const DEFAULT_STREAM_TIMEOUT = 60000;
17
+ export declare const STORAGE_KEY_BACKEND_URL = "backendUrl";
18
+ export declare const SSE_DONE_MARKER = "[DONE]";
19
+ export declare const SSE_DATA_PREFIX = "data: ";
20
+ export declare const SSE_CHUNK_DELIMITER = "\n\n";
21
+ export declare const EXT_ACTIONS: {
22
+ readonly GET_EXTENSION_ID: "get_extension_id";
23
+ readonly TEST_CONNECTION: "test_connection";
24
+ };
25
+ export declare const ERROR_TYPES: {
26
+ readonly NETWORK_ERROR: "network_error";
27
+ readonly EXTENSION_ERROR: "extension_error";
28
+ readonly TIMEOUT_ERROR: "timeout_error";
29
+ readonly AUTH_ERROR: "auth_error";
30
+ };
31
+ export type ConnectionErrorType = (typeof ERROR_TYPES)[keyof typeof ERROR_TYPES];
32
+ export declare const DOCUMENT_STATE_COMPLETE = "complete";
33
+ export declare const EVENT_INITIALIZED = "bodhiext:initialized";
34
+ export declare const BODHI_STREAM_PORT = "BODHI_STREAM_PORT";
35
+ export declare const ORIGIN_WILDCARD = "*";
36
+ export declare const ERROR_MISSING_REQUEST_ID = "Invalid message format: missing requestId or request";
37
+ export declare const ERROR_CONNECTION_CLOSED = "Connection closed unexpectedly";
@@ -0,0 +1,6 @@
1
+ export type { ApiResponse, StreamChunk, ServerStateInfo, ApiError, OperationError, ExtensionError, ChatCompletionsApi, ChatApi, BodhiExtPublicApi } from './bodhiext';
2
+ export { isApiError, isOperationError } from './bodhiext';
3
+ 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';
4
+ export { MESSAGE_TYPES, isOperationErrorResponse, isApiErrorResponse, isApiSuccessResponse, isStreamChunk, isStreamApiError, isStreamError, isExtError, isOpenAiApiErrorBody, isOperationErrorStructure, } from './protocol';
5
+ 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';
6
+ export type { ConnectionErrorType } from './common';
@@ -0,0 +1,222 @@
1
+ import { OpenAiApiError, ErrorBody } from '@bodhiapp/ts-client';
2
+ import { ApiResponse, ServerStateInfo } from './bodhiext';
3
+ /**
4
+ * Validate OpenAI API error body structure
5
+ * { error: { message: string, type: string } }
6
+ */
7
+ export declare function isOpenAiApiErrorBody(body: unknown): body is OpenAiApiError;
8
+ /**
9
+ * Validate OperationErrorResponse structure
10
+ * { message: string, type: string }
11
+ */
12
+ export declare function isOperationErrorStructure(obj: unknown): obj is OperationErrorResponse;
13
+ export declare const MESSAGE_TYPES: {
14
+ readonly API_REQUEST: "BODHI_API_REQUEST";
15
+ readonly API_RESPONSE: "BODHI_API_RESPONSE";
16
+ readonly STREAM_REQUEST: "BODHI_STREAM_REQUEST";
17
+ readonly STREAM_CHUNK: "BODHI_STREAM_CHUNK";
18
+ readonly STREAM_ERROR: "BODHI_STREAM_ERROR";
19
+ readonly STREAM_API_ERROR: "BODHI_STREAM_API_ERROR";
20
+ readonly ERROR: "BODHI_ERROR";
21
+ readonly EXT_REQUEST: "BODHI_EXT_REQUEST";
22
+ readonly EXT_RESPONSE: "BODHI_EXT_RESPONSE";
23
+ };
24
+ export interface ApiRequest<T = unknown> {
25
+ method: string;
26
+ endpoint: string;
27
+ body?: T;
28
+ headers?: Record<string, string>;
29
+ }
30
+ export interface ApiRequestMessage<TReq = unknown> {
31
+ type: string;
32
+ requestId: string;
33
+ request: ApiRequest<TReq>;
34
+ }
35
+ /**
36
+ * Operation-level error response (network unreachable, timeout, extension error)
37
+ * NOT an API error (those come through ApiResponse with OpenAiApiError body)
38
+ * This is a response type, not a thrown error
39
+ */
40
+ export interface OperationErrorResponse {
41
+ message: string;
42
+ type: string;
43
+ }
44
+ /**
45
+ * Success API response message (HTTP request completed, regardless of status code)
46
+ */
47
+ export interface ApiResponseSuccessMessage<T = unknown> {
48
+ type: string;
49
+ requestId: string;
50
+ response: ApiResponse<T>;
51
+ }
52
+ /**
53
+ * Operation error response message - HTTP request couldn't complete
54
+ */
55
+ export interface OperationErrorResponseMessage {
56
+ type: string;
57
+ requestId: string;
58
+ error: OperationErrorResponse;
59
+ }
60
+ /**
61
+ * API response message - discriminated union
62
+ */
63
+ export type ApiResponseMessage<T = unknown> = ApiResponseSuccessMessage<T> | OperationErrorResponseMessage;
64
+ /**
65
+ * Type guard for operation error response
66
+ */
67
+ export declare function isOperationErrorResponse(msg: ApiResponseMessage): msg is OperationErrorResponseMessage;
68
+ /**
69
+ * Type guard to check if response is an API error (4xx/5xx)
70
+ * Narrows body type to OpenAiApiError
71
+ */
72
+ export declare function isApiErrorResponse<T>(response: ApiResponse<T>): response is ApiResponse<T> & {
73
+ body: OpenAiApiError;
74
+ status: number;
75
+ };
76
+ /**
77
+ * Type guard to check if response is successful (2xx)
78
+ * Narrows body type to T
79
+ */
80
+ export declare function isApiSuccessResponse<T>(response: ApiResponse<T>): response is ApiResponse<T> & {
81
+ body: T;
82
+ status: number;
83
+ };
84
+ export interface ErrorMessage {
85
+ type: string;
86
+ requestId: string;
87
+ response: {
88
+ body: ErrorBody;
89
+ status: number;
90
+ headers: Record<string, string>;
91
+ };
92
+ }
93
+ /**
94
+ * Stream chunk message - successful SSE chunk received
95
+ * Uses ApiResponse<T> wrapper for consistency with non-streaming pattern
96
+ */
97
+ export interface StreamChunkMessage<T = unknown> {
98
+ type: typeof MESSAGE_TYPES.STREAM_CHUNK;
99
+ requestId: string;
100
+ response: ApiResponse<T>;
101
+ }
102
+ /**
103
+ * Stream API error message - server returned error response (not SSE)
104
+ * E.g., 400/401/500 JSON error instead of SSE stream
105
+ */
106
+ export interface StreamApiErrorMessage {
107
+ type: typeof MESSAGE_TYPES.STREAM_API_ERROR;
108
+ requestId: string;
109
+ response: ApiResponse<OpenAiApiError>;
110
+ }
111
+ /**
112
+ * Stream error message - network/extension level error
113
+ * E.g., connection refused, timeout, extension error
114
+ */
115
+ export interface StreamErrorMessage {
116
+ type: typeof MESSAGE_TYPES.STREAM_ERROR;
117
+ requestId: string;
118
+ error: OperationErrorResponse;
119
+ }
120
+ /**
121
+ * Union type for all streaming messages
122
+ */
123
+ export type StreamMessage<T = unknown> = StreamChunkMessage<T> | StreamApiErrorMessage | StreamErrorMessage;
124
+ /**
125
+ * Type guard for stream chunk message
126
+ */
127
+ export declare function isStreamChunk<T>(msg: StreamMessage<T>): msg is StreamChunkMessage<T>;
128
+ /**
129
+ * Type guard for stream API error
130
+ */
131
+ export declare function isStreamApiError(msg: StreamMessage): msg is StreamApiErrorMessage;
132
+ /**
133
+ * Type guard for stream error
134
+ */
135
+ export declare function isStreamError(msg: StreamMessage): msg is StreamErrorMessage;
136
+ /**
137
+ * Interface for stream controller to handle SSE responses
138
+ */
139
+ export interface StreamController {
140
+ enqueue: (chunk: any) => void;
141
+ error: (err: Error) => void;
142
+ complete: () => void;
143
+ }
144
+ /**
145
+ * Interface for SSE data chunk
146
+ */
147
+ export interface SSEChunk {
148
+ done?: boolean;
149
+ [key: string]: any;
150
+ }
151
+ /**
152
+ * Generic extension request interface
153
+ */
154
+ export interface ExtRequest {
155
+ action: string;
156
+ params?: any;
157
+ }
158
+ /**
159
+ * Generic extension request message
160
+ */
161
+ export interface ExtRequestMessage {
162
+ type: 'BODHI_EXT_REQUEST';
163
+ requestId: string;
164
+ request: ExtRequest;
165
+ }
166
+ /**
167
+ * Extension-level error structure
168
+ */
169
+ export interface ExtError {
170
+ message: string;
171
+ type?: string;
172
+ }
173
+ /**
174
+ * Error response for extension operations
175
+ */
176
+ export interface ExtErrorResponse {
177
+ error: ExtError;
178
+ }
179
+ /**
180
+ * Union type for extension response (flattened - no wrapper for success)
181
+ * Success: T (the actual response data)
182
+ * Error: { error: ExtError }
183
+ */
184
+ export type ExtResponse<T = unknown> = T | ExtErrorResponse;
185
+ /**
186
+ * Type guard to check if extension response is an error
187
+ */
188
+ export declare function isExtError<T>(res: ExtResponse<T>): res is ExtErrorResponse;
189
+ /**
190
+ * Generic extension response message
191
+ */
192
+ export interface ExtResponseMessage<T = unknown> {
193
+ type: 'BODHI_EXT_RESPONSE';
194
+ requestId: string;
195
+ response: ExtResponse<T>;
196
+ }
197
+ /**
198
+ * Get Extension ID request (no params needed)
199
+ */
200
+ export interface GetExtensionIdRequest extends ExtRequest {
201
+ action: 'get_extension_id';
202
+ params?: undefined;
203
+ }
204
+ /**
205
+ * Get Extension ID response body
206
+ */
207
+ export interface GetExtensionIdResponse {
208
+ extension_id: string;
209
+ }
210
+ /**
211
+ * Test Connection request
212
+ */
213
+ export interface TestConnectionRequest extends ExtRequest {
214
+ action: 'test_connection';
215
+ params: {
216
+ url: string;
217
+ };
218
+ }
219
+ /**
220
+ * Test Connection response body (reuses ServerStateInfo)
221
+ */
222
+ export type TestConnectionResponse = ServerStateInfo;
@@ -0,0 +1,35 @@
1
+ import { AuthState, LogLevel, UIClient } from '../../core/src/index.ts';
2
+ import { ReactNode } from 'react';
3
+ import { ClientContextState } from './client-ctx';
4
+ export type SetupState = 'ready' | 'loading' | 'loaded';
5
+ export interface BodhiProviderProps {
6
+ children: ReactNode;
7
+ client: UIClient;
8
+ modalHtmlPath?: string;
9
+ handleCallback?: boolean;
10
+ callbackPath?: string;
11
+ basePath?: string;
12
+ logLevel?: LogLevel;
13
+ }
14
+ export interface BodhiContext {
15
+ client: UIClient;
16
+ clientState: ClientContextState;
17
+ setupState: SetupState;
18
+ auth: AuthState;
19
+ isAuthLoading: boolean;
20
+ login: () => Promise<void>;
21
+ logout: () => Promise<void>;
22
+ showSetup: () => Promise<void>;
23
+ hideSetup: () => void;
24
+ isAuthenticated: boolean;
25
+ canLogin: boolean;
26
+ isReady: boolean;
27
+ isServerReady: boolean;
28
+ isOverallReady: boolean;
29
+ isInitializing: boolean;
30
+ isExtension: boolean;
31
+ isDirect: boolean;
32
+ }
33
+ export declare const BodhiReactContext: import('react').Context<BodhiContext | null>;
34
+ export declare function BodhiProvider({ children, client, modalHtmlPath, handleCallback, callbackPath, basePath, logLevel, }: BodhiProviderProps): import("react/jsx-runtime").JSX.Element;
35
+ export declare function useBodhi(): BodhiContext;
@@ -0,0 +1,16 @@
1
+ import { UIClient, LogLevel } from '../../core/src/index.ts';
2
+ import { SetupState } from './BodhiProvider';
3
+ interface SetupModalProcessorProps {
4
+ client: UIClient;
5
+ modalHtmlPath?: string;
6
+ hideSetup: () => void;
7
+ onSetupReady?: () => void;
8
+ setupState: SetupState;
9
+ basePath?: string;
10
+ logLevel?: LogLevel;
11
+ }
12
+ /**
13
+ * SetupModalProcessor - Headless React component managing setup modal business logic
14
+ */
15
+ export declare function SetupModalProcessor({ client, modalHtmlPath, hideSetup, onSetupReady, setupState, basePath, logLevel, }: SetupModalProcessorProps): null;
16
+ export {};
@@ -0,0 +1,7 @@
1
+ /**
2
+ * Re-export all OpenAI-compatible types from @bodhiapp/bodhi-js-core/api
3
+ *
4
+ * Usage:
5
+ * import type { CreateChatCompletionRequest, Model } from '@bodhiapp/bodhi-js-react-core/api';
6
+ */
7
+ export * from '../../../core/src/index.ts/api';
@@ -0,0 +1 @@
1
+ export declare const BUILD_MODE: string;
@@ -0,0 +1,26 @@
1
+ import { BackendServerState, ClientState } from '../../core/src/index.ts';
2
+ import { OperationErrorResponse } from '../../../bodhi-browser-ext/src/types';
3
+ export type ClientContextStatus = 'not-initialized' | 'initializing' | 'extension-not-found' | 'direct-not-connected' | 'ready';
4
+ export interface ClientContextState {
5
+ status: ClientContextStatus;
6
+ mode: 'extension' | 'direct' | null;
7
+ extensionId: string | null;
8
+ url: string | null;
9
+ server: BackendServerState;
10
+ error: OperationErrorResponse | null;
11
+ }
12
+ export declare const INITIAL_CLIENT_CONTEXT_STATE: ClientContextState;
13
+ export declare const INITIALIZING_CLIENT_CONTEXT_STATE: ClientContextState;
14
+ export declare function isClientCtxNotInitialized(state: ClientContextState): boolean;
15
+ export declare function isClientCtxInitializing(state: ClientContextState): boolean;
16
+ export declare function isClientCtxInitialized(state: ClientContextState): boolean;
17
+ export declare function isClientCtxReady(state: ClientContextState): boolean;
18
+ export declare function isOverallReady(state: ClientContextState): boolean;
19
+ export declare function clientStateToContextState(state: ClientState): ClientContextState;
20
+ export declare const ClientCtxState: {
21
+ readonly isNotInitialized: typeof isClientCtxNotInitialized;
22
+ readonly isInitializing: typeof isClientCtxInitializing;
23
+ readonly isInitialized: typeof isClientCtxInitialized;
24
+ readonly isReady: typeof isClientCtxReady;
25
+ readonly isOverallReady: typeof isOverallReady;
26
+ };
@@ -0,0 +1,16 @@
1
+ /**
2
+ * @bodhiapp/bodhi-js-react - React bindings for Bodhi SDK
3
+ *
4
+ * Public API exports - minimal surface area following industry best practices
5
+ */
6
+ export { BodhiProvider, BodhiReactContext, useBodhi, type BodhiContext, type BodhiProviderProps, type SetupState, } from './BodhiProvider';
7
+ export type { ClientContextState, ClientContextStatus } from './client-ctx';
8
+ export { INITIAL_CLIENT_CONTEXT_STATE, INITIALIZING_CLIENT_CONTEXT_STATE } from './client-ctx';
9
+ export { ClientCtxState, clientStateToContextState, isClientCtxInitialized, isClientCtxInitializing, isClientCtxNotInitialized, isClientCtxReady, isOverallReady, } from './client-ctx';
10
+ export type { ApiResponseResult, ClientState } from '../../core/src/index.ts';
11
+ export { isApiResultError, isApiResultOperationError, isApiResultSuccess, isDirectState, isExtensionState, isWebUIClient, } from '../../core/src/index.ts';
12
+ export { createApiError, createOperationError } from '../../core/src/index.ts';
13
+ export type { AuthState, UIClient } from '../../core/src/index.ts';
14
+ export { isAuthError, isAuthLoading, isAuthenticated, isClientReady, } from '../../core/src/index.ts';
15
+ export { isOperationError, type OperationError } from '../../core/src/index.ts';
16
+ export { BUILD_MODE as REACT_CORE_BUILD_MODE } from './build-info';
@@ -0,0 +1,2 @@
1
+ "use strict";Object.defineProperty(exports,Symbol.toStringTag,{value:"Module"});const k=require("react/jsx-runtime"),s=require("@bodhiapp/bodhi-js-core"),r=require("react"),p={MODAL_READY:"modal:ready",MODAL_REFRESH:"modal:refresh",MODAL_CLOSE:"modal:close",MODAL_COMPLETE:"modal:complete",MODAL_LNA_CONNECT:"modal:lna:connect",MODAL_LNA_SKIP:"modal:lna:skip",MODAL_CONFIRM_SERVER_INSTALL:"modal:confirm-server-install",MODAL_SELECT_CONNECTION:"modal:select-connection"};function H({client:e,modalHtmlPath:i,hideSetup:L,onSetupReady:_,setupState:R,basePath:m="/",logLevel:A="warn"}){const y=R!=="ready",O=r.useMemo(()=>new s.Logger("SetupModalProcessor",A),[A]),l=r.useRef(null),u=r.useMemo(()=>new s.BodhiClientUserPrefsManager(s.createStoragePrefixWithBasePath(m,"bodhijs:")),[m]),C=r.useRef(null),E=r.useCallback(t=>t==="direct"?"lna":t==="extension"?"extension":null,[]),v=r.useCallback(t=>t.extension==="ready"?{status:"ready",version:"unknown",id:t.extensionId}:t.extension==="not-found"?{status:"not-installed",error:{message:"Extension not found",code:"ext-not-installed"}}:{status:"unreachable",error:{message:"Client not initialized",code:"ext-connection-failed"}},[]),b=r.useCallback(t=>{if(t.server.status==="pending-extension-ready")return{status:"pending-extension-ready",error:{message:"Extension not ready",code:"server-pending-ext-ready"}};const n=t.server;switch(n.status){case"ready":return{status:"ready",version:n.version||"unknown"};case"setup":return{status:"setup",version:n.version||"unknown",error:{message:n.error?.message||"Setup required",code:"server-in-setup-status"}};case"resource-admin":return{status:"resource-admin",version:n.version||"unknown",error:{message:n.error?.message||"Resource admin required",code:"server-in-admin-status"}};case"error":return{status:"error",error:{message:n.error?.message||"Unknown error",code:"server-unexpected-error"}};case"not-reachable":return{status:"unreachable",error:{message:n.error?.message||"Server not reachable",code:"server-conn-refused"}};default:return{status:"unreachable",error:{message:"Unknown server status",code:"server-unexpected-error"}}}},[]),g=r.useCallback(t=>{if(t.server.status==="not-connected")return{status:"pending-lna-ready"};const n=t.server;switch(n.status){case"ready":return{status:"ready",version:n.version||"unknown"};case"setup":return{status:"setup",version:n.version||"unknown"};case"resource-admin":return{status:"resource-admin",version:n.version||"unknown"};case"error":case"not-reachable":return{status:"error",error:{message:n.error?.message||"Connection error"}};default:return{status:"error",error:{message:"Unknown server status"}}}},[]),I=r.useCallback((t,n)=>{if(t.server.status!=="pending-extension-ready"){const o=t.server.status;if(o==="ready"||o==="setup"||o==="resource-admin")return!0}if(n.server.status!=="not-connected"){const o=n.server.status;if(o==="ready"||o==="setup"||o==="resource-admin")return!0}return!1},[]),h=r.useCallback((t,n,o)=>{if(n==="skipped")return{status:"skipped",serverUrl:o};if(t.server.status!=="not-connected"){const d=t.server;return d.status==="ready"||d.status==="setup"||d.status==="resource-admin"?{status:"granted",serverUrl:o}:{status:"unreachable",serverUrl:o,error:{message:d.error?.message||"Server unreachable",code:"lna-unreachable"}}}return n==="granted"?{status:"granted",serverUrl:o}:{status:"prompt",serverUrl:o}},[]),S=r.useCallback(async(t=!1)=>{const n=s.detectBrowser().type,o=s.detectOS().type;let d=await e.getExtensionState();(d.extension==="not-initialized"||t)&&(d=await e.testExtensionConnectivity());let a=await e.getDirectState();const c=u.getDirectStatus();c==="granted"&&(a.server.status==="not-connected"||t)&&(a=await e.testDirectConnectivity());const w=s.getServerUrl(a)||"http://localhost:1135",x=h(a,c,w);return e.getConnectionMode()===null&&(s.isDirectServerReady(a)?await e.setConnectionMode("direct"):s.isExtensionServerReady(d)&&await e.setConnectionMode("extension")),u.isServerInstallConfirmed()||I(d,a)&&u.setServerInstallConfirmed(!0),{extension:v(d),server:b(d),lna:x,lnaServer:g(a),env:{browser:n,os:o},browsers:s.BROWSER_CONFIGS,os:s.OS_CONFIGS,userConfirmations:{serverInstall:u.isServerInstallConfirmed()},selectedConnection:E(e.getConnectionMode())}},[e,u,v,b,g,E,h,I]),f=r.useCallback(()=>{if(!C.current)throw new Error("Cannot get state: currentStateRef is null");return{...C.current,userConfirmations:{serverInstall:u.isServerInstallConfirmed()},selectedConnection:E(e.getConnectionMode())}},[u,e,E]),T=r.useMemo(()=>({[p.MODAL_READY]:async()=>(O.info("MODAL_READY: building initial state"),{setupState:f()}),[p.MODAL_REFRESH]:async()=>{O.info("MODAL_REFRESH: refreshing state");const t=await S(!0);C.current=t;const n=f();return O.info(`MODAL_REFRESH: state refreshed
2
+ `,JSON.stringify(n,null,2)),l.current?.updateState(f()),{setupState:n}},[p.MODAL_LNA_CONNECT]:async t=>{const n=t.payload.serverUrl;console.log("[SetupModalProcessor] LNA connect:",n);const o=await e.testDirectConnectivity(n);if(o.server.status!=="not-connected"){const a=o.server.status;if(a==="ready"||a==="setup"||a==="resource-admin"){u.setDirectStatus("granted"),e.getConnectionMode()===null&&await e.setConnectionMode("direct");const c=await S();return C.current=c,l.current?.updateState(f()),{success:!0}}}const d=await S();return C.current=d,l.current?.updateState(f()),{success:!1}},[p.MODAL_LNA_SKIP]:async()=>{u.setDirectStatus("skipped");const t=await S();return C.current=t,l.current?.updateState(f()),{success:!0}},[p.MODAL_CLOSE]:()=>{L()},[p.MODAL_COMPLETE]:()=>{L()},[p.MODAL_CONFIRM_SERVER_INSTALL]:t=>(u.setServerInstallConfirmed(t.payload.confirmed),l.current?.updateState(f()),{success:!0}),[p.MODAL_SELECT_CONNECTION]:async t=>{const o=t.payload.connection==="lna"?"direct":"extension";return await e.setConnectionMode(o),l.current?.updateState(f()),{success:!0}}}),[O,e,u,S,f,g,L]);return r.useEffect(()=>(l.current=new s.OnboardingModal({modalHtmlPath:i,handlers:T}),()=>{l.current?.destroy(),l.current=null}),[i,T]),r.useEffect(()=>{y&&l.current?S(!0).then(t=>{C.current=t,l.current?.show(t),_?.()}).catch(t=>{console.error("[SetupModalProcessor] buildSetupState failed:",t)}):!y&&l.current&&l.current.destroy()},[y,S,_]),null}const P={status:"not-initialized",mode:null,extensionId:null,url:null,server:s.BACKEND_SERVER_NOT_CONNECTED,error:null},z={status:"initializing",mode:null,extensionId:null,url:null,server:s.BACKEND_SERVER_NOT_CONNECTED,error:null};function B(e){return e.status==="not-initialized"}function j(e){return e.status==="initializing"}function U(e){return e.status!=="not-initialized"&&e.status!=="initializing"}function D(e){return e.status==="ready"}function F(e){return D(e)&&e.server.status==="ready"}function G(e){return s.isExtensionState(e)?{status:e.extension==="not-initialized"?"initializing":e.extension==="not-found"?"extension-not-found":"ready",mode:"extension",extensionId:e.extensionId,url:null,server:e.server,error:e.server.error}:{status:e.url===null?"direct-not-connected":"ready",mode:"direct",extensionId:null,url:e.url,server:e.server,error:e.server.error}}const K={isNotInitialized:B,isInitializing:j,isInitialized:U,isReady:D,isOverallReady:F},N=r.createContext(null);N.displayName="BodhiContext";function V({children:e,client:i,modalHtmlPath:L,handleCallback:_=!0,callbackPath:R="/callback",basePath:m="/",logLevel:A="warn"}){const y=r.useMemo(()=>new s.Logger("BodhiProvider",A),[A]),O=r.useRef(!1),l=r.useRef(!1),[u,C]=r.useState(P),[E,v]=r.useState(s.INITIAL_AUTH_STATE),[b,g]=r.useState(!1),[I,h]=r.useState("ready");r.useEffect(()=>{const a=c=>{switch(c.type){case"client-state":C(G(c.state));break;case"auth-state":v(c.state),g(!1);break}};return i.setStateCallback(a),()=>{i.setStateCallback(s.NOOP_STATE_CALLBACK)}},[i]);const S=r.useCallback(async()=>{h("loading")},[]),f=r.useCallback(()=>{h("ready")},[]),T=r.useCallback(()=>{h("loaded")},[]),t=r.useCallback(async a=>{C(z);try{await i.init(a||{})}catch(c){y.error("Init failed:",c)}},[i,y]);r.useEffect(()=>{if(l.current)return;l.current=!0,(async()=>{if(await t(),!_)return;const c=new URL(window.location.href);if(c.pathname!==R)return;const M=c.searchParams.get("code"),w=c.searchParams.get("state");!M||!w||O.current||(O.current=!0,s.isWebUIClient(i)&&(g(!0),i.handleOAuthCallback(M,w).then(()=>{window.history.replaceState({},"",m)}).catch(x=>{y.error("OAuth callback failed:",x),v({status:"error",user:null,accessToken:null,error:{message:x instanceof Error?x.message:"OAuth callback failed",code:"OAUTH_CALLBACK_FAILED"}}),g(!1),window.history.replaceState({},"",m)})))})()},[t,i,_,R,m]);const n=r.useCallback(async()=>{g(!0);try{await i.login()}catch(a){v({status:"error",user:null,accessToken:null,error:{message:a instanceof Error?a.message:"Login failed",code:"LOGIN_FAILED"}}),g(!1)}},[i]),o=r.useCallback(async()=>{try{await i.logout()}catch(a){v({status:"error",user:null,accessToken:null,error:{message:a instanceof Error?a.message:"Logout failed",code:"LOGOUT_FAILED"}})}},[i]),d=r.useMemo(()=>{const a=u.status==="ready",c=u.server.status==="ready";return{client:i,clientState:u,auth:E,isAuthLoading:b,login:n,logout:o,showSetup:S,hideSetup:f,setupState:I,isAuthenticated:E.status==="authenticated",canLogin:a&&!b,isReady:a,isServerReady:c,isOverallReady:a&&c,isInitializing:u.status==="initializing",isExtension:u.mode==="extension",isDirect:u.mode==="direct"}},[i,u,E,b,I,n,o,S,f]);return k.jsxs(N.Provider,{value:d,children:[k.jsx(H,{client:i,modalHtmlPath:L,hideSetup:f,onSetupReady:T,setupState:I,basePath:m,logLevel:A}),e]})}function W(){const e=r.useContext(N);if(!e)throw new Error("useBodhi must be used within BodhiProvider");return e}const q="production";Object.defineProperty(exports,"createApiError",{enumerable:!0,get:()=>s.createApiError});Object.defineProperty(exports,"createOperationError",{enumerable:!0,get:()=>s.createOperationError});Object.defineProperty(exports,"isApiResultError",{enumerable:!0,get:()=>s.isApiResultError});Object.defineProperty(exports,"isApiResultOperationError",{enumerable:!0,get:()=>s.isApiResultOperationError});Object.defineProperty(exports,"isApiResultSuccess",{enumerable:!0,get:()=>s.isApiResultSuccess});Object.defineProperty(exports,"isAuthError",{enumerable:!0,get:()=>s.isAuthError});Object.defineProperty(exports,"isAuthLoading",{enumerable:!0,get:()=>s.isAuthLoading});Object.defineProperty(exports,"isAuthenticated",{enumerable:!0,get:()=>s.isAuthenticated});Object.defineProperty(exports,"isClientReady",{enumerable:!0,get:()=>s.isClientReady});Object.defineProperty(exports,"isDirectState",{enumerable:!0,get:()=>s.isDirectState});Object.defineProperty(exports,"isExtensionState",{enumerable:!0,get:()=>s.isExtensionState});Object.defineProperty(exports,"isOperationError",{enumerable:!0,get:()=>s.isOperationError});Object.defineProperty(exports,"isWebUIClient",{enumerable:!0,get:()=>s.isWebUIClient});exports.BodhiProvider=V;exports.BodhiReactContext=N;exports.ClientCtxState=K;exports.INITIALIZING_CLIENT_CONTEXT_STATE=z;exports.INITIAL_CLIENT_CONTEXT_STATE=P;exports.REACT_CORE_BUILD_MODE=q;exports.clientStateToContextState=G;exports.isClientCtxInitialized=U;exports.isClientCtxInitializing=j;exports.isClientCtxNotInitialized=B;exports.isClientCtxReady=D;exports.isOverallReady=F;exports.useBodhi=W;
@@ -0,0 +1,2 @@
1
+ export * from './bodhi-js-sdk/react-core/src/index'
2
+ export {}