@nktkas/hyperliquid 0.30.3 → 0.32.0

package/script/src/utils/_symbolConverter.d.ts

@@ -1,96 +0,0 @@
-import type { IRequestTransport } from "../transport/mod.js";
-/** Options for creating a {@link SymbolConverter} instance. */
-export interface SymbolConverterOptions {
-    /** Transport instance to use for API requests. */
-    transport: IRequestTransport;
-    /** Optional dex support: array of dex names, true for all dexs, or false/undefined to skip. */
-    dexs?: string[] | boolean;
-}
-/**
- * Utility class for converting asset symbols to their corresponding IDs and size decimals.
- * Supports perpetuals, spot markets, and optional builder dexs.
- *
- * @example
- * ```ts
- * import { HttpTransport } from "@nktkas/hyperliquid";
- * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
- *
- * const transport = new HttpTransport(); // or `WebSocketTransport`
- * const converter = await SymbolConverter.create({ transport });
- *
- * // By default, dexs are not loaded; specify them when creating an instance
- * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
- *
- * const btcId = converter.getAssetId("BTC"); // perpetual → 0
- * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
- * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
- *
- * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
- * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
- * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
- *
- * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
- * ```
- *
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
- */
-export declare class SymbolConverter {
-    #private;
-    /**
-     * Creates a new SymbolConverter instance, but does not initialize it.
-     * Run {@link reload} to load asset data or use {@link create} to create and initialize in one step.
-     *
-     * @param options - Configuration options including transport and optional dex support.
-     */
-    constructor(options: SymbolConverterOptions);
-    /**
-     * Create and initialize a SymbolConverter instance.
-     *
-     * @param options - Configuration options including transport and optional dex support.
-     *
-     * @returns Initialized SymbolConverter instance.
-     *
-     * @example
-     * ```ts
-     * import { HttpTransport } from "@nktkas/hyperliquid";
-     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
-     *
-     * const transport = new HttpTransport(); // or `WebSocketTransport`
-     * const converter = await SymbolConverter.create({ transport });
-     * ```
-     */
-    static create(options: SymbolConverterOptions): Promise<SymbolConverter>;
-    /**
-     * Reload asset mappings from the API.
-     *
-     * Useful for refreshing data when new assets are added.
-     */
-    reload(): Promise<void>;
-    /**
-     * Get asset ID for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     *
-     * @example "BTC" → 0, "HYPE/USDC" → 10107, "test:ABC" → 110000
-     */
-    getAssetId(name: string): number | undefined;
-    /**
-     * Get size decimals for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     *
-     * @example "BTC" → 5, "HYPE/USDC" → 2, "test:ABC" → 0
-     */
-    getSzDecimals(name: string): number | undefined;
-    /**
-     * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
-     *
-     * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
-     *
-     * @example "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
-     */
-    getSpotPairId(name: string): string | undefined;
-}
-//# sourceMappingURL=_symbolConverter.d.ts.map

package/script/src/utils/_symbolConverter.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"_symbolConverter.d.ts","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,iBAAiB,EAAE,MAAM,qBAAqB,CAAC;AAU7D,+DAA+D;AAC/D,MAAM,WAAW,sBAAsB;IACrC,kDAAkD;IAClD,SAAS,EAAE,iBAAiB,CAAC;IAC7B,+FAA+F;IAC/F,IAAI,CAAC,EAAE,MAAM,EAAE,GAAG,OAAO,CAAC;CAC3B;AAED;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,qBAAa,eAAe;;IAO1B;;;;;OAKG;gBACS,OAAO,EAAE,sBAAsB;IAK3C;;;;;;;;;;;;;;;OAeG;WACU,MAAM,CAAC,OAAO,EAAE,sBAAsB,GAAG,OAAO,CAAC,eAAe,CAAC;IAM9E;;;;OAIG;IACG,MAAM,IAAI,OAAO,CAAC,IAAI,CAAC;IAiG7B;;;;;;;OAOG;IACH,UAAU,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI5C;;;;;;;OAOG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;IAI/C;;;;;;OAMG;IACH,aAAa,CAAC,IAAI,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS;CAGhD"}

package/script/src/utils/_symbolConverter.js

@@ -1,190 +0,0 @@
-"use strict";
-Object.defineProperty(exports, "__esModule", { value: true });
-exports.SymbolConverter = void 0;
-const mod_js_1 = require("../api/info/mod.js");
-/**
- * Utility class for converting asset symbols to their corresponding IDs and size decimals.
- * Supports perpetuals, spot markets, and optional builder dexs.
- *
- * @example
- * ```ts
- * import { HttpTransport } from "@nktkas/hyperliquid";
- * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
- *
- * const transport = new HttpTransport(); // or `WebSocketTransport`
- * const converter = await SymbolConverter.create({ transport });
- *
- * // By default, dexs are not loaded; specify them when creating an instance
- * // const converter = await SymbolConverter.create({ transport, dexs: ["test"] });
- *
- * const btcId = converter.getAssetId("BTC"); // perpetual → 0
- * const hypeUsdcId = converter.getAssetId("HYPE/USDC"); // spot market → 10107
- * const dexAbcId = converter.getAssetId("test:ABC"); // builder dex (if enabled) → 110000
- *
- * const btcSzDecimals = converter.getSzDecimals("BTC"); // perpetual → 5
- * const hypeUsdcSzDecimals = converter.getSzDecimals("HYPE/USDC"); // spot market → 2
- * const dexAbcSzDecimals = converter.getSzDecimals("test:ABC"); // builder dex (if enabled) → 0
- *
- * const spotPairId = converter.getSpotPairId("HFUN/USDC"); // → "@2"
- * ```
- *
- * @see https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/asset-ids
- */
-class SymbolConverter {
-    #transport;
-    #dexOption;
-    #nameToAssetId = new Map();
-    #nameToSzDecimals = new Map();
-    #nameToSpotPairId = new Map();
-    /**
-     * Creates a new SymbolConverter instance, but does not initialize it.
-     * Run {@link reload} to load asset data or use {@link create} to create and initialize in one step.
-     *
-     * @param options - Configuration options including transport and optional dex support.
-     */
-    constructor(options) {
-        this.#transport = options.transport;
-        this.#dexOption = options.dexs ?? false;
-    }
-    /**
-     * Create and initialize a SymbolConverter instance.
-     *
-     * @param options - Configuration options including transport and optional dex support.
-     *
-     * @returns Initialized SymbolConverter instance.
-     *
-     * @example
-     * ```ts
-     * import { HttpTransport } from "@nktkas/hyperliquid";
-     * import { SymbolConverter } from "@nktkas/hyperliquid/utils";
-     *
-     * const transport = new HttpTransport(); // or `WebSocketTransport`
-     * const converter = await SymbolConverter.create({ transport });
-     * ```
-     */
-    static async create(options) {
-        const instance = new SymbolConverter(options);
-        await instance.reload();
-        return instance;
-    }
-    /**
-     * Reload asset mappings from the API.
-     *
-     * Useful for refreshing data when new assets are added.
-     */
-    async reload() {
-        const config = { transport: this.#transport };
-        const needDexs = this.#dexOption === true || (Array.isArray(this.#dexOption) && this.#dexOption.length > 0);
-        const [perpMetaData, spotMetaData, perpDexsData] = await Promise.all([
-            (0, mod_js_1.meta)(config),
-            (0, mod_js_1.spotMeta)(config),
-            needDexs ? (0, mod_js_1.perpDexs)(config) : undefined,
-        ]);
-        if (!perpMetaData?.universe?.length) {
-            throw new Error("Invalid perpetual metadata response");
-        }
-        if (!spotMetaData?.universe?.length || !spotMetaData?.tokens?.length) {
-            throw new Error("Invalid spot metadata response");
-        }
-        this.#nameToAssetId.clear();
-        this.#nameToSzDecimals.clear();
-        this.#nameToSpotPairId.clear();
-        this.#processDefaultPerps(perpMetaData);
-        this.#processSpotAssets(spotMetaData);
-        // Only process builder dexs if dex support is enabled
-        if (perpDexsData) {
-            await this.#processBuilderDexs(perpDexsData);
-        }
-    }
-    #processDefaultPerps(perpMetaData) {
-        perpMetaData.universe.forEach((asset, index) => {
-            this.#nameToAssetId.set(asset.name, index);
-            this.#nameToSzDecimals.set(asset.name, asset.szDecimals);
-        });
-    }
-    async #processBuilderDexs(perpDexsData) {
-        if (!perpDexsData || perpDexsData.length <= 1)
-            return;
-        const builderDexs = perpDexsData
-            .map((dex, index) => ({ dex, index }))
-            .filter((item) => {
-            return item.index > 0 && item.dex !== null && item.dex.name.length > 0;
-        });
-        if (builderDexs.length === 0)
-            return;
-        // Filter dexs based on the dexOption
-        const dexsToProcess = Array.isArray(this.#dexOption)
-            ? builderDexs.filter((item) => this.#dexOption.includes(item.dex.name))
-            : builderDexs; // true means process all
-        if (dexsToProcess.length === 0)
-            return;
-        const config = { transport: this.#transport };
-        const results = await Promise.allSettled(dexsToProcess.map((item) => (0, mod_js_1.meta)(config, { dex: item.dex.name })));
-        results.forEach((result, idx) => {
-            if (result.status !== "fulfilled")
-                return;
-            this.#processBuilderDexResult(result.value, dexsToProcess[idx].index);
-        });
-    }
-    #processBuilderDexResult(dexMeta, perpDexIndex) {
-        const offset = 100000 + perpDexIndex * 10000;
-        dexMeta.universe.forEach((asset, index) => {
-            const assetId = offset + index;
-            this.#nameToAssetId.set(asset.name, assetId);
-            this.#nameToSzDecimals.set(asset.name, asset.szDecimals);
-        });
-    }
-    #processSpotAssets(spotMetaData) {
-        const tokenMap = new Map();
-        spotMetaData.tokens.forEach((token) => {
-            tokenMap.set(token.index, { name: token.name, szDecimals: token.szDecimals });
-        });
-        spotMetaData.universe.forEach((market) => {
-            if (market.tokens.length < 2)
-                return;
-            const baseToken = tokenMap.get(market.tokens[0]);
-            const quoteToken = tokenMap.get(market.tokens[1]);
-            if (!baseToken || !quoteToken)
-                return;
-            const assetId = 10000 + market.index;
-            const baseQuoteKey = `${baseToken.name}/${quoteToken.name}`;
-            this.#nameToAssetId.set(baseQuoteKey, assetId);
-            this.#nameToSzDecimals.set(baseQuoteKey, baseToken.szDecimals);
-            this.#nameToSpotPairId.set(baseQuoteKey, market.name);
-        });
-    }
-    /**
-     * Get asset ID for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     *
-     * @example "BTC" → 0, "HYPE/USDC" → 10107, "test:ABC" → 110000
-     */
-    getAssetId(name) {
-        return this.#nameToAssetId.get(name);
-    }
-    /**
-     * Get size decimals for a coin.
-     * - For Perpetuals, use the coin name (e.g., "BTC").
-     * - For Spot markets, use the "BASE/QUOTE" format (e.g., "HYPE/USDC").
-     * - For Builder Dex assets, use the "DEX_NAME:ASSET_NAME" format (e.g., "test:ABC").
-     *
-     * @example "BTC" → 5, "HYPE/USDC" → 2, "test:ABC" → 0
-     */
-    getSzDecimals(name) {
-        return this.#nameToSzDecimals.get(name);
-    }
-    /**
-     * Get spot pair ID for info endpoints and subscriptions (e.g., l2book, trades).
-     *
-     * Accepts spot markets in the "BASE/QUOTE" format (e.g., "HFUN/USDC").
-     *
-     * @example "HFUN/USDC" → "@2", "PURR/USDC" → "PURR/USDC"
-     */
-    getSpotPairId(name) {
-        return this.#nameToSpotPairId.get(name);
-    }
-}
-exports.SymbolConverter = SymbolConverter;
-//# sourceMappingURL=_symbolConverter.js.map

package/script/src/utils/_symbolConverter.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"_symbolConverter.js","sourceRoot":"","sources":["../../../src/src/utils/_symbolConverter.ts"],"names":[],"mappings":";;;AACA,+CAO4B;AAU5B;;;;;;;;;;;;;;;;;;;;;;;;;;;GA2BG;AACH,MAAa,eAAe;IAC1B,UAAU,CAAoB;IAC9B,UAAU,CAAqB;IAC/B,cAAc,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC3C,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAC9C,iBAAiB,GAAG,IAAI,GAAG,EAAkB,CAAC;IAE9C;;;;;OAKG;IACH,YAAY,OAA+B;QACzC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,SAAS,CAAC;QACpC,IAAI,CAAC,UAAU,GAAG,OAAO,CAAC,IAAI,IAAI,KAAK,CAAC;IAC1C,CAAC;IAED;;;;;;;;;;;;;;;OAeG;IACH,MAAM,CAAC,KAAK,CAAC,MAAM,CAAC,OAA+B;QACjD,MAAM,QAAQ,GAAG,IAAI,eAAe,CAAC,OAAO,CAAC,CAAC;QAC9C,MAAM,QAAQ,CAAC,MAAM,EAAE,CAAC;QACxB,OAAO,QAAQ,CAAC;IAClB,CAAC;IAED;;;;OAIG;IACH,KAAK,CAAC,MAAM;QACV,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,QAAQ,GAAG,IAAI,CAAC,UAAU,KAAK,IAAI,IAAI,CAAC,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC,IAAI,IAAI,CAAC,UAAU,CAAC,MAAM,GAAG,CAAC,CAAC,CAAC;QAE5G,MAAM,CAAC,YAAY,EAAE,YAAY,EAAE,YAAY,CAAC,GAAG,MAAM,OAAO,CAAC,GAAG,CAAC;YACnE,IAAA,aAAI,EAAC,MAAM,CAAC;YACZ,IAAA,iBAAQ,EAAC,MAAM,CAAC;YAChB,QAAQ,CAAC,CAAC,CAAC,IAAA,iBAAQ,EAAC,MAAM,CAAC,CAAC,CAAC,CAAC,SAAS;SACxC,CAAC,CAAC;QAEH,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,EAAE,CAAC;YACpC,MAAM,IAAI,KAAK,CAAC,qCAAqC,CAAC,CAAC;QACzD,CAAC;QAED,IAAI,CAAC,YAAY,EAAE,QAAQ,EAAE,MAAM,IAAI,CAAC,YAAY,EAAE,MAAM,EAAE,MAAM,EAAE,CAAC;YACrE,MAAM,IAAI,KAAK,CAAC,gCAAgC,CAAC,CAAC;QACpD,CAAC;QAED,IAAI,CAAC,cAAc,CAAC,KAAK,EAAE,CAAC;QAC5B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAC/B,IAAI,CAAC,iBAAiB,CAAC,KAAK,EAAE,CAAC;QAE/B,IAAI,CAAC,oBAAoB,CAAC,YAAY,CAAC,CAAC;QACxC,IAAI,CAAC,kBAAkB,CAAC,YAAY,CAAC,CAAC;QAEtC,sDAAsD;QACtD,IAAI,YAAY,EAAE,CAAC;YACjB,MAAM,IAAI,CAAC,mBAAmB,CAAC,YAAY,CAAC,CAAC;QAC/C,CAAC;IACH,CAAC;IAED,oBAAoB,CAAC,YAA0B;QAC7C,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YAC7C,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,CAAC;YAC3C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,KAAK,CAAC,mBAAmB,CAAC,YAA8B;QACtD,IAAI,CAAC,YAAY,IAAI,YAAY,CAAC,MAAM,IAAI,CAAC;YAAE,OAAO;QAEtD,MAAM,WAAW,GAAG,YAAY;aAC7B,GAAG,CAAC,CAAC,GAAG,EAAE,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,GAAG,EAAE,KAAK,EAAE,CAAC,CAAC;aACrC,MAAM,CAAC,CAAC,IAAI,EAAyE,EAAE;YACtF,OAAO,IAAI,CAAC,KAAK,GAAG,CAAC,IAAI,IAAI,CAAC,GAAG,KAAK,IAAI,IAAI,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,MAAM,GAAG,CAAC,CAAC;QACzE,CAAC,CAAC,CAAC;QAEL,IAAI,WAAW,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAErC,qCAAqC;QACrC,MAAM,aAAa,GAAG,KAAK,CAAC,OAAO,CAAC,IAAI,CAAC,UAAU,CAAC;YAClD,CAAC,CAAC,WAAW,CAAC,MAAM,CAAC,CAAC,IAAI,EAAE,EAAE,CAAE,IAAI,CAAC,UAAuB,CAAC,QAAQ,CAAC,IAAI,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;YACrF,CAAC,CAAC,WAAW,CAAC,CAAC,yBAAyB;QAE1C,IAAI,aAAa,CAAC,MAAM,KAAK,CAAC;YAAE,OAAO;QAEvC,MAAM,MAAM,GAAG,EAAE,SAAS,EAAE,IAAI,CAAC,UAAU,EAAE,CAAC;QAC9C,MAAM,OAAO,GAAG,MAAM,OAAO,CAAC,UAAU,CACtC,aAAa,CAAC,GAAG,CAAC,CAAC,IAAI,EAAE,EAAE,CAAC,IAAA,aAAI,EAAC,MAAM,EAAE,EAAE,GAAG,EAAE,IAAI,CAAC,GAAG,CAAC,IAAI,EAAE,CAAC,CAAC,CAClE,CAAC;QAEF,OAAO,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,GAAG,EAAE,EAAE;YAC9B,IAAI,MAAM,CAAC,MAAM,KAAK,WAAW;gBAAE,OAAO;YAC1C,IAAI,CAAC,wBAAwB,CAAC,MAAM,CAAC,KAAK,EAAE,aAAa,CAAC,GAAG,CAAC,CAAC,KAAK,CAAC,CAAC;QACxE,CAAC,CAAC,CAAC;IACL,CAAC;IAED,wBAAwB,CAAC,OAAqB,EAAE,YAAoB;QAClE,MAAM,MAAM,GAAG,MAAM,GAAG,YAAY,GAAG,KAAK,CAAC;QAE7C,OAAO,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,KAAK,EAAE,EAAE;YACxC,MAAM,OAAO,GAAG,MAAM,GAAG,KAAK,CAAC;YAC/B,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,OAAO,CAAC,CAAC;YAC7C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,KAAK,CAAC,IAAI,EAAE,KAAK,CAAC,UAAU,CAAC,CAAC;QAC3D,CAAC,CAAC,CAAC;IACL,CAAC;IAED,kBAAkB,CAAC,YAA8B;QAC/C,MAAM,QAAQ,GAAG,IAAI,GAAG,EAAgD,CAAC;QACzE,YAAY,CAAC,MAAM,CAAC,OAAO,CAAC,CAAC,KAAK,EAAE,EAAE;YACpC,QAAQ,CAAC,GAAG,CAAC,KAAK,CAAC,KAAK,EAAE,EAAE,IAAI,EAAE,KAAK,CAAC,IAAI,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC;QAChF,CAAC,CAAC,CAAC;QAEH,YAAY,CAAC,QAAQ,CAAC,OAAO,CAAC,CAAC,MAAM,EAAE,EAAE;YACvC,IAAI,MAAM,CAAC,MAAM,CAAC,MAAM,GAAG,CAAC;gBAAE,OAAO;YACrC,MAAM,SAAS,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YACjD,MAAM,UAAU,GAAG,QAAQ,CAAC,GAAG,CAAC,MAAM,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC;YAClD,IAAI,CAAC,SAAS,IAAI,CAAC,UAAU;gBAAE,OAAO;YAEtC,MAAM,OAAO,GAAG,KAAK,GAAG,MAAM,CAAC,KAAK,CAAC;YACrC,MAAM,YAAY,GAAG,GAAG,SAAS,CAAC,IAAI,IAAI,UAAU,CAAC,IAAI,EAAE,CAAC;YAC5D,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,YAAY,EAAE,OAAO,CAAC,CAAC;YAC/C,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,SAAS,CAAC,UAAU,CAAC,CAAC;YAC/D,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,YAAY,EAAE,MAAM,CAAC,IAAI,CAAC,CAAC;QACxD,CAAC,CAAC,CAAC;IACL,CAAC;IAED;;;;;;;OAOG;IACH,UAAU,CAAC,IAAY;QACrB,OAAO,IAAI,CAAC,cAAc,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IACvC,CAAC;IAED;;;;;;;OAOG;IACH,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;IAED;;;;;;OAMG;IACH,aAAa,CAAC,IAAY;QACxB,OAAO,IAAI,CAAC,iBAAiB,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC;IAC1C,CAAC;CACF;AAhLD,0CAgLC"}

package/script/src/utils/mod.d.ts.map

@@ -1 +0,0 @@
-{"version":3,"file":"mod.d.ts","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":"AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;AAEH,cAAc,uBAAuB,CAAC;AACtC,cAAc,cAAc,CAAC"}

package/script/src/utils/mod.js.map

@@ -1 +0,0 @@
-{"version":3,"file":"mod.js","sourceRoot":"","sources":["../../../src/src/utils/mod.ts"],"names":[],"mappings":";AAAA;;;;;;;;;;;;;;;;;;;;;;;GAuBG;;;;;;;;;;;;;;;;AAEH,wDAAsC;AACtC,+CAA6B"}

package/src/bin/_utils.ts

@@ -1,344 +0,0 @@
-/**
- * Utility functions for command-line argument parsing and transformation.
- * More useful for working with proxy arguments.
- *
- * @example
- * ```ts
- * import { extractArgs, transformArgs } from "./_utils.ts";
- *
- * const args = ["info", "meta", "--user", "0x1234", "--limit", "10", "--verbose"];
- * const rawArgs = extractArgs(args, { flags: ["verbose"] });
- * // { _: ["info", "meta"], user: "0x1234", limit: "10", verbose: "true" }
- *
- * const typedArgs = transformArgs(rawArgs);
- * // { _: ["info", "meta"], user: "0x1234", limit: 10, verbose: true }
- * ```
- *
- * @module
- */
-
-// ============================================================
-// Extract Args
-// ============================================================
-
-export type RawArgs<
-  Collect extends boolean = true,
-  DoubleDash extends boolean = false,
-> =
-  & { _: string[] }
-  & (DoubleDash extends true ? { "--": string[] } : { "--"?: never })
-  & Record<string, Collect extends false ? string : string | string[]>;
-
-export type ExtractOptions<
-  Collect extends boolean = true,
-  DoubleDash extends boolean = false,
-> = {
-  /**
-   * Consider these keys as flags (no value expected).
-   * Value going after a flag will be treated as a positional argument.
-   */
-  flags?: string[];
-  /**
-   * Collect repeated options into arrays.
-   * - `true` - repeated keys accumulate values into an array.
-   * - `false` - later values overwrite earlier ones.
-   * @default true
-   */
-  collect?: Collect;
-  /**
-   * Handle `--no-*` as negation (sets value to "false").
-   * - `true` - `--no-foo` becomes `{ foo: "false" }`.
-   * - `false` - `--no-foo` becomes `{ "no-foo": "true" }`.
-   * @default true
-   */
-  negatable?: boolean;
-  /**
-   * Store arguments after `--` in a separate array.
-   * - `true` - arguments after `--` are stored in `"--"` array.
-   * - `false` - arguments after `--` are added to `_` array.
-   * @default false
-   */
-  doubleDash?: DoubleDash;
-};
-
-/** Check if next argument can be used as a value. */
-function isValidValue(nextArg: string | undefined): nextArg is string {
-  if (typeof nextArg !== "string") return false;
-  // Allow negative numbers as values (e.g., -5, -3.14)
-  if (nextArg.startsWith("-") && isNaN(Number(nextArg))) return false;
-  return true;
-}
-
-/** Set value for a key, with optional array collection on repeat. */
-function setValue(
-  result: Record<string, string | string[]>,
-  key: string,
-  value: string,
-  collect: boolean,
-): void {
-  if (key in result && collect) {
-    // Key already exists and collect is enabled - convert to array or push
-    const existing = result[key];
-    if (Array.isArray(existing)) {
-      existing.push(value); // Already an array - just push
-    } else {
-      result[key] = [existing, value]; // First repeat - convert to array
-    }
-  } else {
-    // First occurrence or collect disabled - set/overwrite value
-    result[key] = value;
-  }
-}
-
-/** Extract command-line arguments into a key-value object (does not transform values). */
-export function extractArgs<
-  Collect extends boolean = true,
-  DoubleDash extends boolean = false,
->(
-  args: string[],
-  options?: ExtractOptions<Collect, DoubleDash>,
-): RawArgs<Collect, DoubleDash> {
-  const flags = options?.flags ?? [];
-  const collect = options?.collect ?? true;
-  const negatable = options?.negatable ?? true;
-  const doubleDash = options?.doubleDash ?? false;
-
-  const result = (doubleDash ? { _: [], "--": [] } : { _: [] }) as unknown as RawArgs<Collect, DoubleDash>;
-  let terminated = false; // After "--", all args are positional
-
-  for (let i = 0; i < args.length; i++) {
-    const arg = args[i];
-
-    // After "--" terminator, all arguments are positional
-    if (terminated) {
-      if (doubleDash) {
-        (result as RawArgs<Collect, true>)["--"].push(arg);
-      } else {
-        result._.push(arg);
-      }
-      continue;
-    }
-
-    // Options terminator: "--"
-    if (arg === "--") {
-      terminated = true;
-      continue;
-    }
-
-    // Positional argument (doesn't start with "-")
-    if (!arg.startsWith("-")) {
-      result._.push(arg);
-      continue;
-    }
-
-    const isLongOption = arg.startsWith("--");
-
-    // Handle long options (--key, --key=value, --no-key)
-    if (isLongOption) {
-      const rawKey = arg.slice(2);
-      const equalsIndex = rawKey.indexOf("=");
-      const hasInlineValue = equalsIndex !== -1;
-
-      let key = hasInlineValue ? rawKey.substring(0, equalsIndex) : rawKey;
-
-      // Skip reserved keys "_" and "--"
-      if (key === "_" || key === "--") continue;
-
-      let value: string;
-
-      if (negatable && key.startsWith("no-") && !hasInlineValue) { // Handle --no-* negation
-        key = key.slice(3); // Remove "no-" prefix
-        value = "false";
-      } else if (hasInlineValue) { // Handle --key=value
-        value = rawKey.substring(equalsIndex + 1);
-      } else if (!flags.includes(key) && isValidValue(args[i + 1])) { // Handle --key value
-        value = args[++i];
-      } else { // Flag without value
-        value = "true";
-      }
-
-      setValue(result, key, value, collect);
-    } // Handle short options (-v, -f value, -abc)
-    else {
-      const chars = arg.slice(1);
-
-      // Single short option: -f
-      if (chars.length === 1) {
-        const key = chars;
-        if (key === "_") continue; // Skip reserved key
-
-        let value: string;
-        if (!flags.includes(key) && isValidValue(args[i + 1])) { // Handle -f value
-          value = args[++i];
-        } else { // Flag without value
-          value = "true";
-        }
-        setValue(result, key, value, collect);
-      } // Grouped short flags: -abc → a, b, c (all flags, no values)
-      else {
-        for (const char of chars) {
-          if (char === "_") continue; // Skip reserved key
-          setValue(result, char, "true", collect);
-        }
-      }
-    }
-  }
-
-  return result;
-}
-
-// ============================================================
-// Transform Args
-// ============================================================
-
-export interface TransformOptions {
-  /**
-   * Transform rule for null values.
-   * @value `"null"` (case insensitive)
-   * @default null
-   */
-  null?: "null" | "string";
-  /**
-   * Transform rule for boolean values.
-   * @value `"true"` / `"false"` (case insensitive)
-   * @default bool
-   */
-  bool?: "bool" | "string";
-  /**
-   * Transform rule for hexadecimal values.
-   * @value `"0xff"` (case insensitive) (0x prefix required)
-   * @default "string"
-   */
-  hex?: "string" | "number";
-  /**
-   * Transform rule for special numeric values.
-   * @value `"Infinity"` / `"NaN"` (case insensitive) (may include leading sign)
-   * @default "number"
-   */
-  specialNumber?: "string" | "number";
-  /**
-   * Transform rule for numeric values.
-   * @value `"123"` / `"12.3"` / `"1e+2"` / `"-123"` (anything that can be parsed by `Number(value)`; excludes hex values)
-   * @default "number"
-   */
-  number?: "number" | "string";
-  /**
-   * Transform rule for JSON object/array values.
-   * @value `"{ \"a\": 1 }"`, `"[invalid array string]"` (anything that begins with `{` and ends with `}` or begins with `[` and ends with `]`)
-   * @default "object"
-   */
-  json?: "object" | "string";
-}
-
-type TransformedValue = string | number | boolean | null | Record<string, unknown> | unknown[];
-
-export type Args<
-  Collect extends boolean = true,
-  DoubleDash extends boolean = false,
-> =
-  & { _: string[] }
-  & (DoubleDash extends true ? { "--": string[] } : { "--"?: never })
-  & Record<string, Collect extends false ? TransformedValue : TransformedValue | TransformedValue[]>;
-
-/** Transform a single string value based on rules. */
-function transformValue(
-  value: string,
-  opts: {
-    null: "null" | "string";
-    bool: "bool" | "string";
-    hex: "string" | "number";
-    specialNumber: "string" | "number";
-    number: "number" | "string";
-    json: "object" | "string";
-  },
-): Args[string] {
-  // null
-  if (value.toLowerCase() === "null") {
-    return opts.null === "null" ? null : value;
-  }
-  // boolean
-  if (value.toLowerCase() === "true" || value.toLowerCase() === "false") {
-    return opts.bool === "bool" ? value.toLowerCase() === "true" : value;
-  }
-  // hex
-  if (
-    (value.startsWith("0x") || value.startsWith("0X")) &&
-    !isNaN(Number(value))
-  ) {
-    return opts.hex === "string" ? value : Number(value);
-  }
-  // special number
-  if (
-    value.toLowerCase() === "infinity" ||
-    value.toLowerCase() === "-infinity" ||
-    value.toLowerCase() === "nan" ||
-    value.toLowerCase() === "-nan"
-  ) {
-    return opts.specialNumber === "string" ? value : Number(value);
-  }
-  // number
-  if (!isNaN(Number(value))) {
-    return opts.number === "number" ? Number(value) : value;
-  }
-  // json object/array
-  if (
-    (value.startsWith("{") && value.endsWith("}")) ||
-    (value.startsWith("[") && value.endsWith("]"))
-  ) {
-    if (opts.json === "object") {
-      try {
-        return JSON.parse(value);
-      } catch { /** Ignore invalid JSON */ }
-    }
-    return value; // as string if parsing fails or opts is "string"
-  }
-  // string (default)
-  return value;
-}
-
-/**
- * Transform raw args (string values) into typed args based on rules.
- *
- * Order of transformation:
- * 1. null (`"null"`)
- * 2. boolean (`"true"`, `"false"`)
- * 3. hex (`"0x..."`)
- * 4. special number (`"Infinity"`, `"-Infinity"`, `"NaN", "-NaN"`)
- * 5. number (numeric strings)
- * 6. json (object/array strings)
- * 7. string (default)
- */
-export function transformArgs<
-  Collect extends boolean = true,
-  DoubleDash extends boolean = false,
->(
-  args: RawArgs<Collect, DoubleDash>,
-  options?: TransformOptions,
-): Args<Collect, DoubleDash> {
-  const opts = {
-    null: options?.null ?? "null",
-    bool: options?.bool ?? "bool",
-    hex: options?.hex ?? "string",
-    specialNumber: options?.specialNumber ?? "number",
-    number: options?.number ?? "number",
-    json: options?.json ?? "object",
-  } as const;
-
-  const result = ("--" in args ? { _: args._, "--": args["--"] } : { _: args._ }) as unknown as Args<
-    Collect,
-    DoubleDash
-  >;
-  for (const key in args) {
-    if (key === "_" || key === "--") continue; // Skip positional args arrays
-
-    const value = args[key];
-
-    // Handle arrays (repeated options)
-    if (Array.isArray(value)) {
-      result[key] = value.map((v) => transformValue(v, opts));
-    } else {
-      result[key] = transformValue(value, opts);
-    }
-  }
-  return result;
-}