v0-sdk 0.0.6 → 0.0.8

package/README.md

@@ -1,6 +1,8 @@
-# v0 Chat SDK
+# v0 SDK
 
-A TypeScript SDK for interacting with the v0 API to create and manage AI-powered chat conversations, projects, integrations, and more.
+> **⚠️ Developer Preview**: This SDK is currently in beta and is subject to change. Use in production at your own risk.
+
+A TypeScript SDK for interacting with the v0 Platform API to create and manage AI-powered chat conversations, projects, integrations, and more.
 
 ## Features
 
@@ -37,15 +39,6 @@ const chat = await v0.chats.create({
 })
 
 console.log(`Chat created: ${chat.url}`)
-console.log(`Generated code: ${chat.files?.length} files`)
-
-// Add a message to the chat
-const response = await v0.chats.createMessage({
-  chatId: chat.chatId,
-  message: 'Add a dropdown menu to the navbar',
-})
-
-console.log(`AI response: ${response.text}`)
 ```
 
 ## Authentication
@@ -85,33 +78,6 @@ const result = await v0.chats.create({
 
 ```typescript
 const chat = await v0.chats.getById({ chatId: 'chat_id' })
-console.log(chat.messages) // Fully typed message array
-```
-
-#### Manage Chat Favorites
-
-```typescript
-// Favorite a chat
-await v0.chats.favorite({ chatId: 'chat_id' })
-
-// Unfavorite a chat
-await v0.chats.unfavorite({ chatId: 'chat_id' })
-
-// Get favorite chats
-const favorites = await v0.chats.find()
-```
-
-#### Chat History and Management
-
-```typescript
-// Get chat history
-const chats = await v0.chats.find()
-
-// Delete a chat
-await v0.chats.delete({ chatId: 'chat_id' })
-
-// Get chat's associated project
-const project = await v0.chats.getProject({ chatId: 'chat_id' })
 ```
 
 #### Add Messages to Chat
@@ -120,128 +86,65 @@ const project = await v0.chats.getProject({ chatId: 'chat_id' })
 const response = await v0.chats.createMessage({
   chatId: 'chat_id',
   message: 'Add password strength indicator',
-  attachments: [{ url: 'https://example.com/mockup.jpg' }],
-  modelConfiguration: {
-    imageGenerations: true
-  },
 })
 ```
 
-#### Get Version Frame Token
+#### Other Chat Operations
 
-```typescript
-const token = await v0.chats.getVersionFrameToken({ 
-  chatId: 'chat_id', 
-  versionId: 'version_id' 
-})
-```
+- `v0.chats.find()` - Get chat history
+- `v0.chats.delete({ chatId })` - Delete a chat
+- `v0.chats.favorite({ chatId })` - Favorite a chat
+- `v0.chats.unfavorite({ chatId })` - Unfavorite a chat
+- `v0.chats.getProject({ chatId })` - Get chat's associated project
+- `v0.chats.getVersionFrameToken({ chatId, versionId })` - Get version frame token
 
 ### Project Operations
 
-#### Create a Project
-
 ```typescript
+// Create a project
 const project = await v0.projects.create({
   name: 'My New Project',
   description: 'A sample project',
-  environmentVariables: [
-    { key: 'API_KEY', value: 'secret_value' }
-  ],
-  icon: 'https://example.com/icon.png'
 })
-```
 
-#### Find Projects
-
-```typescript
+// Find projects
 const projects = await v0.projects.find()
 ```
 
 ### Vercel Integration
 
-#### Create Vercel Integration Project
-
 ```typescript
+// Create Vercel integration project
 const integration = await v0.integrations.vercel.projects.create({
   projectId: 'vercel_project_id',
-  name: 'project_name'
+  name: 'project_name',
 })
-```
-
-#### Find Vercel Projects
 
-```typescript
+// Find Vercel projects
 const projects = await v0.integrations.vercel.projects.find()
 ```
 
 ### User Management
 
-#### Get User Information
-
 ```typescript
+// Get user information
 const userResponse = await v0.user.get()
-console.log(userResponse.user.name, userResponse.user.email)
-```
-
-#### Get User Plan and Billing
 
-```typescript
+// Get user plan and billing
 const planResponse = await v0.user.getPlan()
-console.log(planResponse.plan, planResponse.balance)
-```
-
-### Deployment and Monitoring
 
-#### Find Deployment Logs
-
-```typescript
-const logs = await v0.deployments.findLogs({
-  deploymentId: 'deployment_id'
-})
+// Get user scopes
+const scopesResponse = await v0.user.getScopes()
 ```
 
-### Scopes and Rate Limits
-
-#### Find Scopes
+### Other Operations
 
 ```typescript
-const scopesResponse = await v0.scopes.find()
-console.log(scopesResponse.scopes)
-```
+// Find deployment logs
+const logs = await v0.deployments.findLogs({ deploymentId: 'deployment_id' })
 
-#### Check Rate Limits
-
-```typescript
+// Check rate limits
 const rateLimits = await v0.rateLimits.find()
-console.log(rateLimits.remaining, rateLimits.reset)
-```
-
-## Working with Attachments
-
-The SDK supports URL and base64-encoded attachments:
-
-```typescript
-// URL attachment
-const response = await v0.chats.create({
-  message: 'Create a component based on this design',
-  attachments: [{ url: 'https://example.com/design.png' }],
-})
-
-// Base64 attachment
-const handleFileUpload = async (file: File) => {
-  const reader = new FileReader()
-  
-  reader.onload = async () => {
-    const response = await v0.chats.create({
-      message: 'Create a component based on this image',
-      attachments: [{ url: reader.result as string }],
-    })
-    
-    console.log(response)
-  }
-  
-  reader.readAsDataURL(file)
-}
 ```
 
 ## TypeScript Support
@@ -249,19 +152,12 @@ const handleFileUpload = async (file: File) => {
 The SDK includes complete type definitions for all API operations:
 
 ```typescript
-import type { 
+import type {
   ChatsCreateRequest,
   ChatsCreateResponse,
   User,
   Project,
-  ScopeSummary 
 } from 'v0-sdk'
-
-// All request and response types are fully typed
-const createChatRequest: ChatsCreateRequest = {
-  message: 'Create a component',
-  system: 'You are a helpful assistant',
-}
 ```
 
 ## Error Handling
@@ -278,8 +174,6 @@ try {
     console.error('Authentication error:', error.message)
   } else if (error.status === 429) {
     console.error('Rate limit exceeded:', error.message)
-  } else {
-    console.error('API error:', error.message)
   }
 }
 ```
@@ -292,39 +186,6 @@ The SDK includes comprehensive test coverage. Run tests with:
 npm test
 ```
 
-### Test Structure
-
-Tests are organized by functionality:
-
-```
-tests/
-├── chats/
-│   ├── create.test.ts
-│   ├── find.test.ts
-│   ├── delete.test.ts
-│   ├── getById.test.ts
-│   ├── favorite.test.ts
-│   ├── unfavorite.test.ts
-│   ├── getProject.test.ts
-│   ├── createMessage.test.ts
-│   └── getVersionFrameToken.test.ts
-├── projects/
-│   ├── create.test.ts
-│   └── find.test.ts
-├── integrations/vercel/projects/
-│   ├── create.test.ts
-│   └── find.test.ts
-├── user/
-│   ├── get.test.ts
-│   └── getPlan.test.ts
-├── deployments/
-│   └── findLogs.test.ts
-├── scopes/
-│   └── find.test.ts
-└── rateLimits/
-    └── find.test.ts
-```
-
 ## Development
 
 ### Building
@@ -347,51 +208,6 @@ npm run generate
 npm test
 ```
 
-## Advanced Usage
-
-### Custom Configuration
-
-```typescript
-const client = new V0Client('your_api_key', 'https://custom-api.example.com', {
-  timeout: 30000,
-  retries: 3
-})
-```
-
-### Team Collaboration
-
-Share chats with your team:
-
-```typescript
-const chat = await v0.chats.create({
-  message: 'Create a component for our design system',
-  chatPrivacy: 'team-edit',
-  teamId: 'your-team-id',
-})
-
-// Now team members can view and edit this chat
-console.log(`Team chat URL: ${chat.url}`)
-```
-
-## Troubleshooting
-
-### Rate Limiting
-
-The API has rate limits. Check your current limits:
-
-```typescript
-const limits = await v0.rateLimits.find()
-console.log(`Remaining requests: ${limits.remaining}`)
-```
-
-### Common Errors
-
-- **403 Forbidden**: Check your API key and ensure you have a valid subscription
-- **400 Bad Request**: Verify your request parameters match the API requirements
-- **404 Not Found**: Ensure the resource ID exists and is accessible to your API key
-- **413 Payload Too Large**: Reduce attachment size (max 10MB per attachment)
-- **429 Too Many Requests**: You've hit the rate limit, wait before making more requests
-
 ## Resources
 
 - [v0 Documentation](https://v0.dev/docs)

package/dist/index.cjs

@@ -10,7 +10,7 @@ async function fetcher(url, method, params = {}) {
     }
     const hasBody = method !== 'GET' && params.body;
     const headers = {
-        'Authorization': `Bearer ${apiKey}`,
+        Authorization: `Bearer ${apiKey}`,
         ...params.headers
     };
     if (hasBody) {
@@ -37,15 +37,24 @@ const v0 = {
                 system: params.system,
                 chatPrivacy: params.chatPrivacy,
                 projectId: params.projectId,
-                modelConfiguration: params.modelConfiguration,
-                chatId: params.chatId
+                modelConfiguration: params.modelConfiguration
             };
             return fetcher(`/chats`, 'POST', {
                 body
             });
         },
-        async find () {
-            return fetcher(`/chats`, 'GET', {});
+        async find (params) {
+            const query = params ? Object.fromEntries(Object.entries({
+                limit: params.limit,
+                offset: params.offset,
+                isFavorite: params.isFavorite
+            }).filter(([_, value])=>value !== undefined)) : {};
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/chats`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
         },
         async delete (params) {
             const pathParams = {
@@ -61,26 +70,38 @@ const v0 = {
             return fetcher(`/chats/${pathParams.chatId}`, 'GET', {
                 });
         },
-        async favorite (params) {
+        async update (params) {
             const pathParams = {
                 chatId: params.chatId
             };
-            return fetcher(`/chats/${pathParams.chatId}/favorite`, 'POST', {
-                });
+            const body = {
+                privacy: params.privacy
+            };
+            return fetcher(`/chats/${pathParams.chatId}`, 'PATCH', {
+                body
+            });
         },
-        async unfavorite (params) {
+        async favorite (params) {
             const pathParams = {
                 chatId: params.chatId
             };
-            return fetcher(`/chats/${pathParams.chatId}/unfavorite`, 'POST', {
-                });
+            const body = {
+                isFavorite: params.isFavorite
+            };
+            return fetcher(`/chats/${pathParams.chatId}/favorite`, 'PUT', {
+                body
+            });
         },
-        async getProject (params) {
+        async fork (params) {
             const pathParams = {
                 chatId: params.chatId
             };
-            return fetcher(`/chats/${pathParams.chatId}/project`, 'GET', {
-                });
+            const body = {
+                versionId: params.versionId
+            };
+            return fetcher(`/chats/${pathParams.chatId}/fork`, 'POST', {
+                body
+            });
         },
         async createMessage (params) {
             const pathParams = {
@@ -95,6 +116,14 @@ const v0 = {
                 body
             });
         },
+        async findIframe (params) {
+            const pathParams = {
+                chatId: params.chatId,
+                versionId: params.versionId
+            };
+            return fetcher(`/chats/${pathParams.chatId}/versions/${pathParams.versionId}/iframe`, 'GET', {
+                });
+        },
         async getVersionFrameToken (params) {
             const pathParams = {
                 chatId: params.chatId,
@@ -110,17 +139,6 @@ const v0 = {
             return fetcher(`/chats/${pathParams.chatId}/metadata`, 'GET', {
                 });
         },
-        async setPrivacy (params) {
-            const pathParams = {
-                chatId: params.chatId
-            };
-            const body = {
-                privacy: params.privacy
-            };
-            return fetcher(`/chats/${pathParams.chatId}/privacy`, 'POST', {
-                body
-            });
-        },
         async upload (params) {
             const pathParams = {
                 chatId: params.chatId
@@ -141,41 +159,14 @@ const v0 = {
                 });
         }
     },
-    deployments: {
-        async findLogs (params) {
+    projects: {
+        async getByChatId (params) {
             const pathParams = {
-                deploymentId: params.deploymentId
+                chatId: params.chatId
             };
-            return fetcher(`/deployments/${pathParams.deploymentId}/logs`, 'GET', {
+            return fetcher(`/chats/${pathParams.chatId}/project`, 'GET', {
                 });
         },
-        async findErrors (params) {
-            const pathParams = {
-                deploymentId: params.deploymentId
-            };
-            return fetcher(`/deployments/${pathParams.deploymentId}/errors`, 'GET', {
-                });
-        }
-    },
-    integrations: {
-        vercel: {
-            projects: {
-                async find () {
-                    return fetcher(`/integrations/vercel/projects`, 'GET', {});
-                },
-                async create (params) {
-                    const body = {
-                        projectId: params.projectId,
-                        name: params.name
-                    };
-                    return fetcher(`/integrations/vercel/projects`, 'POST', {
-                        body
-                    });
-                }
-            }
-        }
-    },
-    projects: {
         async find () {
             return fetcher(`/projects`, 'GET', {});
         },
@@ -203,22 +194,80 @@ const v0 = {
             });
         }
     },
-    scopes: {
-        async find () {
-            return fetcher(`/scopes`, 'GET', {});
+    deployments: {
+        async findLogs (params) {
+            const pathParams = {
+                deploymentId: params.deploymentId
+            };
+            const query = Object.fromEntries(Object.entries({
+                since: params.since
+            }).filter(([_, value])=>value !== undefined));
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/deployments/${pathParams.deploymentId}/logs`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
+        },
+        async findErrors (params) {
+            const pathParams = {
+                deploymentId: params.deploymentId
+            };
+            return fetcher(`/deployments/${pathParams.deploymentId}/errors`, 'GET', {
+                });
+        }
+    },
+    integrations: {
+        vercel: {
+            projects: {
+                async find () {
+                    return fetcher(`/integrations/vercel/projects`, 'GET', {});
+                },
+                async create (params) {
+                    const body = {
+                        projectId: params.projectId,
+                        name: params.name
+                    };
+                    return fetcher(`/integrations/vercel/projects`, 'POST', {
+                        body
+                    });
+                }
+            }
         }
     },
     rateLimits: {
-        async find () {
-            return fetcher(`/rate-limits`, 'GET', {});
+        async find (params) {
+            const query = params ? Object.fromEntries(Object.entries({
+                scope: params.scope
+            }).filter(([_, value])=>value !== undefined)) : {};
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/rate-limits`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
         }
     },
     user: {
         async get () {
             return fetcher(`/user`, 'GET', {});
         },
+        async getBilling (params) {
+            const query = params ? Object.fromEntries(Object.entries({
+                scope: params.scope
+            }).filter(([_, value])=>value !== undefined)) : {};
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/user/billing`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
+        },
         async getPlan () {
             return fetcher(`/user/plan`, 'GET', {});
+        },
+        async getScopes () {
+            return fetcher(`/user/scopes`, 'GET', {});
         }
     }
 };

package/dist/index.d.ts

@@ -1,13 +1,73 @@
+type ChatDetail = {
+    id: string;
+    object: 'chat';
+    url: string;
+    shareable: boolean;
+    privacy?: 'public' | 'private' | 'team' | 'team-edit' | 'unlisted';
+    title?: string;
+    updatedAt?: string;
+    favorite: boolean;
+    authorId: string;
+    latestBlockId?: string;
+    messages: {
+        id: string;
+        object: 'message';
+        content: string;
+        createdAt: string;
+        type: 'message' | 'refinement' | 'forked-block' | 'forked-chat' | 'open-in-v0' | 'added-environment-variables' | 'added-integration' | 'deleted-file' | 'moved-file' | 'renamed-file' | 'edited-file' | 'replace-src' | 'reverted-block' | 'fix-with-v0' | 'sync-git';
+    }[];
+};
+interface ChatSummary {
+    id: string;
+    object: 'chat';
+    shareable: boolean;
+    privacy: string;
+    title?: string;
+    updatedAt: string;
+    favorite: boolean;
+    authorId: string;
+    latestVersionId?: string;
+}
+type MessageDetail = {
+    id: string;
+    object: 'message';
+    chatId: string;
+    url: string;
+    files?: {
+        lang: string;
+        meta: Record<string, any>;
+        source: string;
+    }[];
+    demo?: string;
+    text: string;
+    modelConfiguration: {
+        modelId: 'v0-1.5-sm' | 'v0-1.5-md' | 'v0-1.5-lg';
+        imageGenerations?: boolean;
+        thinking?: boolean;
+    };
+};
+interface ProjectDetail {
+    id: string;
+    object: 'project';
+    name: string;
+    vercelProjectId?: string;
+}
 interface ScopeSummary {
     id: string;
+    object: 'scope';
     name?: string;
 }
-interface User {
+interface UserDetail {
     id: string;
+    object: 'user';
     name?: string;
     email: string;
     avatar: string;
-    createdAt: string;
+}
+interface VercelProjectDetail {
+    id: string;
+    object: 'vercel_project';
+    name: string;
 }
 interface ChatsCreateRequest {
     message: string;
@@ -22,10 +82,10 @@ interface ChatsCreateRequest {
         imageGenerations?: boolean;
         thinking?: boolean;
     };
-    chatId?: string;
 }
 type ChatsCreateResponse = {
-    chatId: string;
+    id: string;
+    object: 'chat';
     url: string;
     files?: {
         lang: string;
@@ -39,62 +99,34 @@ type ChatsCreateResponse = {
         imageGenerations?: boolean;
         thinking?: boolean;
     };
-    _deprecation?: {
-        message: string;
-        migration: string;
-        sunset: string;
-    };
 };
 interface ChatsFindResponse {
-    favorites: {
-        chatId: string;
-        shareable: boolean;
-        privacy: string;
-        title: string;
-        updatedAt: string;
-        favorite: boolean;
-        authorId: string;
-    }[];
-    history: {
-        chatId: string;
-        shareable: boolean;
-        privacy: string;
-        title: string;
-        updatedAt: string;
-    }[];
+    object: 'list';
+    data: ChatSummary[];
 }
 interface ChatsDeleteResponse {
-    success: boolean;
+    id: string;
+    object: 'chat';
+    deleted: true;
 }
-type ChatsGetByIdResponse = {
-    chatId: string;
-    url: string;
-    messages: {
-        messageId: string;
-        content: string;
-        createdAt: string;
-        type: 'message' | 'refinement' | 'forked-block' | 'forked-chat' | 'open-in-v0' | 'added-environment-variables' | 'added-integration' | 'deleted-file' | 'moved-file' | 'renamed-file' | 'edited-file' | 'replace-src' | 'reverted-block' | 'fix-with-v0' | 'sync-git';
-    }[];
-};
-type ChatsFavoriteResponse = {
-    success: boolean;
-} | {
-    error: string;
-    success?: any;
-};
-type ChatsUnfavoriteResponse = {
-    success: boolean;
-} | {
-    error: string;
-    success?: any;
-};
-interface ChatsGetProjectResponse {
-    project: {
-        id: string;
-        name: string;
-        url: string;
-    };
+type ChatsGetByIdResponse = ChatDetail;
+interface ChatsUpdateRequest {
+    privacy?: 'public' | 'private' | 'team' | 'team-edit' | 'unlisted';
 }
+type ChatsUpdateResponse = ChatDetail;
+interface ChatsFavoriteRequest {
+    isFavorite: boolean;
+}
+interface ChatsFavoriteResponse {
+    id: string;
+    object: 'chat';
+    favorited: boolean;
+}
+interface ChatsForkRequest {
+    versionId: string;
+}
+type ChatsForkResponse = ChatDetail;
+type ProjectsGetByChatIdResponse = ProjectDetail;
 interface ChatsCreateMessageRequest {
     message: string;
     attachments?: {
@@ -106,22 +138,12 @@ interface ChatsCreateMessageRequest {
         thinking?: boolean;
     };
 }
-type ChatsCreateMessageResponse = {
-    chatId: string;
+type ChatsCreateMessageResponse = MessageDetail;
+interface ChatsFindIframeResponse {
+    id: string;
+    object: 'iframe';
     url: string;
-    files?: {
-        lang: string;
-        meta: Record<string, any>;
-        source: string;
-    }[];
-    demo?: string;
-    text: string;
-    modelConfiguration: {
-        modelId: 'v0-1.5-sm' | 'v0-1.5-md' | 'v0-1.5-lg';
-        imageGenerations?: boolean;
-        thinking?: boolean;
-    };
-};
+}
 interface ChatsGetVersionFrameTokenResponse {
     token: string;
 }
@@ -139,28 +161,13 @@ interface ChatsGetMetadataResponse {
         url: string;
     };
 }
-interface ChatsSetPrivacyRequest {
-    privacy: 'public' | 'private' | 'team' | 'team-edit' | 'unlisted';
-}
-type ChatsSetPrivacyResponse = {
-    success: 'true';
-} | {
-    error: string;
-};
 interface ChatsUploadRequest {
     file: any;
 }
 interface ChatsUploadResponse {
     url: string;
 }
-interface ChatsResumeResponse {
-    message: {
-        id: string;
-        content: string;
-        createdAt: string;
-        finishReason?: string;
-    };
-}
+type ChatsResumeResponse = MessageDetail;
 interface DeploymentsFindLogsResponse {
     error?: string;
     logs: string[];
@@ -173,24 +180,17 @@ interface DeploymentsFindErrorsResponse {
     formattedError?: string;
 }
 interface IntegrationsVercelProjectsFindResponse {
-    projects: {
-        id: string;
-        name: string;
-        url: string;
-    }[];
+    object: 'list';
+    data: VercelProjectDetail[];
 }
 interface IntegrationsVercelProjectsCreateRequest {
     projectId: string;
     name: string;
 }
-interface IntegrationsVercelProjectsCreateResponse {
-    success: boolean;
-}
+type IntegrationsVercelProjectsCreateResponse = VercelProjectDetail;
 interface ProjectsFindResponse {
-    id: string;
-    name: string;
-    url: string;
-    env: string[];
+    object: 'list';
+    data: ProjectDetail[];
 }
 interface ProjectsCreateRequest {
     name: string;
@@ -202,29 +202,55 @@ interface ProjectsCreateRequest {
     }[];
     instructions?: string;
 }
-interface ProjectsCreateResponse {
-    id: string;
-    name: string;
-    vercelProjectId?: string;
-}
+type ProjectsCreateResponse = ProjectDetail;
 interface ProjectsAssignRequest {
     chatId: string;
 }
 interface ProjectsAssignResponse {
-    success: boolean;
-}
-interface ScopesFindResponse {
-    scopes: ScopeSummary[];
+    object: 'project';
+    id: string;
+    assigned: true;
 }
 interface RateLimitsFindResponse {
     remaining?: number;
     reset?: number;
     limit: number;
 }
-interface UserGetResponse {
-    user: User;
-}
+type UserGetResponse = UserDetail;
+type UserGetBillingResponse = {
+    billingType: 'token';
+    data: {
+        plan: string;
+        billingMode?: 'test';
+        role: string;
+        billingCycle: {
+            start: number;
+            end: number;
+        };
+        balance: {
+            remaining: number;
+            total: number;
+        };
+        onDemand: {
+            balance: number;
+            blocks?: {
+                expirationDate?: number;
+                effectiveDate: number;
+                originalBalance: number;
+                currentBalance: number;
+            }[];
+        };
+    };
+} | {
+    billingType: 'legacy';
+    data: {
+        remaining?: number;
+        reset?: number;
+        limit: number;
+    };
+};
 interface UserGetPlanResponse {
+    object: 'plan';
     plan: string;
     billingCycle: {
         start: number;
@@ -235,28 +261,40 @@ interface UserGetPlanResponse {
         total: number;
     };
 }
+interface UserGetScopesResponse {
+    object: 'list';
+    data: ScopeSummary[];
+}
 declare const v0: {
     chats: {
         create(params: ChatsCreateRequest): Promise<ChatsCreateResponse>;
-        find(): Promise<ChatsFindResponse>;
+        find(params?: {
+            limit?: string;
+            offset?: string;
+            isFavorite?: string;
+        }): Promise<ChatsFindResponse>;
         delete(params: {
             chatId: string;
         }): Promise<ChatsDeleteResponse>;
         getById(params: {
             chatId: string;
         }): Promise<ChatsGetByIdResponse>;
-        favorite(params: {
+        update(params: {
             chatId: string;
-        }): Promise<ChatsFavoriteResponse>;
-        unfavorite(params: {
+        } & ChatsUpdateRequest): Promise<ChatsUpdateResponse>;
+        favorite(params: {
             chatId: string;
-        }): Promise<ChatsUnfavoriteResponse>;
-        getProject(params: {
+        } & ChatsFavoriteRequest): Promise<ChatsFavoriteResponse>;
+        fork(params: {
             chatId: string;
-        }): Promise<ChatsGetProjectResponse>;
+        } & ChatsForkRequest): Promise<ChatsForkResponse>;
         createMessage(params: {
             chatId: string;
         } & ChatsCreateMessageRequest): Promise<ChatsCreateMessageResponse>;
+        findIframe(params: {
+            chatId: string;
+            versionId: string;
+        }): Promise<ChatsFindIframeResponse>;
         getVersionFrameToken(params: {
             chatId: string;
             versionId: string;
@@ -264,9 +302,6 @@ declare const v0: {
         getMetadata(params: {
             chatId: string;
         }): Promise<ChatsGetMetadataResponse>;
-        setPrivacy(params: {
-            chatId: string;
-        } & ChatsSetPrivacyRequest): Promise<ChatsSetPrivacyResponse>;
         upload(params: {
             chatId: string;
         } & ChatsUploadRequest): Promise<ChatsUploadResponse>;
@@ -275,9 +310,20 @@ declare const v0: {
             messageId: string;
         }): Promise<ChatsResumeResponse>;
     };
+    projects: {
+        getByChatId(params: {
+            chatId: string;
+        }): Promise<ProjectsGetByChatIdResponse>;
+        find(): Promise<ProjectsFindResponse>;
+        create(params: ProjectsCreateRequest): Promise<ProjectsCreateResponse>;
+        assign(params: {
+            projectId: string;
+        } & ProjectsAssignRequest): Promise<ProjectsAssignResponse>;
+    };
     deployments: {
         findLogs(params: {
             deploymentId: string;
+            since?: string;
         }): Promise<DeploymentsFindLogsResponse>;
         findErrors(params: {
             deploymentId: string;
@@ -291,22 +337,18 @@ declare const v0: {
             };
         };
     };
-    projects: {
-        find(): Promise<ProjectsFindResponse>;
-        create(params: ProjectsCreateRequest): Promise<ProjectsCreateResponse>;
-        assign(params: {
-            projectId: string;
-        } & ProjectsAssignRequest): Promise<ProjectsAssignResponse>;
-    };
-    scopes: {
-        find(): Promise<ScopesFindResponse>;
-    };
     rateLimits: {
-        find(): Promise<RateLimitsFindResponse>;
+        find(params?: {
+            scope?: string;
+        }): Promise<RateLimitsFindResponse>;
     };
     user: {
         get(): Promise<UserGetResponse>;
+        getBilling(params?: {
+            scope?: string;
+        }): Promise<UserGetBillingResponse>;
         getPlan(): Promise<UserGetPlanResponse>;
+        getScopes(): Promise<UserGetScopesResponse>;
     };
 };
 

package/dist/index.js

@@ -8,7 +8,7 @@ async function fetcher(url, method, params = {}) {
     }
     const hasBody = method !== 'GET' && params.body;
     const headers = {
-        'Authorization': `Bearer ${apiKey}`,
+        Authorization: `Bearer ${apiKey}`,
         ...params.headers
     };
     if (hasBody) {
@@ -35,15 +35,24 @@ const v0 = {
                 system: params.system,
                 chatPrivacy: params.chatPrivacy,
                 projectId: params.projectId,
-                modelConfiguration: params.modelConfiguration,
-                chatId: params.chatId
+                modelConfiguration: params.modelConfiguration
             };
             return fetcher(`/chats`, 'POST', {
                 body
             });
         },
-        async find () {
-            return fetcher(`/chats`, 'GET', {});
+        async find (params) {
+            const query = params ? Object.fromEntries(Object.entries({
+                limit: params.limit,
+                offset: params.offset,
+                isFavorite: params.isFavorite
+            }).filter(([_, value])=>value !== undefined)) : {};
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/chats`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
         },
         async delete (params) {
             const pathParams = {
@@ -59,26 +68,38 @@ const v0 = {
             return fetcher(`/chats/${pathParams.chatId}`, 'GET', {
                 });
         },
-        async favorite (params) {
+        async update (params) {
             const pathParams = {
                 chatId: params.chatId
             };
-            return fetcher(`/chats/${pathParams.chatId}/favorite`, 'POST', {
-                });
+            const body = {
+                privacy: params.privacy
+            };
+            return fetcher(`/chats/${pathParams.chatId}`, 'PATCH', {
+                body
+            });
         },
-        async unfavorite (params) {
+        async favorite (params) {
             const pathParams = {
                 chatId: params.chatId
             };
-            return fetcher(`/chats/${pathParams.chatId}/unfavorite`, 'POST', {
-                });
+            const body = {
+                isFavorite: params.isFavorite
+            };
+            return fetcher(`/chats/${pathParams.chatId}/favorite`, 'PUT', {
+                body
+            });
         },
-        async getProject (params) {
+        async fork (params) {
             const pathParams = {
                 chatId: params.chatId
             };
-            return fetcher(`/chats/${pathParams.chatId}/project`, 'GET', {
-                });
+            const body = {
+                versionId: params.versionId
+            };
+            return fetcher(`/chats/${pathParams.chatId}/fork`, 'POST', {
+                body
+            });
         },
         async createMessage (params) {
             const pathParams = {
@@ -93,6 +114,14 @@ const v0 = {
                 body
             });
         },
+        async findIframe (params) {
+            const pathParams = {
+                chatId: params.chatId,
+                versionId: params.versionId
+            };
+            return fetcher(`/chats/${pathParams.chatId}/versions/${pathParams.versionId}/iframe`, 'GET', {
+                });
+        },
         async getVersionFrameToken (params) {
             const pathParams = {
                 chatId: params.chatId,
@@ -108,17 +137,6 @@ const v0 = {
             return fetcher(`/chats/${pathParams.chatId}/metadata`, 'GET', {
                 });
         },
-        async setPrivacy (params) {
-            const pathParams = {
-                chatId: params.chatId
-            };
-            const body = {
-                privacy: params.privacy
-            };
-            return fetcher(`/chats/${pathParams.chatId}/privacy`, 'POST', {
-                body
-            });
-        },
         async upload (params) {
             const pathParams = {
                 chatId: params.chatId
@@ -139,41 +157,14 @@ const v0 = {
                 });
         }
     },
-    deployments: {
-        async findLogs (params) {
+    projects: {
+        async getByChatId (params) {
             const pathParams = {
-                deploymentId: params.deploymentId
+                chatId: params.chatId
             };
-            return fetcher(`/deployments/${pathParams.deploymentId}/logs`, 'GET', {
+            return fetcher(`/chats/${pathParams.chatId}/project`, 'GET', {
                 });
         },
-        async findErrors (params) {
-            const pathParams = {
-                deploymentId: params.deploymentId
-            };
-            return fetcher(`/deployments/${pathParams.deploymentId}/errors`, 'GET', {
-                });
-        }
-    },
-    integrations: {
-        vercel: {
-            projects: {
-                async find () {
-                    return fetcher(`/integrations/vercel/projects`, 'GET', {});
-                },
-                async create (params) {
-                    const body = {
-                        projectId: params.projectId,
-                        name: params.name
-                    };
-                    return fetcher(`/integrations/vercel/projects`, 'POST', {
-                        body
-                    });
-                }
-            }
-        }
-    },
-    projects: {
         async find () {
             return fetcher(`/projects`, 'GET', {});
         },
@@ -201,22 +192,80 @@ const v0 = {
             });
         }
     },
-    scopes: {
-        async find () {
-            return fetcher(`/scopes`, 'GET', {});
+    deployments: {
+        async findLogs (params) {
+            const pathParams = {
+                deploymentId: params.deploymentId
+            };
+            const query = Object.fromEntries(Object.entries({
+                since: params.since
+            }).filter(([_, value])=>value !== undefined));
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/deployments/${pathParams.deploymentId}/logs`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
+        },
+        async findErrors (params) {
+            const pathParams = {
+                deploymentId: params.deploymentId
+            };
+            return fetcher(`/deployments/${pathParams.deploymentId}/errors`, 'GET', {
+                });
+        }
+    },
+    integrations: {
+        vercel: {
+            projects: {
+                async find () {
+                    return fetcher(`/integrations/vercel/projects`, 'GET', {});
+                },
+                async create (params) {
+                    const body = {
+                        projectId: params.projectId,
+                        name: params.name
+                    };
+                    return fetcher(`/integrations/vercel/projects`, 'POST', {
+                        body
+                    });
+                }
+            }
         }
     },
     rateLimits: {
-        async find () {
-            return fetcher(`/rate-limits`, 'GET', {});
+        async find (params) {
+            const query = params ? Object.fromEntries(Object.entries({
+                scope: params.scope
+            }).filter(([_, value])=>value !== undefined)) : {};
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/rate-limits`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
         }
     },
     user: {
         async get () {
             return fetcher(`/user`, 'GET', {});
         },
+        async getBilling (params) {
+            const query = params ? Object.fromEntries(Object.entries({
+                scope: params.scope
+            }).filter(([_, value])=>value !== undefined)) : {};
+            const hasQuery = Object.keys(query).length > 0;
+            return fetcher(`/user/billing`, 'GET', {
+                ...hasQuery ? {
+                    query
+                } : {}
+            });
+        },
         async getPlan () {
             return fetcher(`/user/plan`, 'GET', {});
+        },
+        async getScopes () {
+            return fetcher(`/user/scopes`, 'GET', {});
         }
     }
 };

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "v0-sdk",
-  "version": "0.0.6",
+  "version": "0.0.8",
   "description": "TypeScript SDK for the v0 Chats API",
   "type": "module",
   "main": "dist/index.js",
@@ -19,7 +19,8 @@
     "type-check": "tsc --noEmit",
     "type-check:go": "tsgo --noEmit",
     "build": "bunchee",
-    "generate": "tsx src/scripts/generate.ts",
+    "generate": "tsx src/scripts/generate.ts && pnpm format",
+    "format": "prettier --write \"**/*.{ts,tsx,md}\"",
     "test": "vitest"
   },
   "keywords": [
@@ -35,6 +36,7 @@
     "@types/node": "22.5.5",
     "@typescript/native-preview": "7.0.0-dev.20250613.1",
     "bunchee": "^6.5.2",
+    "prettier": "^3.3.3",
     "tsx": "^4.19.2",
     "typescript": "5.7.3"
   }