@incloodsolutions/devkit 0.0.2 → 0.0.3

package/dist/aws/cdk/constructs/cloudwatch-construct.d.ts

@@ -0,0 +1,36 @@
+import { Construct } from 'constructs';
+import { LogGroup, LogGroupProps } from 'aws-cdk-lib/aws-logs';
+import { IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseCloudwatchLogGroupConstruct
+ *
+ * Provides configuration for creating a CloudWatch Log Group
+ * with optional overrides for retention and removal policy.
+ */
+interface ILogGroupConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** Log Group configuration options */
+    readonly logGroupOptions: LogGroupProps;
+}>, 'appName' | 'stage' | 'stackName'> {
+}
+/**
+ * CDK construct for CloudWatch Log Group
+ *
+ * Responsibilities:
+ * - Creates a log group with configurable options
+ * - Applies default removal policy and retention if not provided
+ * - Exposes the log group ARN as a CloudFormation output
+ */
+declare class BaseCloudwatchLogGroupConstruct extends Construct {
+    /** The created CloudWatch Log Group instance */
+    readonly logGroup: LogGroup;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for the log group
+     */
+    constructor(scope: Construct, id: string, props: ILogGroupConstructProps);
+}
+
+export { BaseCloudwatchLogGroupConstruct };

package/dist/aws/cdk/constructs/cloudwatch-construct.js

@@ -0,0 +1,41 @@
+import { Construct } from 'constructs';
+import { RemovalPolicy, CfnOutput } from 'aws-cdk-lib';
+import { LogGroup, RetentionDays } from 'aws-cdk-lib/aws-logs';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseCloudwatchLogGroupConstruct = class extends Construct {
+  static {
+    __name(this, "BaseCloudwatchLogGroupConstruct");
+  }
+  /** The created CloudWatch Log Group instance */
+  logGroup;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for the log group
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.logGroup = new LogGroup(this, id, {
+      ...props.options?.logGroupOptions,
+      /**
+       * Removal policy applied to the log group
+       * Defaults to DESTROY when not explicitly defined
+       */
+      removalPolicy: props?.options?.logGroupOptions?.removalPolicy || RemovalPolicy.DESTROY,
+      /**
+       * Log retention period
+       * Defaults to INFINITE when not explicitly defined
+       */
+      retention: props?.options?.logGroupOptions?.retention || RetentionDays.INFINITE
+    });
+    new CfnOutput(this, "CloudwatchArn", {
+      value: this.logGroup.logGroupArn
+    });
+  }
+};
+
+export { BaseCloudwatchLogGroupConstruct };
+//# sourceMappingURL=cloudwatch-construct.js.map
+//# sourceMappingURL=cloudwatch-construct.js.map

package/dist/aws/cdk/constructs/cloudwatch-construct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/cloudwatch-construct.ts"],"names":[],"mappings":";;;;;;AAyBO,IAAM,+BAAA,GAAN,cAA8C,SAAA,CAAU;AAAA,EAzB/D;AAyB+D,IAAA,MAAA,CAAA,IAAA,EAAA,iCAAA,CAAA;AAAA;AAAA;AAAA,EAErD,QAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAgC;AACzE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,QAAA,GAAW,IAAI,QAAA,CAAS,IAAA,EAAM,EAAA,EAAI;AAAA,MACtC,GAAG,MAAM,OAAA,EAAS,eAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMlB,aAAA,EACC,KAAA,EAAO,OAAA,EAAS,eAAA,EAAiB,iBAC9B,aAAA,CAAc,OAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMlB,SAAA,EACC,KAAA,EAAO,OAAA,EAAS,eAAA,EAAiB,aAC9B,aAAA,CAAc;AAAA,KAClB,CAAA;AAKD,IAAA,IAAI,SAAA,CAAU,MAAM,eAAA,EAAiB;AAAA,MACpC,KAAA,EAAO,KAAK,QAAA,CAAS;AAAA,KACrB,CAAA;AAAA,EACF;AACD","file":"cloudwatch-construct.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { LogGroup, LogGroupProps, RetentionDays } from 'aws-cdk-lib/aws-logs';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseCloudwatchLogGroupConstruct\n *\n * Provides configuration for creating a CloudWatch Log Group\n * with optional overrides for retention and removal policy.\n */\ninterface ILogGroupConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** Log Group configuration options */\n\treadonly logGroupOptions: LogGroupProps\n}>, 'appName' | 'stage' | 'stackName'> { }\n\n/**\n * CDK construct for CloudWatch Log Group\n *\n * Responsibilities:\n * - Creates a log group with configurable options\n * - Applies default removal policy and retention if not provided\n * - Exposes the log group ARN as a CloudFormation output\n */\nexport class BaseCloudwatchLogGroupConstruct extends Construct {\n\t/** The created CloudWatch Log Group instance */\n\treadonly logGroup: LogGroup;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for the log group\n\t */\n\tconstructor(scope: Construct, id: string, props: ILogGroupConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.logGroup = new LogGroup(this, id, {\n\t\t\t...props.options?.logGroupOptions,\n\n\t\t\t/**\n\t\t\t * Removal policy applied to the log group\n\t\t\t * Defaults to DESTROY when not explicitly defined\n\t\t\t */\n\t\t\tremovalPolicy:\n\t\t\t\tprops?.options?.logGroupOptions?.removalPolicy\n\t\t\t\t|| RemovalPolicy.DESTROY,\n\n\t\t\t/**\n\t\t\t * Log retention period\n\t\t\t * Defaults to INFINITE when not explicitly defined\n\t\t\t */\n\t\t\tretention:\n\t\t\t\tprops?.options?.logGroupOptions?.retention\n\t\t\t\t|| RetentionDays.INFINITE,\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the Log Group ARN\n\t\t */\n\t\tnew CfnOutput(this, 'CloudwatchArn', {\n\t\t\tvalue: this.logGroup.logGroupArn\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/dynamo-db-construct.cjs

@@ -0,0 +1,113 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsDynamodb = require('aws-cdk-lib/aws-dynamodb');
+var toolkit = require('@incloodsolutions/toolkit');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseDynamoDBConstruct = class _BaseDynamoDBConstruct extends constructs.Construct {
+  static {
+    __name(this, "BaseDynamoDBConstruct");
+  }
+  /** Newly created DynamoDB table (null if importing existing table) */
+  table;
+  /** Imported DynamoDB table reference (null if creating new table) */
+  existingTable;
+  /** Enables debug logging */
+  enableDebug = false;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for table creation or import
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.enableDebug = props?.enableDebug;
+    if (props.options?.fromExistingTableName) {
+      this.table = null;
+      this.existingTable = awsDynamodb.Table.fromTableName(
+        this,
+        `${id}-RefName`,
+        props.options.fromExistingTableName
+      );
+      if (this.enableDebug) {
+        toolkit.printLog(
+          _BaseDynamoDBConstruct.name,
+          `Created Dynamo-DB table from existing using name ${props.options?.fromExistingTableName}`
+        );
+      }
+    } else if (props.options?.fromExistingTableArn) {
+      this.table = null;
+      this.existingTable = awsDynamodb.Table.fromTableArn(
+        this,
+        `${id}-RefArn`,
+        props.options.fromExistingTableArn
+      );
+      if (this.enableDebug) {
+        toolkit.printLog(
+          _BaseDynamoDBConstruct.name,
+          `Created Dynamo-DB table from existing using ARN`
+        );
+      }
+    } else if (props.options?.fromExistingTableAttributes) {
+      this.table = null;
+      this.existingTable = awsDynamodb.Table.fromTableAttributes(
+        this,
+        `${id}-RefAttributes`,
+        props.options.fromExistingTableAttributes
+      );
+      if (this.enableDebug) {
+        toolkit.printLog(
+          _BaseDynamoDBConstruct.name,
+          `Created Dynamo-DB table from existing attributes`
+        );
+      }
+    } else {
+      this.existingTable = null;
+      this.table = new awsDynamodb.Table(this, id, {
+        ...props.options?.tableOptions,
+        /**
+         * Billing mode defaults to PAY_PER_REQUEST if not provided
+         */
+        billingMode: props.options?.tableOptions?.billingMode || awsDynamodb.BillingMode.PAY_PER_REQUEST,
+        /**
+         * Deletion protection:
+         * - Uses explicit value if provided
+         * - Defaults to true in production stage
+         */
+        deletionProtection: props.options?.tableOptions?.deletionProtection === true || props.options?.tableOptions?.deletionProtection === false ? props.options.tableOptions.deletionProtection : props.stage === "production"
+      });
+      if (props.options?.globalSecondaryIndexes?.length) {
+        props.options.globalSecondaryIndexes.forEach((globalIndex) => {
+          this.table.addGlobalSecondaryIndex(globalIndex);
+          if (this.enableDebug) {
+            toolkit.printLog(
+              _BaseDynamoDBConstruct.name,
+              `Added GSI: ${globalIndex.indexName}`
+            );
+          }
+        });
+      }
+      if (props.options?.localSecondaryIndexes?.length) {
+        props.options.localSecondaryIndexes.forEach((localIndex) => {
+          this.table.addLocalSecondaryIndex(localIndex);
+          if (this.enableDebug) {
+            toolkit.printLog(
+              _BaseDynamoDBConstruct.name,
+              `Added LSI: ${localIndex.indexName}`
+            );
+          }
+        });
+      }
+    }
+    new awsCdkLib.CfnOutput(this, "DynamoDbArn", {
+      value: props.options?.fromExistingTableName || props.options?.fromExistingTableArn ? this.existingTable.tableArn : this.table.tableArn
+    });
+  }
+};
+
+exports.BaseDynamoDBConstruct = BaseDynamoDBConstruct;
+//# sourceMappingURL=dynamo-db-construct.cjs.map
+//# sourceMappingURL=dynamo-db-construct.cjs.map

package/dist/aws/cdk/constructs/dynamo-db-construct.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/dynamo-db-construct.ts"],"names":["Construct","Table","printLog","BillingMode","CfnOutput"],"mappings":"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","file":"dynamo-db-construct.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { BillingMode, GlobalSecondaryIndexProps, ITable, LocalSecondaryIndexProps, Table, TableAttributes, TableProps } from 'aws-cdk-lib/aws-dynamodb';\n\nimport { printLog } from '@incloodsolutions/toolkit';\n\nimport { IBaseCdkConstructProps, IBaseConstruct } from '../../types';\n\n/**\n * Props for BaseDynamoDBConstruct\n *\n * Provides configuration for:\n * - Creating a new DynamoDB table\n * - Importing an existing table (by name, ARN, or attributes)\n * - Defining Global Secondary Indexes (GSI) and Local Secondary Indexes (LSI)\n */\ninterface IDynamoDBConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** Configuration for creating a new table */\n\treadonly tableOptions?: TableProps;\n\n\t/** Import an existing table by ARN */\n\treadonly fromExistingTableArn?: string;\n\n\t/** Import an existing table by name */\n\treadonly fromExistingTableName?: string;\n\n\t/** Import an existing table using attributes */\n\treadonly fromExistingTableAttributes?: TableAttributes;\n\n\t/** Global Secondary Index definitions */\n\treadonly globalSecondaryIndexes?: GlobalSecondaryIndexProps[];\n\n\t/** Local Secondary Index definitions */\n\treadonly localSecondaryIndexes?: LocalSecondaryIndexProps[];\n}>, 'appName' | 'stackName'> { }\n\n/**\n * CDK construct for DynamoDB table management\n *\n * Responsibilities:\n * - Creates a new DynamoDB table or imports an existing one\n * - Applies default billing mode and deletion protection\n * - Attaches optional GSIs and LSIs\n * - Exposes table ARN as a CloudFormation output\n */\nexport class BaseDynamoDBConstruct extends Construct implements IBaseConstruct {\n\t/** Newly created DynamoDB table (null if importing existing table) */\n\treadonly table: Table;\n\n\t/** Imported DynamoDB table reference (null if creating new table) */\n\treadonly existingTable: ITable;\n\n\t/** Enables debug logging */\n\tenableDebug = false;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for table creation or import\n\t */\n\tconstructor(scope: Construct, id: string, props: IDynamoDBConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.enableDebug = props?.enableDebug;\n\n\t\t/**\n\t\t * Import table by name\n\t\t */\n\t\tif (props.options?.fromExistingTableName) {\n\t\t\tthis.table = null;\n\n\t\t\tthis.existingTable = Table.fromTableName(\n\t\t\t\tthis,\n\t\t\t\t`${id}-RefName`,\n\t\t\t\tprops.options.fromExistingTableName\n\t\t\t);\n\n\t\t\tif (this.enableDebug) {\n\t\t\t\tprintLog(\n\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t`Created Dynamo-DB table from existing using name ${props.options?.fromExistingTableName}`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Import table by ARN\n\t\t\t */\n\t\t} else if (props.options?.fromExistingTableArn) {\n\t\t\tthis.table = null;\n\n\t\t\tthis.existingTable = Table.fromTableArn(\n\t\t\t\tthis,\n\t\t\t\t`${id}-RefArn`,\n\t\t\t\tprops.options.fromExistingTableArn\n\t\t\t);\n\n\t\t\tif (this.enableDebug) {\n\t\t\t\tprintLog(\n\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t`Created Dynamo-DB table from existing using ARN`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Import table using attributes\n\t\t\t */\n\t\t} else if (props.options?.fromExistingTableAttributes) {\n\t\t\tthis.table = null;\n\n\t\t\tthis.existingTable = Table.fromTableAttributes(\n\t\t\t\tthis,\n\t\t\t\t`${id}-RefAttributes`,\n\t\t\t\tprops.options.fromExistingTableAttributes\n\t\t\t);\n\n\t\t\tif (this.enableDebug) {\n\t\t\t\tprintLog(\n\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t`Created Dynamo-DB table from existing attributes`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Create new table\n\t\t\t */\n\t\t} else {\n\t\t\tthis.existingTable = null;\n\n\t\t\tthis.table = new Table(this, id, {\n\t\t\t\t...props.options?.tableOptions,\n\n\t\t\t\t/**\n\t\t\t\t * Billing mode defaults to PAY_PER_REQUEST if not provided\n\t\t\t\t */\n\t\t\t\tbillingMode:\n\t\t\t\t\tprops.options?.tableOptions?.billingMode\n\t\t\t\t\t|| BillingMode.PAY_PER_REQUEST,\n\n\t\t\t\t/**\n\t\t\t\t * Deletion protection:\n\t\t\t\t * - Uses explicit value if provided\n\t\t\t\t * - Defaults to true in production stage\n\t\t\t\t */\n\t\t\t\tdeletionProtection:\n\t\t\t\t\t(props.options?.tableOptions?.deletionProtection === true ||\n\t\t\t\t\t\tprops.options?.tableOptions?.deletionProtection === false)\n\t\t\t\t\t\t? props.options.tableOptions.deletionProtection\n\t\t\t\t\t\t: props.stage === 'production',\n\t\t\t});\n\n\t\t\t/**\n\t\t\t * Attach Global Secondary Indexes (GSI)\n\t\t\t */\n\t\t\tif (props.options?.globalSecondaryIndexes?.length) {\n\t\t\t\tprops.options.globalSecondaryIndexes.forEach(globalIndex => {\n\t\t\t\t\tthis.table.addGlobalSecondaryIndex(globalIndex);\n\n\t\t\t\t\tif (this.enableDebug) {\n\t\t\t\t\t\tprintLog(\n\t\t\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t\t\t`Added GSI: ${globalIndex.indexName}`\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Attach Local Secondary Indexes (LSI)\n\t\t\t */\n\t\t\tif (props.options?.localSecondaryIndexes?.length) {\n\t\t\t\tprops.options.localSecondaryIndexes.forEach(localIndex => {\n\t\t\t\t\tthis.table.addLocalSecondaryIndex(localIndex);\n\n\t\t\t\t\tif (this.enableDebug) {\n\t\t\t\t\t\tprintLog(\n\t\t\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t\t\t`Added LSI: ${localIndex.indexName}`\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\t/**\n\t\t * CloudFormation output exposing the table ARN\n\t\t * Resolves to either created or imported table\n\t\t */\n\t\tnew CfnOutput(this, 'DynamoDbArn', {\n\t\t\tvalue:\n\t\t\t\t(props.options?.fromExistingTableName || props.options?.fromExistingTableArn)\n\t\t\t\t\t? this.existingTable.tableArn\n\t\t\t\t\t: this.table.tableArn\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/dynamo-db-construct.d.cts

@@ -0,0 +1,53 @@
+import { Construct } from 'constructs';
+import { Table, ITable, TableProps, TableAttributes, GlobalSecondaryIndexProps, LocalSecondaryIndexProps } from 'aws-cdk-lib/aws-dynamodb';
+import { IBaseConstruct, IBaseCdkConstructProps } from '../../types/index.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseDynamoDBConstruct
+ *
+ * Provides configuration for:
+ * - Creating a new DynamoDB table
+ * - Importing an existing table (by name, ARN, or attributes)
+ * - Defining Global Secondary Indexes (GSI) and Local Secondary Indexes (LSI)
+ */
+interface IDynamoDBConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** Configuration for creating a new table */
+    readonly tableOptions?: TableProps;
+    /** Import an existing table by ARN */
+    readonly fromExistingTableArn?: string;
+    /** Import an existing table by name */
+    readonly fromExistingTableName?: string;
+    /** Import an existing table using attributes */
+    readonly fromExistingTableAttributes?: TableAttributes;
+    /** Global Secondary Index definitions */
+    readonly globalSecondaryIndexes?: GlobalSecondaryIndexProps[];
+    /** Local Secondary Index definitions */
+    readonly localSecondaryIndexes?: LocalSecondaryIndexProps[];
+}>, 'appName' | 'stackName'> {
+}
+/**
+ * CDK construct for DynamoDB table management
+ *
+ * Responsibilities:
+ * - Creates a new DynamoDB table or imports an existing one
+ * - Applies default billing mode and deletion protection
+ * - Attaches optional GSIs and LSIs
+ * - Exposes table ARN as a CloudFormation output
+ */
+declare class BaseDynamoDBConstruct extends Construct implements IBaseConstruct {
+    /** Newly created DynamoDB table (null if importing existing table) */
+    readonly table: Table;
+    /** Imported DynamoDB table reference (null if creating new table) */
+    readonly existingTable: ITable;
+    /** Enables debug logging */
+    enableDebug: boolean;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for table creation or import
+     */
+    constructor(scope: Construct, id: string, props: IDynamoDBConstructProps);
+}
+
+export { BaseDynamoDBConstruct };

package/dist/aws/cdk/constructs/dynamo-db-construct.d.ts

@@ -0,0 +1,53 @@
+import { Construct } from 'constructs';
+import { Table, ITable, TableProps, TableAttributes, GlobalSecondaryIndexProps, LocalSecondaryIndexProps } from 'aws-cdk-lib/aws-dynamodb';
+import { IBaseConstruct, IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseDynamoDBConstruct
+ *
+ * Provides configuration for:
+ * - Creating a new DynamoDB table
+ * - Importing an existing table (by name, ARN, or attributes)
+ * - Defining Global Secondary Indexes (GSI) and Local Secondary Indexes (LSI)
+ */
+interface IDynamoDBConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** Configuration for creating a new table */
+    readonly tableOptions?: TableProps;
+    /** Import an existing table by ARN */
+    readonly fromExistingTableArn?: string;
+    /** Import an existing table by name */
+    readonly fromExistingTableName?: string;
+    /** Import an existing table using attributes */
+    readonly fromExistingTableAttributes?: TableAttributes;
+    /** Global Secondary Index definitions */
+    readonly globalSecondaryIndexes?: GlobalSecondaryIndexProps[];
+    /** Local Secondary Index definitions */
+    readonly localSecondaryIndexes?: LocalSecondaryIndexProps[];
+}>, 'appName' | 'stackName'> {
+}
+/**
+ * CDK construct for DynamoDB table management
+ *
+ * Responsibilities:
+ * - Creates a new DynamoDB table or imports an existing one
+ * - Applies default billing mode and deletion protection
+ * - Attaches optional GSIs and LSIs
+ * - Exposes table ARN as a CloudFormation output
+ */
+declare class BaseDynamoDBConstruct extends Construct implements IBaseConstruct {
+    /** Newly created DynamoDB table (null if importing existing table) */
+    readonly table: Table;
+    /** Imported DynamoDB table reference (null if creating new table) */
+    readonly existingTable: ITable;
+    /** Enables debug logging */
+    enableDebug: boolean;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for table creation or import
+     */
+    constructor(scope: Construct, id: string, props: IDynamoDBConstructProps);
+}
+
+export { BaseDynamoDBConstruct };

package/dist/aws/cdk/constructs/dynamo-db-construct.js

@@ -0,0 +1,111 @@
+import { Construct } from 'constructs';
+import { CfnOutput } from 'aws-cdk-lib';
+import { Table, BillingMode } from 'aws-cdk-lib/aws-dynamodb';
+import { printLog } from '@incloodsolutions/toolkit';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseDynamoDBConstruct = class _BaseDynamoDBConstruct extends Construct {
+  static {
+    __name(this, "BaseDynamoDBConstruct");
+  }
+  /** Newly created DynamoDB table (null if importing existing table) */
+  table;
+  /** Imported DynamoDB table reference (null if creating new table) */
+  existingTable;
+  /** Enables debug logging */
+  enableDebug = false;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for table creation or import
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.enableDebug = props?.enableDebug;
+    if (props.options?.fromExistingTableName) {
+      this.table = null;
+      this.existingTable = Table.fromTableName(
+        this,
+        `${id}-RefName`,
+        props.options.fromExistingTableName
+      );
+      if (this.enableDebug) {
+        printLog(
+          _BaseDynamoDBConstruct.name,
+          `Created Dynamo-DB table from existing using name ${props.options?.fromExistingTableName}`
+        );
+      }
+    } else if (props.options?.fromExistingTableArn) {
+      this.table = null;
+      this.existingTable = Table.fromTableArn(
+        this,
+        `${id}-RefArn`,
+        props.options.fromExistingTableArn
+      );
+      if (this.enableDebug) {
+        printLog(
+          _BaseDynamoDBConstruct.name,
+          `Created Dynamo-DB table from existing using ARN`
+        );
+      }
+    } else if (props.options?.fromExistingTableAttributes) {
+      this.table = null;
+      this.existingTable = Table.fromTableAttributes(
+        this,
+        `${id}-RefAttributes`,
+        props.options.fromExistingTableAttributes
+      );
+      if (this.enableDebug) {
+        printLog(
+          _BaseDynamoDBConstruct.name,
+          `Created Dynamo-DB table from existing attributes`
+        );
+      }
+    } else {
+      this.existingTable = null;
+      this.table = new Table(this, id, {
+        ...props.options?.tableOptions,
+        /**
+         * Billing mode defaults to PAY_PER_REQUEST if not provided
+         */
+        billingMode: props.options?.tableOptions?.billingMode || BillingMode.PAY_PER_REQUEST,
+        /**
+         * Deletion protection:
+         * - Uses explicit value if provided
+         * - Defaults to true in production stage
+         */
+        deletionProtection: props.options?.tableOptions?.deletionProtection === true || props.options?.tableOptions?.deletionProtection === false ? props.options.tableOptions.deletionProtection : props.stage === "production"
+      });
+      if (props.options?.globalSecondaryIndexes?.length) {
+        props.options.globalSecondaryIndexes.forEach((globalIndex) => {
+          this.table.addGlobalSecondaryIndex(globalIndex);
+          if (this.enableDebug) {
+            printLog(
+              _BaseDynamoDBConstruct.name,
+              `Added GSI: ${globalIndex.indexName}`
+            );
+          }
+        });
+      }
+      if (props.options?.localSecondaryIndexes?.length) {
+        props.options.localSecondaryIndexes.forEach((localIndex) => {
+          this.table.addLocalSecondaryIndex(localIndex);
+          if (this.enableDebug) {
+            printLog(
+              _BaseDynamoDBConstruct.name,
+              `Added LSI: ${localIndex.indexName}`
+            );
+          }
+        });
+      }
+    }
+    new CfnOutput(this, "DynamoDbArn", {
+      value: props.options?.fromExistingTableName || props.options?.fromExistingTableArn ? this.existingTable.tableArn : this.table.tableArn
+    });
+  }
+};
+
+export { BaseDynamoDBConstruct };
+//# sourceMappingURL=dynamo-db-construct.js.map
+//# sourceMappingURL=dynamo-db-construct.js.map

package/dist/aws/cdk/constructs/dynamo-db-construct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/dynamo-db-construct.ts"],"names":[],"mappings":"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","file":"dynamo-db-construct.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { BillingMode, GlobalSecondaryIndexProps, ITable, LocalSecondaryIndexProps, Table, TableAttributes, TableProps } from 'aws-cdk-lib/aws-dynamodb';\n\nimport { printLog } from '@incloodsolutions/toolkit';\n\nimport { IBaseCdkConstructProps, IBaseConstruct } from '../../types';\n\n/**\n * Props for BaseDynamoDBConstruct\n *\n * Provides configuration for:\n * - Creating a new DynamoDB table\n * - Importing an existing table (by name, ARN, or attributes)\n * - Defining Global Secondary Indexes (GSI) and Local Secondary Indexes (LSI)\n */\ninterface IDynamoDBConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** Configuration for creating a new table */\n\treadonly tableOptions?: TableProps;\n\n\t/** Import an existing table by ARN */\n\treadonly fromExistingTableArn?: string;\n\n\t/** Import an existing table by name */\n\treadonly fromExistingTableName?: string;\n\n\t/** Import an existing table using attributes */\n\treadonly fromExistingTableAttributes?: TableAttributes;\n\n\t/** Global Secondary Index definitions */\n\treadonly globalSecondaryIndexes?: GlobalSecondaryIndexProps[];\n\n\t/** Local Secondary Index definitions */\n\treadonly localSecondaryIndexes?: LocalSecondaryIndexProps[];\n}>, 'appName' | 'stackName'> { }\n\n/**\n * CDK construct for DynamoDB table management\n *\n * Responsibilities:\n * - Creates a new DynamoDB table or imports an existing one\n * - Applies default billing mode and deletion protection\n * - Attaches optional GSIs and LSIs\n * - Exposes table ARN as a CloudFormation output\n */\nexport class BaseDynamoDBConstruct extends Construct implements IBaseConstruct {\n\t/** Newly created DynamoDB table (null if importing existing table) */\n\treadonly table: Table;\n\n\t/** Imported DynamoDB table reference (null if creating new table) */\n\treadonly existingTable: ITable;\n\n\t/** Enables debug logging */\n\tenableDebug = false;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for table creation or import\n\t */\n\tconstructor(scope: Construct, id: string, props: IDynamoDBConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.enableDebug = props?.enableDebug;\n\n\t\t/**\n\t\t * Import table by name\n\t\t */\n\t\tif (props.options?.fromExistingTableName) {\n\t\t\tthis.table = null;\n\n\t\t\tthis.existingTable = Table.fromTableName(\n\t\t\t\tthis,\n\t\t\t\t`${id}-RefName`,\n\t\t\t\tprops.options.fromExistingTableName\n\t\t\t);\n\n\t\t\tif (this.enableDebug) {\n\t\t\t\tprintLog(\n\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t`Created Dynamo-DB table from existing using name ${props.options?.fromExistingTableName}`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Import table by ARN\n\t\t\t */\n\t\t} else if (props.options?.fromExistingTableArn) {\n\t\t\tthis.table = null;\n\n\t\t\tthis.existingTable = Table.fromTableArn(\n\t\t\t\tthis,\n\t\t\t\t`${id}-RefArn`,\n\t\t\t\tprops.options.fromExistingTableArn\n\t\t\t);\n\n\t\t\tif (this.enableDebug) {\n\t\t\t\tprintLog(\n\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t`Created Dynamo-DB table from existing using ARN`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Import table using attributes\n\t\t\t */\n\t\t} else if (props.options?.fromExistingTableAttributes) {\n\t\t\tthis.table = null;\n\n\t\t\tthis.existingTable = Table.fromTableAttributes(\n\t\t\t\tthis,\n\t\t\t\t`${id}-RefAttributes`,\n\t\t\t\tprops.options.fromExistingTableAttributes\n\t\t\t);\n\n\t\t\tif (this.enableDebug) {\n\t\t\t\tprintLog(\n\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t`Created Dynamo-DB table from existing attributes`\n\t\t\t\t);\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Create new table\n\t\t\t */\n\t\t} else {\n\t\t\tthis.existingTable = null;\n\n\t\t\tthis.table = new Table(this, id, {\n\t\t\t\t...props.options?.tableOptions,\n\n\t\t\t\t/**\n\t\t\t\t * Billing mode defaults to PAY_PER_REQUEST if not provided\n\t\t\t\t */\n\t\t\t\tbillingMode:\n\t\t\t\t\tprops.options?.tableOptions?.billingMode\n\t\t\t\t\t|| BillingMode.PAY_PER_REQUEST,\n\n\t\t\t\t/**\n\t\t\t\t * Deletion protection:\n\t\t\t\t * - Uses explicit value if provided\n\t\t\t\t * - Defaults to true in production stage\n\t\t\t\t */\n\t\t\t\tdeletionProtection:\n\t\t\t\t\t(props.options?.tableOptions?.deletionProtection === true ||\n\t\t\t\t\t\tprops.options?.tableOptions?.deletionProtection === false)\n\t\t\t\t\t\t? props.options.tableOptions.deletionProtection\n\t\t\t\t\t\t: props.stage === 'production',\n\t\t\t});\n\n\t\t\t/**\n\t\t\t * Attach Global Secondary Indexes (GSI)\n\t\t\t */\n\t\t\tif (props.options?.globalSecondaryIndexes?.length) {\n\t\t\t\tprops.options.globalSecondaryIndexes.forEach(globalIndex => {\n\t\t\t\t\tthis.table.addGlobalSecondaryIndex(globalIndex);\n\n\t\t\t\t\tif (this.enableDebug) {\n\t\t\t\t\t\tprintLog(\n\t\t\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t\t\t`Added GSI: ${globalIndex.indexName}`\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\n\t\t\t/**\n\t\t\t * Attach Local Secondary Indexes (LSI)\n\t\t\t */\n\t\t\tif (props.options?.localSecondaryIndexes?.length) {\n\t\t\t\tprops.options.localSecondaryIndexes.forEach(localIndex => {\n\t\t\t\t\tthis.table.addLocalSecondaryIndex(localIndex);\n\n\t\t\t\t\tif (this.enableDebug) {\n\t\t\t\t\t\tprintLog(\n\t\t\t\t\t\t\tBaseDynamoDBConstruct.name,\n\t\t\t\t\t\t\t`Added LSI: ${localIndex.indexName}`\n\t\t\t\t\t\t);\n\t\t\t\t\t}\n\t\t\t\t});\n\t\t\t}\n\t\t}\n\n\t\t/**\n\t\t * CloudFormation output exposing the table ARN\n\t\t * Resolves to either created or imported table\n\t\t */\n\t\tnew CfnOutput(this, 'DynamoDbArn', {\n\t\t\tvalue:\n\t\t\t\t(props.options?.fromExistingTableName || props.options?.fromExistingTableArn)\n\t\t\t\t\t? this.existingTable.tableArn\n\t\t\t\t\t: this.table.tableArn\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/event-bridge-construct.cjs

@@ -0,0 +1,47 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsEvents = require('aws-cdk-lib/aws-events');
+var awsEventsTargets = require('aws-cdk-lib/aws-events-targets');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseEventBridgeConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseEventBridgeConstruct");
+  }
+  /** The created EventBridge rule instance */
+  eventSchedule;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for rule and target functions
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.eventSchedule = new awsEvents.Rule(this, id, {
+      ...props.options?.eventBridgeOptions,
+      /** Default description if not explicitly provided */
+      description: props?.options?.eventBridgeOptions?.description || "An Event-bridge rule"
+    });
+    if (props.options?.targetFunctions?.length) {
+      props.options.targetFunctions.forEach((targetFunction) => {
+        this.eventSchedule.addTarget(
+          /**
+           * Lambda target integration
+           */
+          new awsEventsTargets.LambdaFunction(targetFunction)
+        );
+      });
+    }
+    this.eventSchedule.applyRemovalPolicy(awsCdkLib.RemovalPolicy.DESTROY);
+    new awsCdkLib.CfnOutput(this, "EventBridgeArn", {
+      value: this.eventSchedule.ruleArn
+    });
+  }
+};
+
+exports.BaseEventBridgeConstruct = BaseEventBridgeConstruct;
+//# sourceMappingURL=event-bridge-construct.cjs.map
+//# sourceMappingURL=event-bridge-construct.cjs.map

package/dist/aws/cdk/constructs/event-bridge-construct.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/event-bridge-construct.ts"],"names":["Construct","Rule","LambdaFunction","RemovalPolicy","CfnOutput"],"mappings":";;;;;;;;;AAgCO,IAAM,wBAAA,GAAN,cAAuCA,oBAAA,CAAU;AAAA,EAhCxD;AAgCwD,IAAA,MAAA,CAAA,IAAA,EAAA,0BAAA,CAAA;AAAA;AAAA;AAAA,EAE9C,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAmC;AAC5E,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,aAAA,GAAgB,IAAIC,cAAA,CAAK,IAAA,EAAM,EAAA,EAAI;AAAA,MACvC,GAAG,MAAM,OAAA,EAAS,kBAAA;AAAA;AAAA,MAGlB,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,kBAAA,EAAoB,WAAA,IACjC;AAAA,KACJ,CAAA;AAKD,IAAA,IAAI,KAAA,CAAM,OAAA,EAAS,eAAA,EAAiB,MAAA,EAAQ;AAC3C,MAAA,KAAA,CAAM,OAAA,CAAQ,eAAA,CAAgB,OAAA,CAAQ,CAAC,cAAA,KAAmB;AACzD,QAAA,IAAA,CAAK,aAAA,CAAc,SAAA;AAAA;AAAA;AAAA;AAAA,UAIlB,IAAIC,gCAAe,cAAc;AAAA,SAClC;AAAA,MACD,CAAC,CAAA;AAAA,IACF;AAKA,IAAA,IAAA,CAAK,aAAA,CAAc,kBAAA,CAAmBC,uBAAA,CAAc,OAAO,CAAA;AAK3D,IAAA,IAAIC,mBAAA,CAAU,MAAM,gBAAA,EAAkB;AAAA,MACrC,KAAA,EAAO,KAAK,aAAA,CAAc;AAAA,KAC1B,CAAA;AAAA,EACF;AACD","file":"event-bridge-construct.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { Function } from 'aws-cdk-lib/aws-lambda';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { Rule, RuleProps } from 'aws-cdk-lib/aws-events';\nimport { LambdaFunction } from 'aws-cdk-lib/aws-events-targets';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseEventBridgeConstruct\n *\n * Provides configuration for:\n * - EventBridge rule creation\n * - Target Lambda functions\n */\ninterface IEventBridgeConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** Lambda functions to be triggered by the rule */\n\treadonly targetFunctions: Function[];\n\n\t/** EventBridge rule configuration */\n\treadonly eventBridgeOptions: RuleProps;\n}>, 'appName' | 'stage' | 'stackName'> { }\n\n/**\n * CDK construct for EventBridge rule\n *\n * Responsibilities:\n * - Creates an EventBridge rule with configurable options\n * - Attaches one or more Lambda targets\n * - Applies a removal policy\n * - Exposes the rule ARN as a CloudFormation output\n */\nexport class BaseEventBridgeConstruct extends Construct {\n\t/** The created EventBridge rule instance */\n\treadonly eventSchedule: Rule;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for rule and target functions\n\t */\n\tconstructor(scope: Construct, id: string, props: IEventBridgeConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.eventSchedule = new Rule(this, id, {\n\t\t\t...props.options?.eventBridgeOptions,\n\n\t\t\t/** Default description if not explicitly provided */\n\t\t\tdescription:\n\t\t\t\tprops?.options?.eventBridgeOptions?.description\n\t\t\t\t|| 'An Event-bridge rule'\n\t\t});\n\n\t\t/**\n\t\t * Attach Lambda targets to the rule\n\t\t */\n\t\tif (props.options?.targetFunctions?.length) {\n\t\t\tprops.options.targetFunctions.forEach((targetFunction) => {\n\t\t\t\tthis.eventSchedule.addTarget(\n\t\t\t\t\t/**\n\t\t\t\t\t * Lambda target integration\n\t\t\t\t\t */\n\t\t\t\t\tnew LambdaFunction(targetFunction)\n\t\t\t\t);\n\t\t\t});\n\t\t}\n\n\t\t/**\n\t\t * Apply removal policy (useful for non-production environments)\n\t\t */\n\t\tthis.eventSchedule.applyRemovalPolicy(RemovalPolicy.DESTROY);\n\n\t\t/**\n\t\t * CloudFormation output exposing the rule ARN\n\t\t */\n\t\tnew CfnOutput(this, 'EventBridgeArn', {\n\t\t\tvalue: this.eventSchedule.ruleArn\n\t\t});\n\t}\n}"]}

package/dist/aws/cdk/constructs/event-bridge-construct.d.cts

@@ -0,0 +1,41 @@
+import { Construct } from 'constructs';
+import { Function } from 'aws-cdk-lib/aws-lambda';
+import { Rule, RuleProps } from 'aws-cdk-lib/aws-events';
+import { IBaseCdkConstructProps } from '../../types/index.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseEventBridgeConstruct
+ *
+ * Provides configuration for:
+ * - EventBridge rule creation
+ * - Target Lambda functions
+ */
+interface IEventBridgeConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** Lambda functions to be triggered by the rule */
+    readonly targetFunctions: Function[];
+    /** EventBridge rule configuration */
+    readonly eventBridgeOptions: RuleProps;
+}>, 'appName' | 'stage' | 'stackName'> {
+}
+/**
+ * CDK construct for EventBridge rule
+ *
+ * Responsibilities:
+ * - Creates an EventBridge rule with configurable options
+ * - Attaches one or more Lambda targets
+ * - Applies a removal policy
+ * - Exposes the rule ARN as a CloudFormation output
+ */
+declare class BaseEventBridgeConstruct extends Construct {
+    /** The created EventBridge rule instance */
+    readonly eventSchedule: Rule;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for rule and target functions
+     */
+    constructor(scope: Construct, id: string, props: IEventBridgeConstructProps);
+}
+
+export { BaseEventBridgeConstruct };

package/dist/aws/cdk/constructs/event-bridge-construct.d.ts

@@ -0,0 +1,41 @@
+import { Construct } from 'constructs';
+import { Function } from 'aws-cdk-lib/aws-lambda';
+import { Rule, RuleProps } from 'aws-cdk-lib/aws-events';
+import { IBaseCdkConstructProps } from '../../types/index.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseEventBridgeConstruct
+ *
+ * Provides configuration for:
+ * - EventBridge rule creation
+ * - Target Lambda functions
+ */
+interface IEventBridgeConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** Lambda functions to be triggered by the rule */
+    readonly targetFunctions: Function[];
+    /** EventBridge rule configuration */
+    readonly eventBridgeOptions: RuleProps;
+}>, 'appName' | 'stage' | 'stackName'> {
+}
+/**
+ * CDK construct for EventBridge rule
+ *
+ * Responsibilities:
+ * - Creates an EventBridge rule with configurable options
+ * - Attaches one or more Lambda targets
+ * - Applies a removal policy
+ * - Exposes the rule ARN as a CloudFormation output
+ */
+declare class BaseEventBridgeConstruct extends Construct {
+    /** The created EventBridge rule instance */
+    readonly eventSchedule: Rule;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for rule and target functions
+     */
+    constructor(scope: Construct, id: string, props: IEventBridgeConstructProps);
+}
+
+export { BaseEventBridgeConstruct };

package/dist/aws/cdk/constructs/event-bridge-construct.js

@@ -0,0 +1,45 @@
+import { Construct } from 'constructs';
+import { RemovalPolicy, CfnOutput } from 'aws-cdk-lib';
+import { Rule } from 'aws-cdk-lib/aws-events';
+import { LambdaFunction } from 'aws-cdk-lib/aws-events-targets';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseEventBridgeConstruct = class extends Construct {
+  static {
+    __name(this, "BaseEventBridgeConstruct");
+  }
+  /** The created EventBridge rule instance */
+  eventSchedule;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for rule and target functions
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.eventSchedule = new Rule(this, id, {
+      ...props.options?.eventBridgeOptions,
+      /** Default description if not explicitly provided */
+      description: props?.options?.eventBridgeOptions?.description || "An Event-bridge rule"
+    });
+    if (props.options?.targetFunctions?.length) {
+      props.options.targetFunctions.forEach((targetFunction) => {
+        this.eventSchedule.addTarget(
+          /**
+           * Lambda target integration
+           */
+          new LambdaFunction(targetFunction)
+        );
+      });
+    }
+    this.eventSchedule.applyRemovalPolicy(RemovalPolicy.DESTROY);
+    new CfnOutput(this, "EventBridgeArn", {
+      value: this.eventSchedule.ruleArn
+    });
+  }
+};
+
+export { BaseEventBridgeConstruct };
+//# sourceMappingURL=event-bridge-construct.js.map
+//# sourceMappingURL=event-bridge-construct.js.map

package/dist/aws/cdk/constructs/event-bridge-construct.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../../../src/aws/cdk/constructs/event-bridge-construct.ts"],"names":[],"mappings":";;;;;;;AAgCO,IAAM,wBAAA,GAAN,cAAuC,SAAA,CAAU;AAAA,EAhCxD;AAgCwD,IAAA,MAAA,CAAA,IAAA,EAAA,0BAAA,CAAA;AAAA;AAAA;AAAA,EAE9C,aAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAAmC;AAC5E,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,aAAA,GAAgB,IAAI,IAAA,CAAK,IAAA,EAAM,EAAA,EAAI;AAAA,MACvC,GAAG,MAAM,OAAA,EAAS,kBAAA;AAAA;AAAA,MAGlB,WAAA,EACC,KAAA,EAAO,OAAA,EAAS,kBAAA,EAAoB,WAAA,IACjC;AAAA,KACJ,CAAA;AAKD,IAAA,IAAI,KAAA,CAAM,OAAA,EAAS,eAAA,EAAiB,MAAA,EAAQ;AAC3C,MAAA,KAAA,CAAM,OAAA,CAAQ,eAAA,CAAgB,OAAA,CAAQ,CAAC,cAAA,KAAmB;AACzD,QAAA,IAAA,CAAK,aAAA,CAAc,SAAA;AAAA;AAAA;AAAA;AAAA,UAIlB,IAAI,eAAe,cAAc;AAAA,SAClC;AAAA,MACD,CAAC,CAAA;AAAA,IACF;AAKA,IAAA,IAAA,CAAK,aAAA,CAAc,kBAAA,CAAmB,aAAA,CAAc,OAAO,CAAA;AAK3D,IAAA,IAAI,SAAA,CAAU,MAAM,gBAAA,EAAkB;AAAA,MACrC,KAAA,EAAO,KAAK,aAAA,CAAc;AAAA,KAC1B,CAAA;AAAA,EACF;AACD","file":"event-bridge-construct.js","sourcesContent":["import { Construct } from 'constructs';\nimport { Function } from 'aws-cdk-lib/aws-lambda';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { Rule, RuleProps } from 'aws-cdk-lib/aws-events';\nimport { LambdaFunction } from 'aws-cdk-lib/aws-events-targets';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseEventBridgeConstruct\n *\n * Provides configuration for:\n * - EventBridge rule creation\n * - Target Lambda functions\n */\ninterface IEventBridgeConstructProps extends Omit<IBaseCdkConstructProps<{\n\t/** Lambda functions to be triggered by the rule */\n\treadonly targetFunctions: Function[];\n\n\t/** EventBridge rule configuration */\n\treadonly eventBridgeOptions: RuleProps;\n}>, 'appName' | 'stage' | 'stackName'> { }\n\n/**\n * CDK construct for EventBridge rule\n *\n * Responsibilities:\n * - Creates an EventBridge rule with configurable options\n * - Attaches one or more Lambda targets\n * - Applies a removal policy\n * - Exposes the rule ARN as a CloudFormation output\n */\nexport class BaseEventBridgeConstruct extends Construct {\n\t/** The created EventBridge rule instance */\n\treadonly eventSchedule: Rule;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for rule and target functions\n\t */\n\tconstructor(scope: Construct, id: string, props: IEventBridgeConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.eventSchedule = new Rule(this, id, {\n\t\t\t...props.options?.eventBridgeOptions,\n\n\t\t\t/** Default description if not explicitly provided */\n\t\t\tdescription:\n\t\t\t\tprops?.options?.eventBridgeOptions?.description\n\t\t\t\t|| 'An Event-bridge rule'\n\t\t});\n\n\t\t/**\n\t\t * Attach Lambda targets to the rule\n\t\t */\n\t\tif (props.options?.targetFunctions?.length) {\n\t\t\tprops.options.targetFunctions.forEach((targetFunction) => {\n\t\t\t\tthis.eventSchedule.addTarget(\n\t\t\t\t\t/**\n\t\t\t\t\t * Lambda target integration\n\t\t\t\t\t */\n\t\t\t\t\tnew LambdaFunction(targetFunction)\n\t\t\t\t);\n\t\t\t});\n\t\t}\n\n\t\t/**\n\t\t * Apply removal policy (useful for non-production environments)\n\t\t */\n\t\tthis.eventSchedule.applyRemovalPolicy(RemovalPolicy.DESTROY);\n\n\t\t/**\n\t\t * CloudFormation output exposing the rule ARN\n\t\t */\n\t\tnew CfnOutput(this, 'EventBridgeArn', {\n\t\t\tvalue: this.eventSchedule.ruleArn\n\t\t});\n\t}\n}"]}