mcp-xray-pilot 0.10.0

package/dist/schemas/protocols/vmess.js

@@ -0,0 +1,48 @@
+/*
+ * VMess settings schemas.
+ * Source: docs/en/config/inbounds/vmess.md, outbounds/vmess.md
+ */
+import { z } from "zod";
+import { email, userLevel, uuid } from "./common.js";
+const vmessClient = z
+    .object({
+    id: uuid,
+    level: userLevel.optional(),
+    email: email.optional(),
+})
+    .passthrough();
+export const vmessInbound = z
+    .object({
+    clients: z.array(vmessClient).min(1),
+    default: z
+        .object({
+        level: userLevel.optional(),
+    })
+        .passthrough()
+        .optional(),
+    detour: z.object({ to: z.string() }).passthrough().optional(),
+})
+    .passthrough();
+const vmessUser = z
+    .object({
+    id: uuid,
+    security: z
+        .enum(["aes-128-gcm", "chacha20-poly1305", "auto", "none", "zero"])
+        .optional(),
+    level: userLevel.optional(),
+    email: email.optional(),
+})
+    .passthrough();
+const vmessServer = z
+    .object({
+    address: z.string().min(1),
+    port: z.number().int().min(1).max(65535),
+    users: z.array(vmessUser).min(1),
+})
+    .passthrough();
+export const vmessOutbound = z
+    .object({
+    vnext: z.array(vmessServer).min(1),
+})
+    .passthrough();
+//# sourceMappingURL=vmess.js.map

package/dist/schemas/protocols/vmess.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"vmess.js","sourceRoot":"","sources":["../../../src/schemas/protocols/vmess.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,KAAK,EAAE,SAAS,EAAE,IAAI,EAAE,MAAM,aAAa,CAAC;AAErD,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,EAAE,EAAE,IAAI;IACR,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;CACxB,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IACpC,OAAO,EAAE,CAAC;SACP,MAAM,CAAC;QACN,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;KAC5B,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;IACb,MAAM,EAAE,CAAC,CAAC,MAAM,CAAC,EAAE,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,EAAE,CAAC,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAC9D,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,CAAC;IACN,EAAE,EAAE,IAAI;IACR,QAAQ,EAAE,CAAC;SACR,IAAI,CAAC,CAAC,aAAa,EAAE,mBAAmB,EAAE,MAAM,EAAE,MAAM,EAAE,MAAM,CAAC,CAAC;SAClE,QAAQ,EAAE;IACb,KAAK,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC3B,KAAK,EAAE,KAAK,CAAC,QAAQ,EAAE;CACxB,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC1B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,KAAK,CAAC;IACxC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,SAAS,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACjC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;CACnC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/protocols/wireguard.js

@@ -0,0 +1,34 @@
+/*
+ * WireGuard settings schemas (inbound and outbound).
+ * Source: docs/en/config/inbounds/wireguard.md, outbounds/wireguard.md
+ */
+import { z } from "zod";
+const peer = z
+    .object({
+    publicKey: z.string().min(1).optional(),
+    endpoint: z.string().optional(),
+    allowedIPs: z.array(z.string()).optional(),
+    preSharedKey: z.string().optional(),
+    keepAlive: z.number().int().nonnegative().optional(),
+})
+    .passthrough();
+export const wireguardInbound = z
+    .object({
+    secretKey: z.string().min(1),
+    peers: z.array(peer).min(1),
+    mtu: z.number().int().positive().optional(),
+    kernelMode: z.boolean().optional(),
+})
+    .passthrough();
+export const wireguardOutbound = z
+    .object({
+    secretKey: z.string().min(1),
+    address: z.array(z.string()).optional(),
+    peers: z.array(peer).min(1),
+    mtu: z.number().int().positive().optional(),
+    workers: z.number().int().nonnegative().optional(),
+    domainStrategy: z.string().optional(),
+    reserved: z.array(z.number().int()).optional(),
+})
+    .passthrough();
+//# sourceMappingURL=wireguard.js.map

package/dist/schemas/protocols/wireguard.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"wireguard.js","sourceRoot":"","sources":["../../../src/schemas/protocols/wireguard.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,IAAI,GAAG,CAAC;KACX,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACvC,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,UAAU,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC1C,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CACrD,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,gBAAgB,GAAG,CAAC;KAC9B,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACnC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,iBAAiB,GAAG,CAAC;KAC/B,MAAM,CAAC;IACN,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC5B,OAAO,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACvC,KAAK,EAAE,CAAC,CAAC,KAAK,CAAC,IAAI,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC;IAC3B,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,QAAQ,EAAE,CAAC,QAAQ,EAAE;IAC3C,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAClD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACrC,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,CAAC,QAAQ,EAAE;CAC/C,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/security/index.js

@@ -0,0 +1,16 @@
+/*
+ * Security registry.
+ *
+ * Maps streamSettings.security → schema for the matching settings block.
+ */
+import { tlsSettings } from "./tls.js";
+import { realitySettings } from "./reality.js";
+export const securitySpecs = [
+    { security: "tls", settingsKey: "tlsSettings", schema: tlsSettings },
+    { security: "reality", settingsKey: "realitySettings", schema: realitySettings },
+];
+export const securityByName = Object.fromEntries(securitySpecs.map((s) => [s.security, s]));
+export const allSecuritySettingsKeys = new Set(securitySpecs.map((s) => s.settingsKey));
+export { tlsFingerprints, alpnValues } from "./tls.js";
+export { xtlsFlowValues } from "./xtls.js";
+//# sourceMappingURL=index.js.map

package/dist/schemas/security/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/security/index.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,eAAe,EAAE,MAAM,cAAc,CAAC;AAQ/C,MAAM,CAAC,MAAM,aAAa,GAAmB;IAC3C,EAAE,QAAQ,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;IACpE,EAAE,QAAQ,EAAE,SAAS,EAAE,WAAW,EAAE,iBAAiB,EAAE,MAAM,EAAE,eAAe,EAAE;CACjF,CAAC;AAEF,MAAM,CAAC,MAAM,cAAc,GAAiC,MAAM,CAAC,WAAW,CAC5E,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE,CAAC,CAAC,CAAC,CAC1C,CAAC;AAEF,MAAM,CAAC,MAAM,uBAAuB,GAAG,IAAI,GAAG,CAAC,aAAa,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC;AAExF,OAAO,EAAE,eAAe,EAAE,UAAU,EAAE,MAAM,UAAU,CAAC;AACvD,OAAO,EAAE,cAAc,EAAE,MAAM,WAAW,CAAC"}

package/dist/schemas/security/reality.js

@@ -0,0 +1,35 @@
+/*
+ * REALITY streamSettings.realitySettings.
+ * Source: docs/en/config/transport.md
+ *
+ * Validates field shape; semantic checks (key length, hex shortIds, target
+ * grammar) are also enforced as separate lint rules so they show up as
+ * structured issues with explicit rule ids.
+ */
+import { z } from "zod";
+import { tlsFingerprints } from "./tls.js";
+const base64url43 = z
+    .string()
+    .regex(/^[A-Za-z0-9_-]{43}$/, "REALITY key must be 43 base64url chars (no padding)");
+const shortIdHex = z
+    .string()
+    .regex(/^([0-9a-fA-F]{2}){0,8}$/, "REALITY shortId must be hex, even length 0..16");
+export const realitySettings = z
+    .object({
+    show: z.boolean().optional(),
+    target: z.string().optional(),
+    dest: z.string().optional(),
+    xver: z.number().int().nonnegative().optional(),
+    serverNames: z.array(z.string().min(1)).min(1).optional(),
+    privateKey: base64url43.optional(),
+    publicKey: base64url43.optional(),
+    minClientVer: z.string().optional(),
+    maxClientVer: z.string().optional(),
+    maxTimeDiff: z.number().int().nonnegative().optional(),
+    shortIds: z.array(shortIdHex).optional(),
+    spiderX: z.string().optional(),
+    fingerprint: z.enum(tlsFingerprints).optional(),
+    serverName: z.string().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=reality.js.map

package/dist/schemas/security/reality.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"reality.js","sourceRoot":"","sources":["../../../src/schemas/security/reality.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AACxB,OAAO,EAAE,eAAe,EAAE,MAAM,UAAU,CAAC;AAE3C,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,EAAE;KACR,KAAK,CAAC,qBAAqB,EAAE,qDAAqD,CAAC,CAAC;AAEvF,MAAM,UAAU,GAAG,CAAC;KACjB,MAAM,EAAE;KACR,KAAK,CACJ,yBAAyB,EACzB,gDAAgD,CACjD,CAAC;AAEJ,MAAM,CAAC,MAAM,eAAe,GAAG,CAAC;KAC7B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC5B,MAAM,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC7B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC/C,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,CAAC,GAAG,CAAC,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzD,UAAU,EAAE,WAAW,CAAC,QAAQ,EAAE;IAClC,SAAS,EAAE,WAAW,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACtD,QAAQ,EAAE,CAAC,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,QAAQ,EAAE;IACxC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC/C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAClC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/security/tls.js

@@ -0,0 +1,46 @@
+/*
+ * TLS streamSettings.tlsSettings.
+ * Source: docs/en/config/transport.md (security section)
+ */
+import { z } from "zod";
+export const tlsFingerprints = [
+    "chrome",
+    "firefox",
+    "safari",
+    "ios",
+    "android",
+    "edge",
+    "360",
+    "qq",
+    "random",
+    "randomized",
+    "unsafe",
+];
+export const alpnValues = ["h2", "http/1.1", "h3"];
+const certificate = z
+    .object({
+    usage: z.enum(["encipherment", "verify", "issue"]).optional(),
+    certificateFile: z.string().optional(),
+    keyFile: z.string().optional(),
+    certificate: z.array(z.string()).optional(),
+    key: z.array(z.string()).optional(),
+})
+    .passthrough();
+export const tlsSettings = z
+    .object({
+    serverName: z.string().optional(),
+    rejectUnknownSni: z.boolean().optional(),
+    allowInsecure: z.boolean().optional(),
+    alpn: z.array(z.enum(alpnValues)).optional(),
+    minVersion: z.string().optional(),
+    maxVersion: z.string().optional(),
+    cipherSuites: z.string().optional(),
+    fingerprint: z.enum(tlsFingerprints).optional(),
+    certificates: z.array(certificate).optional(),
+    disableSystemRoot: z.boolean().optional(),
+    enableSessionResumption: z.boolean().optional(),
+    pinnedPeerCertificateChainSha256: z.array(z.string()).optional(),
+    masterKeyLog: z.string().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=tls.js.map

package/dist/schemas/security/tls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tls.js","sourceRoot":"","sources":["../../../src/schemas/security/tls.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,eAAe,GAAG;IAC7B,QAAQ;IACR,SAAS;IACT,QAAQ;IACR,KAAK;IACL,SAAS;IACT,MAAM;IACN,KAAK;IACL,IAAI;IACJ,QAAQ;IACR,YAAY;IACZ,QAAQ;CACA,CAAC;AAEX,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC,IAAI,EAAE,UAAU,EAAE,IAAI,CAAU,CAAC;AAE5D,MAAM,WAAW,GAAG,CAAC;KAClB,MAAM,CAAC;IACN,KAAK,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,cAAc,EAAE,QAAQ,EAAE,OAAO,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC7D,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACtC,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC9B,WAAW,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAC3C,GAAG,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,gBAAgB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACxC,aAAa,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACrC,IAAI,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,IAAI,CAAC,UAAU,CAAC,CAAC,CAAC,QAAQ,EAAE;IAC5C,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACnC,WAAW,EAAE,CAAC,CAAC,IAAI,CAAC,eAAe,CAAC,CAAC,QAAQ,EAAE;IAC/C,YAAY,EAAE,CAAC,CAAC,KAAK,CAAC,WAAW,CAAC,CAAC,QAAQ,EAAE;IAC7C,iBAAiB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACzC,uBAAuB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/C,gCAAgC,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IAChE,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACpC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/security/xtls.js

@@ -0,0 +1,17 @@
+/*
+ * XTLS flow values + helper guards.
+ * Source: docs/en/config/features/xtls.md
+ *
+ * The flow lives on the per-client/user object inside settings, not
+ * inside streamSettings. Schema is just the enum; semantic compatibility
+ * (vision requires raw + tls/reality) lives in lint rules.
+ */
+import { z } from "zod";
+export const xtlsFlowValues = [
+    "",
+    "none",
+    "xtls-rprx-vision",
+    "xtls-rprx-vision-udp443",
+];
+export const xtlsFlow = z.enum(xtlsFlowValues);
+//# sourceMappingURL=xtls.js.map

package/dist/schemas/security/xtls.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xtls.js","sourceRoot":"","sources":["../../../src/schemas/security/xtls.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,cAAc,GAAG;IAC5B,EAAE;IACF,MAAM;IACN,kBAAkB;IAClB,yBAAyB;CACjB,CAAC;AAEX,MAAM,CAAC,MAAM,QAAQ,GAAG,CAAC,CAAC,IAAI,CAAC,cAAc,CAAC,CAAC"}

package/dist/schemas/transports/grpc.js

@@ -0,0 +1,18 @@
+/*
+ * gRPC transport.
+ * Source: docs/en/config/transports/grpc.md
+ */
+import { z } from "zod";
+export const grpcSettings = z
+    .object({
+    serviceName: z.string().min(1),
+    multiMode: z.boolean().optional(),
+    idle_timeout: z.number().int().nonnegative().optional(),
+    health_check_timeout: z.number().int().nonnegative().optional(),
+    permit_without_stream: z.boolean().optional(),
+    initial_windows_size: z.number().int().nonnegative().optional(),
+    user_agent: z.string().optional(),
+    authority: z.string().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=grpc.js.map

package/dist/schemas/transports/grpc.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"grpc.js","sourceRoot":"","sources":["../../../src/schemas/transports/grpc.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,WAAW,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,CAAC,CAAC,CAAC;IAC9B,SAAS,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACjC,YAAY,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACvD,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC/D,qBAAqB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7C,oBAAoB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC/D,UAAU,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IACjC,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/transports/httpupgrade.js

@@ -0,0 +1,14 @@
+/*
+ * HTTPUpgrade transport.
+ * Source: docs/en/config/transports/httpupgrade.md
+ */
+import { z } from "zod";
+export const httpUpgradeSettings = z
+    .object({
+    path: z.string().optional(),
+    host: z.string().optional(),
+    headers: z.record(z.string()).optional(),
+    acceptProxyProtocol: z.boolean().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=httpupgrade.js.map

package/dist/schemas/transports/httpupgrade.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"httpupgrade.js","sourceRoot":"","sources":["../../../src/schemas/transports/httpupgrade.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,mBAAmB,GAAG,CAAC;KACjC,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CAC5C,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/transports/hysteria.js

@@ -0,0 +1,25 @@
+/*
+ * Hysteria transport (rare — usually used as a protocol).
+ * Source: docs/en/config/transports/hysteria.md
+ */
+import { z } from "zod";
+export const hysteriaTransportSettings = z
+    .object({
+    password: z.string().optional(),
+    security: z
+        .object({
+        type: z.string().optional(),
+    })
+        .passthrough()
+        .optional(),
+    congestion: z
+        .object({
+        type: z.string().optional(),
+        up_mbps: z.number().int().nonnegative().optional(),
+        down_mbps: z.number().int().nonnegative().optional(),
+    })
+        .passthrough()
+        .optional(),
+})
+    .passthrough();
+//# sourceMappingURL=hysteria.js.map

package/dist/schemas/transports/hysteria.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"hysteria.js","sourceRoot":"","sources":["../../../src/schemas/transports/hysteria.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,yBAAyB,GAAG,CAAC;KACvC,MAAM,CAAC;IACN,QAAQ,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC;SACR,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;KAC5B,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;IACb,UAAU,EAAE,CAAC;SACV,MAAM,CAAC;QACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;QAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;QAClD,SAAS,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;KACrD,CAAC;SACD,WAAW,EAAE;SACb,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/transports/index.js

@@ -0,0 +1,32 @@
+/*
+ * Transport registry.
+ *
+ * Maps streamSettings.network → schema for the corresponding *Settings block.
+ * Tabular form so the validator can both:
+ *   1. validate the *Settings shape, and
+ *   2. detect a mismatch (network=ws but xhttpSettings present, etc).
+ */
+import { rawSettings } from "./raw.js";
+import { xhttpSettings } from "./xhttp.js";
+import { grpcSettings } from "./grpc.js";
+import { wsSettings } from "./websocket.js";
+import { mkcpSettings } from "./mkcp.js";
+import { httpUpgradeSettings } from "./httpupgrade.js";
+import { hysteriaTransportSettings } from "./hysteria.js";
+export const transportSpecs = [
+    { network: "raw", settingsKey: "rawSettings", schema: rawSettings },
+    { network: "tcp", settingsKey: "tcpSettings", schema: rawSettings },
+    { network: "xhttp", settingsKey: "xhttpSettings", schema: xhttpSettings },
+    { network: "splithttp", settingsKey: "splithttpSettings", schema: xhttpSettings },
+    { network: "grpc", settingsKey: "grpcSettings", schema: grpcSettings },
+    { network: "ws", settingsKey: "wsSettings", schema: wsSettings },
+    { network: "websocket", settingsKey: "wsSettings", schema: wsSettings },
+    { network: "kcp", settingsKey: "kcpSettings", schema: mkcpSettings },
+    { network: "mkcp", settingsKey: "kcpSettings", schema: mkcpSettings },
+    { network: "httpupgrade", settingsKey: "httpupgradeSettings", schema: httpUpgradeSettings },
+    { network: "hysteria", settingsKey: "hysteriaSettings", schema: hysteriaTransportSettings },
+];
+export const transportByNetwork = Object.fromEntries(transportSpecs.map((t) => [t.network, t]));
+/* All known *Settings keys, used to flag cross-network leftovers. */
+export const allSettingsKeys = new Set(transportSpecs.map((t) => t.settingsKey));
+//# sourceMappingURL=index.js.map

package/dist/schemas/transports/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/schemas/transports/index.ts"],"names":[],"mappings":"AAAA;;;;;;;GAOG;AAGH,OAAO,EAAE,WAAW,EAAE,MAAM,UAAU,CAAC;AACvC,OAAO,EAAE,aAAa,EAAE,MAAM,YAAY,CAAC;AAC3C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,UAAU,EAAE,MAAM,gBAAgB,CAAC;AAC5C,OAAO,EAAE,YAAY,EAAE,MAAM,WAAW,CAAC;AACzC,OAAO,EAAE,mBAAmB,EAAE,MAAM,kBAAkB,CAAC;AACvD,OAAO,EAAE,yBAAyB,EAAE,MAAM,eAAe,CAAC;AAS1D,MAAM,CAAC,MAAM,cAAc,GAAoB;IAC7C,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;IACnE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,WAAW,EAAE;IACnE,EAAE,OAAO,EAAE,OAAO,EAAE,WAAW,EAAE,eAAe,EAAE,MAAM,EAAE,aAAa,EAAE;IACzE,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,mBAAmB,EAAE,MAAM,EAAE,aAAa,EAAE;IACjF,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,cAAc,EAAE,MAAM,EAAE,YAAY,EAAE;IACtE,EAAE,OAAO,EAAE,IAAI,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE;IAChE,EAAE,OAAO,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,EAAE,MAAM,EAAE,UAAU,EAAE;IACvE,EAAE,OAAO,EAAE,KAAK,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE;IACpE,EAAE,OAAO,EAAE,MAAM,EAAE,WAAW,EAAE,aAAa,EAAE,MAAM,EAAE,YAAY,EAAE;IACrE,EAAE,OAAO,EAAE,aAAa,EAAE,WAAW,EAAE,qBAAqB,EAAE,MAAM,EAAE,mBAAmB,EAAE;IAC3F,EAAE,OAAO,EAAE,UAAU,EAAE,WAAW,EAAE,kBAAkB,EAAE,MAAM,EAAE,yBAAyB,EAAE;CAC5F,CAAC;AAEF,MAAM,CAAC,MAAM,kBAAkB,GAAkC,MAAM,CAAC,WAAW,CACjF,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,CAAC,OAAO,EAAE,CAAC,CAAC,CAAC,CAC1C,CAAC;AAEF,qEAAqE;AACrE,MAAM,CAAC,MAAM,eAAe,GAAG,IAAI,GAAG,CAAC,cAAc,CAAC,GAAG,CAAC,CAAC,CAAC,EAAE,EAAE,CAAC,CAAC,CAAC,WAAW,CAAC,CAAC,CAAC"}

package/dist/schemas/transports/mkcp.js

@@ -0,0 +1,34 @@
+/*
+ * mKCP transport.
+ * Source: docs/en/config/transports/mkcp.md
+ */
+import { z } from "zod";
+const headerObj = z
+    .object({
+    type: z
+        .enum([
+        "none",
+        "srtp",
+        "utp",
+        "wechat-video",
+        "dtls",
+        "wireguard",
+        "dns",
+    ])
+        .optional(),
+})
+    .passthrough();
+export const mkcpSettings = z
+    .object({
+    mtu: z.number().int().min(576).max(1460).optional(),
+    tti: z.number().int().min(10).max(100).optional(),
+    uplinkCapacity: z.number().int().nonnegative().optional(),
+    downlinkCapacity: z.number().int().nonnegative().optional(),
+    congestion: z.boolean().optional(),
+    readBufferSize: z.number().int().nonnegative().optional(),
+    writeBufferSize: z.number().int().nonnegative().optional(),
+    header: headerObj.optional(),
+    seed: z.string().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=mkcp.js.map

package/dist/schemas/transports/mkcp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"mkcp.js","sourceRoot":"","sources":["../../../src/schemas/transports/mkcp.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC;SACJ,IAAI,CAAC;QACJ,MAAM;QACN,MAAM;QACN,KAAK;QACL,cAAc;QACd,MAAM;QACN,WAAW;QACX,KAAK;KACN,CAAC;SACD,QAAQ,EAAE;CACd,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,YAAY,GAAG,CAAC;KAC1B,MAAM,CAAC;IACN,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,GAAG,CAAC,IAAI,CAAC,CAAC,QAAQ,EAAE;IACnD,GAAG,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,GAAG,CAAC,EAAE,CAAC,CAAC,GAAG,CAAC,GAAG,CAAC,CAAC,QAAQ,EAAE;IACjD,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACzD,gBAAgB,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC3D,UAAU,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAClC,cAAc,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IACzD,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;IAC1D,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;IAC5B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;CAC5B,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/transports/raw.js

@@ -0,0 +1,19 @@
+/*
+ * Raw / TCP transport (streamSettings.network = "raw" or "tcp").
+ * Source: docs/en/config/transports/raw.md, transports/tcp.md
+ */
+import { z } from "zod";
+const headerObj = z
+    .object({
+    type: z.enum(["none", "http"]).optional(),
+    request: z.unknown().optional(),
+    response: z.unknown().optional(),
+})
+    .passthrough();
+export const rawSettings = z
+    .object({
+    acceptProxyProtocol: z.boolean().optional(),
+    header: headerObj.optional(),
+})
+    .passthrough();
+//# sourceMappingURL=raw.js.map

package/dist/schemas/transports/raw.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"raw.js","sourceRoot":"","sources":["../../../src/schemas/transports/raw.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,SAAS,GAAG,CAAC;KAChB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzC,OAAO,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC/B,QAAQ,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;CACjC,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,WAAW,GAAG,CAAC;KACzB,MAAM,CAAC;IACN,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3C,MAAM,EAAE,SAAS,CAAC,QAAQ,EAAE;CAC7B,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/transports/websocket.js

@@ -0,0 +1,15 @@
+/*
+ * WebSocket transport.
+ * Source: docs/en/config/transports/websocket.md
+ */
+import { z } from "zod";
+export const wsSettings = z
+    .object({
+    path: z.string().optional(),
+    host: z.string().optional(),
+    headers: z.record(z.string()).optional(),
+    acceptProxyProtocol: z.boolean().optional(),
+    heartbeatPeriod: z.number().int().nonnegative().optional(),
+})
+    .passthrough();
+//# sourceMappingURL=websocket.js.map

package/dist/schemas/transports/websocket.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"websocket.js","sourceRoot":"","sources":["../../../src/schemas/transports/websocket.ts"],"names":[],"mappings":"AAAA;;;GAGG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,CAAC,MAAM,UAAU,GAAG,CAAC;KACxB,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,mBAAmB,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC3C,eAAe,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,CAAC,WAAW,EAAE,CAAC,QAAQ,EAAE;CAC3D,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/schemas/transports/xhttp.js

@@ -0,0 +1,34 @@
+/*
+ * XHTTP transport.
+ * Source: docs/en/config/transports/xhttp.md (stub) + Xray-core/discussions/4113
+ *
+ * The official .md is a stub linking to the discussion. Field set is encoded
+ * here from the discussion + observed configs in the wild.
+ */
+import { z } from "zod";
+const xmux = z
+    .object({
+    maxConcurrency: z.union([z.number().int(), z.string()]).optional(),
+    maxConnections: z.union([z.number().int(), z.string()]).optional(),
+    cMaxReuseTimes: z.union([z.number().int(), z.string()]).optional(),
+    hMaxRequestTimes: z.union([z.number().int(), z.string()]).optional(),
+    hMaxReusableSecs: z.union([z.number().int(), z.string()]).optional(),
+    hKeepAlivePeriod: z.union([z.number().int(), z.string()]).optional(),
+})
+    .passthrough();
+export const xhttpSettings = z
+    .object({
+    path: z.string().optional(),
+    host: z.string().optional(),
+    mode: z.enum(["auto", "packet-up", "stream-up", "stream-one"]).optional(),
+    extra: z.unknown().optional(),
+    headers: z.record(z.string()).optional(),
+    xmux: xmux.optional(),
+    noGRPCHeader: z.boolean().optional(),
+    xPaddingBytes: z.union([z.number().int(), z.string()]).optional(),
+    scMaxEachPostBytes: z.union([z.number().int(), z.string()]).optional(),
+    scMinPostsIntervalMs: z.union([z.number().int(), z.string()]).optional(),
+    scStreamUpServerSecs: z.union([z.number().int(), z.string()]).optional(),
+})
+    .passthrough();
+//# sourceMappingURL=xhttp.js.map

package/dist/schemas/transports/xhttp.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"xhttp.js","sourceRoot":"","sources":["../../../src/schemas/transports/xhttp.ts"],"names":[],"mappings":"AAAA;;;;;;GAMG;AAEH,OAAO,EAAE,CAAC,EAAE,MAAM,KAAK,CAAC;AAExB,MAAM,IAAI,GAAG,CAAC;KACX,MAAM,CAAC;IACN,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,cAAc,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IAClE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACpE,gBAAgB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACrE,CAAC;KACD,WAAW,EAAE,CAAC;AAEjB,MAAM,CAAC,MAAM,aAAa,GAAG,CAAC;KAC3B,MAAM,CAAC;IACN,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,QAAQ,EAAE;IAC3B,IAAI,EAAE,CAAC,CAAC,IAAI,CAAC,CAAC,MAAM,EAAE,WAAW,EAAE,WAAW,EAAE,YAAY,CAAC,CAAC,CAAC,QAAQ,EAAE;IACzE,KAAK,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IAC7B,OAAO,EAAE,CAAC,CAAC,MAAM,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,QAAQ,EAAE;IACxC,IAAI,EAAE,IAAI,CAAC,QAAQ,EAAE;IACrB,YAAY,EAAE,CAAC,CAAC,OAAO,EAAE,CAAC,QAAQ,EAAE;IACpC,aAAa,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACjE,kBAAkB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACtE,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;IACxE,oBAAoB,EAAE,CAAC,CAAC,KAAK,CAAC,CAAC,CAAC,CAAC,MAAM,EAAE,CAAC,GAAG,EAAE,EAAE,CAAC,CAAC,MAAM,EAAE,CAAC,CAAC,CAAC,QAAQ,EAAE;CACzE,CAAC;KACD,WAAW,EAAE,CAAC"}

package/dist/search.js

@@ -0,0 +1,78 @@
+/*
+ * Tiny full-text search over cached docs.
+ *
+ * Approach: tokenise both query and docs, score by:
+ *   - exact phrase hits in body          ×10
+ *   - exact phrase hit in title          ×25
+ *   - per-token frequency in body        ×1
+ *   - per-token hit in title             ×5
+ * No stemming, no IDF — the corpus is small (~50 docs) and the query is
+ * usually 1-3 keywords. Returns top N hits with snippets.
+ */
+import { readAllTopics } from "./state.js";
+import { snippet } from "./utils.js";
+function tokenise(s) {
+    return s
+        .toLowerCase()
+        .split(/[^a-z0-9_]+/)
+        .filter((t) => t.length >= 2);
+}
+function scoreTopic(topic, query, tokens) {
+    const titleLower = topic.title.toLowerCase();
+    const bodyLower = topic.markdown.toLowerCase();
+    const phrase = query.trim().toLowerCase();
+    let score = 0;
+    if (phrase.length >= 2) {
+        if (titleLower.includes(phrase))
+            score += 25;
+        /* count phrase occurrences in body, capped at 5 to avoid runaway. */
+        let from = 0;
+        let phraseHits = 0;
+        while (phraseHits < 5) {
+            const i = bodyLower.indexOf(phrase, from);
+            if (i < 0)
+                break;
+            phraseHits++;
+            from = i + phrase.length;
+        }
+        score += phraseHits * 10;
+    }
+    for (const t of tokens) {
+        if (titleLower.includes(t))
+            score += 5;
+        /* token frequency in body. */
+        let from = 0;
+        let hits = 0;
+        while (hits < 50) {
+            const i = bodyLower.indexOf(t, from);
+            if (i < 0)
+                break;
+            hits++;
+            from = i + t.length;
+        }
+        score += hits;
+    }
+    return score;
+}
+export async function search(query, maxResults = 10) {
+    const tokens = tokenise(query);
+    if (tokens.length === 0 && query.trim().length < 2)
+        return [];
+    const topics = await readAllTopics();
+    const scored = [];
+    for (const t of topics) {
+        const s = scoreTopic(t, query, tokens);
+        if (s <= 0)
+            continue;
+        scored.push({
+            slug: t.slug,
+            title: t.title,
+            category: t.category,
+            score: s,
+            snippet: snippet(t.markdown, query, 240),
+        });
+    }
+    scored.sort((a, b) => b.score - a.score);
+    return scored.slice(0, Math.max(1, maxResults));
+}
+//# sourceMappingURL=search.js.map

package/dist/search.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"search.js","sourceRoot":"","sources":["../src/search.ts"],"names":[],"mappings":"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"}

package/dist/state.js

@@ -0,0 +1,87 @@
+/*
+ * Global server state — process-wide, in-memory.
+ *
+ * Resolves the on-disk docs directory next to the package, lazily loads
+ * the bundled `_index.json`, and caches Topic bodies after first read.
+ *
+ * This is the only module that knows the actual filesystem layout.
+ */
+import path from "node:path";
+import { fileURLToPath } from "node:url";
+import { promises as fs } from "node:fs";
+import { parseFrontmatter } from "./utils.js";
+const here = path.dirname(fileURLToPath(import.meta.url));
+/* dist/state.js → ../data/docs/   (same layout when running from src via tsx). */
+export const DOCS_DIR = path.resolve(here, "..", "data", "docs");
+export const INDEX_FILE = path.join(DOCS_DIR, "_index.json");
+const state = {
+    index: null,
+    bodyCache: new Map(),
+};
+export async function loadIndex(forceReload = false) {
+    if (state.index && !forceReload)
+        return state.index;
+    try {
+        const raw = await fs.readFile(INDEX_FILE, "utf8");
+        const parsed = JSON.parse(raw);
+        state.index = Array.isArray(parsed) ? parsed : [];
+    }
+    catch {
+        /* Bundle may be absent during first-time dev before fetch-docs ran. */
+        state.index = [];
+    }
+    return state.index;
+}
+export async function saveIndex(index) {
+    await fs.mkdir(DOCS_DIR, { recursive: true });
+    await fs.writeFile(INDEX_FILE, JSON.stringify(index, null, 2), "utf8");
+    state.index = index;
+}
+export async function readTopic(slug) {
+    const cached = state.bodyCache.get(slug);
+    if (cached)
+        return cached;
+    const index = await loadIndex();
+    const meta = index.find((m) => m.slug === slug);
+    if (!meta)
+        return null;
+    const filePath = path.join(DOCS_DIR, meta.file);
+    let raw;
+    try {
+        raw = await fs.readFile(filePath, "utf8");
+    }
+    catch {
+        return null;
+    }
+    const { meta: fm, body } = parseFrontmatter(raw);
+    const topic = {
+        ...meta,
+        title: fm.title || meta.title,
+        markdown: body,
+    };
+    state.bodyCache.set(slug, topic);
+    return topic;
+}
+export async function writeTopic(topic, frontmatter) {
+    await fs.mkdir(DOCS_DIR, { recursive: true });
+    const filePath = path.join(DOCS_DIR, topic.file);
+    await fs.writeFile(filePath, frontmatter + topic.markdown + "\n", "utf8");
+    state.bodyCache.set(topic.slug, topic);
+}
+export function dropCache(slug) {
+    if (slug)
+        state.bodyCache.delete(slug);
+    else
+        state.bodyCache.clear();
+}
+export async function readAllTopics() {
+    const index = await loadIndex();
+    const topics = [];
+    for (const m of index) {
+        const t = await readTopic(m.slug);
+        if (t)
+            topics.push(t);
+    }
+    return topics;
+}
+//# sourceMappingURL=state.js.map