@splendidlabz/utils 1.6.0 → 1.7.0

package/dist/esm/lib/objects/nested-property.js

@@ -0,0 +1,19 @@
+// src/lib/objects/nested-property.js
+function getNestedProperty(object, pathArr) {
+  return pathArr.reduce(
+    (nestedObject, key) => nestedObject && nestedObject[key] !== "undefined" ? nestedObject[key] : void 0,
+    object
+  );
+}
+function getNestedProperty2(object, path) {
+  const pathArray = path.split(".");
+  return getNestedProperty(object, pathArray);
+}
+function getNestedValue(object, path) {
+  return path.split(".").reduce((acc, part) => acc?.[part], object);
+}
+export {
+  getNestedProperty,
+  getNestedProperty2,
+  getNestedValue
+};

package/dist/esm/lib/objects/normalize-object.js

@@ -0,0 +1,80 @@
+// src/lib/functions/functional.js
+function pipe(...fns) {
+  return function(value) {
+    return fns.reduce((acc, fn) => fn(acc), value);
+  };
+}
+
+// src/lib/objects/loop.js
+function objectForEach(object, callback) {
+  Object.entries(object).forEach(([key, value]) => {
+    callback({ key, value });
+  });
+}
+
+// src/lib/strings/convert-case/convert-case.js
+function toKebab(string) {
+  if (!string) return "";
+  return string.split("").map((letter, index) => {
+    const previousLetter = string[index - 1] || "";
+    const currentLetter = letter;
+    if (isDigit(currentLetter) && !isDigit(previousLetter)) {
+      return `-${currentLetter}`;
+    }
+    if (!isCaps(currentLetter)) return currentLetter;
+    if (previousLetter === "") {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    if (isCaps(previousLetter)) {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    return `-${currentLetter.toLowerCase()}`;
+  }).join("").trim().replace(/[-_\s]+/g, "-");
+}
+function toCamel(string) {
+  return toKebab(string).split("-").map((word, index) => {
+    if (index === 0) return word;
+    return word.slice(0, 1).toUpperCase() + word.slice(1).toLowerCase();
+  }).join("");
+}
+function isCaps(char) {
+  return /\p{Lu}/u.test(char);
+}
+function isDigit(char) {
+  return /[0-9]/.test(char);
+}
+
+// src/lib/objects/camelcase-keys.js
+function camelCaseKeys(obj) {
+  if (typeof obj !== "object" || obj === null) {
+    return obj;
+  }
+  const result = {};
+  objectForEach(obj, ({ key, value }) => {
+    const camelCaseKey = toCamel(key);
+    result[camelCaseKey] = camelCaseKeys(value);
+  });
+  return result;
+}
+
+// src/lib/objects/omit-empty.js
+function omitEmpty(obj, shallow = false) {
+  if (typeof obj !== "object" || obj === null) return obj;
+  if (obj instanceof Date) return obj;
+  const result = Array.isArray(obj) ? [] : {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === null || value === void 0 || value === "" || typeof value === "object" && !(value instanceof Date) && Object.keys(value).length === 0) {
+      continue;
+    }
+    result[key] = shallow ? value : omitEmpty(value);
+  }
+  return result;
+}
+
+// src/lib/objects/normalize-object.js
+function normalizeObject(object) {
+  return pipe(omitEmpty, camelCaseKeys)(object);
+}
+export {
+  normalizeObject
+};

package/dist/esm/lib/objects/omit-empty.js

@@ -0,0 +1,16 @@
+// src/lib/objects/omit-empty.js
+function omitEmpty(obj, shallow = false) {
+  if (typeof obj !== "object" || obj === null) return obj;
+  if (obj instanceof Date) return obj;
+  const result = Array.isArray(obj) ? [] : {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === null || value === void 0 || value === "" || typeof value === "object" && !(value instanceof Date) && Object.keys(value).length === 0) {
+      continue;
+    }
+    result[key] = shallow ? value : omitEmpty(value);
+  }
+  return result;
+}
+export {
+  omitEmpty
+};

package/dist/esm/lib/objects/size.js

@@ -0,0 +1,39 @@
+// src/lib/objects/size.js
+function sizeOf(obj) {
+  let bytes = 0;
+  function size(obj2) {
+    if (obj2 !== null && obj2 !== void 0) {
+      switch (typeof obj2) {
+        case "number":
+          bytes += 8;
+          break;
+        case "string":
+          bytes += obj2.length * 2;
+          break;
+        case "boolean":
+          bytes += 4;
+          break;
+        case "object":
+          const objClass = Object.prototype.toString.call(obj2).slice(8, -1);
+          if (objClass === "Object" || objClass === "Array") {
+            for (const key in obj2) {
+              if (!obj2.hasOwnProperty(key)) continue;
+              size(obj2[key]);
+            }
+          } else bytes += obj2.toString().length * 2;
+          break;
+      }
+    }
+    return bytes;
+  }
+  function formatByteSize(bytes2) {
+    if (bytes2 < 1024) return bytes2 + " bytes";
+    else if (bytes2 < 1048576) return (bytes2 / 1024).toFixed(3) + " KiB";
+    else if (bytes2 < 1073741824) return (bytes2 / 1048576).toFixed(3) + " MiB";
+    else return (bytes2 / 1073741824).toFixed(3) + " GiB";
+  }
+  return formatByteSize(size(obj));
+}
+export {
+  sizeOf
+};

package/dist/esm/lib/objects/split.js

@@ -0,0 +1,15 @@
+// src/lib/objects/split.js
+function splitObject(obj, keys) {
+  const picked = {};
+  const omitted = { ...obj };
+  keys.forEach((key) => {
+    if (key in obj) {
+      picked[key] = obj[key];
+      delete omitted[key];
+    }
+  });
+  return { picked, omitted, p: picked, o: omitted };
+}
+export {
+  splitObject
+};

package/dist/esm/lib/promises/index.js

@@ -0,0 +1,33 @@
+// src/lib/promises/reject.js
+import statuses from "statuses";
+
+// src/lib/objects/omit-empty.js
+function omitEmpty(obj, shallow = false) {
+  if (typeof obj !== "object" || obj === null) return obj;
+  if (obj instanceof Date) return obj;
+  const result = Array.isArray(obj) ? [] : {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === null || value === void 0 || value === "" || typeof value === "object" && !(value instanceof Date) && Object.keys(value).length === 0) {
+      continue;
+    }
+    result[key] = shallow ? value : omitEmpty(value);
+  }
+  return result;
+}
+
+// src/lib/promises/reject.js
+function reject(props, { includeStack = true } = {}) {
+  const { status, statusText, body, message } = props;
+  const e = new Error();
+  const err = {
+    status,
+    statusText: statusText || status && statuses(status),
+    body,
+    message,
+    stack: includeStack && e.stack
+  };
+  return Promise.reject(omitEmpty(err));
+}
+export {
+  reject
+};

package/dist/esm/lib/promises/reject.js

@@ -0,0 +1,33 @@
+// src/lib/promises/reject.js
+import statuses from "statuses";
+
+// src/lib/objects/omit-empty.js
+function omitEmpty(obj, shallow = false) {
+  if (typeof obj !== "object" || obj === null) return obj;
+  if (obj instanceof Date) return obj;
+  const result = Array.isArray(obj) ? [] : {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === null || value === void 0 || value === "" || typeof value === "object" && !(value instanceof Date) && Object.keys(value).length === 0) {
+      continue;
+    }
+    result[key] = shallow ? value : omitEmpty(value);
+  }
+  return result;
+}
+
+// src/lib/promises/reject.js
+function reject(props, { includeStack = true } = {}) {
+  const { status, statusText, body, message } = props;
+  const e = new Error();
+  const err = {
+    status,
+    statusText: statusText || status && statuses(status),
+    body,
+    message,
+    stack: includeStack && e.stack
+  };
+  return Promise.reject(omitEmpty(err));
+}
+export {
+  reject
+};

package/dist/esm/lib/sse.js

@@ -0,0 +1,72 @@
+// src/lib/objects/json.js
+function parseJSON(value, defaultValue = {}) {
+  try {
+    return JSON.parse(value);
+  } catch (e) {
+    return defaultValue;
+  }
+}
+
+// src/lib/objects/omit-empty.js
+function omitEmpty(obj, shallow = false) {
+  if (typeof obj !== "object" || obj === null) return obj;
+  if (obj instanceof Date) return obj;
+  const result = Array.isArray(obj) ? [] : {};
+  for (const [key, value] of Object.entries(obj)) {
+    if (value === null || value === void 0 || value === "" || typeof value === "object" && !(value instanceof Date) && Object.keys(value).length === 0) {
+      continue;
+    }
+    result[key] = shallow ? value : omitEmpty(value);
+  }
+  return result;
+}
+
+// src/lib/sse.js
+function createSSE({ event, data, id, retry }) {
+  const eventString = event ? `event: ${event}
+` : "";
+  const idString = id ? `id: ${id}
+` : "";
+  const retryString = retry ? `retry: ${retry}
+` : "";
+  if (typeof data === "object") data = JSON.stringify(data);
+  const dataString = data ? `data: ${data}
+` : "";
+  return `${eventString}${dataString}${idString}${retryString}
+`;
+}
+function parseSSE(message) {
+  const lines = message.split("\n");
+  const result = {
+    event: "message",
+    // Default event type
+    data: "",
+    id: null,
+    retry: null
+  };
+  for (const line of lines) {
+    if (line.startsWith("data:")) {
+      const data = line.slice(5).trim();
+      result.data = parseJSON(data);
+      continue;
+    }
+    if (line.startsWith("event:")) {
+      result.event = line.slice(6).trim();
+      continue;
+    }
+    if (line.startsWith("id:")) {
+      result.id = line.slice(3).trim();
+      continue;
+    }
+    if (line.startsWith("retry:")) {
+      result.retry = parseInt(line.slice(6).trim(), 10);
+      continue;
+    }
+  }
+  const ret = omitEmpty(result);
+  return ret.data ? ret : null;
+}
+export {
+  createSSE,
+  parseSSE
+};

package/dist/esm/lib/strings/convert-case/convert-case.js

@@ -0,0 +1,65 @@
+// src/lib/strings/convert-case/convert-case.js
+function toKebab(string) {
+  if (!string) return "";
+  return string.split("").map((letter, index) => {
+    const previousLetter = string[index - 1] || "";
+    const currentLetter = letter;
+    if (isDigit(currentLetter) && !isDigit(previousLetter)) {
+      return `-${currentLetter}`;
+    }
+    if (!isCaps(currentLetter)) return currentLetter;
+    if (previousLetter === "") {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    if (isCaps(previousLetter)) {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    return `-${currentLetter.toLowerCase()}`;
+  }).join("").trim().replace(/[-_\s]+/g, "-");
+}
+function toCamel(string) {
+  return toKebab(string).split("-").map((word, index) => {
+    if (index === 0) return word;
+    return word.slice(0, 1).toUpperCase() + word.slice(1).toLowerCase();
+  }).join("");
+}
+function toPascal(string) {
+  const camel = toCamel(string);
+  return camel.slice(0, 1).toUpperCase() + camel.slice(1);
+}
+function toTitle(string) {
+  return toKebab(string).split("-").map((word) => {
+    return word.slice(0, 1).toUpperCase() + word.slice(1);
+  }).join(" ");
+}
+function toSlug(string) {
+  return toKebab(string);
+}
+function toSentence(string) {
+  const interim = toKebab(string).replace(/-/g, " ");
+  return interim.slice(0, 1).toUpperCase() + interim.slice(1);
+}
+function toUpper(string) {
+  const interim = toKebab(string).replace(/-/g, " ");
+  return interim.toUpperCase();
+}
+function toLower(string) {
+  const interim = toKebab(string).replace(/-/g, " ");
+  return interim.toLowerCase();
+}
+function isCaps(char) {
+  return /\p{Lu}/u.test(char);
+}
+function isDigit(char) {
+  return /[0-9]/.test(char);
+}
+export {
+  toCamel,
+  toKebab,
+  toLower,
+  toPascal,
+  toSentence,
+  toSlug,
+  toTitle,
+  toUpper
+};

package/dist/esm/lib/strings/index.js

@@ -0,0 +1,140 @@
+// src/lib/strings/convert-case/convert-case.js
+function toKebab(string) {
+  if (!string) return "";
+  return string.split("").map((letter, index) => {
+    const previousLetter = string[index - 1] || "";
+    const currentLetter = letter;
+    if (isDigit(currentLetter) && !isDigit(previousLetter)) {
+      return `-${currentLetter}`;
+    }
+    if (!isCaps(currentLetter)) return currentLetter;
+    if (previousLetter === "") {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    if (isCaps(previousLetter)) {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    return `-${currentLetter.toLowerCase()}`;
+  }).join("").trim().replace(/[-_\s]+/g, "-");
+}
+function toCamel(string) {
+  return toKebab(string).split("-").map((word, index) => {
+    if (index === 0) return word;
+    return word.slice(0, 1).toUpperCase() + word.slice(1).toLowerCase();
+  }).join("");
+}
+function toPascal(string) {
+  const camel = toCamel(string);
+  return camel.slice(0, 1).toUpperCase() + camel.slice(1);
+}
+function toTitle(string) {
+  return toKebab(string).split("-").map((word) => {
+    return word.slice(0, 1).toUpperCase() + word.slice(1);
+  }).join(" ");
+}
+function toSlug(string) {
+  return toKebab(string);
+}
+function toSentence(string) {
+  const interim = toKebab(string).replace(/-/g, " ");
+  return interim.slice(0, 1).toUpperCase() + interim.slice(1);
+}
+function toUpper(string) {
+  const interim = toKebab(string).replace(/-/g, " ");
+  return interim.toUpperCase();
+}
+function toLower(string) {
+  const interim = toKebab(string).replace(/-/g, " ");
+  return interim.toLowerCase();
+}
+function isCaps(char) {
+  return /\p{Lu}/u.test(char);
+}
+function isDigit(char) {
+  return /[0-9]/.test(char);
+}
+
+// src/lib/strings/markdown.js
+import { marked } from "marked";
+import { gfmHeadingId } from "marked-gfm-heading-id";
+import { mangle } from "marked-mangle";
+function markdown(content, options = {}) {
+  const defaultOptions = { inline: false };
+  const opts = { ...defaultOptions, ...options };
+  marked.use(mangle());
+  marked.use(gfmHeadingId());
+  const { content: treated } = treatMarkdownWhitespace(content, opts);
+  return marked.parse(treated);
+}
+function treatMarkdownWhitespace(content, { inline } = {}) {
+  if (!content) return { content: "", inline };
+  const lines = content.split("\n");
+  if (lines[0] !== "" && inline) return { content, inline: true };
+  const firstLineWithLeadingSpacesIndex = lines.findIndex(
+    (line) => line.match(/^\s+/)
+  );
+  const firstLineWithLeadingSpaces = lines[firstLineWithLeadingSpacesIndex];
+  const indentation = firstLineWithLeadingSpaces?.match(/^\s+/)?.[0]?.length ?? 0;
+  const retContent = lines.map((line, index) => {
+    if (index < firstLineWithLeadingSpacesIndex) return line + "\n";
+    return line.slice(indentation) + "\n";
+  }).join("");
+  return {
+    content: retContent,
+    inline
+  };
+}
+
+// src/lib/strings/name.js
+function parseFullName(name) {
+  const parts = name.trim().split(/\s+/);
+  if (parts.length === 1) {
+    return { firstName: parts[0], middleName: "", lastName: "" };
+  }
+  if (parts.length === 2) {
+    return { firstName: parts[0], middleName: "", lastName: parts[1] };
+  }
+  if (parts.length === 3) {
+    const firstName2 = parts.slice(0, 2).join(" ");
+    const lastName2 = parts[2];
+    return { firstName: firstName2, middleName: "", lastName: lastName2 };
+  }
+  const firstName = parts.slice(0, 2).join(" ");
+  const lastName = parts[parts.length - 1];
+  const middleName = parts.slice(2, -1).join(" ");
+  return { firstName, middleName, lastName };
+}
+
+// src/lib/strings/pluralize.js
+import pluralizeLib from "pluralize";
+var pluralize = pluralizeLib;
+
+// src/lib/strings/query-string.js
+function toQueryString(object) {
+  const searchParams = new URLSearchParams(object);
+  return searchParams.toString();
+}
+function plural(count, noun, suffix = "s") {
+  console.warn("plural is deprecated. Use pluralize instead");
+  return `${count} ${noun}${count !== 1 ? suffix : ""}`;
+}
+function stripNumbers(string) {
+  return string.replace(/\d*/, "");
+}
+export {
+  markdown,
+  parseFullName,
+  plural,
+  pluralize,
+  stripNumbers,
+  toCamel,
+  toKebab,
+  toLower,
+  toPascal,
+  toQueryString,
+  toSentence,
+  toSlug,
+  toTitle,
+  toUpper,
+  treatMarkdownWhitespace
+};

package/dist/esm/lib/strings/markdown.js

@@ -0,0 +1,34 @@
+// src/lib/strings/markdown.js
+import { marked } from "marked";
+import { gfmHeadingId } from "marked-gfm-heading-id";
+import { mangle } from "marked-mangle";
+function markdown(content, options = {}) {
+  const defaultOptions = { inline: false };
+  const opts = { ...defaultOptions, ...options };
+  marked.use(mangle());
+  marked.use(gfmHeadingId());
+  const { content: treated } = treatMarkdownWhitespace(content, opts);
+  return marked.parse(treated);
+}
+function treatMarkdownWhitespace(content, { inline } = {}) {
+  if (!content) return { content: "", inline };
+  const lines = content.split("\n");
+  if (lines[0] !== "" && inline) return { content, inline: true };
+  const firstLineWithLeadingSpacesIndex = lines.findIndex(
+    (line) => line.match(/^\s+/)
+  );
+  const firstLineWithLeadingSpaces = lines[firstLineWithLeadingSpacesIndex];
+  const indentation = firstLineWithLeadingSpaces?.match(/^\s+/)?.[0]?.length ?? 0;
+  const retContent = lines.map((line, index) => {
+    if (index < firstLineWithLeadingSpacesIndex) return line + "\n";
+    return line.slice(indentation) + "\n";
+  }).join("");
+  return {
+    content: retContent,
+    inline
+  };
+}
+export {
+  markdown,
+  treatMarkdownWhitespace
+};

package/dist/esm/lib/strings/name.js

@@ -0,0 +1,22 @@
+// src/lib/strings/name.js
+function parseFullName(name) {
+  const parts = name.trim().split(/\s+/);
+  if (parts.length === 1) {
+    return { firstName: parts[0], middleName: "", lastName: "" };
+  }
+  if (parts.length === 2) {
+    return { firstName: parts[0], middleName: "", lastName: parts[1] };
+  }
+  if (parts.length === 3) {
+    const firstName2 = parts.slice(0, 2).join(" ");
+    const lastName2 = parts[2];
+    return { firstName: firstName2, middleName: "", lastName: lastName2 };
+  }
+  const firstName = parts.slice(0, 2).join(" ");
+  const lastName = parts[parts.length - 1];
+  const middleName = parts.slice(2, -1).join(" ");
+  return { firstName, middleName, lastName };
+}
+export {
+  parseFullName
+};

package/dist/esm/lib/strings/pluralize.js

@@ -0,0 +1,6 @@
+// src/lib/strings/pluralize.js
+import pluralizeLib from "pluralize";
+var pluralize = pluralizeLib;
+export {
+  pluralize
+};

package/dist/esm/lib/strings/query-string.js

@@ -0,0 +1,17 @@
+// src/lib/strings/query-string.js
+function toQueryString(object) {
+  const searchParams = new URLSearchParams(object);
+  return searchParams.toString();
+}
+function plural(count, noun, suffix = "s") {
+  console.warn("plural is deprecated. Use pluralize instead");
+  return `${count} ${noun}${count !== 1 ? suffix : ""}`;
+}
+function stripNumbers(string) {
+  return string.replace(/\d*/, "");
+}
+export {
+  plural,
+  stripNumbers,
+  toQueryString
+};

package/dist/esm/lib/style/index.js

@@ -0,0 +1,38 @@
+// src/lib/strings/convert-case/convert-case.js
+function toKebab(string) {
+  if (!string) return "";
+  return string.split("").map((letter, index) => {
+    const previousLetter = string[index - 1] || "";
+    const currentLetter = letter;
+    if (isDigit(currentLetter) && !isDigit(previousLetter)) {
+      return `-${currentLetter}`;
+    }
+    if (!isCaps(currentLetter)) return currentLetter;
+    if (previousLetter === "") {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    if (isCaps(previousLetter)) {
+      return `${currentLetter.toLowerCase()}`;
+    }
+    return `-${currentLetter.toLowerCase()}`;
+  }).join("").trim().replace(/[-_\s]+/g, "-");
+}
+function isCaps(char) {
+  return /\p{Lu}/u.test(char);
+}
+function isDigit(char) {
+  return /[0-9]/.test(char);
+}
+
+// src/lib/style/index.js
+function toStyleString(style) {
+  if (!style) return null;
+  if (typeof style === "string") return style;
+  return Object.entries(style).map(([k, v]) => {
+    if (k.startsWith("--")) return `${k}:${v}`;
+    else return `${toKebab(k)}:${v}`;
+  }).join("; ").concat(";");
+}
+export {
+  toStyleString
+};

package/dist/esm/lib/symbols/index.js

@@ -0,0 +1,13 @@
+// src/lib/symbols/symbols.js
+function getSymbol(object, description) {
+  return Object.getOwnPropertySymbols(object).find(
+    (s) => s.description === description
+  );
+}
+function getSymbolValue(object, description) {
+  return object[getSymbol(object, description)];
+}
+export {
+  getSymbol,
+  getSymbolValue
+};

package/dist/esm/lib/symbols/symbols.js

@@ -0,0 +1,13 @@
+// src/lib/symbols/symbols.js
+function getSymbol(object, description) {
+  return Object.getOwnPropertySymbols(object).find(
+    (s) => s.description === description
+  );
+}
+function getSymbolValue(object, description) {
+  return object[getSymbol(object, description)];
+}
+export {
+  getSymbol,
+  getSymbolValue
+};

package/dist/esm/node/common.js

@@ -0,0 +1,8 @@
+// src/node/common.js
+import crypto from "crypto";
+function uuid() {
+  return crypto.randomUUID();
+}
+export {
+  uuid
+};