@getlatedev/node 0.2.1302 → 0.2.1304

package/dist/index.d.mts

@@ -237,7 +237,7 @@ declare class Zernio {
         listBusinessPartners: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListBusinessPartnersData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListBusinessPartnersResponse, unknown, ThrowOnError>;
         grantBusinessPartner: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GrantBusinessPartnerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GrantBusinessPartnerResponse, unknown, ThrowOnError>;
         revokeBusinessPartner: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RevokeBusinessPartnerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RevokeBusinessPartnerResponse, unknown, ThrowOnError>;
-        getLinkedInMentions: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetLinkedInMentionsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetLinkedInMentionsResponse, GetLinkedInMentionsError, ThrowOnError>;
+        getLinkedInMentions: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetLinkedInMentionsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetLinkedInMentionsResponse, ErrorResponse, ThrowOnError>;
         getHubSpotSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetHubSpotSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetHubSpotSettingsResponse, unknown, ThrowOnError>;
         updateHubSpotSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateHubSpotSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateHubSpotSettingsResponse, unknown, ThrowOnError>;
         getSlackSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetSlackSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetSlackSettingsResponse, unknown, ThrowOnError>;
@@ -28040,7 +28040,7 @@ type GetLinkedInMentionsData = {
     };
     query: {
         /**
-         * Exact display name as shown on LinkedIn. Required for person mentions to be clickable. Optional for org mentions.
+         * Optional override for a person's mention text. When omitted, the real name is resolved from LinkedIn. Ignored for org mentions, which always use the organization's LinkedIn name.
          */
         displayName?: string;
         /**
@@ -28071,13 +28071,11 @@ type GetLinkedInMentionsResponse = ({
      */
     vanityName?: string;
     /**
-     * Warning about clickable mentions (only present for person mentions if displayName was not provided)
+     * Only present for person mentions when displayName was not provided and the real name could not be resolved from LinkedIn
      */
     warning?: string;
 });
-type GetLinkedInMentionsError = ({
-    error?: string;
-} | ErrorResponse);
+type GetLinkedInMentionsError = (ErrorResponse);
 type ListInstagramStoriesData = {
     path: {
         /**
@@ -43814,11 +43812,17 @@ type ListAdSetsData = {
          * Platform campaign ID
          */
         campaignId?: string;
+        limit?: number;
         /**
          * Read the on/off switches live from the platform instead of returning the synced values. The fresh values are stored (so later reads return them too) and the response carries `statusReadAt`, the time of the read. At most 20 platform objects are read per request. Where a read fails (credentials, platform error, no reader on that platform), the stored values come back with `statusReadAt: null`. See "Status freshness" in the operation description. On X the budget is read live in the same read: on GET /v1/ads/{adId} `budget`, `adSetBudget`, `campaignBudget` and `budgetLevel` are the line item and campaign budgets X holds now (stored like the switches); on the ad set and campaign listings `budget` is the one that line item or campaign holds now (returned, not stored); a row whose budget the other level holds keeps its synced `budget`.
          */
         live?: boolean;
+        page?: number;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' | 'reddit';
+        /**
+         * Filter by the ad set's stored `status`, the value each row returns. A live read does not change it. Rows whose `status` is null match no filter.
+         */
+        status?: AdStatus;
     };
 };
 type ListAdSetsResponse = ({
@@ -43826,6 +43830,9 @@ type ListAdSetsResponse = ({
         platformAdSetId?: string;
         platform?: string;
         adSetName?: (string) | null;
+        /**
+         * Stored ad set status (active, paused, pending_review, rejected, completed, cancelled, error), as last synced. The `status` filter matches it.
+         */
         status?: (string) | null;
         /**
          * Raw platform ad set status. On TikTok the ad group's own switch `operation_status` (ENABLE / DISABLE), independent of its campaign. On Meta and Reddit the ad set's `effective_status` (e.g. CAMPAIGN_PAUSED).
@@ -43956,6 +43963,7 @@ type ListAdSetsResponse = ({
          */
         configReadAt?: (string) | null;
     }>;
+    pagination?: Pagination;
 });
 type ListAdSetsError = (ErrorResponse | unknown);
 type CreateAdSetData = {

package/dist/index.d.ts

@@ -237,7 +237,7 @@ declare class Zernio {
         listBusinessPartners: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<ListBusinessPartnersData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<ListBusinessPartnersResponse, unknown, ThrowOnError>;
         grantBusinessPartner: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GrantBusinessPartnerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GrantBusinessPartnerResponse, unknown, ThrowOnError>;
         revokeBusinessPartner: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<RevokeBusinessPartnerData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<RevokeBusinessPartnerResponse, unknown, ThrowOnError>;
-        getLinkedInMentions: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetLinkedInMentionsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetLinkedInMentionsResponse, GetLinkedInMentionsError, ThrowOnError>;
+        getLinkedInMentions: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetLinkedInMentionsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetLinkedInMentionsResponse, ErrorResponse, ThrowOnError>;
         getHubSpotSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetHubSpotSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetHubSpotSettingsResponse, unknown, ThrowOnError>;
         updateHubSpotSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<UpdateHubSpotSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<UpdateHubSpotSettingsResponse, unknown, ThrowOnError>;
         getSlackSettings: <ThrowOnError extends boolean = false>(options: _hey_api_client_fetch.OptionsLegacyParser<GetSlackSettingsData, ThrowOnError>) => _hey_api_client_fetch.RequestResult<GetSlackSettingsResponse, unknown, ThrowOnError>;
@@ -28040,7 +28040,7 @@ type GetLinkedInMentionsData = {
     };
     query: {
         /**
-         * Exact display name as shown on LinkedIn. Required for person mentions to be clickable. Optional for org mentions.
+         * Optional override for a person's mention text. When omitted, the real name is resolved from LinkedIn. Ignored for org mentions, which always use the organization's LinkedIn name.
          */
         displayName?: string;
         /**
@@ -28071,13 +28071,11 @@ type GetLinkedInMentionsResponse = ({
      */
     vanityName?: string;
     /**
-     * Warning about clickable mentions (only present for person mentions if displayName was not provided)
+     * Only present for person mentions when displayName was not provided and the real name could not be resolved from LinkedIn
      */
     warning?: string;
 });
-type GetLinkedInMentionsError = ({
-    error?: string;
-} | ErrorResponse);
+type GetLinkedInMentionsError = (ErrorResponse);
 type ListInstagramStoriesData = {
     path: {
         /**
@@ -43814,11 +43812,17 @@ type ListAdSetsData = {
          * Platform campaign ID
          */
         campaignId?: string;
+        limit?: number;
         /**
          * Read the on/off switches live from the platform instead of returning the synced values. The fresh values are stored (so later reads return them too) and the response carries `statusReadAt`, the time of the read. At most 20 platform objects are read per request. Where a read fails (credentials, platform error, no reader on that platform), the stored values come back with `statusReadAt: null`. See "Status freshness" in the operation description. On X the budget is read live in the same read: on GET /v1/ads/{adId} `budget`, `adSetBudget`, `campaignBudget` and `budgetLevel` are the line item and campaign budgets X holds now (stored like the switches); on the ad set and campaign listings `budget` is the one that line item or campaign holds now (returned, not stored); a row whose budget the other level holds keeps its synced `budget`.
          */
         live?: boolean;
+        page?: number;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' | 'reddit';
+        /**
+         * Filter by the ad set's stored `status`, the value each row returns. A live read does not change it. Rows whose `status` is null match no filter.
+         */
+        status?: AdStatus;
     };
 };
 type ListAdSetsResponse = ({
@@ -43826,6 +43830,9 @@ type ListAdSetsResponse = ({
         platformAdSetId?: string;
         platform?: string;
         adSetName?: (string) | null;
+        /**
+         * Stored ad set status (active, paused, pending_review, rejected, completed, cancelled, error), as last synced. The `status` filter matches it.
+         */
         status?: (string) | null;
         /**
          * Raw platform ad set status. On TikTok the ad group's own switch `operation_status` (ENABLE / DISABLE), independent of its campaign. On Meta and Reddit the ad set's `effective_status` (e.g. CAMPAIGN_PAUSED).
@@ -43956,6 +43963,7 @@ type ListAdSetsResponse = ({
          */
         configReadAt?: (string) | null;
     }>;
+    pagination?: Pagination;
 });
 type ListAdSetsError = (ErrorResponse | unknown);
 type CreateAdSetData = {

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1302",
+  version: "0.2.1304",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/dist/index.mjs

@@ -5,7 +5,7 @@ var __publicField = (obj, key, value) => __defNormalProp(obj, typeof key !== "sy
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1302",
+  version: "0.2.1304",
   description: "The official Node.js library for the Zernio API",
   main: "dist/index.js",
   module: "dist/index.mjs",

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@getlatedev/node",
-  "version": "0.2.1302",
+  "version": "0.2.1304",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/sdk.gen.ts

@@ -3055,9 +3055,9 @@ export const updateLinkedInOrganization = <ThrowOnError extends boolean = false>
  * Important: The mentions array field in POST /v1/posts is stored for reference only and does NOT trigger @mentions on LinkedIn. You must embed the mention format directly in the content text.
  *
  * Requirements:
- * - Person mentions require the LinkedIn account to be admin of at least one organization: both endpoints that resolve a profile URL to a member URN take an organization you administer. Organization mentions (e.g. @Microsoft) have no such requirement.
+ * - Resolving a profile URL to a person mention requires the LinkedIn account to be admin of at least one organization: both endpoints that resolve a profile URL to a member URN take an organization you administer. A resolved person mention publishes from any account. Organization mentions (e.g. @Microsoft) have no such requirement.
  * - The two are not scoped alike. peopleTypeahead?q=organizationFollowers only returns that organization's followers; vanityUrl?q=vanityUrlAsOrganization does not, and its resolvable set is opaque. A 404 here does not mean the person is unknown to you or unknown to LinkedIn: a live public profile can 404 with no reason given.
- * - For person mentions to be clickable, the displayName parameter must exactly match the name shown on their LinkedIn profile.
+ * - displayName is optional: the endpoint looks up the person's real name itself. LinkedIn renders a person mention as a link when the mention text is the person's first name, last name or full name (case-sensitive).
  * - Person mentions DO work when published from personal profiles (the URN only needs to be valid). The limitation is only in the resolution step (URL to URN), not in publishing.
  *
  */
@@ -10690,8 +10690,10 @@ export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(op
  * directly, independent of the `ads` rollup GET /v1/ads/tree uses, so a
  * newly created standalone ad group with no ad yet (POST /v1/ads/ad-sets,
  * Google only) is visible here even though it is invisible in the tree
- * until an ad joins it via `adSetId` on POST /v1/ads/create. Returns at most 500
- * rows, newest first.
+ * until an ad joins it via `adSetId` on POST /v1/ads/create. Rows come newest first
+ * (by platform creation time, then id, so pages never overlap), 500 per page unless `limit`
+ * says otherwise; `pagination.total` counts every matching ad set and `page` reaches the
+ * rest.
  *
  * **This list is SYNCED, not live** (refreshed by background sync, see below). Each row also
  * carries the ad set's config (`targeting`, `bidStrategy`, `bidAmount`, `optimizationGoal`,
@@ -10710,8 +10712,8 @@ export const updateCampaignTargeting = <ThrowOnError extends boolean = false>(op
  * which reads the switches from the platform now, stores them, and returns `statusReadAt`
  * (null when the read failed and the stored values were returned).
  * With `live=true` (which needs a `campaignId` or `adSetId` filter) each listed ad set's own
- * switch (`platformAdSetStatus`) is read live, for the first 20 rows; later rows keep their
- * synced value with `statusReadAt: null`. Live reads cover TikTok, Meta, Google, OpenAI and Reddit.
+ * switch (`platformAdSetStatus`) is read live, for the first 20 rows of the page; later rows keep their
+ * synced value with `statusReadAt: null`. To read more ad sets live, page with `limit=20`. Live reads cover TikTok, Meta, Google, OpenAI and Reddit.
  * The rolled-up `status` is not re-derived by a live read. On TikTok the same live read also
  * returns the ad group's applied `optimizationGoal` and `billingEvent`, as TikTok's adgroup/get
  * reports them, so you can verify the goal TikTok applied rather than the one you requested.

package/src/generated/types.gen.ts

@@ -27241,7 +27241,7 @@ export type GetLinkedInMentionsData = {
     };
     query: {
         /**
-         * Exact display name as shown on LinkedIn. Required for person mentions to be clickable. Optional for org mentions.
+         * Optional override for a person's mention text. When omitted, the real name is resolved from LinkedIn. Ignored for org mentions, which always use the organization's LinkedIn name.
          */
         displayName?: string;
         /**
@@ -27273,14 +27273,12 @@ export type GetLinkedInMentionsResponse = ({
      */
     vanityName?: string;
     /**
-     * Warning about clickable mentions (only present for person mentions if displayName was not provided)
+     * Only present for person mentions when displayName was not provided and the real name could not be resolved from LinkedIn
      */
     warning?: string;
 });
 
-export type GetLinkedInMentionsError = ({
-    error?: string;
-} | ErrorResponse);
+export type GetLinkedInMentionsError = (ErrorResponse);
 
 export type ListInstagramStoriesData = {
     path: {
@@ -44338,11 +44336,17 @@ export type ListAdSetsData = {
          * Platform campaign ID
          */
         campaignId?: string;
+        limit?: number;
         /**
          * Read the on/off switches live from the platform instead of returning the synced values. The fresh values are stored (so later reads return them too) and the response carries `statusReadAt`, the time of the read. At most 20 platform objects are read per request. Where a read fails (credentials, platform error, no reader on that platform), the stored values come back with `statusReadAt: null`. See "Status freshness" in the operation description. On X the budget is read live in the same read: on GET /v1/ads/{adId} `budget`, `adSetBudget`, `campaignBudget` and `budgetLevel` are the line item and campaign budgets X holds now (stored like the switches); on the ad set and campaign listings `budget` is the one that line item or campaign holds now (returned, not stored); a row whose budget the other level holds keeps its synced `budget`.
          */
         live?: boolean;
+        page?: number;
         platform?: 'facebook' | 'instagram' | 'tiktok' | 'linkedin' | 'pinterest' | 'google' | 'twitter' | 'openai' | 'reddit';
+        /**
+         * Filter by the ad set's stored `status`, the value each row returns. A live read does not change it. Rows whose `status` is null match no filter.
+         */
+        status?: AdStatus;
     };
 };
 
@@ -44351,6 +44355,9 @@ export type ListAdSetsResponse = ({
         platformAdSetId?: string;
         platform?: string;
         adSetName?: (string) | null;
+        /**
+         * Stored ad set status (active, paused, pending_review, rejected, completed, cancelled, error), as last synced. The `status` filter matches it.
+         */
         status?: (string) | null;
         /**
          * Raw platform ad set status. On TikTok the ad group's own switch `operation_status` (ENABLE / DISABLE), independent of its campaign. On Meta and Reddit the ad set's `effective_status` (e.g. CAMPAIGN_PAUSED).
@@ -44481,6 +44488,7 @@ export type ListAdSetsResponse = ({
          */
         configReadAt?: (string) | null;
     }>;
+    pagination?: Pagination;
 });
 
 export type ListAdSetsError = (ErrorResponse | unknown);