@settlemint/sdk-utils 2.3.2-pre186542e → 2.3.2-prede7bc05

package/dist/retry.cjs

@@ -0,0 +1,137 @@
+
+//#region src/logging/mask-tokens.ts
+/**
+* Masks sensitive SettleMint tokens in output text by replacing them with asterisks.
+* Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).
+*
+* @param output - The text string that may contain sensitive tokens
+* @returns The text with any sensitive tokens masked with asterisks
+* @example
+* import { maskTokens } from "@settlemint/sdk-utils/terminal";
+*
+* // Masks a token in text
+* const masked = maskTokens("Token: sm_pat_****"); // "Token: ***"
+*/
+const maskTokens = (output) => {
+	return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, "***");
+};
+
+//#endregion
+//#region src/logging/logger.ts
+/**
+* Creates a simple logger with configurable log level
+*
+* @param options - Configuration options for the logger
+* @param options.level - The minimum log level to output (default: warn)
+* @param options.prefix - The prefix to add to the log message (default: "")
+* @returns A logger instance with debug, info, warn, and error methods
+*
+* @example
+* import { createLogger } from "@/utils/logging/logger";
+*
+* const logger = createLogger({ level: 'info' });
+*
+* logger.info('User logged in', { userId: '123' });
+* logger.error('Operation failed', new Error('Connection timeout'));
+*/
+function createLogger(options = {}) {
+	const { level = "warn", prefix = "" } = options;
+	const logLevels = {
+		debug: 0,
+		info: 1,
+		warn: 2,
+		error: 3,
+		none: 4
+	};
+	const currentLevelValue = logLevels[level];
+	const formatArgs = (args) => {
+		if (args.length === 0 || args.every((arg) => arg === undefined || arg === null)) {
+			return "";
+		}
+		const formatted = args.map((arg) => {
+			if (arg instanceof Error) {
+				return `\n${arg.stack || arg.message}`;
+			}
+			if (typeof arg === "object" && arg !== null) {
+				return `\n${JSON.stringify(arg, null, 2)}`;
+			}
+			return ` ${String(arg)}`;
+		}).join("");
+		return `, args:${formatted}`;
+	};
+	const shouldLog = (level$1) => {
+		return logLevels[level$1] >= currentLevelValue;
+	};
+	return {
+		debug: (message, ...args) => {
+			if (shouldLog("debug")) {
+				console.debug(`\x1b[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		},
+		info: (message, ...args) => {
+			if (shouldLog("info")) {
+				console.info(`\x1b[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		},
+		warn: (message, ...args) => {
+			if (shouldLog("warn")) {
+				console.warn(`\x1b[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		},
+		error: (message, ...args) => {
+			if (shouldLog("error")) {
+				console.error(`\x1b[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		}
+	};
+}
+/**
+* Default logger instance with standard configuration
+*/
+const logger = createLogger();
+
+//#endregion
+//#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
+exports.retryWhenFailed = retryWhenFailed;
+//# sourceMappingURL=retry.cjs.map

package/dist/retry.cjs.map

@@ -0,0 +1 @@
+{"version":3,"file":"retry.cjs","names":["output: string","options: LoggerOptions","logLevels: Record<LogLevel, number>","args: unknown[]","level: LogLevel","level","message: string","fn: () => Promise<T>","stopOnError?: (error: Error) => boolean"],"sources":["../src/logging/mask-tokens.ts","../src/logging/logger.ts","../src/retry.ts"],"sourcesContent":["/**\n * Masks sensitive SettleMint tokens in output text by replacing them with asterisks.\n * Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).\n *\n * @param output - The text string that may contain sensitive tokens\n * @returns The text with any sensitive tokens masked with asterisks\n * @example\n * import { maskTokens } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Masks a token in text\n * const masked = maskTokens(\"Token: sm_pat_****\"); // \"Token: ***\"\n */\nexport const maskTokens = (output: string): string => {\n  return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, \"***\");\n};\n","import { maskTokens } from \"./mask-tokens.js\";\n\n/**\n * Log levels supported by the logger\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\n/**\n * Configuration options for the logger\n * @interface LoggerOptions\n */\nexport interface LoggerOptions {\n  /** The minimum log level to output */\n  level?: LogLevel;\n  /** The prefix to add to the log message */\n  prefix?: string;\n}\n\n/**\n * Simple logger interface with basic logging methods\n * @interface Logger\n */\nexport interface Logger {\n  /** Log debug information */\n  debug: (message: string, ...args: unknown[]) => void;\n  /** Log general information */\n  info: (message: string, ...args: unknown[]) => void;\n  /** Log warnings */\n  warn: (message: string, ...args: unknown[]) => void;\n  /** Log errors */\n  error: (message: string, ...args: unknown[]) => void;\n}\n\n/**\n * Creates a simple logger with configurable log level\n *\n * @param options - Configuration options for the logger\n * @param options.level - The minimum log level to output (default: warn)\n * @param options.prefix - The prefix to add to the log message (default: \"\")\n * @returns A logger instance with debug, info, warn, and error methods\n *\n * @example\n * import { createLogger } from \"@/utils/logging/logger\";\n *\n * const logger = createLogger({ level: 'info' });\n *\n * logger.info('User logged in', { userId: '123' });\n * logger.error('Operation failed', new Error('Connection timeout'));\n */\nexport function createLogger(options: LoggerOptions = {}): Logger {\n  const { level = \"warn\", prefix = \"\" } = options;\n\n  const logLevels: Record<LogLevel, number> = {\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n    none: 4,\n  };\n\n  const currentLevelValue = logLevels[level];\n\n  const formatArgs = (args: unknown[]): string => {\n    if (args.length === 0 || args.every((arg) => arg === undefined || arg === null)) {\n      return \"\";\n    }\n\n    const formatted = args\n      .map((arg) => {\n        if (arg instanceof Error) {\n          return `\\n${arg.stack || arg.message}`;\n        }\n        if (typeof arg === \"object\" && arg !== null) {\n          return `\\n${JSON.stringify(arg, null, 2)}`;\n        }\n        return ` ${String(arg)}`;\n      })\n      .join(\"\");\n\n    return `, args:${formatted}`;\n  };\n\n  const shouldLog = (level: LogLevel): boolean => {\n    return logLevels[level] >= currentLevelValue;\n  };\n\n  return {\n    debug: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"debug\")) {\n        console.debug(`\\x1b[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n    info: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"info\")) {\n        console.info(`\\x1b[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n    warn: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"warn\")) {\n        console.warn(`\\x1b[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n    error: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"error\")) {\n        console.error(`\\x1b[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n  };\n}\n\n/**\n * Default logger instance with standard configuration\n */\nexport const logger = createLogger();\n","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":";;;;;;;;;;;;;;AAYA,MAAa,aAAa,CAACA,WAA2B;AACpD,QAAO,OAAO,QAAQ,kCAAkC,MAAM;AAC/D;;;;;;;;;;;;;;;;;;;;ACmCD,SAAgB,aAAaC,UAAyB,CAAE,GAAU;CAChE,MAAM,EAAE,QAAQ,QAAQ,SAAS,IAAI,GAAG;CAExC,MAAMC,YAAsC;EAC1C,OAAO;EACP,MAAM;EACN,MAAM;EACN,OAAO;EACP,MAAM;CACP;CAED,MAAM,oBAAoB,UAAU;CAEpC,MAAM,aAAa,CAACC,SAA4B;AAC9C,MAAI,KAAK,WAAW,KAAK,KAAK,MAAM,CAAC,QAAQ,QAAQ,aAAa,QAAQ,KAAK,EAAE;AAC/E,UAAO;EACR;EAED,MAAM,YAAY,KACf,IAAI,CAAC,QAAQ;AACZ,OAAI,eAAe,OAAO;AACxB,YAAQ,IAAI,IAAI,SAAS,IAAI,QAAQ;GACtC;AACD,cAAW,QAAQ,YAAY,QAAQ,MAAM;AAC3C,YAAQ,IAAI,KAAK,UAAU,KAAK,MAAM,EAAE,CAAC;GAC1C;AACD,WAAQ,GAAG,OAAO,IAAI,CAAC;EACxB,EAAC,CACD,KAAK,GAAG;AAEX,UAAQ,SAAS,UAAU;CAC5B;CAED,MAAM,YAAY,CAACC,YAA6B;AAC9C,SAAO,UAAUC,YAAU;CAC5B;AAED,QAAO;EACL,OAAO,CAACC,SAAiB,GAAG,SAAoB;AAC9C,OAAI,UAAU,QAAQ,EAAE;AACtB,YAAQ,OAAO,UAAU,OAAO,UAAU,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACvG;EACF;EACD,MAAM,CAACA,SAAiB,GAAG,SAAoB;AAC7C,OAAI,UAAU,OAAO,EAAE;AACrB,YAAQ,MAAM,UAAU,OAAO,SAAS,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACrG;EACF;EACD,MAAM,CAACA,SAAiB,GAAG,SAAoB;AAC7C,OAAI,UAAU,OAAO,EAAE;AACrB,YAAQ,MAAM,UAAU,OAAO,SAAS,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACrG;EACF;EACD,OAAO,CAACA,SAAiB,GAAG,SAAoB;AAC9C,OAAI,UAAU,QAAQ,EAAE;AACtB,YAAQ,OAAO,UAAU,OAAO,UAAU,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACvG;EACF;CACF;AACF;;;;AAKD,MAAa,SAAS,cAAc;;;;;;;;;;;;;;;;;AClGpC,eAAsB,gBACpBC,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/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,136 @@
+//#region src/logging/mask-tokens.ts
+/**
+* Masks sensitive SettleMint tokens in output text by replacing them with asterisks.
+* Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).
+*
+* @param output - The text string that may contain sensitive tokens
+* @returns The text with any sensitive tokens masked with asterisks
+* @example
+* import { maskTokens } from "@settlemint/sdk-utils/terminal";
+*
+* // Masks a token in text
+* const masked = maskTokens("Token: sm_pat_****"); // "Token: ***"
+*/
+const maskTokens = (output) => {
+	return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, "***");
+};
+
+//#endregion
+//#region src/logging/logger.ts
+/**
+* Creates a simple logger with configurable log level
+*
+* @param options - Configuration options for the logger
+* @param options.level - The minimum log level to output (default: warn)
+* @param options.prefix - The prefix to add to the log message (default: "")
+* @returns A logger instance with debug, info, warn, and error methods
+*
+* @example
+* import { createLogger } from "@/utils/logging/logger";
+*
+* const logger = createLogger({ level: 'info' });
+*
+* logger.info('User logged in', { userId: '123' });
+* logger.error('Operation failed', new Error('Connection timeout'));
+*/
+function createLogger(options = {}) {
+	const { level = "warn", prefix = "" } = options;
+	const logLevels = {
+		debug: 0,
+		info: 1,
+		warn: 2,
+		error: 3,
+		none: 4
+	};
+	const currentLevelValue = logLevels[level];
+	const formatArgs = (args) => {
+		if (args.length === 0 || args.every((arg) => arg === undefined || arg === null)) {
+			return "";
+		}
+		const formatted = args.map((arg) => {
+			if (arg instanceof Error) {
+				return `\n${arg.stack || arg.message}`;
+			}
+			if (typeof arg === "object" && arg !== null) {
+				return `\n${JSON.stringify(arg, null, 2)}`;
+			}
+			return ` ${String(arg)}`;
+		}).join("");
+		return `, args:${formatted}`;
+	};
+	const shouldLog = (level$1) => {
+		return logLevels[level$1] >= currentLevelValue;
+	};
+	return {
+		debug: (message, ...args) => {
+			if (shouldLog("debug")) {
+				console.debug(`\x1b[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		},
+		info: (message, ...args) => {
+			if (shouldLog("info")) {
+				console.info(`\x1b[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		},
+		warn: (message, ...args) => {
+			if (shouldLog("warn")) {
+				console.warn(`\x1b[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		},
+		error: (message, ...args) => {
+			if (shouldLog("error")) {
+				console.error(`\x1b[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\x1b[0m`);
+			}
+		}
+	};
+}
+/**
+* Default logger instance with standard configuration
+*/
+const logger = createLogger();
+
+//#endregion
+//#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":["output: string","options: LoggerOptions","logLevels: Record<LogLevel, number>","args: unknown[]","level: LogLevel","level","message: string","fn: () => Promise<T>","stopOnError?: (error: Error) => boolean"],"sources":["../src/logging/mask-tokens.ts","../src/logging/logger.ts","../src/retry.ts"],"sourcesContent":["/**\n * Masks sensitive SettleMint tokens in output text by replacing them with asterisks.\n * Handles personal access tokens (PAT), application access tokens (AAT), and service account tokens (SAT).\n *\n * @param output - The text string that may contain sensitive tokens\n * @returns The text with any sensitive tokens masked with asterisks\n * @example\n * import { maskTokens } from \"@settlemint/sdk-utils/terminal\";\n *\n * // Masks a token in text\n * const masked = maskTokens(\"Token: sm_pat_****\"); // \"Token: ***\"\n */\nexport const maskTokens = (output: string): string => {\n  return output.replace(/sm_(pat|aat|sat)_[0-9a-zA-Z]+/g, \"***\");\n};\n","import { maskTokens } from \"./mask-tokens.js\";\n\n/**\n * Log levels supported by the logger\n */\nexport type LogLevel = \"debug\" | \"info\" | \"warn\" | \"error\" | \"none\";\n\n/**\n * Configuration options for the logger\n * @interface LoggerOptions\n */\nexport interface LoggerOptions {\n  /** The minimum log level to output */\n  level?: LogLevel;\n  /** The prefix to add to the log message */\n  prefix?: string;\n}\n\n/**\n * Simple logger interface with basic logging methods\n * @interface Logger\n */\nexport interface Logger {\n  /** Log debug information */\n  debug: (message: string, ...args: unknown[]) => void;\n  /** Log general information */\n  info: (message: string, ...args: unknown[]) => void;\n  /** Log warnings */\n  warn: (message: string, ...args: unknown[]) => void;\n  /** Log errors */\n  error: (message: string, ...args: unknown[]) => void;\n}\n\n/**\n * Creates a simple logger with configurable log level\n *\n * @param options - Configuration options for the logger\n * @param options.level - The minimum log level to output (default: warn)\n * @param options.prefix - The prefix to add to the log message (default: \"\")\n * @returns A logger instance with debug, info, warn, and error methods\n *\n * @example\n * import { createLogger } from \"@/utils/logging/logger\";\n *\n * const logger = createLogger({ level: 'info' });\n *\n * logger.info('User logged in', { userId: '123' });\n * logger.error('Operation failed', new Error('Connection timeout'));\n */\nexport function createLogger(options: LoggerOptions = {}): Logger {\n  const { level = \"warn\", prefix = \"\" } = options;\n\n  const logLevels: Record<LogLevel, number> = {\n    debug: 0,\n    info: 1,\n    warn: 2,\n    error: 3,\n    none: 4,\n  };\n\n  const currentLevelValue = logLevels[level];\n\n  const formatArgs = (args: unknown[]): string => {\n    if (args.length === 0 || args.every((arg) => arg === undefined || arg === null)) {\n      return \"\";\n    }\n\n    const formatted = args\n      .map((arg) => {\n        if (arg instanceof Error) {\n          return `\\n${arg.stack || arg.message}`;\n        }\n        if (typeof arg === \"object\" && arg !== null) {\n          return `\\n${JSON.stringify(arg, null, 2)}`;\n        }\n        return ` ${String(arg)}`;\n      })\n      .join(\"\");\n\n    return `, args:${formatted}`;\n  };\n\n  const shouldLog = (level: LogLevel): boolean => {\n    return logLevels[level] >= currentLevelValue;\n  };\n\n  return {\n    debug: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"debug\")) {\n        console.debug(`\\x1b[32m${prefix}[DEBUG] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n    info: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"info\")) {\n        console.info(`\\x1b[34m${prefix}[INFO] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n    warn: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"warn\")) {\n        console.warn(`\\x1b[33m${prefix}[WARN] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n    error: (message: string, ...args: unknown[]) => {\n      if (shouldLog(\"error\")) {\n        console.error(`\\x1b[31m${prefix}[ERROR] ${maskTokens(message)}${maskTokens(formatArgs(args))}\\x1b[0m`);\n      }\n    },\n  };\n}\n\n/**\n * Default logger instance with standard configuration\n */\nexport const logger = createLogger();\n","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":";;;;;;;;;;;;;AAYA,MAAa,aAAa,CAACA,WAA2B;AACpD,QAAO,OAAO,QAAQ,kCAAkC,MAAM;AAC/D;;;;;;;;;;;;;;;;;;;;ACmCD,SAAgB,aAAaC,UAAyB,CAAE,GAAU;CAChE,MAAM,EAAE,QAAQ,QAAQ,SAAS,IAAI,GAAG;CAExC,MAAMC,YAAsC;EAC1C,OAAO;EACP,MAAM;EACN,MAAM;EACN,OAAO;EACP,MAAM;CACP;CAED,MAAM,oBAAoB,UAAU;CAEpC,MAAM,aAAa,CAACC,SAA4B;AAC9C,MAAI,KAAK,WAAW,KAAK,KAAK,MAAM,CAAC,QAAQ,QAAQ,aAAa,QAAQ,KAAK,EAAE;AAC/E,UAAO;EACR;EAED,MAAM,YAAY,KACf,IAAI,CAAC,QAAQ;AACZ,OAAI,eAAe,OAAO;AACxB,YAAQ,IAAI,IAAI,SAAS,IAAI,QAAQ;GACtC;AACD,cAAW,QAAQ,YAAY,QAAQ,MAAM;AAC3C,YAAQ,IAAI,KAAK,UAAU,KAAK,MAAM,EAAE,CAAC;GAC1C;AACD,WAAQ,GAAG,OAAO,IAAI,CAAC;EACxB,EAAC,CACD,KAAK,GAAG;AAEX,UAAQ,SAAS,UAAU;CAC5B;CAED,MAAM,YAAY,CAACC,YAA6B;AAC9C,SAAO,UAAUC,YAAU;CAC5B;AAED,QAAO;EACL,OAAO,CAACC,SAAiB,GAAG,SAAoB;AAC9C,OAAI,UAAU,QAAQ,EAAE;AACtB,YAAQ,OAAO,UAAU,OAAO,UAAU,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACvG;EACF;EACD,MAAM,CAACA,SAAiB,GAAG,SAAoB;AAC7C,OAAI,UAAU,OAAO,EAAE;AACrB,YAAQ,MAAM,UAAU,OAAO,SAAS,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACrG;EACF;EACD,MAAM,CAACA,SAAiB,GAAG,SAAoB;AAC7C,OAAI,UAAU,OAAO,EAAE;AACrB,YAAQ,MAAM,UAAU,OAAO,SAAS,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACrG;EACF;EACD,OAAO,CAACA,SAAiB,GAAG,SAAoB;AAC9C,OAAI,UAAU,QAAQ,EAAE;AACtB,YAAQ,OAAO,UAAU,OAAO,UAAU,WAAW,QAAQ,CAAC,EAAE,WAAW,WAAW,KAAK,CAAC,CAAC,SAAS;GACvG;EACF;CACF;AACF;;;;AAKD,MAAa,SAAS,cAAc;;;;;;;;;;;;;;;;;AClGpC,eAAsB,gBACpBC,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,71 @@
-"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 environment = __toESM(require("environment"));
 
-// src/runtime/ensure-server.ts
-var import_environment = require("environment");
+//#region src/runtime/ensure-server.ts
+/**
+* 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();
+*/
 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."
-    );
-  }
+	if (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.");
+	}
 }
+/**
+* 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();
+*/
 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.");
-  }
+	if (!environment.isBrowser) {
+		throw new Error("This function can only be used on the browser as it is missing the access token.");
+	}
 }
-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
-});
+/**
+* Boolean indicating if code is currently running in a browser environment
+*/
+const runsInBrowser = environment.isBrowser;
+/**
+* Boolean indicating if code is currently running in a server environment
+*/
+const runsOnServer = !environment.isBrowser;
+
+//#endregion
+exports.ensureBrowser = ensureBrowser;
+exports.ensureServer = ensureServer;
+exports.runsInBrowser = runsInBrowser;
+exports.runsOnServer = runsOnServer;
 //# sourceMappingURL=runtime.cjs.map

package/dist/runtime.cjs.map

@@ -1 +1 @@
-{"version":3,"sources":["../src/runtime.ts","../src/runtime/ensure-server.ts"],"sourcesContent":["export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer } from \"./runtime/ensure-server.js\";\n","import { isBrowser } from \"environment\";\n\n/**\n * Ensures that code is running on the server and not in a browser environment.\n *\n * @throws {Error} If called from a browser environment\n * @example\n * import { ensureServer } from \"@settlemint/sdk-utils/runtime\";\n *\n * // Will throw if running in browser\n * ensureServer();\n */\nexport function ensureServer(): void {\n  if (isBrowser) {\n    throw new Error(\n      \"This function can only be used on the server as including it in the browser will expose your access token.\",\n    );\n  }\n}\n\n/**\n * Ensures that code is running in a browser environment and not on the server.\n *\n * @throws {Error} If called from a server environment\n * @example\n * import { ensureBrowser } from \"@settlemint/sdk-utils/runtime\";\n *\n * // Will throw if running on server\n * ensureBrowser();\n */\nexport function ensureBrowser(): void {\n  if (!isBrowser) {\n    throw new Error(\"This function can only be used on the browser as it is missing the access token.\");\n  }\n}\n\n/**\n * Boolean indicating if code is currently running in a browser environment\n */\nexport const runsInBrowser = isBrowser;\n\n/**\n * Boolean indicating if code is currently running in a server environment\n */\nexport const runsOnServer = !isBrowser;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;AAAA;;;ACAA,yBAA0B;AAYnB,SAAS,eAAqB;AACnC,MAAI,8BAAW;AACb,UAAM,IAAI;AAAA,MACR;AAAA,IACF;AAAA,EACF;AACF;AAYO,SAAS,gBAAsB;AACpC,MAAI,CAAC,8BAAW;AACd,UAAM,IAAI,MAAM,kFAAkF;AAAA,EACpG;AACF;AAKO,IAAM,gBAAgB;AAKtB,IAAM,eAAe,CAAC;","names":[]}
+{"version":3,"file":"runtime.cjs","names":["isBrowser"],"sources":["../src/runtime/ensure-server.ts"],"sourcesContent":["import { isBrowser } from \"environment\";\n\n/**\n * Ensures that code is running on the server and not in a browser environment.\n *\n * @throws {Error} If called from a browser environment\n * @example\n * import { ensureServer } from \"@settlemint/sdk-utils/runtime\";\n *\n * // Will throw if running in browser\n * ensureServer();\n */\nexport function ensureServer(): void {\n  if (isBrowser) {\n    throw new Error(\n      \"This function can only be used on the server as including it in the browser will expose your access token.\",\n    );\n  }\n}\n\n/**\n * Ensures that code is running in a browser environment and not on the server.\n *\n * @throws {Error} If called from a server environment\n * @example\n * import { ensureBrowser } from \"@settlemint/sdk-utils/runtime\";\n *\n * // Will throw if running on server\n * ensureBrowser();\n */\nexport function ensureBrowser(): void {\n  if (!isBrowser) {\n    throw new Error(\"This function can only be used on the browser as it is missing the access token.\");\n  }\n}\n\n/**\n * Boolean indicating if code is currently running in a browser environment\n */\nexport const runsInBrowser = isBrowser;\n\n/**\n * Boolean indicating if code is currently running in a server environment\n */\nexport const runsOnServer = !isBrowser;\n"],"mappings":";;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;;AAYA,SAAgB,eAAqB;AACnC,KAAIA,uBAAW;AACb,QAAM,IAAI,MACR;CAEH;AACF;;;;;;;;;;;AAYD,SAAgB,gBAAsB;AACpC,MAAKA,uBAAW;AACd,QAAM,IAAI,MAAM;CACjB;AACF;;;;AAKD,MAAa,gBAAgBA;;;;AAK7B,MAAa,gBAAgBA"}

package/dist/runtime.d.cts

@@ -1,3 +1,4 @@
+//#region src/runtime/ensure-server.d.ts
 /**
  * Ensures that code is running on the server and not in a browser environment.
  *
@@ -29,4 +30,6 @@ declare const runsInBrowser: boolean;
  */
 declare const runsOnServer: boolean;
 
+//#endregion
 export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };
+//# sourceMappingURL=runtime.d.cts.map

package/dist/runtime.d.ts

@@ -1,3 +1,4 @@
+//#region src/runtime/ensure-server.d.ts
 /**
  * Ensures that code is running on the server and not in a browser environment.
  *
@@ -29,4 +30,6 @@ declare const runsInBrowser: boolean;
  */
 declare const runsOnServer: boolean;
 
+//#endregion
 export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };
+//# sourceMappingURL=runtime.d.ts.map

package/dist/runtime.js

@@ -0,0 +1,45 @@
+import { isBrowser } from "environment";
+
+//#region src/runtime/ensure-server.ts
+/**
+* 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();
+*/
+function ensureServer() {
+	if (isBrowser) {
+		throw new Error("This function can only be used on the server as including it in the browser will expose your access token.");
+	}
+}
+/**
+* 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();
+*/
+function ensureBrowser() {
+	if (!isBrowser) {
+		throw new Error("This function can only be used on the browser as it is missing the access token.");
+	}
+}
+/**
+* Boolean indicating if code is currently running in a browser environment
+*/
+const runsInBrowser = isBrowser;
+/**
+* Boolean indicating if code is currently running in a server environment
+*/
+const runsOnServer = !isBrowser;
+
+//#endregion
+export { ensureBrowser, ensureServer, runsInBrowser, runsOnServer };
+//# sourceMappingURL=runtime.js.map

package/dist/runtime.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"runtime.js","names":[],"sources":["../src/runtime/ensure-server.ts"],"sourcesContent":["import { isBrowser } from \"environment\";\n\n/**\n * Ensures that code is running on the server and not in a browser environment.\n *\n * @throws {Error} If called from a browser environment\n * @example\n * import { ensureServer } from \"@settlemint/sdk-utils/runtime\";\n *\n * // Will throw if running in browser\n * ensureServer();\n */\nexport function ensureServer(): void {\n  if (isBrowser) {\n    throw new Error(\n      \"This function can only be used on the server as including it in the browser will expose your access token.\",\n    );\n  }\n}\n\n/**\n * Ensures that code is running in a browser environment and not on the server.\n *\n * @throws {Error} If called from a server environment\n * @example\n * import { ensureBrowser } from \"@settlemint/sdk-utils/runtime\";\n *\n * // Will throw if running on server\n * ensureBrowser();\n */\nexport function ensureBrowser(): void {\n  if (!isBrowser) {\n    throw new Error(\"This function can only be used on the browser as it is missing the access token.\");\n  }\n}\n\n/**\n * Boolean indicating if code is currently running in a browser environment\n */\nexport const runsInBrowser = isBrowser;\n\n/**\n * Boolean indicating if code is currently running in a server environment\n */\nexport const runsOnServer = !isBrowser;\n"],"mappings":";;;;;;;;;;;;;AAYA,SAAgB,eAAqB;AACnC,KAAI,WAAW;AACb,QAAM,IAAI,MACR;CAEH;AACF;;;;;;;;;;;AAYD,SAAgB,gBAAsB;AACpC,MAAK,WAAW;AACd,QAAM,IAAI,MAAM;CACjB;AACF;;;;AAKD,MAAa,gBAAgB;;;;AAK7B,MAAa,gBAAgB"}

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"}