@lovable.dev/sdk 0.1.5 → 0.1.8

package/dist/index.js

@@ -1,13 +1,18 @@
+// src/client.ts
+import createClient from "openapi-fetch";
+
 // src/types.ts
 var ApiError = class extends Error {
   status;
   type;
   detail;
-  constructor(status, message, type, detail) {
+  props;
+  constructor(status, message, type, detail, props) {
     super(message);
     this.status = status;
     this.type = type;
     this.detail = detail;
+    this.props = props;
   }
 };
 
@@ -21,10 +26,29 @@ function normalizeBaseUrl(url) {
   }
   return normalized;
 }
+var errorMiddleware = {
+  async onResponse({ response }) {
+    if (response.ok) return;
+    let errorBody;
+    try {
+      errorBody = await response.clone().json();
+    } catch {
+    }
+    const message = buildErrorMessage(errorBody, response.status, response.statusText);
+    const type = errorBody?.type ?? errorBody?.title;
+    const detail = errorBody?.detail ?? errorBody?.details;
+    throw new ApiError(response.status, message, type, detail, errorBody?.props);
+  }
+};
+function buildErrorMessage(body, status, statusText) {
+  return body?.message || body?.title || (statusText ? `HTTP ${status}: ${statusText}` : `HTTP ${status}`);
+}
 var LovableClient = class {
   authHeaders;
   baseUrl;
   extraHeaders;
+  clientSource;
+  typedClient;
   constructor(options) {
     const hasApiKey = !!options.apiKey;
     const hasBearerToken = !!options.bearerToken;
@@ -37,10 +61,33 @@ var LovableClient = class {
     this.authHeaders = hasApiKey ? { "Lovable-API-Key": options.apiKey } : { Authorization: `Bearer ${options.bearerToken}` };
     this.baseUrl = normalizeBaseUrl(options.baseUrl);
     this.extraHeaders = options.headers ?? {};
+    this.clientSource = options.clientSource ?? "sdk";
+    this.typedClient = createClient({
+      baseUrl: this.baseUrl,
+      headers: {
+        "X-Client-Source": this.clientSource,
+        ...this.authHeaders,
+        ...this.extraHeaders,
+        Accept: "application/json"
+      }
+    });
+    this.typedClient.use(errorMiddleware);
   }
-  async rawRequest(method, path, body) {
+  /**
+   * Type-safe access to any documented API route, driven by the auto-generated
+   * OpenAPI schema. Path / query params and request bodies are checked at compile
+   * time; calling an unknown path is a type error.
+   *
+   * Non-2xx responses throw `ApiError`; on success, `data` is set on the result.
+   */
+  get typed() {
+    return this.typedClient;
+  }
+  async rawRequest(method, path, body, init) {
     const url = `${this.baseUrl}${path}`;
     const headers = {
+      "X-Client-Source": this.clientSource,
+      ...init?.headers,
       ...this.authHeaders,
       ...this.extraHeaders,
       Accept: "application/json"
@@ -51,7 +98,8 @@ var LovableClient = class {
     const response = await fetch(url, {
       method,
       headers,
-      body: body !== void 0 ? JSON.stringify(body) : void 0
+      body: body !== void 0 ? JSON.stringify(body) : void 0,
+      signal: init?.signal
     });
     if (!response.ok) {
       let errorBody;
@@ -59,8 +107,10 @@ var LovableClient = class {
         errorBody = await response.json();
       } catch {
       }
-      const message = errorBody?.message ?? errorBody?.title ?? `HTTP ${response.status}: ${response.statusText}`;
-      throw new ApiError(response.status, message, errorBody?.title, errorBody?.detail);
+      const message = buildErrorMessage(errorBody, response.status, response.statusText);
+      const type = errorBody?.type ?? errorBody?.title;
+      const detail = errorBody?.detail ?? errorBody?.details;
+      throw new ApiError(response.status, message, type, detail, errorBody?.props);
     }
     return response;
   }
@@ -80,7 +130,8 @@ var LovableClient = class {
    * Useful for validating an API key and discovering workspace IDs.
    */
   async me() {
-    return this.request("GET", "/v1/me");
+    const { data } = await this.typed.GET("/v1/me");
+    return { ...data, workspaces: data.workspaces ?? [] };
   }
   /**
    * List all workspaces the authenticated user has access to
@@ -130,9 +181,11 @@ var LovableClient = class {
     }
     const body = {
       description: options.description,
-      visibility: options.visibility ?? "private",
       template_project_id: options.templateProjectId
     };
+    if (options.visibility) {
+      body.visibility = options.visibility;
+    }
     if (options.techStack) {
       body.tech_stack = options.techStack;
     }
@@ -271,19 +324,6 @@ var LovableClient = class {
   async queryDatabase(projectId, sql) {
     return this.request("POST", `/v1/projects/${projectId}/database/query`, { sql });
   }
-  /**
-   * Get database connection info for a project.
-   *
-   * Returns host, port, user, password, database name, and full connection string
-   * that can be used with any PostgreSQL client (psql, pgAdmin, etc.).
-   * The database must be enabled first (see enableDatabase).
-   *
-   * @param projectId - The project ID
-   * @returns Database connection details
-   */
-  async getDatabaseConnectionInfo(projectId) {
-    return this.request("GET", `/v1/projects/${projectId}/database/connection-info`);
-  }
   // ---------------------------------------------------------------------------
   // Messages
   // ---------------------------------------------------------------------------
@@ -294,6 +334,17 @@ var LovableClient = class {
   async getMessage(projectId, messageId) {
     return this.request("GET", `/v1/projects/${projectId}/messages/${messageId}`);
   }
+  /**
+   * List recent messages in a project, newest first. Use `before` (a message ID
+   * from a prior page) to paginate backwards through history.
+   */
+  async listMessages(projectId, params) {
+    const qs = new URLSearchParams();
+    if (params?.limit !== void 0) qs.set("limit", String(params.limit));
+    if (params?.before) qs.set("before", params.before);
+    const suffix = qs.toString() ? `?${qs.toString()}` : "";
+    return this.request("GET", `/v1/projects/${projectId}/messages${suffix}`);
+  }
   /**
    * Poll for message completion. Waits until the AI response reaches a terminal
    * status (completed, stopped) or the timeout expires.
@@ -382,7 +433,10 @@ var LovableClient = class {
   // ---------------------------------------------------------------------------
   /** Get workspace knowledge (custom instructions for the AI agent). */
   async getWorkspaceKnowledge(workspaceId) {
-    return this.request("GET", `/v1/workspaces/${workspaceId}/knowledge`);
+    const { data } = await this.typed.GET("/v1/workspaces/{workspace_id}/knowledge", {
+      params: { path: { workspace_id: workspaceId } }
+    });
+    return data;
   }
   /** Set workspace knowledge. Max 10,000 characters. */
   async setWorkspaceKnowledge(workspaceId, content) {
@@ -390,7 +444,10 @@ var LovableClient = class {
   }
   /** Get project knowledge (custom instructions for the AI agent). */
   async getProjectKnowledge(projectId) {
-    return this.request("GET", `/v1/projects/${projectId}/knowledge`);
+    const { data } = await this.typed.GET("/v1/projects/{project_id}/knowledge", {
+      params: { path: { project_id: projectId } }
+    });
+    return data;
   }
   /** Set project knowledge. Max 10,000 characters. */
   async setProjectKnowledge(projectId, content) {
@@ -470,23 +527,26 @@ var LovableClient = class {
     );
   }
   // ---------------------------------------------------------------------------
-  // MCP servers
+  // Connectors (MCP servers)
   // ---------------------------------------------------------------------------
-  /** List all MCP servers connected to a workspace. */
-  async listMCPServers(workspaceId) {
-    return this.request("GET", `/v1/workspaces/${workspaceId}/mcp-servers`);
+  /** List all connectors in a workspace. */
+  async listConnectors(workspaceId) {
+    return this.request("GET", `/v1/workspaces/${workspaceId}/connectors`);
   }
-  /** Add an MCP server to a workspace. The server URL is tested before saving. */
-  async addMCPServer(workspaceId, body) {
-    return this.request("POST", `/v1/workspaces/${workspaceId}/mcp-servers`, body);
+  /** Add a connector to a workspace. The server URL is tested before saving. */
+  async addConnector(workspaceId, body) {
+    return this.request("POST", `/v1/workspaces/${workspaceId}/connectors`, body);
   }
-  /** Remove an MCP server from a workspace. */
-  async removeMCPServer(workspaceId, serverId) {
-    return this.request("DELETE", `/v1/workspaces/${workspaceId}/mcp-servers/${serverId}`);
+  /** Remove a connector from a workspace. */
+  async removeConnector(workspaceId, connectorId) {
+    return this.request("DELETE", `/v1/workspaces/${workspaceId}/connectors/${connectorId}`);
   }
-  /** Browse available MCP server templates (catalog). */
-  async listMCPCatalog(workspaceId) {
-    return this.request("GET", `/v1/workspaces/${workspaceId}/mcp-catalog`);
+  /** Browse available connector templates. */
+  async listAvailableConnectors(workspaceId) {
+    return this.request(
+      "GET",
+      `/v1/workspaces/${workspaceId}/available-connectors`
+    );
   }
   // ---------------------------------------------------------------------------
   // Connectors
@@ -574,8 +634,7 @@ var LovableClient = class {
       include_custom_knowledge: options.includeCustomKnowledge,
       project_name: options.projectName,
       skip_initial_remix_message: options.skipInitialRemixMessage,
-      skip_integrations: options.skipIntegrations,
-      include_agent_state: options.includeAgentState
+      skip_integrations: options.skipIntegrations
     };
     if (options.messageId) {
       body.message_id = options.messageId;
@@ -589,7 +648,7 @@ var LovableClient = class {
         headless: true
       };
     }
-    const response = await this.request("POST", `/projects/${sourceProjectId}/remix/init`, body);
+    const response = await this.request("POST", `/v1/projects/${sourceProjectId}/remix/init`, body);
     return response.job_id;
   }
   /**
@@ -612,7 +671,7 @@ var LovableClient = class {
     while (true) {
       const progress = await this.request(
         "GET",
-        `/projects/${sourceProjectId}/remix/progress?job_id=${encodeURIComponent(jobId)}`
+        `/v1/projects/${sourceProjectId}/remix/progress?job_id=${encodeURIComponent(jobId)}`
       );
       options?.onProgress?.(progress.status, progress.step);
       if (progress.status === "completed" && progress.result) {