@8ms/helpers 3.0.26 → 3.1.0

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

@@ -1,5 +1,6 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.mjs";
 import { getToday } from "../../../date/calculation.mjs";
+import { defaultDateTime } from "../../../date/date.mjs";
 import { getYmdHisString } from "../../../date/format.mjs";
 import "../../../date/index.mjs";
 import { getFolder } from "../../../string/getFolder.mjs";
@@ -11,6 +12,7 @@ import { getBrotliCompressed } from "../../../util/server/getBrotliCompressed.mj
 import { getBrotliDecompressed } from "../../../util/server/getBrotliDecompressed.mjs";
 import { getGzipCompressed } from "../../../util/server/getGzipCompressed.mjs";
 import { getGzipDecompressed } from "../../../util/server/getGzipDecompressed.mjs";
+import { isEmpty } from "../../../string/server/isEmpty.mjs";
 import { readFileDefault } from "./awsS3File.mjs";
 import "./index.mjs";
 import ky from "ky";
@@ -29,6 +31,16 @@ var AwsS3 = class extends 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 isEmpty(data);
+		return false;
+	};
 	copy = async (fromBucket, fromKey, toBucket, toKey) => {
 		const { CopyObjectCommand } = await import("@aws-sdk/client-s3");
 		await this.client.send(new CopyObjectCommand({
@@ -187,10 +199,43 @@ var AwsS3 = class extends BaseNamespace {
 		}
 		return response;
 	};
+	getFileHead = async (bucket, key) => {
+		const response = {
+			exists: false,
+			fileType: null,
+			size: -1,
+			modified: 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 = isResponse200(apiResponse);
+			response.fileType = apiResponse.ContentType ?? null;
+			response.size = apiResponse.ContentLength ?? -1;
+			response.modified = 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(readFileDefault);
 		const today = getToday();
-		getToday(true);
 		try {
 			response.now = today.toUnixInteger();
 			const { GetObjectCommand } = await import("@aws-sdk/client-s3");
@@ -233,6 +278,7 @@ var AwsS3 = class extends 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,
@@ -245,11 +291,13 @@ var AwsS3 = class extends 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 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 getGzipCompressed(finalData, gzipOptions);
 		return await this.writeFile(bucket, key, finalData, awsS3Options);
@@ -258,24 +306,16 @@ var AwsS3 = class extends 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/awsS3File.d.cts

@@ -1,12 +1,11 @@
 //#region src/aws/s3/server/awsS3File.d.ts
-type Modified = {
+export type Modified = {
   now?: number;
   modified: string;
 };
-type ReadFileResponse = Modified & {
+export type ReadFileResponse = Modified & {
   body: any;
   error: any;
 };
-declare const readFileDefault: ReadFileResponse;
-//#endregion
-export { Modified, ReadFileResponse, readFileDefault };
+export declare const readFileDefault: ReadFileResponse;
+//#endregion

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

@@ -1,12 +1,11 @@
 //#region src/aws/s3/server/awsS3File.d.ts
-type Modified = {
+export type Modified = {
   now?: number;
   modified: string;
 };
-type ReadFileResponse = Modified & {
+export type ReadFileResponse = Modified & {
   body: any;
   error: any;
 };
-declare const readFileDefault: ReadFileResponse;
-//#endregion
-export { Modified, ReadFileResponse, readFileDefault };
+export declare const readFileDefault: ReadFileResponse;
+//#endregion

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

@@ -1,4 +1,4 @@
 import { Modified, ReadFileResponse, readFileDefault } from "./awsS3File.cjs";
 import { PayloadSchemaType, payloadSchema } from "./payload.cjs";
-import { AwsS3, ReadBufferResponse } from "./AwsS3.cjs";
-export { AwsS3, Modified, PayloadSchemaType, ReadBufferResponse, ReadFileResponse, payloadSchema, readFileDefault };
+import { AwsS3, FileHeadResponse, ReadBufferResponse } from "./AwsS3.cjs";
+export { AwsS3, FileHeadResponse, Modified, PayloadSchemaType, ReadBufferResponse, ReadFileResponse, payloadSchema, readFileDefault };

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

@@ -1,4 +1,4 @@
 import { Modified, ReadFileResponse, readFileDefault } from "./awsS3File.mjs";
 import { PayloadSchemaType, payloadSchema } from "./payload.mjs";
-import { AwsS3, ReadBufferResponse } from "./AwsS3.mjs";
-export { AwsS3, Modified, PayloadSchemaType, ReadBufferResponse, ReadFileResponse, payloadSchema, readFileDefault };
+import { AwsS3, FileHeadResponse, ReadBufferResponse } from "./AwsS3.mjs";
+export { AwsS3, FileHeadResponse, Modified, PayloadSchemaType, ReadBufferResponse, ReadFileResponse, payloadSchema, readFileDefault };

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

@@ -2,6 +2,8 @@ Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
 let zod_v4 = require("zod/v4");
 //#region src/aws/s3/server/payload.ts
 /**
+* This comes from AWS using S3 callback.
+*
 * https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-content-structure.html
 */
 const payloadSchema = zod_v4.z.object({ Records: zod_v4.z.object({

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

@@ -1,9 +1,11 @@
 import { z } from "zod/v4";
 //#region src/aws/s3/server/payload.d.ts
 /**
+ * This comes from AWS using S3 callback.
+ *
  * https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-content-structure.html
  */
-declare const payloadSchema: z.ZodObject<{
+export declare const payloadSchema: z.ZodObject<{
   Records: z.ZodArray<z.ZodObject<{
     eventVersion: z.ZodString;
     eventSource: z.ZodString;
@@ -40,6 +42,5 @@ declare const payloadSchema: z.ZodObject<{
     }, z.core.$strip>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
-type PayloadSchemaType = z.infer<typeof payloadSchema>;
-//#endregion
-export { PayloadSchemaType, payloadSchema };
+export type PayloadSchemaType = z.infer<typeof payloadSchema>;
+//#endregion

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

@@ -1,9 +1,11 @@
 import { z } from "zod/v4";
 //#region src/aws/s3/server/payload.d.ts
 /**
+ * This comes from AWS using S3 callback.
+ *
  * https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-content-structure.html
  */
-declare const payloadSchema: z.ZodObject<{
+export declare const payloadSchema: z.ZodObject<{
   Records: z.ZodArray<z.ZodObject<{
     eventVersion: z.ZodString;
     eventSource: z.ZodString;
@@ -40,6 +42,5 @@ declare const payloadSchema: z.ZodObject<{
     }, z.core.$strip>;
   }, z.core.$strip>>;
 }, z.core.$strip>;
-type PayloadSchemaType = z.infer<typeof payloadSchema>;
-//#endregion
-export { PayloadSchemaType, payloadSchema };
+export type PayloadSchemaType = z.infer<typeof payloadSchema>;
+//#endregion

package/dist/aws/s3/server/payload.mjs

@@ -1,6 +1,8 @@
 import { z } from "zod/v4";
 //#region src/aws/s3/server/payload.ts
 /**
+* This comes from AWS using S3 callback.
+*
 * https://docs.aws.amazon.com/AmazonS3/latest/userguide/notification-content-structure.html
 */
 const payloadSchema = z.object({ Records: z.object({

package/dist/aws/server/getAwsConfig.d.cts

@@ -13,6 +13,5 @@ type AwsConfig = {
     sessionToken?: string;
   };
 };
-declare const getAwsConfig: (props: GetAwsConfigProps) => Promise<AwsConfig>;
-//#endregion
-export { getAwsConfig };
+export declare const getAwsConfig: (props: GetAwsConfigProps) => Promise<AwsConfig>;
+//#endregion

package/dist/aws/server/getAwsConfig.d.mts

@@ -13,6 +13,5 @@ type AwsConfig = {
     sessionToken?: string;
   };
 };
-declare const getAwsConfig: (props: GetAwsConfigProps) => Promise<AwsConfig>;
-//#endregion
-export { getAwsConfig };
+export declare const getAwsConfig: (props: GetAwsConfigProps) => Promise<AwsConfig>;
+//#endregion

package/dist/aws/server/isResponse200.d.cts

@@ -2,6 +2,5 @@
 /**
  * Was the API response a 200?
  */
-declare const isResponse200: (apiResponse: any) => boolean;
-//#endregion
-export { isResponse200 };
+export declare const isResponse200: (apiResponse: any) => boolean;
+//#endregion

package/dist/aws/server/isResponse200.d.mts

@@ -2,6 +2,5 @@
 /**
  * Was the API response a 200?
  */
-declare const isResponse200: (apiResponse: any) => boolean;
-//#endregion
-export { isResponse200 };
+export declare const isResponse200: (apiResponse: any) => boolean;
+//#endregion

package/dist/aws/ses/server/AwsSes.d.cts

@@ -1,11 +1,10 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.cjs";
 import { SESv2Client, SendEmailCommandInput } from "@aws-sdk/client-sesv2";
 //#region src/aws/ses/server/AwsSes.d.ts
-declare class AwsSes extends BaseNamespace {
+export declare class AwsSes extends BaseNamespace {
   client: SESv2Client;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
   send: (input: SendEmailCommandInput) => Promise<unknown>;
 }
-//#endregion
-export { AwsSes };
+//#endregion

package/dist/aws/ses/server/AwsSes.d.mts

@@ -1,11 +1,10 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.mjs";
 import { SESv2Client, SendEmailCommandInput } from "@aws-sdk/client-sesv2";
 //#region src/aws/ses/server/AwsSes.d.ts
-declare class AwsSes extends BaseNamespace {
+export declare class AwsSes extends BaseNamespace {
   client: SESv2Client;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
   send: (input: SendEmailCommandInput) => Promise<unknown>;
 }
-//#endregion
-export { AwsSes };
+//#endregion

package/dist/aws/ses/server/SimpleEmail.d.cts

@@ -19,7 +19,7 @@ type ConstructorProps = {
 /**
  * Class to build and send an AWS SES email.
  */
-declare class SimpleEmail extends BaseClass {
+export declare class SimpleEmail extends BaseClass {
   from?: string;
   to: string[];
   cc: string[];
@@ -51,5 +51,4 @@ declare class SimpleEmail extends BaseClass {
   private _getContentTypeFromFilename;
   private _filterRecipients;
 }
-//#endregion
-export { SimpleEmail };
+//#endregion

package/dist/aws/ses/server/SimpleEmail.d.mts

@@ -19,7 +19,7 @@ type ConstructorProps = {
 /**
  * Class to build and send an AWS SES email.
  */
-declare class SimpleEmail extends BaseClass {
+export declare class SimpleEmail extends BaseClass {
   from?: string;
   to: string[];
   cc: string[];
@@ -51,5 +51,4 @@ declare class SimpleEmail extends BaseClass {
   private _getContentTypeFromFilename;
   private _filterRecipients;
 }
-//#endregion
-export { SimpleEmail };
+//#endregion

package/dist/aws/sqs/server/AwsSqs.d.cts

@@ -23,7 +23,7 @@ type AddToQueue = {
   queueId?: string;
   queueUrl: string;
 };
-declare class AwsSqs extends BaseNamespace {
+export declare class AwsSqs extends BaseNamespace {
   client: SQSClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -31,5 +31,4 @@ declare class AwsSqs extends BaseNamespace {
   deleteFromQueue: (queueUrl: string, recipientHandle: string) => Promise<import("@aws-sdk/client-sqs").DeleteMessageCommandOutput>;
   isEventSqs: (event: SqsEvent) => Promise<boolean>;
 }
-//#endregion
-export { AwsSqs };
+//#endregion

package/dist/aws/sqs/server/AwsSqs.d.mts

@@ -23,7 +23,7 @@ type AddToQueue = {
   queueId?: string;
   queueUrl: string;
 };
-declare class AwsSqs extends BaseNamespace {
+export declare class AwsSqs extends BaseNamespace {
   client: SQSClient;
   config: any;
   init: (config: any, region?: string) => Promise<this>;
@@ -31,5 +31,4 @@ declare class AwsSqs extends BaseNamespace {
   deleteFromQueue: (queueUrl: string, recipientHandle: string) => Promise<import("@aws-sdk/client-sqs").DeleteMessageCommandOutput>;
   isEventSqs: (event: SqsEvent) => Promise<boolean>;
 }
-//#endregion
-export { AwsSqs };
+//#endregion

package/dist/aws/ssm/server/AwsSsm.d.cts

@@ -1,12 +1,11 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.cjs";
 import { SSMClient } from "@aws-sdk/client-ssm";
 //#region src/aws/ssm/server/AwsSsm.d.ts
-declare class AwsSsm extends BaseNamespace {
+export declare class AwsSsm extends BaseNamespace {
   client: SSMClient;
   config: any;
   parameters: Map<string, any>;
   init: (config: any, region?: string) => Promise<this>;
   getParameter: (name: string, withDecryption?: boolean, isJson?: boolean) => Promise<any>;
 }
-//#endregion
-export { AwsSsm };
+//#endregion

package/dist/aws/ssm/server/AwsSsm.d.mts

@@ -1,12 +1,11 @@
 import { BaseNamespace } from "../../../_class/BaseNamespace.mjs";
 import { SSMClient } from "@aws-sdk/client-ssm";
 //#region src/aws/ssm/server/AwsSsm.d.ts
-declare class AwsSsm extends BaseNamespace {
+export declare class AwsSsm extends BaseNamespace {
   client: SSMClient;
   config: any;
   parameters: Map<string, any>;
   init: (config: any, region?: string) => Promise<this>;
   getParameter: (name: string, withDecryption?: boolean, isJson?: boolean) => Promise<any>;
 }
-//#endregion
-export { AwsSsm };
+//#endregion

package/dist/boolean/boolean.d.cts

@@ -2,6 +2,5 @@
 /**
  * Convert an input from a variety of forms into boolean.
  */
-declare const getBoolean: (input: any, defaultValue?: boolean) => boolean;
-//#endregion
-export { getBoolean };
+export declare const getBoolean: (input: any, defaultValue?: boolean) => boolean;
+//#endregion

package/dist/boolean/boolean.d.mts

@@ -2,6 +2,5 @@
 /**
  * Convert an input from a variety of forms into boolean.
  */
-declare const getBoolean: (input: any, defaultValue?: boolean) => boolean;
-//#endregion
-export { getBoolean };
+export declare const getBoolean: (input: any, defaultValue?: boolean) => boolean;
+//#endregion

package/dist/brightData/googleTrends/brightDataSerpGoogleTrends.cjs

@@ -0,0 +1,97 @@
+Object.defineProperty(exports, Symbol.toStringTag, { value: "Module" });
+const require_brightData_googleTrends_widgetId = require("./widgetId.cjs");
+let zod = require("zod");
+//#region src/brightData/googleTrends/brightDataSerpGoogleTrends.ts
+const TimelineSchema = zod.z.object({
+	id: zod.z.literal(require_brightData_googleTrends_widgetId.widgetId.TIMESERIES),
+	type: zod.z.literal(require_brightData_googleTrends_widgetId.widgetType.TIMESERIES),
+	title: zod.z.string(),
+	data: zod.z.object({ default: zod.z.object({
+		timelineData: zod.z.object({
+			time: zod.z.string(),
+			formattedTime: zod.z.string(),
+			formattedAxisTime: zod.z.string(),
+			value: zod.z.number().array().length(1),
+			hasData: zod.z.boolean().array().length(1),
+			formattedValue: zod.z.string().array().length(1),
+			isPartial: zod.z.boolean().optional()
+		}).array(),
+		averages: zod.z.any().array()
+	}) })
+});
+const GeoSchema = zod.z.object({
+	id: zod.z.literal(require_brightData_googleTrends_widgetId.widgetId.GEO),
+	type: zod.z.literal(require_brightData_googleTrends_widgetId.widgetType.GEO),
+	title: zod.z.string(),
+	data: zod.z.object({ default: zod.z.object({ geoMapData: zod.z.object({
+		geoCode: zod.z.string(),
+		geoName: zod.z.string(),
+		value: zod.z.number().array().length(1),
+		formattedValue: zod.z.string().array().length(1),
+		maxValueIndex: zod.z.number(),
+		hasData: zod.z.boolean().array().length(1)
+	}).array() }) })
+});
+const RelatedTopicsSchema = zod.z.object({
+	id: zod.z.literal(require_brightData_googleTrends_widgetId.widgetId.RELATED_TOPICS),
+	type: zod.z.literal(require_brightData_googleTrends_widgetId.widgetType.RELATED_TOPICS),
+	title: zod.z.string(),
+	data: zod.z.object({ default: zod.z.object({ rankedList: zod.z.tuple([zod.z.object({ rankedKeyword: zod.z.object({
+		topic: zod.z.object({
+			mid: zod.z.string(),
+			title: zod.z.string(),
+			type: zod.z.string()
+		}),
+		value: zod.z.number(),
+		formattedValue: zod.z.string(),
+		hasData: zod.z.boolean(),
+		link: zod.z.string()
+	}).array() }), zod.z.object({ rankedKeyword: zod.z.object({
+		topic: zod.z.object({
+			mid: zod.z.string(),
+			title: zod.z.string(),
+			type: zod.z.string()
+		}),
+		value: zod.z.number(),
+		formattedValue: zod.z.string(),
+		link: zod.z.string()
+	}).array() })]) }) })
+});
+const RelatedQueriesSchema = zod.z.object({
+	id: zod.z.literal(require_brightData_googleTrends_widgetId.widgetId.RELATED_QUERIES),
+	type: zod.z.literal(require_brightData_googleTrends_widgetId.widgetType.RELATED_QUERIES),
+	title: zod.z.string(),
+	data: zod.z.object({ default: zod.z.object({ rankedList: zod.z.tuple([zod.z.object({ rankedKeyword: zod.z.object({
+		query: zod.z.string(),
+		value: zod.z.number(),
+		formattedValue: zod.z.string(),
+		hasData: zod.z.boolean(),
+		link: zod.z.string()
+	}).array() }), zod.z.object({ rankedKeyword: zod.z.object({
+		query: zod.z.string(),
+		value: zod.z.number(),
+		formattedValue: zod.z.string(),
+		link: zod.z.string()
+	}).array() })]) }) })
+});
+const KeywordsSchema = zod.z.object({
+	keyword: zod.z.string(),
+	name: zod.z.string(),
+	type: zod.z.string()
+}).array().length(1);
+const BrightDataSerpGoogleTrendsSchema = zod.z.object({
+	widgets: zod.z.tuple([
+		TimelineSchema,
+		GeoSchema,
+		RelatedTopicsSchema,
+		RelatedQueriesSchema
+	]),
+	keywords: KeywordsSchema
+});
+//#endregion
+exports.BrightDataSerpGoogleTrendsSchema = BrightDataSerpGoogleTrendsSchema;
+exports.GeoSchema = GeoSchema;
+exports.KeywordsSchema = KeywordsSchema;
+exports.RelatedQueriesSchema = RelatedQueriesSchema;
+exports.RelatedTopicsSchema = RelatedTopicsSchema;
+exports.TimelineSchema = TimelineSchema;