@incloodsolutions/devkit 0.0.2 → 0.0.4

package/dist/aws-cdk/sqs.d.cts

@@ -0,0 +1,52 @@
+import { Construct } from 'constructs';
+import { Queue, QueueProps } from 'aws-cdk-lib/aws-sqs';
+import { EventSourceMappingProps, Function } from 'aws-cdk-lib/aws-lambda';
+import { IBaseCdkConstructProps } from '../aws-types.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseSqsConstruct
+ *
+ * Provides configuration for:
+ * - SQS queue creation
+ * - Lambda event source mappings
+ */
+interface ISqsConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** Configuration options for the SQS queue */
+    readonly queueOptions?: QueueProps;
+    /**
+     * Configuration for Lambda event source mapping
+     *
+     * Note:
+     * `eventSourceArn` and `target` are managed internally
+     */
+    readonly eventSourceMappingOptions?: Omit<EventSourceMappingProps, 'eventSourceArn' | 'target'>;
+}>, 'appName' | 'stage' | 'stackName'> {
+    /**
+     * Lambda functions to be triggered by SQS messages
+     *
+     * Each function will be connected via an event source mapping
+     */
+    readonly targetFunctions?: Function[];
+}
+/**
+ * CDK construct for SQS queue with Lambda integration
+ *
+ * Responsibilities:
+ * - Creates an SQS queue with configurable options
+ * - Attaches one or more Lambda consumers via event source mappings
+ * - Applies default retry behaviour
+ * - Exposes the queue ARN as a CloudFormation output
+ */
+declare class BaseSqsConstruct extends Construct {
+    /** The created SQS queue instance */
+    readonly queue: Queue;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for queue and Lambda consumers
+     */
+    constructor(scope: Construct, id: string, props: ISqsConstructProps);
+}
+
+export { BaseSqsConstruct };

package/dist/aws-cdk/sqs.d.ts

@@ -0,0 +1,52 @@
+import { Construct } from 'constructs';
+import { Queue, QueueProps } from 'aws-cdk-lib/aws-sqs';
+import { EventSourceMappingProps, Function } from 'aws-cdk-lib/aws-lambda';
+import { IBaseCdkConstructProps } from '../aws-types.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseSqsConstruct
+ *
+ * Provides configuration for:
+ * - SQS queue creation
+ * - Lambda event source mappings
+ */
+interface ISqsConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** Configuration options for the SQS queue */
+    readonly queueOptions?: QueueProps;
+    /**
+     * Configuration for Lambda event source mapping
+     *
+     * Note:
+     * `eventSourceArn` and `target` are managed internally
+     */
+    readonly eventSourceMappingOptions?: Omit<EventSourceMappingProps, 'eventSourceArn' | 'target'>;
+}>, 'appName' | 'stage' | 'stackName'> {
+    /**
+     * Lambda functions to be triggered by SQS messages
+     *
+     * Each function will be connected via an event source mapping
+     */
+    readonly targetFunctions?: Function[];
+}
+/**
+ * CDK construct for SQS queue with Lambda integration
+ *
+ * Responsibilities:
+ * - Creates an SQS queue with configurable options
+ * - Attaches one or more Lambda consumers via event source mappings
+ * - Applies default retry behaviour
+ * - Exposes the queue ARN as a CloudFormation output
+ */
+declare class BaseSqsConstruct extends Construct {
+    /** The created SQS queue instance */
+    readonly queue: Queue;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for queue and Lambda consumers
+     */
+    constructor(scope: Construct, id: string, props: ISqsConstructProps);
+}
+
+export { BaseSqsConstruct };

package/dist/aws-cdk/sqs.js

@@ -0,0 +1,53 @@
+import { Construct } from 'constructs';
+import { RemovalPolicy, CfnOutput } from 'aws-cdk-lib';
+import { Queue } from 'aws-cdk-lib/aws-sqs';
+import { EventSourceMapping } from 'aws-cdk-lib/aws-lambda';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseSqsConstruct = class extends Construct {
+  static {
+    __name(this, "BaseSqsConstruct");
+  }
+  /** The created SQS queue instance */
+  queue;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for queue and Lambda consumers
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.queue = new Queue(this, id, {
+      ...props?.options?.queueOptions,
+      /**
+       * Removal policy applied to the queue
+       * Defaults to DESTROY if not explicitly defined
+       */
+      removalPolicy: props?.options?.queueOptions?.removalPolicy || RemovalPolicy.DESTROY
+    });
+    if (props?.targetFunctions?.length) {
+      props.targetFunctions.forEach((targetFunction, index) => {
+        new EventSourceMapping(this, `${id}-eventSourceMap${index + 1}`, {
+          ...props?.options?.eventSourceMappingOptions,
+          /** Target Lambda function */
+          target: targetFunction,
+          /** Source SQS queue ARN */
+          eventSourceArn: this.queue.queueArn,
+          /**
+           * Retry attempts for failed batch processing
+           * Defaults to 3 if not explicitly defined
+           */
+          retryAttempts: props?.options?.eventSourceMappingOptions?.retryAttempts || 3
+        });
+      });
+    }
+    new CfnOutput(this, "SqsQueueArn", {
+      value: this.queue.queueArn
+    });
+  }
+};
+
+export { BaseSqsConstruct };
+//# sourceMappingURL=sqs.js.map
+//# sourceMappingURL=sqs.js.map

package/dist/aws-cdk/sqs.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/aws/cdk/constructs/sqs-construct.ts"],"names":[],"mappings":";;;;;;;AAqDO,IAAM,gBAAA,GAAN,cAA+B,SAAA,CAAU;AAAA,EArDhD;AAqDgD,IAAA,MAAA,CAAA,IAAA,EAAA,kBAAA,CAAA;AAAA;AAAA;AAAA,EAEtC,KAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA2B;AACpE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,KAAA,GAAQ,IAAI,KAAA,CAAM,IAAA,EAAM,EAAA,EAAI;AAAA,MAChC,GAAG,OAAO,OAAA,EAAS,YAAA;AAAA;AAAA;AAAA;AAAA;AAAA,MAMnB,aAAA,EACC,KAAA,EAAO,OAAA,EAAS,YAAA,EAAc,iBAAiB,aAAA,CAAc;AAAA,KAC9D,CAAA;AAKD,IAAA,IAAI,KAAA,EAAO,iBAAiB,MAAA,EAAQ;AACnC,MAAA,KAAA,CAAM,eAAA,CAAgB,OAAA,CAAQ,CAAC,cAAA,EAAgB,KAAA,KAAU;AACxD,QAAA,IAAI,mBAAmB,IAAA,EAAM,CAAA,EAAG,EAAE,CAAA,eAAA,EAAkB,KAAA,GAAQ,CAAC,CAAA,CAAA,EAAI;AAAA,UAChE,GAAG,OAAO,OAAA,EAAS,yBAAA;AAAA;AAAA,UAGnB,MAAA,EAAQ,cAAA;AAAA;AAAA,UAGR,cAAA,EAAgB,KAAK,KAAA,CAAM,QAAA;AAAA;AAAA;AAAA;AAAA;AAAA,UAM3B,aAAA,EACC,KAAA,EAAO,OAAA,EAAS,yBAAA,EAA2B,aAAA,IAAiB;AAAA,SAC7D,CAAA;AAAA,MACF,CAAC,CAAA;AAAA,IACF;AAKA,IAAA,IAAI,SAAA,CAAU,MAAM,aAAA,EAAe;AAAA,MAClC,KAAA,EAAO,KAAK,KAAA,CAAM;AAAA,KAClB,CAAA;AAAA,EACF;AACD","file":"sqs.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput, RemovalPolicy } from 'aws-cdk-lib';\nimport { Queue, QueueProps } from 'aws-cdk-lib/aws-sqs';\nimport {\n\tEventSourceMapping,\n\tEventSourceMappingProps,\n\tFunction,\n} from 'aws-cdk-lib/aws-lambda';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseSqsConstruct\n *\n * Provides configuration for:\n * - SQS queue creation\n * - Lambda event source mappings\n */\ninterface ISqsConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** Configuration options for the SQS queue */\n\t\treadonly queueOptions?: QueueProps;\n\n\t\t/**\n\t\t * Configuration for Lambda event source mapping\n\t\t *\n\t\t * Note:\n\t\t * `eventSourceArn` and `target` are managed internally\n\t\t */\n\t\treadonly eventSourceMappingOptions?: Omit<\n\t\t\tEventSourceMappingProps,\n\t\t\t'eventSourceArn' | 'target'\n\t\t>;\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {\n\t/**\n\t * Lambda functions to be triggered by SQS messages\n\t *\n\t * Each function will be connected via an event source mapping\n\t */\n\treadonly targetFunctions?: Function[];\n}\n\n/**\n * CDK construct for SQS queue with Lambda integration\n *\n * Responsibilities:\n * - Creates an SQS queue with configurable options\n * - Attaches one or more Lambda consumers via event source mappings\n * - Applies default retry behaviour\n * - Exposes the queue ARN as a CloudFormation output\n */\nexport class BaseSqsConstruct extends Construct {\n\t/** The created SQS queue instance */\n\treadonly queue: Queue;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for queue and Lambda consumers\n\t */\n\tconstructor(scope: Construct, id: string, props: ISqsConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.queue = new Queue(this, id, {\n\t\t\t...props?.options?.queueOptions,\n\n\t\t\t/**\n\t\t\t * Removal policy applied to the queue\n\t\t\t * Defaults to DESTROY if not explicitly defined\n\t\t\t */\n\t\t\tremovalPolicy:\n\t\t\t\tprops?.options?.queueOptions?.removalPolicy || RemovalPolicy.DESTROY,\n\t\t});\n\n\t\t/**\n\t\t * Attach Lambda event source mappings for queue consumption\n\t\t */\n\t\tif (props?.targetFunctions?.length) {\n\t\t\tprops.targetFunctions.forEach((targetFunction, index) => {\n\t\t\t\tnew EventSourceMapping(this, `${id}-eventSourceMap${index + 1}`, {\n\t\t\t\t\t...props?.options?.eventSourceMappingOptions,\n\n\t\t\t\t\t/** Target Lambda function */\n\t\t\t\t\ttarget: targetFunction,\n\n\t\t\t\t\t/** Source SQS queue ARN */\n\t\t\t\t\teventSourceArn: this.queue.queueArn,\n\n\t\t\t\t\t/**\n\t\t\t\t\t * Retry attempts for failed batch processing\n\t\t\t\t\t * Defaults to 3 if not explicitly defined\n\t\t\t\t\t */\n\t\t\t\t\tretryAttempts:\n\t\t\t\t\t\tprops?.options?.eventSourceMappingOptions?.retryAttempts || 3,\n\t\t\t\t});\n\t\t\t});\n\t\t}\n\n\t\t/**\n\t\t * CloudFormation output exposing the SQS queue ARN\n\t\t */\n\t\tnew CfnOutput(this, 'SqsQueueArn', {\n\t\t\tvalue: this.queue.queueArn,\n\t\t});\n\t}\n}\n"]}

package/dist/aws-cdk/vpc.cjs

@@ -0,0 +1,33 @@
+'use strict';
+
+var constructs = require('constructs');
+var awsCdkLib = require('aws-cdk-lib');
+var awsEc2 = require('aws-cdk-lib/aws-ec2');
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseVpcConstruct = class extends constructs.Construct {
+  static {
+    __name(this, "BaseVpcConstruct");
+  }
+  /** The created VPC instance */
+  vpc;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for VPC
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.vpc = new awsEc2.Vpc(this, id, {
+      ...props.options.vpcOptions
+    });
+    new awsCdkLib.CfnOutput(this, "VpcArn", {
+      value: this.vpc.vpcArn
+    });
+  }
+};
+
+exports.BaseVpcConstruct = BaseVpcConstruct;
+//# sourceMappingURL=vpc.cjs.map
+//# sourceMappingURL=vpc.cjs.map

package/dist/aws-cdk/vpc.cjs.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/aws/cdk/constructs/vpc-construct.ts"],"names":["Construct","Vpc","CfnOutput"],"mappings":";;;;;;;;AA0BO,IAAM,gBAAA,GAAN,cAA+BA,oBAAA,CAAU;AAAA,EA1BhD;AA0BgD,IAAA,MAAA,CAAA,IAAA,EAAA,kBAAA,CAAA;AAAA;AAAA;AAAA,EAEtC,GAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA2B;AACpE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,GAAA,GAAM,IAAIC,UAAA,CAAI,IAAA,EAAM,EAAA,EAAI;AAAA,MAC5B,GAAG,MAAM,OAAA,CAAQ;AAAA,KACjB,CAAA;AAKD,IAAA,IAAIC,mBAAA,CAAU,MAAM,QAAA,EAAU;AAAA,MAC7B,KAAA,EAAO,KAAK,GAAA,CAAI;AAAA,KAChB,CAAA;AAAA,EACF;AACD","file":"vpc.cjs","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { Vpc, VpcProps } from 'aws-cdk-lib/aws-ec2';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseVpcConstruct\n *\n * Provides configuration for creating a VPC.\n */\ninterface IVpcConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** VPC configuration options */\n\t\treadonly vpcOptions: VpcProps;\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {}\n\n/**\n * CDK construct for Virtual Private Cloud (VPC)\n *\n * Responsibilities:\n * - Creates a VPC with configurable options\n * - Exposes the VPC ARN as a CloudFormation output\n */\nexport class BaseVpcConstruct extends Construct {\n\t/** The created VPC instance */\n\treadonly vpc: Vpc;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for VPC\n\t */\n\tconstructor(scope: Construct, id: string, props: IVpcConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.vpc = new Vpc(this, id, {\n\t\t\t...props.options.vpcOptions,\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the VPC ARN\n\t\t */\n\t\tnew CfnOutput(this, 'VpcArn', {\n\t\t\tvalue: this.vpc.vpcArn,\n\t\t});\n\t}\n}\n"]}

package/dist/aws-cdk/vpc.d.cts

@@ -0,0 +1,34 @@
+import { Construct } from 'constructs';
+import { Vpc, VpcProps } from 'aws-cdk-lib/aws-ec2';
+import { IBaseCdkConstructProps } from '../aws-types.cjs';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseVpcConstruct
+ *
+ * Provides configuration for creating a VPC.
+ */
+interface IVpcConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** VPC configuration options */
+    readonly vpcOptions: VpcProps;
+}>, 'appName' | 'stage' | 'stackName'> {
+}
+/**
+ * CDK construct for Virtual Private Cloud (VPC)
+ *
+ * Responsibilities:
+ * - Creates a VPC with configurable options
+ * - Exposes the VPC ARN as a CloudFormation output
+ */
+declare class BaseVpcConstruct extends Construct {
+    /** The created VPC instance */
+    readonly vpc: Vpc;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for VPC
+     */
+    constructor(scope: Construct, id: string, props: IVpcConstructProps);
+}
+
+export { BaseVpcConstruct };

package/dist/aws-cdk/vpc.d.ts

@@ -0,0 +1,34 @@
+import { Construct } from 'constructs';
+import { Vpc, VpcProps } from 'aws-cdk-lib/aws-ec2';
+import { IBaseCdkConstructProps } from '../aws-types.js';
+import '@incloodsolutions/toolkit';
+
+/**
+ * Props for BaseVpcConstruct
+ *
+ * Provides configuration for creating a VPC.
+ */
+interface IVpcConstructProps extends Omit<IBaseCdkConstructProps<{
+    /** VPC configuration options */
+    readonly vpcOptions: VpcProps;
+}>, 'appName' | 'stage' | 'stackName'> {
+}
+/**
+ * CDK construct for Virtual Private Cloud (VPC)
+ *
+ * Responsibilities:
+ * - Creates a VPC with configurable options
+ * - Exposes the VPC ARN as a CloudFormation output
+ */
+declare class BaseVpcConstruct extends Construct {
+    /** The created VPC instance */
+    readonly vpc: Vpc;
+    /**
+     * @param scope Parent construct
+     * @param id Unique construct identifier
+     * @param props Configuration for VPC
+     */
+    constructor(scope: Construct, id: string, props: IVpcConstructProps);
+}
+
+export { BaseVpcConstruct };

package/dist/aws-cdk/vpc.js

@@ -0,0 +1,31 @@
+import { Construct } from 'constructs';
+import { CfnOutput } from 'aws-cdk-lib';
+import { Vpc } from 'aws-cdk-lib/aws-ec2';
+
+var __defProp = Object.defineProperty;
+var __name = (target, value) => __defProp(target, "name", { value, configurable: true });
+var BaseVpcConstruct = class extends Construct {
+  static {
+    __name(this, "BaseVpcConstruct");
+  }
+  /** The created VPC instance */
+  vpc;
+  /**
+   * @param scope Parent construct
+   * @param id Unique construct identifier
+   * @param props Configuration for VPC
+   */
+  constructor(scope, id, props) {
+    super(scope, id);
+    this.vpc = new Vpc(this, id, {
+      ...props.options.vpcOptions
+    });
+    new CfnOutput(this, "VpcArn", {
+      value: this.vpc.vpcArn
+    });
+  }
+};
+
+export { BaseVpcConstruct };
+//# sourceMappingURL=vpc.js.map
+//# sourceMappingURL=vpc.js.map

package/dist/aws-cdk/vpc.js.map

@@ -0,0 +1 @@
+{"version":3,"sources":["../../src/aws/cdk/constructs/vpc-construct.ts"],"names":[],"mappings":";;;;;;AA0BO,IAAM,gBAAA,GAAN,cAA+B,SAAA,CAAU;AAAA,EA1BhD;AA0BgD,IAAA,MAAA,CAAA,IAAA,EAAA,kBAAA,CAAA;AAAA;AAAA;AAAA,EAEtC,GAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA,EAOT,WAAA,CAAY,KAAA,EAAkB,EAAA,EAAY,KAAA,EAA2B;AACpE,IAAA,KAAA,CAAM,OAAO,EAAE,CAAA;AAEf,IAAA,IAAA,CAAK,GAAA,GAAM,IAAI,GAAA,CAAI,IAAA,EAAM,EAAA,EAAI;AAAA,MAC5B,GAAG,MAAM,OAAA,CAAQ;AAAA,KACjB,CAAA;AAKD,IAAA,IAAI,SAAA,CAAU,MAAM,QAAA,EAAU;AAAA,MAC7B,KAAA,EAAO,KAAK,GAAA,CAAI;AAAA,KAChB,CAAA;AAAA,EACF;AACD","file":"vpc.js","sourcesContent":["import { Construct } from 'constructs';\nimport { CfnOutput } from 'aws-cdk-lib';\nimport { Vpc, VpcProps } from 'aws-cdk-lib/aws-ec2';\n\nimport { IBaseCdkConstructProps } from '../../types';\n\n/**\n * Props for BaseVpcConstruct\n *\n * Provides configuration for creating a VPC.\n */\ninterface IVpcConstructProps extends Omit<\n\tIBaseCdkConstructProps<{\n\t\t/** VPC configuration options */\n\t\treadonly vpcOptions: VpcProps;\n\t}>,\n\t'appName' | 'stage' | 'stackName'\n> {}\n\n/**\n * CDK construct for Virtual Private Cloud (VPC)\n *\n * Responsibilities:\n * - Creates a VPC with configurable options\n * - Exposes the VPC ARN as a CloudFormation output\n */\nexport class BaseVpcConstruct extends Construct {\n\t/** The created VPC instance */\n\treadonly vpc: Vpc;\n\n\t/**\n\t * @param scope Parent construct\n\t * @param id Unique construct identifier\n\t * @param props Configuration for VPC\n\t */\n\tconstructor(scope: Construct, id: string, props: IVpcConstructProps) {\n\t\tsuper(scope, id);\n\n\t\tthis.vpc = new Vpc(this, id, {\n\t\t\t...props.options.vpcOptions,\n\t\t});\n\n\t\t/**\n\t\t * CloudFormation output exposing the VPC ARN\n\t\t */\n\t\tnew CfnOutput(this, 'VpcArn', {\n\t\t\tvalue: this.vpc.vpcArn,\n\t\t});\n\t}\n}\n"]}