@getlatedev/node 0.2.1099 → 0.2.1101

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.
@@ -1501,7 +1501,7 @@ export const getInstagramFollowStatus = <ThrowOnError extends boolean = false>(o
1501
1501
 
1502
1502
  /**
1503
1503
  * List trending commercial music
1504
- * Returns the 100 currently trending tracks of TikTok's Commercial Music Library for a TikTok account connected through the TikTok for Business app. Use a track id as tiktokSettings.musicSoundInfo.musicSoundId when creating a post. The list is not paged; countryCode selects the country chart.
1504
+ * Returns the 100 currently trending tracks of TikTok's Commercial Music Library for a TikTok account connected through the TikTok for Business app. Send a track's clip.id as tiktokSettings.musicSoundInfo.musicSoundId when creating a post; fall back to id only when the track has no clip. Both publish, but with the full-track id TikTok has shown viewers "This song is not available in your country" on the sound page (observed from Germany, 2026-10-06), while the clip id gave a working sound page for the same track. The list is not paged; countryCode selects the country chart.
1505
1505
  */
1506
1506
  export const listTikTokCommercialMusic = <ThrowOnError extends boolean = false>(options: OptionsLegacyParser<ListTikTokCommercialMusicData, ThrowOnError>) => {
1507
1507
  return (options?.client ?? client).get<ListTikTokCommercialMusicResponse, ListTikTokCommercialMusicError, ThrowOnError>({
@@ -7861,7 +7861,7 @@ export type duration = 'ONE_DAY' | 'THREE_DAYS' | 'SEVEN_DAYS' | 'FOURTEEN_DAYS'
7861
7861
  /**
7862
7862
  * MIME type of the file to upload. Rejected with a 400 (INVALID_FIELD_VALUE on contentType) when it is not one of these values, so generic types such as application/octet-stream are not accepted here.
7863
7863
  */
7864
- export type MediaContentType = 'image/jpeg' | 'image/jpg' | 'image/png' | 'image/webp' | 'image/gif' | 'video/mp4' | 'video/mpeg' | 'video/quicktime' | 'video/avi' | 'video/x-msvideo' | 'video/webm' | 'video/x-m4v' | 'application/pdf' | 'audio/mpeg' | 'audio/mp4' | 'audio/aac' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/x-m4a';
7864
+ export type MediaContentType = 'image/jpeg' | 'image/jpg' | 'image/png' | 'image/webp' | 'image/gif' | 'video/mp4' | 'video/mpeg' | 'video/quicktime' | 'video/avi' | 'video/x-msvideo' | 'video/webm' | 'video/x-m4v' | 'application/pdf' | 'audio/mpeg' | 'audio/mp4' | 'audio/aac' | 'audio/ogg' | 'audio/wav' | 'audio/webm' | 'audio/x-m4a' | 'application/x-subrip' | 'text/vtt';
7865
7865
 
7866
7866
  /**
7867
7867
  * Media referenced in posts. URLs must be publicly reachable over HTTPS. Use POST /v1/media/presign for uploads up to 5GB. Zernio auto-compresses images and videos that exceed platform limits (videos over 200 MB may not be compressed).
@@ -7897,6 +7897,10 @@ export type MediaItem = {
7897
7897
  * Custom cover image URL for Instagram Reels. Can also be set via platformSpecificData.instagramThumbnail or platformSpecificData.reelCover. Resolution order: this field > platformSpecificData.instagramThumbnail > platformSpecificData.reelCover > platformSpecificData.thumbnailUrl (legacy).
7898
7898
  */
7899
7899
  instagramThumbnail?: string;
7900
+ /**
7901
+ * Subtitle (closed caption) files for a video item, in SRT or WebVTT. Each language may appear once per video. Sent to YouTube, Facebook videos, LinkedIn, X and Bluesky; ignored with a warning on every other platform. Zernio downloads each file when the post is created or updated and converts it to the format each platform requires. Per-platform rules: YouTube takes every track; Facebook takes every track, up to 200 KB each; Bluesky takes every track, up to 20 KB each after conversion to WebVTT; X takes the first track only (one subtitle per video); LinkedIn takes the first English track only. Tracks a platform cannot take are skipped and reported in the response warnings. A file that is unreachable, redirects, exceeds 1 MB, is not valid SRT or WebVTT, or is over a platform limit is rejected with a 400 (code INVALID_SUBTITLES). If a platform rejects a file at publish time, the post is still published, without subtitles.
7902
+ */
7903
+ subtitles?: Array<MediaSubtitle>;
7900
7904
  /**
7901
7905
  * Internal flag indicating the image was resized for TikTok
7902
7906
  */
@@ -7905,6 +7909,17 @@ export type MediaItem = {
7905
7909
 
7906
7910
  export type type11 = 'image' | 'video' | 'gif' | 'document';
7907
7911
 
7912
+ export type MediaSubtitle = {
7913
+ /**
7914
+ * Public http(s) URL of an SRT or WebVTT file: your own host, or an upload from POST /v1/media/presign (contentType application/x-subrip or text/vtt). It must serve the file directly, since redirects are refused.
7915
+ */
7916
+ url: string;
7917
+ /**
7918
+ * BCP-47 language code with a two-letter language, e.g. en, es or pt-BR. Viewers see the track labelled with the language name, e.g. English.
7919
+ */
7920
+ language: string;
7921
+ };
7922
+
7908
7923
  export type MediaUploadResponse = {
7909
7924
  files?: Array<UploadedFile>;
7910
7925
  };
@@ -10613,7 +10628,7 @@ export type TikTokPlatformData = {
10613
10628
  */
10614
10629
  musicSoundInfo?: {
10615
10630
  /**
10616
- * The id field of a track from GET /v1/accounts/{accountId}/tiktok/commercial-music (a song clip id). TikTok fails the publish with a generic 51065 when given the commercial music id instead.
10631
+ * The clip.id of a track from GET /v1/accounts/{accountId}/tiktok/commercial-music (its id publishes too, but viewers may see the sound as unavailable in their country; observed from Germany). TikTok fails the publish with a generic 51065 when given the commercial music id instead.
10617
10632
  */
10618
10633
  musicSoundId: string;
10619
10634
  /**
@@ -18894,7 +18909,7 @@ export type ListTikTokCommercialMusicData = {
18894
18909
  export type ListTikTokCommercialMusicResponse = ({
18895
18910
  tracks?: Array<{
18896
18911
  /**
18897
- * The id to send as musicSoundId (the full track's song clip id). TikTok rejects the commercial music id itself at publish time.
18912
+ * The full track's song clip id. Accepted as musicSoundId, but prefer clip.id: posts published with this id have shown viewers a sound page saying the song is not available in their country (observed from Germany). TikTok rejects the commercial music id itself at publish time.
18898
18913
  */
18899
18914
  id?: string;
18900
18915
  /**
@@ -18915,7 +18930,7 @@ export type ListTikTokCommercialMusicResponse = ({
18915
18930
  */
18916
18931
  rank?: number;
18917
18932
  /**
18918
- * The trending excerpt of the track, when TikTok provides one. Its id is also accepted as musicSoundId.
18933
+ * The trending excerpt of the track, when TikTok provides one. Send clip.id as musicSoundId: it publishes and its sound page opens for viewers, unlike the full-track id (observed from Germany, 2026-10-06).
18919
18934
  */
18920
18935
  clip?: {
18921
18936
  id?: string;