@splendidlabz/utils 1.5.1 → 1.7.0

package/dist/types/lib/index.d.cts

@@ -0,0 +1,43 @@
+export { isLastItem, last, lastArrayItem } from './arrays/item-position.cjs';
+export { joinWithConjunction } from './arrays/join.cjs';
+export { shuffle } from './arrays/shuffle.cjs';
+export { sort } from './arrays/sort.cjs';
+export { splitArray } from './arrays/split-array.cjs';
+export { uniqueArray } from './arrays/unique.cjs';
+export { AuthManager, RouteManager } from './auth/route-manager.cjs';
+export { getType, isArray, isObject, notObject } from './checks.cjs';
+export { DAYS } from './date/days.cjs';
+export { MONTHS } from './date/months.cjs';
+export { getTimeInMs, ms, toDays, toHours, toMinutes, toReadableTime, toSeconds, toWeeks } from './date/time.cjs';
+export { flattenArrayFields, formDataToObject } from './form/form-data.cjs';
+export { SanitizeOptions, sanitize, sanitizeArray, sanitizeObject } from './form/sanitize.cjs';
+export { debounce } from './functions/debounce.cjs';
+export { getEnv } from './functions/env.cjs';
+export { compose, curry, pipe, times } from './functions/functional.cjs';
+export { throttle } from './functions/throttle.cjs';
+export { delay, timeout, wait } from './functions/timeout.cjs';
+export { isHashedValue } from './hash.cjs';
+export { splitUnit } from './numbers/index.cjs';
+export { camelCaseKeys } from './objects/camelcase-keys.cjs';
+export { isEmpty, notEmpty } from './objects/empty.cjs';
+export { isEqual, notEqual } from './objects/equal.cjs';
+export { extendObject } from './objects/extend.cjs';
+export { flattenObject } from './objects/flatten.cjs';
+export { parseJSON } from './objects/json.cjs';
+export { objectForEach, objectMap } from './objects/loop.cjs';
+export { createMix, mix } from './objects/mix/mix.cjs';
+export { getNestedProperty, getNestedProperty2, getNestedValue } from './objects/nested-property.cjs';
+export { normalizeObject } from './objects/normalize-object.cjs';
+export { omitEmpty } from './objects/omit-empty.cjs';
+export { sizeOf } from './objects/size.cjs';
+export { splitObject } from './objects/split.cjs';
+export { reject } from './promises/reject.cjs';
+export { createSSE, parseSSE } from './sse.cjs';
+export { toCamel, toKebab, toLower, toPascal, toSentence, toSlug, toTitle, toUpper } from './strings/convert-case/convert-case.cjs';
+export { markdown, treatMarkdownWhitespace } from './strings/markdown.cjs';
+export { parseFullName } from './strings/name.cjs';
+export { pluralize } from './strings/pluralize.cjs';
+export { plural, stripNumbers, toQueryString } from './strings/query-string.cjs';
+export { toStyleString } from './style/index.cjs';
+export { getSymbol, getSymbolValue } from './symbols/symbols.cjs';
+export { toDegrees, toRadians } from './numbers/math.cjs';

package/dist/types/lib/numbers/index.d.cts

@@ -0,0 +1,5 @@
+export { toDegrees, toRadians } from './math.cjs';
+
+declare function splitUnit(string: any): any[];
+
+export { splitUnit };

package/dist/types/lib/numbers/math.d.cts

@@ -0,0 +1,4 @@
+declare function toDegrees(angle: any): number;
+declare function toRadians(angle: any): number;
+
+export { toDegrees, toRadians };

package/dist/types/lib/objects/camelcase-keys.d.cts

@@ -0,0 +1,3 @@
+declare function camelCaseKeys(obj: any): any;
+
+export { camelCaseKeys };

package/dist/types/lib/objects/empty.d.cts

@@ -0,0 +1,4 @@
+declare function isEmpty(obj: any): boolean;
+declare function notEmpty(obj: any): boolean;
+
+export { isEmpty, notEmpty };

package/dist/types/lib/objects/equal.d.cts

@@ -0,0 +1,4 @@
+declare function isEqual(a: any, b: any): boolean;
+declare function notEqual(a: any, b: any): boolean;
+
+export { isEqual, notEqual };

package/dist/types/lib/objects/extend.d.cts

@@ -0,0 +1,6 @@
+declare function extendObject(object: any): {
+    orig: any;
+    extended: {};
+};
+
+export { extendObject };

package/dist/types/lib/objects/flatten.d.cts

@@ -0,0 +1,6 @@
+declare function flattenObject(obj: any, { separator, prefix }: {
+    separator: any;
+    prefix?: string;
+}): {};
+
+export { flattenObject };

package/dist/types/lib/objects/index.d.cts

@@ -0,0 +1,13 @@
+export { camelCaseKeys } from './camelcase-keys.cjs';
+export { isEmpty, notEmpty } from './empty.cjs';
+export { isEqual, notEqual } from './equal.cjs';
+export { extendObject } from './extend.cjs';
+export { flattenObject } from './flatten.cjs';
+export { parseJSON } from './json.cjs';
+export { objectForEach, objectMap } from './loop.cjs';
+export { createMix, mix } from './mix/mix.cjs';
+export { getNestedProperty, getNestedProperty2, getNestedValue } from './nested-property.cjs';
+export { normalizeObject } from './normalize-object.cjs';
+export { omitEmpty } from './omit-empty.cjs';
+export { sizeOf } from './size.cjs';
+export { splitObject } from './split.cjs';

package/dist/types/lib/objects/json.d.cts

@@ -0,0 +1,3 @@
+declare function parseJSON(value: any, defaultValue?: {}): any;
+
+export { parseJSON };

package/dist/types/lib/objects/loop.d.cts

@@ -0,0 +1,4 @@
+declare function objectForEach(object: any, callback: any): void;
+declare function objectMap(object: any, callback: any): any[];
+
+export { objectForEach, objectMap };

package/dist/types/lib/objects/mix/mix.d.cts

@@ -0,0 +1,4 @@
+declare function createMix(userOptions?: {}): (...sources: any[]) => {};
+declare function mix(...sources: any[]): {};
+
+export { createMix, mix };

package/dist/{lib/objects/nested-property.d.ts → types/lib/objects/nested-property.d.cts}

@@ -17,6 +17,8 @@
  * let path = ['one', 'two', 'three'];
  * console.log(getNestedProperty(object, path)); // Outputs: "value"
  */
-export function getNestedProperty(object: any, pathArr: any[]): any;
-export function getNestedProperty2(object: any, path: any): any;
-export function getNestedValue(object: any, path: any): any;
+declare function getNestedProperty(object: any, pathArr: any[]): any;
+declare function getNestedProperty2(object: any, path: any): any;
+declare function getNestedValue(object: any, path: any): any;
+
+export { getNestedProperty, getNestedProperty2, getNestedValue };

package/dist/types/lib/objects/normalize-object.d.cts

@@ -0,0 +1,3 @@
+declare function normalizeObject(object: any): any;
+
+export { normalizeObject };

package/dist/types/lib/objects/omit-empty.d.cts

@@ -0,0 +1,3 @@
+declare function omitEmpty(obj: any, shallow?: boolean): any;
+
+export { omitEmpty };

package/dist/types/lib/objects/size.d.cts

@@ -0,0 +1,3 @@
+declare function sizeOf(obj: any): string;
+
+export { sizeOf };

package/dist/{lib/objects/split.d.ts → types/lib/objects/split.d.cts}

@@ -4,7 +4,11 @@
  * @param {Array} keys
  * @returns
  */
-export function splitObject(obj: any, keys: any[]): {
+declare function splitObject(obj: any, keys: any[]): {
     picked: {};
     omitted: any;
+    p: {};
+    o: any;
 };
+
+export { splitObject };

package/dist/types/lib/promises/index.d.cts

@@ -0,0 +1 @@
+export { reject } from './reject.cjs';

package/dist/types/lib/promises/reject.d.cts

@@ -0,0 +1,5 @@
+declare function reject(props: any, { includeStack }?: {
+    includeStack?: boolean;
+}): Promise<never>;
+
+export { reject };

package/dist/{lib/sse.d.ts → types/lib/sse.d.cts}

@@ -1,4 +1,4 @@
-export function createSSE({ event, data, id, retry }: {
+declare function createSSE({ event, data, id, retry }: {
     event: any;
     data: any;
     id: any;
@@ -13,4 +13,6 @@ export function createSSE({ event, data, id, retry }: {
  * @property {string} [id] - The message ID if specified
  * @property {number} [retry] - The retry interval if specified
  */
-export function parseSSE(message: string): any | null;
+declare function parseSSE(message: string): any | null;
+
+export { createSSE, parseSSE };

package/dist/types/lib/strings/convert-case/convert-case.d.cts

@@ -0,0 +1,10 @@
+declare function toKebab(string: any): any;
+declare function toCamel(string: any): any;
+declare function toPascal(string: any): any;
+declare function toTitle(string: any): any;
+declare function toSlug(string: any): any;
+declare function toSentence(string: any): any;
+declare function toUpper(string: any): any;
+declare function toLower(string: any): any;
+
+export { toCamel, toKebab, toLower, toPascal, toSentence, toSlug, toTitle, toUpper };

package/dist/types/lib/strings/index.d.cts

@@ -0,0 +1,5 @@
+export { toCamel, toKebab, toLower, toPascal, toSentence, toSlug, toTitle, toUpper } from './convert-case/convert-case.cjs';
+export { markdown, treatMarkdownWhitespace } from './markdown.cjs';
+export { parseFullName } from './name.cjs';
+export { pluralize } from './pluralize.cjs';
+export { plural, stripNumbers, toQueryString } from './query-string.cjs';

package/dist/{lib/strings/markdown.d.ts → types/lib/strings/markdown.d.cts}

@@ -5,7 +5,7 @@
  * @param {boolean} [options.inline=false] - Whether content should be treated as inline markdown
  * @returns {string|Promise<string>} HTML string or Promise that resolves to HTML string
  */
-export function markdown(content: string, options?: {
+declare function markdown(content: string, options?: {
     inline?: boolean;
 }): string | Promise<string>;
 /**
@@ -15,9 +15,11 @@ export function markdown(content: string, options?: {
  * @param {boolean} [options.inline=false] - Whether content is inline markdown
  * @returns {{ content: string, inline: boolean }} Processed content and inline status
  */
-export function treatMarkdownWhitespace(content: string, { inline }?: {
+declare function treatMarkdownWhitespace(content: string, { inline }?: {
     inline?: boolean;
 }): {
     content: string;
     inline: boolean;
 };
+
+export { markdown, treatMarkdownWhitespace };

package/dist/types/lib/strings/name.d.cts

@@ -0,0 +1,7 @@
+declare function parseFullName(name: any): {
+    firstName: any;
+    middleName: any;
+    lastName: any;
+};
+
+export { parseFullName };

package/dist/types/lib/strings/pluralize.d.cts

@@ -0,0 +1,3 @@
+declare const pluralize: any;
+
+export { pluralize };

package/dist/types/lib/strings/query-string.d.cts

@@ -0,0 +1,10 @@
+/**
+ * Converts object into a query string
+ * @param {Object} object
+ * @returns
+ */
+declare function toQueryString(object: any): string;
+declare function plural(count: any, noun: any, suffix?: string): string;
+declare function stripNumbers(string: any): any;
+
+export { plural, stripNumbers, toQueryString };

package/dist/types/lib/style/index.d.cts

@@ -0,0 +1,3 @@
+declare function toStyleString(style: any): string;
+
+export { toStyleString };

package/dist/types/lib/symbols/index.d.cts

@@ -0,0 +1 @@
+export { getSymbol, getSymbolValue } from './symbols.cjs';

package/dist/types/lib/symbols/symbols.d.cts

@@ -0,0 +1,4 @@
+declare function getSymbol(object: any, description: any): symbol;
+declare function getSymbolValue(object: any, description: any): any;
+
+export { getSymbol, getSymbolValue };

package/dist/types/node/common.d.cts

@@ -0,0 +1,3 @@
+declare function uuid(): `${string}-${string}-${string}-${string}-${string}`;
+
+export { uuid };

package/dist/types/node/dirname.d.cts

@@ -0,0 +1,9 @@
+/**
+ * Returns __dirname
+ * @param url — import.meta.url
+ * @returns
+ */
+declare function __dirname(url: any): string;
+declare function dirname(url: any): string;
+
+export { __dirname, dirname };

package/dist/{node/file-cache.d.ts → types/node/file-cache.d.cts}

@@ -10,7 +10,7 @@
  * @property {function(string): Promise<object>} loadJSON - Loads and parses JSON from cache file
  * @property {function(string, object): Promise<void>} saveJSON - Saves object as JSON to cache file
  */
-export function createCache(dir: string): Promise<object>;
+declare function createCache(dir: string): Promise<object>;
 /**
  * Legacy file cache API for managing a single cached file
  * @param {Object} options
@@ -24,7 +24,7 @@ export function createCache(dir: string): Promise<object>;
  *   saveJSON: (data: object) => Promise<void>
  * }>}
  */
-export function fileCache({ dir, file }: {
+declare function fileCache({ dir, file }: {
     dir: string;
     file: string;
 }): Promise<{
@@ -39,16 +39,18 @@ export function fileCache({ dir, file }: {
  * @param {string|string[]} globPath - Glob pattern(s) to match files
  * @returns {Promise<number>} Timestamp of most recently modified file, or 0 if no files found
  */
-export function getLastModifiedTime(globPath: string | string[]): Promise<number>;
+declare function getLastModifiedTime(globPath: string | string[]): Promise<number>;
 /**
  * @deprecated Use getLastModifiedTime instead
  * @param {string|string[]} globPath - Glob pattern(s) to match files
  * @returns {Promise<number>} Timestamp of most recently modified file, or 0 if no files found
  */
-export function getLatestModifiedTime(globPath: string | string[]): Promise<number>;
+declare function getLatestModifiedTime(globPath: string | string[]): Promise<number>;
 /**
  * Removes leading slash from a path string
  * @param {string} x - Path string to process
  * @returns {string} Path without leading slash
  */
-export function removeFirstSlash(x: string): string;
+declare function removeFirstSlash(x: string): string;
+
+export { createCache, fileCache, getLastModifiedTime, getLatestModifiedTime, removeFirstSlash };

package/dist/types/node/file.d.cts

@@ -0,0 +1,4 @@
+declare function mkdir(path: any): Promise<string>;
+declare function copyFile(from: any, to: any): Promise<void>;
+
+export { copyFile, mkdir };

package/dist/types/node/hash.d.cts

@@ -0,0 +1,3 @@
+declare function sha256Hash(string: any): string;
+
+export { sha256Hash };

package/dist/types/node/index.d.cts

@@ -0,0 +1,7 @@
+export { uuid } from './common.cjs';
+export { __dirname, dirname } from './dirname.cjs';
+export { createCache, fileCache, getLastModifiedTime, getLatestModifiedTime, removeFirstSlash } from './file-cache.cjs';
+export { sha256Hash } from './hash.cjs';
+export { PKCE } from './pkce.cjs';
+export { randomString } from './random-string.cjs';
+export { sanitize } from './sanitize.cjs';

package/dist/{dom/pkce.d.ts → types/node/pkce.d.cts}

@@ -1,6 +1,8 @@
-export function PKCE(): Promise<{
+declare function PKCE(): Promise<{
     state: string;
     code_verifier: string;
     code_challenge: string;
     code_challenge_method: string;
 }>;
+
+export { PKCE };

package/dist/types/node/random-string.d.cts

@@ -0,0 +1,3 @@
+declare function randomString(length?: number): string;
+
+export { randomString };

package/dist/{node/sanitize.d.ts → types/node/sanitize.d.cts}

@@ -5,4 +5,6 @@
  * @returns {*} Sanitized value
  * @throws {Error} If input is a string but sanitize-html fails
  */
-export function sanitize(value: any, options?: any): any;
+declare function sanitize(value: any, options?: any): any;
+
+export { sanitize };

package/package.json

@@ -1,33 +1,42 @@
 {
   "name": "@splendidlabz/utils",
-  "version": "1.5.1",
+  "version": "1.7.0",
   "description": "",
   "type": "module",
   "sideEffects": false,
+  "main": "./dist/cjs/lib/index.cjs",
+  "module": "./dist/esm/lib/index.js",
+  "types": "./dist/types/lib/index.d.cts",
   "exports": {
     ".": {
-      "types": "./dist/index.d.ts",
-      "import": "./lib/index.js"
+      "types": "./dist/types/lib/index.d.cts",
+      "import": "./dist/esm/lib/index.js",
+      "require": "./dist/cjs/lib/index.cjs"
     },
     "./lib/*": {
-      "types": "./dist/lib/*.d.ts",
-      "import": "./lib/*.js"
+      "types": "./dist/types/lib/*.d.cts",
+      "import": "./dist/esm/lib/*.js",
+      "require": "./dist/cjs/lib/*.cjs"
     },
     "./dom": {
-      "types": "./dist/dom/index.d.ts",
-      "import": "./dom/index.js"
+      "types": "./dist/types/dom/index.d.cts",
+      "import": "./dist/esm/dom/index.js",
+      "require": "./dist/cjs/dom/index.cjs"
     },
     "./dom/*": {
-      "types": "./dist/dom/*.d.ts",
-      "import": "./dom/*.js"
+      "types": "./dist/types/dom/*.d.cts",
+      "import": "./dist/esm/dom/*.js",
+      "require": "./dist/cjs/dom/*.cjs"
     },
     "./node": {
-      "types": "./dist/node/index.d.ts",
-      "import": "./node/index.js"
+      "types": "./dist/types/node/index.d.cts",
+      "import": "./dist/esm/node/index.js",
+      "require": "./dist/cjs/node/index.cjs"
     },
     "./node/*": {
-      "types": "./dist/node/*.d.ts",
-      "import": "./node/*.js"
+      "types": "./dist/types/node/*.d.cts",
+      "import": "./dist/esm/node/*.js",
+      "require": "./dist/cjs/node/*.cjs"
     }
   },
   "scripts": {
@@ -35,8 +44,10 @@
     "test": "npm run type-check && vitest run",
     "test:watch": "vitest",
     "type-check": "tsc --noEmit",
-    "build": "tsc",
-    "prepublishOnly": "npm run build"
+    "build": "tsup --config tsup.config.mjs",
+    "build:watch": "tsup --config tsup.config.mjs --watch",
+    "clean": "rm -rf dist",
+    "prepublishOnly": "npm run clean && npm run build"
   },
   "author": "Zell Liew <zellwk@gmail.com>",
   "dependencies": {
@@ -51,9 +62,11 @@
     "statuses": "^2.0.1"
   },
   "devDependencies": {
-    "@splendidlabz/eslint-config": "2.0.0",
+    "@splendidlabz/eslint-config": "2.1.0",
+    "glob": "^11.0.0",
     "jsdom": "^26.0.0",
     "np": "^10.2.0",
+    "tsup": "^8.0.0",
     "typescript": "^5.4.2",
     "vitest": "^3.1.1"
   }

package/{dom → src/dom}/cookie.js

@@ -8,15 +8,16 @@ export const cookies = {
   },
 }
 
-/**
- * Gets a cookie by name
- * Thanks to https://stackoverflow.com/a/21125098
- * @param {string} name Cookie name
- * @returns string Cookie value
- */
 export function getCookie(name) {
   const match = document.cookie.match(new RegExp('(^| )' + name + '=([^;]+)'))
-  if (match) return match[2]
+  if (!match) return null
+  const decoded = decodeURIComponent(match[2])
+
+  try {
+    return JSON.parse(decoded)
+  } catch (e) {
+    return decoded
+  }
 }
 
 // By Copilot. Needs testing before confirmation.

package/{dom → src/dom}/index.js

@@ -18,5 +18,6 @@ export * from './query-params.js'
 export * from './random-string.js'
 export * from './sanitize.js'
 export * from './session-store.js'
+export * from './spam-prevention.js'
 export * from './trap-focus.js'
 export * from './ui/index.js'

package/{dom → src/dom}/random-string.js

@@ -3,7 +3,7 @@
  * Ensures first character is a letter so it can be used in HTML ids and classes
  * This can actually be used everywhere, not just in the browser.
  */
-export function randomString(length) {
+export function randomString(length = 10) {
   const firstLetter = String.fromCharCode(65 + Math.floor(Math.random() * 26))
   const others = Math.random()
     .toString(36)

package/src/dom/random-string.test.js

@@ -0,0 +1,13 @@
+import { describe, expect, it } from 'vitest'
+import { randomString } from './random-string.js'
+
+describe('randomString', () => {
+  it('should generate a random string', () => {
+    const str = randomString()
+    expect(str).toBeDefined()
+    expect(str.length).toBe(10)
+
+    // Ensure the first character is a letter
+    expect(str[0]).toMatch(/[a-zA-Z]/)
+  })
+})

package/src/dom/spam-prevention.js

@@ -0,0 +1,39 @@
+/**
+ * Enhances a form element with spam detection capabilities
+ * @param {HTMLFormElement} form - The form element to enhance
+ * @param {Object} options - Configuration options
+ * @param {string} options.honeypotField - Name of the honeypot field (default: 'hp')
+ * @param {number} options.honeypotDuration - Minimum time in ms for legitimate form fill (default: 2000)
+ * @returns {Function} Cleanup function to remove listeners and method
+ */
+export function preventSpam(
+  form,
+  { honeypotField = 'hp', honeypotDuration = 2000 } = {},
+) {
+  const startTime = Date.now()
+  let hasInteraction = false
+
+  function checkForInteraction() {
+    hasInteraction = true
+  }
+
+  const events = ['keydown', 'mousemove', 'touchstart', 'click']
+  events.forEach(event => {
+    form.addEventListener(event, checkForInteraction, { once: true })
+  })
+
+  form.containsSpam = function () {
+    const fillTime = Date.now() - startTime
+    const isTooFast = fillTime < honeypotDuration
+    const honeypotInput = form.querySelector(`[name="${honeypotField}"]`)
+    const hasHoneypotValue = honeypotInput?.value?.trim()
+    const noInteraction = !hasInteraction
+
+    // Clean up event listeners after use
+    events.forEach(event =>
+      form.removeEventListener(event, checkForInteraction),
+    )
+
+    return isTooFast || !!hasHoneypotValue || noInteraction
+  }
+}

package/{dom → src/dom}/ui/aria-current.js

@@ -10,7 +10,7 @@ export function markActiveAnchorIn(container, anchorType = 'page') {
   return element
 }
 
-export function goToElement(
+export function scrollToElement(
   element,
   { scrollBehaviour = 'instant', scrollMargin = '3rem' } = {},
 ) {

package/{lib → src/lib}/arrays/index.js

@@ -2,4 +2,5 @@ export * from './item-position.js'
 export * from './join.js'
 export * from './shuffle.js'
 export * from './sort.js'
+export * from './split-array.js'
 export * from './unique.js'

package/{lib → src/lib}/arrays/sort.js

@@ -3,7 +3,7 @@ import { getNestedValue } from '../objects/nested-property.js'
 /**
  * Sorts an array of objects, numbers, or strings without mutating the original array.
  * Supports nested properties, multiple sort keys, and various data types.
- * 
+ *
  * @template T
  * @param {T[]} array - Array to sort
  * @param {Object} [options] - Sort options
@@ -13,16 +13,16 @@ import { getNestedValue } from '../objects/nested-property.js'
  * @example
  * // Sort simple array
  * sort([3, 1, 2]) // [1, 2, 3]
- * 
+ *
  * // Sort objects by single property
  * sort(users, { props: 'name' })
- * 
+ *
  * // Sort objects by multiple properties
  * sort(users, { props: ['age', 'name'] })
- * 
+ *
  * // Sort in reverse order
  * sort(users, { props: 'age', reverse: true })
- * 
+ *
  * // Sort by nested property
  * sort(users, { props: 'address.city' })
  */
@@ -63,7 +63,7 @@ export function sort(array, { props = null, reverse = false } = {}) {
 /**
  * Compares two values for sorting, handling different data types.
  * Supports numbers, strings, dates, and falls back to string comparison.
- * 
+ *
  * @param {*} a - First value to compare
  * @param {*} b - Second value to compare
  * @returns {number} -1 if a < b, 0 if a === b, 1 if a > b

package/src/lib/arrays/split-array.js

@@ -0,0 +1,15 @@
+export function splitArray(array, predicate) {
+  const ret = {
+    picked: [],
+    omitted: [],
+  }
+
+  array.forEach((item, index, arr) => {
+    if (predicate(item, index, arr)) ret.picked.push(item)
+    else ret.omitted.push(item)
+  })
+
+  ret.p = ret.picked
+  ret.o = ret.omitted
+  return ret
+}

package/{lib → src/lib}/auth/route-manager.js

@@ -1,5 +1,6 @@
 /**
   // Usage ... Probably should use either protected or bypass, not both.
+  // Maybe ... glob would be a better for this
   @example 
   const config = {
     routeConfig: {