@lovable.dev/sdk 0.1.7 → 0.1.9

package/dist/index.js

@@ -1,3 +1,6 @@
+// src/client.ts
+import createClient from "openapi-fetch";
+
 // src/types.ts
 var ApiError = class extends Error {
   status;
@@ -23,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;
@@ -39,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"
@@ -53,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;
@@ -61,7 +107,7 @@ var LovableClient = class {
         errorBody = await response.json();
       } catch {
       }
-      const message = errorBody?.message ?? errorBody?.title ?? `HTTP ${response.status}: ${response.statusText}`;
+      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);
@@ -84,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
@@ -134,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;
     }
@@ -275,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
   // ---------------------------------------------------------------------------
@@ -298,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.
@@ -386,15 +433,76 @@ 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) {
     return this.request("PUT", `/v1/workspaces/${workspaceId}/knowledge`, { content });
   }
+  // ---------------------------------------------------------------------------
+  // Workspace skills
+  // ---------------------------------------------------------------------------
+  /** List workspace skills. */
+  async listWorkspaceSkills(workspaceId, options) {
+    const qs = new URLSearchParams();
+    if (options?.includeMarkdown) qs.set("include_markdown", "true");
+    const suffix = qs.toString() ? `?${qs.toString()}` : "";
+    return this.request("GET", `/v1/workspaces/${workspaceId}/skills${suffix}`);
+  }
+  /** Get a single workspace skill, including SKILL.md contents. */
+  async getWorkspaceSkill(workspaceId, skillName) {
+    return this.request(
+      "GET",
+      `/v1/workspaces/${workspaceId}/skills/${encodeURIComponent(skillName)}`
+    );
+  }
+  /** Create a workspace skill from full SKILL.md markdown. */
+  async createWorkspaceSkill(workspaceId, skillName, markdown) {
+    return this.request(
+      "POST",
+      `/v1/workspaces/${workspaceId}/skills/${encodeURIComponent(skillName)}`,
+      { markdown }
+    );
+  }
+  /** Update a workspace skill by replacing its SKILL.md markdown. */
+  async updateWorkspaceSkill(workspaceId, skillName, markdown) {
+    return this.request(
+      "PUT",
+      `/v1/workspaces/${workspaceId}/skills/${encodeURIComponent(skillName)}`,
+      { markdown }
+    );
+  }
+  /** Delete a workspace skill. */
+  async deleteWorkspaceSkill(workspaceId, skillName) {
+    return this.request(
+      "DELETE",
+      `/v1/workspaces/${workspaceId}/skills/${encodeURIComponent(skillName)}`
+    );
+  }
+  // ---------------------------------------------------------------------------
+  // Project skills
+  // ---------------------------------------------------------------------------
+  /** List project skills, including whether each skill is enabled. */
+  async listProjectSkills(projectId) {
+    return this.request("GET", `/v1/projects/${projectId}/skills`);
+  }
+  /** Enable or disable a project skill without removing it from the project repo. */
+  async setProjectSkillEnabled(projectId, skillName, enabled) {
+    return this.request(
+      "PUT",
+      `/v1/projects/${projectId}/skills/${encodeURIComponent(skillName)}/enabled`,
+      { enabled }
+    );
+  }
   /** 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) {