@getlatedev/node 0.1.0 → 0.1.1

package/README.md

@@ -1,9 +1,21 @@
-# Late Node.js Library
+<p align="center">
+  <a href="https://getlate.dev">
+    <img src="https://getlate.dev/images/icon_light.svg" alt="Late" width="60">
+  </a>
+</p>
 
-[![npm version](https://img.shields.io/npm/v/late.svg)](https://www.npmjs.com/package/late)
-[![License](https://img.shields.io/badge/license-Apache--2.0-blue.svg)](LICENSE)
+<h1 align="center">Late Node.js SDK</h1>
 
-The official Node.js library for the [Late API](https://getlate.dev) - schedule social media posts across Instagram, TikTok, YouTube, LinkedIn, X/Twitter, Facebook, Pinterest, Threads, and more.
+<p align="center">
+  <a href="https://www.npmjs.com/package/@getlatedev/node"><img src="https://img.shields.io/npm/v/@getlatedev/node.svg" alt="npm version"></a>
+  <a href="LICENSE"><img src="https://img.shields.io/badge/license-Apache--2.0-blue.svg" alt="License"></a>
+</p>
+
+<p align="center">
+  <strong>One API to post everywhere. 13 platforms, zero headaches.</strong>
+</p>
+
+The official Node.js SDK for the [Late API](https://getlate.dev) — schedule and publish social media posts across Instagram, TikTok, YouTube, LinkedIn, X/Twitter, Facebook, Pinterest, Threads, Bluesky, Reddit, Snapchat, Telegram, and Google Business Profile with a single integration.
 
 ## Installation
 
@@ -11,46 +23,36 @@ The official Node.js library for the [Late API](https://getlate.dev) - schedule
 npm install @getlatedev/node
 ```
 
-## Usage
+## Quick Start
 
 ```typescript
 import Late from '@getlatedev/node';
 
-const late = new Late({
-  apiKey: process.env['LATE_API_KEY'], // This is the default and can be omitted
-});
+const late = new Late(); // Uses LATE_API_KEY env var
 
-async function main() {
-  // Create and publish a post
-  const post = await late.posts.create({
-    body: {
-      content: 'Hello from the Late SDK! 🚀',
-      platforms: [
-        { platform: 'twitter', accountId: 'acc_xxx' },
-        { platform: 'linkedin', accountId: 'acc_yyy' },
-      ],
-      publishNow: true,
-    },
-  });
-
-  console.log(post.data);
-}
+// Publish to multiple platforms with one call
+const { data: post } = await late.posts.createPost({
+  body: {
+    content: 'Hello world from Late!',
+    platforms: [
+      { platform: 'twitter', accountId: 'acc_xxx' },
+      { platform: 'linkedin', accountId: 'acc_yyy' },
+      { platform: 'instagram', accountId: 'acc_zzz' },
+    ],
+    publishNow: true,
+  },
+});
 
-main();
+console.log(`Published to ${post.platforms.length} platforms!`);
 ```
 
 ## Configuration
 
-The client can be configured with the following options:
-
 ```typescript
 const late = new Late({
-  apiKey: 'sk_...', // Defaults to process.env['LATE_API_KEY']
-  baseURL: 'https://getlate.dev/api', // Default
-  timeout: 60000, // Request timeout in ms
-  defaultHeaders: {
-    'X-Custom-Header': 'value',
-  },
+  apiKey: 'your-api-key', // Defaults to process.env['LATE_API_KEY']
+  baseURL: 'https://getlate.dev/api',
+  timeout: 60000,
 });
 ```
 
@@ -59,31 +61,33 @@ const late = new Late({
 ### Schedule a Post
 
 ```typescript
-const post = await late.posts.create({
+const { data: post } = await late.posts.createPost({
   body: {
-    content: 'Scheduled post from the SDK',
+    content: 'This post will go live tomorrow at 10am',
     platforms: [{ platform: 'instagram', accountId: 'acc_xxx' }],
-    scheduledFor: new Date('2025-02-01T10:00:00Z').toISOString(),
+    scheduledFor: '2025-02-01T10:00:00Z',
   },
 });
 ```
 
-### Multi-Platform with Platform-Specific Content
+### Platform-Specific Content
+
+Customize content per platform while posting to all at once:
 
 ```typescript
-const post = await late.posts.create({
+const { data: post } = await late.posts.createPost({
   body: {
-    content: 'Default content for all platforms',
+    content: 'Default content',
     platforms: [
       {
         platform: 'twitter',
         accountId: 'acc_twitter',
-        platformSpecificContent: 'Shorter content for X #hashtags',
+        platformSpecificContent: 'Short & punchy for X',
       },
       {
         platform: 'linkedin',
         accountId: 'acc_linkedin',
-        platformSpecificContent: 'Professional content for LinkedIn',
+        platformSpecificContent: 'Professional tone for LinkedIn with more detail.',
       },
     ],
     publishNow: true,
@@ -91,45 +95,30 @@ const post = await late.posts.create({
 });
 ```
 
-### List Posts
-
-```typescript
-const { data } = await late.posts.list({
-  query: {
-    status: 'scheduled',
-    limit: 20,
-  },
-});
-
-for (const post of data.posts) {
-  console.log(post.content, post.scheduledFor);
-}
-```
-
 ### Upload Media
 
 ```typescript
-// 1. Get presigned URL
-const { data: presign } = await late.media.getPresignedUrl({
-  body: {
-    filename: 'image.jpg',
-    contentType: 'image/jpeg',
-  },
+// 1. Get presigned upload URL
+const { data: presign } = await late.media.getMediaPresignedUrl({
+  body: { filename: 'video.mp4', contentType: 'video/mp4' },
 });
 
-// 2. Upload file
+// 2. Upload your file
 await fetch(presign.uploadUrl, {
   method: 'PUT',
-  body: imageBuffer,
-  headers: { 'Content-Type': 'image/jpeg' },
+  body: videoBuffer,
+  headers: { 'Content-Type': 'video/mp4' },
 });
 
 // 3. Create post with media
-await late.posts.create({
+const { data: post } = await late.posts.createPost({
   body: {
-    content: 'Post with image',
+    content: 'Check out this video!',
     mediaUrls: [presign.publicUrl],
-    platforms: [{ platform: 'instagram', accountId: 'acc_xxx' }],
+    platforms: [
+      { platform: 'tiktok', accountId: 'acc_xxx' },
+      { platform: 'youtube', accountId: 'acc_yyy', youtubeTitle: 'My Video' },
+    ],
     publishNow: true,
   },
 });
@@ -138,94 +127,207 @@ await late.posts.create({
 ### Get Analytics
 
 ```typescript
-const { data: analytics } = await late.analytics.get({
+const { data } = await late.analytics.getAnalytics({
   query: { postId: 'post_xxx' },
 });
 
-console.log('Impressions:', analytics.analytics.impressions);
-console.log('Engagement:', analytics.analytics.engagementRate);
+console.log('Views:', data.analytics.views);
+console.log('Likes:', data.analytics.likes);
+console.log('Engagement Rate:', data.analytics.engagementRate);
 ```
 
 ### List Connected Accounts
 
 ```typescript
-const { data } = await late.accounts.list();
+const { data } = await late.accounts.listAccounts();
 
 for (const account of data.accounts) {
   console.log(`${account.platform}: @${account.username}`);
 }
 ```
 
-### Configure Webhooks
-
-```typescript
-await late.webhooks.updateSettings({
-  body: {
-    url: 'https://your-app.com/webhooks/late',
-    events: ['post.published', 'post.failed', 'account.disconnected'],
-    secret: 'your-webhook-secret',
-  },
-});
-```
-
 ## Error Handling
 
 ```typescript
 import Late, { LateApiError, RateLimitError, ValidationError } from '@getlatedev/node';
 
-const late = new Late();
-
 try {
-  await late.posts.create({ body: { ... } });
+  await late.posts.createPost({ body: { /* ... */ } });
 } catch (error) {
   if (error instanceof RateLimitError) {
-    console.log(`Rate limited. Retry in ${error.getSecondsUntilReset()} seconds`);
+    console.log(`Rate limited. Retry in ${error.getSecondsUntilReset()}s`);
   } else if (error instanceof ValidationError) {
-    console.log('Validation errors:', error.fields);
+    console.log('Invalid request:', error.fields);
   } else if (error instanceof LateApiError) {
-    console.log(`API error ${error.statusCode}: ${error.message}`);
+    console.log(`Error ${error.statusCode}: ${error.message}`);
   }
 }
 ```
 
-## API Reference
+## SDK Reference
 
 ### Posts
-
 | Method | Description |
 |--------|-------------|
-| `posts.list(params)` | List posts |
-| `posts.create(params)` | Create a post |
-| `posts.get(params)` | Get a post |
-| `posts.update(params)` | Update a post |
-| `posts.delete(params)` | Delete a post |
-| `posts.retry(params)` | Retry a failed post |
-| `posts.bulkUpload(params)` | Upload multiple posts |
+| `posts.listPosts()` | List posts visible to the authenticated user |
+| `posts.bulkUploadPosts()` | Validate and schedule multiple posts from CSV |
+| `posts.createPost()` | Create a draft, scheduled, or immediate post |
+| `posts.getPost()` | Get a single post |
+| `posts.updatePost()` | Update a post |
+| `posts.deletePost()` | Delete a post |
+| `posts.retryPost()` | Retry publishing a failed or partial post |
 
 ### Accounts
-
 | Method | Description |
 |--------|-------------|
-| `accounts.list()` | List connected accounts |
-| `accounts.update(params)` | Update an account |
-| `accounts.delete(params)` | Disconnect an account |
-| `accounts.getFollowerStats()` | Get follower statistics |
-| `accounts.getAllHealth()` | Get health for all accounts |
+| `accounts.getAllAccountsHealth()` | Check health of all connected accounts |
+| `accounts.listAccounts()` | List connected social accounts |
+| `accounts.getAccountHealth()` | Check health of a specific account |
+| `accounts.getFollowerStats()` | Get follower stats and growth metrics |
+| `accounts.getGoogleBusinessReviews()` | Get Google Business Profile reviews |
+| `accounts.getLinkedInMentions()` | Resolve a LinkedIn profile or company URL to a URN for @mentions |
+| `accounts.updateAccount()` | Update a social account |
+| `accounts.deleteAccount()` | Disconnect a social account |
+
+### Profiles
+| Method | Description |
+|--------|-------------|
+| `profiles.listProfiles()` | List profiles visible to the authenticated user |
+| `profiles.createProfile()` | Create a new profile |
+| `profiles.getProfile()` | Get a profile by id |
+| `profiles.updateProfile()` | Update a profile |
+| `profiles.deleteProfile()` | Delete a profile (must have no connected accounts) |
 
 ### Analytics
+| Method | Description |
+|--------|-------------|
+| `analytics.getAnalytics()` | Unified analytics for posts |
+| `analytics.getLinkedInAggregateAnalytics()` | Get aggregate analytics for a LinkedIn personal account |
+| `analytics.getLinkedInPostAnalytics()` | Get analytics for a specific LinkedIn post by URN |
+| `analytics.getYouTubeDailyViews()` | YouTube daily views breakdown |
 
+### Account Groups
+| Method | Description |
+|--------|-------------|
+| `accountGroups.listAccountGroups()` | List account groups for the authenticated user |
+| `accountGroups.createAccountGroup()` | Create a new account group |
+| `accountGroups.updateAccountGroup()` | Update an account group |
+| `accountGroups.deleteAccountGroup()` | Delete an account group |
+
+### Queue
+| Method | Description |
+|--------|-------------|
+| `queue.listQueueSlots()` | Get queue schedules for a profile |
+| `queue.createQueueSlot()` | Create a new queue for a profile |
+| `queue.getNextQueueSlot()` | Get the next available queue slot for a profile |
+| `queue.updateQueueSlot()` | Create or update a queue schedule |
+| `queue.deleteQueueSlot()` | Delete a queue schedule |
+| `queue.previewQueue()` | Preview upcoming queue slots for a profile |
+
+### Webhooks
+| Method | Description |
+|--------|-------------|
+| `webhooks.createWebhookSettings()` | Create a new webhook |
+| `webhooks.getWebhookLogs()` | Get webhook delivery logs |
+| `webhooks.getWebhookSettings()` | List all webhooks |
+| `webhooks.updateWebhookSettings()` | Update a webhook |
+| `webhooks.deleteWebhookSettings()` | Delete a webhook |
+| `webhooks.testWebhook()` | Send test webhook |
+
+### API Keys
 | Method | Description |
 |--------|-------------|
-| `analytics.get(params)` | Get post analytics |
-| `analytics.getYouTubeDailyViews(params)` | Get YouTube daily views |
-| `analytics.getLinkedInAggregate(params)` | Get LinkedIn org analytics |
+| `apiKeys.listApiKeys()` | List API keys for the current user |
+| `apiKeys.createApiKey()` | Create a new API key |
+| `apiKeys.deleteApiKey()` | Delete an API key |
 
-See the [API documentation](https://getlate.dev/docs/api) for all available methods.
+### Media
+| Method | Description |
+|--------|-------------|
+| `media.getMediaPresignedUrl()` | Get a presigned URL for direct file upload (up to 5GB) |
+
+### Tools
+| Method | Description |
+|--------|-------------|
+| `tools.getYouTubeTranscript()` | Get YouTube video transcript |
+| `tools.checkInstagramHashtags()` | Check Instagram hashtags for bans |
+| `tools.downloadBlueskyMedia()` | Download Bluesky video |
+| `tools.downloadFacebookVideo()` | Download Facebook video |
+| `tools.downloadInstagramMedia()` | Download Instagram reel or post |
+| `tools.downloadLinkedInVideo()` | Download LinkedIn video |
+| `tools.downloadTikTokVideo()` | Download TikTok video |
+| `tools.downloadTwitterMedia()` | Download Twitter/X video |
+| `tools.downloadYouTubeVideo()` | Download YouTube video or audio |
+
+### Users
+| Method | Description |
+|--------|-------------|
+| `users.listUsers()` | List team users (root + invited) |
+| `users.getUser()` | Get user by id (self or invited) |
+
+### Usage
+| Method | Description |
+|--------|-------------|
+| `usage.getUsageStats()` | Get plan and usage stats for current account |
+
+### Logs
+| Method | Description |
+|--------|-------------|
+| `logs.listLogs()` | Get publishing logs |
+| `logs.getLog()` | Get a single log entry |
+| `logs.getPostLogs()` | Get logs for a specific post |
+
+### Connect (OAuth)
+| Method | Description |
+|--------|-------------|
+| `connect.listFacebookPages()` | List Facebook Pages after OAuth (Headless Mode) |
+| `connect.listGoogleBusinessLocations()` | List Google Business Locations after OAuth (Headless Mode) |
+| `connect.listLinkedInOrganizations()` | Fetch full LinkedIn organization details (Headless Mode) |
+| `connect.listPinterestBoardsForSelection()` | List Pinterest Boards after OAuth (Headless Mode) |
+| `connect.listSnapchatProfiles()` | List Snapchat Public Profiles after OAuth (Headless Mode) |
+| `connect.getConnectUrl()` | Start OAuth connection for a platform |
+| `connect.getLinkedInOrganizations()` | Get available LinkedIn organizations for a connected account |
+| `connect.getPinterestBoards()` | List Pinterest boards for a connected account |
+| `connect.getRedditSubreddits()` | List Reddit subreddits for a connected account |
+| `connect.getTelegramConnectStatus()` | Generate Telegram access code |
+| `connect.updateFacebookPage()` | Update selected Facebook page for a connected account |
+| `connect.updateLinkedInOrganization()` | Switch LinkedIn account type (personal/organization) |
+| `connect.updatePinterestBoards()` | Set default Pinterest board on the connection |
+| `connect.updateRedditSubreddits()` | Set default subreddit on the connection |
+| `connect.completeTelegramConnect()` | Check Telegram connection status |
+| `connect.connectBlueskyCredentials()` | Connect Bluesky using app password |
+| `connect.handleOAuthCallback()` | Complete OAuth token exchange manually (for server-side flows) |
+| `connect.initiateTelegramConnect()` | Direct Telegram connection (power users) |
+| `connect.selectFacebookPage()` | Select a Facebook Page to complete the connection (Headless Mode) |
+| `connect.selectGoogleBusinessLocation()` | Select a Google Business location to complete the connection (Headless Mode) |
+| `connect.selectLinkedInOrganization()` | Select LinkedIn organization or personal account after OAuth |
+| `connect.selectPinterestBoard()` | Select a Pinterest Board to complete the connection (Headless Mode) |
+| `connect.selectSnapchatProfile()` | Select a Snapchat Public Profile to complete the connection (Headless Mode) |
+
+### Reddit
+| Method | Description |
+|--------|-------------|
+| `reddit.getRedditFeed()` | Fetch subreddit feed via a connected account |
+| `reddit.searchReddit()` | Search Reddit posts via a connected account |
+
+### Invites
+| Method | Description |
+|--------|-------------|
+| `invites.listPlatformInvites()` | List platform connection invites |
+| `invites.createInviteToken()` | Create a team member invite token |
+| `invites.createPlatformInvite()` | Create a platform connection invite |
+| `invites.deletePlatformInvite()` | Revoke a platform connection invite |
 
 ## Requirements
 
-- Node.js 18 or later
-- An API key from [Late](https://getlate.dev)
+- Node.js 18+
+- [Late API key](https://getlate.dev) (free tier available)
+
+## Links
+
+- [Documentation](https://docs.getlate.dev)
+- [Dashboard](https://getlate.dev/dashboard)
+- [Changelog](https://docs.getlate.dev/changelog)
 
 ## License