my-singbox 2.0.0-next.0 → 3.0.0

package/dist/core/isp-service.d.ts

@@ -27,7 +27,6 @@ export declare class IspService {
     checkCandidate(image: string, candidatePath: string): Promise<boolean>;
     portListening(proto: 'tcp' | 'udp', port: number): Promise<ListenerStatus>;
     waitListening(proto: 'tcp' | 'udp', port: number): Promise<boolean>;
-    portsFree(): Promise<void>;
-    verifyService(expectIsp: boolean): Promise<boolean>;
+    verifyService(): Promise<boolean>;
     socksEgressIp(isp: IspSocks): Promise<string | undefined>;
 }

package/dist/core/isp.d.ts

@@ -1,7 +1,9 @@
 import { type IspSocks } from '../model.js';
 import type { SingboxConfig } from './render-config.js';
+import { type RoutePolicy } from './routing.js';
 export declare const ISP_BACKUP_DIR = ".isp-backup", ISP_LOCK_FILE = ".isp.lock", ISP_TMP_PREFIX = ".isp-tmp.", GROUP_MAIN = "Proxy";
-export declare const MANAGED_FILES: readonly ['config.json', 'clash.yaml', '.env'];
+export declare const MANAGED_FILES: readonly ['config.json', '.env'];
+export type ManagedFile = typeof MANAGED_FILES[number] | 'clash.yaml';
 export declare class IspError extends Error {
     name: string;
 }
@@ -9,13 +11,11 @@ export declare function envGet(text: string, key: string): string | undefined;
 export declare function envHasIsp(text: string): boolean;
 export declare function checkIspConfig(config: unknown): asserts config is SingboxConfig;
 export declare function configHasIsp(config: SingboxConfig): boolean;
-export declare function addIspToConfig(config: SingboxConfig, isp: IspSocks): SingboxConfig;
-export declare function clashHasIsp(text: string): boolean;
-export declare function addIspToClash(text: string, realityPrivateKey?: string): string;
+export declare function addIspToConfig(config: SingboxConfig, isp: IspSocks, routeDefaults?: RoutePolicy): SingboxConfig;
+export declare function removeIspFromConfig(config: SingboxConfig): SingboxConfig;
 export declare function makeTmpPath(projectDir: string): string;
 export declare function installFile(dest: string, data: string | Uint8Array, projectDir: string): void;
-export declare function makeBackup(projectDir: string): string;
-export declare function findCleanBackup(projectDir: string): string | undefined;
-export declare function restoreBackup(projectDir: string, backupDir: string): void;
+export declare function makeBackup(projectDir: string, files?: readonly ManagedFile[]): string;
+export declare function restoreBackup(projectDir: string, backupDir: string, files?: readonly ManagedFile[]): void;
 export declare function sweepStaleTmp(projectDir: string): void;
 export declare function withLock<T>(projectDir: string, fn: () => Promise<T>): Promise<T>;

package/dist/core/render-config.d.ts

@@ -10,4 +10,4 @@ export interface SingboxConfig {
 }
 export declare function renderSingbox(model: Model, template: unknown): SingboxConfig;
 export declare function serializeSingbox(config: SingboxConfig): string;
-export declare function loadSingboxTemplate(projectDir?: string): unknown;
+export declare function loadSingboxTemplate(projectDir?: string): SingboxConfig;

package/dist/core/routing.d.ts

@@ -0,0 +1,13 @@
+import { type IspSocks } from '../model.js';
+import type { SingboxConfig } from './render-config.js';
+export type RoutePolicy = NonNullable<SingboxConfig['route']>;
+export declare function isRecord(value: unknown): value is Record<string, unknown>;
+export declare function isIspRule(value: unknown): value is Record<string, unknown>;
+/** The old generated rule selected only the dedicated ISP listener tags. */
+export declare function isLegacyIspRule(value: unknown): boolean;
+/** Fail rather than silently changing references outside optional top-level rules. */
+export declare function checkNoIspReferences(config: SingboxConfig): void;
+export declare function upsertIspOutbound(config: SingboxConfig, isp: IspSocks): void;
+/** Mutates only the optional outbound and top-level rules targeting it. */
+export declare function omitIsp(config: SingboxConfig): void;
+export declare function ensureRoute(config: SingboxConfig, defaults?: RoutePolicy): void;