@settlemint/sdk-utils 2.3.2-pr6cb5dd2e → 2.3.2-pr74f654b5

package/dist/package-manager.js

@@ -0,0 +1,9 @@
+import { getPackageManager } from "./package-manager/get-package-manager.js";
+import { getPackageManagerExecutable } from "./package-manager/get-package-manager-executable.js";
+import { installDependencies } from "./package-manager/install-dependencies.js";
+import { isPackageInstalled } from "./package-manager/is-package-installed.js";
+import { setName } from "./package-manager/set-name.js";
+
+export * from "./package-manager/download-and-extract.js"
+
+export { getPackageManager, getPackageManagerExecutable, installDependencies, isPackageInstalled, setName };

package/dist/retry.cjs

@@ -0,0 +1,69 @@
+//#region rolldown:runtime
+var __create = Object.create;
+var __defProp = Object.defineProperty;
+var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
+var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
+var __hasOwnProp = Object.prototype.hasOwnProperty;
+var __copyProps = (to, from, except, desc) => {
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
+};
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
+
+//#endregion
+const src_logging_logger_js = __toESM(require("./logging/logger.js"));
+
+//#region src/retry.ts
+/**
+* Retry a function when it fails.
+* @param fn - The function to retry.
+* @param maxRetries - The maximum number of retries.
+* @param initialSleepTime - The initial time to sleep between exponential backoff retries.
+* @param stopOnError - The function to stop on error.
+* @returns The result of the function or undefined if it fails.
+* @example
+* import { retryWhenFailed } from "@settlemint/sdk-utils";
+* import { readFile } from "node:fs/promises";
+*
+* const result = await retryWhenFailed(() => readFile("/path/to/file.txt"), 3, 1_000);
+*/
+async function retryWhenFailed(fn, maxRetries = 5, initialSleepTime = 1e3, stopOnError) {
+	let retries = 0;
+	const maxAttempts = maxRetries + 1;
+	while (retries < maxAttempts) {
+		try {
+			return await fn();
+		} catch (e) {
+			const error = e;
+			if (typeof stopOnError === "function") {
+				if (stopOnError(error)) {
+					throw error;
+				}
+			}
+			if (retries >= maxRetries) {
+				throw e;
+			}
+			const baseDelay = 2 ** retries * initialSleepTime;
+			const jitterAmount = initialSleepTime * (Math.random() / 10);
+			const delay = baseDelay + jitterAmount;
+			retries += 1;
+			src_logging_logger_js.logger.warn(`An error occurred ${error.message}, retrying in ${delay.toFixed(0)}ms (retry ${retries} of ${maxRetries})...`);
+			await new Promise((resolve) => setTimeout(resolve, delay));
+		}
+	}
+	throw new Error("Retry failed");
+}
+
+//#endregion
+exports.retryWhenFailed = retryWhenFailed;
+//# sourceMappingURL=retry.cjs.map

package/dist/retry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.cjs","names":["fn: () => Promise<T>","stopOnError?: (error: Error) => boolean"],"sources":["../src/retry.ts"],"sourcesContent":["import { logger } from \"./logging/logger.js\";\n\n/**\n * Retry a function when it fails.\n * @param fn - The function to retry.\n * @param maxRetries - The maximum number of retries.\n * @param initialSleepTime - The initial time to sleep between exponential backoff retries.\n * @param stopOnError - The function to stop on error.\n * @returns The result of the function or undefined if it fails.\n * @example\n * import { retryWhenFailed } from \"@settlemint/sdk-utils\";\n * import { readFile } from \"node:fs/promises\";\n *\n * const result = await retryWhenFailed(() => readFile(\"/path/to/file.txt\"), 3, 1_000);\n */\nexport async function retryWhenFailed<T>(\n  fn: () => Promise<T>,\n  maxRetries = 5,\n  initialSleepTime = 1_000,\n  stopOnError?: (error: Error) => boolean,\n): Promise<T> {\n  let retries = 0;\n  const maxAttempts = maxRetries + 1;\n\n  while (retries < maxAttempts) {\n    try {\n      return await fn();\n    } catch (e) {\n      const error = e as Error;\n      if (typeof stopOnError === \"function\") {\n        if (stopOnError(error)) {\n          throw error;\n        }\n      }\n      if (retries >= maxRetries) {\n        throw e;\n      }\n      // Exponential backoff with jitter to prevent thundering herd\n      // Jitter: Random value between 0-10% of initialSleepTime\n      const baseDelay = 2 ** retries * initialSleepTime;\n      const jitterAmount = initialSleepTime * (Math.random() / 10);\n      const delay = baseDelay + jitterAmount;\n      retries += 1;\n      logger.warn(\n        `An error occurred ${error.message}, retrying in ${delay.toFixed(0)}ms (retry ${retries} of ${maxRetries})...`,\n      );\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n\n  throw new Error(\"Retry failed\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAeA,eAAsB,gBACpBA,IACA,aAAa,GACb,mBAAmB,KACnBC,aACY;CACZ,IAAI,UAAU;CACd,MAAM,cAAc,aAAa;AAEjC,QAAO,UAAU,aAAa;AAC5B,MAAI;AACF,UAAO,MAAM,IAAI;EAClB,SAAQ,GAAG;GACV,MAAM,QAAQ;AACd,cAAW,gBAAgB,YAAY;AACrC,QAAI,YAAY,MAAM,EAAE;AACtB,WAAM;IACP;GACF;AACD,OAAI,WAAW,YAAY;AACzB,UAAM;GACP;GAGD,MAAM,YAAY,KAAK,UAAU;GACjC,MAAM,eAAe,oBAAoB,KAAK,QAAQ,GAAG;GACzD,MAAM,QAAQ,YAAY;AAC1B,cAAW;AACX,gCAAO,MACJ,oBAAoB,MAAM,QAAQ,gBAAgB,MAAM,QAAQ,EAAE,CAAC,YAAY,QAAQ,MAAM,WAAW,MAC1G;AACD,SAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,MAAM;EAC1D;CACF;AAED,OAAM,IAAI,MAAM;AACjB"}

package/dist/retry.d.cts

@@ -0,0 +1,19 @@
+//#region src/retry.d.ts
+/**
+ * Retry a function when it fails.
+ * @param fn - The function to retry.
+ * @param maxRetries - The maximum number of retries.
+ * @param initialSleepTime - The initial time to sleep between exponential backoff retries.
+ * @param stopOnError - The function to stop on error.
+ * @returns The result of the function or undefined if it fails.
+ * @example
+ * import { retryWhenFailed } from "@settlemint/sdk-utils";
+ * import { readFile } from "node:fs/promises";
+ *
+ * const result = await retryWhenFailed(() => readFile("/path/to/file.txt"), 3, 1_000);
+ */
+declare function retryWhenFailed<T>(fn: () => Promise<T>, maxRetries?: number, initialSleepTime?: number, stopOnError?: (error: Error) => boolean): Promise<T>;
+
+//#endregion
+export { retryWhenFailed };
+//# sourceMappingURL=retry.d.cts.map

package/dist/retry.d.ts

@@ -0,0 +1,19 @@
+//#region src/retry.d.ts
+/**
+ * Retry a function when it fails.
+ * @param fn - The function to retry.
+ * @param maxRetries - The maximum number of retries.
+ * @param initialSleepTime - The initial time to sleep between exponential backoff retries.
+ * @param stopOnError - The function to stop on error.
+ * @returns The result of the function or undefined if it fails.
+ * @example
+ * import { retryWhenFailed } from "@settlemint/sdk-utils";
+ * import { readFile } from "node:fs/promises";
+ *
+ * const result = await retryWhenFailed(() => readFile("/path/to/file.txt"), 3, 1_000);
+ */
+declare function retryWhenFailed<T>(fn: () => Promise<T>, maxRetries?: number, initialSleepTime?: number, stopOnError?: (error: Error) => boolean): Promise<T>;
+
+//#endregion
+export { retryWhenFailed };
+//# sourceMappingURL=retry.d.ts.map

package/dist/retry.js

@@ -0,0 +1,46 @@
+import { logger } from "./logging/logger.js";
+
+//#region src/retry.ts
+/**
+* Retry a function when it fails.
+* @param fn - The function to retry.
+* @param maxRetries - The maximum number of retries.
+* @param initialSleepTime - The initial time to sleep between exponential backoff retries.
+* @param stopOnError - The function to stop on error.
+* @returns The result of the function or undefined if it fails.
+* @example
+* import { retryWhenFailed } from "@settlemint/sdk-utils";
+* import { readFile } from "node:fs/promises";
+*
+* const result = await retryWhenFailed(() => readFile("/path/to/file.txt"), 3, 1_000);
+*/
+async function retryWhenFailed(fn, maxRetries = 5, initialSleepTime = 1e3, stopOnError) {
+	let retries = 0;
+	const maxAttempts = maxRetries + 1;
+	while (retries < maxAttempts) {
+		try {
+			return await fn();
+		} catch (e) {
+			const error = e;
+			if (typeof stopOnError === "function") {
+				if (stopOnError(error)) {
+					throw error;
+				}
+			}
+			if (retries >= maxRetries) {
+				throw e;
+			}
+			const baseDelay = 2 ** retries * initialSleepTime;
+			const jitterAmount = initialSleepTime * (Math.random() / 10);
+			const delay = baseDelay + jitterAmount;
+			retries += 1;
+			logger.warn(`An error occurred ${error.message}, retrying in ${delay.toFixed(0)}ms (retry ${retries} of ${maxRetries})...`);
+			await new Promise((resolve) => setTimeout(resolve, delay));
+		}
+	}
+	throw new Error("Retry failed");
+}
+
+//#endregion
+export { retryWhenFailed };
+//# sourceMappingURL=retry.js.map

package/dist/retry.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.js","names":["fn: () => Promise<T>","stopOnError?: (error: Error) => boolean"],"sources":["../src/retry.ts"],"sourcesContent":["import { logger } from \"./logging/logger.js\";\n\n/**\n * Retry a function when it fails.\n * @param fn - The function to retry.\n * @param maxRetries - The maximum number of retries.\n * @param initialSleepTime - The initial time to sleep between exponential backoff retries.\n * @param stopOnError - The function to stop on error.\n * @returns The result of the function or undefined if it fails.\n * @example\n * import { retryWhenFailed } from \"@settlemint/sdk-utils\";\n * import { readFile } from \"node:fs/promises\";\n *\n * const result = await retryWhenFailed(() => readFile(\"/path/to/file.txt\"), 3, 1_000);\n */\nexport async function retryWhenFailed<T>(\n  fn: () => Promise<T>,\n  maxRetries = 5,\n  initialSleepTime = 1_000,\n  stopOnError?: (error: Error) => boolean,\n): Promise<T> {\n  let retries = 0;\n  const maxAttempts = maxRetries + 1;\n\n  while (retries < maxAttempts) {\n    try {\n      return await fn();\n    } catch (e) {\n      const error = e as Error;\n      if (typeof stopOnError === \"function\") {\n        if (stopOnError(error)) {\n          throw error;\n        }\n      }\n      if (retries >= maxRetries) {\n        throw e;\n      }\n      // Exponential backoff with jitter to prevent thundering herd\n      // Jitter: Random value between 0-10% of initialSleepTime\n      const baseDelay = 2 ** retries * initialSleepTime;\n      const jitterAmount = initialSleepTime * (Math.random() / 10);\n      const delay = baseDelay + jitterAmount;\n      retries += 1;\n      logger.warn(\n        `An error occurred ${error.message}, retrying in ${delay.toFixed(0)}ms (retry ${retries} of ${maxRetries})...`,\n      );\n      await new Promise((resolve) => setTimeout(resolve, delay));\n    }\n  }\n\n  throw new Error(\"Retry failed\");\n}\n"],"mappings":";;;;;;;;;;;;;;;;AAeA,eAAsB,gBACpBA,IACA,aAAa,GACb,mBAAmB,KACnBC,aACY;CACZ,IAAI,UAAU;CACd,MAAM,cAAc,aAAa;AAEjC,QAAO,UAAU,aAAa;AAC5B,MAAI;AACF,UAAO,MAAM,IAAI;EAClB,SAAQ,GAAG;GACV,MAAM,QAAQ;AACd,cAAW,gBAAgB,YAAY;AACrC,QAAI,YAAY,MAAM,EAAE;AACtB,WAAM;IACP;GACF;AACD,OAAI,WAAW,YAAY;AACzB,UAAM;GACP;GAGD,MAAM,YAAY,KAAK,UAAU;GACjC,MAAM,eAAe,oBAAoB,KAAK,QAAQ,GAAG;GACzD,MAAM,QAAQ,YAAY;AAC1B,cAAW;AACX,UAAO,MACJ,oBAAoB,MAAM,QAAQ,gBAAgB,MAAM,QAAQ,EAAE,CAAC,YAAY,QAAQ,MAAM,WAAW,MAC1G;AACD,SAAM,IAAI,QAAQ,CAAC,YAAY,WAAW,SAAS,MAAM;EAC1D;CACF;AAED,OAAM,IAAI,MAAM;AACjB"}

package/dist/runtime.cjs

@@ -1,53 +1,49 @@
-"use strict";
+//#region rolldown:runtime
+var __create = Object.create;
 var __defProp = Object.defineProperty;
 var __getOwnPropDesc = Object.getOwnPropertyDescriptor;
 var __getOwnPropNames = Object.getOwnPropertyNames;
+var __getProtoOf = Object.getPrototypeOf;
 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;
+	if (from && typeof from === "object" || typeof from === "function") for (var keys = __getOwnPropNames(from), i = 0, n = keys.length, key; i < n; i++) {
+		key = keys[i];
+		if (!__hasOwnProp.call(to, key) && key !== except) __defProp(to, key, {
+			get: ((k) => from[k]).bind(null, key),
+			enumerable: !(desc = __getOwnPropDesc(from, key)) || desc.enumerable
+		});
+	}
+	return to;
 };
-var __toCommonJS = (mod) => __copyProps(__defProp({}, "__esModule", { value: true }), mod);
+var __toESM = (mod, isNodeMode, target) => (target = mod != null ? __create(__getProtoOf(mod)) : {}, __copyProps(isNodeMode || !mod || !mod.__esModule ? __defProp(target, "default", {
+	value: mod,
+	enumerable: true
+}) : target, mod));
 
-// src/runtime.ts
-var runtime_exports = {};
-__export(runtime_exports, {
-  ensureBrowser: () => ensureBrowser,
-  ensureServer: () => ensureServer,
-  runsInBrowser: () => runsInBrowser,
-  runsOnServer: () => runsOnServer
-});
-module.exports = __toCommonJS(runtime_exports);
+//#endregion
+const src_runtime_ensure_server_js = __toESM(require("./runtime/ensure-server.js"));
 
-// src/runtime/ensure-server.ts
-var import_environment = require("environment");
-function ensureServer() {
-  if (import_environment.isBrowser) {
-    throw new Error(
-      "This function can only be used on the server as including it in the browser will expose your access token."
-    );
+Object.defineProperty(exports, 'ensureBrowser', {
+  enumerable: true,
+  get: function () {
+    return src_runtime_ensure_server_js.ensureBrowser;
   }
-}
-function ensureBrowser() {
-  if (!import_environment.isBrowser) {
-    throw new Error("This function can only be used on the browser as it is missing the access token.");
+});
+Object.defineProperty(exports, 'ensureServer', {
+  enumerable: true,
+  get: function () {
+    return src_runtime_ensure_server_js.ensureServer;
   }
-}
-var runsInBrowser = import_environment.isBrowser;
-var runsOnServer = !import_environment.isBrowser;
-// Annotate the CommonJS export names for ESM import in node:
-0 && (module.exports = {
-  ensureBrowser,
-  ensureServer,
-  runsInBrowser,
-  runsOnServer
 });
-//# sourceMappingURL=runtime.cjs.map
+Object.defineProperty(exports, 'runsInBrowser', {
+  enumerable: true,
+  get: function () {
+    return src_runtime_ensure_server_js.runsInBrowser;
+  }
+});
+Object.defineProperty(exports, 'runsOnServer', {
+  enumerable: true,
+  get: function () {
+    return src_runtime_ensure_server_js.runsOnServer;
+  }
+});

package/dist/runtime.d.cts

@@ -1,32 +1,2 @@
-/**
- * Ensures that code is running on the server and not in a browser environment.
- *
- * @throws {Error} If called from a browser environment
- * @example
- * import { ensureServer } from "@settlemint/sdk-utils/runtime";
- *
- * // Will throw if running in browser
- * ensureServer();
- */
-declare function ensureServer(): void;
-/**
- * Ensures that code is running in a browser environment and not on the server.
- *
- * @throws {Error} If called from a server environment
- * @example
- * import { ensureBrowser } from "@settlemint/sdk-utils/runtime";
- *
- * // Will throw if running on server
- * ensureBrowser();
- */
-declare function ensureBrowser(): void;
-/**
- * Boolean indicating if code is currently running in a browser environment
- */
-declare const runsInBrowser: boolean;
-/**
- * Boolean indicating if code is currently running in a server environment
- */
-declare const runsOnServer: boolean;
-
-export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };
+import { ensureBrowser, ensureServer, runsInBrowser, runsOnServer } from "./runtime/ensure-server.js";
+export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };

package/dist/runtime.d.ts

@@ -1,32 +1,2 @@
-/**
- * Ensures that code is running on the server and not in a browser environment.
- *
- * @throws {Error} If called from a browser environment
- * @example
- * import { ensureServer } from "@settlemint/sdk-utils/runtime";
- *
- * // Will throw if running in browser
- * ensureServer();
- */
-declare function ensureServer(): void;
-/**
- * Ensures that code is running in a browser environment and not on the server.
- *
- * @throws {Error} If called from a server environment
- * @example
- * import { ensureBrowser } from "@settlemint/sdk-utils/runtime";
- *
- * // Will throw if running on server
- * ensureBrowser();
- */
-declare function ensureBrowser(): void;
-/**
- * Boolean indicating if code is currently running in a browser environment
- */
-declare const runsInBrowser: boolean;
-/**
- * Boolean indicating if code is currently running in a server environment
- */
-declare const runsOnServer: boolean;
-
-export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };
+import { ensureBrowser, ensureServer, runsInBrowser, runsOnServer } from "./runtime/ensure-server.js";
+export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };

package/dist/runtime.js

@@ -0,0 +1,3 @@
+import { ensureBrowser, ensureServer, runsInBrowser, runsOnServer } from "./runtime/ensure-server.js";
+
+export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };

package/dist/string.cjs

@@ -0,0 +1,76 @@
+
+//#region src/string.ts
+/**
+* Capitalizes the first letter of a string.
+*
+* @param val - The string to capitalize
+* @returns The input string with its first letter capitalized
+*
+* @example
+* import { capitalizeFirstLetter } from "@settlemint/sdk-utils";
+*
+* const capitalized = capitalizeFirstLetter("hello");
+* // Returns: "Hello"
+*/
+function capitalizeFirstLetter(val) {
+	return String(val).charAt(0).toUpperCase() + String(val).slice(1);
+}
+/**
+* Converts a camelCase string to a human-readable string.
+*
+* @param s - The camelCase string to convert
+* @returns The human-readable string
+*
+* @example
+* import { camelCaseToWords } from "@settlemint/sdk-utils";
+*
+* const words = camelCaseToWords("camelCaseString");
+* // Returns: "Camel Case String"
+*/
+function camelCaseToWords(s) {
+	const result = s.replace(/([a-z])([A-Z])/g, "$1 $2");
+	const withSpaces = result.replace(/([A-Z])([a-z])/g, " $1$2");
+	const capitalized = capitalizeFirstLetter(withSpaces);
+	return capitalized.replace(/\s+/g, " ").trim();
+}
+/**
+* Replaces underscores and hyphens with spaces.
+*
+* @param s - The string to replace underscores and hyphens with spaces
+* @returns The input string with underscores and hyphens replaced with spaces
+*
+* @example
+* import { replaceUnderscoresAndHyphensWithSpaces } from "@settlemint/sdk-utils";
+*
+* const result = replaceUnderscoresAndHyphensWithSpaces("Already_Spaced-Second");
+* // Returns: "Already Spaced Second"
+*/
+function replaceUnderscoresAndHyphensWithSpaces(s) {
+	return s.replace(/[-_]/g, " ");
+}
+/**
+* Truncates a string to a maximum length and appends "..." if it is longer.
+*
+* @param value - The string to truncate
+* @param maxLength - The maximum length of the string
+* @returns The truncated string or the original string if it is shorter than the maximum length
+*
+* @example
+* import { truncate } from "@settlemint/sdk-utils";
+*
+* const truncated = truncate("Hello, world!", 10);
+* // Returns: "Hello, wor..."
+*/
+function truncate(value, maxLength) {
+	if (value.length <= maxLength) {
+		return value;
+	}
+	return `${value.slice(0, maxLength)}...`;
+}
+
+//#endregion
+exports.camelCaseToWords = camelCaseToWords;
+exports.capitalizeFirstLetter = capitalizeFirstLetter;
+exports.replaceUnderscoresAndHyphensWithSpaces = replaceUnderscoresAndHyphensWithSpaces;
+exports.truncate = truncate;
+//# sourceMappingURL=string.cjs.map

package/dist/string.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.cjs","names":["val: string","s: string","value: string","maxLength: number"],"sources":["../src/string.ts"],"sourcesContent":["/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n"],"mappings":";;;;;;;;;;;;;;AAYA,SAAgB,sBAAsBA,KAAa;AACjD,QAAO,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,aAAa,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE;AAClE;;;;;;;;;;;;;AAcD,SAAgB,iBAAiBC,GAAW;CAC1C,MAAM,SAAS,EAAE,QAAQ,mBAAmB,QAAQ;CACpD,MAAM,aAAa,OAAO,QAAQ,mBAAmB,QAAQ;CAC7D,MAAM,cAAc,sBAAsB,WAAW;AACrD,QAAO,YAAY,QAAQ,QAAQ,IAAI,CAAC,MAAM;AAC/C;;;;;;;;;;;;;AAcD,SAAgB,uCAAuCA,GAAW;AAChE,QAAO,EAAE,QAAQ,SAAS,IAAI;AAC/B;;;;;;;;;;;;;;AAeD,SAAgB,SAASC,OAAeC,WAAmB;AACzD,KAAI,MAAM,UAAU,WAAW;AAC7B,SAAO;CACR;AACD,SAAQ,EAAE,MAAM,MAAM,GAAG,UAAU,CAAC;AACrC"}

package/dist/string.d.cts

@@ -0,0 +1,58 @@
+//#region src/string.d.ts
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @param val - The string to capitalize
+ * @returns The input string with its first letter capitalized
+ *
+ * @example
+ * import { capitalizeFirstLetter } from "@settlemint/sdk-utils";
+ *
+ * const capitalized = capitalizeFirstLetter("hello");
+ * // Returns: "Hello"
+ */
+declare function capitalizeFirstLetter(val: string): string;
+/**
+ * Converts a camelCase string to a human-readable string.
+ *
+ * @param s - The camelCase string to convert
+ * @returns The human-readable string
+ *
+ * @example
+ * import { camelCaseToWords } from "@settlemint/sdk-utils";
+ *
+ * const words = camelCaseToWords("camelCaseString");
+ * // Returns: "Camel Case String"
+ */
+declare function camelCaseToWords(s: string): string;
+/**
+ * Replaces underscores and hyphens with spaces.
+ *
+ * @param s - The string to replace underscores and hyphens with spaces
+ * @returns The input string with underscores and hyphens replaced with spaces
+ *
+ * @example
+ * import { replaceUnderscoresAndHyphensWithSpaces } from "@settlemint/sdk-utils";
+ *
+ * const result = replaceUnderscoresAndHyphensWithSpaces("Already_Spaced-Second");
+ * // Returns: "Already Spaced Second"
+ */
+declare function replaceUnderscoresAndHyphensWithSpaces(s: string): string;
+/**
+ * Truncates a string to a maximum length and appends "..." if it is longer.
+ *
+ * @param value - The string to truncate
+ * @param maxLength - The maximum length of the string
+ * @returns The truncated string or the original string if it is shorter than the maximum length
+ *
+ * @example
+ * import { truncate } from "@settlemint/sdk-utils";
+ *
+ * const truncated = truncate("Hello, world!", 10);
+ * // Returns: "Hello, wor..."
+ */
+declare function truncate(value: string, maxLength: number): string;
+
+//#endregion
+export { camelCaseToWords, capitalizeFirstLetter, replaceUnderscoresAndHyphensWithSpaces, truncate };
+//# sourceMappingURL=string.d.cts.map

package/dist/string.d.ts

@@ -0,0 +1,58 @@
+//#region src/string.d.ts
+/**
+ * Capitalizes the first letter of a string.
+ *
+ * @param val - The string to capitalize
+ * @returns The input string with its first letter capitalized
+ *
+ * @example
+ * import { capitalizeFirstLetter } from "@settlemint/sdk-utils";
+ *
+ * const capitalized = capitalizeFirstLetter("hello");
+ * // Returns: "Hello"
+ */
+declare function capitalizeFirstLetter(val: string): string;
+/**
+ * Converts a camelCase string to a human-readable string.
+ *
+ * @param s - The camelCase string to convert
+ * @returns The human-readable string
+ *
+ * @example
+ * import { camelCaseToWords } from "@settlemint/sdk-utils";
+ *
+ * const words = camelCaseToWords("camelCaseString");
+ * // Returns: "Camel Case String"
+ */
+declare function camelCaseToWords(s: string): string;
+/**
+ * Replaces underscores and hyphens with spaces.
+ *
+ * @param s - The string to replace underscores and hyphens with spaces
+ * @returns The input string with underscores and hyphens replaced with spaces
+ *
+ * @example
+ * import { replaceUnderscoresAndHyphensWithSpaces } from "@settlemint/sdk-utils";
+ *
+ * const result = replaceUnderscoresAndHyphensWithSpaces("Already_Spaced-Second");
+ * // Returns: "Already Spaced Second"
+ */
+declare function replaceUnderscoresAndHyphensWithSpaces(s: string): string;
+/**
+ * Truncates a string to a maximum length and appends "..." if it is longer.
+ *
+ * @param value - The string to truncate
+ * @param maxLength - The maximum length of the string
+ * @returns The truncated string or the original string if it is shorter than the maximum length
+ *
+ * @example
+ * import { truncate } from "@settlemint/sdk-utils";
+ *
+ * const truncated = truncate("Hello, world!", 10);
+ * // Returns: "Hello, wor..."
+ */
+declare function truncate(value: string, maxLength: number): string;
+
+//#endregion
+export { camelCaseToWords, capitalizeFirstLetter, replaceUnderscoresAndHyphensWithSpaces, truncate };
+//# sourceMappingURL=string.d.ts.map

package/dist/string.js

@@ -0,0 +1,72 @@
+//#region src/string.ts
+/**
+* Capitalizes the first letter of a string.
+*
+* @param val - The string to capitalize
+* @returns The input string with its first letter capitalized
+*
+* @example
+* import { capitalizeFirstLetter } from "@settlemint/sdk-utils";
+*
+* const capitalized = capitalizeFirstLetter("hello");
+* // Returns: "Hello"
+*/
+function capitalizeFirstLetter(val) {
+	return String(val).charAt(0).toUpperCase() + String(val).slice(1);
+}
+/**
+* Converts a camelCase string to a human-readable string.
+*
+* @param s - The camelCase string to convert
+* @returns The human-readable string
+*
+* @example
+* import { camelCaseToWords } from "@settlemint/sdk-utils";
+*
+* const words = camelCaseToWords("camelCaseString");
+* // Returns: "Camel Case String"
+*/
+function camelCaseToWords(s) {
+	const result = s.replace(/([a-z])([A-Z])/g, "$1 $2");
+	const withSpaces = result.replace(/([A-Z])([a-z])/g, " $1$2");
+	const capitalized = capitalizeFirstLetter(withSpaces);
+	return capitalized.replace(/\s+/g, " ").trim();
+}
+/**
+* Replaces underscores and hyphens with spaces.
+*
+* @param s - The string to replace underscores and hyphens with spaces
+* @returns The input string with underscores and hyphens replaced with spaces
+*
+* @example
+* import { replaceUnderscoresAndHyphensWithSpaces } from "@settlemint/sdk-utils";
+*
+* const result = replaceUnderscoresAndHyphensWithSpaces("Already_Spaced-Second");
+* // Returns: "Already Spaced Second"
+*/
+function replaceUnderscoresAndHyphensWithSpaces(s) {
+	return s.replace(/[-_]/g, " ");
+}
+/**
+* Truncates a string to a maximum length and appends "..." if it is longer.
+*
+* @param value - The string to truncate
+* @param maxLength - The maximum length of the string
+* @returns The truncated string or the original string if it is shorter than the maximum length
+*
+* @example
+* import { truncate } from "@settlemint/sdk-utils";
+*
+* const truncated = truncate("Hello, world!", 10);
+* // Returns: "Hello, wor..."
+*/
+function truncate(value, maxLength) {
+	if (value.length <= maxLength) {
+		return value;
+	}
+	return `${value.slice(0, maxLength)}...`;
+}
+
+//#endregion
+export { camelCaseToWords, capitalizeFirstLetter, replaceUnderscoresAndHyphensWithSpaces, truncate };
+//# sourceMappingURL=string.js.map

package/dist/string.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"string.js","names":["val: string","s: string","value: string","maxLength: number"],"sources":["../src/string.ts"],"sourcesContent":["/**\n * Capitalizes the first letter of a string.\n *\n * @param val - The string to capitalize\n * @returns The input string with its first letter capitalized\n *\n * @example\n * import { capitalizeFirstLetter } from \"@settlemint/sdk-utils\";\n *\n * const capitalized = capitalizeFirstLetter(\"hello\");\n * // Returns: \"Hello\"\n */\nexport function capitalizeFirstLetter(val: string) {\n  return String(val).charAt(0).toUpperCase() + String(val).slice(1);\n}\n\n/**\n * Converts a camelCase string to a human-readable string.\n *\n * @param s - The camelCase string to convert\n * @returns The human-readable string\n *\n * @example\n * import { camelCaseToWords } from \"@settlemint/sdk-utils\";\n *\n * const words = camelCaseToWords(\"camelCaseString\");\n * // Returns: \"Camel Case String\"\n */\nexport function camelCaseToWords(s: string) {\n  const result = s.replace(/([a-z])([A-Z])/g, \"$1 $2\");\n  const withSpaces = result.replace(/([A-Z])([a-z])/g, \" $1$2\");\n  const capitalized = capitalizeFirstLetter(withSpaces);\n  return capitalized.replace(/\\s+/g, \" \").trim();\n}\n\n/**\n * Replaces underscores and hyphens with spaces.\n *\n * @param s - The string to replace underscores and hyphens with spaces\n * @returns The input string with underscores and hyphens replaced with spaces\n *\n * @example\n * import { replaceUnderscoresAndHyphensWithSpaces } from \"@settlemint/sdk-utils\";\n *\n * const result = replaceUnderscoresAndHyphensWithSpaces(\"Already_Spaced-Second\");\n * // Returns: \"Already Spaced Second\"\n */\nexport function replaceUnderscoresAndHyphensWithSpaces(s: string) {\n  return s.replace(/[-_]/g, \" \");\n}\n\n/**\n * Truncates a string to a maximum length and appends \"...\" if it is longer.\n *\n * @param value - The string to truncate\n * @param maxLength - The maximum length of the string\n * @returns The truncated string or the original string if it is shorter than the maximum length\n *\n * @example\n * import { truncate } from \"@settlemint/sdk-utils\";\n *\n * const truncated = truncate(\"Hello, world!\", 10);\n * // Returns: \"Hello, wor...\"\n */\nexport function truncate(value: string, maxLength: number) {\n  if (value.length <= maxLength) {\n    return value;\n  }\n  return `${value.slice(0, maxLength)}...`;\n}\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,sBAAsBA,KAAa;AACjD,QAAO,OAAO,IAAI,CAAC,OAAO,EAAE,CAAC,aAAa,GAAG,OAAO,IAAI,CAAC,MAAM,EAAE;AAClE;;;;;;;;;;;;;AAcD,SAAgB,iBAAiBC,GAAW;CAC1C,MAAM,SAAS,EAAE,QAAQ,mBAAmB,QAAQ;CACpD,MAAM,aAAa,OAAO,QAAQ,mBAAmB,QAAQ;CAC7D,MAAM,cAAc,sBAAsB,WAAW;AACrD,QAAO,YAAY,QAAQ,QAAQ,IAAI,CAAC,MAAM;AAC/C;;;;;;;;;;;;;AAcD,SAAgB,uCAAuCA,GAAW;AAChE,QAAO,EAAE,QAAQ,SAAS,IAAI;AAC/B;;;;;;;;;;;;;;AAeD,SAAgB,SAASC,OAAeC,WAAmB;AACzD,KAAI,MAAM,UAAU,WAAW;AAC7B,SAAO;CACR;AACD,SAAQ,EAAE,MAAM,MAAM,GAAG,UAAU,CAAC;AACrC"}