1 | |
2 | * General Trigger Preprocessor |
3 | * |
4 | * ⚠️ This function runs BEFORE the main function. |
5 | * |
6 | * It processes raw trigger data (e.g., MQTT, HTTP, SQS, WebSocket, Kafka, NATS) before passing it to main(). |
7 | * Common tasks: |
8 | * - Convert binary payloads to string/JSON |
9 | * - Extract metadata |
10 | * - Filter messages |
11 | * - Add timestamps/context |
12 | * |
13 | * The returned object determines main() parameters: |
14 | * - {a: 1, b: 2} → main(a, b) |
15 | * - {msg} → main(msg) |
16 | * |
17 | * @param event - Trigger data (e.g., MQTT, HTTP, SQS, WebSocket, Kafka, NATS) |
18 | * @returns Processed data for main() |
19 | */ |
20 | export async function preprocessor( |
21 | event: { |
22 | kind: 'nats', |
23 | payload: string, // base64 encoded payload |
24 | servers: string[], |
25 | subject: string, |
26 | headers?: Record<string, string[]>, |
27 | status?: number, |
28 | description?: string, |
29 | length: number |
30 | }, |
31 | ) { |
32 | if (event.kind === 'nats') { |
33 | try { |
34 | const msg = atob(event.payload) |
35 | |
36 | const data = JSON.parse(msg); |
37 |
|
38 | return { |
39 | msg, |
40 | data, |
41 | nats: event.headers |
42 | }; |
43 | } catch (error) { |
44 | throw new Error("Failed to parse NATS message as JSON"); |
45 | } |
46 | |
47 | } |
48 | |
49 | throw new Error(`Expected nats trigger kind, got: ${event.kind}`); |
50 | } |
51 |
|
52 | |
53 | * Main Function - Handles processed trigger events |
54 | * |
55 | * ⚠️ Called AFTER preprocessor(), with its return values. |
56 | * |
57 | * @param msg - Decoded message content |
58 | * @param data - Parsed JSON data from the NATS message |
59 | * @param headers - messages headers |
60 | */ |
61 | export async function main( |
62 | msg: string, |
63 | data: any, |
64 | headers?: Record<string, string[]> |
65 | ) { |
66 | |
67 | } |
68 |
|