@getlatedev/node 0.2.1122 → 0.2.1124

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
@@ -2010,6 +2010,19 @@ type AccountsListResponse = {
2010
2010
  profileTotals?: {
2011
2011
  [key: string]: (number);
2012
2012
  };
2013
+ /**
2014
+ * Only with includeStatusCounts=true. Counts over every filter of the request except status.
2015
+ */
2016
+ statusCounts?: {
2017
+ /**
2018
+ * Accounts matching the filters in any status.
2019
+ */
2020
+ all: number;
2021
+ /**
2022
+ * Of those, the accounts that need reconnection.
2023
+ */
2024
+ disconnected: number;
2025
+ };
2013
2026
  };
2014
2027
  type AccountWithFollowerStats = SocialAccount & {
2015
2028
  /**
@@ -11978,8 +11991,11 @@ type SocialAccount = {
11978
11991
  /**
11979
11992
  * Whether the user explicitly activated this account. false means the account was
11980
11993
  * created as a side effect (e.g., posting account auto-created when user connected
11981
- * ads first). Such accounts are hidden from this list, cannot be posted to
11982
- * (`ACCOUNT_NOT_ENABLED_FOR_POSTING`), and are not billed as connected accounts.
11994
+ * ads first). GET /v1/accounts still returns such accounts unless `excludeHidden=true`
11995
+ * is passed. They cannot be posted to (`ACCOUNT_NOT_ENABLED_FOR_POSTING`) and are not
11996
+ * billed as connected accounts. On an ads account (`metaads`, `googleads`, ...) the value
11997
+ * does not hide the connection: ads accounts are listed whatever their `enabled` value and
11998
+ * keep working for ads.
11983
11999
  *
11984
12000
  */
11985
12001
  enabled?: boolean;
@@ -20081,10 +20097,35 @@ type ListAccountsData = {
20081
20097
  * Only accounts of this kind. ads = ad accounts (Meta, Google, LinkedIn, Pinterest, TikTok, X, OpenAI), communication = WhatsApp, Telegram, Discord, Slack and iMessage, blogs = Shopify and WordPress, social = every other platform.
20082
20098
  */
20083
20099
  category?: 'social' | 'ads' | 'communication' | 'blogs';
20100
+ /**
20101
+ * When true, leaves out accounts the dashboard does not show as connections: posting
20102
+ * accounts with `enabled: false` (ads accounts are always kept, whatever their `enabled`
20103
+ * value) and the internal `sms` and `phone` accounts behind each phone number. Applied
20104
+ * before pagination, so page totals and `statusCounts` count only the remaining accounts.
20105
+ * Sandbox accounts added by `includeSandbox` are appended after this filter. Accepts
20106
+ * `true` or `false` in any letter case; any other value returns 400.
20107
+ *
20108
+ */
20109
+ excludeHidden?: boolean;
20084
20110
  /**
20085
20111
  * When true, includes accounts from over-limit profiles.
20086
20112
  */
20087
20113
  includeOverLimit?: boolean;
20114
+ /**
20115
+ * When true, appends the shared WhatsApp sandbox account and the iMessage sandbox account
20116
+ * to the list when they are active, honouring `platform` but no other filter. Ignored on
20117
+ * a paginated request (page/limit) and together with `perProfile`. Accepts `true` or
20118
+ * `false` in any letter case; any other value returns 400.
20119
+ *
20120
+ */
20121
+ includeSandbox?: boolean;
20122
+ /**
20123
+ * When true, the response carries `statusCounts`: how many accounts match every other
20124
+ * filter of the request (with `status` lifted) in total and how many of those need a
20125
+ * reconnection. Accepts `true` or `false` in any letter case; any other value returns 400.
20126
+ *
20127
+ */
20128
+ includeStatusCounts?: boolean;
20088
20129
  /**
20089
20130
  * Page size. Must be provided together with page; sending only one of the two returns 400.
20090
20131
  *
@@ -40294,7 +40335,7 @@ type UpdateAdCampaignData = {
40294
40335
  */
40295
40336
  portfolioBidStrategyId?: string;
40296
40337
  /**
40297
- * Google only. Explicitly allow changing a shared campaign budget, affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40338
+ * Google only. Explicitly allow changing a shared campaign budget (flagged as shared by Google, or used by more than one campaign), affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40298
40339
  */
40299
40340
  allowSharedBudgetUpdate?: boolean;
40300
40341
  /**
package/dist/index.d.ts CHANGED
@@ -2010,6 +2010,19 @@ type AccountsListResponse = {
2010
2010
  profileTotals?: {
2011
2011
  [key: string]: (number);
2012
2012
  };
2013
+ /**
2014
+ * Only with includeStatusCounts=true. Counts over every filter of the request except status.
2015
+ */
2016
+ statusCounts?: {
2017
+ /**
2018
+ * Accounts matching the filters in any status.
2019
+ */
2020
+ all: number;
2021
+ /**
2022
+ * Of those, the accounts that need reconnection.
2023
+ */
2024
+ disconnected: number;
2025
+ };
2013
2026
  };
2014
2027
  type AccountWithFollowerStats = SocialAccount & {
2015
2028
  /**
@@ -11978,8 +11991,11 @@ type SocialAccount = {
11978
11991
  /**
11979
11992
  * Whether the user explicitly activated this account. false means the account was
11980
11993
  * created as a side effect (e.g., posting account auto-created when user connected
11981
- * ads first). Such accounts are hidden from this list, cannot be posted to
11982
- * (`ACCOUNT_NOT_ENABLED_FOR_POSTING`), and are not billed as connected accounts.
11994
+ * ads first). GET /v1/accounts still returns such accounts unless `excludeHidden=true`
11995
+ * is passed. They cannot be posted to (`ACCOUNT_NOT_ENABLED_FOR_POSTING`) and are not
11996
+ * billed as connected accounts. On an ads account (`metaads`, `googleads`, ...) the value
11997
+ * does not hide the connection: ads accounts are listed whatever their `enabled` value and
11998
+ * keep working for ads.
11983
11999
  *
11984
12000
  */
11985
12001
  enabled?: boolean;
@@ -20081,10 +20097,35 @@ type ListAccountsData = {
20081
20097
  * Only accounts of this kind. ads = ad accounts (Meta, Google, LinkedIn, Pinterest, TikTok, X, OpenAI), communication = WhatsApp, Telegram, Discord, Slack and iMessage, blogs = Shopify and WordPress, social = every other platform.
20082
20098
  */
20083
20099
  category?: 'social' | 'ads' | 'communication' | 'blogs';
20100
+ /**
20101
+ * When true, leaves out accounts the dashboard does not show as connections: posting
20102
+ * accounts with `enabled: false` (ads accounts are always kept, whatever their `enabled`
20103
+ * value) and the internal `sms` and `phone` accounts behind each phone number. Applied
20104
+ * before pagination, so page totals and `statusCounts` count only the remaining accounts.
20105
+ * Sandbox accounts added by `includeSandbox` are appended after this filter. Accepts
20106
+ * `true` or `false` in any letter case; any other value returns 400.
20107
+ *
20108
+ */
20109
+ excludeHidden?: boolean;
20084
20110
  /**
20085
20111
  * When true, includes accounts from over-limit profiles.
20086
20112
  */
20087
20113
  includeOverLimit?: boolean;
20114
+ /**
20115
+ * When true, appends the shared WhatsApp sandbox account and the iMessage sandbox account
20116
+ * to the list when they are active, honouring `platform` but no other filter. Ignored on
20117
+ * a paginated request (page/limit) and together with `perProfile`. Accepts `true` or
20118
+ * `false` in any letter case; any other value returns 400.
20119
+ *
20120
+ */
20121
+ includeSandbox?: boolean;
20122
+ /**
20123
+ * When true, the response carries `statusCounts`: how many accounts match every other
20124
+ * filter of the request (with `status` lifted) in total and how many of those need a
20125
+ * reconnection. Accepts `true` or `false` in any letter case; any other value returns 400.
20126
+ *
20127
+ */
20128
+ includeStatusCounts?: boolean;
20088
20129
  /**
20089
20130
  * Page size. Must be provided together with page; sending only one of the two returns 400.
20090
20131
  *
@@ -40294,7 +40335,7 @@ type UpdateAdCampaignData = {
40294
40335
  */
40295
40336
  portfolioBidStrategyId?: string;
40296
40337
  /**
40297
- * Google only. Explicitly allow changing a shared campaign budget, affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40338
+ * Google only. Explicitly allow changing a shared campaign budget (flagged as shared by Google, or used by more than one campaign), affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40298
40339
  */
40299
40340
  allowSharedBudgetUpdate?: boolean;
40300
40341
  /**
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.1122",
39
+ version: "0.2.1124",
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.1122",
8
+ version: "0.2.1124",
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.1122",
3
+ "version": "0.2.1124",
4
4
  "description": "The official Node.js library for the Zernio API",
5
5
  "main": "dist/index.js",
6
6
  "module": "dist/index.mjs",
@@ -9847,7 +9847,9 @@ export const getAdCampaignDetails = <ThrowOnError extends boolean = false>(optio
9847
9847
  *
9848
9848
  * Google budget updates read the current budget before mutation. Shared budgets return
9849
9849
  * 409 unless allowSharedBudgetUpdate=true is explicitly supplied, because the change
9850
- * affects every campaign using that budget. Unknown sharing state also returns 409.
9850
+ * affects every campaign using that budget. A budget counts as shared when Google flags
9851
+ * it as shared or when more than one campaign uses it (older budgets can serve several
9852
+ * campaigns without the flag). Unknown sharing state also returns 409.
9851
9853
  *
9852
9854
  * `sharedBudgetId` (Google) moves the campaign onto a shared budget from
9853
9855
  * GET /v1/ads/shared-budgets, which also needs `allowSharedBudgetUpdate: true` (409
@@ -16,6 +16,19 @@ export type AccountsListResponse = {
16
16
  profileTotals?: {
17
17
  [key: string]: (number);
18
18
  };
19
+ /**
20
+ * Only with includeStatusCounts=true. Counts over every filter of the request except status.
21
+ */
22
+ statusCounts?: {
23
+ /**
24
+ * Accounts matching the filters in any status.
25
+ */
26
+ all: number;
27
+ /**
28
+ * Of those, the accounts that need reconnection.
29
+ */
30
+ disconnected: number;
31
+ };
19
32
  };
20
33
 
21
34
  export type AccountWithFollowerStats = SocialAccount & {
@@ -10445,8 +10458,11 @@ export type SocialAccount = {
10445
10458
  /**
10446
10459
  * Whether the user explicitly activated this account. false means the account was
10447
10460
  * created as a side effect (e.g., posting account auto-created when user connected
10448
- * ads first). Such accounts are hidden from this list, cannot be posted to
10449
- * (`ACCOUNT_NOT_ENABLED_FOR_POSTING`), and are not billed as connected accounts.
10461
+ * ads first). GET /v1/accounts still returns such accounts unless `excludeHidden=true`
10462
+ * is passed. They cannot be posted to (`ACCOUNT_NOT_ENABLED_FOR_POSTING`) and are not
10463
+ * billed as connected accounts. On an ads account (`metaads`, `googleads`, ...) the value
10464
+ * does not hide the connection: ads accounts are listed whatever their `enabled` value and
10465
+ * keep working for ads.
10450
10466
  *
10451
10467
  */
10452
10468
  enabled?: boolean;
@@ -18963,10 +18979,35 @@ export type ListAccountsData = {
18963
18979
  * Only accounts of this kind. ads = ad accounts (Meta, Google, LinkedIn, Pinterest, TikTok, X, OpenAI), communication = WhatsApp, Telegram, Discord, Slack and iMessage, blogs = Shopify and WordPress, social = every other platform.
18964
18980
  */
18965
18981
  category?: 'social' | 'ads' | 'communication' | 'blogs';
18982
+ /**
18983
+ * When true, leaves out accounts the dashboard does not show as connections: posting
18984
+ * accounts with `enabled: false` (ads accounts are always kept, whatever their `enabled`
18985
+ * value) and the internal `sms` and `phone` accounts behind each phone number. Applied
18986
+ * before pagination, so page totals and `statusCounts` count only the remaining accounts.
18987
+ * Sandbox accounts added by `includeSandbox` are appended after this filter. Accepts
18988
+ * `true` or `false` in any letter case; any other value returns 400.
18989
+ *
18990
+ */
18991
+ excludeHidden?: boolean;
18966
18992
  /**
18967
18993
  * When true, includes accounts from over-limit profiles.
18968
18994
  */
18969
18995
  includeOverLimit?: boolean;
18996
+ /**
18997
+ * When true, appends the shared WhatsApp sandbox account and the iMessage sandbox account
18998
+ * to the list when they are active, honouring `platform` but no other filter. Ignored on
18999
+ * a paginated request (page/limit) and together with `perProfile`. Accepts `true` or
19000
+ * `false` in any letter case; any other value returns 400.
19001
+ *
19002
+ */
19003
+ includeSandbox?: boolean;
19004
+ /**
19005
+ * When true, the response carries `statusCounts`: how many accounts match every other
19006
+ * filter of the request (with `status` lifted) in total and how many of those need a
19007
+ * reconnection. Accepts `true` or `false` in any letter case; any other value returns 400.
19008
+ *
19009
+ */
19010
+ includeStatusCounts?: boolean;
18970
19011
  /**
18971
19012
  * Page size. Must be provided together with page; sending only one of the two returns 400.
18972
19013
  *
@@ -40725,7 +40766,7 @@ export type UpdateAdCampaignData = {
40725
40766
  */
40726
40767
  portfolioBidStrategyId?: string;
40727
40768
  /**
40728
- * Google only. Explicitly allow changing a shared campaign budget, affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40769
+ * Google only. Explicitly allow changing a shared campaign budget (flagged as shared by Google, or used by more than one campaign), affecting every campaign that uses it. Does not bypass an unknown sharing state. Also required to move a campaign onto a shared budget with sharedBudgetId.
40729
40770
  */
40730
40771
  allowSharedBudgetUpdate?: boolean;
40731
40772
  /**