xray-typed 1.0.1 → 1.0.3

package/dist/config/inbound.d.ts

@@ -8,19 +8,13 @@ import { SocksInboundConfig } from '../proxies/socks';
 import { HTTPInboundConfig } from '../proxies/http';
 import { DokodemoInboundConfig } from '../proxies/dokodemo';
 /**
- * Inbound connection configuration.
- *
- * @see https://xtls.github.io/en/config/inbound.html
+ * Common inbound fields shared by all protocol variants.
  */
-export interface InboundConfig {
-    /** Inbound protocol name. */
-    protocol?: InboundProtocol;
+interface InboundConfigBase {
     /** Listening port. Can be a number, string range "1-65535", or comma-separated. */
     port?: number | string;
     /** Listening address (default: "0.0.0.0"). */
     listen?: string;
-    /** Protocol-specific settings. Type depends on protocol value. */
-    settings?: InboundSettings;
     /** Unique tag for routing reference. */
     tag?: string;
     /** Transport layer settings. */
@@ -28,9 +22,67 @@ export interface InboundConfig {
     /** Traffic sniffing configuration. */
     sniffing?: SniffingConfig;
 }
+/**
+ * Discriminated union of all inbound configurations.
+ * TypeScript will automatically narrow `settings` based on `protocol`.
+ *
+ * @example
+ * ```typescript
+ * if (inbound.protocol === 'shadowsocks') {
+ *   inbound.settings?.method; // OK — ShadowsocksInboundConfig
+ * }
+ * ```
+ *
+ * @see https://xtls.github.io/en/config/inbound.html
+ */
+export type InboundConfig = InboundVLess | InboundVMess | InboundTrojan | InboundShadowsocks | InboundSocks | InboundHTTP | InboundDokodemo | InboundTunnel | InboundMixed | InboundGeneric;
+export interface InboundVLess extends InboundConfigBase {
+    protocol: 'vless';
+    settings?: VLessInboundConfig;
+}
+export interface InboundVMess extends InboundConfigBase {
+    protocol: 'vmess';
+    settings?: VMessInboundConfig;
+}
+export interface InboundTrojan extends InboundConfigBase {
+    protocol: 'trojan';
+    settings?: TrojanInboundConfig;
+}
+export interface InboundShadowsocks extends InboundConfigBase {
+    protocol: 'shadowsocks';
+    settings?: ShadowsocksInboundConfig;
+}
+export interface InboundSocks extends InboundConfigBase {
+    protocol: 'socks';
+    settings?: SocksInboundConfig;
+}
+export interface InboundHTTP extends InboundConfigBase {
+    protocol: 'http';
+    settings?: HTTPInboundConfig;
+}
+export interface InboundDokodemo extends InboundConfigBase {
+    protocol: 'dokodemo-door';
+    settings?: DokodemoInboundConfig;
+}
+/** Alias for dokodemo-door in Xray-Core. Same settings. */
+export interface InboundTunnel extends InboundConfigBase {
+    protocol: 'tunnel';
+    settings?: DokodemoInboundConfig;
+}
+/** Alias for combined http+socks in Xray-Core. Accepts both setting types. */
+export interface InboundMixed extends InboundConfigBase {
+    protocol: 'mixed';
+    settings?: SocksInboundConfig | HTTPInboundConfig;
+}
+/** Fallback for unknown/custom protocols. */
+export interface InboundGeneric extends InboundConfigBase {
+    protocol?: string;
+    settings?: Record<string, unknown>;
+}
 /**
  * Union type for all possible inbound protocol settings.
  */
 export type InboundSettings = VLessInboundConfig | VMessInboundConfig | TrojanInboundConfig | ShadowsocksInboundConfig | SocksInboundConfig | HTTPInboundConfig | DokodemoInboundConfig;
-export type InboundProtocol = 'vless' | 'vmess' | 'trojan' | 'shadowsocks' | 'socks' | 'http' | 'dokodemo-door';
+export type InboundProtocol = 'vless' | 'vmess' | 'trojan' | 'shadowsocks' | 'socks' | 'http' | 'dokodemo-door' | 'tunnel' | 'mixed';
+export {};
 //# sourceMappingURL=inbound.d.ts.map

package/dist/config/inbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/config/inbound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,cAAc,EAAE,MAAM,YAAY,CAAC;AAC5C,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,wBAAwB,EAAE,MAAM,wBAAwB,CAAC;AAClE,OAAO,EAAE,kBAAkB,EAAE,MAAM,kBAAkB,CAAC;AACtD,OAAO,EAAE,iBAAiB,EAAE,MAAM,iBAAiB,CAAC;AACpD,OAAO,EAAE,qBAAqB,EAAE,MAAM,qBAAqB,CAAC;AAE5D;;;;GAIG;AACH,MAAM,WAAW,aAAa;IAC1B,6BAA6B;IAC7B,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,mFAAmF;IACnF,IAAI,CAAC,EAAE,MAAM,GAAG,MAAM,CAAC;IACvB,8CAA8C;IAC9C,MAAM,CAAC,EAAE,MAAM,CAAC;IAChB,kEAAkE;IAClE,QAAQ,CAAC,EAAE,eAAe,CAAC;IAC3B,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,gCAAgC;IAChC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,sCAAsC;IACtC,QAAQ,CAAC,EAAE,cAAc,CAAC;CAC7B;AAED;;GAEG;AACH,MAAM,MAAM,eAAe,GACrB,kBAAkB,GAClB,kBAAkB,GAClB,mBAAmB,GACnB,wBAAwB,GACxB,kBAAkB,GAClB,iBAAiB,GACjB,qBAAqB,CAAC;AAE5B,MAAM,MAAM,eAAe,GACrB,OAAO,GACP,OAAO,GACP,QAAQ,GACR,aAAa,GACb,OAAO,GACP,MAAM,GACN,eAAe,CAAC"}
+{"version":3,"file":"inbound.d.ts","sourceRoot":"","sources":["../../src/config/inbound.ts"],"names":[],"mappings":"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"}

package/dist/config/outbound.d.ts

@@ -12,19 +12,13 @@ import { DNSOutboundConfig } from '../proxies/dns';
 import { WireGuardOutboundConfig } from '../proxies/wireguard';
 import { LoopbackOutboundConfig } from '../proxies/loopback';
 /**
- * Outbound connection configuration.
- *
- * @see https://xtls.github.io/en/config/outbound.html
+ * Common outbound fields shared by all protocol variants.
  */
-export interface OutboundConfig {
-    /** Outbound protocol name. */
-    protocol?: OutboundProtocol;
+interface OutboundConfigBase {
     /** Send traffic through specific local address. */
     sendThrough?: string;
     /** Unique tag for routing reference. */
     tag?: string;
-    /** Protocol-specific settings. Type depends on protocol value. */
-    settings?: OutboundSettings;
     /** Transport layer settings. */
     streamSettings?: StreamSettingsConfig;
     /** Proxy chain settings. */
@@ -40,9 +34,73 @@ export interface ProxySettings {
     /** Use transport layer proxying (instead of application layer). */
     transportLayer?: boolean;
 }
+/**
+ * Discriminated union of all outbound configurations.
+ * TypeScript will automatically narrow `settings` based on `protocol`.
+ *
+ * @example
+ * ```typescript
+ * if (outbound.protocol === 'freedom') {
+ *   outbound.settings?.fragment; // OK — FreedomOutboundConfig
+ * }
+ * ```
+ *
+ * @see https://xtls.github.io/en/config/outbound.html
+ */
+export type OutboundConfig = OutboundVLess | OutboundVMess | OutboundTrojan | OutboundShadowsocks | OutboundSocks | OutboundHTTP | OutboundFreedom | OutboundBlackhole | OutboundDNS | OutboundWireGuard | OutboundLoopback | OutboundGeneric;
+export interface OutboundVLess extends OutboundConfigBase {
+    protocol: 'vless';
+    settings?: VLessOutboundConfig;
+}
+export interface OutboundVMess extends OutboundConfigBase {
+    protocol: 'vmess';
+    settings?: VMessOutboundConfig;
+}
+export interface OutboundTrojan extends OutboundConfigBase {
+    protocol: 'trojan';
+    settings?: TrojanOutboundConfig;
+}
+export interface OutboundShadowsocks extends OutboundConfigBase {
+    protocol: 'shadowsocks';
+    settings?: ShadowsocksOutboundConfig;
+}
+export interface OutboundSocks extends OutboundConfigBase {
+    protocol: 'socks';
+    settings?: SocksOutboundConfig;
+}
+export interface OutboundHTTP extends OutboundConfigBase {
+    protocol: 'http';
+    settings?: HTTPOutboundConfig;
+}
+export interface OutboundFreedom extends OutboundConfigBase {
+    protocol: 'freedom';
+    settings?: FreedomOutboundConfig;
+}
+export interface OutboundBlackhole extends OutboundConfigBase {
+    protocol: 'blackhole';
+    settings?: BlackholeOutboundConfig;
+}
+export interface OutboundDNS extends OutboundConfigBase {
+    protocol: 'dns';
+    settings?: DNSOutboundConfig;
+}
+export interface OutboundWireGuard extends OutboundConfigBase {
+    protocol: 'wireguard';
+    settings?: WireGuardOutboundConfig;
+}
+export interface OutboundLoopback extends OutboundConfigBase {
+    protocol: 'loopback';
+    settings?: LoopbackOutboundConfig;
+}
+/** Fallback for unknown/custom protocols. */
+export interface OutboundGeneric extends OutboundConfigBase {
+    protocol?: string;
+    settings?: Record<string, unknown>;
+}
 /**
  * Union type for all possible outbound protocol settings.
  */
 export type OutboundSettings = VLessOutboundConfig | VMessOutboundConfig | TrojanOutboundConfig | ShadowsocksOutboundConfig | SocksOutboundConfig | HTTPOutboundConfig | FreedomOutboundConfig | BlackholeOutboundConfig | DNSOutboundConfig | WireGuardOutboundConfig | LoopbackOutboundConfig;
 export type OutboundProtocol = 'vless' | 'vmess' | 'trojan' | 'shadowsocks' | 'socks' | 'http' | 'freedom' | 'blackhole' | 'dns' | 'wireguard' | 'loopback';
+export {};
 //# sourceMappingURL=outbound.d.ts.map

package/dist/config/outbound.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../src/config/outbound.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,oBAAoB,EAAE,MAAM,qBAAqB,CAAC;AAC3D,OAAO,EAAE,SAAS,EAAE,MAAM,OAAO,CAAC;AAClC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,oBAAoB,EAAE,MAAM,mBAAmB,CAAC;AACzD,OAAO,EAAE,yBAAyB,EAAE,MAAM,wBAAwB,CAAC;AACnE,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,kBAAkB,EAAE,MAAM,iBAAiB,CAAC;AACrD,OAAO,EAAE,qBAAqB,EAAE,MAAM,oBAAoB,CAAC;AAC3D,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,iBAAiB,EAAE,MAAM,gBAAgB,CAAC;AACnD,OAAO,EAAE,uBAAuB,EAAE,MAAM,sBAAsB,CAAC;AAC/D,OAAO,EAAE,sBAAsB,EAAE,MAAM,qBAAqB,CAAC;AAE7D;;;;GAIG;AACH,MAAM,WAAW,cAAc;IAC3B,8BAA8B;IAC9B,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,mDAAmD;IACnD,WAAW,CAAC,EAAE,MAAM,CAAC;IACrB,wCAAwC;IACxC,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,kEAAkE;IAClE,QAAQ,CAAC,EAAE,gBAAgB,CAAC;IAC5B,gCAAgC;IAChC,cAAc,CAAC,EAAE,oBAAoB,CAAC;IACtC,4BAA4B;IAC5B,aAAa,CAAC,EAAE,aAAa,CAAC;IAC9B,mCAAmC;IACnC,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,uBAAuB;IACvB,cAAc,CAAC,EAAE,MAAM,CAAC;CAC3B;AAED,MAAM,WAAW,aAAa;IAC1B,gDAAgD;IAChD,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,mEAAmE;IACnE,cAAc,CAAC,EAAE,OAAO,CAAC;CAC5B;AAED;;GAEG;AACH,MAAM,MAAM,gBAAgB,GACtB,mBAAmB,GACnB,mBAAmB,GACnB,oBAAoB,GACpB,yBAAyB,GACzB,mBAAmB,GACnB,kBAAkB,GAClB,qBAAqB,GACrB,uBAAuB,GACvB,iBAAiB,GACjB,uBAAuB,GACvB,sBAAsB,CAAC;AAE7B,MAAM,MAAM,gBAAgB,GACtB,OAAO,GACP,OAAO,GACP,QAAQ,GACR,aAAa,GACb,OAAO,GACP,MAAM,GACN,SAAS,GACT,WAAW,GACX,KAAK,GACL,WAAW,GACX,UAAU,CAAC"}
+{"version":3,"file":"outbound.d.ts","sourceRoot":"","sources":["../../src/config/outbound.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,4 +1,4 @@
-export { XrayConfig } from './xray-config';
+export { XrayConfig, VersionConfig, XRAY_CONFIG_KEY_ORDER, XrayConfigKey, sortXrayConfig, } from './xray-config';
 export { LogConfig, LogLevel, MaskAddressMode, } from './config/log';
 export { APIConfig, APIService, } from './config/api';
 export { MetricsConfig, } from './config/metrics';
@@ -11,8 +11,8 @@ export { FakeDNSConfig, FakeDNSPoolConfig, } from './config/fakedns';
 export { ObservatoryConfig, BurstObservatoryConfig, HealthCheckSettings, } from './config/observatory';
 export { SniffingConfig, SniffDestOverride, } from './config/sniffing';
 export { MuxConfig, XudpProxyUDP443, } from './config/mux';
-export { InboundConfig, InboundSettings, InboundProtocol, } from './config/inbound';
-export { OutboundConfig, OutboundSettings, OutboundProtocol, ProxySettings, } from './config/outbound';
+export { InboundConfig, InboundVLess, InboundVMess, InboundTrojan, InboundShadowsocks, InboundSocks, InboundHTTP, InboundDokodemo, InboundTunnel, InboundMixed, InboundGeneric, InboundSettings, InboundProtocol, } from './config/inbound';
+export { OutboundConfig, OutboundVLess, OutboundVMess, OutboundTrojan, OutboundShadowsocks, OutboundSocks, OutboundHTTP, OutboundFreedom, OutboundBlackhole, OutboundDNS, OutboundWireGuard, OutboundLoopback, OutboundGeneric, OutboundSettings, OutboundProtocol, ProxySettings, } from './config/outbound';
 export { TransportProtocol, SecurityType, HeaderType, Int32Range, Bandwidth, } from './transport/common';
 export { StreamSettingsConfig } from './transport/stream';
 export { TCPConfig, TCPHeaderNone, TCPHeaderHTTP, TCPHTTPRequest, TCPHTTPResponse } from './transport/tcp';

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,eAAe,CAAC;AAG3C,OAAO,EACH,SAAS,EACT,QAAQ,EACR,eAAe,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,SAAS,EACT,UAAU,GACb,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,WAAW,GACd,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,SAAS,EACT,gBAAgB,EAChB,gBAAgB,GACnB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,aAAa,EACb,WAAW,EACX,iBAAiB,EACjB,aAAa,EACb,iBAAiB,EACjB,qBAAqB,EACrB,qBAAqB,EACrB,WAAW,EACX,aAAa,GAChB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,YAAY,EACZ,WAAW,EACX,YAAY,GACf,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACH,aAAa,EACb,YAAY,EACZ,YAAY,GACf,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,aAAa,EACb,iBAAiB,GACpB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,iBAAiB,EACjB,sBAAsB,EACtB,mBAAmB,GACtB,MAAM,sBAAsB,CAAC;AAE9B,OAAO,EACH,cAAc,EACd,iBAAiB,GACpB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,SAAS,EACT,eAAe,GAClB,MAAM,cAAc,CAAC;AAEtB,OAAO,EACH,aAAa,EACb,eAAe,EACf,eAAe,GAClB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,gBAAgB,EAChB,aAAa,GAChB,MAAM,mBAAmB,CAAC;AAG3B,OAAO,EACH,iBAAiB,EACjB,YAAY,EACZ,UAAU,EACV,UAAU,EACV,SAAS,GACZ,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EAAE,oBAAoB,EAAE,MAAM,oBAAoB,CAAC;AAC1D,OAAO,EAAE,SAAS,EAAE,aAAa,EAAE,aAAa,EAAE,cAAc,EAAE,eAAe,EAAE,MAAM,iBAAiB,CAAC;AAC3G,OAAO,EAAE,SAAS,EAAE,SAAS,EAAE,MAAM,iBAAiB,CAAC;AACvD,OAAO,EAAE,eAAe,EAAE,MAAM,uBAAuB,CAAC;AACxD,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,UAAU,EAAE,MAAM,kBAAkB,CAAC;AAC9C,OAAO,EAAE,UAAU,EAAE,UAAU,EAAE,YAAY,EAAE,MAAM,kBAAkB,CAAC;AACxE,OAAO,EAAE,iBAAiB,EAAE,MAAM,yBAAyB,CAAC;AAC5D,OAAO,EACH,eAAe,EACf,UAAU,EACV,aAAa,GAChB,MAAM,uBAAuB,CAAC;AAC/B,OAAO,EACH,cAAc,EACd,gBAAgB,EAChB,cAAc,GACjB,MAAM,sBAAsB,CAAC;AAC9B,OAAO,EACH,SAAS,EACT,aAAa,EACb,gBAAgB,EAChB,cAAc,GACjB,MAAM,iBAAiB,CAAC;AACzB,OAAO,EACH,aAAa,EACb,mBAAmB,GACtB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,UAAU,EACV,qBAAqB,GACxB,MAAM,qBAAqB,CAAC;AAC7B,OAAO,EACH,eAAe,EACf,QAAQ,EACR,oBAAoB,EACpB,iBAAiB,EACjB,SAAS,IAAI,aAAa,EAC1B,gBAAgB,EAChB,YAAY,GACf,MAAM,uBAAuB,CAAC;AAG/B,OAAO,EACH,kBAAkB,EAClB,WAAW,EACX,oBAAoB,EACpB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,gBAAgB,EAChB,SAAS,GACZ,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACH,kBAAkB,EAClB,gBAAgB,EAChB,kBAAkB,EAClB,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACH,mBAAmB,EACnB,UAAU,EACV,qBAAqB,EACrB,oBAAoB,EACpB,oBAAoB,GACvB,MAAM,kBAAkB,CAAC;AAE1B,OAAO,EACH,wBAAwB,EACxB,eAAe,EACf,yBAAyB,EACzB,iBAAiB,EACjB,iBAAiB,GACpB,MAAM,uBAAuB,CAAC;AAE/B,OAAO,EACH,kBAAkB,EAClB,YAAY,EACZ,mBAAmB,EACnB,mBAAmB,EACnB,iBAAiB,EACjB,aAAa,GAChB,MAAM,iBAAiB,CAAC;AAEzB,OAAO,EACH,iBAAiB,EACjB,WAAW,EACX,kBAAkB,EAClB,kBAAkB,EAClB,gBAAgB,GACnB,MAAM,gBAAgB,CAAC;AAExB,OAAO,EACH,qBAAqB,EACrB,cAAc,EACd,WAAW,EACX,SAAS,EACT,qBAAqB,GACxB,MAAM,mBAAmB,CAAC;AAE3B,OAAO,EACH,uBAAuB,EACvB,iBAAiB,EACjB,qBAAqB,GACxB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,iBAAiB,EACjB,kBAAkB,EAClB,aAAa,GAChB,MAAM,eAAe,CAAC;AAEvB,OAAO,EACH,qBAAqB,GACxB,MAAM,oBAAoB,CAAC;AAE5B,OAAO,EACH,uBAAuB,EACvB,aAAa,GAChB,MAAM,qBAAqB,CAAC;AAE7B,OAAO,EACH,sBAAsB,GACzB,MAAM,oBAAoB,CAAC"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"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"}

package/dist/index.js

@@ -1,3 +1,8 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.sortXrayConfig = exports.XRAY_CONFIG_KEY_ORDER = void 0;
+// ── Root Config ──
+var xray_config_1 = require("./xray-config");
+Object.defineProperty(exports, "XRAY_CONFIG_KEY_ORDER", { enumerable: true, get: function () { return xray_config_1.XRAY_CONFIG_KEY_ORDER; } });
+Object.defineProperty(exports, "sortXrayConfig", { enumerable: true, get: function () { return xray_config_1.sortXrayConfig; } });
 //# sourceMappingURL=index.js.map

package/dist/index.js.map

@@ -1 +1 @@
-{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":""}
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":";;;AAAA,oBAAoB;AACpB,6CAMuB;AAHnB,oHAAA,qBAAqB,OAAA;AAErB,6GAAA,cAAc,OAAA"}

package/dist/transport/common.d.ts

@@ -13,7 +13,7 @@ export type Bandwidth = string | number;
 /**
  * Transport protocol type.
  */
-export type TransportProtocol = 'tcp' | 'raw' | 'kcp' | 'mkcp' | 'ws' | 'websocket' | 'http' | 'h2' | 'grpc' | 'gun' | 'quic' | 'httpupgrade' | 'splithttp' | 'xhttp' | 'hysteria2';
+export type TransportProtocol = 'tcp' | 'raw' | 'kcp' | 'ws' | 'grpc' | 'httpupgrade' | 'xhttp' | 'hysteria';
 /**
  * Security type for stream settings.
  */

package/dist/transport/common.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/transport/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACvB,KAAK,GACL,KAAK,GACL,KAAK,GACL,MAAM,GACN,IAAI,GACJ,WAAW,GACX,MAAM,GACN,IAAI,GACJ,MAAM,GACN,KAAK,GACL,MAAM,GACN,aAAa,GACb,WAAW,GACX,OAAO,GACP,WAAW,CAAC;AAElB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,UAAU,GAChB,MAAM,GACN,MAAM,GACN,KAAK,GACL,cAAc,GACd,MAAM,GACN,WAAW,GACX,KAAK,CAAC"}
+{"version":3,"file":"common.d.ts","sourceRoot":"","sources":["../../src/transport/common.ts"],"names":[],"mappings":"AAAA;;GAEG;AAEH;;;GAGG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,CAAC;AAEzC;;GAEG;AACH,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,MAAM,CAAC;AAExC;;GAEG;AACH,MAAM,MAAM,iBAAiB,GACvB,KAAK,GACL,KAAK,GACL,KAAK,GACL,IAAI,GACJ,MAAM,GACN,aAAa,GACb,OAAO,GACP,UAAU,CAAC;AAEjB;;GAEG;AACH,MAAM,MAAM,YAAY,GAAG,MAAM,GAAG,KAAK,GAAG,SAAS,CAAC;AAEtD;;GAEG;AACH,MAAM,MAAM,UAAU,GAAG,MAAM,GAAG,MAAM,GAAG,KAAK,GAAG,cAAc,GAAG,MAAM,GAAG,WAAW,GAAG,KAAK,CAAC"}

package/dist/xray-config.d.ts

@@ -73,4 +73,25 @@ export interface VersionConfig {
     /** Maximum allowed Xray-Core version. Empty or omitted = no upper bound. */
     max?: string;
 }
+/**
+ * All top-level keys of XrayConfig in canonical order.
+ * Use with `sortXrayConfig` or for your own normalization logic.
+ */
+export declare const XRAY_CONFIG_KEY_ORDER: readonly ["log", "api", "metrics", "dns", "routing", "policy", "inbounds", "outbounds", "transport", "stats", "reverse", "fakeDns", "observatory", "burstObservatory", "version"];
+/** Union of all top-level XrayConfig key names. */
+export type XrayConfigKey = (typeof XRAY_CONFIG_KEY_ORDER)[number];
+/**
+ * Returns a new XrayConfig with keys sorted in canonical order.
+ * Unknown keys (not in the standard set) are appended at the end
+ * in their original order.
+ *
+ * @example
+ * ```typescript
+ * import { sortXrayConfig } from 'xray-typed';
+ *
+ * const normalized = sortXrayConfig(rawConfig);
+ * const json = JSON.stringify(normalized, null, 2);
+ * ```
+ */
+export declare function sortXrayConfig<T extends XrayConfig>(config: T): T;
 //# sourceMappingURL=xray-config.d.ts.map

package/dist/xray-config.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"xray-config.d.ts","sourceRoot":"","sources":["../src/xray-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACvB,yBAAyB;IACzB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,kCAAkC;IAClC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,kDAAkD;IAClD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mDAAmD;IACnD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gEAAgE;IAChE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6BAA6B;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC1B,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB"}
+{"version":3,"file":"xray-config.d.ts","sourceRoot":"","sources":["../src/xray-config.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,WAAW,EAAE,MAAM,gBAAgB,CAAC;AAC7C,OAAO,EAAE,SAAS,EAAE,MAAM,cAAc,CAAC;AACzC,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,YAAY,EAAE,MAAM,iBAAiB,CAAC;AAC/C,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,iBAAiB,EAAE,sBAAsB,EAAE,MAAM,sBAAsB,CAAC;AACjF,OAAO,EAAE,aAAa,EAAE,MAAM,kBAAkB,CAAC;AACjD,OAAO,EAAE,cAAc,EAAE,MAAM,mBAAmB,CAAC;AAEnD;;;;;;;;;;;;;;;;GAgBG;AACH,MAAM,WAAW,UAAU;IACvB,yBAAyB;IACzB,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,8BAA8B;IAC9B,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,sCAAsC;IACtC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,+CAA+C;IAC/C,GAAG,CAAC,EAAE,SAAS,CAAC;IAChB,mCAAmC;IACnC,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,kCAAkC;IAClC,MAAM,CAAC,EAAE,YAAY,CAAC;IACtB,2BAA2B;IAC3B,QAAQ,CAAC,EAAE,aAAa,EAAE,CAAC;IAC3B,4BAA4B;IAC5B,SAAS,CAAC,EAAE,cAAc,EAAE,CAAC;IAC7B,0FAA0F;IAC1F,SAAS,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,OAAO,CAAC,CAAC;IACpC,kDAAkD;IAClD,KAAK,CAAC,EAAE,WAAW,CAAC;IACpB,mDAAmD;IACnD,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,8BAA8B;IAC9B,OAAO,CAAC,EAAE,aAAa,CAAC;IACxB,gEAAgE;IAChE,WAAW,CAAC,EAAE,iBAAiB,CAAC;IAChC,sEAAsE;IACtE,gBAAgB,CAAC,EAAE,sBAAsB,CAAC;IAC1C,6BAA6B;IAC7B,OAAO,CAAC,EAAE,aAAa,CAAC;CAC3B;AAED;;;;;;;GAOG;AACH,MAAM,WAAW,aAAa;IAC1B,6FAA6F;IAC7F,GAAG,CAAC,EAAE,MAAM,CAAC;IACb,4EAA4E;IAC5E,GAAG,CAAC,EAAE,MAAM,CAAC;CAChB;AAED;;;GAGG;AACH,eAAO,MAAM,qBAAqB,mLAgBgB,CAAC;AAEnD,mDAAmD;AACnD,MAAM,MAAM,aAAa,GAAG,CAAC,OAAO,qBAAqB,CAAC,CAAC,MAAM,CAAC,CAAC;AAEnE;;;;;;;;;;;;GAYG;AACH,wBAAgB,cAAc,CAAC,CAAC,SAAS,UAAU,EAAE,MAAM,EAAE,CAAC,GAAG,CAAC,CAgBjE"}

package/dist/xray-config.js

@@ -1,3 +1,53 @@
 "use strict";
 Object.defineProperty(exports, "__esModule", { value: true });
+exports.XRAY_CONFIG_KEY_ORDER = void 0;
+exports.sortXrayConfig = sortXrayConfig;
+/**
+ * All top-level keys of XrayConfig in canonical order.
+ * Use with `sortXrayConfig` or for your own normalization logic.
+ */
+exports.XRAY_CONFIG_KEY_ORDER = [
+    'log',
+    'api',
+    'metrics',
+    'dns',
+    'routing',
+    'policy',
+    'inbounds',
+    'outbounds',
+    'transport',
+    'stats',
+    'reverse',
+    'fakeDns',
+    'observatory',
+    'burstObservatory',
+    'version',
+];
+/**
+ * Returns a new XrayConfig with keys sorted in canonical order.
+ * Unknown keys (not in the standard set) are appended at the end
+ * in their original order.
+ *
+ * @example
+ * ```typescript
+ * import { sortXrayConfig } from 'xray-typed';
+ *
+ * const normalized = sortXrayConfig(rawConfig);
+ * const json = JSON.stringify(normalized, null, 2);
+ * ```
+ */
+function sortXrayConfig(config) {
+    const sorted = {};
+    for (const key of exports.XRAY_CONFIG_KEY_ORDER) {
+        if (key in config) {
+            sorted[key] = config[key];
+        }
+    }
+    for (const key of Object.keys(config)) {
+        if (!(key in sorted)) {
+            sorted[key] = config[key];
+        }
+    }
+    return sorted;
+}
 //# sourceMappingURL=xray-config.js.map

package/dist/xray-config.js.map

@@ -1 +1 @@
-{"version":3,"file":"xray-config.js","sourceRoot":"","sources":["../src/xray-config.ts"],"names":[],"mappings":""}
+{"version":3,"file":"xray-config.js","sourceRoot":"","sources":["../src/xray-config.ts"],"names":[],"mappings":";;;AAoHA,wCAgBC;AAtDD;;;GAGG;AACU,QAAA,qBAAqB,GAAG;IACjC,KAAK;IACL,KAAK;IACL,SAAS;IACT,KAAK;IACL,SAAS;IACT,QAAQ;IACR,UAAU;IACV,WAAW;IACX,WAAW;IACX,OAAO;IACP,SAAS;IACT,SAAS;IACT,aAAa;IACb,kBAAkB;IAClB,SAAS;CACqC,CAAC;AAKnD;;;;;;;;;;;;GAYG;AACH,SAAgB,cAAc,CAAuB,MAAS;IAC1D,MAAM,MAAM,GAAG,EAA6B,CAAC;IAE7C,KAAK,MAAM,GAAG,IAAI,6BAAqB,EAAE,CAAC;QACtC,IAAI,GAAG,IAAI,MAAM,EAAE,CAAC;YAChB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAG,CAAC,CAAC;QAC9B,CAAC;IACL,CAAC;IAED,KAAK,MAAM,GAAG,IAAI,MAAM,CAAC,IAAI,CAAC,MAAM,CAAC,EAAE,CAAC;QACpC,IAAI,CAAC,CAAC,GAAG,IAAI,MAAM,CAAC,EAAE,CAAC;YACnB,MAAM,CAAC,GAAG,CAAC,GAAG,MAAM,CAAC,GAAc,CAAC,CAAC;QACzC,CAAC;IACL,CAAC;IAED,OAAO,MAAW,CAAC;AACvB,CAAC"}

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "xray-typed",
-  "version": "1.0.1",
+  "version": "1.0.3",
   "description": "Complete TypeScript type definitions for Xray-Core JSON configuration",
   "main": "dist/index.js",
   "types": "dist/index.d.ts",
@@ -27,4 +27,4 @@
   "devDependencies": {
     "typescript": "^5.9.3"
   }
-}
+}