HTTP trigger script with preprocessor template

/**

 * General Trigger Preprocessor

 *

 * ⚠️ This function runs BEFORE the main function.

 *

 * It processes raw trigger data (e.g., MQTT, HTTP, SQS, WebSocket, Kafka, NATS) before passing it to `main()`.

 * Common tasks:

 * - Convert binary payloads to string/JSON

 * - Extract metadata

 * - Filter messages

 * - Add timestamps/context

 *

 * The returned object determines `main()` parameters:

 * - `{a: 1, b: 2}` → `main(a, b)`

 * - `{http}` → `main(http)`

 *

 * @param event - Trigger data (e.g., MQTT, HTTP, SQS, WebSocket, Kafka, NATS)

 * @returns Processed data for `main()`

 */

export async function preprocessor(

  event: {

    kind: 'http';

    body: any;

    raw_string: string | null;

    route: string;

    path: string;

    method: string;

    params: Record<string, string>; // path params

    query: Record<string, string>; // query params

    headers: Record<string, string>;

  }

) {

  if (event.kind === 'http') {

    return {

      body: event.body,

      params: event.params,

      query: event.query,

    };

  }

  throw new Error(`Expected http trigger kind, got: ${event.kind}`);

}

/**

 * Main Function - Handles processed trigger events

 *

 * ⚠️ Called AFTER `preprocessor()`, with its return values.

 *

 * @param body - HTTP request body

 * @param params - Path parameters from the HTTP request

 * @param query - Query parameters from the HTTP request

 */

export async function main(

  body: any,

  params: Record<string, string>,

  query: Record<string, string>

) {

  // Implement the main function logic here

}