@jingyi0605/codingns 0.2.5 → 0.3.0

package/dist/server/modules/skills/skill-reconciler.js

@@ -0,0 +1,99 @@
+export class SkillReconciler {
+    reconcile(input) {
+        const managed = [];
+        const unmanaged = [];
+        const conflicted = [];
+        const diagnostics = [...(input.diagnostics ?? [])];
+        const managedSkillById = new Map(input.managedSkills.map((record) => [record.id, record]));
+        const managedSkillByDirectoryName = new Map(input.managedSkills.map((record) => [record.directoryName, record]));
+        const targetRootByCli = new Map(input.targetLocations.map((location) => [location.targetCli, location.rootDir]));
+        const actualDirectoryKeys = new Set();
+        for (const directory of input.directories) {
+            const managedSkill = managedSkillByDirectoryName.get(directory.directoryName);
+            const managementState = resolveManagementState(directory, managedSkill);
+            const entry = createSkillScanEntry(directory, managedSkill, managementState);
+            actualDirectoryKeys.add(createDirectoryKey(directory.targetCli, directory.directoryName));
+            if (managementState === "managed") {
+                managed.push(entry);
+                continue;
+            }
+            if (managementState === "conflicted") {
+                conflicted.push(entry);
+                continue;
+            }
+            unmanaged.push(entry);
+        }
+        for (const binding of input.bindings) {
+            if (!binding.enabled) {
+                continue;
+            }
+            const managedSkill = managedSkillById.get(binding.skillId);
+            if (!managedSkill) {
+                continue;
+            }
+            const directoryKey = createDirectoryKey(binding.targetCli, managedSkill.directoryName);
+            if (actualDirectoryKeys.has(directoryKey)) {
+                continue;
+            }
+            diagnostics.push({
+                targetCli: binding.targetCli,
+                rootDir: targetRootByCli.get(binding.targetCli) ?? "",
+                code: "SKILL_TARGET_SKILL_MISSING",
+                detail: `目标 CLI 缺少受管 skill：${managedSkill.directoryName}`,
+                directoryName: managedSkill.directoryName,
+                directoryPath: null,
+                managedSkillId: managedSkill.id
+            });
+        }
+        return {
+            managed: sortSkillScanEntries(managed),
+            unmanaged: sortSkillScanEntries(unmanaged),
+            conflicted: sortSkillScanEntries(conflicted),
+            diagnostics: sortSkillScanDiagnostics(diagnostics),
+            scannedAt: input.scannedAt
+        };
+    }
+}
+function resolveManagementState(directory, managedSkill) {
+    if (!managedSkill) {
+        return "unmanaged";
+    }
+    return managedSkill.contentHash === directory.contentHash ? "managed" : "conflicted";
+}
+function createSkillScanEntry(directory, managedSkill, managementState) {
+    return {
+        targetCli: directory.targetCli,
+        directoryPath: directory.directoryPath,
+        directoryName: directory.directoryName,
+        name: directory.name,
+        contentHash: directory.contentHash,
+        managementState,
+        managedSkillId: managedSkill?.id ?? null
+    };
+}
+function createDirectoryKey(targetCli, directoryName) {
+    return `${targetCli}:${directoryName}`;
+}
+function sortSkillScanEntries(entries) {
+    return entries.sort((left, right) => {
+        const targetOrder = left.targetCli.localeCompare(right.targetCli);
+        if (targetOrder !== 0) {
+            return targetOrder;
+        }
+        return left.directoryName.localeCompare(right.directoryName);
+    });
+}
+function sortSkillScanDiagnostics(diagnostics) {
+    return diagnostics.sort((left, right) => {
+        const targetOrder = left.targetCli.localeCompare(right.targetCli);
+        if (targetOrder !== 0) {
+            return targetOrder;
+        }
+        const codeOrder = left.code.localeCompare(right.code);
+        if (codeOrder !== 0) {
+            return codeOrder;
+        }
+        return (left.directoryName ?? "").localeCompare(right.directoryName ?? "");
+    });
+}
+//# sourceMappingURL=skill-reconciler.js.map

package/dist/server/modules/skills/skill-reconciler.js.map

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

package/dist/server/modules/skills/skill-sync-planner.d.ts

@@ -0,0 +1,8 @@
+import type { SkillTargetBindingRecord, SkillTargetCli } from "../../types/domain.js";
+export interface PlannedSkillSyncTarget {
+    targetCli: SkillTargetCli;
+    existingBinding: SkillTargetBindingRecord | null;
+}
+export declare class SkillSyncPlanner {
+    planRequestedTargets(requestedTargetCli: readonly SkillTargetCli[], existingBindings?: readonly SkillTargetBindingRecord[]): PlannedSkillSyncTarget[];
+}

package/dist/server/modules/skills/skill-sync-planner.js

@@ -0,0 +1,20 @@
+import { AppError } from "../../shared/errors/app-error.js";
+export class SkillSyncPlanner {
+    planRequestedTargets(requestedTargetCli, existingBindings = []) {
+        const normalizedTargetCli = Array.from(new Set(requestedTargetCli));
+        if (normalizedTargetCli.length === 0) {
+            throw new AppError({
+                statusCode: 400,
+                errorCode: "INVALID_INPUT",
+                detail: "至少要指定一个目标 CLI",
+                field: "targetCli"
+            });
+        }
+        const bindingByTarget = new Map(existingBindings.map((binding) => [binding.targetCli, binding]));
+        return normalizedTargetCli.map((targetCli) => ({
+            targetCli,
+            existingBinding: bindingByTarget.get(targetCli) ?? null
+        }));
+    }
+}
+//# sourceMappingURL=skill-sync-planner.js.map

package/dist/server/modules/skills/skill-sync-planner.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-sync-planner.js","sourceRoot":"","sources":["../../../../src/modules/skills/skill-sync-planner.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,QAAQ,EAAE,MAAM,kCAAkC,CAAC;AAQ5D,MAAM,OAAO,gBAAgB;IAC3B,oBAAoB,CAClB,kBAA6C,EAC7C,mBAAwD,EAAE;QAE1D,MAAM,mBAAmB,GAAG,KAAK,CAAC,IAAI,CAAC,IAAI,GAAG,CAAC,kBAAkB,CAAC,CAAC,CAAC;QAEpE,IAAI,mBAAmB,CAAC,MAAM,KAAK,CAAC,EAAE,CAAC;YACrC,MAAM,IAAI,QAAQ,CAAC;gBACjB,UAAU,EAAE,GAAG;gBACf,SAAS,EAAE,eAAe;gBAC1B,MAAM,EAAE,eAAe;gBACvB,KAAK,EAAE,WAAW;aACnB,CAAC,CAAC;QACL,CAAC;QAED,MAAM,eAAe,GAAG,IAAI,GAAG,CAC7B,gBAAgB,CAAC,GAAG,CAAC,CAAC,OAAO,EAAE,EAAE,CAAC,CAAC,OAAO,CAAC,SAAS,EAAE,OAAO,CAAU,CAAC,CACzE,CAAC;QAEF,OAAO,mBAAmB,CAAC,GAAG,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,CAAC;YAC7C,SAAS;YACT,eAAe,EAAE,eAAe,CAAC,GAAG,CAAC,SAAS,CAAC,IAAI,IAAI;SACxD,CAAC,CAAC,CAAC;IACN,CAAC;CACF"}

package/dist/server/modules/skills/skill-target-adapter.d.ts

@@ -0,0 +1,34 @@
+import type { HostConfig } from "../../config/env.js";
+import type { SkillTargetCli } from "../../types/domain.js";
+export interface SkillTargetLocation {
+    targetCli: SkillTargetCli;
+    rootDir: string;
+}
+export interface SkillTargetAdapter {
+    readonly targetCli: SkillTargetCli;
+    resolveRootDir(): string;
+}
+export declare class ClaudeCodeSkillTargetAdapter implements SkillTargetAdapter {
+    private readonly config;
+    readonly targetCli: "claude-code";
+    constructor(config: Pick<HostConfig, "claudeCodeHomeDir">);
+    resolveRootDir(): string;
+}
+export declare class CodexSkillTargetAdapter implements SkillTargetAdapter {
+    private readonly config;
+    readonly targetCli: "codex";
+    constructor(config: Pick<HostConfig, "codexHomeDir">);
+    resolveRootDir(): string;
+}
+export declare class GeminiSkillTargetAdapter implements SkillTargetAdapter {
+    private readonly config;
+    readonly targetCli: "gemini";
+    constructor(config: Pick<HostConfig, "geminiHomeDir">);
+    resolveRootDir(): string;
+}
+export declare class OpenCodeSkillTargetAdapter implements SkillTargetAdapter {
+    readonly targetCli: "opencode";
+    resolveRootDir(): string;
+}
+export declare function createDefaultSkillTargetAdapters(config: Pick<HostConfig, "claudeCodeHomeDir" | "codexHomeDir" | "geminiHomeDir">): SkillTargetAdapter[];
+export declare function resolveSkillTargetLocation(adapters: readonly SkillTargetAdapter[], targetCli: SkillTargetCli): SkillTargetLocation;

package/dist/server/modules/skills/skill-target-adapter.js

@@ -0,0 +1,65 @@
+import os from "node:os";
+import path from "node:path";
+export class ClaudeCodeSkillTargetAdapter {
+    config;
+    targetCli = "claude-code";
+    constructor(config) {
+        this.config = config;
+    }
+    resolveRootDir() {
+        return path.resolve(this.config.claudeCodeHomeDir, "skills");
+    }
+}
+export class CodexSkillTargetAdapter {
+    config;
+    targetCli = "codex";
+    constructor(config) {
+        this.config = config;
+    }
+    resolveRootDir() {
+        return path.resolve(this.config.codexHomeDir, "skills");
+    }
+}
+export class GeminiSkillTargetAdapter {
+    config;
+    targetCli = "gemini";
+    constructor(config) {
+        this.config = config;
+    }
+    resolveRootDir() {
+        return path.resolve(this.config.geminiHomeDir, "skills");
+    }
+}
+export class OpenCodeSkillTargetAdapter {
+    targetCli = "opencode";
+    resolveRootDir() {
+        return resolveDefaultOpenCodeSkillsDir();
+    }
+}
+export function createDefaultSkillTargetAdapters(config) {
+    return [
+        new ClaudeCodeSkillTargetAdapter(config),
+        new CodexSkillTargetAdapter(config),
+        new GeminiSkillTargetAdapter(config),
+        new OpenCodeSkillTargetAdapter()
+    ];
+}
+export function resolveSkillTargetLocation(adapters, targetCli) {
+    const adapter = adapters.find((candidate) => candidate.targetCli === targetCli);
+    if (!adapter) {
+        throw new Error("SKILL_TARGET_NOT_SUPPORTED");
+    }
+    return {
+        targetCli,
+        rootDir: adapter.resolveRootDir()
+    };
+}
+function resolveDefaultOpenCodeSkillsDir() {
+    const homeDir = os.homedir();
+    if (process.platform === "win32") {
+        const appDataDir = process.env.APPDATA?.trim();
+        return path.resolve(appDataDir || path.join(homeDir, "AppData", "Roaming"), "opencode", "skills");
+    }
+    return path.resolve(homeDir, ".config", "opencode", "skills");
+}
+//# sourceMappingURL=skill-target-adapter.js.map

package/dist/server/modules/skills/skill-target-adapter.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"skill-target-adapter.js","sourceRoot":"","sources":["../../../../src/modules/skills/skill-target-adapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,MAAM,SAAS,CAAC;AACzB,OAAO,IAAI,MAAM,WAAW,CAAC;AAe7B,MAAM,OAAO,4BAA4B;IAGV;IAFpB,SAAS,GAAG,aAAsB,CAAC;IAE5C,YAA6B,MAA6C;QAA7C,WAAM,GAAN,MAAM,CAAuC;IAAG,CAAC;IAE9E,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,iBAAiB,EAAE,QAAQ,CAAC,CAAC;IAC/D,CAAC;CACF;AAED,MAAM,OAAO,uBAAuB;IAGL;IAFpB,SAAS,GAAG,OAAgB,CAAC;IAEtC,YAA6B,MAAwC;QAAxC,WAAM,GAAN,MAAM,CAAkC;IAAG,CAAC;IAEzE,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,YAAY,EAAE,QAAQ,CAAC,CAAC;IAC1D,CAAC;CACF;AAED,MAAM,OAAO,wBAAwB;IAGN;IAFpB,SAAS,GAAG,QAAiB,CAAC;IAEvC,YAA6B,MAAyC;QAAzC,WAAM,GAAN,MAAM,CAAmC;IAAG,CAAC;IAE1E,cAAc;QACZ,OAAO,IAAI,CAAC,OAAO,CAAC,IAAI,CAAC,MAAM,CAAC,aAAa,EAAE,QAAQ,CAAC,CAAC;IAC3D,CAAC;CACF;AAED,MAAM,OAAO,0BAA0B;IAC5B,SAAS,GAAG,UAAmB,CAAC;IAEzC,cAAc;QACZ,OAAO,+BAA+B,EAAE,CAAC;IAC3C,CAAC;CACF;AAED,MAAM,UAAU,gCAAgC,CAC9C,MAAgF;IAEhF,OAAO;QACL,IAAI,4BAA4B,CAAC,MAAM,CAAC;QACxC,IAAI,uBAAuB,CAAC,MAAM,CAAC;QACnC,IAAI,wBAAwB,CAAC,MAAM,CAAC;QACpC,IAAI,0BAA0B,EAAE;KACjC,CAAC;AACJ,CAAC;AAED,MAAM,UAAU,0BAA0B,CACxC,QAAuC,EACvC,SAAyB;IAEzB,MAAM,OAAO,GAAG,QAAQ,CAAC,IAAI,CAAC,CAAC,SAAS,EAAE,EAAE,CAAC,SAAS,CAAC,SAAS,KAAK,SAAS,CAAC,CAAC;IAEhF,IAAI,CAAC,OAAO,EAAE,CAAC;QACb,MAAM,IAAI,KAAK,CAAC,4BAA4B,CAAC,CAAC;IAChD,CAAC;IAED,OAAO;QACL,SAAS;QACT,OAAO,EAAE,OAAO,CAAC,cAAc,EAAE;KAClC,CAAC;AACJ,CAAC;AAED,SAAS,+BAA+B;IACtC,MAAM,OAAO,GAAG,EAAE,CAAC,OAAO,EAAE,CAAC;IAE7B,IAAI,OAAO,CAAC,QAAQ,KAAK,OAAO,EAAE,CAAC;QACjC,MAAM,UAAU,GAAG,OAAO,CAAC,GAAG,CAAC,OAAO,EAAE,IAAI,EAAE,CAAC;QAE/C,OAAO,IAAI,CAAC,OAAO,CAAC,UAAU,IAAI,IAAI,CAAC,IAAI,CAAC,OAAO,EAAE,SAAS,EAAE,SAAS,CAAC,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;IACpG,CAAC;IAED,OAAO,IAAI,CAAC,OAAO,CAAC,OAAO,EAAE,SAAS,EAAE,UAAU,EAAE,QAAQ,CAAC,CAAC;AAChE,CAAC"}

package/dist/server/modules/tailscale/tailscale-controller.d.ts

@@ -0,0 +1,15 @@
+import type { FastifyReply, FastifyRequest } from "fastify";
+import type { TailscaleConfigUpdateInput } from "./tailscale-service.js";
+import { TailscaleService } from "./tailscale-service.js";
+export declare class TailscaleController {
+    private readonly tailscaleService;
+    constructor(tailscaleService: TailscaleService);
+    readonly getStatus: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly updateConfig: (request: FastifyRequest<{
+        Body: TailscaleConfigUpdateInput;
+    }>, reply: FastifyReply) => Promise<void>;
+    readonly enable: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly disable: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly login: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+    readonly logout: (request: FastifyRequest, reply: FastifyReply) => Promise<void>;
+}

package/dist/server/modules/tailscale/tailscale-controller.js

@@ -0,0 +1,33 @@
+import { requireUserId } from "../preferences/common.js";
+export class TailscaleController {
+    tailscaleService;
+    constructor(tailscaleService) {
+        this.tailscaleService = tailscaleService;
+    }
+    getStatus = async (request, reply) => {
+        // 这里显式要求登录态，避免未来系统路由被复用时绕过受保护边界。
+        requireUserId(request);
+        reply.send(await this.tailscaleService.getStatus());
+    };
+    updateConfig = async (request, reply) => {
+        requireUserId(request);
+        reply.send(await this.tailscaleService.updateConfig(request.body ?? {}));
+    };
+    enable = async (request, reply) => {
+        requireUserId(request);
+        reply.send(await this.tailscaleService.enable());
+    };
+    disable = async (request, reply) => {
+        requireUserId(request);
+        reply.send(await this.tailscaleService.disable());
+    };
+    login = async (request, reply) => {
+        requireUserId(request);
+        reply.send(await this.tailscaleService.login());
+    };
+    logout = async (request, reply) => {
+        requireUserId(request);
+        reply.send(await this.tailscaleService.logout());
+    };
+}
+//# sourceMappingURL=tailscale-controller.js.map

package/dist/server/modules/tailscale/tailscale-controller.js.map

@@ -0,0 +1 @@
+{"version":3,"file":"tailscale-controller.js","sourceRoot":"","sources":["../../../../src/modules/tailscale/tailscale-controller.ts"],"names":[],"mappings":"AAEA,OAAO,EAAE,aAAa,EAAE,MAAM,0BAA0B,CAAC;AAIzD,MAAM,OAAO,mBAAmB;IACD;IAA7B,YAA6B,gBAAkC;QAAlC,qBAAgB,GAAhB,gBAAgB,CAAkB;IAAG,CAAC;IAE1D,SAAS,GAAG,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAiB,EAAE;QACzF,iCAAiC;QACjC,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,SAAS,EAAE,CAAC,CAAC;IACtD,CAAC,CAAC;IAEO,YAAY,GAAG,KAAK,EAC3B,OAA6D,EAC7D,KAAmB,EACJ,EAAE;QACjB,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,YAAY,CAAC,OAAO,CAAC,IAAI,IAAI,EAAE,CAAC,CAAC,CAAC;IAC3E,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAiB,EAAE;QACtF,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC;IAEO,OAAO,GAAG,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAiB,EAAE;QACvF,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,OAAO,EAAE,CAAC,CAAC;IACpD,CAAC,CAAC;IAEO,KAAK,GAAG,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAiB,EAAE;QACrF,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,KAAK,EAAE,CAAC,CAAC;IAClD,CAAC,CAAC;IAEO,MAAM,GAAG,KAAK,EAAE,OAAuB,EAAE,KAAmB,EAAiB,EAAE;QACtF,aAAa,CAAC,OAAO,CAAC,CAAC;QACvB,KAAK,CAAC,IAAI,CAAC,MAAM,IAAI,CAAC,gBAAgB,CAAC,MAAM,EAAE,CAAC,CAAC;IACnD,CAAC,CAAC;CACH"}

package/dist/server/modules/tailscale/tailscale-helper-client.d.ts

@@ -0,0 +1,41 @@
+export type TailscaleHelperBackendState = "running" | "needs_login" | "starting" | "stopped" | "error";
+export interface TailscaleHelperSnapshot {
+    backendState: TailscaleHelperBackendState;
+    loginUrl: string | null;
+    hostname: string | null;
+    accountName: string | null;
+    tailnetFqdn: string | null;
+    tailnetIpv4: string | null;
+    tailnetIpv6: string | null;
+    lastError: string | null;
+}
+export declare class TailscaleHelperClient {
+    private readonly child;
+    private readonly stdoutReader;
+    private readonly pendingRequests;
+    private nextRequestId;
+    constructor();
+    inspectStatus(input: {
+        commandPath: string;
+    }): Promise<TailscaleHelperSnapshot>;
+    enable(input: {
+        commandPath: string;
+        controlServerUrl: string | null;
+        hostname: string | null;
+    }): Promise<TailscaleHelperSnapshot>;
+    login(input: {
+        commandPath: string;
+        controlServerUrl: string | null;
+        hostname: string | null;
+    }): Promise<TailscaleHelperSnapshot>;
+    disable(input: {
+        commandPath: string;
+    }): Promise<TailscaleHelperSnapshot>;
+    logout(input: {
+        commandPath: string;
+    }): Promise<TailscaleHelperSnapshot>;
+    dispose(): void;
+    private sendRequest;
+    private handleResponseLine;
+    private rejectAll;
+}

package/dist/server/modules/tailscale/tailscale-helper-client.js

@@ -0,0 +1,135 @@
+import { spawn } from "node:child_process";
+import path from "node:path";
+import readline from "node:readline";
+import { fileURLToPath } from "node:url";
+export class TailscaleHelperClient {
+    child;
+    stdoutReader;
+    pendingRequests = new Map();
+    nextRequestId = 1;
+    constructor() {
+        const launch = resolveHelperLaunch();
+        this.child = spawn(launch.command, launch.args, {
+            cwd: process.cwd(),
+            env: process.env,
+            stdio: ["pipe", "pipe", "pipe"]
+        });
+        this.stdoutReader = readline.createInterface({
+            input: this.child.stdout
+        });
+        this.stdoutReader.on("line", (line) => {
+            this.handleResponseLine(line);
+        });
+        this.child.stderr.on("data", (chunk) => {
+            const content = String(chunk).trim();
+            if (content) {
+                console.warn(`[tailscale-helper] ${content}`);
+            }
+        });
+        this.child.on("error", (error) => {
+            this.rejectAll(error);
+        });
+        this.child.on("exit", (code, signal) => {
+            this.rejectAll(new Error(`tailscale helper 已退出：code=${code ?? "null"} signal=${signal ?? "null"}`));
+        });
+    }
+    async inspectStatus(input) {
+        return await this.sendRequest({
+            type: "status",
+            ...input
+        });
+    }
+    async enable(input) {
+        return await this.sendRequest({
+            type: "enable",
+            ...input
+        });
+    }
+    async login(input) {
+        return await this.sendRequest({
+            type: "login",
+            ...input
+        });
+    }
+    async disable(input) {
+        return await this.sendRequest({
+            type: "disable",
+            ...input
+        });
+    }
+    async logout(input) {
+        return await this.sendRequest({
+            type: "logout",
+            ...input
+        });
+    }
+    dispose() {
+        this.stdoutReader.close();
+        if (!this.child.killed) {
+            this.child.kill("SIGTERM");
+        }
+    }
+    async sendRequest(payload) {
+        const id = String(this.nextRequestId++);
+        return await new Promise((resolve, reject) => {
+            this.pendingRequests.set(id, {
+                resolve: (value) => {
+                    resolve(value);
+                },
+                reject
+            });
+            this.child.stdin.write(`${JSON.stringify({ id, ...payload })}\n`, (error) => {
+                if (!error) {
+                    return;
+                }
+                this.pendingRequests.delete(id);
+                reject(error);
+            });
+        });
+    }
+    handleResponseLine(line) {
+        const trimmed = line.trim();
+        if (!trimmed.startsWith("{")) {
+            return;
+        }
+        let payload;
+        try {
+            payload = JSON.parse(trimmed);
+        }
+        catch {
+            return;
+        }
+        const pending = this.pendingRequests.get(payload.id);
+        if (!pending) {
+            return;
+        }
+        this.pendingRequests.delete(payload.id);
+        if (payload.ok) {
+            pending.resolve(payload.result);
+            return;
+        }
+        pending.reject(new Error(payload.error));
+    }
+    rejectAll(error) {
+        for (const pending of this.pendingRequests.values()) {
+            pending.reject(error);
+        }
+        this.pendingRequests.clear();
+    }
+}
+function resolveHelperLaunch() {
+    const currentFilePath = fileURLToPath(import.meta.url);
+    const extension = path.extname(currentFilePath);
+    const helperPath = currentFilePath.replace(/tailscale-helper-client\.(ts|js)$/, `tailscale-helper-process${extension}`);
+    if (extension === ".ts") {
+        return {
+            command: process.execPath,
+            args: ["--import", "tsx", helperPath]
+        };
+    }
+    return {
+        command: process.execPath,
+        args: [helperPath]
+    };
+}
+//# sourceMappingURL=tailscale-helper-client.js.map

package/dist/server/modules/tailscale/tailscale-helper-client.js.map

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

package/dist/server/modules/tailscale/tailscale-helper-process.d.ts

@@ -0,0 +1 @@
+export {};