@proveanything/smartlinks 1.13.11 → 1.13.12

package/dist/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.13.11  |  Generated: 2026-05-13T07:57:31.015Z
+Version: 1.13.12  |  Generated: 2026-05-14T16:00:33.063Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3024,11 +3024,31 @@ interface EmailVerifyTokenResponse {
 }
 ```
 
+**WhatsAppReplyCta** (interface)
+```typescript
+interface WhatsAppReplyCta {
+  body: string
+  buttonLabel: string
+  buttonUrl: string
+}
+```
+
+**WhatsAppReplyOptions** (interface)
+```typescript
+interface WhatsAppReplyOptions {
+  contentSid?: string
+  contentVariables?: Record<string, unknown>
+  cta?: WhatsAppReplyCta
+  text?: string
+}
+```
+
 **SendWhatsAppRequest** (interface)
 ```typescript
 interface SendWhatsAppRequest {
   phoneNumber?: string
   redirectUrl?: string
+  reply?: WhatsAppReplyOptions
 }
 ```
 

package/dist/docs/auth-kit.md

@@ -88,9 +88,17 @@ import { authKit } from '@proveanything/smartlinks';
 // 1) Send WhatsApp verification deep link
 const wa = await authKit.sendWhatsApp(clientId);
 
-// Optional: pass redirect context only
+// Optional: pass redirect context and/or a post-verification reply
 // const wa = await authKit.sendWhatsApp(clientId, {
 //   redirectUrl: 'https://app.example.com/checkout/continue',
+//   reply: {
+//     cta: {
+//       body: "You're verified and ready to bid.",
+//       buttonLabel: 'Back to Auction',
+//       buttonUrl: '{{returnUrl}}',
+//     },
+//     text: "You're verified. Return to the app to continue.",
+//   },
 // });
 
 // wa.waLink can be opened directly by the app/browser
@@ -135,6 +143,27 @@ Verification status values returned by `authKit.getWhatsAppStatus` are:
 - `expired`
 - `unknown`
 
+#### Post-verification reply
+
+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`)
+3. `reply.text` — plain-text fallback
+4. Per-client default (`authKit/{clientId}.whatsapp` config)
+5. Built-in default text
+
+The following template placeholders are available in `reply.text`, `reply.cta` fields, and `reply.contentVariables` values:
+
+| Placeholder | Description |
+|---|---|
+| `{{returnUrl}}` | The resolved redirect URL |
+| `{{phoneNumber}}` | The verified phone number |
+| `{{clientId}}` | The Auth Kit client ID |
+| `{{token}}` | The verification token |
+
+> **Note:** `redirectUrl` is optional. WhatsApp tokens are short hex strings (16 chars) for better UX.
+
 ### Google OAuth
 
 ```ts

package/dist/openapi.yaml

@@ -17864,6 +17864,31 @@ components:
       required:
         - success
         - message
+    WhatsAppReplyCta:
+      type: object
+      properties:
+        body:
+          type: string
+        buttonLabel:
+          type: string
+        buttonUrl:
+          type: string
+      required:
+        - body
+        - buttonLabel
+        - buttonUrl
+    WhatsAppReplyOptions:
+      type: object
+      properties:
+        contentSid:
+          type: string
+        contentVariables:
+          type: object
+          additionalProperties: true
+        cta:
+          $ref: "#/components/schemas/WhatsAppReplyCta"
+        text:
+          type: string
     SendWhatsAppRequest:
       type: object
       properties:
@@ -17871,6 +17896,8 @@ components:
           type: string
         redirectUrl:
           type: string
+        reply:
+          $ref: "#/components/schemas/WhatsAppReplyOptions"
     SendWhatsAppResponse:
       type: object
       properties:

package/dist/types/authKit.d.ts

@@ -76,9 +76,24 @@ export interface EmailVerifyTokenResponse {
     emailVerificationMode?: 'immediate' | 'verify-auto-login' | 'verify-manual-login';
 }
 export type VerifyStatus = 'pending' | 'verified' | 'failed' | 'expired' | 'unknown';
+export interface WhatsAppReplyCta {
+    body: string;
+    buttonLabel: string;
+    buttonUrl: string;
+}
+export interface WhatsAppReplyOptions {
+    /** Option A: explicit Twilio Content SID */
+    contentSid?: string;
+    contentVariables?: Record<string, unknown>;
+    /** Option B: CTA shorthand (uses shared generic CTA content SID) */
+    cta?: WhatsAppReplyCta;
+    /** Option C: plain-text fallback */
+    text?: string;
+}
 export interface SendWhatsAppRequest {
     phoneNumber?: string;
     redirectUrl?: string;
+    reply?: WhatsAppReplyOptions;
 }
 export interface SendWhatsAppResponse {
     waLink: string;

package/docs/API_SUMMARY.md

@@ -1,6 +1,6 @@
 # Smartlinks API Summary
 
-Version: 1.13.11  |  Generated: 2026-05-13T07:57:31.015Z
+Version: 1.13.12  |  Generated: 2026-05-14T16:00:33.063Z
 
 This is a concise summary of all available API functions and types.
 
@@ -3024,11 +3024,31 @@ interface EmailVerifyTokenResponse {
 }
 ```
 
+**WhatsAppReplyCta** (interface)
+```typescript
+interface WhatsAppReplyCta {
+  body: string
+  buttonLabel: string
+  buttonUrl: string
+}
+```
+
+**WhatsAppReplyOptions** (interface)
+```typescript
+interface WhatsAppReplyOptions {
+  contentSid?: string
+  contentVariables?: Record<string, unknown>
+  cta?: WhatsAppReplyCta
+  text?: string
+}
+```
+
 **SendWhatsAppRequest** (interface)
 ```typescript
 interface SendWhatsAppRequest {
   phoneNumber?: string
   redirectUrl?: string
+  reply?: WhatsAppReplyOptions
 }
 ```
 

package/docs/auth-kit.md

@@ -88,9 +88,17 @@ import { authKit } from '@proveanything/smartlinks';
 // 1) Send WhatsApp verification deep link
 const wa = await authKit.sendWhatsApp(clientId);
 
-// Optional: pass redirect context only
+// Optional: pass redirect context and/or a post-verification reply
 // const wa = await authKit.sendWhatsApp(clientId, {
 //   redirectUrl: 'https://app.example.com/checkout/continue',
+//   reply: {
+//     cta: {
+//       body: "You're verified and ready to bid.",
+//       buttonLabel: 'Back to Auction',
+//       buttonUrl: '{{returnUrl}}',
+//     },
+//     text: "You're verified. Return to the app to continue.",
+//   },
 // });
 
 // wa.waLink can be opened directly by the app/browser
@@ -135,6 +143,27 @@ Verification status values returned by `authKit.getWhatsAppStatus` are:
 - `expired`
 - `unknown`
 
+#### Post-verification reply
+
+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`)
+3. `reply.text` — plain-text fallback
+4. Per-client default (`authKit/{clientId}.whatsapp` config)
+5. Built-in default text
+
+The following template placeholders are available in `reply.text`, `reply.cta` fields, and `reply.contentVariables` values:
+
+| Placeholder | Description |
+|---|---|
+| `{{returnUrl}}` | The resolved redirect URL |
+| `{{phoneNumber}}` | The verified phone number |
+| `{{clientId}}` | The Auth Kit client ID |
+| `{{token}}` | The verification token |
+
+> **Note:** `redirectUrl` is optional. WhatsApp tokens are short hex strings (16 chars) for better UX.
+
 ### Google OAuth
 
 ```ts

package/openapi.yaml

@@ -17864,6 +17864,31 @@ components:
       required:
         - success
         - message
+    WhatsAppReplyCta:
+      type: object
+      properties:
+        body:
+          type: string
+        buttonLabel:
+          type: string
+        buttonUrl:
+          type: string
+      required:
+        - body
+        - buttonLabel
+        - buttonUrl
+    WhatsAppReplyOptions:
+      type: object
+      properties:
+        contentSid:
+          type: string
+        contentVariables:
+          type: object
+          additionalProperties: true
+        cta:
+          $ref: "#/components/schemas/WhatsAppReplyCta"
+        text:
+          type: string
     SendWhatsAppRequest:
       type: object
       properties:
@@ -17871,6 +17896,8 @@ components:
           type: string
         redirectUrl:
           type: string
+        reply:
+          $ref: "#/components/schemas/WhatsAppReplyOptions"
     SendWhatsAppResponse:
       type: object
       properties:

package/package.json

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