tailii-host 0.1.0 → 0.3.0

package/dist/services/previewServer.js

@@ -0,0 +1,233 @@
+// previewServer.ts
+// tailii (TS host) — Web プレビュー用の loopback 静的ファイルサーバー。
+//
+// iOS の Web プレビューは既存 SSH 接続内の direct-tcpip トンネルで Mac の
+// 127.0.0.1 へ到達する。dev サーバーはそのままトンネルで開けるが、
+// ディスク上の HTML ファイルには配信元が必要なため、このサーバーが
+// 「対象ファイルのディレクトリ」を root として loopback のみで配信する。
+// ネットワークへは一切公開しない（bind は 127.0.0.1 固定）。
+// URL には 128bit ランダムトークンのパス接頭辞を必須にする。
+import { randomBytes } from "node:crypto";
+import { createReadStream } from "node:fs";
+import { stat } from "node:fs/promises";
+import http from "node:http";
+import path from "node:path";
+/** open が失敗したときの型付きエラー。message はそのまま preview_error に載る。 */
+export class PreviewError extends Error {
+    reason;
+    constructor(reason, detail) {
+        super(`${reason}: ${detail}`);
+        this.reason = reason;
+        this.name = "PreviewError";
+    }
+}
+const MIME_TYPES = {
+    ".html": "text/html; charset=utf-8",
+    ".htm": "text/html; charset=utf-8",
+    ".css": "text/css; charset=utf-8",
+    ".js": "text/javascript; charset=utf-8",
+    ".mjs": "text/javascript; charset=utf-8",
+    ".json": "application/json; charset=utf-8",
+    ".txt": "text/plain; charset=utf-8",
+    ".svg": "image/svg+xml",
+    ".png": "image/png",
+    ".jpg": "image/jpeg",
+    ".jpeg": "image/jpeg",
+    ".gif": "image/gif",
+    ".webp": "image/webp",
+    ".ico": "image/x-icon",
+    ".woff": "font/woff",
+    ".woff2": "font/woff2",
+    ".ttf": "font/ttf",
+    ".otf": "font/otf",
+    ".mp4": "video/mp4",
+    ".webm": "video/webm",
+    ".mp3": "audio/mpeg",
+    ".wav": "audio/wav",
+    ".map": "application/json; charset=utf-8",
+    ".wasm": "application/wasm",
+};
+const BIND_HOST = "127.0.0.1";
+/** トークン cookie の名前接頭辞（`tailii_t_<token>=1`）。複数 site が同居しても衝突しない。 */
+const COOKIE_PREFIX = "tailii_t_";
+/**
+ * `.html/.htm` の絶対パスを受け取り、そのディレクトリを root に配信する
+ * loopback 静的サーバー群を管理する。同一ファイルの再 open はリスナーを
+ * 再利用し、`close(id)` で参照が尽きたら teardown する。
+ */
+export class PreviewServer {
+    /** normalized file path → site */
+    sites = new Map();
+    /** preview 要求 id → normalized file path */
+    idToKey = new Map();
+    /** target（.html/.htm 絶対パス）の配信を開始し、到達 URL を返す。 */
+    async open(id, target) {
+        const key = this.validateTarget(target);
+        await this.requireReadableFile(key);
+        const existing = this.sites.get(key);
+        if (existing) {
+            existing.ids.add(id);
+            this.idToKey.set(id, key);
+            return { url: existing.url };
+        }
+        const rootDir = path.dirname(key);
+        const token = randomBytes(16).toString("hex");
+        const server = http.createServer((req, res) => {
+            void this.handleRequest(rootDir, token, req, res);
+        });
+        const sockets = new Set();
+        server.on("connection", (socket) => {
+            sockets.add(socket);
+            socket.on("close", () => sockets.delete(socket));
+        });
+        const port = await new Promise((resolve, reject) => {
+            server.once("error", reject);
+            server.listen(0, BIND_HOST, () => {
+                const address = server.address();
+                if (address === null || typeof address === "string") {
+                    reject(new Error("listen address unavailable"));
+                    return;
+                }
+                resolve(address.port);
+            });
+        });
+        const url = `http://${BIND_HOST}:${port}/t/${token}/${encodeURIComponent(path.basename(key))}`;
+        const site = { server, url, ids: new Set([id]), sockets };
+        this.sites.set(key, site);
+        this.idToKey.set(id, key);
+        return { url };
+    }
+    /** id の参照を外し、最後の参照ならサーバーを畳む。未知 id は no-op。 */
+    async close(id) {
+        const key = this.idToKey.get(id);
+        if (key === undefined)
+            return;
+        this.idToKey.delete(id);
+        const site = this.sites.get(key);
+        if (site === undefined)
+            return;
+        site.ids.delete(id);
+        if (site.ids.size > 0)
+            return;
+        this.sites.delete(key);
+        await PreviewServer.shutdown(site);
+    }
+    /** 全サーバーを畳む（engine 終了時）。冪等。 */
+    async closeAll() {
+        const sites = [...this.sites.values()];
+        this.sites.clear();
+        this.idToKey.clear();
+        await Promise.all(sites.map((site) => PreviewServer.shutdown(site)));
+    }
+    validateTarget(target) {
+        const normalized = path.normalize(target);
+        if (!path.isAbsolute(normalized)) {
+            throw new PreviewError("invalid-target", `絶対パスではない: ${target}`);
+        }
+        const ext = path.extname(normalized).toLowerCase();
+        if (ext !== ".html" && ext !== ".htm") {
+            throw new PreviewError("invalid-target", `.html/.htm ではない: ${target}`);
+        }
+        return normalized;
+    }
+    async requireReadableFile(filePath) {
+        try {
+            const info = await stat(filePath);
+            if (!info.isFile())
+                throw new PreviewError("not-found", filePath);
+        }
+        catch (error) {
+            if (error instanceof PreviewError)
+                throw error;
+            throw new PreviewError("not-found", filePath);
+        }
+    }
+    async handleRequest(rootDir, token, req, res) {
+        try {
+            const rawPath = (req.url ?? "/").split("?")[0] ?? "/";
+            const prefix = `/t/${token}/`;
+            if (rawPath.startsWith(prefix)) {
+                // トークン付きパス: HTML のディレクトリ配下を配信する（相対参照の解決）。
+                let decodedRel;
+                try {
+                    decodedRel = decodeURIComponent(rawPath.slice(prefix.length));
+                }
+                catch {
+                    res.writeHead(400).end();
+                    return;
+                }
+                const resolved = path.resolve(rootDir, decodedRel);
+                if (resolved !== rootDir && !resolved.startsWith(rootDir + path.sep)) {
+                    res.writeHead(403).end();
+                    return;
+                }
+                // トークンを cookie にも載せる。HTML 内の**絶対パス参照**（<img src="/Users/..."> 等）は
+                // トークン接頭辞を持たない URL になるため、後続要求はこの cookie で認可する。
+                await PreviewServer.serveFile(resolved, res, {
+                    "set-cookie": `${COOKIE_PREFIX}${token}=1; Path=/; SameSite=Lax`,
+                });
+                return;
+            }
+            if (PreviewServer.hasTokenCookie(req, token)) {
+                // 有効な cookie 持ちの絶対パス要求: HTML 内の絶対参照を解決する。
+                // 認可主体はトークン保持者＝SSH トンネル越しの本人のみ（cookie は最初の
+                // トークン付き応答でしか配られない）。root 制限は課さない（本人の Mac の
+                // 本人が読めるファイルであり、エージェント生成 HTML は uploads 等
+                // ディレクトリ外の絶対パスを普通に参照するため）。
+                let decoded;
+                try {
+                    decoded = decodeURIComponent(rawPath);
+                }
+                catch {
+                    res.writeHead(400).end();
+                    return;
+                }
+                const resolved = path.normalize(decoded);
+                if (!path.isAbsolute(resolved)) {
+                    res.writeHead(404).end();
+                    return;
+                }
+                await PreviewServer.serveFile(resolved, res);
+                return;
+            }
+            res.writeHead(404).end();
+        }
+        catch {
+            if (!res.headersSent)
+                res.writeHead(500);
+            res.end();
+        }
+    }
+    /** ファイル 1 件を MIME 付きで応答する（ディレクトリは index.html へフォールバック）。 */
+    static async serveFile(requestedPath, res, extraHeaders = {}) {
+        let filePath = requestedPath;
+        let info = await stat(filePath).catch(() => null);
+        if (info?.isDirectory()) {
+            filePath = path.join(filePath, "index.html");
+            info = await stat(filePath).catch(() => null);
+        }
+        if (info === null || !info.isFile()) {
+            res.writeHead(404).end();
+            return;
+        }
+        const mime = MIME_TYPES[path.extname(filePath).toLowerCase()] ?? "application/octet-stream";
+        res.writeHead(200, { "content-type": mime, "content-length": info.size, ...extraHeaders });
+        const stream = createReadStream(filePath);
+        stream.on("error", () => res.destroy());
+        stream.pipe(res);
+    }
+    static hasTokenCookie(req, token) {
+        const header = req.headers.cookie;
+        if (header === undefined)
+            return false;
+        return header
+            .split(";")
+            .some((part) => part.trim().startsWith(`${COOKIE_PREFIX}${token}=`));
+    }
+    static async shutdown(site) {
+        for (const socket of site.sockets)
+            socket.destroy();
+        await new Promise((resolve) => site.server.close(() => resolve()));
+    }
+}
+//# sourceMappingURL=previewServer.js.map

package/dist/services/previewServer.js.map

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

package/dist/services/quicGateway.d.ts

@@ -0,0 +1,143 @@
+/** launchd ジョブのラベル（plist ファイル名と対）。 */
+export declare const QUIC_GW_LAUNCHD_LABEL = "com.tailii.quic-gw";
+/** ゲートウェイの既定 UDP ポート（凍結定数、Rust 側 DEFAULT_PORT と一致）。 */
+export declare const QUIC_GW_DEFAULT_PORT = 46853;
+/** `tailii-quic-gw credentials --json` の出力。 */
+export interface QuicCredentials {
+    dir: string;
+    /** SPKI SHA-256（base64）。iOS がピン検証に使う（payload v3 の quicPin）。 */
+    spkiPin: string;
+    /** 証明書 DER SHA-256（base64）。Rust 自己検証クライアント用。 */
+    certPin: string;
+    /** 32byte トークン（base64、payload v3 の quicToken）。 */
+    token: string;
+    port: number;
+}
+/** 資格情報ディレクトリ（Rust 側 default_credentials_dir と対）。 */
+export declare function quicCredentialsDir(): string;
+/** ゲートウェイの監査ログパス（launchd が stdout/stderr をここへ向ける）。 */
+export declare function quicGatewayLogPath(): string;
+/**
+ * launchd が起動する gateway バイナリの設置先（`~/.tailii/bin/tailii-quic-gw`）。
+ *
+ * 重要（実機で判明した罠）: launchd の LaunchAgent は `~/Documents` `~/Desktop`
+ * `~/Downloads` 等の **TCC 保護フォルダにアクセスできない**。ビルド成果物や npm 配布物が
+ * そうした場所にあると、launchd 起動時に dyld がバイナリを map できず **dyld 段階で無限
+ * ストール**する（プロセスは生存するが bind に到達せず、ログも出ない）。Terminal 起動は
+ * ユーザーの TCC 付与を継承するため成功し、差分に気付きにくい。回避のため、常駐用バイナリは
+ * 必ず非 TCC 保護の隠しディレクトリ `~/.tailii/bin` へコピーしてから launchd に渡す。
+ */
+export declare function quicGatewayInstalledBinaryPath(): string;
+/**
+ * gateway バイナリを非 TCC 保護の `~/.tailii/bin` へコピーして、その設置先パスを返す。
+ * 内容が同一なら再コピーしない（mtime/サイズで判定）。常に実行ビットを立てる。
+ */
+export declare function installQuicGatewayBinary(sourcePath: string): string;
+/** LaunchAgent plist の設置先。 */
+export declare function quicLaunchAgentPlistPath(): string;
+/**
+ * ゲートウェイバイナリを解決する。見つからなければ null（QUIC は任意機能なので
+ * 呼び出し側は SSH-only で継続してよい）。
+ *
+ * 解決順:
+ *   1. 環境変数 `TAILII_QUIC_GW`（明示上書き）
+ *   2. npm prebuilt（optionalDependencies `@tailii/quic-gw-darwin-{arm64,x64}`）
+ *   3. モノレポのローカル cargo ビルド（quic-gw/target/release/tailii-quic-gw）
+ *   4. PATH
+ */
+export declare function resolveQuicGatewayBinary(env?: NodeJS.ProcessEnv): string | null;
+/** コマンド実行子（テスト注入用）。stdout を返し、失敗は reject。 */
+export type CommandRunner = (file: string, args: string[]) => Promise<string>;
+/**
+ * 資格情報を生成（既存なら読込・冪等）して返す。
+ * 実体は `tailii-quic-gw credentials --json --dir <dir>`。
+ */
+export declare function ensureQuicCredentials(gatewayPath: string, dir?: string, runner?: CommandRunner): Promise<QuicCredentials>;
+/** `quicLaunchAgentPlist` に渡す解決済み絶対パス群。 */
+export interface QuicLaunchAgentConfig {
+    gatewayPath: string;
+    logPath: string;
+    /** 資格情報ディレクトリ（絶対パス）。`--dir` に明示的に渡す。 */
+    credentialsDir: string;
+    /** exec 子プロセスへ注入する PATH（launch.ts の defaultInjectedPath と同一）。 */
+    injectedPath: string;
+    /** ユーザーの HOME 絶対パス（EnvironmentVariables に設定）。 */
+    home: string;
+}
+/**
+ * LaunchAgent plist の内容（KeepAlive 常駐・監査ログは stdout/stderr リダイレクト）。
+ *
+ * 重要（実機で判明した罠）: macOS の GUI LaunchAgent は **HOME を継承しない**。
+ * ゲートウェイは `~/.tailii/quic` の展開・`default_injected_path` の両方で HOME を読むため、
+ * HOME 空だと資格情報ディレクトリが `/.tailii/quic` に化けて `create_dir_all` が失敗し、
+ * serve が即終了 → KeepAlive 再起動ループに陥る。対策として:
+ *   1. `EnvironmentVariables` に HOME を明示（gateway 本体 + exec 子プロセス双方に効く）。
+ *   2. `--dir` / `--path` を **絶対パスで明示的に渡し**、HOME 展開へ依存しない（防御多重化）。
+ */
+export declare function quicLaunchAgentPlist(config: QuicLaunchAgentConfig): string;
+/** launchctl 実行子（テスト注入用）。exit 0 で resolve、非 0 は reject。 */
+export type LaunchctlRunner = (args: string[]) => Promise<void>;
+export interface InstallLaunchAgentOptions {
+    /** 解決済み gateway バイナリ（ビルド/配布物の場所。TCC 保護下でも可）。 */
+    gatewayPath: string;
+    plistPath?: string;
+    logPath?: string;
+    /** 資格情報ディレクトリ（絶対パス）。省略時 `quicCredentialsDir()`。 */
+    credentialsDir?: string;
+    /** exec 子プロセスの PATH。省略時 `defaultInjectedPath()`。 */
+    injectedPath?: string;
+    /** HOME 絶対パス。省略時 `os.homedir()`。 */
+    home?: string;
+    /**
+     * launchd が実際に起動するバイナリパス（`gatewayPath` からのコピー先）。
+     * 省略時 `~/.tailii/bin/tailii-quic-gw` へコピーする（TCC 回避）。テストで無効化可。
+     */
+    installBinary?: (gatewayPath: string) => string;
+    uid?: number;
+    launchctl?: LaunchctlRunner;
+}
+/**
+ * LaunchAgent を設置して（再）起動する（冪等）。
+ * 既存ジョブは bootout してから bootstrap し、plist 更新を確実に反映する。
+ *
+ * gateway バイナリは非 TCC 保護の `~/.tailii/bin` へコピーしてから launchd に渡す
+ * （`installQuicGatewayBinary` 参照。TCC 保護フォルダ由来の dyld ストール回避）。
+ */
+export declare function installQuicLaunchAgent(options: InstallLaunchAgentOptions): Promise<void>;
+/** launchd ジョブが常駐しているか（doctor / quic-info 用・副作用なし）。 */
+export declare function isQuicGatewayLoaded(uid?: number, launchctl?: LaunchctlRunner): Promise<boolean>;
+/**
+ * `tailii-host quic-info` の応答形状。iOS `QUICCredentialCache.parse` と契約整合。
+ * mosh の「SSH で鍵を配って以後 UDP」と同じ構図 — SSH（認証済み暗号路）経由で
+ * QUIC の接続情報を配布し、iOS が Keychain にキャッシュして次回以降 QUIC 先行する。
+ * これにより payload v3 の QR 再ペアリング無しで既存端末が QUIC 化できる。
+ */
+export interface QuicInfoResult {
+    available: boolean;
+    /** available=false の理由（診断用。iOS は available だけ見る）。 */
+    reason?: string;
+    port?: number;
+    pin?: string;
+    token?: string;
+}
+/**
+ * 証明書 PEM から SPKI SHA-256 ピン（base64）を計算する。
+ * Rust 側 `Credentials::spki_pin()`（rcgen public_key_der のハッシュ）と同一値になる
+ * （X.509 の SubjectPublicKeyInfo DER は同一バイト列のため）。
+ */
+export declare function computeSpkiPinFromCertPem(certPem: string): string;
+/**
+ * ディスク上の資格情報（cert.pem / token）から quic-info の中身を読む。
+ * ゲートウェイバイナリには依存しない（生成は setup / Rust 側の責務。ここは読むだけ）。
+ */
+export declare function readQuicCredentialsFromDisk(dir?: string): {
+    pin: string;
+    token: string;
+} | null;
+/** quic-info の本体（テスト注入可能な純ロジック）。 */
+export declare function collectQuicInfo(options?: {
+    dir?: string;
+    isLoaded?: () => Promise<boolean>;
+}): Promise<QuicInfoResult>;
+/** `tailii-host quic-info` エントリポイント。stdout に JSON 1 行を出す（常に exit 0）。 */
+export declare function runQuicInfoCommand(_argv: string[]): Promise<number>;