my-singbox 0.0.0-stage → 2.0.0

package/dist/core/env.d.ts

@@ -0,0 +1,39 @@
+export declare const ENV_KEYS: readonly ['SING_BOX_VERSION', 'VLESS_UUID', 'REALITY_PRIVATE_KEY', 'REALITY_PUBLIC_KEY', 'REALITY_SHORT_ID', 'SS_PASSWORD', 'SERVER_ADDRESS', 'ISP_SOCKS_ADDR', 'ISP_SOCKS_USER', 'ISP_SOCKS_PASS', 'ISP_SOCKS_EGRESS_IP'];
+export type EnvKey = (typeof ENV_KEYS)[number];
+export interface Env {
+    values: Partial<Record<EnvKey, string>>;
+    keys: Set<EnvKey>;
+}
+export declare class EnvError extends Error {
+    name: string;
+}
+export declare class FileExistsError extends Error {
+    name: string;
+    constructor();
+}
+export declare function envQuote(v: string): string;
+export declare function envUnquote(raw: string): string | null;
+export declare function parseEnv(text: string, label?: string): Env;
+export declare function loadEnvFile(path: string): Env;
+export declare const ENV_HEADER = "# ISP outbound (managed by scripts/isp-outbound.sh)";
+export declare const ENV_HEADER_NOEOL: string;
+export declare function envWithoutIsp(text: string): string;
+export declare function envWithIsp(text: string, isp: {
+    addr: string;
+    user: string;
+    pass: string;
+    egressIp: string;
+}): string;
+export declare function renderGeneratedEnv(v: {
+    singBoxVersion: string;
+    vlessUuid: string;
+    realityPrivateKey: string;
+    realityPublicKey: string;
+    realityShortId: string;
+    ssPassword: string;
+    serverAddress: string;
+}): string;
+export declare function writeFileAtomic(path: string, data: string | Uint8Array, options?: {
+    exclusive?: boolean;
+}): void;
+export declare function writeEnvFile(path: string, text: string): void;

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

@@ -0,0 +1,33 @@
+import type { IspSocks } from '../model.js';
+export interface IspServiceIO {
+    projectDir: string;
+    env?: NodeJS.ProcessEnv;
+    sleep?(ms: number): Promise<void>;
+    stdout(text: string): void;
+    stderr(text: string): void;
+    signal?: AbortSignal;
+}
+export type DockerInfo = 'ok' | 'permission-denied' | 'down';
+export type ListenerStatus = boolean | 'unknown';
+/** External commands use this run's environment, including its PATH. */
+export declare class IspService {
+    private readonly io;
+    constructor(io: IspServiceIO);
+    private warn;
+    private command;
+    private compose;
+    private pause;
+    dockerInfo(): Promise<DockerInfo>;
+    composeAvailable(): Promise<boolean>;
+    containerImage(): Promise<string>;
+    containerStatus(): Promise<string>;
+    recreate(): Promise<boolean>;
+    composeExecCheck(): Promise<boolean>;
+    showLogs(): Promise<void>;
+    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>;
+    socksEgressIp(isp: IspSocks): Promise<string | undefined>;
+}

package/dist/core/isp.d.ts

@@ -0,0 +1,21 @@
+import { type IspSocks } from '../model.js';
+import type { SingboxConfig } from './render-config.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 class IspError extends Error {
+    name: string;
+}
+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 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 sweepStaleTmp(projectDir: string): void;
+export declare function withLock<T>(projectDir: string, fn: () => Promise<T>): Promise<T>;

package/dist/core/keys.d.ts

@@ -0,0 +1,20 @@
+export interface KeyDeps {
+    runSingbox(args: string[]): Promise<string>;
+    randomUuid(): string;
+    randomShortId(): string;
+}
+export declare function generateKeys(deps: KeyDeps): Promise<{
+    vlessUuid: string;
+    realityPrivateKey: string;
+    realityPublicKey: string;
+    realityShortId: string;
+    ssPassword: string;
+}>;
+export type DockerRun = (file: string, args: string[]) => Promise<string>;
+export declare function defaultKeyDeps(image: string): KeyDeps;
+export declare function dockerAvailable(run?: DockerRun): Promise<boolean>;
+export declare function dockerDaemonUp(run?: DockerRun): Promise<boolean>;
+export interface PublicIpDeps {
+    httpGet(url: string, family: 4 | 6): Promise<string>;
+}
+export declare function detectPublicIp(deps?: PublicIpDeps): Promise<string | null>;

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

@@ -0,0 +1,2 @@
+import type { Model } from '../model.js';
+export declare function renderClash(model: Model, templateText: string): string;

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

@@ -0,0 +1,13 @@
+import type { Model } from '../model.js';
+export interface SingboxConfig {
+    inbounds: Record<string, unknown>[];
+    outbounds?: Record<string, unknown>[];
+    route?: {
+        rules?: unknown[];
+        [key: string]: unknown;
+    };
+    [key: string]: unknown;
+}
+export declare function renderSingbox(model: Model, template: unknown): SingboxConfig;
+export declare function serializeSingbox(config: SingboxConfig): string;
+export declare function loadSingboxTemplate(projectDir?: string): unknown;

package/dist/core/start.d.ts

@@ -0,0 +1,23 @@
+export declare function parseListenPorts(configText: string): number[];
+export declare function secretValues(envText: string): string[];
+export declare function redact(text: string, secrets: string[]): string;
+export declare function composeImageTag(text: string): string;
+export declare function firewallPorts(configText: string): string[];
+export interface StartDeps {
+    run(file: string, args: string[]): Promise<{
+        code: number;
+        stdout: string;
+        stderr: string;
+    }>;
+    tcpOpen(port: number): Promise<boolean>;
+    sleep(ms: number): Promise<void>;
+}
+export declare function realStartDeps(): StartDeps;
+export declare function startNode(opts: {
+    project: string;
+    deps: StartDeps;
+    dockerAvailable(): Promise<boolean>;
+    dockerDaemonUp(): Promise<boolean>;
+    stdout(t: string): void;
+    stderr(t: string): void;
+}): Promise<void>;

package/dist/core/templates.d.ts

@@ -0,0 +1,3 @@
+export declare function findTemplate(name: string, projectDir?: string): string;
+export declare function findPackageFile(name: string): string;
+export declare function readTemplate(name: string, projectDir?: string): string;

package/dist/core/validate.d.ts

@@ -0,0 +1,17 @@
+export declare const UUID_RE: RegExp;
+export declare const PRIVATE_KEY_RE: RegExp;
+export declare const PUBLIC_KEY_RE: RegExp;
+export declare const SHORT_ID_RE: RegExp;
+export declare const SS_PASSWORD_RE: RegExp;
+export declare function isIpv4(s: string): boolean;
+export declare function isIpv6(s: string): boolean;
+export declare function isIpv6Strict(s: string): boolean;
+export declare function isHostname(s: string): boolean;
+export declare function isValidServerAddress(s: string): boolean;
+export declare function isPublicIp(s: string): boolean;
+export declare function parseIspAddr(value: string): {
+    host: string;
+    port: number;
+    addr: string;
+} | null;
+export declare function validCred(value: string): boolean;

package/dist/doctor/checks.d.ts

@@ -0,0 +1,14 @@
+import type { System } from './system.js';
+export type Status = 'OK' | 'WARN' | 'FAIL';
+export interface Check {
+    name: string;
+    status: Status;
+    message: string;
+}
+export declare function checkNode(s: System): Check;
+export declare function checkPlatform(s: System): Check;
+export declare function checkArch(s: System): Check;
+export declare function checkCompose(s: System): Promise<Check>;
+export declare function checkSocket(s: System): Check;
+export declare function dockerAccessGuidance(s: System): Promise<string>;
+export declare function runDoctor(s: System, write: (text: string) => void): Promise<number>;

package/dist/doctor/system.d.ts

@@ -0,0 +1,10 @@
+export interface System {
+    nodeVersion: string;
+    platform: string;
+    arch: string;
+    glibcVersionRuntime?: string;
+    exec(file: string, args: string[]): Promise<string>;
+    socketAccessible(): boolean;
+    username(): string;
+}
+export declare function realSystem(): System;

package/dist/index.d.ts

@@ -0,0 +1,12 @@
+export * from './doctor/checks.js';
+export { type System } from './doctor/system.js';
+export * from './core/validate.js';
+export * from './core/env.js';
+export * from './core/keys.js';
+export * from './model.js';
+export * from './core/templates.js';
+export * from './core/render-config.js';
+export * from './core/render-clash.js';
+export * from './core/isp-service.js';
+export * from './core/isp.js';
+export * from './core/start.js';