@8ms/helpers 2.2.9 → 2.2.12

package/package.json

@@ -1,197 +1,299 @@
 {
-	"name":                 "@8ms/helpers",
-	"license":              "UNLICENSED",
-	"version":              "2.2.9",
-	"repository":           {
+	"name": "@8ms/helpers",
+	"license": "UNLICENSED",
+	"version": "2.2.12",
+	"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"
 	},
-	"packageManager":       "pnpm@9.15.0",
-	"engines":              {
+	"packageManager": "pnpm@9.15.0",
+	"engines": {
 		"node": "24"
 	},
-	"dependencies":         {
-		"axios":  "^1.13.5",
+	"dependencies": {
+		"axios": "^1.13.5",
 		"lodash": "^4.17.23",
-		"luxon":  "^3.7.2",
-		"zod":    "^4.3.6"
+		"luxon": "^3.7.2",
+		"zod": "^4.3.6"
 	},
-	"peerDependencies":     {
-		"@1password/sdk":                "<1.0.0",
-		"@aws-sdk/client-ec2":           "^3.0.0",
-		"@aws-sdk/client-ecs":           "^3.0.0",
-		"@aws-sdk/client-glue":          "^3.0.0",
-		"@aws-sdk/client-lambda":        "^3.0.0",
-		"@aws-sdk/client-s3":            "^3.0.0",
-		"@aws-sdk/client-ses":           "^3.0.0",
-		"@aws-sdk/client-sqs":           "^3.0.0",
-		"@aws-sdk/client-ssm":           "^3.0.0",
-		"@aws-sdk/lib-storage":          "^3.0.0",
+	"peerDependencies": {
+		"@1password/sdk": "<1.0.0",
+		"@aws-sdk/client-ec2": "^3.0.0",
+		"@aws-sdk/client-ecs": "^3.0.0",
+		"@aws-sdk/client-glue": "^3.0.0",
+		"@aws-sdk/client-lambda": "^3.0.0",
+		"@aws-sdk/client-s3": "^3.0.0",
+		"@aws-sdk/client-ses": "^3.0.0",
+		"@aws-sdk/client-sqs": "^3.0.0",
+		"@aws-sdk/client-ssm": "^3.0.0",
+		"@aws-sdk/lib-storage": "^3.0.0",
 		"@aws-sdk/s3-request-presigner": "^3.0.0",
-		"@google-cloud/bigquery":        "^8.0.0",
-		"@google-cloud/common":          "^6.0.0",
-		"@google-cloud/storage":         "^7.0.0",
-		"@googleapis/sheets":            "^13.0.0",
-		"@planetscale/database":         "^1.0.0",
-		"@prisma/adapter-mariadb":       "^7.0.0",
-		"@prisma/adapter-pg":            "^7.0.0",
-		"@prisma/adapter-planetscale":   "^7.0.0",
-		"@prisma/client":                "^7.0.0",
-		"crypto-js":                     "^4.0.0",
-		"fs-extra":                      "^11.0.0",
-		"google-ads-api":                "^23.0.0",
-		"googleapis-common":             "^8.0.0",
-		"next":                          "^16.0.0",
-		"react":                         "^19.0.0",
-		"react-intersection-observer":   "^10.0.0",
-		"stream-chain":                  "^3.0.0",
-		"stream-json":                   "^1.0.0",
-		"swr":                           "^2.0.0"
+		"@google-cloud/bigquery": "^8.0.0",
+		"@google-cloud/common": "^6.0.0",
+		"@google-cloud/storage": "^7.0.0",
+		"@googleapis/sheets": "^13.0.0",
+		"@planetscale/database": "^1.0.0",
+		"@prisma/adapter-mariadb": "^7.0.0",
+		"@prisma/adapter-pg": "^7.0.0",
+		"@prisma/adapter-planetscale": "^7.0.0",
+		"@prisma/client": "^7.0.0",
+		"crypto-js": "^4.0.0",
+		"fs-extra": "^11.0.0",
+		"google-ads-api": "^23.0.0",
+		"googleapis-common": "^8.0.0",
+		"next": "^16.0.0",
+		"react": "^19.0.0",
+		"react-intersection-observer": "^10.0.0",
+		"stream-chain": "^3.0.0",
+		"stream-json": "^1.0.0",
+		"swr": "^2.0.0"
 	},
 	"peerDependenciesMeta": {
-		"@1password/sdk":                {
+		"@1password/sdk": {
 			"optional": true
 		},
-		"@aws-sdk/client-ec2":           {
+		"@aws-sdk/client-ec2": {
 			"optional": true
 		},
-		"@aws-sdk/client-ecs":           {
+		"@aws-sdk/client-ecs": {
 			"optional": true
 		},
-		"@aws-sdk/client-glue":          {
+		"@aws-sdk/client-glue": {
 			"optional": true
 		},
-		"@aws-sdk/client-lambda":        {
+		"@aws-sdk/client-lambda": {
 			"optional": true
 		},
-		"@aws-sdk/client-s3":            {
+		"@aws-sdk/client-s3": {
 			"optional": true
 		},
-		"@aws-sdk/client-ses":           {
+		"@aws-sdk/client-ses": {
 			"optional": true
 		},
-		"@aws-sdk/client-sqs":           {
+		"@aws-sdk/client-sqs": {
 			"optional": true
 		},
-		"@aws-sdk/client-ssm":           {
+		"@aws-sdk/client-ssm": {
 			"optional": true
 		},
-		"@aws-sdk/lib-storage":          {
+		"@aws-sdk/lib-storage": {
 			"optional": true
 		},
 		"@aws-sdk/s3-request-presigner": {
 			"optional": true
 		},
-		"@google-cloud/bigquery":        {
+		"@google-cloud/bigquery": {
 			"optional": true
 		},
-		"@google-cloud/common":          {
+		"@google-cloud/common": {
 			"optional": true
 		},
-		"@google-cloud/storage":         {
+		"@google-cloud/storage": {
 			"optional": true
 		},
-		"@googleapis/sheets":            {
+		"@googleapis/sheets": {
 			"optional": true
 		},
-		"@planetscale/database":         {
+		"@planetscale/database": {
 			"optional": true
 		},
-		"@prisma/adapter-mariadb":       {
+		"@prisma/adapter-mariadb": {
 			"optional": true
 		},
-		"@prisma/adapter-pg":            {
+		"@prisma/adapter-pg": {
 			"optional": true
 		},
-		"@prisma/adapter-planetscale":   {
+		"@prisma/adapter-planetscale": {
 			"optional": true
 		},
-		"@prisma/client":                {
+		"@prisma/client": {
 			"optional": true
 		},
-		"crypto-js":                     {
+		"crypto-js": {
 			"optional": true
 		},
-		"fs-extra":                      {
+		"fs-extra": {
 			"optional": true
 		},
-		"google-ads-api":                {
+		"google-ads-api": {
 			"optional": true
 		},
-		"googleapis-common":             {
+		"googleapis-common": {
 			"optional": true
 		},
-		"next":                          {
+		"next": {
 			"optional": true
 		},
-		"react":                         {
+		"react": {
 			"optional": true
 		},
-		"stream-chain":                  {
+		"stream-chain": {
 			"optional": true
 		},
-		"stream-json":                   {
+		"stream-json": {
 			"optional": true
 		},
-		"swr":                           {
+		"swr": {
 			"optional": true
 		}
 	},
-	"devDependencies":      {
-		"@1password/sdk":                "^0.4.0",
-		"@aws-sdk/client-ec2":           "^3.992.0",
-		"@aws-sdk/client-ecs":           "^3.992.0",
-		"@aws-sdk/client-glue":          "^3.992.0",
-		"@aws-sdk/client-lambda":        "^3.992.0",
-		"@aws-sdk/client-s3":            "^3.992.0",
-		"@aws-sdk/client-ses":           "^3.992.0",
-		"@aws-sdk/client-sqs":           "^3.992.0",
-		"@aws-sdk/client-ssm":           "^3.992.0",
-		"@aws-sdk/lib-storage":          "^3.992.0",
+	"devDependencies": {
+		"@1password/sdk": "^0.4.0",
+		"@aws-sdk/client-ec2": "^3.992.0",
+		"@aws-sdk/client-ecs": "^3.992.0",
+		"@aws-sdk/client-glue": "^3.992.0",
+		"@aws-sdk/client-lambda": "^3.992.0",
+		"@aws-sdk/client-s3": "^3.992.0",
+		"@aws-sdk/client-ses": "^3.992.0",
+		"@aws-sdk/client-sqs": "^3.992.0",
+		"@aws-sdk/client-ssm": "^3.992.0",
+		"@aws-sdk/lib-storage": "^3.992.0",
 		"@aws-sdk/s3-request-presigner": "^3.992.0",
-		"@babel/core":                   "7.29.0",
-		"@babel/preset-env":             "7.29.0",
-		"@babel/preset-flow":            "7.27.1",
-		"@babel/preset-typescript":      "7.28.5",
-		"@google-cloud/bigquery":        "^8.1.1",
-		"@google-cloud/common":          "^6.0.0",
-		"@google-cloud/storage":         "^7.19.0",
-		"@googleapis/sheets":            "^13.0.1",
-		"@planetscale/database":         "^1.19.0",
-		"@prisma/adapter-mariadb":       "^7.4.0",
-		"@prisma/adapter-pg":            "^7.4.0",
-		"@prisma/adapter-planetscale":   "^7.4.0",
-		"@prisma/client":                "^7.4.0",
-		"@types/babel__core":            "^7.20.5",
-		"@types/crypto-js":              "^4.2.2",
-		"@types/fs-extra":               "11.0.4",
-		"@types/jest":                   "30.0.0",
-		"@types/lodash":                 "^4.17.23",
-		"@types/luxon":                  "3.7.1",
-		"@types/node":                   "^24.10.13",
-		"@types/react":                  "^19.2.14",
-		"babel-jest":                    "30.2.0",
-		"crypto-js":                     "^4.2.0",
-		"dotenv":                        "^17.3.1",
-		"fs-extra":                      "11.3.3",
-		"google-ads-api":                "^23.0.0",
-		"googleapis-common":             "^8.0.0",
-		"jest":                          "30.2.0",
-		"next":                          "^16.1.6",
-		"node-fetch":                    "3.3.2",
-		"react":                         "^19.2.4",
-		"react-intersection-observer":   "^10.0.2",
-		"stream-chain":                  "^3.4.0",
-		"stream-json":                   "^1.9.1",
-		"swr":                           "^2.4.0",
-		"ts-node":                       "10.9.2",
-		"tslib":                         "2.8.1",
-		"typescript":                    "^5.9.3"
+		"@babel/core": "7.29.0",
+		"@babel/preset-env": "7.29.0",
+		"@babel/preset-flow": "7.27.1",
+		"@babel/preset-typescript": "7.28.5",
+		"@google-cloud/bigquery": "^8.1.1",
+		"@google-cloud/common": "^6.0.0",
+		"@google-cloud/storage": "^7.19.0",
+		"@googleapis/sheets": "^13.0.1",
+		"@planetscale/database": "^1.19.0",
+		"@prisma/adapter-mariadb": "^7.4.0",
+		"@prisma/adapter-pg": "^7.4.0",
+		"@prisma/adapter-planetscale": "^7.4.0",
+		"@prisma/client": "^7.4.0",
+		"@types/babel__core": "^7.20.5",
+		"@types/crypto-js": "^4.2.2",
+		"@types/fs-extra": "11.0.4",
+		"@types/jest": "30.0.0",
+		"@types/lodash": "^4.17.23",
+		"@types/luxon": "3.7.1",
+		"@types/node": "^24.10.13",
+		"@types/react": "^19.2.14",
+		"babel-jest": "30.2.0",
+		"crypto-js": "^4.2.0",
+		"dotenv": "^17.3.1",
+		"fs-extra": "11.3.3",
+		"google-ads-api": "^23.0.0",
+		"googleapis-common": "^8.0.0",
+		"jest": "30.2.0",
+		"next": "^16.1.6",
+		"node-fetch": "3.3.2",
+		"react": "^19.2.4",
+		"react-intersection-observer": "^10.0.2",
+		"stream-chain": "^3.4.0",
+		"stream-json": "^1.9.1",
+		"swr": "^2.4.0",
+		"ts-node": "10.9.2",
+		"tslib": "2.8.1",
+		"typescript": "^5.9.3"
+	},
+	"exports": {
+		".": {
+			"types": "./index.d.ts",
+			"default": "./index.js"
+		},
+		"./_class": {
+			"types": "./_class/index.d.ts",
+			"default": "./_class/index.js"
+		},
+		"./adverity": {
+			"types": "./adverity/index.d.ts",
+			"default": "./adverity/index.js"
+		},
+		"./api": {
+			"types": "./api/index.d.ts",
+			"default": "./api/index.js"
+		},
+		"./array": {
+			"types": "./array/index.d.ts",
+			"default": "./array/index.js"
+		},
+		"./atInternet": {
+			"types": "./atInternet/index.d.ts",
+			"default": "./atInternet/index.js"
+		},
+		"./axios": {
+			"types": "./axios/index.d.ts",
+			"default": "./axios/index.js"
+		},
+		"./boolean": {
+			"types": "./boolean/index.d.ts",
+			"default": "./boolean/index.js"
+		},
+		"./crud": {
+			"types": "./crud/index.d.ts",
+			"default": "./crud/index.js"
+		},
+		"./crypto": {
+			"types": "./crypto/index.d.ts",
+			"default": "./crypto/index.js"
+		},
+		"./date": {
+			"types": "./date/index.d.ts",
+			"default": "./date/index.js"
+		},
+		"./environment": {
+			"types": "./environment/index.d.ts",
+			"default": "./environment/index.js"
+		},
+		"./file": {
+			"types": "./file/index.d.ts",
+			"default": "./file/index.js"
+		},
+		"./geo": {
+			"types": "./geo/index.d.ts",
+			"default": "./geo/index.js"
+		},
+		"./json": {
+			"types": "./json/index.d.ts",
+			"default": "./json/index.js"
+		},
+		"./nextAuth": {
+			"types": "./nextAuth/index.d.ts",
+			"default": "./nextAuth/index.js"
+		},
+		"./nextJs": {
+			"types": "./nextJs/index.d.ts",
+			"default": "./nextJs/index.js"
+		},
+		"./number": {
+			"types": "./number/index.d.ts",
+			"default": "./number/index.js"
+		},
+		"./object": {
+			"types": "./object/index.d.ts",
+			"default": "./object/index.js"
+		},
+		"./sorting": {
+			"types": "./sorting/index.d.ts",
+			"default": "./sorting/index.js"
+		},
+		"./string": {
+			"types": "./string/index.d.ts",
+			"default": "./string/index.js"
+		},
+		"./swr": {
+			"types": "./swr/index.d.ts",
+			"default": "./swr/index.js"
+		},
+		"./url": {
+			"types": "./url/index.d.ts",
+			"default": "./url/index.js"
+		},
+		"./util": {
+			"types": "./util/index.d.ts",
+			"default": "./util/index.js"
+		},
+		"./webWorker": {
+			"types": "./webWorker/index.d.ts",
+			"default": "./webWorker/index.js"
+		}
 	}
 }

package/prisma/PrismaNamespace.js

@@ -1,102 +1,62 @@
-"use strict";
-var __createBinding = (this && this.__createBinding) || (Object.create ? (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    var desc = Object.getOwnPropertyDescriptor(m, k);
-    if (!desc || ("get" in desc ? !m.__esModule : desc.writable || desc.configurable)) {
-      desc = { enumerable: true, get: function() { return m[k]; } };
-    }
-    Object.defineProperty(o, k2, desc);
-}) : (function(o, m, k, k2) {
-    if (k2 === undefined) k2 = k;
-    o[k2] = m[k];
-}));
-var __setModuleDefault = (this && this.__setModuleDefault) || (Object.create ? (function(o, v) {
-    Object.defineProperty(o, "default", { enumerable: true, value: v });
-}) : function(o, v) {
-    o["default"] = v;
-});
-var __importStar = (this && this.__importStar) || (function () {
-    var ownKeys = function(o) {
-        ownKeys = Object.getOwnPropertyNames || function (o) {
-            var ar = [];
-            for (var k in o) if (Object.prototype.hasOwnProperty.call(o, k)) ar[ar.length] = k;
-            return ar;
-        };
-        return ownKeys(o);
-    };
-    return function (mod) {
-        if (mod && mod.__esModule) return mod;
-        var result = {};
-        if (mod != null) for (var k = ownKeys(mod), i = 0; i < k.length; i++) if (k[i] !== "default") __createBinding(result, mod, k[i]);
-        __setModuleDefault(result, mod);
-        return result;
-    };
-})();
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.PrismaNamespace = void 0;
-const _class_1 = require("../_class");
-const getError_1 = require("../util/getError");
-class PrismaNamespace extends _class_1.BaseNamespace {
-    constructor() {
-        super(...arguments);
-        // Async setup to only initialise where required
-        this.ensureInit = async () => {
-            if (!this.client) {
-                let adapter = null;
-                if (this.config.isPlanetScale) {
-                    try {
-                        const { PrismaPlanetScale } = await Promise.resolve().then(() => __importStar(require("@prisma/adapter-planetscale")));
-                        adapter = new PrismaPlanetScale({
-                            url: this.config.url,
-                        });
-                    }
-                    catch (e) {
-                        throw new Error(`PlanetScale adapter not installed - ${(0, getError_1.getError)(e)}`);
-                    }
+import { BaseNamespace } from "../_class";
+import { getError } from "../util/getError";
+export class PrismaNamespace extends BaseNamespace {
+    // Async setup to only initialise where required
+    ensureInit = async () => {
+        if (!this.client) {
+            let adapter = null;
+            if (this.config.isPlanetScale) {
+                try {
+                    const { PrismaPlanetScale } = await import("@prisma/adapter-planetscale");
+                    adapter = new PrismaPlanetScale({
+                        url: this.config.url,
+                    });
+                }
+                catch (e) {
+                    throw new Error(`PlanetScale adapter not installed - ${getError(e)}`);
                 }
-                if (this.config.isMysql) {
-                    try {
-                        const { PrismaMariaDb } = await Promise.resolve().then(() => __importStar(require("@prisma/adapter-mariadb")));
-                        adapter = new PrismaMariaDb(this.config.url);
-                    }
-                    catch (e) {
-                        throw new Error(`MariaDB adapter not installed - ${(0, getError_1.getError)(e)}`);
-                    }
+            }
+            if (this.config.isMysql) {
+                try {
+                    const { PrismaMariaDb } = await import("@prisma/adapter-mariadb");
+                    adapter = new PrismaMariaDb(this.config.url);
                 }
-                else {
-                    // Prisma v7 requires a driver adapter — use the one matching your database
-                    // e.g. @prisma/adapter-pg for Postgres, @prisma/adapter-mysql2 for MySQL
-                    try {
-                        const { PrismaPg } = await Promise.resolve().then(() => __importStar(require("@prisma/adapter-pg")));
-                        adapter = new PrismaPg({
-                            connectionString: process.env.DATABASE_URL,
-                        });
-                    }
-                    catch (e) {
-                        throw new Error(`Postgres adapter not installed - ${(0, getError_1.getError)(e)}`);
-                    }
+                catch (e) {
+                    throw new Error(`MariaDB adapter not installed - ${getError(e)}`);
                 }
+            }
+            else {
+                // Prisma v7 requires a driver adapter — use the one matching your database
+                // e.g. @prisma/adapter-pg for Postgres, @prisma/adapter-mysql2 for MySQL
                 try {
-                    // In Prisma v7, the client is generated to a custom output path
-                    // @ts-ignore
-                    const { PrismaClient } = await Promise.resolve().then(() => __importStar(require("../../generated/prisma/client")));
-                    // Show the full query if debugging
-                    if (this.config.isDebug) {
-                        this.client = new PrismaClient({
-                            adapter,
-                            log: [{ emit: "event", level: "query" }],
-                        });
-                    }
-                    // Standard prisma
-                    else {
-                        this.client = new PrismaClient({ adapter });
-                    }
+                    const { PrismaPg } = await import("@prisma/adapter-pg");
+                    adapter = new PrismaPg({
+                        connectionString: process.env.DATABASE_URL,
+                    });
                 }
                 catch (e) {
-                    throw new Error(`Prisma Client not installed - ${(0, getError_1.getError)(e)}`);
+                    throw new Error(`Postgres adapter not installed - ${getError(e)}`);
+                }
+            }
+            try {
+                // In Prisma v7, the client is generated to a custom output path
+                // @ts-ignore
+                const { PrismaClient } = await import("../../generated/prisma/client");
+                // Show the full query if debugging
+                if (this.config.isDebug) {
+                    this.client = new PrismaClient({
+                        adapter,
+                        log: [{ emit: "event", level: "query" }],
+                    });
+                }
+                // Standard prisma
+                else {
+                    this.client = new PrismaClient({ adapter });
                 }
             }
-        };
-    }
+            catch (e) {
+                throw new Error(`Prisma Client not installed - ${getError(e)}`);
+            }
+        }
+    };
 }
-exports.PrismaNamespace = PrismaNamespace;

package/prisma/getDecimal.js

@@ -1,23 +1,16 @@
-"use strict";
-var __importDefault = (this && this.__importDefault) || function (mod) {
-    return (mod && mod.__esModule) ? mod : { "default": mod };
-};
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDecimal = void 0;
-const getDecimal_1 = require("../number/getDecimal");
-const isArray_1 = __importDefault(require("lodash/isArray"));
+import { getDecimal as getNumberDecimal } from "../number/getDecimal";
+import isArray from "lodash/isArray";
 /**
  * Fetch the number from a prisma decimal (comes through as an object).
  */
-const getDecimal = (input, dp = 2) => {
+export const getDecimal = (input, dp = 2) => {
     let numberString = "";
     // Prisma value
-    if ((0, isArray_1.default)(input?.d)) {
+    if (isArray(input?.d)) {
         numberString = input.absoluteValue();
     }
     else {
         numberString = input.toString();
     }
-    return (0, getDecimal_1.getDecimal)(numberString, dp);
+    return getNumberDecimal(numberString, dp);
 };
-exports.getDecimal = getDecimal;

package/prisma/server.js

@@ -1,10 +1,7 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.getDecimal = exports.prismaClient = void 0;
-const PrismaNamespace_1 = require("./PrismaNamespace");
+import { PrismaNamespace } from "./PrismaNamespace";
 const prismaNamespaces = new Map();
 // Main client that is used by system
-const prismaClient = async (key = "default", config) => {
+export const prismaClient = async (key = "default", config) => {
     if (prismaNamespaces.has(key)) {
         return prismaNamespaces.get(key);
     }
@@ -22,11 +19,9 @@ const prismaClient = async (key = "default", config) => {
             throw new Error(`Config required for namespace '${key}'`);
         }
     }
-    const namespace = new PrismaNamespace_1.PrismaNamespace(key, config);
+    const namespace = new PrismaNamespace(key, config);
     await namespace.ensureInit();
     prismaNamespaces.set(key, namespace);
     return namespace;
 };
-exports.prismaClient = prismaClient;
-var getDecimal_1 = require("./getDecimal");
-Object.defineProperty(exports, "getDecimal", { enumerable: true, get: function () { return getDecimal_1.getDecimal; } });
+export { getDecimal } from "./getDecimal";