@singbox-iac/cli 0.1.0

package/dist/modules/preview/index.js

@@ -0,0 +1,141 @@
+import { spawn } from "node:child_process";
+import { constants } from "node:fs";
+import { access, mkdtemp, readFile, rm, writeFile } from "node:fs/promises";
+import { tmpdir } from "node:os";
+import path from "node:path";
+import { buildConfigArtifact } from "../build/index.js";
+import { applyPlanToBuilderConfig, renderGeneratedRules, renderUpdatedBuilderConfig, } from "../natural-language/index.js";
+export async function generateAuthoringPreview(input) {
+    const [currentConfigRaw, currentRulesRaw] = await Promise.all([
+        readFile(input.configPath, "utf8"),
+        readFileIfExists(input.rulesPath),
+    ]);
+    const proposedRules = renderGeneratedRules(input.plan);
+    const proposedConfig = renderUpdatedBuilderConfig({
+        rawConfig: currentConfigRaw,
+        rulesPath: input.rulesPath,
+        ...(input.plan.scheduleIntervalMinutes
+            ? { intervalMinutes: input.plan.scheduleIntervalMinutes }
+            : {}),
+        ...(input.plan.groupDefaults ? { groupDefaults: input.plan.groupDefaults } : {}),
+        ...(input.plan.verificationOverrides
+            ? { verificationOverrides: input.plan.verificationOverrides }
+            : {}),
+    });
+    const effectiveConfig = applyPlanToBuilderConfig(input.config, {
+        rulesPath: input.rulesPath,
+        plan: input.plan,
+    });
+    const rulesDiff = await createUnifiedDiff("rules", currentRulesRaw ?? "", proposedRules);
+    const configDiff = await createUnifiedDiff("builder-config", currentConfigRaw, proposedConfig);
+    if (input.buildStaging === false) {
+        return {
+            rulesDiff,
+            configDiff,
+        };
+    }
+    const runDir = await mkdtemp(path.join(tmpdir(), "singbox-iac-author-preview-"));
+    try {
+        const tempRulesPath = path.join(runDir, "custom.rules.yaml");
+        const tempStagingPath = path.join(runDir, "config.staging.json");
+        await writeFile(tempRulesPath, proposedRules, "utf8");
+        await buildConfigArtifact({
+            config: {
+                ...effectiveConfig,
+                output: {
+                    ...effectiveConfig.output,
+                    stagingPath: tempStagingPath,
+                },
+                rules: {
+                    ...effectiveConfig.rules,
+                    userRulesFile: tempRulesPath,
+                },
+            },
+            ...(input.subscriptionFile ? { subscriptionFile: input.subscriptionFile } : {}),
+            ...(input.subscriptionUrl ? { subscriptionUrl: input.subscriptionUrl } : {}),
+        });
+        const [currentStagingRaw, proposedStagingRaw] = await Promise.all([
+            readFileIfExists(input.config.output.stagingPath),
+            readFile(tempStagingPath, "utf8"),
+        ]);
+        return {
+            rulesDiff,
+            configDiff,
+            stagingDiff: await createUnifiedDiff("staging-config", currentStagingRaw ?? "", proposedStagingRaw),
+        };
+    }
+    finally {
+        await rm(runDir, { recursive: true, force: true });
+    }
+}
+async function readFileIfExists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return readFile(filePath, "utf8");
+    }
+    catch {
+        return undefined;
+    }
+}
+async function createUnifiedDiff(label, currentContent, nextContent) {
+    const currentNormalized = ensureTrailingNewline(currentContent);
+    const nextNormalized = ensureTrailingNewline(nextContent);
+    if (currentNormalized === nextNormalized) {
+        return {
+            label,
+            changed: false,
+            diff: `(no changes in ${label})`,
+        };
+    }
+    const runDir = await mkdtemp(path.join(tmpdir(), "singbox-iac-diff-"));
+    try {
+        const beforePath = path.join(runDir, "before.txt");
+        const afterPath = path.join(runDir, "after.txt");
+        await Promise.all([
+            writeFile(beforePath, currentNormalized, "utf8"),
+            writeFile(afterPath, nextNormalized, "utf8"),
+        ]);
+        const diff = await runDiff(label, beforePath, afterPath);
+        return {
+            label,
+            changed: true,
+            diff,
+        };
+    }
+    finally {
+        await rm(runDir, { recursive: true, force: true });
+    }
+}
+async function runDiff(label, beforePath, afterPath) {
+    return new Promise((resolve, reject) => {
+        const child = spawn("/usr/bin/diff", [
+            "-u",
+            "-L",
+            `current:${label}`,
+            "-L",
+            `proposed:${label}`,
+            beforePath,
+            afterPath,
+        ]);
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0 || code === 1) {
+                resolve(stdout.trimEnd());
+                return;
+            }
+            reject(new Error(stderr.trim() || `diff failed for ${label}`));
+        });
+    });
+}
+function ensureTrailingNewline(content) {
+    return content.endsWith("\n") ? content : `${content}\n`;
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/preview/index.js.map

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

package/dist/modules/rule-templates/index.d.ts

@@ -0,0 +1,15 @@
+import type { UserRouteRule } from "../user-rules/index.js";
+export interface RuleTemplate {
+    readonly id: string;
+    readonly title: string;
+    readonly summary: string;
+    readonly beforeBuiltins: readonly UserRouteRule[];
+    readonly afterBuiltins: readonly UserRouteRule[];
+    readonly tags: readonly string[];
+}
+export declare function listRuleTemplates(): readonly RuleTemplate[];
+export declare function getRuleTemplate(id: string): RuleTemplate | undefined;
+export declare function mergeRuleTemplates(templateIds: readonly string[]): {
+    readonly beforeBuiltins: readonly UserRouteRule[];
+    readonly afterBuiltins: readonly UserRouteRule[];
+};

package/dist/modules/rule-templates/index.js

@@ -0,0 +1,200 @@
+const templateCatalog = [
+    {
+        id: "developer-ai-sites",
+        title: "Developer AI Sites",
+        summary: "Route common third-party AI sites like OpenRouter and Perplexity to AI-Out.",
+        tags: ["developer", "ai"],
+        beforeBuiltins: [
+            {
+                name: "OpenRouter uses the AI selector",
+                domainSuffix: ["openrouter.ai"],
+                route: "AI-Out",
+            },
+            {
+                name: "Perplexity uses the AI selector",
+                domainSuffix: ["perplexity.ai"],
+                route: "AI-Out",
+            },
+        ],
+        afterBuiltins: [],
+    },
+    {
+        id: "developer-common-sites",
+        title: "Developer Common Sites",
+        summary: "Route common third-party developer sites like GitLab, npm, Vercel, Docker Hub, and Stack Overflow to Dev-Common-Out.",
+        tags: ["developer", "tools"],
+        beforeBuiltins: [
+            {
+                name: "Common third-party developer sites use Dev-Common-Out",
+                domainSuffix: [
+                    "gitlab.com",
+                    "npmjs.com",
+                    "registry.npmjs.org",
+                    "vercel.com",
+                    "cloudflare.com",
+                    "docker.com",
+                    "hub.docker.com",
+                    "stackoverflow.com",
+                    "huggingface.co",
+                ],
+                route: "Dev-Common-Out",
+            },
+        ],
+        afterBuiltins: [],
+    },
+    {
+        id: "video-us",
+        title: "Video Streaming via US",
+        summary: "Route popular US-oriented video sites to the US selector.",
+        tags: ["video", "streaming", "us"],
+        beforeBuiltins: [
+            {
+                name: "US video streaming uses US",
+                domainSuffix: [
+                    "youtube.com",
+                    "youtu.be",
+                    "netflix.com",
+                    "nflxvideo.net",
+                    "primevideo.com",
+                    "amazonvideo.com",
+                    "disneyplus.com",
+                    "disney-plus.net",
+                    "tv.apple.com",
+                    "hulu.com",
+                    "max.com",
+                ],
+                route: "US",
+            },
+        ],
+        afterBuiltins: [],
+    },
+    {
+        id: "video-hk",
+        title: "Video Streaming via HK",
+        summary: "Route popular international video sites to the HK selector.",
+        tags: ["video", "streaming", "hk"],
+        beforeBuiltins: [
+            {
+                name: "International video streaming uses HK",
+                domainSuffix: [
+                    "youtube.com",
+                    "youtu.be",
+                    "netflix.com",
+                    "nflxvideo.net",
+                    "primevideo.com",
+                    "amazonvideo.com",
+                    "disneyplus.com",
+                    "disney-plus.net",
+                    "tv.apple.com",
+                    "hulu.com",
+                    "max.com",
+                    "twitch.tv",
+                ],
+                route: "HK",
+            },
+        ],
+        afterBuiltins: [],
+    },
+    {
+        id: "video-sg",
+        title: "Video Streaming via SG",
+        summary: "Route popular international video sites to the SG selector.",
+        tags: ["video", "streaming", "sg"],
+        beforeBuiltins: [
+            {
+                name: "International video streaming uses SG",
+                domainSuffix: [
+                    "youtube.com",
+                    "youtu.be",
+                    "netflix.com",
+                    "nflxvideo.net",
+                    "primevideo.com",
+                    "amazonvideo.com",
+                    "disneyplus.com",
+                    "disney-plus.net",
+                    "tv.apple.com",
+                    "hulu.com",
+                    "max.com",
+                    "twitch.tv",
+                ],
+                route: "SG",
+            },
+        ],
+        afterBuiltins: [],
+    },
+    {
+        id: "video-jp",
+        title: "Video Streaming via JP",
+        summary: "Route Japan-oriented video services to the JP selector.",
+        tags: ["video", "streaming", "jp"],
+        beforeBuiltins: [
+            {
+                name: "JP video streaming uses JP",
+                domainSuffix: ["abema.tv", "niconico.jp", "dmm.com", "lemino.docomo.ne.jp"],
+                route: "JP",
+            },
+        ],
+        afterBuiltins: [],
+    },
+    {
+        id: "cn-video-direct",
+        title: "China Video Direct",
+        summary: "Keep common mainland video sites on direct routing.",
+        tags: ["video", "cn", "direct"],
+        beforeBuiltins: [],
+        afterBuiltins: [
+            {
+                name: "Mainland video sites stay direct",
+                domainSuffix: [
+                    "bilibili.com",
+                    "bilibili.tv",
+                    "iqiyi.com",
+                    "iq.com",
+                    "youku.com",
+                    "mgtv.com",
+                ],
+                route: "direct",
+            },
+        ],
+    },
+];
+export function listRuleTemplates() {
+    return templateCatalog;
+}
+export function getRuleTemplate(id) {
+    return templateCatalog.find((template) => template.id === id);
+}
+export function mergeRuleTemplates(templateIds) {
+    const resolved = templateIds.map((id) => {
+        const template = getRuleTemplate(id);
+        if (!template) {
+            throw new Error(`Unknown rule template "${id}".`);
+        }
+        return template;
+    });
+    return {
+        beforeBuiltins: dedupeRules(resolved.flatMap((template) => template.beforeBuiltins)),
+        afterBuiltins: dedupeRules(resolved.flatMap((template) => template.afterBuiltins)),
+    };
+}
+function dedupeRules(rules) {
+    const byKey = new Map();
+    for (const rule of rules) {
+        byKey.set(stableRuleKey(rule), rule);
+    }
+    return [...byKey.values()];
+}
+function stableRuleKey(rule) {
+    return JSON.stringify({
+        inbound: rule.inbound ?? [],
+        protocol: rule.protocol ?? null,
+        network: rule.network ?? null,
+        port: rule.port ?? null,
+        domain: rule.domain ?? [],
+        domainSuffix: rule.domainSuffix ?? [],
+        ruleSet: rule.ruleSet ?? [],
+        route: rule.route ?? null,
+        action: rule.action ?? null,
+    });
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/rule-templates/index.js.map

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

package/dist/modules/schedule/index.d.ts

@@ -0,0 +1,32 @@
+export interface ScheduleInstallInput {
+    readonly configPath: string;
+    readonly intervalMinutes: number;
+    readonly cliEntrypoint: string;
+    readonly label?: string;
+    readonly launchAgentsDir?: string;
+    readonly workingDirectory?: string;
+    readonly logsDir?: string;
+    readonly force?: boolean;
+    readonly load?: boolean;
+}
+export interface ScheduleInstallResult {
+    readonly label: string;
+    readonly plistPath: string;
+    readonly stdoutPath: string;
+    readonly stderrPath: string;
+}
+export interface ScheduleRemoveInput {
+    readonly label?: string;
+    readonly launchAgentsDir?: string;
+    readonly unload?: boolean;
+}
+export declare function installLaunchdSchedule(input: ScheduleInstallInput): Promise<ScheduleInstallResult>;
+export declare function removeLaunchdSchedule(input: ScheduleRemoveInput): Promise<string>;
+export declare function renderLaunchAgentPlist(input: {
+    readonly label: string;
+    readonly intervalMinutes: number;
+    readonly workingDirectory: string;
+    readonly stdoutPath: string;
+    readonly stderrPath: string;
+    readonly programArguments: readonly string[];
+}): string;

package/dist/modules/schedule/index.js

@@ -0,0 +1,155 @@
+import { spawn } from "node:child_process";
+import { constants } from "node:fs";
+import { access, mkdir, rm, writeFile } from "node:fs/promises";
+import { homedir } from "node:os";
+import path from "node:path";
+const defaultLaunchAgentLabel = "org.singbox-iac.update";
+export async function installLaunchdSchedule(input) {
+    const label = input.label ?? defaultLaunchAgentLabel;
+    const launchAgentsDir = input.launchAgentsDir ?? path.join(homedir(), "Library", "LaunchAgents");
+    const logsDir = input.logsDir ?? path.join(homedir(), ".config", "singbox-iac", "logs");
+    const plistPath = path.join(launchAgentsDir, `${label}.plist`);
+    const stdoutPath = path.join(logsDir, `${label}.stdout.log`);
+    const stderrPath = path.join(logsDir, `${label}.stderr.log`);
+    if (input.force !== true && (await pathExists(plistPath))) {
+        throw new Error(`LaunchAgent already exists: ${plistPath}`);
+    }
+    await mkdir(launchAgentsDir, { recursive: true });
+    await mkdir(logsDir, { recursive: true });
+    if (input.load !== false) {
+        await runLaunchctl(["bootout", launchctlDomainService(label)], true);
+    }
+    const workingDirectory = input.workingDirectory ?? process.cwd();
+    const programArguments = resolveProgramArguments({
+        cliEntrypoint: path.resolve(input.cliEntrypoint),
+        configPath: path.resolve(input.configPath),
+        workingDirectory,
+    });
+    const plist = renderLaunchAgentPlist({
+        label,
+        intervalMinutes: input.intervalMinutes,
+        workingDirectory,
+        stdoutPath,
+        stderrPath,
+        programArguments,
+    });
+    await writeFile(plistPath, plist, "utf8");
+    if (input.load !== false) {
+        await runLaunchctl(["bootstrap", launchctlDomain(), plistPath]);
+    }
+    return {
+        label,
+        plistPath,
+        stdoutPath,
+        stderrPath,
+    };
+}
+export async function removeLaunchdSchedule(input) {
+    const label = input.label ?? defaultLaunchAgentLabel;
+    const launchAgentsDir = input.launchAgentsDir ?? path.join(homedir(), "Library", "LaunchAgents");
+    const plistPath = path.join(launchAgentsDir, `${label}.plist`);
+    if (input.unload !== false) {
+        await runLaunchctl(["bootout", launchctlDomainService(label)], true);
+    }
+    await rm(plistPath, { force: true });
+    return plistPath;
+}
+export function renderLaunchAgentPlist(input) {
+    return `<?xml version="1.0" encoding="UTF-8"?>
+<!DOCTYPE plist PUBLIC "-//Apple//DTD PLIST 1.0//EN" "http://www.apple.com/DTDs/PropertyList-1.0.dtd">
+<plist version="1.0">
+<dict>
+  <key>Label</key>
+  <string>${escapeXml(input.label)}</string>
+  <key>ProgramArguments</key>
+  <array>
+${input.programArguments
+        .map((argument) => `    <string>${escapeXml(argument)}</string>`)
+        .join("\n")}
+  </array>
+  <key>WorkingDirectory</key>
+  <string>${escapeXml(input.workingDirectory)}</string>
+  <key>StartInterval</key>
+  <integer>${input.intervalMinutes * 60}</integer>
+  <key>RunAtLoad</key>
+  <true/>
+  <key>StandardOutPath</key>
+  <string>${escapeXml(input.stdoutPath)}</string>
+  <key>StandardErrorPath</key>
+  <string>${escapeXml(input.stderrPath)}</string>
+  <key>EnvironmentVariables</key>
+  <dict>
+    <key>PATH</key>
+    <string>${escapeXml(resolveLaunchdPath())}</string>
+  </dict>
+</dict>
+</plist>
+`;
+}
+async function pathExists(filePath) {
+    try {
+        await access(filePath, constants.F_OK);
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+function launchctlDomain() {
+    if (typeof process.getuid !== "function") {
+        throw new Error("launchd scheduling requires process.getuid(), which is unavailable here.");
+    }
+    return `gui/${process.getuid()}`;
+}
+function launchctlDomainService(label) {
+    return `${launchctlDomain()}/${label}`;
+}
+async function runLaunchctl(args, allowFailure = false) {
+    await new Promise((resolve, reject) => {
+        const child = spawn("/bin/launchctl", args, {
+            stdio: ["ignore", "pipe", "pipe"],
+        });
+        let stdout = "";
+        let stderr = "";
+        child.stdout.on("data", (chunk) => {
+            stdout += chunk.toString();
+        });
+        child.stderr.on("data", (chunk) => {
+            stderr += chunk.toString();
+        });
+        child.on("error", reject);
+        child.on("close", (code) => {
+            if (code === 0 || allowFailure) {
+                resolve();
+                return;
+            }
+            const details = [stdout.trim(), stderr.trim()].filter((value) => value.length > 0).join("\n");
+            reject(new Error(details || `launchctl ${args.join(" ")} failed`));
+        });
+    });
+}
+function resolveLaunchdPath() {
+    const entries = [
+        process.env.PATH,
+        "/opt/homebrew/bin:/usr/local/bin:/usr/bin:/bin:/usr/sbin:/sbin",
+    ]
+        .filter((value) => typeof value === "string" && value.length > 0)
+        .flatMap((value) => value.split(path.delimiter));
+    return [...new Set(entries)].join(path.delimiter);
+}
+function resolveProgramArguments(input) {
+    if (path.extname(input.cliEntrypoint) === ".ts") {
+        const tsxBinary = path.resolve(input.workingDirectory, "node_modules", ".bin", "tsx");
+        return [tsxBinary, input.cliEntrypoint, "update", "--config", input.configPath];
+    }
+    return [process.execPath, input.cliEntrypoint, "update", "--config", input.configPath];
+}
+function escapeXml(value) {
+    return value
+        .replaceAll("&", "&amp;")
+        .replaceAll("<", "&lt;")
+        .replaceAll(">", "&gt;")
+        .replaceAll('"', "&quot;")
+        .replaceAll("'", "&apos;");
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/schedule/index.js.map

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

package/dist/modules/update/index.d.ts

@@ -0,0 +1,22 @@
+import type { BuilderConfig } from "../../config/schema.js";
+import type { BuiltConfigArtifact } from "../build/index.js";
+import { type VerificationReport } from "../verification/index.js";
+export interface RunUpdateInput {
+    readonly config: BuilderConfig;
+    readonly outputPath?: string;
+    readonly livePath?: string;
+    readonly backupPath?: string;
+    readonly subscriptionFile?: string;
+    readonly subscriptionUrl?: string;
+    readonly singBoxBinary?: string;
+    readonly chromeBinary?: string;
+    readonly verify?: boolean;
+    readonly reload?: boolean;
+}
+export interface UpdateResult {
+    readonly build: BuiltConfigArtifact;
+    readonly verification?: VerificationReport;
+    readonly livePath: string;
+    readonly backupPath?: string;
+}
+export declare function runUpdate(input: RunUpdateInput): Promise<UpdateResult>;

package/dist/modules/update/index.js

@@ -0,0 +1,38 @@
+import { buildConfigArtifact } from "../build/index.js";
+import { applyConfig } from "../manager/index.js";
+import { assertVerificationReportPassed, verifyConfigRoutes, } from "../verification/index.js";
+export async function runUpdate(input) {
+    const build = await buildConfigArtifact({
+        config: input.config,
+        ...(input.outputPath ? { outputPath: input.outputPath } : {}),
+        ...(input.subscriptionFile ? { subscriptionFile: input.subscriptionFile } : {}),
+        ...(input.subscriptionUrl ? { subscriptionUrl: input.subscriptionUrl } : {}),
+    });
+    let verification;
+    if (input.verify !== false) {
+        verification = await verifyConfigRoutes({
+            configPath: build.outputPath,
+            ...(input.singBoxBinary ? { singBoxBinary: input.singBoxBinary } : {}),
+            ...(input.chromeBinary ? { chromeBinary: input.chromeBinary } : {}),
+            configuredScenarios: input.config.verification.scenarios,
+        });
+        assertVerificationReportPassed(verification);
+    }
+    const livePath = input.livePath ?? input.config.output.livePath;
+    const backupPath = input.backupPath ?? input.config.output.backupPath;
+    await applyConfig({
+        stagingPath: build.outputPath,
+        livePath,
+        ...(backupPath ? { backupPath } : {}),
+        ...(input.singBoxBinary ? { singBoxBinary: input.singBoxBinary } : {}),
+        reload: input.reload ?? false,
+        runtime: input.config.runtime.reload,
+    });
+    return {
+        build,
+        ...(verification ? { verification } : {}),
+        livePath,
+        ...(backupPath ? { backupPath } : {}),
+    };
+}
+//# sourceMappingURL=index.js.map

package/dist/modules/update/index.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"index.js","sourceRoot":"","sources":["../../../src/modules/update/index.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,mBAAmB,EAAE,MAAM,mBAAmB,CAAC;AACxD,OAAO,EAAE,WAAW,EAAE,MAAM,qBAAqB,CAAC;AAClD,OAAO,EAEL,8BAA8B,EAC9B,kBAAkB,GACnB,MAAM,0BAA0B,CAAC;AAsBlC,MAAM,CAAC,KAAK,UAAU,SAAS,CAAC,KAAqB;IACnD,MAAM,KAAK,GAAG,MAAM,mBAAmB,CAAC;QACtC,MAAM,EAAE,KAAK,CAAC,MAAM;QACpB,GAAG,CAAC,KAAK,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,KAAK,CAAC,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC7D,GAAG,CAAC,KAAK,CAAC,gBAAgB,CAAC,CAAC,CAAC,EAAE,gBAAgB,EAAE,KAAK,CAAC,gBAAgB,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QAC/E,GAAG,CAAC,KAAK,CAAC,eAAe,CAAC,CAAC,CAAC,EAAE,eAAe,EAAE,KAAK,CAAC,eAAe,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KAC7E,CAAC,CAAC;IAEH,IAAI,YAA4C,CAAC;IACjD,IAAI,KAAK,CAAC,MAAM,KAAK,KAAK,EAAE,CAAC;QAC3B,YAAY,GAAG,MAAM,kBAAkB,CAAC;YACtC,UAAU,EAAE,KAAK,CAAC,UAAU;YAC5B,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACtE,GAAG,CAAC,KAAK,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,KAAK,CAAC,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;YACnE,mBAAmB,EAAE,KAAK,CAAC,MAAM,CAAC,YAAY,CAAC,SAAS;SACzD,CAAC,CAAC;QACH,8BAA8B,CAAC,YAAY,CAAC,CAAC;IAC/C,CAAC;IAED,MAAM,QAAQ,GAAG,KAAK,CAAC,QAAQ,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,QAAQ,CAAC;IAChE,MAAM,UAAU,GAAG,KAAK,CAAC,UAAU,IAAI,KAAK,CAAC,MAAM,CAAC,MAAM,CAAC,UAAU,CAAC;IAEtE,MAAM,WAAW,CAAC;QAChB,WAAW,EAAE,KAAK,CAAC,UAAU;QAC7B,QAAQ;QACR,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACrC,GAAG,CAAC,KAAK,CAAC,aAAa,CAAC,CAAC,CAAC,EAAE,aAAa,EAAE,KAAK,CAAC,aAAa,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACtE,MAAM,EAAE,KAAK,CAAC,MAAM,IAAI,KAAK;QAC7B,OAAO,EAAE,KAAK,CAAC,MAAM,CAAC,OAAO,CAAC,MAAM;KACrC,CAAC,CAAC;IAEH,OAAO;QACL,KAAK;QACL,GAAG,CAAC,YAAY,CAAC,CAAC,CAAC,EAAE,YAAY,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;QACzC,QAAQ;QACR,GAAG,CAAC,UAAU,CAAC,CAAC,CAAC,EAAE,UAAU,EAAE,CAAC,CAAC,CAAC,EAAE,CAAC;KACtC,CAAC;AACJ,CAAC"}

package/dist/modules/user-rules/index.d.ts

@@ -0,0 +1,18 @@
+export interface UserRouteRule {
+    readonly name?: string;
+    readonly inbound?: readonly string[];
+    readonly protocol?: string;
+    readonly network?: "tcp" | "udp";
+    readonly port?: number;
+    readonly domain?: readonly string[];
+    readonly domainSuffix?: readonly string[];
+    readonly ruleSet?: readonly string[];
+    readonly route?: string;
+    readonly action?: "reject";
+}
+export interface LoadedUserRules {
+    readonly beforeBuiltins: readonly UserRouteRule[];
+    readonly afterBuiltins: readonly UserRouteRule[];
+    readonly warnings: readonly string[];
+}
+export declare function loadUserRules(filePath: string): Promise<LoadedUserRules>;