@8ms/helpers 1.38.0 → 2.0.0

package/.yarnrc.yml

@@ -0,0 +1,2 @@
+nodeLinker: node-modules
+yarnPath: .yarn/releases/yarn-4.9.2.cjs

package/README.md

@@ -0,0 +1,12 @@
+# Yarn 4
+Use corepack to run Yarn 4 for this project.
+
+# Dates and Timezones
+
+Currently this is not possible to test using timezone-mock due to changing the timezone across the board and appears to not take effect.
+
+If a date is coming from the Database/Server it should be in UTC.
+
+If a date is coming from the client side, the server needs to convert this input into UTC before being processed. 
+
+Where possible dates should be passed as YYYYMMDD numbers so they are only converted for presentation purposes.

package/package.json

@@ -1,54 +1,183 @@
 {
-	"name":            "@8ms/helpers",
-	"license":         "UNLICENSED",
-	"version":         "1.38.0",
-	"repository":      {
+	"name": "@8ms/helpers",
+	"license": "UNLICENSED",
+	"version": "2.0.0",
+	"repository": {
 		"type": "git",
-		"url":  "git+https://github.com/8millionstories-organisation/8ms-helpers-ts.git"
+		"url": "git+https://github.com/8millionstories-organisation/8ms-helpers-ts.git"
 	},
-	"main":            "index.js",
-	"types":           "index.d.ts",
-	"scripts":         {
+	"main": "index.js",
+	"types": "index.d.ts",
+	"scripts": {
 		"build": "tsc",
-		"jest":  "jest --watch"
+		"jest": "jest --watch"
 	},
-	"dependencies":    {
-		"@date-fns/tz":  "1.2.0",
-		"@date-fns/utc": "2.1.0",
-		"axios":         "1.7.8",
-		"crypto-js":     "4.2.0",
-		"date-fns":      "4.1.0",
-		"lodash":        "4.17.21",
-		"zod":           "3.23.8"
+	"engines": {
+		"node": "22"
+	},
+	"dependencies": {
+		"axios": "1.9.0",
+		"lodash": "4.17.21",
+		"luxon": "3.6.1",
+		"zod": "3.25.63"
+	},
+	"peerDependencies": {
+		"@1password/sdk": "0.3.1",
+		"@aws-sdk/client-ec2": "3.828.0",
+		"@aws-sdk/client-ecs": "3.828.0",
+		"@aws-sdk/client-glue": "3.828.0",
+		"@aws-sdk/client-lambda": "3.828.0",
+		"@aws-sdk/client-s3": "3.828.0",
+		"@aws-sdk/client-ses": "3.828.0",
+		"@aws-sdk/client-sqs": "3.828.0",
+		"@aws-sdk/client-ssm": "3.828.0",
+		"@aws-sdk/lib-storage": "3.828.0",
+		"@aws-sdk/s3-request-presigner": "3.828.0",
+		"@google-cloud/bigquery": "7.9.1",
+		"@google-cloud/storage": "7.14.0",
+		"@googleapis/sheets": "10.0.1",
+		"@planetscale/database": "1.19.0",
+		"@prisma/adapter-planetscale": "5.22.0",
+		"@prisma/client": "5.22.0",
+		"athena-express": "7.1.5",
+		"aws-sdk": "2.1692.0",
+		"crypto-js": "4.2.0",
+		"fs-extra": "11.3.0",
+		"google-ads-api": "20.0.1",
+		"react": "19.1.0",
+		"stream-chain": "3.3.2",
+		"stream-json": "1.9.1",
+		"swr": "2.3.3"
+	},
+	"peerDependenciesMeta": {
+		"@1password/sdk": {
+			"optional": true
+		},
+		"@aws-sdk/client-ec2": {
+			"optional": true
+		},
+		"@aws-sdk/client-ecs": {
+			"optional": true
+		},
+		"@aws-sdk/client-glue": {
+			"optional": true
+		},
+		"@aws-sdk/client-lambda": {
+			"optional": true
+		},
+		"@aws-sdk/client-s3": {
+			"optional": true
+		},
+		"@aws-sdk/client-ses": {
+			"optional": true
+		},
+		"@aws-sdk/client-sqs": {
+			"optional": true
+		},
+		"@aws-sdk/client-ssm": {
+			"optional": true
+		},
+		"@aws-sdk/lib-storage": {
+			"optional": true
+		},
+		"@aws-sdk/s3-request-presigner": {
+			"optional": true
+		},
+		"@google-cloud/bigquery": {
+			"optional": true
+		},
+		"@google-cloud/storage": {
+			"optional": true
+		},
+		"@googleapis/sheets": {
+			"optional": true
+		},
+		"@planetscale/database": {
+			"optional": true
+		},
+		"@prisma/adapter-planetscale": {
+			"optional": true
+		},
+		"@prisma/client": {
+			"optional": true
+		},
+		"athena-express": {
+			"optional": true
+		},
+		"aws-sdk": {
+			"optional": true
+		},
+		"crypto-js": {
+			"optional": true
+		},
+		"fs-extra": {
+			"optional": true
+		},
+		"google-ads-api": {
+			"optional": true
+		},
+		"react": {
+			"optional": true
+		},
+		"stream-chain": {
+			"optional": true
+		},
+		"stream-json": {
+			"optional": true
+		},
+		"swr": {
+			"optional": true
+		},
+		"zod": {
+			"optional": true
+		}
 	},
 	"devDependencies": {
-		"@aws-sdk/client-ec2":           "3.701.0",
-		"@aws-sdk/client-ecs":           "3.699.0",
-		"@aws-sdk/client-s3":            "3.701.0",
-		"@aws-sdk/client-ses":           "3.699.0",
-		"@aws-sdk/client-sqs":           "3.699.0",
-		"@aws-sdk/client-ssm":           "3.699.0",
-		"@aws-sdk/lib-storage":          "3.701.0",
-		"@aws-sdk/s3-request-presigner": "3.701.0",
-		"@babel/preset-env":             "7.26.0",
-		"@babel/preset-flow":            "7.25.9",
-		"@babel/preset-typescript":      "7.26.0",
-		"@google-cloud/bigquery":        "7.9.1",
-		"@google-cloud/storage":         "7.14.0",
-		"@planetscale/database":         "1.19.0",
-		"@prisma/adapter-planetscale":   "5.22.0",
-		"@prisma/client":                "5.22.0",
-		"@types/jest":                   "29.5.14",
-		"@types/lodash":                 "4.17.13",
-		"@types/node":                   "20.14.12",
-		"babel-jest":                    "29.7.0",
-		"jest":                          "29.7.0",
-		"node-fetch":                    "3.3.2",
-		"stream-chain":                  "3.3.2",
-		"stream-json":                   "1.9.1",
-		"timezone-mock":                 "1.3.6",
-		"ts-node":                       "10.9.2",
-		"tslib":                         "2.8.1",
-		"typescript":                    "5.7.2"
-	}
+		"@1password/sdk": "0.3.1",
+		"@aws-sdk/client-ec2": "3.828.0",
+		"@aws-sdk/client-ecs": "3.828.0",
+		"@aws-sdk/client-glue": "3.828.0",
+		"@aws-sdk/client-lambda": "3.828.0",
+		"@aws-sdk/client-s3": "3.828.0",
+		"@aws-sdk/client-ses": "3.828.0",
+		"@aws-sdk/client-sqs": "3.828.0",
+		"@aws-sdk/client-ssm": "3.828.0",
+		"@aws-sdk/lib-storage": "3.828.0",
+		"@aws-sdk/s3-request-presigner": "3.828.0",
+		"@babel/core": "7.27.4",
+		"@babel/preset-env": "7.27.2",
+		"@babel/preset-flow": "7.27.1",
+		"@babel/preset-typescript": "7.27.1",
+		"@google-cloud/bigquery": "8.1.0",
+		"@google-cloud/storage": "7.16.0",
+		"@googleapis/sheets": "10.0.1",
+		"@planetscale/database": "1.19.0",
+		"@prisma/adapter-planetscale": "6.9.0",
+		"@prisma/client": "6.9.0",
+		"@types/babel__core": "7",
+		"@types/crypto-js": "4.2.2",
+		"@types/fs-extra": "11.0.4",
+		"@types/jest": "29.5.14",
+		"@types/lodash": "4.17.17",
+		"@types/luxon": "3.6.2",
+		"@types/node": "22.15.31",
+		"@types/react": "19",
+		"athena-express": "7.1.5",
+		"aws-sdk": "2.1692.0",
+		"babel-jest": "30.0.0",
+		"crypto-js": "4.2.0",
+		"dotenv": "16.5.0",
+		"fs-extra": "11.3.0",
+		"google-ads-api": "20.0.1",
+		"jest": "30.0.0",
+		"node-fetch": "3.3.2",
+		"react": "19.1.0",
+		"stream-chain": "3.4.0",
+		"stream-json": "1.9.1",
+		"swr": "2.3.3",
+		"ts-node": "10.9.2",
+		"tslib": "2.8.1",
+		"typescript": "5.8.3"
+	},
+	"packageManager": "yarn@4.9.2"
 }

package/api/ApiResponse.d.ts

@@ -1,50 +0,0 @@
-import { Response } from "./response";
-import { State } from "./";
-type Constructor = {
-    body?: any;
-    error?: any;
-    state?: State;
-};
-/**
- * Class version of the API to enable quicker instances.
- */
-declare class ApiResponse {
-    state: State;
-    body: any;
-    error: any;
-    constructor({ body, error, state }?: Constructor);
-    fromJson({ input }: {
-        input: Response;
-    }): this;
-    getBody(): any;
-    getBodyDefaultTo({ defaultValue, keys }: {
-        defaultValue: any;
-        keys: any | any[];
-    }): any;
-    getError(): any;
-    getJson(): Response;
-    getState(): State;
-    isError(): boolean;
-    isIdle(): boolean;
-    isPending(): boolean;
-    isSuccess(): boolean;
-    setToIdle(): this;
-    setToPending(): this;
-    setToError({ body, error }: {
-        body?: any;
-        error: any;
-    }): this;
-    setToSuccess({ body }: {
-        body: any;
-    }): this;
-    setBody({ body }: {
-        body: any;
-    }): this;
-    setError({ error }: {
-        error: any;
-    }): this;
-    setState({ state }: {
-        state: State;
-    }): this;
-}
-export default ApiResponse;

package/api/ApiResponse.js

@@ -1,94 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const defaultTo_1 = __importDefault(require("../util/defaultTo"));
-const _1 = require("./");
-/**
- * Class version of the API to enable quicker instances.
- */
-class ApiResponse {
-    constructor({ body, error, state } = {}) {
-        this.state = _1.State.IDLE;
-        this.body = null;
-        this.error = null;
-        this.body = body || null;
-        this.error = error || null;
-        this.state = state || _1.State.IDLE;
-        return this;
-    }
-    fromJson({ input }) {
-        this.body = input.body;
-        this.error = input.error;
-        this.state = input.state;
-        return this;
-    }
-    getBody() {
-        return this.body;
-    }
-    getBodyDefaultTo({ defaultValue, keys }) {
-        return (0, defaultTo_1.default)({
-            defaultValue,
-            instance: this.body,
-            keys,
-        });
-    }
-    getError() {
-        return this.error;
-    }
-    getJson() {
-        return {
-            body: this.body,
-            error: this.error,
-            state: this.state,
-        };
-    }
-    getState() {
-        return this.state;
-    }
-    isError() {
-        return this.state === _1.State.ERROR;
-    }
-    isIdle() {
-        return this.state === _1.State.IDLE;
-    }
-    isPending() {
-        return this.state === _1.State.PENDING;
-    }
-    isSuccess() {
-        return this.state === _1.State.SUCCESS;
-    }
-    setToIdle() {
-        this.state = _1.State.IDLE;
-        return this;
-    }
-    setToPending() {
-        this.state = _1.State.PENDING;
-        return this;
-    }
-    setToError({ body, error }) {
-        this.body = body || null;
-        this.error = error;
-        this.state = _1.State.ERROR;
-        return this;
-    }
-    setToSuccess({ body }) {
-        this.body = body;
-        this.state = _1.State.SUCCESS;
-        return this;
-    }
-    setBody({ body }) {
-        this.body = body;
-        return this;
-    }
-    setError({ error }) {
-        this.error = error;
-        return this;
-    }
-    setState({ state }) {
-        this.state = state;
-        return this;
-    }
-}
-exports.default = ApiResponse;

package/api/index.d.ts

@@ -1,9 +0,0 @@
-export declare enum State {
-    CANCELLED = "CANCELLED",
-    ERROR = "ERROR",
-    IDLE = "IDLE",
-    PENDING = "PENDING",
-    SUCCESS = "SUCCESS",
-    VALIDATION_ERROR = "VALIDATION_ERROR"
-}
-export declare const unexpectedError: string;

package/api/index.js

@@ -1,13 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.unexpectedError = exports.State = void 0;
-var State;
-(function (State) {
-    State["CANCELLED"] = "CANCELLED";
-    State["ERROR"] = "ERROR";
-    State["IDLE"] = "IDLE";
-    State["PENDING"] = "PENDING";
-    State["SUCCESS"] = "SUCCESS";
-    State["VALIDATION_ERROR"] = "VALIDATION_ERROR";
-})(State || (exports.State = State = {}));
-exports.unexpectedError = "An unexpected error occurred, please try again.";

package/api/isError.d.ts

@@ -1,6 +0,0 @@
-import { Response } from "./response";
-type IsError = {
-    response: Response;
-};
-declare const isError: (props: IsError) => boolean;
-export default isError;

package/api/isError.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const _1 = require("./");
-const isError = (props) => {
-    return _1.State.ERROR === props.response.state;
-};
-exports.default = isError;

package/api/isSuccess.d.ts

@@ -1,6 +0,0 @@
-import { Response } from './response';
-type IsSuccess = {
-    response: Response;
-};
-declare const isSuccess: (props: IsSuccess) => boolean;
-export default isSuccess;

package/api/isSuccess.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const _1 = require("./");
-const isSuccess = (props) => {
-    return _1.State.SUCCESS === props.response.state;
-};
-exports.default = isSuccess;

package/api/response.d.ts

@@ -1,8 +0,0 @@
-import { State } from "./";
-export type Response = {
-    body: any | null;
-    error: string | null;
-    state: State;
-};
-declare const response: Response;
-export default response;

package/api/response.js

@@ -1,9 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-const _1 = require("./");
-const response = {
-    body: null,
-    error: null,
-    state: _1.State.IDLE,
-};
-exports.default = response;

package/array/contains.d.ts

@@ -1,9 +0,0 @@
-type Contains = {
-    haystack: any;
-    needle: any;
-};
-/**
- * Shorthand to check if an array or string contains a needle.
- */
-declare const contains: (props: Contains) => boolean;
-export default contains;

package/array/contains.js

@@ -1,7 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Shorthand to check if an array or string contains a needle.
- */
-const contains = (props) => -1 !== props.haystack.indexOf(props.needle);
-exports.default = contains;

package/array/getArray.d.ts

@@ -1,8 +0,0 @@
-type GetArray = {
-    input: any;
-};
-/**
- * Convert an array into an array or return if already an array.
- */
-declare const getArray: (props: GetArray) => any[];
-export default getArray;

package/array/getArray.js

@@ -1,11 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const isArray_1 = __importDefault(require("lodash/isArray"));
-/**
- * Convert an array into an array or return if already an array.
- */
-const getArray = (props) => (0, isArray_1.default)(props.input) ? props.input : [props.input];
-exports.default = getArray;

package/atInternet/request.d.ts

@@ -1,30 +0,0 @@
-/**
- * The request in the structure required by AT Internet.
- */
-export type Request = {
-    columns: string[];
-    evo?: {
-        [evoKey: string]: object;
-    };
-    filter?: {
-        [filterKey: string]: object;
-    };
-    "max-results": number;
-    options: {
-        "ignore_null_properties": boolean;
-    };
-    "page-num": number;
-    period: {
-        [periodKey: string]: [
-            {
-                type: string;
-                start: string;
-                end: string;
-            }
-        ];
-    };
-    sort: string[];
-    space: {
-        s: number[];
-    };
-};

package/atInternet/request.js

@@ -1,2 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });

package/aws/athenaExpress/initClient.d.ts

@@ -1,12 +0,0 @@
-import { Config } from '../getConfig';
-type InitClient = {
-    config: Config;
-    database: string;
-    s3Bucket: string;
-    s3Key: string;
-};
-/**
- * Initialise the database using manually provided credentials.
- */
-declare const initClient: (props: InitClient) => void;
-export default initClient;

package/aws/athenaExpress/initClient.js

@@ -1,31 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-const getConfig_1 = __importDefault(require("../getConfig"));
-global.awsAthenaExpressClient = null;
-/**
- * Initialise the database using manually provided credentials.
- */
-const initClient = (props) => {
-    if (!global.awsAthenaExpressClient) {
-        const athenaExpress = require('athena-express');
-        const awsSdk = require('aws-sdk');
-        const formattedConfig = (0, getConfig_1.default)({
-            config: props.config,
-            isAthenaExpress: true
-        });
-        // Set the aws authentication
-        awsSdk.config.update(formattedConfig);
-        global.awsAthenaExpressClient = new athenaExpress.AthenaExpress({
-            aws: awsSdk,
-            s3: `s3://${props.s3Bucket}/${props.s3Key}`,
-            db: props.database,
-            formatJson: true,
-            retry: 200,
-            getStats: false,
-        });
-    }
-};
-exports.default = initClient;

package/aws/athenaExpress/query.d.ts

@@ -1,8 +0,0 @@
-type Query = {
-    query: string;
-};
-/**
- * Build the query and return the data.
- */
-declare const query: (props: Query) => Promise<any>;
-export default query;

package/aws/athenaExpress/query.js

@@ -1,16 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-/**
- * Build the query and return the data.
- */
-const query = async (props) => {
-    return await global.awsAthenaExpressClient.query(props.query)
-        .then(data => {
-        let subResponse = [];
-        if (undefined !== data['Items']) {
-            subResponse = data['Items'];
-        }
-        return subResponse;
-    });
-};
-exports.default = query;

package/aws/ec2/initClient.d.ts

@@ -1,11 +0,0 @@
-import { Config } from "../getConfig";
-type InitClient = {
-    config: Config;
-};
-/**
- * Shorthand function to get the EC2 Client.
- * Library: @aws-sdk/client-ec2
- * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ec2/
- */
-export declare const initClient: (props: InitClient) => void;
-export {};

package/aws/ec2/initClient.js

@@ -1,23 +0,0 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.initClient = void 0;
-const getConfig_1 = __importDefault(require("../getConfig"));
-global.awsEc2Client = null;
-/**
- * Shorthand function to get the EC2 Client.
- * Library: @aws-sdk/client-ec2
- * https://docs.aws.amazon.com/AWSJavaScriptSDK/v3/latest/client/ec2/
- */
-const initClient = (props) => {
-    if (!global.awsEc2Client) {
-        const { EC2Client } = require("@aws-sdk/client-ec2");
-        const formattedConfig = (0, getConfig_1.default)({
-            config: props.config
-        });
-        global.awsEc2Client = new EC2Client(formattedConfig);
-    }
-};
-exports.initClient = initClient;