@nktkas/hyperliquid 0.25.0-beta.2 → 0.25.0-beta.4

package/README.md

@@ -23,7 +23,7 @@ runtimes, written in TypeScript.
 > [!NOTE]
 > While this library is in TypeScript, it can also be used in JavaScript and supports ESM/CommonJS.
 
-### Node.js (choose your package manager)
+### Node.js v20+ (choose your package manager)
 
 ```
 npm i @nktkas/hyperliquid
@@ -33,7 +33,21 @@ pnpm add @nktkas/hyperliquid
 yarn add @nktkas/hyperliquid
 ```
 
-### Deno
+If you are using **Node.js v20 specifically** and intend to use [`WebSocketTransport`](#websocket-transport), you need
+to install the [`ws`](https://www.npmjs.com/package/ws) package and pass the `WebSocket` class to the constructor:
+
+```ts
+import WebSocket from "ws"; // install `ws` package
+import * as hl from "@nktkas/hyperliquid";
+
+const transport = new hl.WebSocketTransport({
+    reconnect: {
+        WebSocket, // pass `WebSocket` class from `ws` package
+    },
+});
+```
+
+### Deno v2.0+
 
 ```
 deno add jsr:@nktkas/hyperliquid
@@ -41,79 +55,41 @@ deno add jsr:@nktkas/hyperliquid
 
 ### Web
 
+The SDK is fully browser-compatible; integrate it via CDN or bundle it with your application.
+
 ```html
 <script type="module">
     import * as hl from "https://esm.sh/jsr/@nktkas/hyperliquid";
 </script>
 ```
 
-### React Native
+### React Native v0.74.5 / Expo v51
 
-<details>
-<summary>For React Native, you need to import polyfills before importing the SDK:</summary>
-
-```js
-// React Native v0.79 / Expo v53
-// Issues:
-// - signing: does not support private keys directly, use `viem` or `ethers`
-
-import "event-target-polyfill"; // for `WebSocketTransport`
-// or
-// import { Event, EventTarget } from "event-target-shim";
-// if (!globalThis.EventTarget || !globalThis.Event) {
-//     globalThis.EventTarget = EventTarget;
-//     globalThis.Event = Event;
-// }
+For React Native, you need to import polyfills before importing the SDK:
 
-if (!globalThis.CustomEvent) { // for `WebSocketTransport`
-    globalThis.CustomEvent = function (type, params) {
-        params = params || {};
-        const event = new Event(type, params);
-        event.detail = params.detail || null;
-        return event;
-    };
-}
+```ts
+import "fast-text-encoding"; // `TextEncoder` (utf-8)
+import "event-target-polyfill"; // `EventTarget`, `Event`
+import * as hl from "@nktkas/hyperliquid";
+```
 
-if (!Promise.withResolvers) { // for `WebSocketTransport`
-    Promise.withResolvers = function () {
-        let resolve, reject;
-        const promise = new Promise((res, rej) => {
-            resolve = res;
-            reject = rej;
-        });
-        return { promise, resolve, reject };
-    };
-}
+<details>
+<summary>Issues:</summary>
 
-if (!AbortSignal.any) {
-    AbortSignal.any = function (signals) {
-        const controller = new AbortController();
-        for (const signal of signals) {
-            if (signal.aborted) {
-                controller.abort(signal.reason);
-                return controller.signal;
-            }
-            signal.addEventListener("abort", () => {
-                controller.abort(signal.reason);
-            }, { once: true, signal: controller.signal });
-        }
-        return controller.signal;
-    };
-}
-
-if (!AbortSignal.timeout) {
-    AbortSignal.timeout = function (delay) {
-        const controller = new AbortController();
-        setTimeout(() => controller.abort(), delay);
-        return controller.signal;
-    };
-}
-```
+- signing: doesn't support a private key directly as a wallet, use `viem` or `ethers` instead
 
 </details>
 
 ## Quick Start
 
+### CLI
+
+The SDK includes a command-line interface for quick interactions with Hyperliquid API without writing code.
+
+```bash
+npx @nktkas/hyperliquid --help
+```
+
 ### [Info endpoint](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/info-endpoint)
 
 ```ts
@@ -189,6 +165,7 @@ const multiSignClient = new hl.MultiSignClient({
     multiSignAddress: "0x...",
     signers: [
         "0x...", // `viem`, `ethers`, or private key directly
+        // ... more signers
     ],
 });
 
@@ -206,10 +183,10 @@ First, choose and configure your transport layer (more details in the [API Refer
 import * as hl from "@nktkas/hyperliquid";
 
 // 1. HTTP Transport: suitable for one-time requests or serverless environments
-const httpTransport = new hl.HttpTransport({...}); // Accepts optional parameters (e.g. isTestnet, timeout, etc.)
+const httpTransport = new hl.HttpTransport({ ... }); // Accepts optional parameters (e.g. isTestnet, timeout, etc.)
 
 // 2. WebSocket Transport: has better network latency than HTTP transport
-const wsTransport = new hl.WebSocketTransport({...}); // Accepts optional parameters (e.g. url, isTestnet, timeout, reconnect, etc.)
+const wsTransport = new hl.WebSocketTransport({ ... }); // Accepts optional parameters (e.g. url, isTestnet, timeout, reconnect, etc.)
 ```
 
 ### 2) Initialize Client
@@ -531,6 +508,7 @@ class ExchangeClient {
     setReferrer(params: SetReferrerParameters): Promise<SuccessResponse>;
     subAccountModify(params: SubAccountModifyParameters): Promise<SuccessResponse>;
     spotUser(params: SpotUserParameters): Promise<SuccessResponse>;
+    webData2(params: WebData2Parameters): Promise<WebData2>;
 
     // Transfer
     sendAsset(params: SendAssetParameters): Promise<SuccessResponse>;
@@ -626,7 +604,7 @@ class MultiSignClient extends ExchangeClient {
                 multiSignAddress: Hex;
                 signers: [
                     AbstractWallet, // first is leader for multi-sign transaction (signs transaction 2 times)
-                    ...AbstractWallet[], // may be additional signers
+                    ...AbstractWallet[], // ... more signers
                 ];
             },
     );
@@ -641,69 +619,105 @@ Transport acts as a layer between class requests and Hyperliquid servers.
 
 #### HTTP Transport
 
-**Features:**
-
-- Uses [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) for requests. Can be configured using
-  [`fetchOptions`](https://developer.mozilla.org/en-US/docs/Web/API/RequestInit).
-- Automatically determines the target URL based on the request + `isTestnet` flag.
+Uses [fetch](https://developer.mozilla.org/en-US/docs/Web/API/Fetch_API) for requests.
 
 ```ts
 class HttpTransport {
     constructor(options?: {
-        isTestnet?: boolean; // Whether to use testnet url (default: false)
-        timeout?: number; // Request timeout in ms (default: 10_000)
-        server?: { // Custom server URLs
+        /** Whether to use testnet url (default: false) */
+        isTestnet?: boolean;
+        /** Request timeout in ms (default: 10_000) */
+        timeout?: number;
+        /** Custom server URLs */
+        server?: {
             mainnet?: { api?: string | URL; rpc?: string | URL };
             testnet?: { api?: string | URL; rpc?: string | URL };
         };
-        fetchOptions?: RequestInit; // A custom fetch options
-        onRequest?: (request: Request) => MaybePromise<Request | void | null | undefined>; // A callback before request is sent
-        onResponse?: (response: Response) => MaybePromise<Response | void | null | undefined>; // A callback after response is received
+        /** Custom fetch options */
+        fetchOptions?: RequestInit;
+        /** Callback before request is sent */
+        onRequest?: (request: Request) => MaybePromise<Request | void | null | undefined>;
+        /** Callback after response is received */
+        onResponse?: (response: Response) => MaybePromise<Response | void | null | undefined>;
+        /** Callback on error during fetching */
+        onError?: (error: unknown) => MaybePromise<Error | void | null | undefined>;
     });
 }
 ```
 
 #### WebSocket Transport
 
+Uses [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) for requests. Supports
+[subscriptions](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions) and
+[post requests](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests).
+
 **Features:**
 
-- Uses [WebSocket](https://developer.mozilla.org/en-US/docs/Web/API/WebSocket) for requests.
-- Supports [subscriptions](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/subscriptions)
-  and [post requests](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/websocket/post-requests).
 - Automatically restores connection after loss and resubscribes to previous subscriptions.
 - Smart keep alive (pings only when idle).
 - Lazy initialization with message buffering during connection establishment.
 
 **Limitations:**
 
-- Cannot mix api/explorer endpoints or mainnet/testnet in single connection. Need to create separate instances for
-  different endpoints.
-- Cannot send explorer post-requests via WebSocket. Use [HTTP transport](#http-transport).
+- 1 instance = 1 immutable endpoint. Cannot mix api/explorer endpoints or mainnet/testnet in single connection. Need to
+  create separate instances for different endpoints.
+- Cannot send explorer post-requests via WebSocket.
 
 ```ts
 class WebSocketTransport {
     constructor(options?: {
-        url?: string | URL; // WebSocket URL (default: "wss://api.hyperliquid.xyz/ws")
-        isTestnet?: boolean; // Indicates this transport uses testnet endpoint (default: false)
-        timeout?: number; // Request timeout in ms (default: 10_000)
-        keepAlive?: {
-            interval?: number; // Ping interval in ms (default: 30_000)
-            timeout?: number; // Pong timeout in ms (default: same as `timeout` for requests)
-        };
+        /** Indicates this transport uses testnet endpoint (default: false) */
+        isTestnet?: boolean;
+        /**
+         * Custom WebSocket endpoint for API and Subscription requests.
+         * (default: `wss://api.hyperliquid.xyz` for mainnet, `wss://api.testnet.hyperliquid.xyz` for testnet)
+         */
+        url?: string | URL;
+        /** Timeout for requests in ms (default: 10_000) */
+        timeout?: number;
+        /** Interval between sending ping messages in ms (default: 30_000) */
+        keepAliveInterval?: number;
+        /** Reconnection policy configuration for closed connections */
         reconnect?: {
-            maxRetries?: number; // Maximum number of reconnection attempts (default: 3)
-            connectionTimeout?: number; // Connection timeout in ms (default: 10_000)
-            connectionDelay?: number | ((attempt: number) => number | Promise<number>); // Delay between reconnection (default: Exponential backoff (max 10s))
-            shouldReconnect?: (event: CloseEvent) => boolean | Promise<boolean>; // Custom reconnection logic (default: Always reconnect)
-            messageBuffer?: MessageBufferStrategy; // Message buffering strategy between reconnection (default: FIFO buffer)
+            /** Custom WebSocket constructor (default: global WebSocket) */
+            WebSocket?: new (url: string | URL) => WebSocket;
+            /** Maximum number of reconnection attempts (default: 3) */
+            maxRetries?: number;
+            /** Maximum time in ms to wait for a connection to open (default: 10_000) */
+            connectionTimeout?: number;
+            /** Delay before reconnection in ms (default: Exponential backoff (max 10s)) */
+            reconnectionDelay?: number | ((attempt: number) => number);
         };
-        autoResubscribe?: boolean; // Whether to automatically resubscribe to events after reconnection (default: true)
+        /** Enable automatic re-subscription to Hyperliquid subscription after reconnection (default: true) */
+        resubscribe?: boolean;
     });
     ready(signal?: AbortSignal): Promise<void>;
     close(signal?: AbortSignal): Promise<void>;
 }
 ```
 
+### Errors
+
+All SDK errors extend from `HyperliquidError` base class for unified error handling:
+
+```ts
+import { ApiRequestError, HyperliquidError, SchemaError, TransportError } from "@nktkas/hyperliquid";
+
+try {
+    await exchClient.order({ ... });
+} catch (error) {
+    if (error instanceof SchemaError) {
+        // Invalid data format (before sending request)
+    } else if (error instanceof ApiRequestError) {
+        // API returned error (e.g., insufficient funds)
+    } else if (error instanceof TransportError) {
+        // Network/connection failure (e.g., timeout)
+    } else if (error instanceof HyperliquidError) {
+        // Some other Hyperliquid SDK error
+    }
+}
+```
+
 ## Additional Import Points
 
 ### `/schemas`
@@ -743,7 +757,7 @@ Also valibot schema can be converted to JSON Schema:
 import { OrderRequest } from "@nktkas/hyperliquid/schemas";
 import { toJsonSchema } from "@valibot/to-json-schema";
 
-const schema = toJsonSchema(OrderRequest, { errorMode: "ignore" });
+const schema = toJsonSchema(OrderRequest, { errorMode: "ignore", typeMode: "output" });
 
 console.log(JSON.stringify(schema, null, 2));
 // {
@@ -789,7 +803,7 @@ import { CancelRequest, parser } from "@nktkas/hyperliquid/schemas";
 
 const privateKey = "0x..."; // `viem`, `ethers`, or private key directly
 
-const action = parser(CancelRequest.entries.action)({ // for correct signature generation
+const action = parser(CancelRequest.entries.action)({ // for correct signature generation (optional)
     type: "cancel",
     cancels: [
         { a: 0, o: 12345 },
@@ -816,7 +830,7 @@ import { ApproveAgentRequest, parser } from "@nktkas/hyperliquid/schemas";
 
 const privateKey = "0x..."; // `viem`, `ethers`, or private key directly
 
-const action = parser(ApproveAgentRequest.entries.action)({ // for correct signature generation
+const action = parser(ApproveAgentRequest.entries.action)({ // for correct signature generation (optional)
     type: "approveAgent",
     signatureChainId: "0x66eee",
     hyperliquidChain: "Mainnet",
@@ -859,19 +873,13 @@ with `tif: "Ioc"` and price that guarantee immediate execution:
 - For buys: set limit price >= current best ask
 - For sells: set limit price <= current best bid
 
-### How to use the [Agent Wallet](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets#api-wallets) / [Vault](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults) / [Sub-Account](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults) in `ExchangeClient`?
-
-**Agent Wallet**: Use agent's private key in constructor instead of master account's private key.
-
-**Vault and Sub-Account**: Pass vault or sub-account address via `vaultAddress` options to methods or set
-`defaultVaultAddress` in constructor.
+### How to use the [Agent Wallet](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/nonces-and-api-wallets#api-wallets) in [`ExchangeClient`](#exchangeclient)?
 
-### How to use Testnet?
+Use agent's private key in constructor instead of master account's private key.
 
-[**HttpTransport**](#http-transport): Set the `isTestnet` flag to `true`.
+### How to use the [Vault](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults) / [Sub-Account](https://hyperliquid.gitbook.io/hyperliquid-docs/for-developers/api/exchange-endpoint#subaccounts-and-vaults) in [`ExchangeClient`](#exchangeclient)?
 
-[**WebSocketTransport**](#websocket-transport): Set the `isTestnet` flag to `true` and provide the testnet `url` when
-initializing the transport.
+Pass vault or sub-account address via `vaultAddress` options to methods or set `defaultVaultAddress` in constructor.
 
 ## Contributing
 

package/esm/bin/_utils.d.ts

@@ -0,0 +1,80 @@
+export type RawArgs = {
+    [key: string]: string | undefined;
+} & {
+    _: string[];
+};
+export type ParseOptions = {
+    /**
+     * Consider these keys as flags (no value expected).
+     * Value going after a flag will be treated as a positional argument.
+     */
+    flags?: string[];
+};
+/**
+ * Parse command-line arguments into a key-value object.
+ * Does not transform values.
+ */
+export declare function parseArgs(args: string[], options?: ParseOptions): RawArgs;
+export interface TransformOptions {
+    /**
+     * Transform rule for flags (keys without values).
+     * @value `undefined`
+     * @default "true"
+     */
+    flag?: "true" | "false" | ((key: string) => "true" | "false");
+    /**
+     * Transform rule for null values.
+     * @value `"null"` (case insensitive)
+     * @default "null"
+     */
+    null?: "null" | "string" | ((key: string, value: string) => "null" | "string");
+    /**
+     * Transform rule for boolean values.
+     * @value `"true"`, `"false"` (case insensitive)
+     * @default "bool"
+     */
+    bool?: "bool" | "string" | ((key: string, value: string) => "bool" | "string");
+    /**
+     * Transform rule for hexadecimal values.
+     * @value `"0xff"`, `"0X1A"` (case insensitive) (0x prefix required)
+     * @default "string"
+     */
+    hex?: "string" | "number" | ((key: string, value: string) => "string" | "number");
+    /**
+     * Transform rule for special numeric values.
+     * @value `"Infinity"`, `"-Infinity"`, `"NaN"`, `"-NaN"` (case insensitive)
+     * @default "string"
+     */
+    specialNumber?: "string" | "number" | ((key: string, value: string) => "string" | "number");
+    /**
+     * Transform rule for numeric values.
+     * @value `"123"`, `"12.3"`, `"1e+2"`, `"+123"`, `"-123"` (anything that can be parsed by `Number(value)`) (excludes hex values)
+     * @default "number"
+     */
+    number?: "number" | "string" | ((key: string, value: string) => "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" | ((key: string, value: string) => "object" | "string");
+}
+export interface Args {
+    [key: string]: string | number | boolean | null | Record<string, unknown> | unknown[];
+    _: string[];
+}
+/**
+ * Transform raw args (string values) into typed args based on rules.
+ *
+ * Order of transformation:
+ * 1. flag (`undefined`)
+ * 2. null (`"null"`)
+ * 3. boolean (`"true"`, `"false"`)
+ * 4. hex (`"0x..."`)
+ * 5. special number (`"Infinity"`, `"-Infinity"`, `"NaN", "-NaN"`)
+ * 6. number (numeric strings)
+ * 7. json (object/array strings)
+ * 8. string (default)
+ */
+export declare function transformArgs(args: RawArgs, options?: TransformOptions): Args;
+//# sourceMappingURL=_utils.d.ts.map

package/esm/bin/_utils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.d.ts","sourceRoot":"","sources":["../../src/bin/_utils.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,OAAO,GAAG;IAClB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,SAAS,CAAC;CACrC,GAAG;IACA,CAAC,EAAE,MAAM,EAAE,CAAC;CACf,CAAC;AAEF,MAAM,MAAM,YAAY,GAAG;IACvB;;;OAGG;IACH,KAAK,CAAC,EAAE,MAAM,EAAE,CAAC;CACpB,CAAC;AAEF;;;GAGG;AACH,wBAAgB,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,OAAO,CAAC,EAAE,YAAY,GAAG,OAAO,CA8BzE;AAED,MAAM,WAAW,gBAAgB;IAC7B;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,OAAO,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,KAAK,MAAM,GAAG,OAAO,CAAC,CAAC;IAC9D;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/E;;;;OAIG;IACH,IAAI,CAAC,EAAE,MAAM,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,MAAM,GAAG,QAAQ,CAAC,CAAC;IAC/E;;;;OAIG;IACH,GAAG,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAClF;;;;OAIG;IACH,aAAa,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;IAC5F;;;;OAIG;IACH,MAAM,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;IACrF;;;;OAIG;IACH,IAAI,CAAC,EAAE,QAAQ,GAAG,QAAQ,GAAG,CAAC,CAAC,GAAG,EAAE,MAAM,EAAE,KAAK,EAAE,MAAM,KAAK,QAAQ,GAAG,QAAQ,CAAC,CAAC;CACtF;AAED,MAAM,WAAW,IAAI;IACjB,CAAC,GAAG,EAAE,MAAM,GAAG,MAAM,GAAG,MAAM,GAAG,OAAO,GAAG,IAAI,GAAG,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,GAAG,OAAO,EAAE,CAAC;IACtF,CAAC,EAAE,MAAM,EAAE,CAAC;CACf;AAED;;;;;;;;;;;;GAYG;AACH,wBAAgB,aAAa,CAAC,IAAI,EAAE,OAAO,EAAE,OAAO,CAAC,EAAE,gBAAgB,GAAG,IAAI,CAuE7E"}

package/esm/bin/_utils.js

@@ -0,0 +1,112 @@
+/**
+ * Parse command-line arguments into a key-value object.
+ * Does not transform values.
+ */
+export function parseArgs(args, options) {
+    const result = { _: [] };
+    for (let i = 0; i < args.length; i++) {
+        const arg = args[i];
+        const nextArg = args[i + 1];
+        if (arg.startsWith("-")) {
+            if (arg === "-_" || arg === "--_")
+                continue; // Skip reserved key "_"
+            const isLong = arg.startsWith("--");
+            let keyPart = arg.slice(isLong ? 2 : 1);
+            let value;
+            const eqIndex = keyPart.indexOf("=");
+            if (eqIndex !== -1) {
+                value = keyPart.substring(eqIndex + 1);
+                keyPart = keyPart.substring(0, eqIndex);
+            }
+            else if (!options?.flags?.includes(keyPart) && // Skip if key is defined as flag and don't expect value
+                typeof nextArg === "string" && (!nextArg.startsWith("-") || !isNaN(parseFloat(nextArg)))) {
+                value = nextArg;
+                i++; // Skip next arg as it's consumed as value for current key
+            }
+            result[keyPart] = value;
+        }
+        else {
+            result._.push(arg);
+        }
+    }
+    return result;
+}
+/**
+ * Transform raw args (string values) into typed args based on rules.
+ *
+ * Order of transformation:
+ * 1. flag (`undefined`)
+ * 2. null (`"null"`)
+ * 3. boolean (`"true"`, `"false"`)
+ * 4. hex (`"0x..."`)
+ * 5. special number (`"Infinity"`, `"-Infinity"`, `"NaN", "-NaN"`)
+ * 6. number (numeric strings)
+ * 7. json (object/array strings)
+ * 8. string (default)
+ */
+export function transformArgs(args, options) {
+    const opts = {
+        flag: "true",
+        null: "null",
+        bool: "bool",
+        hex: "string",
+        specialNumber: "string",
+        number: "number",
+        json: "object",
+        ...options,
+    };
+    const result = { _: args._ };
+    for (const key in args) {
+        if (key === "_")
+            continue; // Skip the positional args array
+        const value = args[key];
+        // Transformation logic
+        let transformedValue;
+        // flag
+        if (value === undefined) {
+            const action = typeof opts.flag === "function" ? opts.flag(key) : opts.flag;
+            transformedValue = action === "true" ? true : false;
+        } // null
+        else if (value.toLowerCase() === "null") {
+            const action = typeof opts.null === "function" ? opts.null(key, value) : opts.null;
+            transformedValue = action === "null" ? null : value;
+        } // boolean
+        else if (value.toLowerCase() === "true" || value.toLowerCase() === "false") {
+            const action = typeof opts.bool === "function" ? opts.bool(key, value) : opts.bool;
+            transformedValue = action === "bool" ? value.toLowerCase() === "true" : value;
+        } // hex
+        else if ((value.startsWith("0x") || value.startsWith("0X")) && !isNaN(parseInt(value, 16))) {
+            const action = typeof opts.hex === "function" ? opts.hex(key, value) : opts.hex;
+            transformedValue = action === "string" ? value : parseInt(value, 16);
+        } // special number
+        else if (value.toLowerCase() === "infinity" || value.toLowerCase() === "-infinity" ||
+            value.toLowerCase() === "nan" || value.toLowerCase() === "-nan") {
+            const action = typeof opts.specialNumber === "function"
+                ? opts.specialNumber(key, value)
+                : opts.specialNumber;
+            transformedValue = action === "string" ? value : Number(value);
+        } // number
+        else if (!isNaN(Number(value))) {
+            const action = typeof opts.number === "function" ? opts.number(key, value) : opts.number;
+            transformedValue = action === "number" ? Number(value) : value;
+        } // json object/array
+        else if ((value.startsWith("{") && value.endsWith("}")) ||
+            (value.startsWith("[") && value.endsWith("]"))) {
+            const action = typeof opts.json === "function" ? opts.json(key, value) : opts.json;
+            try {
+                transformedValue = action === "object"
+                    ? JSON.parse(value)
+                    : value;
+            }
+            catch {
+                transformedValue = value;
+            }
+        } // string (default)
+        else {
+            transformedValue = value;
+        }
+        result[key] = transformedValue;
+    }
+    return result;
+}
+//# sourceMappingURL=_utils.js.map

package/esm/bin/_utils.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"_utils.js","sourceRoot":"","sources":["../../src/bin/_utils.ts"],"names":[],"mappings":"AAcA;;;GAGG;AACH,MAAM,UAAU,SAAS,CAAC,IAAc,EAAE,OAAsB;IAC5D,MAAM,MAAM,GAAG,EAAE,CAAC,EAAE,EAAE,EAAwB,CAAC;IAC/C,KAAK,IAAI,CAAC,GAAG,CAAC,EAAE,CAAC,GAAG,IAAI,CAAC,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC;QACnC,MAAM,GAAG,GAAG,IAAI,CAAC,CAAC,CAAC,CAAC;QACpB,MAAM,OAAO,GAAG,IAAI,CAAC,CAAC,GAAG,CAAC,CAAuB,CAAC;QAElD,IAAI,GAAG,CAAC,UAAU,CAAC,GAAG,CAAC,EAAE,CAAC;YACtB,IAAI,GAAG,KAAK,IAAI,IAAI,GAAG,KAAK,KAAK;gBAAE,SAAS,CAAC,wBAAwB;YAErE,MAAM,MAAM,GAAG,GAAG,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC;YACpC,IAAI,OAAO,GAAG,GAAG,CAAC,KAAK,CAAC,MAAM,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC,CAAC;YACxC,IAAI,KAAyB,CAAC;YAC9B,MAAM,OAAO,GAAG,OAAO,CAAC,OAAO,CAAC,GAAG,CAAC,CAAC;YAErC,IAAI,OAAO,KAAK,CAAC,CAAC,EAAE,CAAC;gBACjB,KAAK,GAAG,OAAO,CAAC,SAAS,CAAC,OAAO,GAAG,CAAC,CAAC,CAAC;gBACvC,OAAO,GAAG,OAAO,CAAC,SAAS,CAAC,CAAC,EAAE,OAAO,CAAC,CAAC;YAC5C,CAAC;iBAAM,IACH,CAAC,OAAO,EAAE,KAAK,EAAE,QAAQ,CAAC,OAAO,CAAC,IAAI,wDAAwD;gBAC9F,OAAO,OAAO,KAAK,QAAQ,IAAI,CAAC,CAAC,OAAO,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,OAAO,CAAC,CAAC,CAAC,EAC1F,CAAC;gBACC,KAAK,GAAG,OAAO,CAAC;gBAChB,CAAC,EAAE,CAAC,CAAC,0DAA0D;YACnE,CAAC;YACD,MAAM,CAAC,OAAO,CAAC,GAAG,KAAK,CAAC;QAC5B,CAAC;aAAM,CAAC;YACJ,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC;QACvB,CAAC;IACL,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC;AAoDD;;;;;;;;;;;;GAYG;AACH,MAAM,UAAU,aAAa,CAAC,IAAa,EAAE,OAA0B;IACnE,MAAM,IAAI,GAAG;QACT,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,IAAI,EAAE,MAAM;QACZ,GAAG,EAAE,QAAQ;QACb,aAAa,EAAE,QAAQ;QACvB,MAAM,EAAE,QAAQ;QAChB,IAAI,EAAE,QAAQ;QACd,GAAG,OAAO;KACJ,CAAC;IAEX,MAAM,MAAM,GAAS,EAAE,CAAC,EAAE,IAAI,CAAC,CAAC,EAAE,CAAC;IACnC,KAAK,MAAM,GAAG,IAAI,IAAI,EAAE,CAAC;QACrB,IAAI,GAAG,KAAK,GAAG;YAAE,SAAS,CAAC,iCAAiC;QAE5D,MAAM,KAAK,GAAG,IAAI,CAAC,GAAG,CAAC,CAAC;QAExB,uBAAuB;QACvB,IAAI,gBAA8B,CAAC;QAEnC,OAAO;QACP,IAAI,KAAK,KAAK,SAAS,EAAE,CAAC;YACtB,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YAC5E,gBAAgB,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QACxD,CAAC,CAAC,OAAO;aACJ,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,EAAE,CAAC;YACtC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACnF,gBAAgB,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,IAAI,CAAC,CAAC,CAAC,KAAK,CAAC;QACxD,CAAC,CAAC,UAAU;aACP,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,OAAO,EAAE,CAAC;YACzE,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACnF,gBAAgB,GAAG,MAAM,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,CAAC,CAAC,CAAC,KAAK,CAAC;QAClF,CAAC,CAAC,MAAM;aACH,IAAI,CAAC,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,IAAI,KAAK,CAAC,UAAU,CAAC,IAAI,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC,EAAE,CAAC;YACzF,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,GAAG,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,GAAG,CAAC;YAChF,gBAAgB,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,QAAQ,CAAC,KAAK,EAAE,EAAE,CAAC,CAAC;QACzE,CAAC,CAAC,iBAAiB;aACd,IACD,KAAK,CAAC,WAAW,EAAE,KAAK,UAAU,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,WAAW;YACzE,KAAK,CAAC,WAAW,EAAE,KAAK,KAAK,IAAI,KAAK,CAAC,WAAW,EAAE,KAAK,MAAM,EACjE,CAAC;YACC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,aAAa,KAAK,UAAU;gBACnD,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC,GAAG,EAAE,KAAK,CAAC;gBAChC,CAAC,CAAC,IAAI,CAAC,aAAa,CAAC;YACzB,gBAAgB,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC;QACnE,CAAC,CAAC,SAAS;aACN,IAAI,CAAC,KAAK,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,EAAE,CAAC;YAC7B,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,MAAM,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,MAAM,CAAC;YACzF,gBAAgB,GAAG,MAAM,KAAK,QAAQ,CAAC,CAAC,CAAC,MAAM,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,KAAK,CAAC;QACnE,CAAC,CAAC,oBAAoB;aACjB,IACD,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC;YAC9C,CAAC,KAAK,CAAC,UAAU,CAAC,GAAG,CAAC,IAAI,KAAK,CAAC,QAAQ,CAAC,GAAG,CAAC,CAAC,EAChD,CAAC;YACC,MAAM,MAAM,GAAG,OAAO,IAAI,CAAC,IAAI,KAAK,UAAU,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC,GAAG,EAAE,KAAK,CAAC,CAAC,CAAC,CAAC,IAAI,CAAC,IAAI,CAAC;YACnF,IAAI,CAAC;gBACD,gBAAgB,GAAG,MAAM,KAAK,QAAQ;oBAClC,CAAC,CAAC,IAAI,CAAC,KAAK,CAAC,KAAK,CAAwC;oBAC1D,CAAC,CAAC,KAAK,CAAC;YAChB,CAAC;YAAC,MAAM,CAAC;gBACL,gBAAgB,GAAG,KAAK,CAAC;YAC7B,CAAC;QACL,CAAC,CAAC,mBAAmB;aAChB,CAAC;YACF,gBAAgB,GAAG,KAAK,CAAC;QAC7B,CAAC;QAED,MAAM,CAAC,GAAG,CAAC,GAAG,gBAAgB,CAAC;IACnC,CAAC;IACD,OAAO,MAAM,CAAC;AAClB,CAAC"}

package/esm/bin/cli.d.ts

@@ -0,0 +1,3 @@
+#!/usr/bin/env node
+export {};
+//# sourceMappingURL=cli.d.ts.map

package/esm/bin/cli.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"cli.d.ts","sourceRoot":"","sources":["../../src/bin/cli.ts"],"names":[],"mappings":""}