@getlatedev/node 0.2.1215 → 0.2.1217

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.
package/dist/index.d.mts CHANGED
@@ -12342,6 +12342,22 @@ type SocialAccount = {
12342
12342
  *
12343
12343
  */
12344
12344
  enabled?: boolean;
12345
+ /**
12346
+ * End of the account's publishing cooldown. Compare it with the current time: a value
12347
+ * in the past means the cooldown has ended (the field is cleared on the next successful
12348
+ * publish), null means no cooldown since the last successful publish. A cooldown starts
12349
+ * when a post to the account fails with `errorCategory` `user_abuse` (spam, abuse or
12350
+ * rate-limit errors), or when 10 or more posts to it fail within an hour with
12351
+ * `user_content`, `platform_error`, `platform_rate_limit` or `unknown`. It doubles with
12352
+ * each start inside a 24-hour window that opens at the first one (10, 20, 40, 80 minutes
12353
+ * and so on, capped at 24 hours). On a YouTube account with a recorded successful upload
12354
+ * it instead runs until 24 hours after that upload, or 1 hour when that upload is older
12355
+ * than 24 hours. While it is in the future, POST /v1/posts (drafts excepted) and
12356
+ * POST /v1/posts/{postId}/retry return 429 for this account, and this account's pending
12357
+ * targets on posts scheduled before the cooldown ends are failed when it starts.
12358
+ *
12359
+ */
12360
+ rateLimitedUntil?: (string) | null;
12345
12361
  /**
12346
12362
  * Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes:
12347
12363
  * - qualityRating: Phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN)
package/dist/index.d.ts CHANGED
@@ -12342,6 +12342,22 @@ type SocialAccount = {
12342
12342
  *
12343
12343
  */
12344
12344
  enabled?: boolean;
12345
+ /**
12346
+ * End of the account's publishing cooldown. Compare it with the current time: a value
12347
+ * in the past means the cooldown has ended (the field is cleared on the next successful
12348
+ * publish), null means no cooldown since the last successful publish. A cooldown starts
12349
+ * when a post to the account fails with `errorCategory` `user_abuse` (spam, abuse or
12350
+ * rate-limit errors), or when 10 or more posts to it fail within an hour with
12351
+ * `user_content`, `platform_error`, `platform_rate_limit` or `unknown`. It doubles with
12352
+ * each start inside a 24-hour window that opens at the first one (10, 20, 40, 80 minutes
12353
+ * and so on, capped at 24 hours). On a YouTube account with a recorded successful upload
12354
+ * it instead runs until 24 hours after that upload, or 1 hour when that upload is older
12355
+ * than 24 hours. While it is in the future, POST /v1/posts (drafts excepted) and
12356
+ * POST /v1/posts/{postId}/retry return 429 for this account, and this account's pending
12357
+ * targets on posts scheduled before the cooldown ends are failed when it starts.
12358
+ *
12359
+ */
12360
+ rateLimitedUntil?: (string) | null;
12345
12361
  /**
12346
12362
  * Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes:
12347
12363
  * - qualityRating: Phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN)
package/dist/index.js CHANGED
@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
36
36
  // package.json
37
37
  var package_default = {
38
38
  name: "@getlatedev/node",
39
- version: "0.2.1215",
39
+ version: "0.2.1217",
40
40
  description: "The official Node.js library for the Zernio API",
41
41
  main: "dist/index.js",
42
42
  module: "dist/index.mjs",
package/dist/index.mjs CHANGED
@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
5
5
  // package.json
6
6
  var package_default = {
7
7
  name: "@getlatedev/node",
8
- version: "0.2.1215",
8
+ version: "0.2.1217",
9
9
  description: "The official Node.js library for the Zernio API",
10
10
  main: "dist/index.js",
11
11
  module: "dist/index.mjs",
package/package.json CHANGED
@@ -1,6 +1,6 @@
1
1
  {
2
2
  "name": "@getlatedev/node",
3
- "version": "0.2.1215",
3
+ "version": "0.2.1217",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -1020,6 +1020,8 @@ export const createPost = <ThrowOnError extends boolean = false>(options: Option
1020
1020
  *
1021
1021
  * LinkedIn personal profiles: LinkedIn has no listing API for personal profiles, so a `url` is REQUIRED and imports that single post. Pass any LinkedIn post URL (`linkedin.com/posts/…`, `linkedin.com/feed/update/urn:li:activity:…`) or a `urn:li:share:…` / `urn:li:ugcPost:…` URN. Works for posts published outside Zernio and before the account was connected, any age; the post must be authored by the connected member. Imported posts return full analytics (impressions, reach, reactions, comments, reshares, saves) and keep refreshing on the background analytics cycle, but carry no content/media (LinkedIn does not expose them for personal profiles). `publishedAt` comes from the post id: an activity URL (`linkedin.com/feed/update/urn:li:activity:…`) carries the publication time, while a `urn:li:share:…` / `urn:li:ugcPost:…` URN only carries the creation time, which is earlier for a post scheduled in another tool. Pass the activity URL for the exact publication date; importing it again for a post already imported by its URN corrects `publishedAt` on the same record. Right after an import, the per-post `GET /v1/analytics?postId=` read can show zeros for a few minutes while the metrics are ingested; this endpoint's response carries the fetched values immediately.
1022
1022
  *
1023
+ * TikTok Business accounts: a `postId` or TikTok `url` that the listing has not stored is fetched from TikTok and imported as an external post, at any age, with its current metrics.
1024
+ *
1023
1025
  * `url` accepts any format the platform uses (e.g. `instagram.com/p/…`, `instagram.com/reel/…`, `youtu.be/…`, `youtube.com/shorts/…`, `tiktok.com/@user/video/…`, `vm.tiktok.com` short links, `pinterest.com/pin/…` on any regional domain, and `pin.it` short links). Pass `postId` (the platform media/video/pin id) as an alternative locator.
1024
1026
  *
1025
1027
  * Note: post-level analytics (reach, impressions) still carry the platform's own delay (e.g. ~24h on Instagram). This endpoint confirms the post exists and returns its metadata plus basic engagement (likes, comments), not delayed insights.
@@ -10799,6 +10799,22 @@ export type SocialAccount = {
10799
10799
  *
10800
10800
  */
10801
10801
  enabled?: boolean;
10802
+ /**
10803
+ * End of the account's publishing cooldown. Compare it with the current time: a value
10804
+ * in the past means the cooldown has ended (the field is cleared on the next successful
10805
+ * publish), null means no cooldown since the last successful publish. A cooldown starts
10806
+ * when a post to the account fails with `errorCategory` `user_abuse` (spam, abuse or
10807
+ * rate-limit errors), or when 10 or more posts to it fail within an hour with
10808
+ * `user_content`, `platform_error`, `platform_rate_limit` or `unknown`. It doubles with
10809
+ * each start inside a 24-hour window that opens at the first one (10, 20, 40, 80 minutes
10810
+ * and so on, capped at 24 hours). On a YouTube account with a recorded successful upload
10811
+ * it instead runs until 24 hours after that upload, or 1 hour when that upload is older
10812
+ * than 24 hours. While it is in the future, POST /v1/posts (drafts excepted) and
10813
+ * POST /v1/posts/{postId}/retry return 429 for this account, and this account's pending
10814
+ * targets on posts scheduled before the cooldown ends are failed when it starts.
10815
+ *
10816
+ */
10817
+ rateLimitedUntil?: (string) | null;
10802
10818
  /**
10803
10819
  * Platform-specific metadata. Fields vary by platform. For WhatsApp accounts, includes:
10804
10820
  * - qualityRating: Phone number quality rating from Meta (GREEN, YELLOW, RED, or UNKNOWN)