@getlatedev/node 0.2.1231 → 0.2.1233

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
@@ -11538,7 +11538,12 @@ type PostRetryResponse = {
11538
11538
  };
11539
11539
  type PostsListResponse = {
11540
11540
  posts?: Array<Post>;
11541
- pagination?: Pagination;
11541
+ pagination?: (Pagination & {
11542
+ /**
11543
+ * Cursor for the next page in the same sortBy order. Send it back as `cursor`. Null on the last page, and always null for `sortBy=status` or `sortBy=platform`. Absent for `source=external`.
11544
+ */
11545
+ nextCursor?: (string) | null;
11546
+ });
11542
11547
  };
11543
11548
  type PostUpdateResponse = {
11544
11549
  message?: string;
@@ -19015,9 +19020,9 @@ type GetInstagramAccountInsightsData = {
19015
19020
  /**
19016
19021
  * Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions".
19017
19022
  * Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares,
19018
- * replies, reposts, follows_and_unfollows, profile_links_taps.
19023
+ * replies, reposts, follows_and_unfollows, profile_links_taps, profile_views, website_clicks.
19019
19024
  * Note: only "reach" supports metricType=time_series. All other metrics (including
19020
- * follows_and_unfollows) are total_value only. This is an Instagram Graph API limitation,
19025
+ * follows_and_unfollows, profile_views and website_clicks) are total_value only. This is an Instagram Graph API limitation,
19021
19026
  * not a Zernio limitation - the IG API does not return time-series data for these metrics.
19022
19027
  * For a daily running follower count, use /v1/analytics/instagram/follower-history instead.
19023
19028
  *
@@ -20477,6 +20482,10 @@ type ListPostsData = {
20477
20482
  * Filter posts to those created by a specific team user (24-char hex ObjectId).
20478
20483
  */
20479
20484
  createdBy?: string;
20485
+ /**
20486
+ * Opaque cursor from a previous response's `pagination.nextCursor`. Returns the page that follows it in the same `sortBy` order, and takes precedence over `page` and `offset`. Each cursor page costs the same however deep it is, unlike `page`/`offset`, which get slower the further you go; prefer it to walk a long history. Send the same filters and `sortBy` as the request that issued it: a cursor from another `sortBy` returns 400. Not available with `sortBy=status` or `sortBy=platform`, or with `source=external`.
20487
+ */
20488
+ cursor?: string;
20480
20489
  /**
20481
20490
  * Alias of fromDate, kept for existing callers
20482
20491
  * @deprecated
@@ -20487,6 +20496,10 @@ type ListPostsData = {
20487
20496
  * @deprecated
20488
20497
  */
20489
20498
  dateTo?: string;
20499
+ /**
20500
+ * Comma-separated list of post fields to return. Each post then carries `_id` plus only these fields, which makes large pages much cheaper: leave out `platforms`, `content`, `mediaItems` or `metadata` when you do not need them. Accepted: `userId`, `title`, `content`, `mediaItems`, `platforms`, `scheduledFor`, `timezone`, `status`, `tags`, `hashtags`, `mentions`, `visibility`, `metadata`, `recycling`, `recycledFromPostId`, `queuedFromProfile`, `queueId`, `createdAt`, `updatedAt`. An unknown field returns 400 naming it. `fields=_id` returns ids only. Omit it (or send it empty) for the full post. Not available with `source=external`.
20501
+ */
20502
+ fields?: string;
20490
20503
  /**
20491
20504
  * Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400. The same name the other date-window filters use (ads, analytics).
20492
20505
  */
package/dist/index.d.ts CHANGED
@@ -11538,7 +11538,12 @@ type PostRetryResponse = {
11538
11538
  };
11539
11539
  type PostsListResponse = {
11540
11540
  posts?: Array<Post>;
11541
- pagination?: Pagination;
11541
+ pagination?: (Pagination & {
11542
+ /**
11543
+ * Cursor for the next page in the same sortBy order. Send it back as `cursor`. Null on the last page, and always null for `sortBy=status` or `sortBy=platform`. Absent for `source=external`.
11544
+ */
11545
+ nextCursor?: (string) | null;
11546
+ });
11542
11547
  };
11543
11548
  type PostUpdateResponse = {
11544
11549
  message?: string;
@@ -19015,9 +19020,9 @@ type GetInstagramAccountInsightsData = {
19015
19020
  /**
19016
19021
  * Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions".
19017
19022
  * Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares,
19018
- * replies, reposts, follows_and_unfollows, profile_links_taps.
19023
+ * replies, reposts, follows_and_unfollows, profile_links_taps, profile_views, website_clicks.
19019
19024
  * Note: only "reach" supports metricType=time_series. All other metrics (including
19020
- * follows_and_unfollows) are total_value only. This is an Instagram Graph API limitation,
19025
+ * follows_and_unfollows, profile_views and website_clicks) are total_value only. This is an Instagram Graph API limitation,
19021
19026
  * not a Zernio limitation - the IG API does not return time-series data for these metrics.
19022
19027
  * For a daily running follower count, use /v1/analytics/instagram/follower-history instead.
19023
19028
  *
@@ -20477,6 +20482,10 @@ type ListPostsData = {
20477
20482
  * Filter posts to those created by a specific team user (24-char hex ObjectId).
20478
20483
  */
20479
20484
  createdBy?: string;
20485
+ /**
20486
+ * Opaque cursor from a previous response's `pagination.nextCursor`. Returns the page that follows it in the same `sortBy` order, and takes precedence over `page` and `offset`. Each cursor page costs the same however deep it is, unlike `page`/`offset`, which get slower the further you go; prefer it to walk a long history. Send the same filters and `sortBy` as the request that issued it: a cursor from another `sortBy` returns 400. Not available with `sortBy=status` or `sortBy=platform`, or with `source=external`.
20487
+ */
20488
+ cursor?: string;
20480
20489
  /**
20481
20490
  * Alias of fromDate, kept for existing callers
20482
20491
  * @deprecated
@@ -20487,6 +20496,10 @@ type ListPostsData = {
20487
20496
  * @deprecated
20488
20497
  */
20489
20498
  dateTo?: string;
20499
+ /**
20500
+ * Comma-separated list of post fields to return. Each post then carries `_id` plus only these fields, which makes large pages much cheaper: leave out `platforms`, `content`, `mediaItems` or `metadata` when you do not need them. Accepted: `userId`, `title`, `content`, `mediaItems`, `platforms`, `scheduledFor`, `timezone`, `status`, `tags`, `hashtags`, `mentions`, `visibility`, `metadata`, `recycling`, `recycledFromPostId`, `queuedFromProfile`, `queueId`, `createdAt`, `updatedAt`. An unknown field returns 400 naming it. `fields=_id` returns ids only. Omit it (or send it empty) for the full post. Not available with `source=external`.
20501
+ */
20502
+ fields?: string;
20490
20503
  /**
20491
20504
  * Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400. The same name the other date-window filters use (ads, analytics).
20492
20505
  */
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.1231",
39
+ version: "0.2.1233",
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.1231",
8
+ version: "0.2.1233",
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.1231",
3
+ "version": "0.2.1233",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -3064,8 +3064,10 @@ export const getInstagramBusinessDiscovery = <ThrowOnError extends boolean = fal
3064
3064
  * - `live`: fetched from Meta in real time (story is still active)
3065
3065
  * - `cached`: fetched from a persisted `story_insights` webhook payload
3066
3066
  * (story has expired but we received its final-state metrics from Meta)
3067
- * - `unavailable`: story has expired and we never received its webhook
3068
- * payload (for example, the account connected after the story expired)
3067
+ * - `unavailable`: story has expired and Meta sent no `story_insights` webhook for it.
3068
+ * Meta sends it most reliably for accounts connected with Facebook Login or with their
3069
+ * linked Facebook Page connected, so read insights while the story is live if you need
3070
+ * final numbers.
3069
3071
  *
3070
3072
  * Meta can report an expired story as an empty successful result rather
3071
3073
  * than an error, so an expired story resolves to `cached` or `unavailable`
@@ -9934,7 +9934,12 @@ export type PostRetryResponse = {
9934
9934
 
9935
9935
  export type PostsListResponse = {
9936
9936
  posts?: Array<Post>;
9937
- pagination?: Pagination;
9937
+ pagination?: (Pagination & {
9938
+ /**
9939
+ * Cursor for the next page in the same sortBy order. Send it back as `cursor`. Null on the last page, and always null for `sortBy=status` or `sortBy=platform`. Absent for `source=external`.
9940
+ */
9941
+ nextCursor?: (string) | null;
9942
+ });
9938
9943
  };
9939
9944
 
9940
9945
  export type PostUpdateResponse = {
@@ -17750,9 +17755,9 @@ export type GetInstagramAccountInsightsData = {
17750
17755
  /**
17751
17756
  * Comma-separated list of metrics. Defaults to "reach,views,accounts_engaged,total_interactions".
17752
17757
  * Valid metrics: reach, views, accounts_engaged, total_interactions, comments, likes, saves, shares,
17753
- * replies, reposts, follows_and_unfollows, profile_links_taps.
17758
+ * replies, reposts, follows_and_unfollows, profile_links_taps, profile_views, website_clicks.
17754
17759
  * Note: only "reach" supports metricType=time_series. All other metrics (including
17755
- * follows_and_unfollows) are total_value only. This is an Instagram Graph API limitation,
17760
+ * follows_and_unfollows, profile_views and website_clicks) are total_value only. This is an Instagram Graph API limitation,
17756
17761
  * not a Zernio limitation - the IG API does not return time-series data for these metrics.
17757
17762
  * For a daily running follower count, use /v1/analytics/instagram/follower-history instead.
17758
17763
  *
@@ -19317,6 +19322,10 @@ export type ListPostsData = {
19317
19322
  * Filter posts to those created by a specific team user (24-char hex ObjectId).
19318
19323
  */
19319
19324
  createdBy?: string;
19325
+ /**
19326
+ * Opaque cursor from a previous response's `pagination.nextCursor`. Returns the page that follows it in the same `sortBy` order, and takes precedence over `page` and `offset`. Each cursor page costs the same however deep it is, unlike `page`/`offset`, which get slower the further you go; prefer it to walk a long history. Send the same filters and `sortBy` as the request that issued it: a cursor from another `sortBy` returns 400. Not available with `sortBy=status` or `sortBy=platform`, or with `source=external`.
19327
+ */
19328
+ cursor?: string;
19320
19329
  /**
19321
19330
  * Alias of fromDate, kept for existing callers
19322
19331
  * @deprecated
@@ -19327,6 +19336,10 @@ export type ListPostsData = {
19327
19336
  * @deprecated
19328
19337
  */
19329
19338
  dateTo?: string;
19339
+ /**
19340
+ * Comma-separated list of post fields to return. Each post then carries `_id` plus only these fields, which makes large pages much cheaper: leave out `platforms`, `content`, `mediaItems` or `metadata` when you do not need them. Accepted: `userId`, `title`, `content`, `mediaItems`, `platforms`, `scheduledFor`, `timezone`, `status`, `tags`, `hashtags`, `mentions`, `visibility`, `metadata`, `recycling`, `recycledFromPostId`, `queuedFromProfile`, `queueId`, `createdAt`, `updatedAt`. An unknown field returns 400 naming it. `fields=_id` returns ids only. Omit it (or send it empty) for the full post. Not available with `source=external`.
19341
+ */
19342
+ fields?: string;
19330
19343
  /**
19331
19344
  * Zero-padded YYYY-MM-DD, or a full ISO 8601 datetime. An empty value means no date filter; any other malformed value returns 400. The same name the other date-window filters use (ads, analytics).
19332
19345
  */