@archtx/utils 2.0.3 → 2.0.5

package/dist/exports.d.ts

@@ -8,21 +8,22 @@ export * from './deep-freeze.js';
 export * from './deep-merge.js';
 export * from './ensure-array.js';
 export * from './format-decimal.js';
-export * from './is-email.js';
 export * from './is-hex-color.js';
 export * from './is-prod.js';
-export * from './is-url.js';
-export * from './make-uuid.js';
-export * from './obfuscate-string.js';
 export * from './object.js';
 export * from './object-diff-paths.js';
 export * from './object-values-to-dot-notation.js';
-export * from './pluralize.js';
 export * from './random-color.js';
 export * from './sanitize-obj-props.js';
 export * from './sleep.js';
 export * from './timeout.js';
 export * from './undefined-default.js';
+export * from './strings/is-email.js';
+export * from './strings/is-url.js';
+export * from './strings/make-uuid.js';
+export * from './strings/obfuscate-string.js';
+export * from './strings/pluralize.js';
+export * from './strings/reproducible-hash.js';
 export * from './constants/millisecond-time.js';
 export * from './constants/second-time.js';
 export * from './datetime/iso-string.js';

package/dist/exports.js

@@ -8,21 +8,23 @@ export * from './deep-freeze.js';
 export * from './deep-merge.js';
 export * from './ensure-array.js';
 export * from './format-decimal.js';
-export * from './is-email.js';
 export * from './is-hex-color.js';
 export * from './is-prod.js';
-export * from './is-url.js';
-export * from './make-uuid.js';
-export * from './obfuscate-string.js';
 export * from './object.js';
 export * from './object-diff-paths.js';
 export * from './object-values-to-dot-notation.js';
-export * from './pluralize.js';
 export * from './random-color.js';
 export * from './sanitize-obj-props.js';
 export * from './sleep.js';
 export * from './timeout.js';
 export * from './undefined-default.js';
+// strings
+export * from './strings/is-email.js';
+export * from './strings/is-url.js';
+export * from './strings/make-uuid.js';
+export * from './strings/obfuscate-string.js';
+export * from './strings/pluralize.js';
+export * from './strings/reproducible-hash.js';
 // utils
 export * from './constants/millisecond-time.js';
 export * from './constants/second-time.js';

package/dist/exports.js.map

@@ -1 +1 @@
-{"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,eAAe,CAAA;AAC7B,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,gBAAgB,CAAA;AAC9B,cAAc,uBAAuB,CAAA;AACrC,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,oCAAoC,CAAA;AAClD,cAAc,gBAAgB,CAAA;AAC9B,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AAEtC,QAAQ;AACR,cAAc,iCAAiC,CAAA;AAC/C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA"}
+{"version":3,"file":"exports.js","sourceRoot":"","sources":["../src/exports.ts"],"names":[],"mappings":"AAAA,cAAc,iCAAiC,CAAA;AAC/C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,gCAAgC,CAAA;AAC9C,cAAc,wBAAwB,CAAA;AACtC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,iBAAiB,CAAA;AAC/B,cAAc,kBAAkB,CAAA;AAChC,cAAc,iBAAiB,CAAA;AAC/B,cAAc,mBAAmB,CAAA;AACjC,cAAc,qBAAqB,CAAA;AACnC,cAAc,mBAAmB,CAAA;AACjC,cAAc,cAAc,CAAA;AAC5B,cAAc,aAAa,CAAA;AAC3B,cAAc,wBAAwB,CAAA;AACtC,cAAc,oCAAoC,CAAA;AAClD,cAAc,mBAAmB,CAAA;AACjC,cAAc,yBAAyB,CAAA;AACvC,cAAc,YAAY,CAAA;AAC1B,cAAc,cAAc,CAAA;AAC5B,cAAc,wBAAwB,CAAA;AAEtC,UAAU;AACV,cAAc,uBAAuB,CAAA;AACrC,cAAc,qBAAqB,CAAA;AACnC,cAAc,wBAAwB,CAAA;AACtC,cAAc,+BAA+B,CAAA;AAC7C,cAAc,wBAAwB,CAAA;AACtC,cAAc,gCAAgC,CAAA;AAE9C,QAAQ;AACR,cAAc,iCAAiC,CAAA;AAC/C,cAAc,4BAA4B,CAAA;AAC1C,cAAc,0BAA0B,CAAA"}

package/dist/make-uuid.test.js

@@ -1,5 +1,5 @@
 import { describe, test, expect } from 'vitest';
-import { makeUuid } from './make-uuid.js';
+import { makeUuid } from './strings/make-uuid.js';
 describe('makeUuid()', () => {
     test('it works', () => {
         const uuid = makeUuid();

package/dist/make-uuid.test.js.map

@@ -1 +1 @@
-{"version":3,"file":"make-uuid.test.js","sourceRoot":"","sources":["../src/make-uuid.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,gBAAgB,CAAA;AAEzC,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;QACpB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;QAEvB,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAAA;QAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAC5C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;QAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAEtD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}
+{"version":3,"file":"make-uuid.test.js","sourceRoot":"","sources":["../src/make-uuid.test.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAC,IAAI,EAAC,MAAM,EAAE,MAAM,QAAQ,CAAA;AAC7C,OAAO,EAAE,QAAQ,EAAE,MAAM,wBAAwB,CAAA;AAEjD,QAAQ,CAAC,YAAY,EAAE,GAAG,EAAE;IAC1B,IAAI,CAAC,UAAU,EAAE,GAAG,EAAE;QACpB,MAAM,IAAI,GAAG,QAAQ,EAAE,CAAA;QAEvB,MAAM,CAAC,OAAO,IAAI,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;QAClC,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,qBAAqB,EAAE,GAAG,EAAE;QAC/B,MAAM,IAAI,GAAG,QAAQ,CAAC,OAAO,CAAC,CAAA;QAC9B,MAAM,KAAK,GAAG,QAAQ,CAAC,QAAQ,CAAC,CAAA;QAChC,MAAM,KAAK,GAAG,QAAQ,CAAC,uBAAuB,CAAC,CAAA;QAE/C,MAAM,CAAC,IAAI,CAAC,CAAC,SAAS,CAAC,OAAO,CAAC,CAAA;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,MAAM,CAAC,CAAA;QAC/B,MAAM,CAAC,KAAK,CAAC,CAAC,SAAS,CAAC,mBAAmB,CAAC,CAAA;QAC5C,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,CAAC,eAAe,CAAC,EAAE,CAAC,CAAA;IACzC,CAAC,CAAC,CAAA;IAEF,IAAI,CAAC,iEAAiE,EAAE,GAAG,EAAE;QAC3E,MAAM,IAAI,GAAG,QAAQ,CAAC,QAAQ,EAAE,EAAE,OAAO,EAAE,QAAQ,EAAE,CAAC,CAAA;QAEtD,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,QAAQ,CAAC,CAAA;IACrD,CAAC,CAAC,CAAA;AACJ,CAAC,CAAC,CAAA"}

package/dist/strings/is-email.d.ts

@@ -0,0 +1 @@
+export declare function isEmail(email: string): boolean;

package/dist/strings/is-email.js

@@ -0,0 +1,5 @@
+export function isEmail(email) {
+    const re = /^(([^<>()[\]\\.,;:\s@"]+(\.[^<>()[\]\\.,;:\s@"]+)*)|(".+"))@((\[[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\.[0-9]{1,3}\])|(([a-zA-Z\-0-9]+\.)+[a-zA-Z]{2,}))$/;
+    return re.test(String(email).trim().toLowerCase());
+}
+//# sourceMappingURL=is-email.js.map

package/dist/strings/is-email.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-email.js","sourceRoot":"","sources":["../../src/strings/is-email.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,OAAO,CAAC,KAAa;IACnC,MAAM,EAAE,GACN,uJAAuJ,CAAA;IACzJ,OAAO,EAAE,CAAC,IAAI,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,IAAI,EAAE,CAAC,WAAW,EAAE,CAAC,CAAA;AACpD,CAAC"}

package/dist/strings/is-url.d.ts

@@ -0,0 +1 @@
+export declare function isUrl(str: string): boolean;

package/dist/strings/is-url.js

@@ -0,0 +1,10 @@
+export function isUrl(str) {
+    const pattern = new RegExp('^(https?:\\/\\/)?' + // protocol
+        '((([a-z\\d]([a-z\\d-]*[a-z\\d])*)\\.)+[a-z]{2,}|' + // modules name
+        '((\\d{1,3}\\.){3}\\d{1,3}))' + // OR ip (v4) address
+        '(\\:\\d+)?(\\/[-a-z\\d%_.~+]*)*' + // port and path
+        '(\\?[;&a-z\\d%_.~+=-]*)?' + // query string
+        '(\\#[-a-z\\d_]*)?$', 'i');
+    return !!pattern.test(str);
+}
+//# sourceMappingURL=is-url.js.map

package/dist/strings/is-url.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-url.js","sourceRoot":"","sources":["../../src/strings/is-url.ts"],"names":[],"mappings":"AAAA,MAAM,UAAU,KAAK,CAAC,GAAW;IAC/B,MAAM,OAAO,GAAG,IAAI,MAAM,CACxB,mBAAmB,GAAG,WAAW;QAC/B,kDAAkD,GAAG,eAAe;QACpE,6BAA6B,GAAG,qBAAqB;QACrD,iCAAiC,GAAG,gBAAgB;QACpD,0BAA0B,GAAG,eAAe;QAC5C,oBAAoB,EACtB,GAAG,CACJ,CAAA;IAED,OAAO,CAAC,CAAC,OAAO,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;AAC5B,CAAC"}

package/dist/strings/make-uuid.d.ts

@@ -0,0 +1,16 @@
+/**
+ * This func is used by Entities to create `id` fields, some Entities embed the OrganizationEntity's `id` in their
+ * own `id`, in these cases, the `organizationId` is passed as an arg. The position of the embedded organizationId
+ * should always be last.
+ *
+ * The default size we implement here is 14 char,
+ *
+ * Note: for size, check the collision probability calculator: https://zelark.github.io/nano-id-cc/
+ *
+ * @param prefix
+ * @param opts
+ */
+export declare const makeUuid: (prefix?: string | number, opts?: {
+    postfix?: string;
+    size?: number;
+}) => string;

package/dist/strings/make-uuid.js

@@ -0,0 +1,25 @@
+import { customAlphabet } from 'nanoid';
+const CUSTOM_ALPHABET = '0123456789ABCDEFGHIJKLMNOPQRSTUVWXYZ_abcdefghijklmnopqrstuvwxyz-';
+const generator = customAlphabet(CUSTOM_ALPHABET, 20);
+/**
+ * This func is used by Entities to create `id` fields, some Entities embed the OrganizationEntity's `id` in their
+ * own `id`, in these cases, the `organizationId` is passed as an arg. The position of the embedded organizationId
+ * should always be last.
+ *
+ * The default size we implement here is 14 char,
+ *
+ * Note: for size, check the collision probability calculator: https://zelark.github.io/nano-id-cc/
+ *
+ * @param prefix
+ * @param opts
+ */
+export const makeUuid = (prefix, opts) => {
+    const prfx = prefix || '';
+    const psfx = opts?.postfix ? `${opts?.postfix}` : '';
+    // no spaces or line-breaks allowed
+    // The only special chars allowed are "-" and "_"
+    return `${prfx}${generator(opts?.size)}${psfx}`
+        .trim()
+        .replace(/[^a-zA-Z0-9\-_]/g, '');
+};
+//# sourceMappingURL=make-uuid.js.map

package/dist/strings/make-uuid.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"make-uuid.js","sourceRoot":"","sources":["../../src/strings/make-uuid.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,QAAQ,CAAA;AAEvC,MAAM,eAAe,GACnB,kEAAkE,CAAA;AACpE,MAAM,SAAS,GAAG,cAAc,CAAC,eAAe,EAAE,EAAE,CAAC,CAAA;AAErD;;;;;;;;;;;GAWG;AACH,MAAM,CAAC,MAAM,QAAQ,GAAG,CACtB,MAAwB,EACxB,IAA0C,EAC1C,EAAE;IACF,MAAM,IAAI,GAAG,MAAM,IAAI,EAAE,CAAA;IACzB,MAAM,IAAI,GAAG,IAAI,EAAE,OAAO,CAAC,CAAC,CAAC,GAAG,IAAI,EAAE,OAAO,EAAE,CAAC,CAAC,CAAC,EAAE,CAAA;IAEpD,mCAAmC;IACnC,iDAAiD;IACjD,OAAO,GAAG,IAAI,GAAG,SAAS,CAAC,IAAI,EAAE,IAAI,CAAC,GAAG,IAAI,EAAE;SAC5C,IAAI,EAAE;SACN,OAAO,CAAC,kBAAkB,EAAE,EAAE,CAAC,CAAA;AACpC,CAAC,CAAA"}

package/dist/strings/obfuscate-string.d.ts

@@ -0,0 +1,21 @@
+type ObfuscatedString = string;
+export declare function isObfuscatedString(str: string): boolean;
+/**
+ * This function is used to obfuscate a string so that it can be used in a URL
+ * and is not easily guessable.
+ *
+ * @note this function earmarks an obfuscated string with a prefix to identify
+ * it as an obfuscated string. This is useful for when you need to determine
+ * whether a string is obfuscated or not.
+ */
+export declare function obfuscateString(str: string): ObfuscatedString;
+/**
+ * This function is used to de-obfuscate a string that was obfuscated using
+ * the obfuscateString function.
+ *
+ * @note this function will throw an error if the string is not obfuscated
+ */
+export declare function deObfuscateString(obufscatedString: ObfuscatedString, opts?: {
+    throw?: boolean;
+}): string;
+export {};

package/dist/strings/obfuscate-string.js

@@ -0,0 +1,46 @@
+import { ParamError } from '@archtx/core';
+const OBFUSCATED_STRING_PREFIX = 'oBfSs';
+export function isObfuscatedString(str) {
+    return str.startsWith(OBFUSCATED_STRING_PREFIX);
+}
+/**
+ * This function is used to obfuscate a string so that it can be used in a URL
+ * and is not easily guessable.
+ *
+ * @note this function earmarks an obfuscated string with a prefix to identify
+ * it as an obfuscated string. This is useful for when you need to determine
+ * whether a string is obfuscated or not.
+ */
+export function obfuscateString(str) {
+    if (!str)
+        throw new ParamError('obfuscateString str is required');
+    if (isObfuscatedString(str))
+        throw new ParamError('obfuscateString str is already obfuscated');
+    const encoded = Buffer.from(str).toString('base64');
+    return (OBFUSCATED_STRING_PREFIX +
+        encoded.replace('+', '-').replace('/', '_').replace(/=+$/g, ''));
+}
+/**
+ * This function is used to de-obfuscate a string that was obfuscated using
+ * the obfuscateString function.
+ *
+ * @note this function will throw an error if the string is not obfuscated
+ */
+export function deObfuscateString(obufscatedString, opts = { throw: true }) {
+    if (!obufscatedString)
+        throw new ParamError('deObfuscateString string is required');
+    if (!isObfuscatedString(obufscatedString)) {
+        if (opts?.throw) {
+            throw new ParamError('obfuscateString str is already obfuscated');
+        }
+        else {
+            return obufscatedString;
+        }
+    }
+    // remove the earmark prefix
+    obufscatedString = obufscatedString.replace(OBFUSCATED_STRING_PREFIX, '');
+    obufscatedString += Array(5 - (obufscatedString.length % 4)).join('=');
+    obufscatedString = obufscatedString.replace('-', '+').replace('_', '/');
+    return Buffer.from(obufscatedString, 'base64').toString();
+}
+//# sourceMappingURL=obfuscate-string.js.map

package/dist/strings/obfuscate-string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"obfuscate-string.js","sourceRoot":"","sources":["../../src/strings/obfuscate-string.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AAIzC,MAAM,wBAAwB,GAAG,OAAO,CAAA;AAExC,MAAM,UAAU,kBAAkB,CAAC,GAAW;IAC5C,OAAO,GAAG,CAAC,UAAU,CAAC,wBAAwB,CAAC,CAAA;AACjD,CAAC;AAED;;;;;;;GAOG;AACH,MAAM,UAAU,eAAe,CAAC,GAAW;IACzC,IAAI,CAAC,GAAG;QAAE,MAAM,IAAI,UAAU,CAAC,iCAAiC,CAAC,CAAA;IAEjE,IAAI,kBAAkB,CAAC,GAAG,CAAC;QACzB,MAAM,IAAI,UAAU,CAClB,2CAA2C,CAC5C,CAAA;IAEH,MAAM,OAAO,GAAG,MAAM,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,QAAQ,CAAC,QAAQ,CAAC,CAAA;IAEnD,OAAO,CACL,wBAAwB;QACxB,OAAO,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,MAAM,EAAE,EAAE,CAAC,CAChE,CAAA;AACH,CAAC;AAED;;;;;GAKG;AACH,MAAM,UAAU,iBAAiB,CAC/B,gBAAkC,EAClC,OAA4B,EAAE,KAAK,EAAE,IAAI,EAAE;IAE3C,IAAI,CAAC,gBAAgB;QACnB,MAAM,IAAI,UAAU,CAAC,sCAAsC,CAAC,CAAA;IAE9D,IAAI,CAAC,kBAAkB,CAAC,gBAAgB,CAAC,EAAE,CAAC;QAC1C,IAAI,IAAI,EAAE,KAAK,EAAE,CAAC;YAChB,MAAM,IAAI,UAAU,CAClB,2CAA2C,CAC5C,CAAA;QACH,CAAC;aAAM,CAAC;YACN,OAAO,gBAAgB,CAAA;QACzB,CAAC;IACH,CAAC;IAED,4BAA4B;IAC5B,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,wBAAwB,EAAE,EAAE,CAAC,CAAA;IAEzE,gBAAgB,IAAI,KAAK,CAAC,CAAC,GAAG,CAAC,gBAAgB,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAA;IAEtE,gBAAgB,GAAG,gBAAgB,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAC,OAAO,CAAC,GAAG,EAAE,GAAG,CAAC,CAAA;IAEvE,OAAO,MAAM,CAAC,IAAI,CAAC,gBAAgB,EAAE,QAAQ,CAAC,CAAC,QAAQ,EAAE,CAAA;AAC3D,CAAC"}

package/dist/strings/pluralize.d.ts

@@ -0,0 +1,5 @@
+/**
+ * @example pluralize('Location', 3) // "Locations"
+ * @example pluralize(['Entry', 'Entries'], 2) // "Entries"
+ */
+export declare function pluralize(txt: string | string[], count?: number): string;

package/dist/strings/pluralize.js

@@ -0,0 +1,17 @@
+/**
+ * @example pluralize('Location', 3) // "Locations"
+ * @example pluralize(['Entry', 'Entries'], 2) // "Entries"
+ */
+export function pluralize(txt, count = 0) {
+    if (count > 1) {
+        if (Array.isArray(txt)) {
+            return txt[1];
+        }
+        return txt + 's';
+    }
+    if (Array.isArray(txt)) {
+        return txt[0];
+    }
+    return txt;
+}
+//# sourceMappingURL=pluralize.js.map

package/dist/strings/pluralize.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"pluralize.js","sourceRoot":"","sources":["../../src/strings/pluralize.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,GAAsB,EAAE,KAAK,GAAE,CAAC;IACxD,IAAI,KAAK,GAAG,CAAC,EAAE,CAAC;QACd,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;YACvB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;QACf,CAAC;QACD,OAAO,GAAG,GAAG,GAAG,CAAA;IAClB,CAAC;IAED,IAAI,KAAK,CAAC,OAAO,CAAC,GAAG,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAC,CAAC,CAAC,CAAA;IACf,CAAC;IAED,OAAO,GAAG,CAAA;AACZ,CAAC"}

package/dist/strings/reproducible-hash.d.ts

@@ -0,0 +1,5 @@
+/**
+ * This function creates a reproducible hash from a given string input.
+ * @param input
+ */
+export declare function createReproducibleHash(input: string): string;

package/dist/strings/reproducible-hash.js

@@ -0,0 +1,23 @@
+/**
+ * This function creates a reproducible hash from a given string input.
+ * @param input
+ */
+export function createReproducibleHash(input) {
+    // Simple implementation using a common string hashing algorithm
+    let hash = 0;
+    const prime = 31;
+    // Handle empty string
+    if (input.length === 0) {
+        return '0';
+    }
+    // Apply hashing algorithm
+    for (let i = 0; i < input.length; i++) {
+        // Get char code
+        const char = input.charCodeAt(i);
+        // Apply prime multiplication and add char code
+        hash = (hash * prime + char) & 0xffffffff;
+    }
+    // Convert to hex string
+    return hash.toString(16);
+}
+//# sourceMappingURL=reproducible-hash.js.map

package/dist/strings/reproducible-hash.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reproducible-hash.js","sourceRoot":"","sources":["../../src/strings/reproducible-hash.ts"],"names":[],"mappings":"AAAA;;;GAGG;AACH,MAAM,UAAU,sBAAsB,CAAC,KAAa;IAClD,gEAAgE;IAChE,IAAI,IAAI,GAAG,CAAC,CAAA;IACZ,MAAM,KAAK,GAAG,EAAE,CAAA;IAEhB,sBAAsB;IACtB,IAAI,KAAK,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;QACvB,OAAO,GAAG,CAAA;IACZ,CAAC;IAED,0BAA0B;IAC1B,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,KAAK,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACtC,gBAAgB;QAChB,MAAM,IAAI,GAAG,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,CAAA;QAChC,+CAA+C;QAC/C,IAAI,GAAG,CAAC,IAAI,GAAG,KAAK,GAAG,IAAI,CAAC,GAAG,UAAU,CAAA;IAC3C,CAAC;IAED,wBAAwB;IACxB,OAAO,IAAI,CAAC,QAAQ,CAAC,EAAE,CAAC,CAAA;AAC1B,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@archtx/utils",
-  "version": "2.0.3",
+  "version": "2.0.5",
   "description": "Utility functions and helpers for JS software",
   "main": "dist/exports.js",
   "type": "module",