@realtimex/sdk 1.7.21 → 2.0.1

package/dist/chunk-ORAAYW4C.mjs

@@ -0,0 +1,271 @@
+// src/v1/errors.ts
+var DeveloperApiError = class extends Error {
+  constructor(status, code, message) {
+    super(message);
+    this.status = status;
+    this.code = code;
+    this.name = "DeveloperApiError";
+  }
+};
+var AuthenticationError = class extends DeveloperApiError {
+  constructor(message = "Invalid or missing API key") {
+    super(403, "AUTHENTICATION_ERROR", message);
+    this.name = "AuthenticationError";
+  }
+};
+var NotFoundError = class extends DeveloperApiError {
+  constructor(message = "Resource not found") {
+    super(404, "NOT_FOUND", message);
+    this.name = "NotFoundError";
+  }
+};
+var ValidationError = class extends DeveloperApiError {
+  constructor(message) {
+    super(400, "VALIDATION_ERROR", message);
+    this.name = "ValidationError";
+  }
+};
+var ServerError = class extends DeveloperApiError {
+  constructor(message = "Internal server error") {
+    super(500, "SERVER_ERROR", message);
+    this.name = "ServerError";
+  }
+};
+
+// src/v1/client.ts
+var DeveloperApiClient = class {
+  constructor(baseUrl, apiKey, appId) {
+    this.baseUrl = baseUrl.replace(/\/$/, "");
+    this.apiKey = apiKey;
+    this.appId = appId;
+  }
+  getHeaders(extra) {
+    const headers = {
+      "Content-Type": "application/json",
+      "Authorization": `Bearer ${this.apiKey}`
+    };
+    if (this.appId) headers["x-app-id"] = this.appId;
+    return { ...headers, ...extra };
+  }
+  async handleResponse(response) {
+    let data;
+    try {
+      data = await response.json();
+    } catch {
+      data = {};
+    }
+    if (response.ok) return data;
+    const message = data?.message || data?.error || response.statusText || "Request failed";
+    switch (response.status) {
+      case 400:
+        throw new ValidationError(message);
+      case 401:
+      case 403:
+        throw new AuthenticationError(message);
+      case 404:
+        throw new NotFoundError(message);
+      case 500:
+      case 502:
+      case 503:
+        throw new ServerError(message);
+      default:
+        throw new DeveloperApiError(response.status, "API_ERROR", message);
+    }
+  }
+  /**
+   * Make a JSON request to the v1 API.
+   */
+  async request(method, path, body) {
+    const url = `${this.baseUrl}/api${path}`;
+    const response = await fetch(url, {
+      method,
+      headers: this.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+    return this.handleResponse(response);
+  }
+  /**
+   * Make a multipart/form-data request (e.g. file uploads).
+   * Do NOT set Content-Type — browser/fetch will set it with the boundary.
+   */
+  async requestMultipart(method, path, form) {
+    const url = `${this.baseUrl}/api${path}`;
+    const authHeaders = { "Authorization": `Bearer ${this.apiKey}` };
+    if (this.appId) authHeaders["x-app-id"] = this.appId;
+    const response = await fetch(url, {
+      method,
+      headers: authHeaders,
+      body: form
+    });
+    return this.handleResponse(response);
+  }
+  /**
+   * Make a raw request and return the Response object directly.
+   * Used for streaming (SSE) endpoints.
+   */
+  async requestRaw(method, path, body) {
+    const url = `${this.baseUrl}/api${path}`;
+    return fetch(url, {
+      method,
+      headers: this.getHeaders(),
+      body: body !== void 0 ? JSON.stringify(body) : void 0
+    });
+  }
+};
+
+// src/v1/modules/v1Workspace.ts
+var V1WorkspaceModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new workspace
+   * @see POST /v1/workspace/new
+   */
+  async createWorkspace(body) {
+    return this.client.request("POST", `/v1/workspace/new`, body);
+  }
+  /**
+   * List all current workspaces
+   * @see GET /v1/workspaces
+   */
+  async listWorkspaces() {
+    return this.client.request("GET", `/v1/workspaces`);
+  }
+  /**
+   * Get a workspace by its unique slug.
+   * @see GET /v1/workspace/{slug}
+   */
+  async getWorkspace(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}`);
+  }
+  /**
+   * Deletes a workspace by its slug.
+   * @see DELETE /v1/workspace/{slug}
+   */
+  async deleteWorkspace(slug) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}`);
+  }
+  /**
+   * Update workspace settings by its unique slug.
+   * @see POST /v1/workspace/{slug}/update
+   */
+  async updateWorkspace(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/update`, body);
+  }
+  /**
+   * Get a workspaces chats regardless of user by its unique slug.
+   * @see GET /v1/workspace/{slug}/chats
+   */
+  async listChats(slug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/chats`);
+  }
+  /**
+   * Add or remove documents from a workspace by its unique slug.
+   * @see POST /v1/workspace/{slug}/update-embeddings
+   */
+  async updateEmbeddings(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/update-embeddings`, body);
+  }
+  /**
+   * Add or remove pin from a document in a workspace by its unique slug.
+   * @see POST /v1/workspace/{slug}/update-pin
+   */
+  async updatePin(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/update-pin`, body);
+  }
+  /**
+   * Execute a chat with a workspace
+   * @see POST /v1/workspace/{slug}/chat
+   */
+  async chat(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/chat`, body);
+  }
+  /**
+   * Execute a streamable chat with a workspace
+   * @see POST /v1/workspace/{slug}/stream-chat
+   */
+  // @streaming-stub — implement SSE parsing in overrides/v1WorkspaceStreaming.ts
+  async streamChat(slug, body) {
+    return this.client.requestRaw("POST", `/v1/workspace/${slug}/stream-chat`, body);
+  }
+  /**
+   * Perform a vector similarity search in a workspace
+   * @see POST /v1/workspace/{slug}/vector-search
+   */
+  async vectorSearch(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/vector-search`, body);
+  }
+};
+
+// src/v1/modules/v1Thread.ts
+var V1ThreadModule = class {
+  constructor(client) {
+    this.client = client;
+  }
+  /**
+   * Create a new workspace thread
+   * @see POST /v1/workspace/{slug}/thread/new
+   */
+  async createThread(slug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/new`, body);
+  }
+  /**
+   * Update thread settings by its unique slug.
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/update
+   */
+  async updateThread(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/update`, body);
+  }
+  /**
+   * Delete a workspace thread
+   * @see DELETE /v1/workspace/{slug}/thread/{threadSlug}
+   */
+  async deleteThread(slug, threadSlug) {
+    return this.client.request("DELETE", `/v1/workspace/${slug}/thread/${threadSlug}`);
+  }
+  /**
+   * Get chats for a workspace thread
+   * @see GET /v1/workspace/{slug}/thread/{threadSlug}/chats
+   */
+  async listChats(slug, threadSlug) {
+    return this.client.request("GET", `/v1/workspace/${slug}/thread/${threadSlug}/chats`);
+  }
+  /**
+   * Chat with a workspace thread
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/chat
+   */
+  async chat(slug, threadSlug, body) {
+    return this.client.request("POST", `/v1/workspace/${slug}/thread/${threadSlug}/chat`, body);
+  }
+  /**
+   * Stream chat with a workspace thread
+   * @see POST /v1/workspace/{slug}/thread/{threadSlug}/stream-chat
+   */
+  // @streaming-stub — implement SSE parsing in overrides/v1ThreadStreaming.ts
+  async streamChat(slug, threadSlug, body) {
+    return this.client.requestRaw("POST", `/v1/workspace/${slug}/thread/${threadSlug}/stream-chat`, body);
+  }
+};
+
+// src/v1/namespace.ts
+var V1ApiNamespace = class {
+  // [GENERATED-PROPS-END]
+  constructor(baseUrl, apiKey, appId) {
+    this._client = new DeveloperApiClient(baseUrl, apiKey, appId);
+    this.workspace = new V1WorkspaceModule(this._client);
+    this.thread = new V1ThreadModule(this._client);
+  }
+};
+
+export {
+  DeveloperApiError,
+  AuthenticationError,
+  NotFoundError,
+  ValidationError,
+  ServerError,
+  DeveloperApiClient,
+  V1WorkspaceModule,
+  V1ThreadModule,
+  V1ApiNamespace
+};

package/dist/errors-C98IGxYU.d.mts

@@ -0,0 +1,168 @@
+/**
+ * DeveloperApiClient - HTTP client for the RealtimeX v1 Developer API.
+ *
+ * Supports two authentication modes:
+ * - API Key: Authorization: Bearer <apiKey>
+ * - App ID: x-app-id header (for LocalApp / SDK agent authentication)
+ *
+ * When both are provided, x-app-id takes priority on the server side.
+ */
+declare class DeveloperApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly appId?;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+    private getHeaders;
+    private handleResponse;
+    /**
+     * Make a JSON request to the v1 API.
+     */
+    request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
+    /**
+     * Make a multipart/form-data request (e.g. file uploads).
+     * Do NOT set Content-Type — browser/fetch will set it with the boundary.
+     */
+    requestMultipart<T = unknown>(method: string, path: string, form: FormData): Promise<T>;
+    /**
+     * Make a raw request and return the Response object directly.
+     * Used for streaming (SSE) endpoints.
+     */
+    requestRaw(method: string, path: string, body?: unknown): Promise<Response>;
+}
+
+declare class V1WorkspaceModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * Create a new workspace
+     * @see POST /v1/workspace/new
+     */
+    createWorkspace(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * List all current workspaces
+     * @see GET /v1/workspaces
+     */
+    listWorkspaces(): Promise<unknown>;
+    /**
+     * Get a workspace by its unique slug.
+     * @see GET /v1/workspace/{slug}
+     */
+    getWorkspace(slug: string): Promise<unknown>;
+    /**
+     * Deletes a workspace by its slug.
+     * @see DELETE /v1/workspace/{slug}
+     */
+    deleteWorkspace(slug: string): Promise<unknown>;
+    /**
+     * Update workspace settings by its unique slug.
+     * @see POST /v1/workspace/{slug}/update
+     */
+    updateWorkspace(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get a workspaces chats regardless of user by its unique slug.
+     * @see GET /v1/workspace/{slug}/chats
+     */
+    listChats(slug: string): Promise<unknown>;
+    /**
+     * Add or remove documents from a workspace by its unique slug.
+     * @see POST /v1/workspace/{slug}/update-embeddings
+     */
+    updateEmbeddings(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Add or remove pin from a document in a workspace by its unique slug.
+     * @see POST /v1/workspace/{slug}/update-pin
+     */
+    updatePin(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Execute a chat with a workspace
+     * @see POST /v1/workspace/{slug}/chat
+     */
+    chat(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Execute a streamable chat with a workspace
+     * @see POST /v1/workspace/{slug}/stream-chat
+     */
+    streamChat(slug: string, body?: Record<string, unknown>): Promise<Response>;
+    /**
+     * Perform a vector similarity search in a workspace
+     * @see POST /v1/workspace/{slug}/vector-search
+     */
+    vectorSearch(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+
+declare class V1ThreadModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * Create a new workspace thread
+     * @see POST /v1/workspace/{slug}/thread/new
+     */
+    createThread(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Update thread settings by its unique slug.
+     * @see POST /v1/workspace/{slug}/thread/{threadSlug}/update
+     */
+    updateThread(slug: string, threadSlug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Delete a workspace thread
+     * @see DELETE /v1/workspace/{slug}/thread/{threadSlug}
+     */
+    deleteThread(slug: string, threadSlug: string): Promise<unknown>;
+    /**
+     * Get chats for a workspace thread
+     * @see GET /v1/workspace/{slug}/thread/{threadSlug}/chats
+     */
+    listChats(slug: string, threadSlug: string): Promise<unknown>;
+    /**
+     * Chat with a workspace thread
+     * @see POST /v1/workspace/{slug}/thread/{threadSlug}/chat
+     */
+    chat(slug: string, threadSlug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Stream chat with a workspace thread
+     * @see POST /v1/workspace/{slug}/thread/{threadSlug}/stream-chat
+     */
+    streamChat(slug: string, threadSlug: string, body?: Record<string, unknown>): Promise<Response>;
+}
+
+/**
+ * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
+ *
+ * Usage:
+ *   const sdk = new RealtimeXSDK({ realtimex: { apiKey: 'sk-...' } });
+ *   await sdk.v1?.workspace.listWorkspaces();
+ *   await sdk.v1?.thread.createThread('workspace-slug');
+ *
+ * Regenerate modules: node scripts/generate-v1-sdk.mjs --force
+ */
+
+declare class V1ApiNamespace {
+    /** @internal Shared HTTP client used by all v1 modules */
+    readonly _client: DeveloperApiClient;
+    workspace: V1WorkspaceModule;
+    thread: V1ThreadModule;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+}
+
+/**
+ * RealtimeX SDK - Developer API (v1) Error Classes
+ */
+declare class DeveloperApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+declare class AuthenticationError extends DeveloperApiError {
+    constructor(message?: string);
+}
+declare class NotFoundError extends DeveloperApiError {
+    constructor(message?: string);
+}
+declare class ValidationError extends DeveloperApiError {
+    constructor(message: string);
+}
+declare class ServerError extends DeveloperApiError {
+    constructor(message?: string);
+}
+
+export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, DeveloperApiError as a, ValidationError as b, V1WorkspaceModule as c, V1ThreadModule as d };

package/dist/errors-C98IGxYU.d.ts

@@ -0,0 +1,168 @@
+/**
+ * DeveloperApiClient - HTTP client for the RealtimeX v1 Developer API.
+ *
+ * Supports two authentication modes:
+ * - API Key: Authorization: Bearer <apiKey>
+ * - App ID: x-app-id header (for LocalApp / SDK agent authentication)
+ *
+ * When both are provided, x-app-id takes priority on the server side.
+ */
+declare class DeveloperApiClient {
+    private readonly baseUrl;
+    private readonly apiKey;
+    private readonly appId?;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+    private getHeaders;
+    private handleResponse;
+    /**
+     * Make a JSON request to the v1 API.
+     */
+    request<T = unknown>(method: string, path: string, body?: unknown): Promise<T>;
+    /**
+     * Make a multipart/form-data request (e.g. file uploads).
+     * Do NOT set Content-Type — browser/fetch will set it with the boundary.
+     */
+    requestMultipart<T = unknown>(method: string, path: string, form: FormData): Promise<T>;
+    /**
+     * Make a raw request and return the Response object directly.
+     * Used for streaming (SSE) endpoints.
+     */
+    requestRaw(method: string, path: string, body?: unknown): Promise<Response>;
+}
+
+declare class V1WorkspaceModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * Create a new workspace
+     * @see POST /v1/workspace/new
+     */
+    createWorkspace(body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * List all current workspaces
+     * @see GET /v1/workspaces
+     */
+    listWorkspaces(): Promise<unknown>;
+    /**
+     * Get a workspace by its unique slug.
+     * @see GET /v1/workspace/{slug}
+     */
+    getWorkspace(slug: string): Promise<unknown>;
+    /**
+     * Deletes a workspace by its slug.
+     * @see DELETE /v1/workspace/{slug}
+     */
+    deleteWorkspace(slug: string): Promise<unknown>;
+    /**
+     * Update workspace settings by its unique slug.
+     * @see POST /v1/workspace/{slug}/update
+     */
+    updateWorkspace(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Get a workspaces chats regardless of user by its unique slug.
+     * @see GET /v1/workspace/{slug}/chats
+     */
+    listChats(slug: string): Promise<unknown>;
+    /**
+     * Add or remove documents from a workspace by its unique slug.
+     * @see POST /v1/workspace/{slug}/update-embeddings
+     */
+    updateEmbeddings(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Add or remove pin from a document in a workspace by its unique slug.
+     * @see POST /v1/workspace/{slug}/update-pin
+     */
+    updatePin(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Execute a chat with a workspace
+     * @see POST /v1/workspace/{slug}/chat
+     */
+    chat(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Execute a streamable chat with a workspace
+     * @see POST /v1/workspace/{slug}/stream-chat
+     */
+    streamChat(slug: string, body?: Record<string, unknown>): Promise<Response>;
+    /**
+     * Perform a vector similarity search in a workspace
+     * @see POST /v1/workspace/{slug}/vector-search
+     */
+    vectorSearch(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+}
+
+declare class V1ThreadModule {
+    private readonly client;
+    constructor(client: DeveloperApiClient);
+    /**
+     * Create a new workspace thread
+     * @see POST /v1/workspace/{slug}/thread/new
+     */
+    createThread(slug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Update thread settings by its unique slug.
+     * @see POST /v1/workspace/{slug}/thread/{threadSlug}/update
+     */
+    updateThread(slug: string, threadSlug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Delete a workspace thread
+     * @see DELETE /v1/workspace/{slug}/thread/{threadSlug}
+     */
+    deleteThread(slug: string, threadSlug: string): Promise<unknown>;
+    /**
+     * Get chats for a workspace thread
+     * @see GET /v1/workspace/{slug}/thread/{threadSlug}/chats
+     */
+    listChats(slug: string, threadSlug: string): Promise<unknown>;
+    /**
+     * Chat with a workspace thread
+     * @see POST /v1/workspace/{slug}/thread/{threadSlug}/chat
+     */
+    chat(slug: string, threadSlug: string, body?: Record<string, unknown>): Promise<unknown>;
+    /**
+     * Stream chat with a workspace thread
+     * @see POST /v1/workspace/{slug}/thread/{threadSlug}/stream-chat
+     */
+    streamChat(slug: string, threadSlug: string, body?: Record<string, unknown>): Promise<Response>;
+}
+
+/**
+ * V1ApiNamespace - Container for all RealtimeX Developer API (v1) modules.
+ *
+ * Usage:
+ *   const sdk = new RealtimeXSDK({ realtimex: { apiKey: 'sk-...' } });
+ *   await sdk.v1?.workspace.listWorkspaces();
+ *   await sdk.v1?.thread.createThread('workspace-slug');
+ *
+ * Regenerate modules: node scripts/generate-v1-sdk.mjs --force
+ */
+
+declare class V1ApiNamespace {
+    /** @internal Shared HTTP client used by all v1 modules */
+    readonly _client: DeveloperApiClient;
+    workspace: V1WorkspaceModule;
+    thread: V1ThreadModule;
+    constructor(baseUrl: string, apiKey: string, appId?: string);
+}
+
+/**
+ * RealtimeX SDK - Developer API (v1) Error Classes
+ */
+declare class DeveloperApiError extends Error {
+    readonly status: number;
+    readonly code: string;
+    constructor(status: number, code: string, message: string);
+}
+declare class AuthenticationError extends DeveloperApiError {
+    constructor(message?: string);
+}
+declare class NotFoundError extends DeveloperApiError {
+    constructor(message?: string);
+}
+declare class ValidationError extends DeveloperApiError {
+    constructor(message: string);
+}
+declare class ServerError extends DeveloperApiError {
+    constructor(message?: string);
+}
+
+export { AuthenticationError as A, DeveloperApiClient as D, NotFoundError as N, ServerError as S, V1ApiNamespace as V, DeveloperApiError as a, ValidationError as b, V1WorkspaceModule as c, V1ThreadModule as d };