lua-cli 3.21.0 → 3.22.0

package/docs/README.md

@@ -1,6 +1,6 @@
-# lua-cli v3.21.0
+# lua-cli v3.22.0
 
-Welcome to the comprehensive API documentation for lua-cli v3.21.0. This guide covers every API, class, and function exported by the package.
+Welcome to the comprehensive API documentation for lua-cli v3.22.0. This guide covers every API, class, and function exported by the package.
 
 ## 📚 Documentation Index
 

package/docs/api/Templates.md

@@ -107,7 +107,7 @@ Sends a template message to one or more phone numbers.
 - `data` (object)
   - `phoneNumbers` (string[]) - Array of phone numbers (E.164 format)
   - `values` (object, optional) - Template variable values
-    - `header` (object) - Header variables (key-value pairs). For media-header templates, pass the media URL instead: `image_url` (IMAGE), `video_url` (VIDEO), or `document_url` + optional `document_filename` (DOCUMENT). URLs must be publicly reachable over HTTPS.
+    - `header` (object) - Header variables (key-value pairs). For media-header templates, pass the media instead, either as a URL — `image_url` (IMAGE), `video_url` (VIDEO), `document_url` + optional `document_filename` (DOCUMENT), all of which must be publicly reachable over HTTPS — or as a Meta media id: `image_id`, `video_id`, `document_id`. An id takes precedence if both are given.
     - `body` (object) - Body variables (key-value pairs)
     - `buttons` (array) - Button values
 
@@ -154,6 +154,29 @@ const response = await Templates.whatsapp.send(
 );
 ```
 
+**Example (media header by Meta media id):**
+```typescript
+// Upload the image to Meta once via POST /{phone-number-id}/media, then reuse the returned
+// media id across every send. WhatsApp skips the per-send URL fetch entirely, which is the
+// cheaper and more reliable option for bulk campaigns.
+//
+// Three constraints: the id must come from POST /{phone-number-id}/media (NOT the Resumable
+// Upload API, whose "h:..." handle is only valid for template creation); it is scoped to the
+// business phone number it was uploaded on, which must be the one behind this channel; and
+// Meta expires media ids after 30 days.
+const response = await Templates.whatsapp.send(
+  'channel_123',
+  'promo_template',
+  {
+    phoneNumbers: ['+1234567890'],
+    values: {
+      header: { image_id: '1234567890123456' },
+      body: { discount: '20%' }
+    }
+  }
+);
+```
+
 ## Template Structure
 
 ### Template Components

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "lua-cli",
-  "version": "3.21.0",
+  "version": "3.22.0",
   "description": "Build, test, and deploy AI agents with custom tools, webhooks, and scheduled jobs. Features LuaAgent unified configuration, streaming chat, and batch deployment.",
   "readmeFilename": "README.md",
   "main": "dist/api-exports.js",
@@ -110,8 +110,8 @@
     "ts-node": "^10.9.2",
     "tsup": "^8.5.1",
     "@lua/shared-source-sync": "0.0.1",
-    "@lua/shared-sandbox": "0.0.1",
-    "@lua/shared-types": "0.0.1"
+    "@lua/shared-types": "0.0.1",
+    "@lua/shared-sandbox": "0.0.1"
   },
   "scripts": {
     "clean": "rm -rf dist temp",

package/template/package.json

@@ -20,7 +20,7 @@
     "inquirer": "^12.9.6",
     "stripe": "^17.5.0",
     "js-yaml": "^4.1.0",
-    "lua-cli": "^3.21.0",
+    "lua-cli": "^3.22.0",
     "openai": "^5.23.0",
     "uuid": "^13.0.0",
     "zod": "^3.24.1"