@ton/appkit 0.0.1-alpha.2 → 0.0.2

package/dist/esm/utils/arrays/key-by.test.js

@@ -0,0 +1,49 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { describe, expect, it } from 'vitest';
+import { keyBy } from './key-by';
+describe('keyBy', () => {
+    it('should key array by property', () => {
+        const array = [
+            { id: 1, name: 'a' },
+            { id: 2, name: 'b' },
+        ];
+        const result = keyBy(array, (item) => item.id);
+        expect(result).toEqual({
+            1: { id: 1, name: 'a' },
+            2: { id: 2, name: 'b' },
+        });
+    });
+    it('should handle property collision (last wins)', () => {
+        const array = [
+            { id: 1, name: 'a' },
+            { id: 1, name: 'b' },
+        ];
+        // Based on implementation: arr.forEach(...) which iterates in order
+        const result = keyBy(array, (item) => item.id);
+        expect(result).toEqual({
+            1: { id: 1, name: 'b' },
+        });
+    });
+    it('should handle empty array', () => {
+        const array = [];
+        const result = keyBy(array, (item) => item.id);
+        expect(result).toEqual({});
+    });
+    it('should work with string keys', () => {
+        const array = [
+            { id: 'a', val: 1 },
+            { id: 'b', val: 2 },
+        ];
+        const result = keyBy(array, (item) => item.id);
+        expect(result).toEqual({
+            a: { id: 'a', val: 1 },
+            b: { id: 'b', val: 2 },
+        });
+    });
+});

package/dist/esm/utils/arrays/random-from-array.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export declare const randomFromArray: <T>(items: T[]) => T;
+//# sourceMappingURL=random-from-array.d.ts.map

package/dist/esm/utils/arrays/random-from-array.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-from-array.d.ts","sourceRoot":"","sources":["../../../../src/utils/arrays/random-from-array.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,eAAe,GAAI,CAAC,EAAE,OAAO,CAAC,EAAE,KAAG,CAAqD,CAAC"}

package/dist/esm/utils/arrays/random-from-array.js

@@ -0,0 +1,8 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export const randomFromArray = (items) => items[Math.floor(Math.random() * items.length)];

package/dist/esm/utils/arrays/random-from-array.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export {};
+//# sourceMappingURL=random-from-array.test.d.ts.map

package/dist/esm/utils/arrays/random-from-array.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"random-from-array.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/arrays/random-from-array.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/esm/utils/arrays/random-from-array.test.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { describe, expect, it, vi } from 'vitest';
+import { randomFromArray } from './random-from-array';
+describe('randomFromArray', () => {
+    it('should return an item from the array', () => {
+        const array = [1, 2, 3];
+        const item = randomFromArray(array);
+        expect(array).toContain(item);
+    });
+    it('should return undefined for empty array', () => {
+        const array = [];
+        const item = randomFromArray(array);
+        expect(item).toBeUndefined();
+    });
+    it('should work with single item', () => {
+        const array = [42];
+        expect(randomFromArray(array)).toBe(42);
+    });
+    it('should use Math.random', () => {
+        const randomSpy = vi.spyOn(Math, 'random');
+        randomFromArray([1, 2]);
+        expect(randomSpy).toHaveBeenCalled();
+        randomSpy.mockRestore();
+    });
+});

package/dist/esm/utils/errors/get-error-message.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export declare const getErrorMessage: (error: unknown, defaultMessage?: string) => string;
+//# sourceMappingURL=get-error-message.d.ts.map

package/dist/esm/utils/errors/get-error-message.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-error-message.d.ts","sourceRoot":"","sources":["../../../../src/utils/errors/get-error-message.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAOH,eAAO,MAAM,eAAe,GAAI,OAAO,OAAO,EAAE,iBAAiB,MAAM,KAAG,MAUzE,CAAC"}

package/dist/esm/utils/errors/get-error-message.js

@@ -0,0 +1,17 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+const isObjectWithMessage = (toBeDetermined) => !!toBeDetermined && !!toBeDetermined.message;
+export const getErrorMessage = (error, defaultMessage) => {
+    if (typeof error === 'string') {
+        return error;
+    }
+    if (error instanceof Error || isObjectWithMessage(error)) {
+        return error.message;
+    }
+    return defaultMessage || 'Error occurred';
+};

package/dist/esm/utils/errors/get-error-message.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export {};
+//# sourceMappingURL=get-error-message.test.d.ts.map

package/dist/esm/utils/errors/get-error-message.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"get-error-message.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/errors/get-error-message.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/esm/utils/errors/get-error-message.test.js

@@ -0,0 +1,32 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { describe, expect, it } from 'vitest';
+import { getErrorMessage } from './get-error-message';
+describe('getErrorMessage', () => {
+    it('should return error message from Error object', () => {
+        const error = new Error('Something went wrong');
+        expect(getErrorMessage(error)).toBe('Something went wrong');
+    });
+    it('should return string error directly', () => {
+        const error = 'Something went wrong';
+        expect(getErrorMessage(error)).toBe('Something went wrong');
+    });
+    it('should return message from object with message property', () => {
+        const error = { message: 'Something went wrong' };
+        expect(getErrorMessage(error)).toBe('Something went wrong');
+    });
+    it('should return default message if error is unknown object', () => {
+        const error = { foo: 'bar' };
+        expect(getErrorMessage(error, 'Default Message')).toBe('Default Message');
+        expect(getErrorMessage(error)).toBe('Error occurred');
+    });
+    it('should return default message if error is null/undefined', () => {
+        expect(getErrorMessage(null)).toBe('Error occurred');
+        expect(getErrorMessage(undefined)).toBe('Error occurred');
+    });
+});

package/dist/esm/utils/functions/noop.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export declare const noop: () => void;
+//# sourceMappingURL=noop.d.ts.map

package/dist/esm/utils/functions/noop.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"noop.d.ts","sourceRoot":"","sources":["../../../../src/utils/functions/noop.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,IAAI,QAAO,IAEvB,CAAC"}

package/dist/esm/utils/functions/noop.js

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export const noop = () => {
+    //
+};

package/dist/esm/utils/index.d.ts

@@ -0,0 +1,22 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export { formatUnits, parseUnits } from '@ton/walletkit';
+export * from './amount/validate-numeric-string';
+export * from './arrays/key-by';
+export * from './arrays/random-from-array';
+export * from './errors/get-error-message';
+export * from './functions/noop';
+export * from './jetton/jetton-info';
+export * from './nft/nft-info';
+export * from './object/map-values';
+export * from './predicate/is-string';
+export * from './promise/cancel-promise';
+export * from './promise/sleep';
+export * from './query/filter-query-options';
+export * from './string/middle-ellipsis';
+//# sourceMappingURL=index.d.ts.map

package/dist/esm/utils/index.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../../../src/utils/index.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,WAAW,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAEzD,cAAc,kCAAkC,CAAC;AACjD,cAAc,iBAAiB,CAAC;AAChC,cAAc,4BAA4B,CAAC;AAC3C,cAAc,4BAA4B,CAAC;AAC3C,cAAc,kBAAkB,CAAC;AACjC,cAAc,sBAAsB,CAAC;AACrC,cAAc,gBAAgB,CAAC;AAC/B,cAAc,qBAAqB,CAAC;AACpC,cAAc,uBAAuB,CAAC;AACtC,cAAc,0BAA0B,CAAC;AACzC,cAAc,iBAAiB,CAAC;AAChC,cAAc,8BAA8B,CAAC;AAC7C,cAAc,0BAA0B,CAAC"}

package/dist/esm/utils/index.js

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export { formatUnits, parseUnits } from '@ton/walletkit';
+export * from './amount/validate-numeric-string';
+export * from './arrays/key-by';
+export * from './arrays/random-from-array';
+export * from './errors/get-error-message';
+export * from './functions/noop';
+export * from './jetton/jetton-info';
+export * from './nft/nft-info';
+export * from './object/map-values';
+export * from './predicate/is-string';
+export * from './promise/cancel-promise';
+export * from './promise/sleep';
+export * from './query/filter-query-options';
+export * from './string/middle-ellipsis';

package/dist/esm/utils/jetton/jetton-info.d.ts

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type { Jetton } from '@ton/walletkit';
+export declare const getJettonsSymbol: (jetton: Jetton) => string | undefined;
+export declare const getJettonsName: (jetton: Jetton) => string | undefined;
+export declare const getJettonsImage: (jetton: Jetton) => string | undefined;
+export declare const getFormattedJettonInfo: (jetton: Jetton) => {
+    address: string;
+    walletAddress: string;
+    description: string | undefined;
+    name: string | undefined;
+    symbol: string | undefined;
+    image: string | undefined;
+    imageData: string | undefined;
+    balance: string;
+    decimals: number | undefined;
+};
+//# sourceMappingURL=jetton-info.d.ts.map

package/dist/esm/utils/jetton/jetton-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"jetton-info.d.ts","sourceRoot":"","sources":["../../../../src/utils/jetton/jetton-info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,MAAM,EAAE,MAAM,gBAAgB,CAAC;AAE7C,eAAO,MAAM,gBAAgB,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAM1D,CAAC;AAEF,eAAO,MAAM,cAAc,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAMxD,CAAC;AAEF,eAAO,MAAM,eAAe,GAAI,QAAQ,MAAM,KAAG,MAAM,GAAG,SAazD,CAAC;AAEF,eAAO,MAAM,sBAAsB,GAAI,QAAQ,MAAM;;;;;;;;;;CAkBpD,CAAC"}

package/dist/esm/utils/jetton/jetton-info.js

@@ -0,0 +1,48 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export const getJettonsSymbol = (jetton) => {
+    if (!jetton?.info?.symbol) {
+        return;
+    }
+    return jetton.info.symbol;
+};
+export const getJettonsName = (jetton) => {
+    if (!jetton?.info?.name && !jetton?.info?.symbol) {
+        return;
+    }
+    return jetton.info?.name || jetton.info?.symbol || '';
+};
+export const getJettonsImage = (jetton) => {
+    if (!jetton?.info?.image) {
+        return;
+    }
+    return (jetton.info.image.url ||
+        (jetton.info.image.data ? atob(jetton.info.image.data) : undefined) ||
+        jetton.info.image.mediumUrl ||
+        jetton.info.image.largeUrl ||
+        jetton.info.image.smallUrl ||
+        '');
+};
+export const getFormattedJettonInfo = (jetton) => {
+    const jettonName = getJettonsName(jetton);
+    const jettonSymbol = getJettonsSymbol(jetton);
+    const jettonImage = getJettonsImage(jetton);
+    const jettonBalance = jetton.balance || '0';
+    const jettonDecimals = jetton.decimalsNumber;
+    return {
+        address: jetton.address,
+        walletAddress: jetton.walletAddress,
+        description: jetton.info?.description,
+        name: jettonName,
+        symbol: jettonSymbol,
+        image: jettonImage,
+        imageData: jetton.info?.image?.data,
+        balance: jettonBalance,
+        decimals: jettonDecimals,
+    };
+};

package/dist/esm/utils/nft/nft-info.d.ts

@@ -0,0 +1,21 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import type { NFT } from '@ton/walletkit';
+export declare const getNftImage: (nft: NFT) => string | null;
+export declare const getNftName: (nft: NFT) => string;
+export declare const getCollectionName: (nft: NFT) => string;
+export declare const getNftDescription: (nft: NFT) => string | null;
+export declare const getFormattedNftInfo: (nft: NFT) => {
+    address: string;
+    collectionName: string;
+    name: string;
+    image: string | null;
+    description: string | null;
+    isOnSale: boolean | undefined;
+};
+//# sourceMappingURL=nft-info.d.ts.map

package/dist/esm/utils/nft/nft-info.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"nft-info.d.ts","sourceRoot":"","sources":["../../../../src/utils/nft/nft-info.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,KAAK,EAAE,GAAG,EAAE,MAAM,gBAAgB,CAAC;AAI1C,eAAO,MAAM,WAAW,GAAI,KAAK,GAAG,KAAG,MAAM,GAAG,IAmB/C,CAAC;AAEF,eAAO,MAAM,UAAU,GAAI,KAAK,GAAG,KAAG,MAIrC,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,KAAK,GAAG,KAAG,MAE5C,CAAC;AAEF,eAAO,MAAM,iBAAiB,GAAI,KAAK,GAAG,KAAG,MAAM,GAAG,IAErD,CAAC;AAEF,eAAO,MAAM,mBAAmB,GAAI,KAAK,GAAG;;;;;;;CAc3C,CAAC"}

package/dist/esm/utils/nft/nft-info.js

@@ -0,0 +1,57 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { middleEllipsis } from '../string/middle-ellipsis';
+export const getNftImage = (nft) => {
+    if (!nft.info?.image)
+        return null;
+    const { url, data, mediumUrl, smallUrl, largeUrl } = nft.info.image;
+    if (url)
+        return url;
+    if (mediumUrl)
+        return mediumUrl;
+    if (largeUrl)
+        return largeUrl;
+    if (smallUrl)
+        return smallUrl;
+    if (data) {
+        try {
+            return atob(data);
+        }
+        catch {
+            return null;
+        }
+    }
+    return null;
+};
+export const getNftName = (nft) => {
+    if (nft.info?.name)
+        return nft.info.name;
+    if (nft.index)
+        return `NFT #${nft.index}`;
+    return middleEllipsis(nft.address);
+};
+export const getCollectionName = (nft) => {
+    return nft.collection?.name || 'Unknown Collection';
+};
+export const getNftDescription = (nft) => {
+    return nft.info?.description || null;
+};
+export const getFormattedNftInfo = (nft) => {
+    const nftName = getNftName(nft);
+    const nftImage = getNftImage(nft);
+    const collectionName = getCollectionName(nft);
+    const nftDescription = getNftDescription(nft);
+    return {
+        address: nft.address,
+        collectionName,
+        name: nftName,
+        image: nftImage,
+        description: nftDescription,
+        isOnSale: nft.isOnSale,
+    };
+};

package/dist/esm/utils/object/map-values.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export declare function mapValues<T extends object, K extends keyof T, V>(object: T, getNewValue: (value: T[K], key: K, obj: T) => V): Record<K, V>;
+//# sourceMappingURL=map-values.d.ts.map

package/dist/esm/utils/object/map-values.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-values.d.ts","sourceRoot":"","sources":["../../../../src/utils/object/map-values.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,SAAS,CAAC,CAAC,SAAS,MAAM,EAAE,CAAC,SAAS,MAAM,CAAC,EAAE,CAAC,EAC5D,MAAM,EAAE,CAAC,EACT,WAAW,EAAE,CAAC,KAAK,EAAE,CAAC,CAAC,CAAC,CAAC,EAAE,GAAG,EAAE,CAAC,EAAE,GAAG,EAAE,CAAC,KAAK,CAAC,GAChD,MAAM,CAAC,CAAC,EAAE,CAAC,CAAC,CAWd"}

package/dist/esm/utils/object/map-values.js

@@ -0,0 +1,16 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export function mapValues(object, getNewValue) {
+    const result = {};
+    const keys = Object.keys(object);
+    for (const key of keys) {
+        const value = object[key];
+        result[key] = getNewValue(value, key, object);
+    }
+    return result;
+}

package/dist/esm/utils/object/map-values.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export {};
+//# sourceMappingURL=map-values.test.d.ts.map

package/dist/esm/utils/object/map-values.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"map-values.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/object/map-values.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/esm/utils/object/map-values.test.js

@@ -0,0 +1,31 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { describe, expect, it } from 'vitest';
+import { mapValues } from './map-values';
+describe('mapValues', () => {
+    it('should map values of object', () => {
+        const obj = { a: 1, b: 2 };
+        const result = mapValues(obj, (value) => value * 2);
+        expect(result).toEqual({ a: 2, b: 4 });
+    });
+    it('should provide key in callback', () => {
+        const obj = { a: 1, b: 2 };
+        const result = mapValues(obj, (value, key) => `${key}:${value}`);
+        expect(result).toEqual({ a: 'a:1', b: 'b:2' });
+    });
+    it('should handle empty object', () => {
+        const obj = {};
+        const result = mapValues(obj, (value) => value);
+        expect(result).toEqual({});
+    });
+    it('should not mutate original object', () => {
+        const obj = { a: 1 };
+        mapValues(obj, (val) => val + 1);
+        expect(obj).toEqual({ a: 1 });
+    });
+});

package/dist/esm/utils/predicate/is-string.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export declare function isString(value: unknown): value is string;
+//# sourceMappingURL=is-string.d.ts.map

package/dist/esm/utils/predicate/is-string.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-string.d.ts","sourceRoot":"","sources":["../../../../src/utils/predicate/is-string.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,wBAAgB,QAAQ,CAAC,KAAK,EAAE,OAAO,GAAG,KAAK,IAAI,MAAM,CAExD"}

package/dist/esm/utils/predicate/is-string.js

@@ -0,0 +1,10 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export function isString(value) {
+    return typeof value === 'string';
+}

package/dist/esm/utils/predicate/is-string.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export {};
+//# sourceMappingURL=is-string.test.d.ts.map

package/dist/esm/utils/predicate/is-string.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"is-string.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/predicate/is-string.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/esm/utils/predicate/is-string.test.js

@@ -0,0 +1,25 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { describe, expect, it } from 'vitest';
+import { isString } from './is-string';
+describe('isString', () => {
+    it('should return true for strings', () => {
+        expect(isString('hello')).toBe(true);
+        expect(isString('')).toBe(true);
+        expect(isString(String('hello'))).toBe(true);
+    });
+    it('should return false for non-strings', () => {
+        expect(isString(123)).toBe(false);
+        expect(isString(true)).toBe(false);
+        expect(isString({})).toBe(false);
+        expect(isString([])).toBe(false);
+        expect(isString(null)).toBe(false);
+        expect(isString(undefined)).toBe(false);
+        expect(isString(Symbol('sym'))).toBe(false);
+    });
+});

package/dist/esm/utils/promise/cancel-promise.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export declare const cancelPromise: <T>(promise: T, timeoutMs: number) => Promise<T>;
+//# sourceMappingURL=cancel-promise.d.ts.map

package/dist/esm/utils/promise/cancel-promise.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-promise.d.ts","sourceRoot":"","sources":["../../../../src/utils/promise/cancel-promise.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,eAAO,MAAM,aAAa,GAAI,CAAC,EAAE,SAAS,CAAC,EAAE,WAAW,MAAM,KAAG,OAAO,CAAC,CAAC,CAOzE,CAAC"}

package/dist/esm/utils/promise/cancel-promise.js

@@ -0,0 +1,15 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export const cancelPromise = (promise, timeoutMs) => {
+    return Promise.race([
+        promise,
+        new Promise((_, reject) => {
+            setTimeout(() => reject(new Error(`Execution timed out - ${timeoutMs}ms`)), timeoutMs);
+        }),
+    ]);
+};

package/dist/esm/utils/promise/cancel-promise.test.d.ts

@@ -0,0 +1,9 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+export {};
+//# sourceMappingURL=cancel-promise.test.d.ts.map

package/dist/esm/utils/promise/cancel-promise.test.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cancel-promise.test.d.ts","sourceRoot":"","sources":["../../../../src/utils/promise/cancel-promise.test.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG"}

package/dist/esm/utils/promise/cancel-promise.test.js

@@ -0,0 +1,23 @@
+/**
+ * Copyright (c) TonTech.
+ *
+ * This source code is licensed under the MIT license found in the
+ * LICENSE file in the root directory of this source tree.
+ *
+ */
+import { describe, expect, it } from 'vitest';
+import { cancelPromise } from './cancel-promise';
+describe('cancelPromise', () => {
+    it('should resolve if promise resolves before timeout', async () => {
+        const promise = new Promise((resolve) => setTimeout(() => resolve('success'), 10));
+        await expect(cancelPromise(promise, 50)).resolves.toBe('success');
+    });
+    it('should reject if promise times out', async () => {
+        const promise = new Promise((resolve) => setTimeout(() => resolve('success'), 50));
+        await expect(cancelPromise(promise, 10)).rejects.toThrow('Execution timed out - 10ms');
+    });
+    it('should propagate rejection from original promise', async () => {
+        const promise = new Promise((_, reject) => setTimeout(() => reject(new Error('failure')), 10));
+        await expect(cancelPromise(promise, 50)).rejects.toThrow('failure');
+    });
+});