@getlatedev/node 0.2.908 → 0.2.910

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
@@ -8296,6 +8296,9 @@ type PostAnalytics = {
8296
8296
  * Number of saves/bookmarks (Instagram, Pinterest, X)
8297
8297
  */
8298
8298
  saves?: number;
8299
+ /**
8300
+ * Link clicks where the platform reports them. Always 0 on Facebook Page stories: Meta exposes no link-click metric for stories.
8301
+ */
8299
8302
  clicks?: number;
8300
8303
  views?: number;
8301
8304
  /**
@@ -16918,7 +16921,7 @@ type GetConnectUrlData = {
16918
16921
  * After your framework decodes the query string once, run one more decodeURIComponent (or
16919
16922
  * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
16920
16923
  *
16921
- * `missing_google_permissions` (YouTube and Google Business) means the user unchecked one or more
16924
+ * `missing_google_permissions` (YouTube, Google Business and Google Ads) means the user unchecked one or more
16922
16925
  * permissions on Google's consent screen. It always comes with `is_user_fixable=true`. When Google
16923
16926
  * reported the granted scopes, `missing_scopes` is also present: a comma-separated list of the
16924
16927
  * requested Google scopes that were not granted. Ask the user to connect again and keep every
package/dist/index.d.ts CHANGED
@@ -8296,6 +8296,9 @@ type PostAnalytics = {
8296
8296
  * Number of saves/bookmarks (Instagram, Pinterest, X)
8297
8297
  */
8298
8298
  saves?: number;
8299
+ /**
8300
+ * Link clicks where the platform reports them. Always 0 on Facebook Page stories: Meta exposes no link-click metric for stories.
8301
+ */
8299
8302
  clicks?: number;
8300
8303
  views?: number;
8301
8304
  /**
@@ -16918,7 +16921,7 @@ type GetConnectUrlData = {
16918
16921
  * After your framework decodes the query string once, run one more decodeURIComponent (or
16919
16922
  * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
16920
16923
  *
16921
- * `missing_google_permissions` (YouTube and Google Business) means the user unchecked one or more
16924
+ * `missing_google_permissions` (YouTube, Google Business and Google Ads) means the user unchecked one or more
16922
16925
  * permissions on Google's consent screen. It always comes with `is_user_fixable=true`. When Google
16923
16926
  * reported the granted scopes, `missing_scopes` is also present: a comma-separated list of the
16924
16927
  * requested Google scopes that were not granted. Ask the user to connect again and keep every
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.908",
39
+ version: "0.2.910",
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.908",
8
+ version: "0.2.910",
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.908",
3
+ "version": "0.2.910",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -79,6 +79,8 @@ export const validateSubreddit = <ThrowOnError extends boolean = false>(options:
79
79
  *
80
80
  * LinkedIn personal accounts: Analytics are only available for posts published through Zernio. LinkedIn's API only returns metrics for posts authored by the authenticated user. Organization/company page analytics work for all posts.
81
81
  *
82
+ * Facebook Page stories: stories on a connected Page, published through Zernio or natively, are collected while they are live and returned like any other post (platformPostUrl points to the story). Their lifetime metrics refresh about hourly, with a final reading shortly before the story expires at 24 hours; after that the values stay at that last reading. Mapping: impressions = story impressions, reach = story reach, views = story media views, likes = story reactions, comments = story replies, shares = story shares. Meta exposes no link-click metric for stories, so clicks is always 0. Metrics for a story published through Zernio are available on its Zernio post ID.
83
+ *
82
84
  */
83
85
  export const getAnalytics = <ThrowOnError extends boolean = false>(options?: OptionsLegacyParser<GetAnalyticsData, ThrowOnError>) => {
84
86
  return (options?.client ?? client).get<GetAnalyticsResponse, GetAnalyticsError, ThrowOnError>({
@@ -1715,7 +1717,11 @@ export const handleOAuthCallback = <ThrowOnError extends boolean = false>(option
1715
1717
  * `error=google_ads_no_ad_accounts`, `platform=googleads` and an `error_message` naming each
1716
1718
  * customer the Google user can reach and why it was left out (for example
1717
1719
  * CUSTOMER_NOT_ENABLED). Sign in with a Google user that has access to the ad account or to
1718
- * its manager account.
1720
+ * its manager account. When the user unticks the Google Ads permission on Google's consent
1721
+ * screen, the callback saves nothing and redirects with `error=missing_google_permissions`,
1722
+ * `platform=googleads`, `is_user_fixable=true` and `missing_scopes`. An existing connection
1723
+ * whose token lacks that permission is flagged needsReconnection, and the health endpoints
1724
+ * report "Google Ads permission not granted"; this endpoint then returns an authUrl for it.
1719
1725
  *
1720
1726
  * Ads accounts appear as regular SocialAccount documents with ads platform values (e.g., metaads, tiktokads) in GET /v1/accounts.
1721
1727
  *
@@ -6879,6 +6879,9 @@ export type PostAnalytics = {
6879
6879
  * Number of saves/bookmarks (Instagram, Pinterest, X)
6880
6880
  */
6881
6881
  saves?: number;
6882
+ /**
6883
+ * Link clicks where the platform reports them. Always 0 on Facebook Page stories: Meta exposes no link-click metric for stories.
6884
+ */
6882
6885
  clicks?: number;
6883
6886
  views?: number;
6884
6887
  /**
@@ -15959,7 +15962,7 @@ export type GetConnectUrlData = {
15959
15962
  * After your framework decodes the query string once, run one more decodeURIComponent (or
15960
15963
  * equivalent) and then JSON.parse it. `tempToken` and `connect_token` are plain values.
15961
15964
  *
15962
- * `missing_google_permissions` (YouTube and Google Business) means the user unchecked one or more
15965
+ * `missing_google_permissions` (YouTube, Google Business and Google Ads) means the user unchecked one or more
15963
15966
  * permissions on Google's consent screen. It always comes with `is_user_fixable=true`. When Google
15964
15967
  * reported the granted scopes, `missing_scopes` is also present: a comma-separated list of the
15965
15968
  * requested Google scopes that were not granted. Ask the user to connect again and keep every