@8ms/helpers 2.4.10 → 2.4.12

package/dist/aws/cloudWatchLog/server/AwsCloudWatchLogNamespace.cjs

@@ -4,66 +4,76 @@ const require_date_calculation = require("../../../date/calculation.cjs");
 require("../../../date/index.cjs");
 //#region src/aws/cloudWatchLog/server/AwsCloudWatchLogNamespace.ts
 var AwsCloudWatchLogNamespace = class extends require__class_BaseNamespace.BaseNamespace {
-	constructor(..._args) {
-		super(..._args);
-		this.ensureInit = async () => {
-			if (!this.client) try {
-				const { CloudWatchLogsClient } = await import("@aws-sdk/client-cloudwatch-logs");
-				this.client = new CloudWatchLogsClient(this.config);
-			} catch (e) {
-				throw new Error("AWS CloudWatch Logs Client not installed");
-			}
-		};
-		this.createLogGroup = async (logGroupName) => {
-			await this.ensureInit();
-			const { CreateLogGroupCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			return await this.client.send(new CreateLogGroupCommand({ logGroupName }));
-		};
-		this.logGroupExists = async (logGroupName) => {
-			await this.ensureInit();
-			const { DescribeLogGroupsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			const response = await this.client.send(new DescribeLogGroupsCommand({
-				logGroupNamePrefix: logGroupName,
-				limit: 1
-			}));
-			if (!response?.logGroups || 0 === response.logGroups.length) return false;
-			return true;
-		};
-		this.createStream = async (logGroupName, logStreamName) => {
-			await this.ensureInit();
-			const { CreateLogStreamCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			return await this.client.send(new CreateLogStreamCommand({
-				logGroupName,
-				logStreamName
-			}));
-		};
-		this.logStreamExists = async (logGroupName, logStreamName) => {
-			await this.ensureInit();
-			const { DescribeLogStreamsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			const response = await this.client.send(new DescribeLogStreamsCommand({
-				logGroupName,
-				logStreamNamePrefix: logStreamName,
-				limit: 1
-			}));
-			if (!response?.logStreams || 0 === response.logStreams.length) return false;
-			return true;
-		};
-		this.logEvent = async (logGroupName, logStreamName, logEvent) => {
-			return await this.logEvents(logGroupName, logStreamName, [logEvent]);
-		};
-		this.logEvents = async (logGroupName, logStreamName, logEvents) => {
-			await this.ensureInit();
-			const { PutLogEventsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			return await this.client.send(new PutLogEventsCommand({
-				logGroupName,
-				logStreamName,
-				logEvents: logEvents.map((event) => ({
-					timestamp: require_date_calculation.getLuxonDate(event.timestamp).toMillis(),
-					message: typeof event.data === "string" ? event.data : JSON.stringify(event.data)
-				}))
-			}));
-		};
-	}
+	ensureInit = async () => {
+		if (!this.client) try {
+			const { CloudWatchLogsClient } = await import("@aws-sdk/client-cloudwatch-logs");
+			this.client = new CloudWatchLogsClient(this.config);
+		} catch (e) {
+			throw new Error("AWS CloudWatch Logs Client not installed");
+		}
+	};
+	/**
+	* Create a CloudWatch Log Group.
+	* This should typically be the name of the application + environment
+	*/
+	createLogGroup = async (logGroupName) => {
+		await this.ensureInit();
+		const { CreateLogGroupCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		return await this.client.send(new CreateLogGroupCommand({ logGroupName }));
+	};
+	/**
+	* Checks whether a CloudWatch Log Group exists.
+	*/
+	logGroupExists = async (logGroupName) => {
+		await this.ensureInit();
+		const { DescribeLogGroupsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		const response = await this.client.send(new DescribeLogGroupsCommand({
+			logGroupNamePrefix: logGroupName,
+			limit: 1
+		}));
+		if (!response?.logGroups || 0 === response.logGroups.length) return false;
+		return true;
+	};
+	/**
+	* Creates a stream within a CloudWatch Log Group.
+	*/
+	createStream = async (logGroupName, logStreamName) => {
+		await this.ensureInit();
+		const { CreateLogStreamCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		return await this.client.send(new CreateLogStreamCommand({
+			logGroupName,
+			logStreamName
+		}));
+	};
+	/**
+	* Checks whether a CloudWatch Log Stream exists within a given Log Group.
+	*/
+	logStreamExists = async (logGroupName, logStreamName) => {
+		await this.ensureInit();
+		const { DescribeLogStreamsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		const response = await this.client.send(new DescribeLogStreamsCommand({
+			logGroupName,
+			logStreamNamePrefix: logStreamName,
+			limit: 1
+		}));
+		if (!response?.logStreams || 0 === response.logStreams.length) return false;
+		return true;
+	};
+	logEvent = async (logGroupName, logStreamName, logEvent) => {
+		return await this.logEvents(logGroupName, logStreamName, [logEvent]);
+	};
+	logEvents = async (logGroupName, logStreamName, logEvents) => {
+		await this.ensureInit();
+		const { PutLogEventsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		return await this.client.send(new PutLogEventsCommand({
+			logGroupName,
+			logStreamName,
+			logEvents: logEvents.map((event) => ({
+				timestamp: require_date_calculation.getLuxonDate(event.timestamp).toMillis(),
+				message: typeof event.data === "string" ? event.data : JSON.stringify(event.data)
+			}))
+		}));
+	};
 };
 //#endregion
 exports.AwsCloudWatchLogNamespace = AwsCloudWatchLogNamespace;

package/dist/aws/cloudWatchLog/server/AwsCloudWatchLogNamespace.mjs

@@ -3,66 +3,76 @@ import { getLuxonDate } from "../../../date/calculation.mjs";
 import "../../../date/index.mjs";
 //#region src/aws/cloudWatchLog/server/AwsCloudWatchLogNamespace.ts
 var AwsCloudWatchLogNamespace = class extends BaseNamespace {
-	constructor(..._args) {
-		super(..._args);
-		this.ensureInit = async () => {
-			if (!this.client) try {
-				const { CloudWatchLogsClient } = await import("@aws-sdk/client-cloudwatch-logs");
-				this.client = new CloudWatchLogsClient(this.config);
-			} catch (e) {
-				throw new Error("AWS CloudWatch Logs Client not installed");
-			}
-		};
-		this.createLogGroup = async (logGroupName) => {
-			await this.ensureInit();
-			const { CreateLogGroupCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			return await this.client.send(new CreateLogGroupCommand({ logGroupName }));
-		};
-		this.logGroupExists = async (logGroupName) => {
-			await this.ensureInit();
-			const { DescribeLogGroupsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			const response = await this.client.send(new DescribeLogGroupsCommand({
-				logGroupNamePrefix: logGroupName,
-				limit: 1
-			}));
-			if (!response?.logGroups || 0 === response.logGroups.length) return false;
-			return true;
-		};
-		this.createStream = async (logGroupName, logStreamName) => {
-			await this.ensureInit();
-			const { CreateLogStreamCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			return await this.client.send(new CreateLogStreamCommand({
-				logGroupName,
-				logStreamName
-			}));
-		};
-		this.logStreamExists = async (logGroupName, logStreamName) => {
-			await this.ensureInit();
-			const { DescribeLogStreamsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			const response = await this.client.send(new DescribeLogStreamsCommand({
-				logGroupName,
-				logStreamNamePrefix: logStreamName,
-				limit: 1
-			}));
-			if (!response?.logStreams || 0 === response.logStreams.length) return false;
-			return true;
-		};
-		this.logEvent = async (logGroupName, logStreamName, logEvent) => {
-			return await this.logEvents(logGroupName, logStreamName, [logEvent]);
-		};
-		this.logEvents = async (logGroupName, logStreamName, logEvents) => {
-			await this.ensureInit();
-			const { PutLogEventsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
-			return await this.client.send(new PutLogEventsCommand({
-				logGroupName,
-				logStreamName,
-				logEvents: logEvents.map((event) => ({
-					timestamp: getLuxonDate(event.timestamp).toMillis(),
-					message: typeof event.data === "string" ? event.data : JSON.stringify(event.data)
-				}))
-			}));
-		};
-	}
+	ensureInit = async () => {
+		if (!this.client) try {
+			const { CloudWatchLogsClient } = await import("@aws-sdk/client-cloudwatch-logs");
+			this.client = new CloudWatchLogsClient(this.config);
+		} catch (e) {
+			throw new Error("AWS CloudWatch Logs Client not installed");
+		}
+	};
+	/**
+	* Create a CloudWatch Log Group.
+	* This should typically be the name of the application + environment
+	*/
+	createLogGroup = async (logGroupName) => {
+		await this.ensureInit();
+		const { CreateLogGroupCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		return await this.client.send(new CreateLogGroupCommand({ logGroupName }));
+	};
+	/**
+	* Checks whether a CloudWatch Log Group exists.
+	*/
+	logGroupExists = async (logGroupName) => {
+		await this.ensureInit();
+		const { DescribeLogGroupsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		const response = await this.client.send(new DescribeLogGroupsCommand({
+			logGroupNamePrefix: logGroupName,
+			limit: 1
+		}));
+		if (!response?.logGroups || 0 === response.logGroups.length) return false;
+		return true;
+	};
+	/**
+	* Creates a stream within a CloudWatch Log Group.
+	*/
+	createStream = async (logGroupName, logStreamName) => {
+		await this.ensureInit();
+		const { CreateLogStreamCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		return await this.client.send(new CreateLogStreamCommand({
+			logGroupName,
+			logStreamName
+		}));
+	};
+	/**
+	* Checks whether a CloudWatch Log Stream exists within a given Log Group.
+	*/
+	logStreamExists = async (logGroupName, logStreamName) => {
+		await this.ensureInit();
+		const { DescribeLogStreamsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		const response = await this.client.send(new DescribeLogStreamsCommand({
+			logGroupName,
+			logStreamNamePrefix: logStreamName,
+			limit: 1
+		}));
+		if (!response?.logStreams || 0 === response.logStreams.length) return false;
+		return true;
+	};
+	logEvent = async (logGroupName, logStreamName, logEvent) => {
+		return await this.logEvents(logGroupName, logStreamName, [logEvent]);
+	};
+	logEvents = async (logGroupName, logStreamName, logEvents) => {
+		await this.ensureInit();
+		const { PutLogEventsCommand } = await import("@aws-sdk/client-cloudwatch-logs");
+		return await this.client.send(new PutLogEventsCommand({
+			logGroupName,
+			logStreamName,
+			logEvents: logEvents.map((event) => ({
+				timestamp: getLuxonDate(event.timestamp).toMillis(),
+				message: typeof event.data === "string" ? event.data : JSON.stringify(event.data)
+			}))
+		}));
+	};
 };
 //#endregion
 export { AwsCloudWatchLogNamespace };

package/dist/aws/cloudWatchMetric/server/AwsCloudWatchMetricNamespace.cjs

@@ -7,35 +7,37 @@ require("../../../date/index.cjs");
 let _aws_sdk_client_cloudwatch = require("@aws-sdk/client-cloudwatch");
 //#region src/aws/cloudWatchMetric/server/AwsCloudWatchMetricNamespace.ts
 var AwsCloudWatchMetricNamespace = class extends require__class_BaseNamespace.BaseNamespace {
-	constructor(..._args) {
-		super(..._args);
-		this.ensureInit = async () => {
-			if (!this.client) try {
-				const { CloudWatchClient } = await import("@aws-sdk/client-cloudwatch");
-				this.client = new CloudWatchClient(this.config);
-			} catch (e) {
-				throw new Error("AWS CloudWatch Client not installed");
-			}
-		};
-		this.logMetric = async (namespace, metricData) => {
-			await this.ensureInit();
-			const { PutMetricDataCommand } = await import("@aws-sdk/client-cloudwatch");
-			const data = require_array_array.getArray(metricData);
-			return await this.client.send(new PutMetricDataCommand({
-				Namespace: namespace,
-				MetricData: data.map((metric) => ({
-					MetricName: metric.metricName,
-					Value: metric.value,
-					Unit: metric?.unit || _aws_sdk_client_cloudwatch.StandardUnit.Count,
-					Timestamp: require_date_calculation.getLuxonDate(metric.timestamp).toJSDate(),
-					Dimensions: metric.dimensions?.map((dimension) => ({
-						Name: dimension.name,
-						Value: dimension.value
-					}))
+	ensureInit = async () => {
+		if (!this.client) try {
+			const { CloudWatchClient } = await import("@aws-sdk/client-cloudwatch");
+			this.client = new CloudWatchClient(this.config);
+		} catch (e) {
+			throw new Error("AWS CloudWatch Client not installed");
+		}
+	};
+	/**
+	* Publishes metric data to CloudWatch.
+	* The namespace is created automatically.
+	* Dimensions should contain additional info (but top level).
+	*/
+	logMetric = async (namespace, metricData) => {
+		await this.ensureInit();
+		const { PutMetricDataCommand } = await import("@aws-sdk/client-cloudwatch");
+		const data = require_array_array.getArray(metricData);
+		return await this.client.send(new PutMetricDataCommand({
+			Namespace: namespace,
+			MetricData: data.map((metric) => ({
+				MetricName: metric.metricName,
+				Value: metric.value,
+				Unit: metric?.unit || _aws_sdk_client_cloudwatch.StandardUnit.Count,
+				Timestamp: require_date_calculation.getLuxonDate(metric.timestamp).toJSDate(),
+				Dimensions: metric.dimensions?.map((dimension) => ({
+					Name: dimension.name,
+					Value: dimension.value
 				}))
-			}));
-		};
-	}
+			}))
+		}));
+	};
 };
 //#endregion
 exports.AwsCloudWatchMetricNamespace = AwsCloudWatchMetricNamespace;

package/dist/aws/cloudWatchMetric/server/AwsCloudWatchMetricNamespace.mjs

@@ -5,35 +5,37 @@ import "../../../date/index.mjs";
 import { StandardUnit } from "@aws-sdk/client-cloudwatch";
 //#region src/aws/cloudWatchMetric/server/AwsCloudWatchMetricNamespace.ts
 var AwsCloudWatchMetricNamespace = class extends BaseNamespace {
-	constructor(..._args) {
-		super(..._args);
-		this.ensureInit = async () => {
-			if (!this.client) try {
-				const { CloudWatchClient } = await import("@aws-sdk/client-cloudwatch");
-				this.client = new CloudWatchClient(this.config);
-			} catch (e) {
-				throw new Error("AWS CloudWatch Client not installed");
-			}
-		};
-		this.logMetric = async (namespace, metricData) => {
-			await this.ensureInit();
-			const { PutMetricDataCommand } = await import("@aws-sdk/client-cloudwatch");
-			const data = getArray(metricData);
-			return await this.client.send(new PutMetricDataCommand({
-				Namespace: namespace,
-				MetricData: data.map((metric) => ({
-					MetricName: metric.metricName,
-					Value: metric.value,
-					Unit: metric?.unit || StandardUnit.Count,
-					Timestamp: getLuxonDate(metric.timestamp).toJSDate(),
-					Dimensions: metric.dimensions?.map((dimension) => ({
-						Name: dimension.name,
-						Value: dimension.value
-					}))
+	ensureInit = async () => {
+		if (!this.client) try {
+			const { CloudWatchClient } = await import("@aws-sdk/client-cloudwatch");
+			this.client = new CloudWatchClient(this.config);
+		} catch (e) {
+			throw new Error("AWS CloudWatch Client not installed");
+		}
+	};
+	/**
+	* Publishes metric data to CloudWatch.
+	* The namespace is created automatically.
+	* Dimensions should contain additional info (but top level).
+	*/
+	logMetric = async (namespace, metricData) => {
+		await this.ensureInit();
+		const { PutMetricDataCommand } = await import("@aws-sdk/client-cloudwatch");
+		const data = getArray(metricData);
+		return await this.client.send(new PutMetricDataCommand({
+			Namespace: namespace,
+			MetricData: data.map((metric) => ({
+				MetricName: metric.metricName,
+				Value: metric.value,
+				Unit: metric?.unit || StandardUnit.Count,
+				Timestamp: getLuxonDate(metric.timestamp).toJSDate(),
+				Dimensions: metric.dimensions?.map((dimension) => ({
+					Name: dimension.name,
+					Value: dimension.value
 				}))
-			}));
-		};
-	}
+			}))
+		}));
+	};
 };
 //#endregion
 export { AwsCloudWatchMetricNamespace };

package/dist/aws/ec2/server/AwsEc2Namespace.cjs

@@ -2,38 +2,35 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require__class_BaseNamespace = require("../../../_class/BaseNamespace.cjs");
 //#region src/aws/ec2/server/AwsEc2Namespace.ts
 var AwsEc2Namespace = class extends require__class_BaseNamespace.BaseNamespace {
-	constructor(..._args) {
-		super(..._args);
-		this.ensureInit = async () => {
-			if (!this.client) try {
-				const { EC2Client } = await import("@aws-sdk/client-ec2");
-				this.client = new EC2Client(this.config);
-			} catch (e) {
-				throw new Error("AWS EC2 Client not installed");
-			}
-		};
-		this.startInstances = async (instanceIds, additionalInfo, dryRun) => {
-			await this.ensureInit();
-			const { StartInstancesCommand } = await import("@aws-sdk/client-ec2");
-			const command = new StartInstancesCommand({
-				InstanceIds: instanceIds,
-				AdditionalInfo: additionalInfo,
-				DryRun: dryRun
-			});
-			return await this.client.send(command);
-		};
-		this.stopInstances = async (instanceIds, hibernate, force, dryRun) => {
-			await this.ensureInit();
-			const { StopInstancesCommand } = await import("@aws-sdk/client-ec2");
-			const command = new StopInstancesCommand({
-				InstanceIds: instanceIds,
-				Hibernate: hibernate,
-				DryRun: dryRun,
-				Force: force
-			});
-			return await this.client.send(command);
-		};
-	}
+	ensureInit = async () => {
+		if (!this.client) try {
+			const { EC2Client } = await import("@aws-sdk/client-ec2");
+			this.client = new EC2Client(this.config);
+		} catch (e) {
+			throw new Error("AWS EC2 Client not installed");
+		}
+	};
+	startInstances = async (instanceIds, additionalInfo, dryRun) => {
+		await this.ensureInit();
+		const { StartInstancesCommand } = await import("@aws-sdk/client-ec2");
+		const command = new StartInstancesCommand({
+			InstanceIds: instanceIds,
+			AdditionalInfo: additionalInfo,
+			DryRun: dryRun
+		});
+		return await this.client.send(command);
+	};
+	stopInstances = async (instanceIds, hibernate, force, dryRun) => {
+		await this.ensureInit();
+		const { StopInstancesCommand } = await import("@aws-sdk/client-ec2");
+		const command = new StopInstancesCommand({
+			InstanceIds: instanceIds,
+			Hibernate: hibernate,
+			DryRun: dryRun,
+			Force: force
+		});
+		return await this.client.send(command);
+	};
 };
 //#endregion
 exports.AwsEc2Namespace = AwsEc2Namespace;

package/dist/aws/ec2/server/AwsEc2Namespace.mjs

@@ -1,38 +1,35 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.mjs";
 //#region src/aws/ec2/server/AwsEc2Namespace.ts
 var AwsEc2Namespace = class extends BaseNamespace {
-	constructor(..._args) {
-		super(..._args);
-		this.ensureInit = async () => {
-			if (!this.client) try {
-				const { EC2Client } = await import("@aws-sdk/client-ec2");
-				this.client = new EC2Client(this.config);
-			} catch (e) {
-				throw new Error("AWS EC2 Client not installed");
-			}
-		};
-		this.startInstances = async (instanceIds, additionalInfo, dryRun) => {
-			await this.ensureInit();
-			const { StartInstancesCommand } = await import("@aws-sdk/client-ec2");
-			const command = new StartInstancesCommand({
-				InstanceIds: instanceIds,
-				AdditionalInfo: additionalInfo,
-				DryRun: dryRun
-			});
-			return await this.client.send(command);
-		};
-		this.stopInstances = async (instanceIds, hibernate, force, dryRun) => {
-			await this.ensureInit();
-			const { StopInstancesCommand } = await import("@aws-sdk/client-ec2");
-			const command = new StopInstancesCommand({
-				InstanceIds: instanceIds,
-				Hibernate: hibernate,
-				DryRun: dryRun,
-				Force: force
-			});
-			return await this.client.send(command);
-		};
-	}
+	ensureInit = async () => {
+		if (!this.client) try {
+			const { EC2Client } = await import("@aws-sdk/client-ec2");
+			this.client = new EC2Client(this.config);
+		} catch (e) {
+			throw new Error("AWS EC2 Client not installed");
+		}
+	};
+	startInstances = async (instanceIds, additionalInfo, dryRun) => {
+		await this.ensureInit();
+		const { StartInstancesCommand } = await import("@aws-sdk/client-ec2");
+		const command = new StartInstancesCommand({
+			InstanceIds: instanceIds,
+			AdditionalInfo: additionalInfo,
+			DryRun: dryRun
+		});
+		return await this.client.send(command);
+	};
+	stopInstances = async (instanceIds, hibernate, force, dryRun) => {
+		await this.ensureInit();
+		const { StopInstancesCommand } = await import("@aws-sdk/client-ec2");
+		const command = new StopInstancesCommand({
+			InstanceIds: instanceIds,
+			Hibernate: hibernate,
+			DryRun: dryRun,
+			Force: force
+		});
+		return await this.client.send(command);
+	};
 };
 //#endregion
 export { AwsEc2Namespace };