@lovable.dev/sdk 0.0.1

package/README.md

@@ -0,0 +1,166 @@
+# @lovable/sdk
+
+TypeScript SDK for the Lovable API.
+
+Currently in preview.
+
+## Installation
+
+```bash
+npm install @lovable/sdk
+```
+
+## Usage
+
+```typescript
+import { LovableClient } from "@lovable/sdk";
+
+const client = new LovableClient({
+  apiKey: "lov_your-api-key",
+});
+
+// List workspaces
+const workspaces = await client.listWorkspaces();
+console.log(workspaces);
+
+// Create a project
+const project = await client.createProject(workspaces[0].id, {
+  description: "A todo app with authentication",
+  visibility: "private",
+  initialMessage: "Create a simple todo app with user authentication",
+});
+console.log("Created project:", project.id);
+
+// Wait for project to be ready (status = "completed")
+const readyProject = await client.waitForProjectReady(project.id, {
+  onProgress: (p) => console.log(`Status: ${p.status}`),
+});
+
+// Send a chat message to an existing project
+await client.chat(readyProject.id, {
+  message: "Add a dark mode toggle to the app",
+});
+
+// Wait for project to be published/deployed
+const published = await client.waitForProjectPublished(project.id);
+console.log("Live at:", published.url);
+
+// Invite a collaborator to a workspace
+await client.inviteCollaborator(workspaces[0].id, {
+  email: "collaborator@example.com",
+  role: "member",
+});
+```
+
+## API Reference
+
+### `LovableClient`
+
+#### Constructor
+
+```typescript
+new LovableClient(options: LovableClientOptions)
+```
+
+- `apiKey` (required): Your Lovable API key
+- `baseUrl` (optional): Override the default API base URL
+
+#### Methods
+
+##### `listWorkspaces(): Promise<WorkspaceWithMembership[]>`
+
+List all workspaces the authenticated user has access to.
+
+##### `getWorkspace(workspaceId: string): Promise<WorkspaceWithMembership>`
+
+Get a specific workspace by ID.
+
+##### `listProjects(workspaceId: string, options?): Promise<ProjectResponse[]>`
+
+List projects in a workspace.
+
+Options:
+
+- `limit` (optional): Maximum number of projects to return
+- `visibility` (optional): Filter by visibility (`"all"` | `"personal"` | `"public"` | `"workspace"`)
+
+##### `createProject(workspaceId: string, options): Promise<ProjectResponse>`
+
+Create a new project in a workspace.
+
+Options:
+
+- `description` (required): Project description
+- `techStack` (optional): Technology stack (e.g., `"react"`)
+- `visibility` (optional): Project visibility (`"draft"` | `"private"` | `"public"`)
+- `templateProjectId` (optional): ID of a template project to clone
+- `initialMessage` (optional): Initial chat message to send to the AI agent
+
+##### `chat(projectId: string, options): Promise<void>`
+
+Send a chat message to a project's AI agent.
+
+Options:
+
+- `message` (required): The message to send
+- `chatOnly` (optional): If true, only chat without making code changes
+
+Note: This is an asynchronous operation. The API accepts the message and processes it in the background.
+
+##### `inviteCollaborator(workspaceId: string, options): Promise<WorkspaceMembershipResponse>`
+
+Invite a user to a workspace.
+
+Options:
+
+- `email` (required): Email address of the user to invite
+- `role` (optional): Role to assign (`"admin"` | `"collaborator"` | `"member"` | `"viewer"`)
+
+##### `listWorkspaceMembers(workspaceId: string): Promise<WorkspaceMembershipResponse[]>`
+
+List all members of a workspace.
+
+##### `removeWorkspaceMember(workspaceId: string, userId: string): Promise<void>`
+
+Remove a member from a workspace.
+
+##### `getProject(projectId: string): Promise<ProjectResponse>`
+
+Get project details by ID.
+
+##### `waitForProjectReady(projectId: string, options?): Promise<ProjectResponse>`
+
+Wait for a project to reach "completed" status. Projects start in "in_progress" status while being created/built.
+
+Options:
+
+- `pollInterval` (optional): Time between polls in ms (default: 2000)
+- `timeout` (optional): Maximum time to wait in ms (default: 300000 = 5 minutes)
+- `onProgress` (optional): Callback for status updates
+
+Throws an error if the project fails or timeout is reached.
+
+##### `waitForProjectPublished(projectId: string, options?): Promise<ProjectResponse>`
+
+Wait for a project to be published (deployed) and have a live URL.
+
+Options:
+
+- `pollInterval` (optional): Time between polls in ms (default: 3000)
+- `timeout` (optional): Maximum time to wait in ms (default: 600000 = 10 minutes)
+- `onProgress` (optional): Callback for status updates
+
+Throws an error if timeout is reached.
+
+## Types
+
+The SDK exports TypeScript types for all API responses. See `src/types.ts` for the full list.
+
+```typescript
+import type {
+  WorkspaceWithMembership,
+  ProjectResponse,
+  CreateProjectOptions,
+  // ... etc
+} from "@lovable/sdk";
+```

package/dist/index.d.ts

@@ -0,0 +1,295 @@
+type ProjectVisibility = "draft" | "private" | "public";
+type MemberRole = "admin" | "collaborator" | "invited" | "member" | "none" | "owner" | "viewer";
+type ProjectStatus = "completed" | "in_progress" | "failed";
+interface WorkspaceMembership {
+    email: string;
+    invited_at?: string;
+    joined_at?: string;
+    monthly_credit_limit: number | null;
+    project_access?: Record<string, {
+        access_level?: string;
+    }>;
+    role: MemberRole;
+    user_id: string;
+    workspace_id: string;
+}
+interface WorkspaceWithMembership {
+    id: string;
+    name: string;
+    description?: string;
+    image_url?: string;
+    owner_id?: string;
+    is_personal?: boolean;
+    plan?: string;
+    plan_type?: string;
+    num_projects: number;
+    num_seats?: number;
+    membership: WorkspaceMembership;
+    created_at: string;
+    updated_at: string;
+    deleted_at?: string;
+    credits_granted: number;
+    credits_used: number;
+    daily_credits_limit: number;
+    daily_credits_used: number;
+    billing_period_credits_limit: number;
+    billing_period_credits_used: number;
+    billing_period_start_date?: string;
+    billing_period_end_date?: string;
+    rollover_credits_limit: number;
+    rollover_credits_used: number;
+    topup_credits_limit: number;
+    topup_credits_used: number;
+    total_credits_used: number;
+    subscription_status?: "active" | "canceled" | "incomplete_expired" | "incomplete" | "past_due" | "paused" | "trialing" | "unpaid";
+    referral_code?: string;
+    short_referral_code?: string;
+    referral_count: number;
+    followers_count: number;
+    default_project_visibility?: ProjectVisibility;
+    default_project_publish_visibility?: "private" | "public";
+    mcp_enabled?: boolean;
+}
+interface WorkspaceMembershipResponse {
+    user_id: string;
+    username: string;
+    display_name?: string;
+    email?: string;
+    role: MemberRole;
+    invited_at?: string;
+    joined_at?: string;
+    monthly_credit_limit?: number;
+    total_credits_used?: number;
+    total_credits_used_in_billing_period?: number;
+    project_access?: Record<string, {
+        access_level?: string;
+    }>;
+}
+interface ProjectResponse {
+    id: string;
+    name?: string;
+    display_name?: string;
+    description: string;
+    tech_stack: string;
+    status: string;
+    visibility?: ProjectVisibility;
+    publish_visibility?: "private" | "public";
+    is_published: boolean;
+    is_starred?: boolean;
+    is_template?: boolean;
+    is_github?: boolean;
+    is_supabase_enabled?: boolean;
+    url?: string;
+    og_image_url?: string;
+    latest_screenshot_url?: string;
+    user_id: string;
+    user_display_name?: string;
+    user_photo_url?: string;
+    created_at: string;
+    created_by?: string;
+    updated_at: string;
+    deleted_at?: string;
+    last_edited_at?: string;
+    last_viewed_at?: string;
+    published_at?: string;
+    workspace_id?: string;
+    folder_id?: string;
+    category?: string;
+    edit_count?: number;
+    gen_count?: number;
+    user_message_count?: number;
+    remix_count: number;
+    remixed_from_project_id?: string;
+    template_project_id?: string;
+    credit_total?: number;
+    custom_instructions?: string;
+    main_branch?: string;
+    latest_commit_sha?: string;
+    github_repo_name?: string;
+    github_repo_id?: number;
+    deployment_target?: string;
+    active_deployment_job_id?: string;
+    environments_enabled?: boolean;
+    hide_badge: boolean | null;
+    featured?: boolean;
+    featured_at?: string;
+    feature_rank?: number;
+    feature_source?: string;
+}
+interface ChatRequest {
+    id: string;
+    message: string;
+    chat_only: boolean;
+    headless: boolean;
+    ai_message_id?: string;
+    intent?: string;
+    model?: string;
+    temperature?: number;
+    current_page?: string;
+    view?: string;
+    view_description?: string;
+    prev_session_id?: string;
+    is_creation?: boolean;
+}
+interface CreateProjectBody {
+    description: string;
+    tech_stack: string;
+    visibility?: ProjectVisibility;
+    template_project_id?: string;
+    initial_message?: ChatRequest;
+    category?: string;
+    project_type?: string;
+    prompt_name?: string;
+    selected_theme?: string;
+    env_vars?: Record<string, string>;
+    metadata?: Record<string, unknown>;
+}
+interface AddUserToWorkspaceInputBody {
+    email: string;
+    role?: MemberRole;
+}
+interface CreateProjectOptions {
+    description: string;
+    techStack?: string;
+    visibility?: ProjectVisibility;
+    templateProjectId?: string;
+    initialMessage?: string;
+}
+interface InviteCollaboratorOptions {
+    email: string;
+    role?: MemberRole;
+}
+interface ChatMessageOptions {
+    message: string;
+    chatOnly?: boolean;
+}
+interface LovableClientOptions {
+    apiKey: string;
+    baseUrl?: string;
+}
+interface LovableError extends Error {
+    status: number;
+    type?: string;
+    detail?: string;
+}
+interface WaitOptions {
+    pollInterval?: number;
+    timeout?: number;
+    onProgress?: (project: ProjectResponse) => void;
+}
+interface DeploymentResponse {
+    status: string;
+    deployment_id?: string;
+    url?: string;
+}
+
+declare class LovableClient {
+    private readonly apiKey;
+    private readonly baseUrl;
+    constructor(options: LovableClientOptions);
+    private request;
+    /**
+     * List all workspaces the authenticated user has access to
+     */
+    listWorkspaces(): Promise<WorkspaceWithMembership[]>;
+    /**
+     * Get a specific workspace by ID
+     */
+    getWorkspace(workspaceId: string): Promise<WorkspaceWithMembership>;
+    /**
+     * List projects in a workspace
+     */
+    listProjects(workspaceId: string, options?: {
+        limit?: number;
+        visibility?: "all" | "personal" | "public" | "workspace";
+    }): Promise<ProjectResponse[]>;
+    /**
+     * Create a new project in a workspace
+     */
+    createProject(workspaceId: string, options: CreateProjectOptions): Promise<ProjectResponse>;
+    /**
+     * Send a chat message to a project
+     *
+     * Note: This sends a message to the project's AI agent. The response is
+     * asynchronous - the API accepts the message and processes it in the background.
+     */
+    chat(projectId: string, options: ChatMessageOptions): Promise<void>;
+    /**
+     * Invite a user to a workspace as a collaborator
+     */
+    inviteCollaborator(workspaceId: string, options: InviteCollaboratorOptions): Promise<WorkspaceMembershipResponse>;
+    /**
+     * List members of a workspace
+     */
+    listWorkspaceMembers(workspaceId: string): Promise<WorkspaceMembershipResponse[]>;
+    /**
+     * Remove a member from a workspace
+     */
+    removeWorkspaceMember(workspaceId: string, userId: string): Promise<void>;
+    /**
+     * Get project details by ID
+     */
+    getProject(projectId: string): Promise<ProjectResponse>;
+    /**
+     * Get the preview URL for a project.
+     *
+     * The preview URL is available once the project reaches "completed" status.
+     * This URL allows viewing the project in development mode.
+     *
+     * @param projectId - The project ID
+     * @returns The preview URL
+     */
+    getPreviewUrl(projectId: string): string;
+    /**
+     * Get the published URL for a project (if published).
+     *
+     * Returns the public URL if the project has been published, or null if not.
+     *
+     * @param projectId - The project ID
+     * @returns The published URL or null if not published
+     */
+    getPublishedUrl(projectId: string): Promise<string | null>;
+    /**
+     * Publish a project.
+     *
+     * This triggers a deployment which makes the project publicly accessible.
+     * The deployment runs asynchronously - use waitForProjectPublished() to wait for completion.
+     *
+     * @param projectId - The project ID to publish
+     * @param options.name - Optional custom slug for the published URL
+     * @returns Deployment info including deployment ID
+     */
+    publish(projectId: string, options?: {
+        name?: string;
+    }): Promise<DeploymentResponse>;
+    /**
+     * Wait for a project to reach "completed" status.
+     *
+     * Projects start in "in_progress" status while being created/built.
+     * This method polls until the status becomes "completed" or "failed".
+     * A successful completion means the project's preview is ready to view.
+     *
+     * @param projectId - The project ID to wait for
+     * @param options.pollInterval - Time between polls in ms (default: 2000)
+     * @param options.timeout - Maximum time to wait in ms (default: 300000 = 5 minutes)
+     * @param options.onProgress - Optional callback for status updates
+     * @returns The completed project
+     * @throws Error if project fails or timeout is reached
+     */
+    waitForProjectReady(projectId: string, options?: WaitOptions): Promise<ProjectResponse>;
+    /**
+     * Wait for a project to be published (deployed).
+     *
+     * This method polls until the project has `is_published: true` and a `url`.
+     *
+     * @param projectId - The project ID to wait for
+     * @param options.pollInterval - Time between polls in ms (default: 3000)
+     * @param options.timeout - Maximum time to wait in ms (default: 600000 = 10 minutes)
+     * @param options.onProgress - Optional callback for status updates
+     * @returns The published project with URL
+     * @throws Error if timeout is reached
+     */
+    waitForProjectPublished(projectId: string, options?: WaitOptions): Promise<ProjectResponse>;
+}
+
+export { type AddUserToWorkspaceInputBody, type ChatMessageOptions, type ChatRequest, type CreateProjectBody, type CreateProjectOptions, type DeploymentResponse, type InviteCollaboratorOptions, LovableClient, type LovableClientOptions, type LovableError, type MemberRole, type ProjectResponse, type ProjectStatus, type ProjectVisibility, type WaitOptions, type WorkspaceMembership, type WorkspaceMembershipResponse, type WorkspaceWithMembership };

package/dist/index.js

@@ -0,0 +1,246 @@
+// src/client.ts
+var DEFAULT_BASE_URL = "https://api.lovable.dev";
+function normalizeBaseUrl(url) {
+  if (!url) return DEFAULT_BASE_URL;
+  let normalized = url.replace(/\/$/, "");
+  if (!normalized.startsWith("http://") && !normalized.startsWith("https://")) {
+    const isLocalhost = normalized.startsWith("localhost") || normalized.startsWith("127.0.0.1");
+    normalized = isLocalhost ? `http://${normalized}` : `https://${normalized}`;
+  }
+  return normalized;
+}
+var LovableClient = class {
+  apiKey;
+  baseUrl;
+  constructor(options) {
+    if (!options.apiKey) {
+      throw new Error("API key is required");
+    }
+    this.apiKey = options.apiKey;
+    this.baseUrl = normalizeBaseUrl(options.baseUrl);
+  }
+  async request(method, path, body) {
+    const url = `${this.baseUrl}${path}`;
+    const headers = {
+      "Lovable-API-Key": this.apiKey,
+      "Content-Type": "application/json"
+    };
+    const response = await fetch(url, {
+      method,
+      headers,
+      body: body ? JSON.stringify(body) : void 0
+    });
+    if (!response.ok) {
+      let errorBody;
+      try {
+        errorBody = await response.json();
+      } catch {
+      }
+      const error = new Error(errorBody?.title ?? `HTTP ${response.status}: ${response.statusText}`);
+      error.status = response.status;
+      error.type = errorBody?.title;
+      error.detail = errorBody?.detail;
+      throw error;
+    }
+    if (response.status === 204) {
+      return void 0;
+    }
+    return response.json();
+  }
+  /**
+   * List all workspaces the authenticated user has access to
+   */
+  async listWorkspaces() {
+    const response = await this.request("GET", "/user/workspaces");
+    return response.workspaces ?? [];
+  }
+  /**
+   * Get a specific workspace by ID
+   */
+  async getWorkspace(workspaceId) {
+    return this.request("GET", `/user/workspaces/${workspaceId}`);
+  }
+  /**
+   * List projects in a workspace
+   */
+  async listProjects(workspaceId, options) {
+    const params = new URLSearchParams();
+    if (options?.limit) params.set("limit", options.limit.toString());
+    if (options?.visibility) params.set("visibility", options.visibility);
+    const query = params.toString();
+    const path = `/workspaces/${workspaceId}/projects${query ? `?${query}` : ""}`;
+    const response = await this.request("GET", path);
+    return response.projects ?? [];
+  }
+  /**
+   * Create a new project in a workspace
+   */
+  async createProject(workspaceId, options) {
+    const body = {
+      description: options.description,
+      tech_stack: options.techStack ?? "",
+      visibility: options.visibility ?? "private",
+      template_project_id: options.templateProjectId
+    };
+    if (options.initialMessage) {
+      body.initial_message = {
+        id: crypto.randomUUID(),
+        message: options.initialMessage,
+        chat_only: false,
+        headless: true
+      };
+    }
+    return this.request("POST", `/workspaces/${workspaceId}/projects`, body);
+  }
+  /**
+   * Send a chat message to a project
+   *
+   * Note: This sends a message to the project's AI agent. The response is
+   * asynchronous - the API accepts the message and processes it in the background.
+   */
+  async chat(projectId, options) {
+    const body = {
+      id: crypto.randomUUID(),
+      message: options.message,
+      chat_only: options.chatOnly ?? false,
+      headless: true
+    };
+    await this.request("POST", `/projects/${projectId}/chat`, body);
+  }
+  /**
+   * Invite a user to a workspace as a collaborator
+   */
+  async inviteCollaborator(workspaceId, options) {
+    const body = {
+      email: options.email,
+      role: options.role ?? "member"
+    };
+    return this.request("POST", `/workspaces/${workspaceId}/memberships`, body);
+  }
+  /**
+   * List members of a workspace
+   */
+  async listWorkspaceMembers(workspaceId) {
+    const response = await this.request("GET", `/workspaces/${workspaceId}/memberships`);
+    return response.memberships ?? [];
+  }
+  /**
+   * Remove a member from a workspace
+   */
+  async removeWorkspaceMember(workspaceId, userId) {
+    await this.request("DELETE", `/workspaces/${workspaceId}/memberships/${userId}`);
+  }
+  /**
+   * Get project details by ID
+   */
+  async getProject(projectId) {
+    return this.request("GET", `/projects/${projectId}/details`);
+  }
+  /**
+   * Get the preview URL for a project.
+   *
+   * The preview URL is available once the project reaches "completed" status.
+   * This URL allows viewing the project in development mode.
+   *
+   * @param projectId - The project ID
+   * @returns The preview URL
+   */
+  getPreviewUrl(projectId) {
+    return `https://id-preview--${projectId}.lovable.app`;
+  }
+  /**
+   * Get the published URL for a project (if published).
+   *
+   * Returns the public URL if the project has been published, or null if not.
+   *
+   * @param projectId - The project ID
+   * @returns The published URL or null if not published
+   */
+  async getPublishedUrl(projectId) {
+    const project = await this.getProject(projectId);
+    return project.is_published && project.url ? project.url : null;
+  }
+  /**
+   * Publish a project.
+   *
+   * This triggers a deployment which makes the project publicly accessible.
+   * The deployment runs asynchronously - use waitForProjectPublished() to wait for completion.
+   *
+   * @param projectId - The project ID to publish
+   * @param options.name - Optional custom slug for the published URL
+   * @returns Deployment info including deployment ID
+   */
+  async publish(projectId, options) {
+    return this.request("POST", `/projects/${projectId}/deployments`, {
+      name: options?.name
+    });
+  }
+  /**
+   * Wait for a project to reach "completed" status.
+   *
+   * Projects start in "in_progress" status while being created/built.
+   * This method polls until the status becomes "completed" or "failed".
+   * A successful completion means the project's preview is ready to view.
+   *
+   * @param projectId - The project ID to wait for
+   * @param options.pollInterval - Time between polls in ms (default: 2000)
+   * @param options.timeout - Maximum time to wait in ms (default: 300000 = 5 minutes)
+   * @param options.onProgress - Optional callback for status updates
+   * @returns The completed project
+   * @throws Error if project fails or timeout is reached
+   */
+  async waitForProjectReady(projectId, options) {
+    const pollInterval = options?.pollInterval ?? 2e3;
+    const timeout = options?.timeout ?? 3e5;
+    const startTime = Date.now();
+    while (true) {
+      const project = await this.getProject(projectId);
+      options?.onProgress?.(project);
+      if (project.status === "completed") {
+        return project;
+      }
+      if (project.status === "failed") {
+        throw new Error(`Project ${projectId} failed to build`);
+      }
+      if (Date.now() - startTime > timeout) {
+        throw new Error(`Timeout waiting for project ${projectId} to be ready`);
+      }
+      await sleep(pollInterval);
+    }
+  }
+  /**
+   * Wait for a project to be published (deployed).
+   *
+   * This method polls until the project has `is_published: true` and a `url`.
+   *
+   * @param projectId - The project ID to wait for
+   * @param options.pollInterval - Time between polls in ms (default: 3000)
+   * @param options.timeout - Maximum time to wait in ms (default: 600000 = 10 minutes)
+   * @param options.onProgress - Optional callback for status updates
+   * @returns The published project with URL
+   * @throws Error if timeout is reached
+   */
+  async waitForProjectPublished(projectId, options) {
+    const pollInterval = options?.pollInterval ?? 3e3;
+    const timeout = options?.timeout ?? 6e5;
+    const startTime = Date.now();
+    while (true) {
+      const project = await this.getProject(projectId);
+      options?.onProgress?.(project);
+      if (project.is_published && project.url) {
+        return project;
+      }
+      if (Date.now() - startTime > timeout) {
+        throw new Error(`Timeout waiting for project ${projectId} to be published`);
+      }
+      await sleep(pollInterval);
+    }
+  }
+};
+function sleep(ms) {
+  return new Promise((resolve) => setTimeout(resolve, ms));
+}
+export {
+  LovableClient
+};
+//# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../src/client.ts"],"sourcesContent":["import type {\n  LovableClientOptions,\n  LovableError,\n  CreateProjectOptions,\n  InviteCollaboratorOptions,\n  ChatMessageOptions,\n  WaitOptions,\n  WorkspaceWithMembership,\n  ProjectResponse,\n  WorkspaceMembershipResponse,\n  CreateProjectBody,\n  ChatRequest,\n  AddUserToWorkspaceInputBody,\n  GetWorkspacesResponse,\n  GetWorkspaceProjectsResponse,\n  DeploymentResponse,\n} from \"./types.js\";\n\nconst DEFAULT_BASE_URL = \"https://api.lovable.dev\";\n\nfunction normalizeBaseUrl(url: string | undefined): string {\n  if (!url) return DEFAULT_BASE_URL;\n\n  let normalized = url.replace(/\\/$/, \"\");\n\n  // Add http:// for localhost URLs without protocol\n  if (!normalized.startsWith(\"http://\") && !normalized.startsWith(\"https://\")) {\n    const isLocalhost = normalized.startsWith(\"localhost\") || normalized.startsWith(\"127.0.0.1\");\n    normalized = isLocalhost ? `http://${normalized}` : `https://${normalized}`;\n  }\n\n  return normalized;\n}\n\nexport class LovableClient {\n  private readonly apiKey: string;\n  private readonly baseUrl: string;\n\n  constructor(options: LovableClientOptions) {\n    if (!options.apiKey) {\n      throw new Error(\"API key is required\");\n    }\n    this.apiKey = options.apiKey;\n    this.baseUrl = normalizeBaseUrl(options.baseUrl);\n  }\n\n  private async request<T>(method: string, path: string, body?: unknown): Promise<T> {\n    const url = `${this.baseUrl}${path}`;\n\n    const headers: Record<string, string> = {\n      \"Lovable-API-Key\": this.apiKey,\n      \"Content-Type\": \"application/json\",\n    };\n\n    const response = await fetch(url, {\n      method,\n      headers,\n      body: body ? JSON.stringify(body) : undefined,\n    });\n\n    if (!response.ok) {\n      let errorBody: { title?: string; detail?: string } | undefined;\n      try {\n        errorBody = (await response.json()) as { title?: string; detail?: string };\n      } catch {\n        // Ignore JSON parse errors\n      }\n\n      const error = new Error(errorBody?.title ?? `HTTP ${response.status}: ${response.statusText}`) as LovableError;\n      error.status = response.status;\n      error.type = errorBody?.title;\n      error.detail = errorBody?.detail;\n      throw error;\n    }\n\n    if (response.status === 204) {\n      return undefined as T;\n    }\n\n    return response.json() as Promise<T>;\n  }\n\n  /**\n   * List all workspaces the authenticated user has access to\n   */\n  async listWorkspaces(): Promise<WorkspaceWithMembership[]> {\n    const response = await this.request<GetWorkspacesResponse>(\"GET\", \"/user/workspaces\");\n    return response.workspaces ?? [];\n  }\n\n  /**\n   * Get a specific workspace by ID\n   */\n  async getWorkspace(workspaceId: string): Promise<WorkspaceWithMembership> {\n    return this.request<WorkspaceWithMembership>(\"GET\", `/user/workspaces/${workspaceId}`);\n  }\n\n  /**\n   * List projects in a workspace\n   */\n  async listProjects(\n    workspaceId: string,\n    options?: { limit?: number; visibility?: \"all\" | \"personal\" | \"public\" | \"workspace\" },\n  ): Promise<ProjectResponse[]> {\n    const params = new URLSearchParams();\n    if (options?.limit) params.set(\"limit\", options.limit.toString());\n    if (options?.visibility) params.set(\"visibility\", options.visibility);\n\n    const query = params.toString();\n    const path = `/workspaces/${workspaceId}/projects${query ? `?${query}` : \"\"}`;\n\n    const response = await this.request<GetWorkspaceProjectsResponse>(\"GET\", path);\n    return response.projects ?? [];\n  }\n\n  /**\n   * Create a new project in a workspace\n   */\n  async createProject(workspaceId: string, options: CreateProjectOptions): Promise<ProjectResponse> {\n    const body: CreateProjectBody = {\n      description: options.description,\n      tech_stack: options.techStack ?? \"\",\n      visibility: options.visibility ?? \"private\",\n      template_project_id: options.templateProjectId,\n    };\n\n    if (options.initialMessage) {\n      body.initial_message = {\n        id: crypto.randomUUID(),\n        message: options.initialMessage,\n        chat_only: false,\n        headless: true,\n      };\n    }\n\n    return this.request<ProjectResponse>(\"POST\", `/workspaces/${workspaceId}/projects`, body);\n  }\n\n  /**\n   * Send a chat message to a project\n   *\n   * Note: This sends a message to the project's AI agent. The response is\n   * asynchronous - the API accepts the message and processes it in the background.\n   */\n  async chat(projectId: string, options: ChatMessageOptions): Promise<void> {\n    const body: ChatRequest = {\n      id: crypto.randomUUID(),\n      message: options.message,\n      chat_only: options.chatOnly ?? false,\n      headless: true,\n    };\n\n    await this.request<void>(\"POST\", `/projects/${projectId}/chat`, body);\n  }\n\n  /**\n   * Invite a user to a workspace as a collaborator\n   */\n  async inviteCollaborator(\n    workspaceId: string,\n    options: InviteCollaboratorOptions,\n  ): Promise<WorkspaceMembershipResponse> {\n    const body: AddUserToWorkspaceInputBody = {\n      email: options.email,\n      role: options.role ?? \"member\",\n    };\n\n    return this.request<WorkspaceMembershipResponse>(\"POST\", `/workspaces/${workspaceId}/memberships`, body);\n  }\n\n  /**\n   * List members of a workspace\n   */\n  async listWorkspaceMembers(workspaceId: string): Promise<WorkspaceMembershipResponse[]> {\n    const response = await this.request<{\n      memberships: WorkspaceMembershipResponse[] | null;\n    }>(\"GET\", `/workspaces/${workspaceId}/memberships`);\n    return response.memberships ?? [];\n  }\n\n  /**\n   * Remove a member from a workspace\n   */\n  async removeWorkspaceMember(workspaceId: string, userId: string): Promise<void> {\n    await this.request<void>(\"DELETE\", `/workspaces/${workspaceId}/memberships/${userId}`);\n  }\n\n  /**\n   * Get project details by ID\n   */\n  async getProject(projectId: string): Promise<ProjectResponse> {\n    return this.request<ProjectResponse>(\"GET\", `/projects/${projectId}/details`);\n  }\n\n  /**\n   * Get the preview URL for a project.\n   *\n   * The preview URL is available once the project reaches \"completed\" status.\n   * This URL allows viewing the project in development mode.\n   *\n   * @param projectId - The project ID\n   * @returns The preview URL\n   */\n  getPreviewUrl(projectId: string): string {\n    return `https://id-preview--${projectId}.lovable.app`;\n  }\n\n  /**\n   * Get the published URL for a project (if published).\n   *\n   * Returns the public URL if the project has been published, or null if not.\n   *\n   * @param projectId - The project ID\n   * @returns The published URL or null if not published\n   */\n  async getPublishedUrl(projectId: string): Promise<string | null> {\n    const project = await this.getProject(projectId);\n    return project.is_published && project.url ? project.url : null;\n  }\n\n  /**\n   * Publish a project.\n   *\n   * This triggers a deployment which makes the project publicly accessible.\n   * The deployment runs asynchronously - use waitForProjectPublished() to wait for completion.\n   *\n   * @param projectId - The project ID to publish\n   * @param options.name - Optional custom slug for the published URL\n   * @returns Deployment info including deployment ID\n   */\n  async publish(projectId: string, options?: { name?: string }): Promise<DeploymentResponse> {\n    return this.request<DeploymentResponse>(\"POST\", `/projects/${projectId}/deployments`, {\n      name: options?.name,\n    });\n  }\n\n  /**\n   * Wait for a project to reach \"completed\" status.\n   *\n   * Projects start in \"in_progress\" status while being created/built.\n   * This method polls until the status becomes \"completed\" or \"failed\".\n   * A successful completion means the project's preview is ready to view.\n   *\n   * @param projectId - The project ID to wait for\n   * @param options.pollInterval - Time between polls in ms (default: 2000)\n   * @param options.timeout - Maximum time to wait in ms (default: 300000 = 5 minutes)\n   * @param options.onProgress - Optional callback for status updates\n   * @returns The completed project\n   * @throws Error if project fails or timeout is reached\n   */\n  async waitForProjectReady(projectId: string, options?: WaitOptions): Promise<ProjectResponse> {\n    const pollInterval = options?.pollInterval ?? 2000;\n    const timeout = options?.timeout ?? 300000;\n    const startTime = Date.now();\n\n    while (true) {\n      const project = await this.getProject(projectId);\n      options?.onProgress?.(project);\n\n      if (project.status === \"completed\") {\n        return project;\n      }\n\n      if (project.status === \"failed\") {\n        throw new Error(`Project ${projectId} failed to build`);\n      }\n\n      if (Date.now() - startTime > timeout) {\n        throw new Error(`Timeout waiting for project ${projectId} to be ready`);\n      }\n\n      await sleep(pollInterval);\n    }\n  }\n\n  /**\n   * Wait for a project to be published (deployed).\n   *\n   * This method polls until the project has `is_published: true` and a `url`.\n   *\n   * @param projectId - The project ID to wait for\n   * @param options.pollInterval - Time between polls in ms (default: 3000)\n   * @param options.timeout - Maximum time to wait in ms (default: 600000 = 10 minutes)\n   * @param options.onProgress - Optional callback for status updates\n   * @returns The published project with URL\n   * @throws Error if timeout is reached\n   */\n  async waitForProjectPublished(projectId: string, options?: WaitOptions): Promise<ProjectResponse> {\n    const pollInterval = options?.pollInterval ?? 3000;\n    const timeout = options?.timeout ?? 600000;\n    const startTime = Date.now();\n\n    while (true) {\n      const project = await this.getProject(projectId);\n      options?.onProgress?.(project);\n\n      if (project.is_published && project.url) {\n        return project;\n      }\n\n      if (Date.now() - startTime > timeout) {\n        throw new Error(`Timeout waiting for project ${projectId} to be published`);\n      }\n\n      await sleep(pollInterval);\n    }\n  }\n}\n\nfunction sleep(ms: number): Promise<void> {\n  return new Promise((resolve) => setTimeout(resolve, ms));\n}\n"],"mappings":"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","names":[]}

package/package.json

@@ -0,0 +1,44 @@
+{
+  "name": "@lovable.dev/sdk",
+  "version": "0.0.1",
+  "description": "TypeScript SDK for the Lovable API",
+  "type": "module",
+  "main": "dist/index.js",
+  "module": "dist/index.js",
+  "types": "dist/index.d.ts",
+  "exports": {
+    ".": {
+      "import": "./dist/index.js",
+      "types": "./dist/index.d.ts"
+    }
+  },
+  "files": [
+    "dist"
+  ],
+  "devDependencies": {
+    "tsup": "^8.5.0",
+    "typescript": "^5.9.3",
+    "vitest": "^3.2.4"
+  },
+  "publishConfig": {
+    "access": "public"
+  },
+  "repository": {
+    "type": "git",
+    "url": "https://github.com/lovable-dev/lovable.git",
+    "directory": "packages/lov-sdk"
+  },
+  "license": "MIT",
+  "keywords": [
+    "lovable",
+    "sdk",
+    "api",
+    "typescript"
+  ],
+  "scripts": {
+    "build": "tsup",
+    "typecheck": "tsc --noEmit",
+    "test": "vitest",
+    "publish:npm": "pnpm publish --access public"
+  }
+}