@proveanything/smartlinks 1.13.17 → 1.13.18

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.13.17  |  Generated: 2026-05-15T20:47:03.471Z
+Version: 1.13.18  |  Generated: 2026-05-15T21:59:57.655Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3030,6 +3030,7 @@ interface WhatsAppReplyCta {
   body: string
   buttonLabel: string
   buttonUrl: string
+  mediaUrl?: string  // optional image (JPEG/PNG, public https) — selects image card template
 }
 ```
 

package/dist/docs/auth-kit.md

@@ -105,6 +105,7 @@ const wa = await authKit.sendWhatsApp(clientId);
 //       body: "You're verified and ready to bid.",
 //       buttonLabel: 'Back to Auction',
 //       buttonUrl: '{{returnUrl}}',
+//       // mediaUrl: 'https://cdn.example.com/bid-confirmed.jpg',  // optional: include to use image card template
 //     },
 //     text: "You're verified. Return to the app to continue.",
 //   },
@@ -170,11 +171,15 @@ Verification status values returned by `authKit.getWhatsAppStatus` are:
 Pass a `reply` object in `sendWhatsApp` to send a message back to the user after they confirm `CONFIRM <token>`. Reply resolution order:
 
 1. `reply.contentSid` — explicit Twilio Content SID
-2. `reply.cta` — CTA shorthand using the shared generic Twilio Content template SID (`TWILIO_WHATSAPP_GENERIC_CTA_SID`)
+2. `reply.cta` — CTA shorthand:
+   - If `cta.mediaUrl` is present (valid public `https://` URL), uses the **image card** Twilio Content template (`TWILIO_WHATSAPP_IMAGE_CTA_SID`)
+   - Otherwise uses the **text CTA** template (`TWILIO_WHATSAPP_GENERIC_CTA_SID`)
 3. `reply.text` — plain-text fallback
 4. Per-client default (`authKit/{clientId}.whatsapp` config)
 5. Built-in default text
 
+> **Important:** Only pass `mediaUrl` when you have a valid, publicly reachable `https://` JPEG or PNG. If the field is absent or blank, the text-only CTA template is selected automatically. Never pass an empty string — omit the field entirely to avoid Twilio rejecting the send.
+
 The following template placeholders are available in `reply.text`, `reply.cta` fields, and `reply.contentVariables` values:
 
 | Placeholder | Description |

package/dist/openapi.yaml

@@ -17906,6 +17906,8 @@ components:
           type: string
         buttonUrl:
           type: string
+        mediaUrl:
+          type: string
       required:
         - body
         - buttonLabel

package/dist/types/authKit.d.ts

@@ -83,6 +83,7 @@ export interface WhatsAppReplyCta {
     body: string;
     buttonLabel: string;
     buttonUrl: string;
+    mediaUrl?: string;
 }
 export interface WhatsAppReplyOptions {
     /** Option A: explicit Twilio Content SID */

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.13.17  |  Generated: 2026-05-15T20:47:03.471Z
+Version: 1.13.18  |  Generated: 2026-05-15T21:59:57.655Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3030,6 +3030,7 @@ interface WhatsAppReplyCta {
   body: string
   buttonLabel: string
   buttonUrl: string
+  mediaUrl?: string  // optional image (JPEG/PNG, public https) — selects image card template
 }
 ```
 

package/docs/auth-kit.md

@@ -105,6 +105,7 @@ const wa = await authKit.sendWhatsApp(clientId);
 //       body: "You're verified and ready to bid.",
 //       buttonLabel: 'Back to Auction',
 //       buttonUrl: '{{returnUrl}}',
+//       // mediaUrl: 'https://cdn.example.com/bid-confirmed.jpg',  // optional: include to use image card template
 //     },
 //     text: "You're verified. Return to the app to continue.",
 //   },
@@ -170,11 +171,15 @@ Verification status values returned by `authKit.getWhatsAppStatus` are:
 Pass a `reply` object in `sendWhatsApp` to send a message back to the user after they confirm `CONFIRM <token>`. Reply resolution order:
 
 1. `reply.contentSid` — explicit Twilio Content SID
-2. `reply.cta` — CTA shorthand using the shared generic Twilio Content template SID (`TWILIO_WHATSAPP_GENERIC_CTA_SID`)
+2. `reply.cta` — CTA shorthand:
+   - If `cta.mediaUrl` is present (valid public `https://` URL), uses the **image card** Twilio Content template (`TWILIO_WHATSAPP_IMAGE_CTA_SID`)
+   - Otherwise uses the **text CTA** template (`TWILIO_WHATSAPP_GENERIC_CTA_SID`)
 3. `reply.text` — plain-text fallback
 4. Per-client default (`authKit/{clientId}.whatsapp` config)
 5. Built-in default text
 
+> **Important:** Only pass `mediaUrl` when you have a valid, publicly reachable `https://` JPEG or PNG. If the field is absent or blank, the text-only CTA template is selected automatically. Never pass an empty string — omit the field entirely to avoid Twilio rejecting the send.
+
 The following template placeholders are available in `reply.text`, `reply.cta` fields, and `reply.contentVariables` values:
 
 | Placeholder | Description |

package/openapi.yaml

@@ -17906,6 +17906,8 @@ components:
           type: string
         buttonUrl:
           type: string
+        mediaUrl:
+          type: string
       required:
         - body
         - buttonLabel

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@proveanything/smartlinks",
-  "version": "1.13.17",
+  "version": "1.13.18",
   "description": "Official JavaScript/TypeScript SDK for the Smartlinks API",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",