idea-aws 3.9.1 → 3.10.2

package/dist/index.d.ts

@@ -10,3 +10,4 @@ export * from './src/ses';
 export * from './src/sns';
 export * from './src/translate';
 export * from './src/attachments';
+export * from './src/logger';

package/dist/index.js

@@ -22,3 +22,4 @@ __exportStar(require("./src/ses"), exports);
 __exportStar(require("./src/sns"), exports);
 __exportStar(require("./src/translate"), exports);
 __exportStar(require("./src/attachments"), exports);
+__exportStar(require("./src/logger"), exports);

package/dist/src/attachments.js

@@ -3,9 +3,6 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Attachments = void 0;
 const dynamoDB_1 = require("./dynamoDB");
 const s3_1 = require("./s3");
-// declare libs as global vars to be reused in warm starts by the Lambda function
-let ideaWarmStart_ddb = null;
-let ideaWarmStart_s3 = null;
 /**
  * A custom class that takes advantage of DynamoDB and S3 to easily manage attachments.
  */
@@ -16,12 +13,8 @@ class Attachments {
          */
         this.S3_ATTACHMENTS_BUCKET = process.env['S3_ATTACHMENTS_BUCKET'] || 'idea-attachments';
         this.IUID_ATTACHMENTS_PREFIX = process.env['IUID_ATTACHMENTS_PREFIX'] || 'ATT';
-        if (!ideaWarmStart_ddb)
-            ideaWarmStart_ddb = new dynamoDB_1.DynamoDB();
-        this.dynamo = ideaWarmStart_ddb;
-        if (!ideaWarmStart_s3)
-            ideaWarmStart_s3 = new s3_1.S3();
-        this.s3 = ideaWarmStart_s3;
+        this.dynamo = new dynamoDB_1.DynamoDB();
+        this.s3 = new s3_1.S3();
     }
     /**
      * Get a signedURL to put an attachment.

package/dist/src/cognito.js

@@ -3,16 +3,12 @@ Object.defineProperty(exports, "__esModule", { value: true });
 exports.Cognito = void 0;
 const aws_sdk_1 = require("aws-sdk");
 const idea_toolbox_1 = require("idea-toolbox");
-// declare libs as global vars to be reused in warm starts by the Lambda function
-let ideaWarmStart_cognito = null;
 /**
  * A wrapper for AWS Cognito.
  */
 class Cognito {
     constructor() {
-        if (!ideaWarmStart_cognito)
-            ideaWarmStart_cognito = new aws_sdk_1.CognitoIdentityServiceProvider({ apiVersion: '2016-04-18' });
-        this.cognito = ideaWarmStart_cognito;
+        this.cognito = new aws_sdk_1.CognitoIdentityServiceProvider({ apiVersion: '2016-04-18' });
     }
     /**
      * Change the region in which to find the user pool.
@@ -20,8 +16,7 @@ class Cognito {
      */
     setRegion(region) {
         // there is no quick way to change the region without re-creating the object
-        ideaWarmStart_cognito = new aws_sdk_1.CognitoIdentityServiceProvider({ apiVersion: this.cognito.config.apiVersion, region });
-        this.cognito = ideaWarmStart_cognito;
+        this.cognito = new aws_sdk_1.CognitoIdentityServiceProvider({ apiVersion: this.cognito.config.apiVersion, region });
     }
     /**
      * Get the attributes of the user, from the authorizer claims.

package/dist/src/comprehend.js

@@ -2,16 +2,12 @@
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.Comprehend = void 0;
 const aws_sdk_1 = require("aws-sdk");
-// declare libs as global vars to be reused in warm starts by the Lambda function
-let ideaWarmStart_comprehend = null;
 /**
  * A wrapper for Amazon Comprehend.
  */
 class Comprehend {
     constructor() {
-        if (!ideaWarmStart_comprehend)
-            ideaWarmStart_comprehend = new aws_sdk_1.Comprehend({ apiVersion: '2017-11-27' });
-        this.comprehend = ideaWarmStart_comprehend;
+        this.comprehend = new aws_sdk_1.Comprehend({ apiVersion: '2017-11-27' });
     }
     /**
      * Inspects text and returns an inference of the prevailing sentiment (POSITIVE, NEUTRAL, MIXED, or NEGATIVE).

package/dist/src/dynamoDB.js

@@ -6,17 +6,14 @@ const uuid_1 = require("uuid");
 const nanoid_1 = require("nanoid");
 const NanoID = (0, nanoid_1.customAlphabet)('0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZabcdefghijklmnopqrstuvwxyz', 25);
 const shortid_1 = require("shortid");
-const idea_toolbox_1 = require("idea-toolbox");
-// declare libs as global vars to be reused in warm starts by the Lambda function
-let ideaWarmStart_ddb = null;
+const logger_1 = require("./logger");
+const logger = new logger_1.Logger();
 /**
  * A wrapper for AWS DynamoDB.
  */
 class DynamoDB {
     constructor() {
-        if (!ideaWarmStart_ddb)
-            ideaWarmStart_ddb = new aws_sdk_1.DynamoDB.DocumentClient();
-        this.dynamo = ideaWarmStart_ddb;
+        this.dynamo = new aws_sdk_1.DynamoDB.DocumentClient();
     }
     /**
      * Convert a JSON object from dynamoDB format to simple JSON.
@@ -104,7 +101,7 @@ class DynamoDB {
      * @param key the key of the counter
      */
     async getAtomicCounterByKey(key) {
-        (0, idea_toolbox_1.logger)(`GET ATOMIC COUNTER FOR ${key}`);
+        logger.debug(`Get atomic counter for ${key}`);
         const result = await this.update({
             TableName: 'idea_atomicCounters',
             Key: { key },
@@ -121,7 +118,7 @@ class DynamoDB {
      * Get an item of a DynamoDB table.
      */
     async get(params) {
-        (0, idea_toolbox_1.logger)(`GET ${params.TableName}`);
+        logger.debug(`Get ${params.TableName}`);
         const result = await this.dynamo.get(params).promise();
         if (!result?.Item)
             throw new Error('Not found');
@@ -131,21 +128,21 @@ class DynamoDB {
      * Put an item in a DynamoDB table.
      */
     async put(params) {
-        (0, idea_toolbox_1.logger)(`PUT ${params.TableName}`);
+        logger.debug(`Put ${params.TableName}`);
         return await this.dynamo.put(params).promise();
     }
     /**
      * Update an item of a DynamoDB table.
      */
     async update(params) {
-        (0, idea_toolbox_1.logger)(`UPDATE ${params.TableName}`);
+        logger.debug(`Update ${params.TableName}`);
         return await this.dynamo.update(params).promise();
     }
     /**
      * Delete an item of a DynamoDB table.
      */
     async delete(params) {
-        (0, idea_toolbox_1.logger)(`DELETE ${params.TableName}`);
+        logger.debug(`Delete ${params.TableName}`);
         return await this.dynamo.delete(params).promise();
     }
     /**
@@ -154,7 +151,7 @@ class DynamoDB {
      */
     async batchGet(table, keys, ignoreErr) {
         if (!keys.length) {
-            (0, idea_toolbox_1.logger)(`BATCH GET ${table}`, null, 'No elements to get');
+            logger.debug(`Batch get ${table}: no elements to get`);
             return [];
         }
         return await this.batchGetHelper(table, keys, [], Boolean(ignoreErr));
@@ -165,7 +162,7 @@ class DynamoDB {
                 [table]: { Keys: keys.slice(currentChunk, currentChunk + chunkSize) }
             }
         };
-        (0, idea_toolbox_1.logger)(`BATCH GET ${table}`, null, `${currentChunk} of ${keys.length}`);
+        logger.debug(`Batch get ${table}: ${currentChunk} of ${keys.length}`);
         let result;
         try {
             result = await this.dynamo.batchGet(batch).promise();
@@ -190,7 +187,7 @@ class DynamoDB {
      */
     async batchPut(table, items) {
         if (!items.length)
-            return (0, idea_toolbox_1.logger)(`BATCH WRITE (PUT) ${table}`, null, 'No elements to write');
+            return logger.debug(`Batch write (put) ${table}: no elements to write`);
         await this.batchWriteHelper(table, items, true);
     }
     /**
@@ -200,11 +197,11 @@ class DynamoDB {
      */
     async batchDelete(table, keys) {
         if (!keys.length)
-            return (0, idea_toolbox_1.logger)(`BATCH WRITE (DELETE) ${table}`, null, 'No elements to write');
+            return logger.debug(`Batch write (delete) ${table}: no elements to write`);
         await this.batchWriteHelper(table, keys, false);
     }
     async batchWriteHelper(table, itemsOrKeys, isPut, currentChunk = 0, chunkSize = 25) {
-        (0, idea_toolbox_1.logger)(`BATCH WRITE (${isPut ? 'PUT' : 'DELETE'}) ${table}`, null, `${currentChunk} of ${itemsOrKeys.length}`);
+        logger.debug(`Batch write (${isPut ? 'put' : 'delete'}) ${table}: ${currentChunk} of ${itemsOrKeys.length}`);
         let requests;
         if (isPut)
             requests = itemsOrKeys.slice(currentChunk, currentChunk + chunkSize).map(i => ({ PutRequest: { Item: i } }));
@@ -229,7 +226,7 @@ class DynamoDB {
                 params.RequestItems = response.UnprocessedItems;
                 attempts++;
                 const waitSeconds = getRandomInt(attempts * 5);
-                (0, idea_toolbox_1.logger)('BATCH WRITE THROTTLED', null, `Waiting ${waitSeconds} seconds to retry`);
+                logger.debug(`Batch write throttled: waiting ${waitSeconds} seconds to retry`);
                 await wait(waitSeconds);
             }
             else {
@@ -242,9 +239,9 @@ class DynamoDB {
      * @param params the params to apply to DynamoDB's function
      */
     async query(params) {
-        (0, idea_toolbox_1.logger)(`Query ${params.TableName}`);
+        logger.debug(`Query ${params.TableName}`);
         const result = await this.queryScanHelper(params, [], true);
-        (0, idea_toolbox_1.logger)(`\tResults query ${params.TableName}`, null, result?.length || 0);
+        logger.debug(`Results query ${params.TableName}: ${result?.length || 0}`);
         return result;
     }
     /**
@@ -252,9 +249,9 @@ class DynamoDB {
      * @param params the params to apply to DynamoDB's function
      */
     async scan(params) {
-        (0, idea_toolbox_1.logger)(`Scan ${params.TableName}`);
+        logger.debug(`Scan ${params.TableName}`);
         const result = await this.queryScanHelper(params, [], false);
-        (0, idea_toolbox_1.logger)(`\tResults scan ${params.TableName}`, null, result?.length || 0);
+        logger.debug(`Results scan ${params.TableName}: ${result?.length || 0}`);
         return result;
     }
     async queryScanHelper(params, items, isQuery) {
@@ -276,9 +273,9 @@ class DynamoDB {
      * @param params the params to apply to DynamoDB's function
      */
     async queryClassic(params) {
-        (0, idea_toolbox_1.logger)(`Query classic ${params.TableName}`);
+        logger.debug(`Query classic ${params.TableName}`);
         const result = await this.dynamo.query(params).promise();
-        (0, idea_toolbox_1.logger)(`\tResults query classic ${params.TableName}`, null, result?.Items?.length || 0);
+        logger.debug(`Results query classic ${params.TableName}: ${result?.Items?.length || 0}`);
         return result;
     }
     /**
@@ -286,9 +283,9 @@ class DynamoDB {
      * @param params the params to apply to DynamoDB's function
      */
     async scanClassic(params) {
-        (0, idea_toolbox_1.logger)(`Scan classic ${params.TableName}`);
+        logger.debug(`Scan classic ${params.TableName}`);
         const result = await this.dynamo.scan(params).promise();
-        (0, idea_toolbox_1.logger)(`\tResults scan classic ${params.TableName}`, null, result?.Items?.length || 0);
+        logger.debug(`Results scan classic ${params.TableName}: ${result?.Items?.length || 0}`);
         return result;
     }
     /**
@@ -297,8 +294,8 @@ class DynamoDB {
      */
     async transactWrites(ops) {
         if (!ops.length)
-            return (0, idea_toolbox_1.logger)('TRANSACTION WRITES', null, 'No elements to write');
-        (0, idea_toolbox_1.logger)('TRANSACTION WRITES');
+            return logger.debug('Transaction writes: no elements to write');
+        logger.debug('Transaction writes');
         await this.dynamo.transactWrite({ TransactItems: ops.slice(0, 10) }).promise();
     }
     /**

package/dist/src/genericController.d.ts

@@ -7,6 +7,7 @@ import { Translate } from './translate';
 import { Comprehend } from './comprehend';
 import { SecretsManager } from './secretsManager';
 import { Attachments } from './attachments';
+import { Logger } from './logger';
 /**
  * An abstract class to inherit to manage some resources with an AWS Lambda function.
  */
@@ -23,6 +24,7 @@ export declare abstract class GenericController {
     protected _secrets: SecretsManager;
     protected _attachments: Attachments;
     tables: any;
+    protected logger: Logger;
     protected logRequestsWithKey: string;
     /**
      * Initialize a new GenericController helper object.
@@ -37,31 +39,57 @@ export declare abstract class GenericController {
     /**
      * Default callback for the Lambda.
      */
-    protected done(err: Error | null, res?: any): void;
+    protected done(err: any, res?: any): void;
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get dynamoDB(): DynamoDB;
     protected set dynamoDB(dynamoDB: DynamoDB);
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get cognito(): Cognito;
     protected set cognito(cognito: Cognito);
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get s3(): S3;
     protected set s3(s3: S3);
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get ses(): SES;
     protected set ses(ses: SES);
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get sns(): SNS;
     protected set sns(sns: SNS);
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get translate(): Translate;
     protected set translate(translate: Translate);
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get comprehend(): Comprehend;
     protected set comprehend(comprehend: Comprehend);
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     protected get secrets(): SecretsManager;
     protected set secrets(secrets: SecretsManager);
     /**
      * Manage attachments (through SignedURLs).
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
      */
     get attachments(): Attachments;
     set attachments(attachments: Attachments);
 }
 /**
  * The initial options for a constructor of class GenericController.
+ * @deprecated following new IAC standards.
  */
 export interface GenericControllerOptions {
     /**

package/dist/src/genericController.js

@@ -1,7 +1,6 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
 exports.GenericController = void 0;
-const idea_toolbox_1 = require("idea-toolbox");
 const dynamoDB_1 = require("./dynamoDB");
 const cognito_1 = require("./cognito");
 const s3_1 = require("./s3");
@@ -11,6 +10,7 @@ const translate_1 = require("./translate");
 const comprehend_1 = require("./comprehend");
 const secretsManager_1 = require("./secretsManager");
 const attachments_1 = require("./attachments");
+const logger_1 = require("./logger");
 /**
  * An abstract class to inherit to manage some resources with an AWS Lambda function.
  */
@@ -21,23 +21,27 @@ class GenericController {
      * @param callback the callback to resolve or reject the execution
      */
     constructor(event, callback, options = {}) {
+        this.logger = new logger_1.Logger();
         this.event = event;
         this.callback = callback;
         this.tables = options.tables || {};
-        // set the logs to print objects deeper
-        // eslint-disable-next-line @typescript-eslint/no-var-requires
-        require('util').inspect.defaultOptions.depth = null;
     }
     /**
      * Default callback for the Lambda.
      */
     done(err, res) {
-        (0, idea_toolbox_1.logger)(err ? 'DONE WITH ERRORS' : 'DONE', err, res, true);
+        if (err)
+            this.logger.info('END-FAILED', { error: err.message || err.errorMessage });
+        else
+            this.logger.info('END-SUCCESS');
         this.callback(err, res);
     }
     ///
     /// AWS SERVICES
     ///
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get dynamoDB() {
         if (!this._dynamoDB)
             this._dynamoDB = new dynamoDB_1.DynamoDB();
@@ -46,6 +50,9 @@ class GenericController {
     set dynamoDB(dynamoDB) {
         this._dynamoDB = dynamoDB;
     }
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get cognito() {
         if (!this._cognito)
             this._cognito = new cognito_1.Cognito();
@@ -54,6 +61,9 @@ class GenericController {
     set cognito(cognito) {
         this._cognito = cognito;
     }
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get s3() {
         if (!this._s3)
             this._s3 = new s3_1.S3();
@@ -62,6 +72,9 @@ class GenericController {
     set s3(s3) {
         this._s3 = s3;
     }
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get ses() {
         if (!this._ses)
             this._ses = new ses_1.SES();
@@ -70,6 +83,9 @@ class GenericController {
     set ses(ses) {
         this._ses = ses;
     }
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get sns() {
         if (!this._sns)
             this._sns = new sns_1.SNS();
@@ -78,6 +94,9 @@ class GenericController {
     set sns(sns) {
         this._sns = sns;
     }
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get translate() {
         if (!this._translate)
             this._translate = new translate_1.Translate();
@@ -86,6 +105,9 @@ class GenericController {
     set translate(translate) {
         this._translate = translate;
     }
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get comprehend() {
         if (!this._comprehend)
             this._comprehend = new comprehend_1.Comprehend();
@@ -94,6 +116,9 @@ class GenericController {
     set comprehend(comprehend) {
         this._comprehend = comprehend;
     }
+    /**
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
+     */
     get secrets() {
         if (!this._secrets)
             this._secrets = new secretsManager_1.SecretsManager();
@@ -107,6 +132,7 @@ class GenericController {
     ///
     /**
      * Manage attachments (through SignedURLs).
+     * @deprecated use external object to improve cold starts. See most recent projects for reference.
      */
     get attachments() {
         if (!this._attachments)

package/dist/src/logger.d.ts

@@ -0,0 +1,19 @@
+/**
+ * Manage structured logging.
+ */
+export declare class Logger {
+    level: string;
+    private originalLevel;
+    constructor({ level }?: {
+        level?: string;
+    });
+    isEnabled(level: number): boolean;
+    appendError(params: any, err: Error): any;
+    log(levelName: string, message: string, params: any): void;
+    debug(msg: string, params?: any): void;
+    info(msg: string, params?: any): void;
+    warn(msg: string, err: Error | any, params?: any): void;
+    error(msg: string, err: Error | any, params?: any): void;
+    enableDebug(): () => void;
+    resetLevel(): void;
+}

package/dist/src/logger.js

@@ -0,0 +1,53 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.Logger = void 0;
+/**
+ * Manage structured logging.
+ */
+class Logger {
+    constructor({ level = process.env.LOG_LEVEL } = {}) {
+        this.level = (level || 'DEBUG').toUpperCase();
+        this.originalLevel = this.level;
+    }
+    isEnabled(level) {
+        return level >= (LogLevels[this.level] || LogLevels.DEBUG);
+    }
+    appendError(params, err) {
+        if (!err)
+            return params;
+        return { ...(params || {}), errorName: err.name, errorMessage: err.message, stackTrace: err.stack };
+    }
+    log(levelName, message, params) {
+        const level = LogLevels[levelName];
+        if (!this.isEnabled(level))
+            return;
+        const logMsg = { ...params, level, sLevel: levelName, message };
+        const consoleMethods = { DEBUG: console.debug, INFO: console.info, WARN: console.warn, ERROR: console.error };
+        // re-order message and params to appear earlier in the log row
+        consoleMethods[levelName](JSON.stringify({ message, ...params, ...logMsg }, (_, value) => typeof value === 'bigint' ? value.toString() : value));
+    }
+    debug(msg, params = {}) {
+        this.log('DEBUG', msg, params);
+    }
+    info(msg, params = {}) {
+        this.log('INFO', msg, params);
+    }
+    warn(msg, err, params = {}) {
+        const parameters = this.appendError(params, err);
+        this.log('WARN', msg, parameters);
+    }
+    error(msg, err, params = {}) {
+        const parameters = this.appendError(params, err);
+        this.log('ERROR', msg, parameters);
+    }
+    enableDebug() {
+        this.level = 'DEBUG';
+        return () => this.resetLevel();
+    }
+    resetLevel() {
+        this.level = this.originalLevel;
+    }
+}
+exports.Logger = Logger;
+// levels here are identical to bunyan practices (https://github.com/trentm/node-bunyan#levels)
+const LogLevels = { DEBUG: 20, INFO: 30, WARN: 40, ERROR: 50 };

package/dist/src/resourceController.d.ts

@@ -1,28 +1,39 @@
+import 'source-map-support/register';
+import { APIGatewayProxyEventV2, APIGatewayProxyEvent, Callback } from 'aws-lambda';
 import { CognitoUser } from 'idea-toolbox';
+import { Logger } from './logger';
 import { GenericController, GenericControllerOptions } from './genericController';
 /**
  * An abstract class to inherit to manage API requests (AWS API Gateway) in an AWS Lambda function.
  */
 export declare abstract class ResourceController extends GenericController {
+    protected event: APIGatewayProxyEventV2 | APIGatewayProxyEvent;
+    protected callback: Callback;
     protected authorization: string;
     protected claims: any;
     protected principalId: string;
-    protected user: CognitoUser;
+    protected cognitoUser: CognitoUser;
     protected stage: string;
     protected httpMethod: string;
-    body: any;
-    queryParams: any;
+    protected body: any;
+    protected queryParams: any;
     protected resource: string;
     protected path: string;
+    protected pathParameters: any;
     protected resourceId: string;
+    protected returnStatusCode?: number;
+    protected logger: Logger;
     protected logRequestsWithKey: string;
     protected currentLang: string;
     protected defaultLang: string;
     protected translations: any;
     protected templateMatcher: RegExp;
-    constructor(event: any, callback: any, options?: ResourceControllerOptions);
-    handleRequest: () => void;
-    protected done(err: Error | null, res?: any, statusCode?: number): void;
+    constructor(event: APIGatewayProxyEventV2 | APIGatewayProxyEvent, callback: Callback, options?: ResourceControllerOptions);
+    private initFromEventV2;
+    private initFromEventV1;
+    handleRequest: () => Promise<void>;
+    private controlHandlerError;
+    protected done(err: any, res?: any, statusCode?: number): void;
     /**
      * To @override
      */
@@ -95,6 +106,9 @@ export declare abstract class ResourceController extends GenericController {
      * @deprecated don't run a Lambda from another Lambda (bad practice)
      */
     invokeInternalAPIRequest(params: InternalAPIRequestParams): Promise<any>;
+    private invokeInternalAPIRequestWithLambda;
+    private invokeInternalAPIRequestWithEventBridge;
+    private mapEventForInternalApiRequest;
     /**
      * Whether the current request comes from an internal API request, i.e. it was invoked by another controller.
      * @deprecated don't run a Lambda from another Lambda (bad practice)
@@ -139,13 +153,26 @@ export interface ResourceControllerOptions extends GenericControllerOptions {
 }
 /**
  * The parameters needed to invoke an internal API request.
- * @deprecated don't run a Lambda from another Lambda (bad practice)
+ * @deprecated don't run a Lambda from another Lambda (bad practice).
  */
 export interface InternalAPIRequestParams {
     /**
-     * The name of the lambda function receiving the request; e.g. `project_memberships`.
+     * The name of the Lambda function receiving the request; e.g. `project_memberships`.
+     * Note: the invocation is always syncronous.
+     * Either this attribute or `eventBus` must be set.
      */
-    lambda: string;
+    lambda?: string;
+    /**
+     * The EventBridge destination of the request.
+     * If the bus name or ARN isn't specified, the default one is used.
+     * The `target` maps into the `DetailType` of the event.
+     * Note: the invocation is always asyncronous.
+     * Either this attribute or `lambda` must be set.
+     */
+    eventBridge?: {
+        bus?: string;
+        target?: string;
+    };
     /**
      * The alias of the lambda function to invoke. Default: the value of the current API stage.
      */
@@ -175,3 +202,9 @@ export interface InternalAPIRequestParams {
      */
     body?: any;
 }
+/**
+ * Explicitly define a specific type of error to use in the RC's handler, to distinguish it from the normal errors.
+ */
+export declare class RCError extends Error {
+    constructor(message: string);
+}