@getlatedev/node 0.2.881 → 0.2.882

package/dist/index.d.mts

@@ -22884,7 +22884,7 @@ type CreateInboxConversationData = {
          */
         accountId: string;
         /**
-         * Recipient identifier. For X this is the numeric user ID; for WhatsApp and SMS, the recipient phone number in international format (digits, country code included); for Slack, the workspace member id (e.g. U01ABCDEF). Provide either this or participantUsername.
+         * Recipient identifier. For X this is the numeric user ID; for WhatsApp and SMS, the recipient phone number in international format (digits, country code included); for Slack, the workspace member id (e.g. U01ABCDEF); for iMessage, a phone number in international format with the leading + or an iMessage email. Provide either this or participantUsername.
          */
         participantId?: string;
         /**
@@ -23054,18 +23054,21 @@ type CreateInboxConversationResponse = ({
 });
 type CreateInboxConversationError = (({
     error?: string;
-    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_HEADER' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
+    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_HEADER' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED' | 'invalid_content';
 } | WhatsAppTemplateLookupError) | {
     error?: string;
 } | unknown | ({
     error?: string;
     code?: 'account_not_found' | 'PARTICIPANT_NOT_FOUND';
-} | WhatsAppTemplateLookupError) | ({
+} | WhatsAppTemplateLookupError) | {
+    error?: string;
+    code?: 'recipient_opted_out' | 'recipient_must_message_first';
+} | ({
     error?: string;
     code?: 'DM_NOT_ALLOWED';
 } | WhatsAppTemplateLookupError) | ({
     error?: string;
-    code?: 'rate_limited';
+    code?: 'rate_limited' | 'new_contact_limit';
 } | WhatsAppTemplateLookupError) | WhatsAppTemplateLookupError);
 type SearchInboxConversationsData = {
     query: {

package/dist/index.d.ts

@@ -22884,7 +22884,7 @@ type CreateInboxConversationData = {
          */
         accountId: string;
         /**
-         * Recipient identifier. For X this is the numeric user ID; for WhatsApp and SMS, the recipient phone number in international format (digits, country code included); for Slack, the workspace member id (e.g. U01ABCDEF). Provide either this or participantUsername.
+         * Recipient identifier. For X this is the numeric user ID; for WhatsApp and SMS, the recipient phone number in international format (digits, country code included); for Slack, the workspace member id (e.g. U01ABCDEF); for iMessage, a phone number in international format with the leading + or an iMessage email. Provide either this or participantUsername.
          */
         participantId?: string;
         /**
@@ -23054,18 +23054,21 @@ type CreateInboxConversationResponse = ({
 });
 type CreateInboxConversationError = (({
     error?: string;
-    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_HEADER' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
+    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_HEADER' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED' | 'invalid_content';
 } | WhatsAppTemplateLookupError) | {
     error?: string;
 } | unknown | ({
     error?: string;
     code?: 'account_not_found' | 'PARTICIPANT_NOT_FOUND';
-} | WhatsAppTemplateLookupError) | ({
+} | WhatsAppTemplateLookupError) | {
+    error?: string;
+    code?: 'recipient_opted_out' | 'recipient_must_message_first';
+} | ({
     error?: string;
     code?: 'DM_NOT_ALLOWED';
 } | WhatsAppTemplateLookupError) | ({
     error?: string;
-    code?: 'rate_limited';
+    code?: 'rate_limited' | 'new_contact_limit';
 } | WhatsAppTemplateLookupError) | WhatsAppTemplateLookupError);
 type SearchInboxConversationsData = {
     query: {

package/dist/index.js

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

package/src/generated/sdk.gen.ts

@@ -3705,7 +3705,9 @@ export const listInboxConversations = <ThrowOnError extends boolean = false>(opt
  * Create conversation
  * Start a direct message conversation with a user. If a conversation with that recipient already exists, the message is added to the existing thread.
  *
- * Supported platforms: X, Bluesky, Reddit, WhatsApp, SMS, and Slack. Other platforms return PLATFORM_NOT_SUPPORTED.
+ * Supported platforms: X, Bluesky, Reddit, WhatsApp, SMS, Slack, and iMessage. Other platforms return PLATFORM_NOT_SUPPORTED.
+ *
+ * **iMessage.** Pass the recipient as participantId: a phone number in international format (+15551234567) or an iMessage email. Senders ordered through Zernio can message contacts who never wrote to them. The first message to such a contact must be a personal, plain-text note: no links, email addresses, phone numbers, prices, attachments or marketing. It is checked against those rules and reviewed for spam before sending; one that fails returns 400 with code `invalid_content` and nothing is sent. Each sender may open at most one new conversation every 15 minutes, and a new sender warms up: 2 new conversations per 24 hours on days 1-2 after activation, 5 on days 3-4, 10 on days 5-7, 20 on days 8-14, 30 on days 15-21 and 50 after that. Beyond that the request returns 429 with code `new_contact_limit` and a time to retry. The warm-up counts from when a sender ordered through Zernio went live; senders registered from your own provider account are not warmed up by Zernio. Until the contact replies, the opening is the only message the thread accepts: further sends return 409 `recipient_must_message_first`. Once the contact has written, the thread behaves like any other and is not limited. Recipients can report a first message as junk, and reports can get a sender blocked permanently, so keep the reply rate high (above roughly 30%). A sender registered with your own provider account may lack the add-on for new contacts; its sends to them return 409 `recipient_must_message_first`, and an opt-in link is the way in. A contact who opted out returns 409 `recipient_opted_out`.
  *
  * **Slack.** Pass a workspace member id as participantId (list them with GET /v1/accounts/{accountId}/slack-members). Zernio opens the DM channel with that member and sends the message; the thread then behaves like any other Slack conversation in the inbox. The member must belong to the connected workspace.
  *
@@ -3835,6 +3837,15 @@ export const getInboxConversationMessages = <ThrowOnError extends boolean = fals
  * return a `400` with code `131056`. Sends to other recipients are
  * unaffected, so parallelise across recipients rather than flooding one.
  *
+ * iMessage pacing: messages to contacts who have not written to the
+ * sender in the last 24 hours must be at least 2 minutes apart per
+ * sender; a send inside that window returns `429` with code
+ * `new_contact_limit` and the time to retry. Replies to contacts who
+ * wrote within the last day are not paced. A thread opened with
+ * `POST /v1/inbox/conversations` accepts no message after the opening
+ * until the contact replies (`409 recipient_must_message_first`). Text
+ * must be shorter than 10,000 characters.
+ *
  * WhatsApp template messages: to send an approved template into this
  * conversation (required when the 24-hour customer-service window is
  * closed), use the `template` field with a single element carrying the
@@ -5397,10 +5408,11 @@ export const setImessageSubscription = <ThrowOnError extends boolean = false>(op
 /**
  * Create a tracked iMessage opt-in link
  * Generates a per-campaign link that opens Messages on this sender with
- * `body` prefilled. iMessage is send-first: a sender can only message a
- * contact who has written to it (a send to anyone else fails with
- * `recipient_must_message_first`), and the contact's tap-and-send is
- * what opens that door.
+ * `body` prefilled. A thread the contact opens skips the pacing and the
+ * first-message content rule that apply when the sender writes first,
+ * and it is the only way in for senders without the add-on for new
+ * contacts (their sends to anyone else fail with
+ * `recipient_must_message_first`).
  *
  * Each link carries a unique code in place of the `[opt-in-code]`
  * placeholder; when the contact sends it, the resulting `message.received`

package/src/generated/types.gen.ts

@@ -22332,7 +22332,7 @@ export type CreateInboxConversationData = {
          */
         accountId: string;
         /**
-         * Recipient identifier. For X this is the numeric user ID; for WhatsApp and SMS, the recipient phone number in international format (digits, country code included); for Slack, the workspace member id (e.g. U01ABCDEF). Provide either this or participantUsername.
+         * Recipient identifier. For X this is the numeric user ID; for WhatsApp and SMS, the recipient phone number in international format (digits, country code included); for Slack, the workspace member id (e.g. U01ABCDEF); for iMessage, a phone number in international format with the leading + or an iMessage email. Provide either this or participantUsername.
          */
         participantId?: string;
         /**
@@ -22504,18 +22504,21 @@ export type CreateInboxConversationResponse = ({
 
 export type CreateInboxConversationError = (({
     error?: string;
-    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_HEADER' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED';
+    code?: 'PLATFORM_NOT_SUPPORTED' | 'PLATFORM_LIMITATION' | 'TEMPLATE_REQUIRED' | 'INVALID_TEMPLATE_PARAMS' | 'INVALID_TEMPLATE_BUTTON_PARAM' | 'INVALID_TEMPLATE_HEADER' | 'INVALID_TEMPLATE_CARD_PARAM' | 'DIRECT_SEND_NOT_ELIGIBLE' | 'DIRECT_SEND_LIMITED' | 'DIRECT_SEND_BLOCKED' | 'invalid_content';
 } | WhatsAppTemplateLookupError) | {
     error?: string;
 } | unknown | ({
     error?: string;
     code?: 'account_not_found' | 'PARTICIPANT_NOT_FOUND';
-} | WhatsAppTemplateLookupError) | ({
+} | WhatsAppTemplateLookupError) | {
+    error?: string;
+    code?: 'recipient_opted_out' | 'recipient_must_message_first';
+} | ({
     error?: string;
     code?: 'DM_NOT_ALLOWED';
 } | WhatsAppTemplateLookupError) | ({
     error?: string;
-    code?: 'rate_limited';
+    code?: 'rate_limited' | 'new_contact_limit';
 } | WhatsAppTemplateLookupError) | WhatsAppTemplateLookupError);
 
 export type SearchInboxConversationsData = {