@8ms/helpers 3.0.27 → 3.1.0

package/dist/aws/cloudWatchMetric/server/AwsCloudWatchMetric.d.mts

@@ -2,7 +2,7 @@ import { BaseNamespace } from "../../../_class/BaseNamespace.mjs";
 import { LogMetric } from "./logMetric.mjs";
 import { CloudWatchClient } from "@aws-sdk/client-cloudwatch";
 //#region src/aws/cloudWatchMetric/server/AwsCloudWatchMetric.d.ts
-declare class AwsCloudWatchMetric extends BaseNamespace {
+export declare class AwsCloudWatchMetric extends BaseNamespace {
   client: CloudWatchClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -13,5 +13,4 @@ declare class AwsCloudWatchMetric extends BaseNamespace {
    */
   logMetric: (namespace: string, metricData: LogMetric | LogMetric[]) => Promise<import("@aws-sdk/client-cloudwatch").PutMetricDataCommandOutput>;
 }
-//#endregion
-export { AwsCloudWatchMetric };
+//#endregion

package/dist/aws/cloudWatchMetric/server/logMetric.d.cts

@@ -2,7 +2,7 @@ import { InputDate } from "../../../date/date.cjs";
 import "../../../date/index.cjs";
 import { StandardUnit } from "@aws-sdk/client-cloudwatch";
 //#region src/aws/cloudWatchMetric/server/logMetric.d.ts
-type LogMetric = {
+export type LogMetric = {
   metricName: string;
   value: number;
   unit?: StandardUnit;
@@ -12,5 +12,4 @@ type LogMetric = {
     value: string;
   }[];
 };
-//#endregion
-export { LogMetric };
+//#endregion

package/dist/aws/cloudWatchMetric/server/logMetric.d.mts

@@ -2,7 +2,7 @@ import { InputDate } from "../../../date/date.mjs";
 import "../../../date/index.mjs";
 import { StandardUnit } from "@aws-sdk/client-cloudwatch";
 //#region src/aws/cloudWatchMetric/server/logMetric.d.ts
-type LogMetric = {
+export type LogMetric = {
   metricName: string;
   value: number;
   unit?: StandardUnit;
@@ -12,5 +12,4 @@ type LogMetric = {
     value: string;
   }[];
 };
-//#endregion
-export { LogMetric };
+//#endregion

package/dist/aws/ec2/server/AwsEc2.d.cts

@@ -1,12 +1,11 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.cjs";
 import { EC2Client } from "@aws-sdk/client-ec2";
 //#region src/aws/ec2/server/AwsEc2.d.ts
-declare class AwsEc2 extends BaseNamespace {
+export declare class AwsEc2 extends BaseNamespace {
   client: EC2Client;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
   startInstances: (instanceIds: string[], additionalInfo?: string, dryRun?: boolean) => Promise<import("@aws-sdk/client-ec2").StartInstancesCommandOutput>;
   stopInstances: (instanceIds: string[], hibernate?: boolean, force?: boolean, dryRun?: boolean) => Promise<import("@aws-sdk/client-ec2").StopInstancesCommandOutput>;
 }
-//#endregion
-export { AwsEc2 };
+//#endregion

package/dist/aws/ec2/server/AwsEc2.d.mts

@@ -1,12 +1,11 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.mjs";
 import { EC2Client } from "@aws-sdk/client-ec2";
 //#region src/aws/ec2/server/AwsEc2.d.ts
-declare class AwsEc2 extends BaseNamespace {
+export declare class AwsEc2 extends BaseNamespace {
   client: EC2Client;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
   startInstances: (instanceIds: string[], additionalInfo?: string, dryRun?: boolean) => Promise<import("@aws-sdk/client-ec2").StartInstancesCommandOutput>;
   stopInstances: (instanceIds: string[], hibernate?: boolean, force?: boolean, dryRun?: boolean) => Promise<import("@aws-sdk/client-ec2").StopInstancesCommandOutput>;
 }
-//#endregion
-export { AwsEc2 };
+//#endregion

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

@@ -0,0 +1,12 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/aws/ec2/server/ec2InstanceState.ts
+const ec2InstanceState = {
+	PENDING: "pending",
+	RUNNING: "running",
+	SHUTTING_DOWN: "shutting-down",
+	TERMINATED: "terminated",
+	STOPPING: "stopping",
+	STOPPED: "stopped"
+};
+//#endregion
+exports.ec2InstanceState = ec2InstanceState;

package/dist/aws/ec2/server/ec2InstanceState.d.cts

@@ -0,0 +1,11 @@
+//#region src/aws/ec2/server/ec2InstanceState.d.ts
+export declare const ec2InstanceState: {
+  readonly PENDING: "pending";
+  readonly RUNNING: "running";
+  readonly SHUTTING_DOWN: "shutting-down";
+  readonly TERMINATED: "terminated";
+  readonly STOPPING: "stopping";
+  readonly STOPPED: "stopped";
+};
+export type Ec2InstanceState = typeof ec2InstanceState[keyof typeof ec2InstanceState];
+//#endregion

package/dist/aws/ec2/server/ec2InstanceState.d.mts

@@ -0,0 +1,11 @@
+//#region src/aws/ec2/server/ec2InstanceState.d.ts
+export declare const ec2InstanceState: {
+  readonly PENDING: "pending";
+  readonly RUNNING: "running";
+  readonly SHUTTING_DOWN: "shutting-down";
+  readonly TERMINATED: "terminated";
+  readonly STOPPING: "stopping";
+  readonly STOPPED: "stopped";
+};
+export type Ec2InstanceState = typeof ec2InstanceState[keyof typeof ec2InstanceState];
+//#endregion

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

@@ -0,0 +1,11 @@
+//#region src/aws/ec2/server/ec2InstanceState.ts
+const ec2InstanceState = {
+	PENDING: "pending",
+	RUNNING: "running",
+	SHUTTING_DOWN: "shutting-down",
+	TERMINATED: "terminated",
+	STOPPING: "stopping",
+	STOPPED: "stopped"
+};
+//#endregion
+export { ec2InstanceState };

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

@@ -1,3 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_aws_ec2_server_AwsEc2 = require("./AwsEc2.cjs");
+const require_aws_ec2_server_ec2InstanceState = require("./ec2InstanceState.cjs");
 exports.AwsEc2 = require_aws_ec2_server_AwsEc2.AwsEc2;
+exports.ec2InstanceState = require_aws_ec2_server_ec2InstanceState.ec2InstanceState;

package/dist/aws/ec2/server/index.d.cts

@@ -1,2 +1,3 @@
 import { AwsEc2 } from "./AwsEc2.cjs";
-export { AwsEc2 };
+import { Ec2InstanceState, ec2InstanceState } from "./ec2InstanceState.cjs";
+export { AwsEc2, Ec2InstanceState, ec2InstanceState };

package/dist/aws/ec2/server/index.d.mts

@@ -1,2 +1,3 @@
 import { AwsEc2 } from "./AwsEc2.mjs";
-export { AwsEc2 };
+import { Ec2InstanceState, ec2InstanceState } from "./ec2InstanceState.mjs";
+export { AwsEc2, Ec2InstanceState, ec2InstanceState };

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

@@ -1,2 +1,3 @@
 import { AwsEc2 } from "./AwsEc2.mjs";
-export { AwsEc2 };
+import { ec2InstanceState } from "./ec2InstanceState.mjs";
+export { AwsEc2, ec2InstanceState };

package/dist/aws/ecs/server/AwsEcs.d.cts

@@ -24,7 +24,7 @@ type RunTaskProps = {
   overrides?: TaskOverride;
   taskDefinition?: string;
 };
-declare class AwsEcs extends BaseNamespace {
+export declare class AwsEcs extends BaseNamespace {
   client: ECSClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -50,5 +50,4 @@ declare class AwsEcs extends BaseNamespace {
    */
   runTask: (props: RunTaskProps) => Promise<any>;
 }
-//#endregion
-export { AwsEcs };
+//#endregion

package/dist/aws/ecs/server/AwsEcs.d.mts

@@ -24,7 +24,7 @@ type RunTaskProps = {
   overrides?: TaskOverride;
   taskDefinition?: string;
 };
-declare class AwsEcs extends BaseNamespace {
+export declare class AwsEcs extends BaseNamespace {
   client: ECSClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -50,5 +50,4 @@ declare class AwsEcs extends BaseNamespace {
    */
   runTask: (props: RunTaskProps) => Promise<any>;
 }
-//#endregion
-export { AwsEcs };
+//#endregion

package/dist/aws/ecs/server/index.cjs

@@ -1,3 +1,5 @@
 Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_aws_ecs_server_AwsEcs = require("./AwsEcs.cjs");
+const require_aws_ecs_server_launchType = require("./launchType.cjs");
 exports.AwsEcs = require_aws_ecs_server_AwsEcs.AwsEcs;
+exports.ecsLaunchType = require_aws_ecs_server_launchType.ecsLaunchType;

package/dist/aws/ecs/server/index.d.cts

@@ -1,2 +1,3 @@
 import { AwsEcs } from "./AwsEcs.cjs";
-export { AwsEcs };
+import { EcsLaunchType, ecsLaunchType } from "./launchType.cjs";
+export { AwsEcs, EcsLaunchType, ecsLaunchType };

package/dist/aws/ecs/server/index.d.mts

@@ -1,2 +1,3 @@
 import { AwsEcs } from "./AwsEcs.mjs";
-export { AwsEcs };
+import { EcsLaunchType, ecsLaunchType } from "./launchType.mjs";
+export { AwsEcs, EcsLaunchType, ecsLaunchType };

package/dist/aws/ecs/server/index.mjs

@@ -1,2 +1,3 @@
 import { AwsEcs } from "./AwsEcs.mjs";
-export { AwsEcs };
+import { ecsLaunchType } from "./launchType.mjs";
+export { AwsEcs, ecsLaunchType };

package/dist/aws/ecs/server/launchType.cjs

@@ -0,0 +1,10 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+//#region src/aws/ecs/server/launchType.ts
+const ecsLaunchType = {
+	EC2: "EC2",
+	EXTERNAL: "EXTERNAL",
+	FARGATE: "FARGATE",
+	MANAGED_INSTANCES: "MANAGED_INSTANCES"
+};
+//#endregion
+exports.ecsLaunchType = ecsLaunchType;

package/dist/aws/ecs/server/launchType.d.cts

@@ -0,0 +1,9 @@
+//#region src/aws/ecs/server/launchType.d.ts
+export declare const ecsLaunchType: {
+  readonly EC2: "EC2";
+  readonly EXTERNAL: "EXTERNAL";
+  readonly FARGATE: "FARGATE";
+  readonly MANAGED_INSTANCES: "MANAGED_INSTANCES";
+};
+export type EcsLaunchType = typeof ecsLaunchType[keyof typeof ecsLaunchType];
+//#endregion

package/dist/aws/ecs/server/launchType.d.mts

@@ -0,0 +1,9 @@
+//#region src/aws/ecs/server/launchType.d.ts
+export declare const ecsLaunchType: {
+  readonly EC2: "EC2";
+  readonly EXTERNAL: "EXTERNAL";
+  readonly FARGATE: "FARGATE";
+  readonly MANAGED_INSTANCES: "MANAGED_INSTANCES";
+};
+export type EcsLaunchType = typeof ecsLaunchType[keyof typeof ecsLaunchType];
+//#endregion

package/dist/aws/ecs/server/launchType.mjs

@@ -0,0 +1,9 @@
+//#region src/aws/ecs/server/launchType.ts
+const ecsLaunchType = {
+	EC2: "EC2",
+	EXTERNAL: "EXTERNAL",
+	FARGATE: "FARGATE",
+	MANAGED_INSTANCES: "MANAGED_INSTANCES"
+};
+//#endregion
+export { ecsLaunchType };

package/dist/aws/glue/server/AwsGlue.d.cts

@@ -1,7 +1,7 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.cjs";
 import { GlueClient } from "@aws-sdk/client-glue";
 //#region src/aws/glue/server/AwsGlue.d.ts
-declare class AwsGlue extends BaseNamespace {
+export declare class AwsGlue extends BaseNamespace {
   client: GlueClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -10,5 +10,4 @@ declare class AwsGlue extends BaseNamespace {
    */
   invoke: (crawler: string) => Promise<boolean>;
 }
-//#endregion
-export { AwsGlue };
+//#endregion

package/dist/aws/glue/server/AwsGlue.d.mts

@@ -1,7 +1,7 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.mjs";
 import { GlueClient } from "@aws-sdk/client-glue";
 //#region src/aws/glue/server/AwsGlue.d.ts
-declare class AwsGlue extends BaseNamespace {
+export declare class AwsGlue extends BaseNamespace {
   client: GlueClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -10,5 +10,4 @@ declare class AwsGlue extends BaseNamespace {
    */
   invoke: (crawler: string) => Promise<boolean>;
 }
-//#endregion
-export { AwsGlue };
+//#endregion

package/dist/aws/lambda/server/AwsLambda.d.cts

@@ -7,7 +7,7 @@ type InvokeProps = {
   isJson?: boolean;
   payload?: object;
 };
-declare class AwsLambda extends BaseNamespace {
+export declare class AwsLambda extends BaseNamespace {
   client: LambdaClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -18,5 +18,4 @@ declare class AwsLambda extends BaseNamespace {
    */
   invoke: (props: InvokeProps) => Promise<any>;
 }
-//#endregion
-export { AwsLambda };
+//#endregion

package/dist/aws/lambda/server/AwsLambda.d.mts

@@ -7,7 +7,7 @@ type InvokeProps = {
   isJson?: boolean;
   payload?: object;
 };
-declare class AwsLambda extends BaseNamespace {
+export declare class AwsLambda extends BaseNamespace {
   client: LambdaClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -18,5 +18,4 @@ declare class AwsLambda extends BaseNamespace {
    */
   invoke: (props: InvokeProps) => Promise<any>;
 }
-//#endregion
-export { AwsLambda };
+//#endregion

package/dist/aws/lambda/server/getHandlerPath.d.cts

@@ -1,4 +1,3 @@
 //#region src/aws/lambda/server/getHandlerPath.d.ts
-declare const getHandlerPath: (input: string) => string;
-//#endregion
-export { getHandlerPath };
+export declare const getHandlerPath: (input: string) => string;
+//#endregion

package/dist/aws/lambda/server/getHandlerPath.d.mts

@@ -1,4 +1,3 @@
 //#region src/aws/lambda/server/getHandlerPath.d.ts
-declare const getHandlerPath: (input: string) => string;
-//#endregion
-export { getHandlerPath };
+export declare const getHandlerPath: (input: string) => string;
+//#endregion

package/dist/aws/s3/server/AwsS3.cjs

@@ -2,6 +2,7 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 const require_runtime = require("../../../_virtual/_rolldown/runtime.cjs");
 const require__class_BaseNamespace = require("../../../_class/BaseNamespace.cjs");
 const require_date_calculation = require("../../../date/calculation.cjs");
+const require_date_date = require("../../../date/date.cjs");
 const require_date_format = require("../../../date/format.cjs");
 require("../../../date/index.cjs");
 const require_string_getFolder = require("../../../string/getFolder.cjs");
@@ -13,6 +14,7 @@ const require_util_server_getBrotliCompressed = require("../../../util/server/ge
 const require_util_server_getBrotliDecompressed = require("../../../util/server/getBrotliDecompressed.cjs");
 const require_util_server_getGzipCompressed = require("../../../util/server/getGzipCompressed.cjs");
 const require_util_server_getGzipDecompressed = require("../../../util/server/getGzipDecompressed.cjs");
+const require_string_server_isEmpty = require("../../../string/server/isEmpty.cjs");
 const require_aws_s3_server_awsS3File = require("./awsS3File.cjs");
 require("./index.cjs");
 let ky = require("ky");
@@ -32,6 +34,16 @@ var AwsS3 = class extends require__class_BaseNamespace.BaseNamespace {
 		}
 		return this;
 	};
+	/**
+	* Guard against writing null/undefined data, or a string that is empty once decoded
+	* (e.g. a gzip/brotli-compressed empty string). Non-string data (Buffer, stream, etc.)
+	* is only checked for null/undefined, since emptiness isn't well-defined for it.
+	*/
+	isNullOrEmptyData = async (data) => {
+		if (null === data || void 0 === data) return true;
+		if ("string" === typeof data) return require_string_server_isEmpty.isEmpty(data);
+		return false;
+	};
 	copy = async (fromBucket, fromKey, toBucket, toKey) => {
 		const { CopyObjectCommand } = await import("@aws-sdk/client-s3");
 		await this.client.send(new CopyObjectCommand({
@@ -190,10 +202,43 @@ var AwsS3 = class extends require__class_BaseNamespace.BaseNamespace {
 		}
 		return response;
 	};
+	getFileHead = async (bucket, key) => {
+		const response = {
+			exists: false,
+			fileType: null,
+			size: -1,
+			modified: require_date_date.defaultDateTime,
+			etag: null,
+			versionId: null,
+			encoding: null,
+			cacheControl: null,
+			meta: {},
+			expires: null
+		};
+		try {
+			const { HeadObjectCommand } = await import("@aws-sdk/client-s3");
+			const apiResponse = await this.client.send(new HeadObjectCommand({
+				Bucket: bucket,
+				Key: key
+			}));
+			response.exists = require_aws_server_isResponse200.isResponse200(apiResponse);
+			response.fileType = apiResponse.ContentType ?? null;
+			response.size = apiResponse.ContentLength ?? -1;
+			response.modified = require_date_format.getYmdHisString(apiResponse.LastModified);
+			response.etag = apiResponse.ETag ?? null;
+			response.versionId = apiResponse.VersionId ?? null;
+			response.encoding = apiResponse.ContentEncoding ?? null;
+			response.cacheControl = apiResponse.CacheControl ?? null;
+			response.meta = apiResponse.Metadata ?? {};
+			response.expires = apiResponse.ExpiresString ?? null;
+		} catch (exception) {
+			response.exists = false;
+		}
+		return response;
+	};
 	readFile = async (bucket, key, options = {}) => {
 		let response = structuredClone(require_aws_s3_server_awsS3File.readFileDefault);
 		const today = require_date_calculation.getToday();
-		require_date_calculation.getToday(true);
 		try {
 			response.now = today.toUnixInteger();
 			const { GetObjectCommand } = await import("@aws-sdk/client-s3");
@@ -236,6 +281,7 @@ var AwsS3 = class extends require__class_BaseNamespace.BaseNamespace {
 		return await this.writeFile(bucket, key, finalData, awsS3Options);
 	};
 	writeFile = async (bucket, key, data, options = {}) => {
+		if (await this.isNullOrEmptyData(data)) return null;
 		const { PutObjectCommand } = await import("@aws-sdk/client-s3");
 		return await this.client.send(new PutObjectCommand({
 			Bucket: bucket,
@@ -248,11 +294,13 @@ var AwsS3 = class extends require__class_BaseNamespace.BaseNamespace {
 		return await this.writeFile(bucket, key, JSON.stringify(data), options);
 	};
 	writeJsonGzip = async (bucket, key, data, gzipOptions = {}, awsS3Options = {}) => {
+		if (await this.isNullOrEmptyData(data)) return null;
 		let finalData = JSON.stringify(data);
 		finalData = await require_util_server_getGzipCompressed.getGzipCompressed(finalData, gzipOptions);
 		return await this.writeFile(bucket, key, finalData, awsS3Options);
 	};
 	writeGzip = async (bucket, key, data, gzipOptions = {}, awsS3Options = {}) => {
+		if (await this.isNullOrEmptyData(data)) return null;
 		let finalData = data;
 		finalData = await require_util_server_getGzipCompressed.getGzipCompressed(finalData, gzipOptions);
 		return await this.writeFile(bucket, key, finalData, awsS3Options);
@@ -261,24 +309,16 @@ var AwsS3 = class extends require__class_BaseNamespace.BaseNamespace {
 	* Get a presigned post URL so we can upload directly to S3 via frontend.
 	*/
 	presignedPost = async (props) => {
-		return new Promise(async (resolve, reject) => {
-			let response = null;
-			const formData = new FormData();
-			Object.entries(props.fields).forEach(([key, value]) => {
-				formData.append(key, value);
-			});
-			formData.append("file", props.file);
-			if ((await fetch(props.url, {
-				method: "POST",
-				body: formData
-			})).ok) {
-				response = `https://${props.bucket}.s3.${this.config.region}.amazonaws.com/${props.key}`;
-				resolve(response);
-			} else {
-				response = null;
-				reject(response);
-			}
+		const formData = new FormData();
+		Object.entries(props.fields).forEach(([key, value]) => {
+			formData.append(key, value);
 		});
+		formData.append("file", props.file);
+		if (!(await fetch(props.url, {
+			method: "POST",
+			body: formData
+		})).ok) throw new Error("Failed to upload to S3");
+		return `https://${props.bucket}.s3.${this.config.region}.amazonaws.com/${props.key}`;
 	};
 	/**
 	* Download a file and write to S3.

package/dist/aws/s3/server/AwsS3.d.cts

@@ -3,9 +3,21 @@ import { Modified, ReadFileResponse } from "./awsS3File.cjs";
 import "./index.cjs";
 import { S3Client } from "@aws-sdk/client-s3";
 //#region src/aws/s3/server/AwsS3.d.ts
-type ReadBufferResponse = Modified & {
+export type ReadBufferResponse = Modified & {
   buffer: any;
 };
+export type FileHeadResponse = {
+  exists: boolean;
+  fileType: string | null;
+  size: number;
+  modified: string;
+  etag: string | null;
+  versionId: string | null;
+  encoding: string | null;
+  cacheControl: string | null;
+  meta: Record<string, string>;
+  expires: string | null;
+};
 type Options = {
   [key: string]: any;
 };
@@ -16,10 +28,16 @@ type WritePresignedPostProps = {
   key: string;
   url: string;
 };
-declare class AwsS3 extends BaseNamespace {
+export declare class AwsS3 extends BaseNamespace {
   client: S3Client;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
+  /**
+   * Guard against writing null/undefined data, or a string that is empty once decoded
+   * (e.g. a gzip/brotli-compressed empty string). Non-string data (Buffer, stream, etc.)
+   * is only checked for null/undefined, since emptiness isn't well-defined for it.
+   */
+  private isNullOrEmptyData;
   copy: (fromBucket: string, fromKey: string, toBucket: string, toKey: string) => Promise<void>;
   deleteFile: (bucket: string, key: string) => Promise<void>;
   deleteFiles: (bucket: string, keys: string[]) => Promise<void>;
@@ -45,23 +63,23 @@ declare class AwsS3 extends BaseNamespace {
   readJsonBrotli: (bucket: string, key: string, brotliOptions?: object, awsS3Options?: Options) => Promise<ReadFileResponse>;
   readBuffer: (bucket: string, key: string) => Promise<ReadBufferResponse>;
   fileExists: (bucket: string, key: string) => Promise<boolean>;
+  getFileHead: (bucket: string, key: string) => Promise<FileHeadResponse>;
   readFile: (bucket: string, key: string, options?: Options) => Promise<ReadFileResponse>;
   readJson: (bucket: string, key: string) => Promise<ReadFileResponse>;
   readJsonGzip: (bucket: string, key: string, gzipOptions?: object, awsS3Options?: Options) => Promise<ReadFileResponse>;
   readGzip: (bucket: string, key: string, gzipOptions?: object, awsS3Options?: Options) => Promise<ReadFileResponse>;
-  writeBrotli: (bucket: string, key: string, data: any, brotliOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeFile: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeJson: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeJsonGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
+  writeBrotli: (bucket: string, key: string, data: any, brotliOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeFile: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeJson: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeJsonGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
   /**
    * Get a presigned post URL so we can upload directly to S3 via frontend.
    */
-  presignedPost: (props: WritePresignedPostProps) => Promise<null | string>;
+  presignedPost: (props: WritePresignedPostProps) => Promise<string>;
   /**
    * Download a file and write to S3.
    */
   urlContents: (bucket: string, key: string, url: string) => Promise<void>;
 }
-//#endregion
-export { AwsS3, ReadBufferResponse };
+//#endregion

package/dist/aws/s3/server/AwsS3.d.mts

@@ -3,9 +3,21 @@ import { Modified, ReadFileResponse } from "./awsS3File.mjs";
 import "./index.mjs";
 import { S3Client } from "@aws-sdk/client-s3";
 //#region src/aws/s3/server/AwsS3.d.ts
-type ReadBufferResponse = Modified & {
+export type ReadBufferResponse = Modified & {
   buffer: any;
 };
+export type FileHeadResponse = {
+  exists: boolean;
+  fileType: string | null;
+  size: number;
+  modified: string;
+  etag: string | null;
+  versionId: string | null;
+  encoding: string | null;
+  cacheControl: string | null;
+  meta: Record<string, string>;
+  expires: string | null;
+};
 type Options = {
   [key: string]: any;
 };
@@ -16,10 +28,16 @@ type WritePresignedPostProps = {
   key: string;
   url: string;
 };
-declare class AwsS3 extends BaseNamespace {
+export declare class AwsS3 extends BaseNamespace {
   client: S3Client;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
+  /**
+   * Guard against writing null/undefined data, or a string that is empty once decoded
+   * (e.g. a gzip/brotli-compressed empty string). Non-string data (Buffer, stream, etc.)
+   * is only checked for null/undefined, since emptiness isn't well-defined for it.
+   */
+  private isNullOrEmptyData;
   copy: (fromBucket: string, fromKey: string, toBucket: string, toKey: string) => Promise<void>;
   deleteFile: (bucket: string, key: string) => Promise<void>;
   deleteFiles: (bucket: string, keys: string[]) => Promise<void>;
@@ -45,23 +63,23 @@ declare class AwsS3 extends BaseNamespace {
   readJsonBrotli: (bucket: string, key: string, brotliOptions?: object, awsS3Options?: Options) => Promise<ReadFileResponse>;
   readBuffer: (bucket: string, key: string) => Promise<ReadBufferResponse>;
   fileExists: (bucket: string, key: string) => Promise<boolean>;
+  getFileHead: (bucket: string, key: string) => Promise<FileHeadResponse>;
   readFile: (bucket: string, key: string, options?: Options) => Promise<ReadFileResponse>;
   readJson: (bucket: string, key: string) => Promise<ReadFileResponse>;
   readJsonGzip: (bucket: string, key: string, gzipOptions?: object, awsS3Options?: Options) => Promise<ReadFileResponse>;
   readGzip: (bucket: string, key: string, gzipOptions?: object, awsS3Options?: Options) => Promise<ReadFileResponse>;
-  writeBrotli: (bucket: string, key: string, data: any, brotliOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeFile: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeJson: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeJsonGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
-  writeGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput>;
+  writeBrotli: (bucket: string, key: string, data: any, brotliOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeFile: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeJson: (bucket: string, key: string, data: any, options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeJsonGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
+  writeGzip: (bucket: string, key: string, data: any, gzipOptions?: object, awsS3Options?: Options) => Promise<import("@aws-sdk/client-s3").PutObjectCommandOutput | null>;
   /**
    * Get a presigned post URL so we can upload directly to S3 via frontend.
    */
-  presignedPost: (props: WritePresignedPostProps) => Promise<null | string>;
+  presignedPost: (props: WritePresignedPostProps) => Promise<string>;
   /**
    * Download a file and write to S3.
    */
   urlContents: (bucket: string, key: string, url: string) => Promise<void>;
 }
-//#endregion
-export { AwsS3, ReadBufferResponse };
+//#endregion