@getlatedev/node 0.2.1105 → 0.2.1107

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -9369,7 +9369,7 @@ export const getCommentAutomation = <ThrowOnError extends boolean = false>(optio
 
 /**
  * Update automation settings
- * Update an automation's keywords, DM message, inline buttons, comment reply, or active status.
+ * Update an automation's keywords, DM message, inline buttons, comment reply, post binding, or active status.
  * Pass `buttons: []` to clear all buttons. When `buttons` is non-empty, `dmMessage` (the new
  * one if you're changing it, otherwise the stored one) must be 640 characters or less.
  * On a TikTok, Threads, LinkedIn or YouTube automation (public reply only) the DM fields

package/src/generated/types.gen.ts

@@ -10334,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.
      */
@@ -10402,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.
@@ -10414,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.
  */
@@ -19887,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.
          */
@@ -19937,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):
@@ -19990,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:
@@ -38914,6 +38936,9 @@ export type ListCommentAutomationsResponse = ({
          * Only with matchMode=word: also fire on close misspellings of a keyword (one edit for 4-7 character keywords, two from 8 up). Keywords shorter than 4 characters are never fuzzy-matched.
          */
         typoTolerance?: boolean;
+        /**
+         * Instagram and Facebook only. On reply-only platforms (tiktok, threads, linkedin, youtube) every DM-leg field is omitted: dmMessage, dmMessageVariations, buttons, template, quickReplies, dmMedia, publicReplyPolicy, dedupeSameTextHours, actions, audience, followGate, dmDelaySeconds and alsoMatchInDms.
+         */
         dmMessage?: string;
         /**
          * Inline DM buttons (up to 3). Omitted when none are set.
@@ -39100,6 +39125,9 @@ export type CreateCommentAutomationResponse = ({
          * Only with matchMode=word: also fire on close misspellings of a keyword (one edit for 4-7 character keywords, two from 8 up). Keywords shorter than 4 characters are never fuzzy-matched.
          */
         typoTolerance?: boolean;
+        /**
+         * Omitted on reply-only platforms (tiktok, threads, linkedin, youtube), together with every other DM-leg field.
+         */
         dmMessage?: string;
         /**
          * Inline DM buttons (up to 3). Omitted when none are set.
@@ -39178,6 +39206,9 @@ export type GetCommentAutomationResponse = ({
          * Only with matchMode=word: also fire on close misspellings of a keyword (one edit for 4-7 character keywords, two from 8 up). Keywords shorter than 4 characters are never fuzzy-matched.
          */
         typoTolerance?: boolean;
+        /**
+         * Omitted on reply-only platforms (tiktok, threads, linkedin, youtube), together with every other DM-leg field.
+         */
         dmMessage?: string;
         /**
          * Inline DM buttons (up to 3). Omitted when none are set.
@@ -39253,6 +39284,18 @@ export type UpdateCommentAutomationData = {
          * Only with matchMode=word: also fire on close misspellings of a keyword (one edit for 4-7 character keywords, two from 8 up). Keywords shorter than 4 characters are never fuzzy-matched.
          */
         typoTolerance?: boolean;
+        /**
+         * Re-binds the automation to another post: the platform media/post ID (or story media id when trigger=story_reply). postId, platformPostId and postTitle move as a unit: sending any of them replaces all three, and an omitted one is cleared. Send all three as null (or empty) to make it account-wide (any post / any story). Omit all three to keep the current binding. 409 when another active automation already owns the new post.
+         */
+        platformPostId?: (string) | null;
+        /**
+         * Zernio post ID (24 hexadecimal characters); platform IDs return 400. Use it INSTEAD of platformPostId to bind to a not-yet-published Zernio post: the automation stays pending and arms itself when that post publishes. Moves as a unit with platformPostId and postTitle (see platformPostId).
+         */
+        postId?: (string) | null;
+        /**
+         * Post content snippet for display. Moves as a unit with platformPostId and postId (see platformPostId).
+         */
+        postTitle?: (string) | null;
         dmMessage?: string;
         /**
          * Inline DM buttons (1-3). Pass [] to clear all buttons.
@@ -39333,6 +39376,9 @@ export type UpdateCommentAutomationResponse = ({
          * Only with matchMode=word: also fire on close misspellings of a keyword (one edit for 4-7 character keywords, two from 8 up). Keywords shorter than 4 characters are never fuzzy-matched.
          */
         typoTolerance?: boolean;
+        /**
+         * Omitted on reply-only platforms (tiktok, threads, linkedin, youtube), together with every other DM-leg field.
+         */
         dmMessage?: string;
         /**
          * Inline DM buttons (up to 3). Omitted when none are set.
@@ -39371,7 +39417,7 @@ export type UpdateCommentAutomationResponse = ({
 
 export type UpdateCommentAutomationError = (ErrorResponse | {
     error?: string;
-});
+} | unknown);
 
 export type DeleteCommentAutomationData = {
     path: {