@getlatedev/node 0.1.22 → 0.1.24

This diff represents the content of publicly available package versions that have been released to one of the supported registries. The information contained in this diff is provided for informational purposes only and reflects changes between package versions as they appear in their respective public registries.
@@ -661,42 +661,14 @@ export type LinkedInPlatformData = {
661
661
 
662
662
  /**
663
663
  * Media referenced in posts. URLs must be publicly reachable over HTTPS by the destination platforms.
664
- * When using thirdparty storage, ensure signed links remain valid until upload completes.
664
+ * When using third-party storage, ensure signed links remain valid until upload completes.
665
665
  *
666
666
  * **Uploading Media:**
667
667
  * Use `POST /v1/media/presign` to get a presigned URL, then upload your file directly to cloud storage.
668
668
  * Supports files up to 5GB. See the `/v1/media/presign` endpoint documentation for details.
669
669
  *
670
670
  * **Automatic Media Compression:**
671
- * Late automatically compresses media that exceeds platform limits, so you don't need to worry about file size restrictions. Compression happens server-side during publishing.
672
- *
673
- * **Image compression by platform:**
674
- * - Twitter/X: >5 MB
675
- * - Instagram: >8 MB
676
- * - Threads: >8 MB
677
- * - Facebook: >10 MB
678
- * - LinkedIn: >8 MB
679
- * - TikTok: >20 MB
680
- * - Pinterest: >32 MB
681
- * - Reddit: >20 MB
682
- * - Snapchat: >20 MB
683
- * - Telegram: >10 MB
684
- * - Bluesky: >1 MB
685
- * - YouTube (thumbnails): >2 MB
686
- * - Google Business: >5 MB
687
- *
688
- * **Video compression by platform:**
689
- * - Twitter/X: >512 MB
690
- * - Instagram Stories: >100 MB
691
- * - Instagram Reels: >300 MB
692
- * - Facebook: >4 GB
693
- * - LinkedIn: >5 GB
694
- * - TikTok: >4 GB
695
- * - Pinterest: >2 GB
696
- * - Snapchat: >500 MB
697
- * - Telegram: >50 MB
698
- *
699
- * Note: Videos larger than 200 MB may not be compressed due to server timeout constraints. For best results, compress very large videos before uploading.
671
+ * Late automatically compresses images and videos that exceed platform limits. Compression happens server-side during publishing. Videos larger than 200 MB may not be compressed due to server timeout constraints.
700
672
  *
701
673
  */
702
674
  export type MediaItem = {
@@ -1271,27 +1243,11 @@ export type RedditPlatformData = {
1271
1243
  };
1272
1244
 
1273
1245
  /**
1274
- * Snapchat Public Profile API constraints:
1275
- *
1276
- * **General Requirements:**
1277
- * - Snapchat requires a Public Profile to publish content
1278
- * - Media is required for all content types (no text-only posts)
1279
- * - Only one media item per post is supported
1280
- * - Media is automatically encrypted using AES-256-CBC before upload
1246
+ * Snapchat requires a Public Profile. Media is required for all content types (single item only, auto-encrypted before upload).
1281
1247
  *
1282
- * **Content Types:**
1283
- * - **Story** (default): Ephemeral content visible for 24 hours. No caption/text supported.
1284
- * - **Saved Story**: Permanent story on your Public Profile. Uses post content as title (max 45 chars).
1285
- * - **Spotlight**: Video content for Snapchat's entertainment feed. Supports description (max 160 chars) with hashtags.
1248
+ * **Content types:** Story (ephemeral 24h, no caption), Saved Story (permanent, title max 45 chars), Spotlight (video, description max 160 chars).
1286
1249
  *
1287
- * **Media Constraints:**
1288
- * - Images: max 20 MB, JPEG/PNG format
1289
- * - Videos: max 500 MB, MP4 format, 5-60 seconds duration, minimum 540x960px resolution
1290
- * - Aspect ratio: 9:16 recommended
1291
- *
1292
- * **Analytics:**
1293
- * - Views, screenshots, shares, unique viewers, completion rate available
1294
- * - Analytics are fetched per content type (story/saved_story/spotlight)
1250
+ * **Media limits:** Images max 20 MB (JPEG/PNG), videos max 500 MB (MP4, 5-60s, min 540x960px, 9:16 recommended).
1295
1251
  *
1296
1252
  */
1297
1253
  export type SnapchatPlatformData = {
@@ -3161,35 +3117,11 @@ export type GetConnectUrlData = {
3161
3117
  */
3162
3118
  profileId: string;
3163
3119
  /**
3164
- * Optional: Your custom redirect URL after connection completes.
3165
- *
3166
- * **Standard Mode:** Omit `headless=true` to use our hosted page selection UI.
3167
- * After the user selects a Facebook Page, Late redirects here with:
3168
- * `?connected=facebook&profileId=X&username=Y`
3120
+ * Your custom redirect URL after connection completes.
3169
3121
  *
3170
- * **Headless Mode (Facebook, LinkedIn, Pinterest, Google Business Profile & Snapchat):**
3171
- * Pass `headless=true` as a query parameter on this endpoint (not inside `redirect_url`), e.g.:
3172
- * `GET /v1/connect/facebook?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
3173
- * `GET /v1/connect/linkedin?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
3174
- * `GET /v1/connect/pinterest?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
3175
- * `GET /v1/connect/googlebusiness?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
3176
- * `GET /v1/connect/snapchat?profileId=PROFILE_ID&redirect_url=https://yourapp.com/callback&headless=true`
3122
+ * **Standard Mode:** After the user selects an account, Late redirects here with `?connected={platform}&profileId=X&username=Y`.
3177
3123
  *
3178
- * After OAuth, the user is redirected directly to your `redirect_url` with OAuth data:
3179
- * - **Facebook:** `?profileId=X&tempToken=Y&userProfile=Z&connect_token=CT&platform=facebook&step=select_page`
3180
- * - **LinkedIn:** `?profileId=X&pendingDataToken=TOKEN&connect_token=CT&platform=linkedin&step=select_organization`
3181
- * Use `GET /v1/connect/pending-data?token=TOKEN` to fetch tempToken, userProfile, organizations, refreshToken.
3182
- * - **Pinterest:** `?profileId=X&tempToken=Y&userProfile=Z&connect_token=CT&platform=pinterest&step=select_board`
3183
- * - **Google Business:** `?profileId=X&tempToken=Y&userProfile=Z&connect_token=CT&platform=googlebusiness&step=select_location`
3184
- * - **Snapchat:** `?profileId=X&tempToken=Y&userProfile=Z&publicProfiles=PROFILES&connect_token=CT&platform=snapchat&step=select_public_profile`
3185
- * (publicProfiles contains `id`, `display_name`, `username`, `profile_image_url`, `subscriber_count`)
3186
- *
3187
- * Then use the respective endpoints to build your custom UI:
3188
- * - Facebook: `/v1/connect/facebook/select-page` (GET to fetch, POST to save)
3189
- * - LinkedIn: `/v1/connect/linkedin/organizations` (GET to fetch logos), `/v1/connect/linkedin/select-organization` (POST to save)
3190
- * - Pinterest: `/v1/connect/pinterest/select-board` (GET to fetch, POST to save)
3191
- * - Google Business: `/v1/connect/googlebusiness/locations` (GET) and `/v1/connect/googlebusiness/select-location` (POST)
3192
- * - Snapchat: `/v1/connect/snapchat/select-profile` (POST to save selected public profile)
3124
+ * **Headless Mode:** Pass `headless=true` as a query parameter on this endpoint. After OAuth, the user is redirected to your URL with OAuth data (`profileId`, `tempToken`, `userProfile`, `connect_token`, `platform`, `step`). See the main endpoint description for details.
3193
3125
  *
3194
3126
  * Example: `https://yourdomain.com/integrations/callback`
3195
3127
  *
@@ -6112,6 +6044,11 @@ export type GetInboxPostCommentsData = {
6112
6044
  path: {
6113
6045
  /**
6114
6046
  * The post identifier. Accepts a Late post ID (MongoDB ObjectId) which is automatically resolved to the platform-specific post ID, or a platform-specific post ID directly (e.g. tweet ID, Facebook Graph ID, YouTube video ID).
6047
+ *
6048
+ * **LinkedIn:** For your own posts, the full URN stored in Late (e.g., `urn:li:share:7429218977714745345`) is used automatically.
6049
+ * For third-party posts, pass either the full activity URN (e.g., `urn:li:activity:7422459067685855232`) or the raw numeric activity ID from the LinkedIn URL (automatically wrapped as `urn:li:activity:`).
6050
+ * Note: LinkedIn post URLs use activity IDs (`linkedin.com/feed/update/urn:li:activity:XXXX`).
6051
+ *
6115
6052
  */
6116
6053
  postId: string;
6117
6054
  };
@@ -6249,6 +6186,9 @@ export type ReplyToInboxPostData = {
6249
6186
  path: {
6250
6187
  /**
6251
6188
  * The post identifier. Accepts a Late post ID or a platform-specific post ID.
6189
+ *
6190
+ * **LinkedIn:** For third-party posts, pass the full activity URN (e.g., `urn:li:activity:7422459067685855232`) or the raw numeric activity ID from the URL.
6191
+ *
6252
6192
  */
6253
6193
  postId: string;
6254
6194
  };
@@ -6274,6 +6214,9 @@ export type DeleteInboxCommentData = {
6274
6214
  path: {
6275
6215
  /**
6276
6216
  * The post identifier. Accepts a Late post ID or a platform-specific post ID.
6217
+ *
6218
+ * **LinkedIn:** For third-party posts, pass the full activity URN (e.g., `urn:li:activity:7422459067685855232`) or the raw numeric activity ID from the URL.
6219
+ *
6277
6220
  */
6278
6221
  postId: string;
6279
6222
  };