lua-cli 3.1.0-alpha.3 → 3.1.0-alpha.5

package/template/examples/webhooks/FileUploadWebhook.ts

@@ -0,0 +1,86 @@
+/**
+ * File Upload Webhook
+ * 
+ * Receives file uploads from external systems and stores them in the CDN.
+ * 
+ * Use cases:
+ * - Customer uploads documents via your website form
+ * - Integration with document management systems
+ * - Receiving images/files from third-party services
+ * 
+ * Webhook URL: https://webhook.heylua.ai/{agentId}/file-upload
+ */
+
+import { LuaWebhook, CDN, Data, User } from "lua-cli";
+import { z } from "zod";
+
+const fileUploadWebhook = new LuaWebhook({
+  name: "file-upload",
+  description: "Receives file uploads and stores them in CDN",
+
+  headerSchema: z.object({
+    'content-type': z.string(),
+    'x-api-key': z.string().optional()
+  }),
+
+  bodySchema: z.object({
+    filename: z.string(),
+    contentType: z.string(),
+    data: z.string().describe("Base64 encoded file data"),
+    metadata: z.object({
+      category: z.string().optional(),
+      description: z.string().optional(),
+      tags: z.array(z.string()).optional()
+    }).optional()
+  }),
+
+  execute: async (event: any) => {
+    const { body } = event;
+    console.log(`📁 Receiving file upload: ${body.filename}`);
+
+    // Decode base64 data
+    const buffer = Buffer.from(body.data, 'base64');
+    const blob = new Blob([buffer], { type: body.contentType });
+    const file = new File([blob], body.filename, { type: body.contentType });
+
+    console.log(`📤 Uploading to CDN: ${file.name} (${file.size} bytes)`);
+
+    // Upload to CDN
+    const fileId = await CDN.upload(file);
+
+    console.log(`✅ File stored with ID: ${fileId}`);
+
+    // Store file metadata in custom data for later retrieval
+    const fileRecord = await Data.create('uploaded-files', {
+      fileId: fileId,
+      filename: body.filename,
+      contentType: body.contentType,
+      size: file.size,
+      category: body.metadata?.category || 'uncategorized',
+      description: body.metadata?.description,
+      tags: body.metadata?.tags || [],
+      uploadedAt: new Date().toISOString()
+    }, `${body.filename} ${body.metadata?.category || ''} ${body.metadata?.tags?.join(' ') || ''}`);
+
+    // Notify user about the upload
+    const user = await User.get();
+    if (user) {
+      await user.send([{
+        type: "text",
+        text: `📁 New file uploaded: ${body.filename}`
+      }]);
+    }
+
+    return {
+      success: true,
+      fileId: fileId,
+      recordId: fileRecord.id,
+      filename: body.filename,
+      size: file.size,
+      message: 'File uploaded and stored successfully'
+    };
+  }
+});
+
+export default fileUploadWebhook;
+

package/template/{src → examples}/webhooks/PaymentWebhook.ts

@@ -5,6 +5,10 @@
  * It validates signatures, processes payment events, and updates order status.
  * 
  * Common use case: Stripe webhook for payment confirmations
+ * 
+ * Webhook URLs:
+ *   https://webhook.heylua.ai/{agentId}/{webhookId}
+ *   https://webhook.heylua.ai/{agentId}/{webhook-name}
  */
 
 import { LuaWebhook, Orders, Data } from "lua-cli";
@@ -12,10 +16,7 @@ import { z } from "zod";
 
 const paymentWebhook = new LuaWebhook({
   name: "payment-notifications",
-  version: "1.0.0",
   description: "Receives payment notifications from payment providers",
-  context: "This webhook processes payment confirmation events from Stripe or other providers. " +
-           "It validates the payment, updates order status, and logs the transaction.",
 
   // Headers typically include webhook signature for verification
   headerSchema: z.object({
@@ -40,16 +41,18 @@ const paymentWebhook = new LuaWebhook({
     })
   }),
 
-  execute: async ({ headers, body }) => {
-    console.log(`💳 Payment event received:`, body.type);
+  execute: async (event: any) => {
+    const { headers, body } = event;
+    console.log(`💳 Payment event received:`, body?.type);
 
-    // In production: Verify Stripe signature
+    // In production: Verify Stripe signature manually in your execute function
     // const signature = headers['stripe-signature'];
-    // const isValid = verifyStripeSignature(body, signature);
+    // const secret = env('STRIPE_WEBHOOK_SECRET');
+    // const isValid = verifyStripeSignature(body, signature, secret);
     // if (!isValid) throw new Error('Invalid signature');
 
-    const payment = body.data.object;
-    const eventType = body.type;
+    const payment = body?.data?.object;
+    const eventType = body?.type;
 
     // Handle payment success
     if (eventType === 'payment_intent.succeeded') {

package/template/examples/webhooks/UserEventWebhook.ts

@@ -0,0 +1,105 @@
+/**
+ * User Event Webhook Example
+ * 
+ * This webhook receives user events from external systems (e.g., CRM, marketing tools).
+ * It validates incoming data, stores events for processing, and can send template
+ * messages using the Templates API (currently supports WhatsApp templates).
+ * 
+ * Webhook URLs:
+ *   https://webhook.heylua.ai/{agentId}/{webhookId}
+ *   https://webhook.heylua.ai/{agentId}/{webhook-name}
+ */
+
+import { LuaWebhook, Data, Templates } from "lua-cli";
+import { z } from "zod";
+
+const userEventWebhook = new LuaWebhook({
+  name: "user-events",
+  description: "Receives user events from external systems",
+
+  // Validate query parameters (optional source tracking)
+  querySchema: z.object({
+    source: z.string().optional(),
+    version: z.string().optional()
+  }),
+
+  // Validate headers (require API key for security)
+  headerSchema: z.object({
+    'x-api-key': z.string(),
+    'content-type': z.string().optional()
+  }),
+
+  // Validate request body
+  bodySchema: z.object({
+    eventType: z.enum(['signup', 'update', 'delete']),
+    userId: z.string(),
+    email: z.string().email(),
+    name: z.string().optional(),
+    phoneNumber: z.string().optional(),
+    channelId: z.string().optional(),
+    metadata: z.record(z.any()).optional(),
+    timestamp: z.string()
+  }),
+
+  execute: async (event: any) => {
+    const { query, headers, body } = event;
+    console.log(`📥 Received ${body?.eventType} event for user:`, body?.email);
+    console.log(`📍 Source:`, query?.source || 'unknown');
+
+    // Security: Validate API key (in production, use env variable)
+    const expectedKey = process.env.WEBHOOK_API_KEY || 'your-secret-key';
+    if (headers?.['x-api-key'] !== expectedKey) {
+      throw new Error('Invalid API key');
+    }
+
+    // Store the event in custom data collection
+    const eventData = {
+      ...body,
+      source: query?.source,
+      receivedAt: new Date().toISOString(),
+      processed: false
+    };
+
+    const result = await Data.create('user-events', eventData, 
+      `${body?.eventType} ${body?.email} ${body?.name || ''}`
+    );
+
+    console.log('✅ Event stored successfully:', result.id);
+
+    // Example: Send welcome template on signup using Templates API
+    // Uses Templates.whatsapp namespace for WhatsApp templates
+    let templateResult = null;
+    if (body?.eventType === 'signup' && body?.phoneNumber && body?.channelId) {
+      try {
+        // Search for a welcome template
+        const response = await Templates.whatsapp.list(body.channelId, { search: 'welcome' });
+        const welcomeTemplate = response.templates.find((t: any) => t.status === 'APPROVED');
+        
+        if (welcomeTemplate) {
+          // Send the template message
+          templateResult = await Templates.whatsapp.send(body.channelId, welcomeTemplate.id, {
+            phoneNumbers: [body.phoneNumber],
+            values: {
+              body: { name: body.name || 'there' }
+            }
+          });
+          console.log('📱 Welcome template sent:', templateResult.results[0]?.messages[0]?.id);
+        }
+      } catch (error: any) {
+        console.log('⚠️ Could not send welcome template:', error.message);
+      }
+    }
+
+    // Return success response
+    return {
+      success: true,
+      eventId: result.id,
+      userId: body?.userId,
+      templateSent: templateResult?.totalErrors === 0,
+      timestamp: new Date().toISOString()
+    };
+  }
+});
+
+export default userEventWebhook;
+