@getlatedev/node 0.2.1104 → 0.2.1106

package/dist/index.js

@@ -36,7 +36,7 @@ module.exports = __toCommonJS(index_exports);
 // package.json
 var package_default = {
   name: "@getlatedev/node",
-  version: "0.2.1104",
+  version: "0.2.1106",
   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.1104",
+  version: "0.2.1106",
   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.1104",
+  "version": "0.2.1106",
   "description": "The official Node.js library for the Zernio API",
   "main": "dist/index.js",
   "module": "dist/index.mjs",

package/src/generated/types.gen.ts

@@ -355,6 +355,48 @@ export type Ad = {
          * All media URLs for this ad (carousel images, multiple assets). Populated for Meta (carousel child_attachments), Google Ads (responsive display marketing_images), and LinkedIn (multi-image posts).
          */
         mediaUrls?: Array<(string)>;
+        /**
+         * Meta only today. The carousel's cards in the order the ad shows them, one per
+         * Meta `link_data.child_attachments` entry, using the same field names as the
+         * `carouselCards` create input. On a carousel synced from Meta, `imageUrl` is resolved
+         * exactly like `mediaUrls` (the stable `/adimages` permalink first), so the cards that
+         * carry an image line up with `mediaUrls` in order; a card whose image Meta does not
+         * resolve keeps its place without `imageUrl`. On a carousel created through Zernio
+         * it starts as the cards you sent. Absent on non-carousel ads and on
+         * other platforms. Synced carousels stored before this field existed fill it in on
+         * their next sync.
+         *
+         */
+        carouselCards?: Array<{
+            /**
+             * Card image, resolved like the matching `mediaUrls` entry. Absent when Meta returns no resolvable image for the card.
+             */
+            imageUrl?: string;
+            /**
+             * Meta ad image hash of the card image (`image_hash`).
+             */
+            imageHash?: string;
+            /**
+             * Card title (Meta `name`).
+             */
+            headline?: string;
+            /**
+             * Card description, under the title (Meta `description`).
+             */
+            description?: string;
+            /**
+             * Card destination URL (Meta `link`).
+             */
+            linkUrl?: string;
+            /**
+             * Card call to action type (Meta `call_to_action.type`), e.g. SHOP_NOW or WATCH_MORE.
+             */
+            callToAction?: string;
+            /**
+             * Meta video id when the card is a video (`video_id`).
+             */
+            videoId?: string;
+        }>;
         /**
          * LinkedIn only. Whether LinkedIn is currently serving this specific creative. Complements the ad-level `servingStatuses`, which describes the parent campaign.
          */
@@ -10292,6 +10334,14 @@ export type SocialAccount = {
     profileId: (string | Profile);
     username?: string;
     displayName?: string;
+    /**
+     * The account's id on its platform as the platform reports it to Zernio; stable across reconnects, so it is the key to match an account against your own records. Instagram: the app-scoped user id on Instagram Login accounts (the professional account id is in `metadata.instagramScopedId`), the professional account id (`17841...`) on Facebook Login accounts. TikTok: the open_id of Zernio's TikTok app, which differs from the open_id any other app sees for the same user. Either value can be passed back as `expectedPlatformUserId` on GET /v1/connect/{platform}.
+     */
+    platformUserId?: string;
+    /**
+     * TikTok accounts only. The account type TikTok reported when the account was connected. `personal` accounts cannot use TikTok direct messages through the API (TikTok limits Business Messaging to Business Accounts): skip the inbox for them and tell the user to switch to a Business Account in the TikTok app, then reconnect. `business` is the prerequisite, not a guarantee; messaging also needs the messaging scopes granted and TikTok's regional availability. `unknown` on accounts connected before this was captured or whose grant left out the account-type scope.
+     */
+    tiktokAccountType?: 'business' | 'personal' | 'unknown';
     /**
      * URL to the account's profile picture on the platform. May be null if the platform does not provide one.
      */
@@ -10360,6 +10410,7 @@ export type SocialAccount = {
      *
      * For Instagram accounts:
      * - loginMethod: "facebook_login" when the account was connected through Facebook Login. Absent on accounts connected with Instagram Login. On facebook_login accounts, comment reads leave hidden comments out entirely instead of returning them with isHidden true.
+     * - instagramScopedId: the Instagram professional account id (`17841...`). On Instagram Login accounts this is the id that is the same whichever app connected the account, while platformUserId is app-scoped; Facebook Login accounts hold this id as platformUserId.
      *
      * For X (Twitter) accounts:
      * - profileData.extraData.isPremium: Whether X reports a paid subscription (Basic, Premium, Premium+, or a blue verified badge), which raises the post length limit from 280 to 25,000 characters. Read live at connect and reconnect and refreshed by the daily follower snapshot; because X intermittently reports no subscription for subscribed accounts, a cancellation is stored on the fourth consecutive daily snapshot that reports it (about four days). Accounts connected before the extraData layout carry the same flag at profileData.isPremium.
@@ -10372,6 +10423,11 @@ export type SocialAccount = {
 
 export type platform11 = 'tiktok' | 'instagram' | 'facebook' | 'youtube' | 'linkedin' | 'twitter' | 'threads' | 'pinterest' | 'reddit' | 'bluesky' | 'googlebusiness' | 'telegram' | 'snapchat' | 'discord' | 'slack' | 'whatsapp' | 'shopify' | 'wordpress' | 'linkedinads' | 'metaads' | 'pinterestads' | 'tiktokads' | 'xads' | 'googleads' | 'openaiads' | 'sms' | 'phone' | 'rcs' | 'whopads';
 
+/**
+ * TikTok accounts only. The account type TikTok reported when the account was connected. `personal` accounts cannot use TikTok direct messages through the API (TikTok limits Business Messaging to Business Accounts): skip the inbox for them and tell the user to switch to a Business Account in the TikTok app, then reconnect. `business` is the prerequisite, not a guarantee; messaging also needs the messaging scopes granted and TikTok's regional availability. `unknown` on accounts connected before this was captured or whose grant left out the account-type scope.
+ */
+export type tiktokAccountType = 'business' | 'personal' | 'unknown';
+
 /**
  * A tracking tag's install on a connected store: a Shopify web pixel, or a Custom HTML widget on a WordPress site. Fields marked Shopify or WordPress are present only for that platform.
  */
@@ -19845,6 +19901,14 @@ export type GetConnectUrlData = {
          * Hosted signup page only (`signup=hosted`, WhatsApp): name shown in the page title ("Connect your WhatsApp number to <brandName>") instead of Zernio. The Zernio logo stays: the page is co-branded, not white-label. Trimmed; 1 to 60 characters. Rejected with 400 `INVALID_FIELD_VALUE` without `signup=hosted`. Stored on the signup session at issue time, so the page URL cannot change it.
          */
         brandName?: string;
+        /**
+         * Only connect if the login lands on this platform account; any other account ends the flow with `error=account_mismatch` (a 409 `account_mismatch` on POST /v1/connect/instagram/select-account) and nothing is written. Compared with every id the platform reports for the authorized account: the `platformUserId` of a Zernio account on this platform, or on Instagram either the app-scoped id or the professional account id (`metadata.instagramScopedId`, the `17841...` id that Facebook Login accounts hold as platformUserId). TikTok open_ids are app-scoped, so an id from your own TikTok app never matches; use expectedUsername there. Honoured by the OAuth callback (every platform that connects without a selection step, Instagram Login included) and by the Instagram selection step; on the other selection endpoints you choose the destination yourself. In headless mode the marker travels in the redirect_url we hand you, so pass that URL back unchanged. On X it counts toward the OAuth state limit described under redirect_url.
+         */
+        expectedPlatformUserId?: string;
+        /**
+         * Only connect if the authorized account's handle is this one (case-insensitive, a leading @ is ignored); otherwise the flow ends with `error=account_mismatch`, `error_message` naming the handle that was authorized, and nothing is written. Same coverage and transport as expectedPlatformUserId; when both are sent both must match. Use this on a first connection, where you hold the handle the user typed but no Zernio id yet.
+         */
+        expectedUsername?: string;
         /**
          * When true, the user is redirected to your redirect_url with raw OAuth data (code, state) instead of Zernio's default account selection UI. Use this to build a custom connect experience.
          */
@@ -19895,7 +19959,7 @@ export type GetConnectUrlData = {
          * `dashboard_url`, `missing_scopes`, `error_reason` and the `platform_error*` params are
          * conditional and must be treated as optional. Your own query params are kept on every
          * redirect, but ours overwrite a param of yours with the same name. On an error redirect the
-         * internal `headless`, `adsConnect`, `adsScope` and `reconnectAccountId` markers we add during the flow are removed.
+         * internal `headless`, `adsConnect`, `adsScope`, `reconnectAccountId`, `expectedPlatformUserId` and `expectedUsername` markers we add during the flow are removed.
          *
          * Correlation (every redirect from an OAuth callback, success and failure, and the
          * `redirect_url` returned by the selection endpoints such as POST /v1/connect/facebook/select-page):
@@ -19948,7 +20012,7 @@ export type GetConnectUrlData = {
          * oauth_denied, invalid_callback, invalid_state, unsupported_platform, connection_failed,
          * internal_error, token_exchange_failed, byok_config_error, personal_account_not_supported,
          * missing_google_permissions, missing_tiktok_permissions, platform_requires_destination,
-         * reconnect_account_mismatch, instagram_login_method_mismatch, invalid_request,
+         * reconnect_account_mismatch, account_mismatch, instagram_login_method_mismatch, invalid_request,
          * code_already_redeemed
          *
          * Access and limits: