@ls-stack/utils 3.63.0 → 3.66.0

package/dist/runShellCmd.d.cts

@@ -1,90 +0,0 @@
-type CmdResult = {
-    label: string | null;
-    out: string;
-    error: boolean;
-    stdout: string;
-    stderr: string;
-};
-type RunCmdOptions = {
-    mock?: CmdResult;
-    silent?: boolean | 'timeOnly';
-    cwd?: string;
-    throwOnError?: boolean;
-    noCiColorForce?: boolean;
-};
-/**
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please
- *   update your imports:
- *
- *       // Old (deprecated)
- *       import { runCmd } from '@ls-stack/utils/runShellCmd';
- *
- *       // New (preferred)
- *       import { runCmd } from '@ls-stack/node-utils/runShellCmd';
- * @param label
- * @param command
- * @param root0
- * @param root0.mock
- * @param root0.silent
- * @param root0.throwOnError
- * @param root0.cwd
- * @param root0.noCiColorForce
- */
-declare function runCmd(label: string | null, command: string | string[], { mock, silent, throwOnError, cwd, noCiColorForce, }?: RunCmdOptions): Promise<CmdResult>;
-/**
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please
- *   update your imports:
- *
- *       // Old (deprecated)
- *       import { concurrentCmd } from '@ls-stack/utils/runShellCmd';
- *
- *       // New (preferred)
- *       import { concurrentCmd } from '@ls-stack/node-utils/runShellCmd';
- * @param label
- * @param cmd
- * @param onResult
- */
-declare function concurrentCmd(label: string, cmd: string | string[], onResult: (result: CmdResult) => void): Promise<() => void>;
-/**
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please
- *   update your imports:
- *
- *       // Old (deprecated)
- *       import { runCmdUnwrap } from '@ls-stack/utils/runShellCmd';
- *
- *       // New (preferred)
- *       import { runCmdUnwrap } from '@ls-stack/node-utils/runShellCmd';
- * @param label
- * @param command
- * @param root0
- * @param root0.silent
- */
-declare function runCmdUnwrap(label: string | null, command: string | string[], { silent, }?: {
-    silent?: boolean | 'timeOnly';
-}): Promise<string>;
-/**
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please
- *   update your imports:
- *
- *       // Old (deprecated)
- *       import { runCmdSilent } from '@ls-stack/utils/runShellCmd';
- *
- *       // New (preferred)
- *       import { runCmdSilent } from '@ls-stack/node-utils/runShellCmd';
- * @param command
- */
-declare function runCmdSilent(command: string | string[]): Promise<CmdResult>;
-/**
- * @deprecated This utility has been moved to @ls-stack/node-utils. Please
- *   update your imports:
- *
- *       // Old (deprecated)
- *       import { runCmdSilentUnwrap } from '@ls-stack/utils/runShellCmd';
- *
- *       // New (preferred)
- *       import { runCmdSilentUnwrap } from '@ls-stack/node-utils/runShellCmd';
- * @param command
- */
-declare function runCmdSilentUnwrap(command: string | string[]): Promise<string>;
-
-export { concurrentCmd, runCmd, runCmdSilent, runCmdSilentUnwrap, runCmdUnwrap };

package/dist/runShellCmd.js

@@ -1,98 +0,0 @@
-// src/runShellCmd.ts
-import { spawn } from "child_process";
-function runCmd(label, command, {
-  mock,
-  silent,
-  throwOnError,
-  cwd = process.cwd(),
-  noCiColorForce
-} = {}) {
-  if (mock) return Promise.resolve(mock);
-  if (label && (!silent || silent === "timeOnly")) {
-    console.log(`----${label}----`);
-    console.time("\u2705");
-  }
-  return new Promise((resolve) => {
-    const [cmd = "", ...args] = Array.isArray(command) ? command.flatMap(
-      (item) => item.startsWith("$") ? item.replace("$", "").split(" ") : item
-    ) : command.split(" ");
-    const child = spawn(cmd, args, {
-      cwd,
-      env: noCiColorForce ? void 0 : { ...process.env, CLICOLOR_FORCE: "1" }
-    });
-    let stdout = "";
-    let stderr = "";
-    let out = "";
-    child.stdout.on("data", (data) => {
-      stdout += String(data);
-      out += String(data);
-      if (!silent) {
-        console.log(String(data));
-      }
-    });
-    child.stderr.on("data", (data) => {
-      stderr += String(data);
-      out += String(data);
-      if (!silent) {
-        console.log(String(data));
-      }
-    });
-    child.on("close", (code) => {
-      const hasError = code !== 0;
-      if (!silent || silent === "timeOnly") {
-        if (!hasError) {
-          console.timeEnd("\u2705");
-        }
-        console.log("\n");
-      }
-      if (throwOnError && hasError) {
-        if (silent) {
-          if (label) {
-            console.log(`----${label}----`);
-          } else {
-            console.trace();
-          }
-          console.error(stderr);
-        }
-        process.exit(1);
-      }
-      resolve({ label, out, stderr, stdout, error: hasError });
-    });
-  });
-}
-async function concurrentCmd(label, cmd, onResult) {
-  const start = Date.now();
-  const result = await runCmd(label, cmd, { silent: true });
-  onResult(result);
-  const elapsedSeconds = (Date.now() - start) / 1e3;
-  console.log(
-    `${result.error ? "\u{1F534}" : "\u2705"} ${result.label} (${elapsedSeconds.toFixed(
-      1
-    )}s)`
-  );
-  return () => {
-    if (result.error) {
-      console.log(`\u274C ${result.label} errors:`);
-      console.log(result.out);
-      console.log("\n");
-    }
-  };
-}
-async function runCmdUnwrap(label, command, {
-  silent
-} = {}) {
-  return (await runCmd(label, command, { silent, throwOnError: true })).stdout;
-}
-function runCmdSilent(command) {
-  return runCmd(null, command, { silent: true });
-}
-function runCmdSilentUnwrap(command) {
-  return runCmdUnwrap(null, command, { silent: true });
-}
-export {
-  concurrentCmd,
-  runCmd,
-  runCmdSilent,
-  runCmdSilentUnwrap,
-  runCmdUnwrap
-};

package/dist/safeJson.cjs

@@ -1,45 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/safeJson.ts
-var safeJson_exports = {};
-__export(safeJson_exports, {
-  safeJsonParse: () => safeJsonParse,
-  safeJsonStringify: () => safeJsonStringify
-});
-module.exports = __toCommonJS(safeJson_exports);
-function safeJsonStringify(value) {
-  try {
-    return JSON.stringify(value);
-  } catch (_) {
-    return void 0;
-  }
-}
-function safeJsonParse(value) {
-  try {
-    return JSON.parse(value);
-  } catch (_) {
-    return void 0;
-  }
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  safeJsonParse,
-  safeJsonStringify
-});

package/dist/safeJson.d.ts

@@ -1,16 +0,0 @@
-/**
- * JSON.stringify can throw if the value is circular or contains functions, this
- * function catches those errors and returns undefined
- *
- * @param value
- */
-declare function safeJsonStringify(value: unknown): string | undefined;
-/**
- * JSON.parse can throw if the value is not valid JSON, this function catches
- * those errors and returns undefined
- *
- * @param value
- */
-declare function safeJsonParse(value: string): unknown;
-
-export { safeJsonParse, safeJsonStringify };

package/dist/safeJson.js

@@ -1,8 +0,0 @@
-import {
-  safeJsonParse,
-  safeJsonStringify
-} from "./chunk-VAAMRG4K.js";
-export {
-  safeJsonParse,
-  safeJsonStringify
-};

package/dist/saferTyping.cjs

@@ -1,52 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/saferTyping.ts
-var saferTyping_exports = {};
-__export(saferTyping_exports, {
-  __FIX_THIS_CASTING__: () => __FIX_THIS_CASTING__,
-  __FIX_THIS_TYPING__: () => __FIX_THIS_TYPING__,
-  __LEGIT_ANY_CAST__: () => __LEGIT_ANY_CAST__,
-  __LEGIT_CAST__: () => __LEGIT_CAST__,
-  __REFINE_CAST__: () => __REFINE_CAST__
-});
-module.exports = __toCommonJS(saferTyping_exports);
-function __LEGIT_ANY_CAST__(value) {
-  return value;
-}
-function __LEGIT_CAST__(value) {
-  return value;
-}
-function __REFINE_CAST__(value) {
-  return () => value;
-}
-function __FIX_THIS_CASTING__(value) {
-  return value;
-}
-function __FIX_THIS_TYPING__(value) {
-  return value;
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  __FIX_THIS_CASTING__,
-  __FIX_THIS_TYPING__,
-  __LEGIT_ANY_CAST__,
-  __LEGIT_CAST__,
-  __REFINE_CAST__
-});

package/dist/saferTyping.d.ts

@@ -1,47 +0,0 @@
-/**
- * Use this only when you have 100% of certainty that this will not break the
- * types
- */
-type __LEGIT_ANY__ = any;
-type __LEGIT_ANY_FUNCTION__ = (...params: any) => __LEGIT_ANY__;
-/** An empty object type, equivalent to `{}` but with safer typing */
-type EmptyObject = Record<string, never>;
-/**
- * Cast a value to `any` type. Use this when you have legit usage of `any`
- * casting.
- *
- * @template V (optional) - When used enforces that the casted value is
- *   assignable to the type V, use it for safer casts
- * @param value
- */
-declare function __LEGIT_ANY_CAST__<V = unknown>(value: V): __LEGIT_ANY__;
-/**
- * Cast a value to a specific type T. Use this when you have legit usage of type
- * assertion.
- *
- * @template T - The type to cast to
- * @template V (optional) - When used enforces that the casted value is
- *   assignable to the type V, use it for safer casts
- * @param value
- */
-declare function __LEGIT_CAST__<T, V = unknown>(value: V): T;
-/**
- * Refine a value to a specific type T. Use this when you have legit usage of
- * type assertion.
- *
- * @template T - The type to cast to
- * @template V (optional) - When used enforces that the casted value is
- *   assignable to the type V, use it for safer casts
- * @param value
- */
-declare function __REFINE_CAST__<T>(value: T): <R extends T>() => R;
-declare function __FIX_THIS_CASTING__<T>(value: unknown): T;
-type __FIX_THIS_TYPING__ = any;
-declare function __FIX_THIS_TYPING__(value: unknown): __LEGIT_ANY__;
-/**
- * Any type that is not a primitive (number, string, boolean, null, undefined,
- * symbol, bigint, ...) Equivalent to `object` type
- */
-type AnyNonPrimitiveValue = object;
-
-export { type AnyNonPrimitiveValue, type EmptyObject, __FIX_THIS_CASTING__, __FIX_THIS_TYPING__, __LEGIT_ANY_CAST__, type __LEGIT_ANY_FUNCTION__, type __LEGIT_ANY__, __LEGIT_CAST__, __REFINE_CAST__ };

package/dist/saferTyping.js

@@ -1,23 +0,0 @@
-// src/saferTyping.ts
-function __LEGIT_ANY_CAST__(value) {
-  return value;
-}
-function __LEGIT_CAST__(value) {
-  return value;
-}
-function __REFINE_CAST__(value) {
-  return () => value;
-}
-function __FIX_THIS_CASTING__(value) {
-  return value;
-}
-function __FIX_THIS_TYPING__(value) {
-  return value;
-}
-export {
-  __FIX_THIS_CASTING__,
-  __FIX_THIS_TYPING__,
-  __LEGIT_ANY_CAST__,
-  __LEGIT_CAST__,
-  __REFINE_CAST__
-};

package/dist/serializeXML.cjs

@@ -1,154 +0,0 @@
-"use strict";
-var __defProp = Object.defineProperty;
-var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
-var __getOwnPropNames = Object.getOwnPropertyNames;
-var __hasOwnProp = Object.prototype.hasOwnProperty;
-var __export = (target, all) => {
-  for (var name in all)
-    __defProp(target, name, { get: all[name], enumerable: true });
-};
-var __copyProps = (to, from, except, desc) => {
-  if (from && typeof from === "object" || typeof from === "function") {
-    for (let key of __getOwnPropNames(from))
-      if (!__hasOwnProp.call(to, key) && key !== except)
-        __defProp(to, key, { get: () => from[key], enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable });
-  }
-  return to;
-};
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
-
-// src/serializeXML.ts
-var serializeXML_exports = {};
-__export(serializeXML_exports, {
-  serializeXML: () => serializeXML
-});
-module.exports = __toCommonJS(serializeXML_exports);
-
-// src/typeGuards.ts
-function isTruthy(value) {
-  return !!value;
-}
-
-// src/arrayUtils.ts
-function filterAndMap(array, mapFilter) {
-  const result = [];
-  let i = -1;
-  for (const item of array) {
-    i += 1;
-    const filterResult = mapFilter(item, i);
-    if (filterResult !== false) {
-      result.push(filterResult);
-    }
-  }
-  return result;
-}
-
-// src/serializeXML.ts
-var XML_TAG_NAME_REGEX = /^[a-zA-Z_][a-zA-Z0-9._-]*$/;
-var XML_PREFIX_REGEX = /^xml/i;
-var XML_ESCAPE_MAP = {
-  "&": "&",
-  "<": "&lt;",
-  ">": "&gt;",
-  '"': "&quot;",
-  "'": "&#39;"
-};
-var XML_ESCAPE_REGEX = /[&<>"']/g;
-function serializeXML(node, options) {
-  if (Array.isArray(node)) {
-    const EMPTY_LINE_MARKER = "\0EMPTY_LINE\0";
-    return node.filter(isTruthy).map((n) => {
-      if (n.type === "emptyLine") {
-        return EMPTY_LINE_MARKER;
-      }
-      return serializeWithLevel(n, options, 0);
-    }).filter(isTruthy).join(options?.indent ? "\n" : "").replace(new RegExp(EMPTY_LINE_MARKER, "g"), "");
-  }
-  return serializeWithLevel(node, options, 0);
-}
-function serializeWithLevel(node, options = {}, level) {
-  const {
-    indent,
-    escapeText: globalEscapeText = false,
-    validateTagName = true,
-    invalidNodes = "throw"
-  } = options;
-  const indentStr = indent ? getIndentString(indent, level) : "";
-  const newline = indent ? "\n" : "";
-  if (node.type === "comment") {
-    const shouldEscapeText2 = node.escapeText !== void 0 ? node.escapeText : globalEscapeText;
-    const content = shouldEscapeText2 ? escapeXml(node.content) : node.content;
-    return `${indentStr}<!-- ${content} -->`;
-  }
-  if (node.type === "emptyLine") {
-    return "";
-  }
-  const {
-    name,
-    attrs: attributes = {},
-    children,
-    escapeText: nodeEscapeText
-  } = node;
-  const shouldEscapeText = nodeEscapeText !== void 0 ? nodeEscapeText : globalEscapeText;
-  if (validateTagName && !isValidXmlTagName(name)) {
-    if (invalidNodes === "throw") {
-      throw new Error(`Invalid XML tag name: "${name}"`);
-    }
-    return "";
-  }
-  const attributesStr = filterAndMap(
-    Object.entries(attributes),
-    ([key, value]) => value !== null && value !== void 0 ? `${key}="${escapeXml(String(value))}"` : false
-  ).join(" ");
-  const attributesPart = attributesStr ? ` ${attributesStr}` : "";
-  if (children === void 0) {
-    return `${indentStr}<${name}${attributesPart} />`;
-  }
-  if (typeof children === "string") {
-    const processedText = shouldEscapeText ? escapeXml(children) : children;
-    if (processedText.includes("\n") && indent) {
-      const lines = processedText.split("\n");
-      const contentIndent = getIndentString(indent, level + 1);
-      const indentedLines = lines.map((line, index) => {
-        if (line.trim() === "") return "";
-        return index === 0 ? line : contentIndent + line;
-      });
-      const indentedText = indentedLines.join("\n");
-      return `${indentStr}<${name}${attributesPart}>
-${contentIndent}${indentedText}
-${indentStr}</${name}>`;
-    }
-    return `${indentStr}<${name}${attributesPart}>${processedText}</${name}>`;
-  }
-  if (children.length === 0) {
-    return `${indentStr}<${name}${attributesPart}></${name}>`;
-  }
-  const serializedChildren = filterAndMap(children, (child) => {
-    if (!child) return false;
-    const serializedChild = serializeWithLevel(child, options, level + 1);
-    return serializedChild || false;
-  });
-  if (serializedChildren.length === 0) {
-    return `${indentStr}<${name}${attributesPart}></${name}>`;
-  }
-  const childrenStr = serializedChildren.join(newline);
-  return `${indentStr}<${name}${attributesPart}>${newline}${childrenStr}${newline}${indentStr}</${name}>`;
-}
-function getIndentString(indent, level) {
-  if (typeof indent === "string") {
-    return indent.repeat(level);
-  }
-  return " ".repeat(indent * level);
-}
-function isValidXmlTagName(name) {
-  if (!name) return false;
-  if (XML_PREFIX_REGEX.test(name)) return false;
-  return XML_TAG_NAME_REGEX.test(name);
-}
-function escapeXml(text) {
-  return text.replace(XML_ESCAPE_REGEX, (char) => XML_ESCAPE_MAP[char]);
-}
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  serializeXML
-});

package/dist/serializeXML.d.cts

@@ -1,22 +0,0 @@
-type XMLNode = {
-    type?: 'node';
-    name: string;
-    attrs?: Record<string, string | number | boolean | null | undefined>;
-    children?: (XMLNode | null | undefined | false)[] | string;
-    escapeText?: boolean;
-} | {
-    type: 'comment';
-    content: string;
-    escapeText?: boolean;
-} | {
-    type: 'emptyLine';
-};
-type SerializeOptions = {
-    indent?: number | string;
-    escapeText?: boolean;
-    validateTagName?: boolean;
-    invalidNodes?: 'throw' | 'reject';
-};
-declare function serializeXML(node: XMLNode | (XMLNode | null | undefined | false)[], options?: SerializeOptions): string;
-
-export { type SerializeOptions, type XMLNode, serializeXML };

package/dist/serializeXML.d.ts

@@ -1,22 +0,0 @@
-type XMLNode = {
-    type?: 'node';
-    name: string;
-    attrs?: Record<string, string | number | boolean | null | undefined>;
-    children?: (XMLNode | null | undefined | false)[] | string;
-    escapeText?: boolean;
-} | {
-    type: 'comment';
-    content: string;
-    escapeText?: boolean;
-} | {
-    type: 'emptyLine';
-};
-type SerializeOptions = {
-    indent?: number | string;
-    escapeText?: boolean;
-    validateTagName?: boolean;
-    invalidNodes?: 'throw' | 'reject';
-};
-declare function serializeXML(node: XMLNode | (XMLNode | null | undefined | false)[], options?: SerializeOptions): string;
-
-export { type SerializeOptions, type XMLNode, serializeXML };