tailii-host 0.6.0 → 0.7.1

package/dist/shared/clientBuild.d.ts

@@ -0,0 +1,44 @@
+export interface ClientBuildRecord {
+    /** 記録時点で最も新しいビルド番号（CFBundleVersion）。 */
+    latestClientBuild: string;
+    /** そのビルドが名乗ったマーケティング版（表示用。比較には使わない）。 */
+    clientVersion?: string;
+    /** 記録した時刻（epoch ms）。 */
+    tsMs: number;
+}
+/**
+ * この host 版がリリース時点で把握しているアプリの最新ビルド（CFBundleVersion）。
+ *
+ * 観測値（このホストへ接続してきた中で最も新しいビルド）だけを広告すると、
+ * **host が先に更新された場合に古いアプリへ何も促せない**（新しいビルドが一度も
+ * 接続していないため記録が育たない）。広告値はこのピンと観測値の新しい方を採り、
+ * どちらが先に更新されても古い側にだけ更新導線が出るようにする。
+ *
+ * **アプリの新ビルドを配布したときに上げる**。配布前に上げると、まだ入手できない
+ * ビルドへの更新を促すことになる（host のピンをアプリ側が持つ関係の裏返し。
+ * 順序は docs/host-auto-update.md を参照）。
+ */
+export declare const CLIENT_BUILD_PIN = "5";
+/** 記録ファイルの既定パス（self-update の管理ルートと同じ ~/.tailii/host/ 配下）。 */
+export declare function clientBuildRecordPath(): string;
+/** "4" / "1.2.3" を整数タプルへ。Apple の CFBundleVersion 規約外は null。 */
+export declare function parseBuildTuple(build: string): number[] | null;
+/** ビルド番号の比較（欠けた要素は 0 とみなす）。どちらかが規約外なら null。 */
+export declare function compareBuild(a: string, b: string): number | null;
+/** 記録済みの最新クライアントビルドを読む（無い・壊れている・規約外は null）。 */
+export declare function readLatestClientBuild(filePath?: string): string | null;
+/**
+ * hello で名乗られたクライアントビルドを記録する。既存より新しいときだけ書き換える
+ * （古いビルドの接続で記録が後退しない = 「最も新しいビルド」の単調性）。
+ * 記録は best-effort（失敗しても接続には影響させない）。
+ * @returns 書き換えたら true。
+ */
+export declare function recordClientBuild(info: {
+    clientBuild: string;
+    clientVersion?: string;
+}, filePath?: string, nowMs?: number): boolean;
+/**
+ * hello で広告するビルド番号を決める（ピンと観測値の新しい方）。
+ * どちらも無い / 規約外なら null（広告しない = 誤警報より沈黙）。
+ */
+export declare function advertisedClientBuild(observed: string | null, pin?: string | null): string | null;

package/dist/shared/clientBuild.js

@@ -0,0 +1,116 @@
+// shared/clientBuild.ts — iOS クライアントのビルド番号の記録（host-auto-update）
+//
+// アプリは channel_hello に自分の `clientVersion`(CFBundleShortVersionString, 例 "1.0.0") と
+// `clientBuild`(CFBundleVersion, 例 "4") を載せる。host はこのホストへ接続してきた
+// 「最も新しいビルド番号」を ~/.tailii/host/client-build.json に記録し、次回以降の
+// channel_hello で `latestClientBuild` として広告する（記録が無い / 古い間は host 版が持つ
+// ピン CLIENT_BUILD_PIN を使う）。アプリは自分のビルド番号と比較し、より新しいビルドが
+// あれば「アプリを更新」を促す
+// （TestFlight 配布ではマーケティング版 1.0.0 が据え置かれたままビルド番号だけ進むため、
+// 版文字列ではなくビルド番号で判定する）。
+//
+// ビルド番号は Apple の規約どおり「ピリオド区切りの整数 1〜3 要素」だけを比較対象にする。
+// それ以外（空・非数値）は記録も比較もしない（誤警報より沈黙）。
+import fs from "node:fs";
+import os from "node:os";
+import path from "node:path";
+/**
+ * この host 版がリリース時点で把握しているアプリの最新ビルド（CFBundleVersion）。
+ *
+ * 観測値（このホストへ接続してきた中で最も新しいビルド）だけを広告すると、
+ * **host が先に更新された場合に古いアプリへ何も促せない**（新しいビルドが一度も
+ * 接続していないため記録が育たない）。広告値はこのピンと観測値の新しい方を採り、
+ * どちらが先に更新されても古い側にだけ更新導線が出るようにする。
+ *
+ * **アプリの新ビルドを配布したときに上げる**。配布前に上げると、まだ入手できない
+ * ビルドへの更新を促すことになる（host のピンをアプリ側が持つ関係の裏返し。
+ * 順序は docs/host-auto-update.md を参照）。
+ */
+export const CLIENT_BUILD_PIN = "5";
+/** 記録ファイルの既定パス（self-update の管理ルートと同じ ~/.tailii/host/ 配下）。 */
+export function clientBuildRecordPath() {
+    return path.join(os.homedir(), ".tailii", "host", "client-build.json");
+}
+/** "4" / "1.2.3" を整数タプルへ。Apple の CFBundleVersion 規約外は null。 */
+export function parseBuildTuple(build) {
+    const parts = build.trim().split(".");
+    if (parts.length === 0 || parts.length > 3)
+        return null;
+    const numbers = [];
+    for (const part of parts) {
+        if (!/^\d{1,9}$/.test(part))
+            return null;
+        numbers.push(Number.parseInt(part, 10));
+    }
+    return numbers;
+}
+/** ビルド番号の比較（欠けた要素は 0 とみなす）。どちらかが規約外なら null。 */
+export function compareBuild(a, b) {
+    const left = parseBuildTuple(a);
+    const right = parseBuildTuple(b);
+    if (left === null || right === null)
+        return null;
+    const length = Math.max(left.length, right.length);
+    for (let index = 0; index < length; index += 1) {
+        const l = left[index] ?? 0;
+        const r = right[index] ?? 0;
+        if (l !== r)
+            return l < r ? -1 : 1;
+    }
+    return 0;
+}
+/** 記録済みの最新クライアントビルドを読む（無い・壊れている・規約外は null）。 */
+export function readLatestClientBuild(filePath = clientBuildRecordPath()) {
+    try {
+        const parsed = JSON.parse(fs.readFileSync(filePath, "utf8"));
+        if (typeof parsed !== "object" || parsed === null)
+            return null;
+        const record = parsed;
+        if (typeof record.latestClientBuild !== "string")
+            return null;
+        return parseBuildTuple(record.latestClientBuild) === null ? null : record.latestClientBuild;
+    }
+    catch {
+        return null;
+    }
+}
+/**
+ * hello で名乗られたクライアントビルドを記録する。既存より新しいときだけ書き換える
+ * （古いビルドの接続で記録が後退しない = 「最も新しいビルド」の単調性）。
+ * 記録は best-effort（失敗しても接続には影響させない）。
+ * @returns 書き換えたら true。
+ */
+export function recordClientBuild(info, filePath = clientBuildRecordPath(), nowMs = Date.now()) {
+    if (parseBuildTuple(info.clientBuild) === null)
+        return false;
+    const current = readLatestClientBuild(filePath);
+    if (current !== null && (compareBuild(info.clientBuild, current) ?? -1) <= 0)
+        return false;
+    const record = {
+        latestClientBuild: info.clientBuild.trim(),
+        ...(info.clientVersion !== undefined ? { clientVersion: info.clientVersion } : {}),
+        tsMs: nowMs,
+    };
+    try {
+        fs.mkdirSync(path.dirname(filePath), { recursive: true });
+        fs.writeFileSync(filePath, JSON.stringify(record));
+        return true;
+    }
+    catch {
+        return false;
+    }
+}
+/**
+ * hello で広告するビルド番号を決める（ピンと観測値の新しい方）。
+ * どちらも無い / 規約外なら null（広告しない = 誤警報より沈黙）。
+ */
+export function advertisedClientBuild(observed, pin = CLIENT_BUILD_PIN) {
+    const validObserved = observed !== null && parseBuildTuple(observed) !== null ? observed : null;
+    const validPin = pin !== null && parseBuildTuple(pin) !== null ? pin : null;
+    if (validPin === null)
+        return validObserved;
+    if (validObserved === null)
+        return validPin;
+    return (compareBuild(validObserved, validPin) ?? 0) >= 0 ? validObserved : validPin;
+}
+//# sourceMappingURL=clientBuild.js.map

package/dist/shared/clientBuild.js.map

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

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "tailii-host",
-  "version": "0.6.0",
+  "version": "0.7.1",
   "description": "Tailii host — control Claude Code / Codex sessions on your machine from the Tailii mobile app",
   "author": "Namasugi",
   "license": "MIT",
@@ -50,7 +50,7 @@
     "ws": "^8.21.1"
   },
   "optionalDependencies": {
-    "@tailii/quic-gw-darwin-arm64": "0.6.0",
-    "@tailii/quic-gw-darwin-x64": "0.6.0"
+    "@tailii/quic-gw-darwin-arm64": "0.7.1",
+    "@tailii/quic-gw-darwin-x64": "0.7.1"
   }
 }