@leather.io/utils 0.43.0 → 0.44.1

package/.turbo/turbo-build.log

@@ -1,5 +1,5 @@
 
-> @leather.io/utils@0.43.0 build /home/runner/work/mono/mono/packages/utils
+> @leather.io/utils@0.44.1 build /home/runner/work/mono/mono/packages/utils
 > tsup
 
 CLI Building entry: src/index.ts
@@ -8,9 +8,9 @@
 CLI Using tsup config: /home/runner/work/mono/mono/packages/utils/tsup.config.ts
 CLI Target: es2022
 ESM Build start
-ESM dist/index.js     71.76 KB
-ESM dist/index.js.map 135.06 KB
-ESM ⚡️ Build success in 33ms
+ESM dist/index.js     72.48 KB
+ESM dist/index.js.map 137.40 KB
+ESM ⚡️ Build success in 32ms
 DTS Build start
-DTS ⚡️ Build success in 1800ms
-DTS dist/index.d.ts 13.38 KB
+DTS ⚡️ Build success in 1847ms
+DTS dist/index.d.ts 14.39 KB

package/CHANGELOG.md

@@ -332,6 +332,20 @@
     * @leather.io/constants bumped to 0.25.1
     * @leather.io/models bumped to 0.39.1
 
+### Dependencies
+
+* The following workspace dependencies were updated
+  * dependencies
+    * @leather.io/constants bumped to 0.25.3
+    * @leather.io/models bumped to 0.41.0
+
+## [0.44.0](https://github.com/leather-io/mono/compare/@leather.io/utils-v0.43.0...@leather.io/utils-v0.44.0) (2025-08-27)
+
+
+### Features
+
+* flatten object util ([cdebfec](https://github.com/leather-io/mono/commit/cdebfec46d68cb1ac9d12b844b9b4c7e976237d4))
+
 ## [0.43.0](https://github.com/leather-io/mono/compare/@leather.io/utils-v0.42.4...@leather.io/utils-v0.43.0) (2025-08-26)
 
 

package/dist/index.d.ts

@@ -170,6 +170,37 @@ declare function createCurrencyFormatter({ locale, onError }: CreateCurrencyForm
     formatPercentage: (amount: number, decimals?: number) => string;
 };
 
+type ObjectValue = string | number | boolean | null | NestedObject | ObjectValue[];
+interface NestedObject {
+    [key: string]: ObjectValue;
+}
+interface FlattenedObject {
+    [key: string]: string | number | boolean | null;
+}
+/**
+ * Flattens a nested object or array into a flat object with dot-notation key paths.
+ *
+ * @param input - The object or array to flatten
+ * @param prefix - Internal parameter for recursion, represents the current key path
+ * @returns A flat object where keys represent the path to the original nested value
+ *
+ * @example
+ * ```typescript
+ * // Object example
+ * flattenObject({ layer1: { layer2: 'value' } })
+ * // Returns: { 'layer1.layer2': 'value' }
+ *
+ * // Array example
+ * flattenObject([{ key: 'value' }])
+ * // Returns: { '[0].key': 'value' }
+ *
+ * // Mixed example
+ * flattenObject({ users: [{ name: 'John', age: 30 }] })
+ * // Returns: { 'users[0].name': 'John', 'users[0].age': 30 }
+ * ```
+ */
+declare function flattenObject(input: ObjectValue, prefix?: string): FlattenedObject;
+
 interface SpamFilterArgs {
     input: string;
     whitelist: string[];
@@ -249,4 +280,4 @@ declare function match<Variant extends string | number>(): <T>(variant: Variant,
 declare function removeTrailingNullCharacters(s: string): string;
 declare function isNumberOrNumberList(value: unknown): value is number | number[];
 
-export { type CreateInscriptionData, type FormatAmountOptions, aggregateBaseCryptoAssetBalances, aggregateBtcBalances, aggregateStxBalances, assertExistence, assertIsTruthy, assertUnreachable, baseCurrencyAmountInQuote, baseCurrencyAmountInQuoteWithFallback, btcToSat, calculateMeanAverage, capitalize, convertAmountToBaseUnit, convertAmountToFractionalUnit, convertToMoneyTypeWithDefaultOfZero, countDecimals, createAccountAddresses, createBaseCryptoAssetBalance, createBtcBalance, createCounter, createCurrencyFormatter, createInscriptionAsset, createMoney, createMoneyFromDecimal, createNullArrayOfLength, createNumArrayOfRange, createStxBalance, dateToUnixTimestamp, daysInMs, daysInSec, defaultWalletKeyId, delay, ensureArray, extractPhraseFromString, fibonacciGenerator, fiveMinInMs, getAssetDisplayName, getAssetId, getTicker, hasBitcoinAddress, hasStacksAddress, hexToNumber, hoursInMs, hoursInSec, increaseValueByOneMicroStx, initBigNumber, invertExchangeRate, isBigInt, isBoolean, isDefined, isEmpty, isEmptyArray, isEmptyString, isError, isEven, isFiatCurrencyCode, isFulfilled, isFunction, isHexString, isMoney, isMoneyGreaterThanZero, isNumber, isNumberOrNumberList, isObject, isRejected, isString, isTypedArray, isUndefined, isValidPrecision, makeNumberRange, makeStacksTxExplorerLink, mapObject, match, matchesAssetId, maxMoney, microStxToStx, migratePositiveAssetBalancesToTop, minMoney, minutesInMs, minutesInSec, moneyToBaseUnit, noop, oneDayInMs, oneMinInMs, oneWeekInMs, propIfDefined, pxStringToNumber, quoteCurrencyAmountToBase, rebaseMarketData, removeTrailingNullCharacters, reverseBytes, safelyFormatHexTxid, sanitizeContent, satToBtc, scaleValue, secondsInMs, sortAssetsByName, spamFilter, stxToMicroStx, subtractMoney, sumMoney, sumNumbers, toHexString, truncateMiddle, undefinedIfLengthZero, uniqueArray, unitToFractionalUnit, weeksInMs, weeksInSec, whenInscriptionMimeType, whenNetwork };
+export { type CreateInscriptionData, type FormatAmountOptions, aggregateBaseCryptoAssetBalances, aggregateBtcBalances, aggregateStxBalances, assertExistence, assertIsTruthy, assertUnreachable, baseCurrencyAmountInQuote, baseCurrencyAmountInQuoteWithFallback, btcToSat, calculateMeanAverage, capitalize, convertAmountToBaseUnit, convertAmountToFractionalUnit, convertToMoneyTypeWithDefaultOfZero, countDecimals, createAccountAddresses, createBaseCryptoAssetBalance, createBtcBalance, createCounter, createCurrencyFormatter, createInscriptionAsset, createMoney, createMoneyFromDecimal, createNullArrayOfLength, createNumArrayOfRange, createStxBalance, dateToUnixTimestamp, daysInMs, daysInSec, defaultWalletKeyId, delay, ensureArray, extractPhraseFromString, fibonacciGenerator, fiveMinInMs, flattenObject, getAssetDisplayName, getAssetId, getTicker, hasBitcoinAddress, hasStacksAddress, hexToNumber, hoursInMs, hoursInSec, increaseValueByOneMicroStx, initBigNumber, invertExchangeRate, isBigInt, isBoolean, isDefined, isEmpty, isEmptyArray, isEmptyString, isError, isEven, isFiatCurrencyCode, isFulfilled, isFunction, isHexString, isMoney, isMoneyGreaterThanZero, isNumber, isNumberOrNumberList, isObject, isRejected, isString, isTypedArray, isUndefined, isValidPrecision, makeNumberRange, makeStacksTxExplorerLink, mapObject, match, matchesAssetId, maxMoney, microStxToStx, migratePositiveAssetBalancesToTop, minMoney, minutesInMs, minutesInSec, moneyToBaseUnit, noop, oneDayInMs, oneMinInMs, oneWeekInMs, propIfDefined, pxStringToNumber, quoteCurrencyAmountToBase, rebaseMarketData, removeTrailingNullCharacters, reverseBytes, safelyFormatHexTxid, sanitizeContent, satToBtc, scaleValue, secondsInMs, sortAssetsByName, spamFilter, stxToMicroStx, subtractMoney, sumMoney, sumNumbers, toHexString, truncateMiddle, undefinedIfLengthZero, uniqueArray, unitToFractionalUnit, weeksInMs, weeksInSec, whenInscriptionMimeType, whenNetwork };

package/dist/index.js

@@ -1942,6 +1942,29 @@ function deriveFractionOptions(amount, decimals, compact, presetNumberFormatOpti
   };
 }
 
+// src/flatten-object.ts
+function flattenObject(input, prefix = "") {
+  const result = {};
+  if (input === null || typeof input !== "object") {
+    if (prefix === "") return { value: input };
+    return { [prefix]: input };
+  }
+  if (Array.isArray(input)) {
+    input.forEach((item, index) => {
+      const key = prefix === "" ? `[${index}]` : `${prefix}[${index}]`;
+      const flattened = flattenObject(item, key);
+      Object.assign(result, flattened);
+    });
+  } else {
+    Object.entries(input).forEach(([key, value]) => {
+      const newKey = prefix === "" ? key : `${prefix}.${key}`;
+      const flattened = flattenObject(value, newKey);
+      Object.assign(result, flattened);
+    });
+  }
+  return result;
+}
+
 // src/spam-filter/tlds-list.ts
 var tlds = [
   "AAA",
@@ -3651,6 +3674,7 @@ export {
   extractPhraseFromString,
   fibonacciGenerator,
   fiveMinInMs,
+  flattenObject,
   getAssetDisplayName,
   getAssetId,
   getTicker,