browser-git-ops 0.0.2 → 0.0.5

package/dist/virtualfs/changeTracker.d.ts

@@ -0,0 +1,66 @@
+import { StorageBackend } from './storageBackend.ts';
+import { IndexManager } from './indexManager.ts';
+/**
+ * 変更追跡を行うユーティリティクラス
+ */
+export declare class ChangeTracker {
+    private backend;
+    private indexManager;
+    /**
+     * コンストラクタ
+     * @param {StorageBackend} backend - ストレージバックエンド
+     * @param {IndexManager} indexManager - インデックス管理オブジェクト
+     */
+    constructor(backend: StorageBackend, indexManager: IndexManager);
+    /**
+     * ワークスペースの変更セットを取得する
+     * @returns {Promise<Array>} 変更オブジェクトの配列
+     */
+    getChangeSet(): Promise<Array<any>>;
+    /**
+     * インデックス差分から削除変更を取得する
+     * @returns {Promise<Array<{type:'delete';path:string;baseSha:string}>>} 削除変更の配列
+     */
+    private _changesFromIndexDeletes;
+    /**
+     * Determine whether an index entry should be considered a local delete.
+     * - explicit deleted state -> true
+     * - only if workspaceSha existed previously and workspace blob now missing
+     * @param ie index entry
+     * @param p file path
+     * @returns true when entry represents a local deletion
+     */
+    private _isIndexEntryDeleted;
+    /**
+     * トゥームストーンから削除変更を取得する（未実装：空配列を返す）
+     * @returns {Promise<Array<{type:'delete';path:string;baseSha:string}>>}
+     */
+    private _changesFromTombstones;
+    /**
+     * インデックスエントリから作成・更新の変更を取得する
+     * @returns {Promise<Array>} 作成/更新変更の配列
+     */
+    private _changesFromIndexEntries;
+    /**
+     * 単一のインデックスファイルから変更を抽出する
+     * @param {string} p - ファイルパス
+     * @param {string|null} infoTxt - インデックスの情報テキスト
+     * @returns {Promise<Array>} 変更配列
+     */
+    private _changesForIndexFile;
+    /**
+     * インデックスエントリから具体的な変更リストを作る
+     * @param {any} entry - インデックスエントリ
+     * @param {string} p - パス
+     * @param {string|null} blob - blob コンテンツ
+     * @returns {Array} 変更オブジェクト配列
+     */
+    private _changesFromIndexEntry;
+    /**
+     * エントリが変更対象として考慮されるか判定する
+     * @param {any} entry - インデックスエントリ
+     * @returns {boolean} 考慮対象ならtrue
+     */
+    private _isEntryConsidered;
+}
+//# sourceMappingURL=changeTracker.d.ts.map

package/dist/virtualfs/changeTracker.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"changeTracker.d.ts","sourceRoot":"","sources":["../../src/virtualfs/changeTracker.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;GAEG;AACH,qBAAa,aAAa;IACxB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAc;IAElC;;;;OAIG;gBACS,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY;IAK/D;;;OAGG;IACG,YAAY,IAAI,OAAO,CAAC,KAAK,CAAC,GAAG,CAAC,CAAC;IAgBzC;;;OAGG;YACW,wBAAwB;IAgBtC;;;;;;;OAOG;YACW,oBAAoB;IAQlC;;;OAGG;YACW,sBAAsB;IAIpC;;;OAGG;YACW,wBAAwB;IAatC;;;;;OAKG;YACW,oBAAoB;IAiBlC;;;;;;OAMG;IACH,OAAO,CAAC,sBAAsB;IAiB9B;;;;OAIG;IACH,OAAO,CAAC,kBAAkB;CAG3B"}

package/dist/virtualfs/conflictManager.d.ts

@@ -0,0 +1,69 @@
+import { StorageBackend } from './storageBackend.ts';
+import { IndexManager } from './indexManager.ts';
+/**
+ *
+ */
+export declare class ConflictManager {
+    private backend;
+    private indexManager;
+    /**
+     *
+     */
+    constructor(backend: StorageBackend, indexManager: IndexManager);
+    /**
+     * 指定パスのコンフリクト内容を読み取る
+     * @param {string} filepath - ファイルパス
+     * @returns {Promise<string|null>} コンフリクトの内容、なければnull
+     */
+    readConflict(filepath: string): Promise<string | null>;
+    /**
+     * コンフリクトを解消してインデックスを更新する
+     * @param {string} filepath - ファイルパス
+     * @returns {Promise<boolean>} 成功すればtrue、失敗すればfalse
+     */
+    resolveConflict(filepath: string): Promise<boolean>;
+    /**
+     * Load index entry from info blob or index entries.
+     * @param {string} filepath
+     * @returns {Promise<any>} index entry or undefined
+     */
+    private _loadIndexEntry;
+    /**
+     * リモートの内容をコンフリクトとして永続化する
+     * @param {string} p - ファイルパス
+     * @param {string|undefined} content - 永続化する内容
+     * @returns {Promise<void>}
+     */
+    persistRemoteContentAsConflict(p: string, content: string | undefined): Promise<void>;
+    /**
+     * 指定のインデックスエントリをコンフリクト状態にする
+     * @param {string} p - ファイルパス
+     * @param {any} ie - インデックスエントリオブジェクト
+     * @param {string} remoteHeadSha - リモートのHEAD SHA
+     * @returns {Promise<void>}
+     */
+    setIndexEntryToConflict(p: string, ie: any, remoteHeadSha: string): Promise<void>;
+    /**
+     * 解決済みのコンフリクトエントリを昇格してベース状態に戻す
+     * @param {any} c - コンフリクト情報（.path を含む）
+     * @param {Record<string,string>} baseSnapshot - ベーススナップショットマップ
+     * @returns {Promise<void>}
+     */
+    promoteResolvedConflictEntry(c: any, baseSnapshot: Record<string, string>): Promise<void>;
+    /**
+     * 全てのコンフリクトが解決済みか判定する
+     * @param {Array<any>} conflicts - コンフリクト一覧
+     * @returns {Promise<boolean>} 全て解決済みならtrue
+     */
+    areAllResolved(conflicts: Array<any>): Promise<boolean>;
+    /**
+     * 解決済みのコンフリクト群を昇格してインデックスを更新する
+     * @param {Array<any>} conflicts - コンフリクト一覧
+     * @param {Record<string,string>} baseSnapshot - ベーススナップショット
+     * @param {string} remoteHead - リモートのHEAD
+     * @returns {Promise<void>}
+     */
+    promoteResolvedConflicts(conflicts: Array<any>, baseSnapshot: Record<string, string>, remoteHead: string): Promise<void>;
+}
+export default ConflictManager;
+//# sourceMappingURL=conflictManager.d.ts.map

package/dist/virtualfs/conflictManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"conflictManager.d.ts","sourceRoot":"","sources":["../../src/virtualfs/conflictManager.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAEhD;;GAEG;AACH,qBAAa,eAAe;IAC1B,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,YAAY,CAAc;IAElC;;OAEG;gBACS,OAAO,EAAE,cAAc,EAAE,YAAY,EAAE,YAAY;IAK/D;;;;OAIG;IACG,YAAY,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAM5D;;;;OAIG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,CAAC;IAgCzD;;;;OAIG;YACW,eAAe;IAW7B;;;;;OAKG;IACG,8BAA8B,CAAC,CAAC,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IAS3F;;;;;;OAMG;IACG,uBAAuB,CAAC,CAAC,EAAE,MAAM,EAAE,EAAE,EAAE,GAAG,EAAE,aAAa,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAOvF;;;;;OAKG;IACG,4BAA4B,CAAC,CAAC,EAAE,GAAG,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,GAAG,OAAO,CAAC,IAAI,CAAC;IAyB/F;;;;OAIG;IACG,cAAc,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,GAAG,OAAO,CAAC,OAAO,CAAC;IAe7D;;;;;;OAMG;IACG,wBAAwB,CAAC,SAAS,EAAE,KAAK,CAAC,GAAG,CAAC,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,UAAU,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAQ/H;AAED,eAAe,eAAe,CAAA"}

package/dist/virtualfs/hashUtils.d.ts

@@ -0,0 +1,13 @@
+/**
+ * SHA-1ハッシュ値を計算して16進文字列で返す
+ * @param {string} content - ハッシュ対象の文字列
+ * @returns {Promise<string>} SHA-1ハッシュの16進表現
+ */
+export declare function shaOf(content: string): Promise<string>;
+/**
+ * Git の blob としての SHA-1 ハッシュを計算して16進文字列で返す
+ * @param {string} content - blob の中身となる文字列
+ * @returns {Promise<string>} SHA-1ハッシュの16進表現（git blob 用）
+ */
+export declare function shaOfGitBlob(content: string): Promise<string>;
+//# sourceMappingURL=hashUtils.d.ts.map

package/dist/virtualfs/hashUtils.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"hashUtils.d.ts","sourceRoot":"","sources":["../../src/virtualfs/hashUtils.ts"],"names":[],"mappings":"AAAA;;;;GAIG;AACH,wBAAsB,KAAK,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAM5D;AAED;;;;GAIG;AACH,wBAAsB,YAAY,CAAC,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAUnE"}

package/dist/virtualfs/indexManager.d.ts

@@ -0,0 +1,57 @@
+import type { StorageBackend } from './storageBackend.ts';
+import { IndexFile } from './types.ts';
+/**
+ * インデックス管理クラス
+ */
+export declare class IndexManager {
+    private backend;
+    private head;
+    private lastCommitKey;
+    /**
+     * コンストラクタ
+     * @param {StorageBackend} backend - ストレージバックエンド
+     */
+    constructor(backend: StorageBackend);
+    /**
+     * インデックスをストレージから読み込む
+     * @returns {Promise<void>}
+     */
+    loadIndex(): Promise<void>;
+    /**
+     * インデックスをストレージへ書き込む
+     * @returns {Promise<void>}
+     */
+    saveIndex(): Promise<void>;
+    /**
+     * 現在のheadを返す
+     * @returns {string}
+     */
+    getHead(): string;
+    /**
+     * headを設定する
+     * @param {string} h - head文字列
+     */
+    setHead(h: string): void;
+    /**
+     * 最後のコミットキーを返す
+     * @returns {string|undefined}
+     */
+    getLastCommitKey(): string | undefined;
+    /**
+     * 最後のコミットキーを設定する
+     * @param {string|undefined} k - コミットキー
+     */
+    setLastCommitKey(k: string | undefined): void;
+    /**
+     * 現在のインデックスを取得する（Proxyでheadを委譲）
+     * @returns {Promise<IndexFile>} インデックスオブジェクト
+     */
+    getIndex(): Promise<IndexFile>;
+    /**
+     * info に存在する全パスを列挙する
+     * @returns {Promise<string[]>} パスの配列
+     */
+    listPaths(): Promise<string[]>;
+}
+export default IndexManager;
+//# sourceMappingURL=indexManager.d.ts.map

package/dist/virtualfs/indexManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexManager.d.ts","sourceRoot":"","sources":["../../src/virtualfs/indexManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACzD,OAAO,EAAE,SAAS,EAAE,MAAM,YAAY,CAAA;AAEtC;;GAEG;AACH,qBAAa,YAAY;IACvB,OAAO,CAAC,OAAO,CAAgB;IAC/B,OAAO,CAAC,IAAI,CAAa;IACzB,OAAO,CAAC,aAAa,CAAoB;IAEzC;;;OAGG;gBACS,OAAO,EAAE,cAAc;IAInC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAchC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,IAAI,CAAC;IAUhC;;;OAGG;IACH,OAAO,IAAI,MAAM;IAIjB;;;OAGG;IACH,OAAO,CAAC,CAAC,EAAE,MAAM,GAAG,IAAI;IAIxB;;;OAGG;IACH,gBAAgB,IAAI,MAAM,GAAG,SAAS;IAItC;;;OAGG;IACH,gBAAgB,CAAC,CAAC,EAAE,MAAM,GAAG,SAAS,GAAG,IAAI;IAI7C;;;OAGG;IACG,QAAQ,IAAI,OAAO,CAAC,SAAS,CAAC;IAgCpC;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,MAAM,EAAE,CAAC;CAiBrC;AAED,eAAe,YAAY,CAAA"}

package/dist/virtualfs/indexedDatabaseStorage.d.ts

@@ -0,0 +1,7 @@
+import { StorageBackendConstructor } from './storageBackend.ts';
+/**
+ * IndexedDB を用いた永続化実装
+ */
+export declare const IndexedDatabaseStorage: StorageBackendConstructor;
+export default IndexedDatabaseStorage;
+//# sourceMappingURL=indexedDatabaseStorage.d.ts.map

package/dist/virtualfs/indexedDatabaseStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"indexedDatabaseStorage.d.ts","sourceRoot":"","sources":["../../src/virtualfs/indexedDatabaseStorage.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,yBAAyB,EAAW,MAAM,qBAAqB,CAAA;AAExF;;GAEG;AACH,eAAO,MAAM,sBAAsB,EAAE,yBAy8BpC,CAAA;AAED,eAAe,sBAAsB,CAAA"}

package/dist/virtualfs/inmemoryStorage.d.ts

@@ -0,0 +1,8 @@
+import { StorageBackendConstructor } from './storageBackend.ts';
+/**
+ * テストや軽量動作検証用のインメモリ実装。
+ * `StorageBackend` を実装し、アプリケーション側で差し替えて利用できます。
+ */
+export declare const InMemoryStorage: StorageBackendConstructor;
+export default InMemoryStorage;
+//# sourceMappingURL=inmemoryStorage.d.ts.map

package/dist/virtualfs/inmemoryStorage.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"inmemoryStorage.d.ts","sourceRoot":"","sources":["../../src/virtualfs/inmemoryStorage.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAQ/E;;;GAGG;AACH,eAAO,MAAM,eAAe,EAAE,yBAynB7B,CAAA;AAED,eAAe,eAAe,CAAA"}

package/dist/virtualfs/localChangeApplier.d.ts

@@ -0,0 +1,21 @@
+import type { StorageBackend } from './storageBackend.ts';
+/**
+ *
+ */
+export declare class LocalChangeApplier {
+    private backend;
+    /**
+     *
+     */
+    constructor(backend: StorageBackend);
+    /**
+     *
+     */
+    applyCreateOrUpdate(ch: any): Promise<void>;
+    /**
+     *
+     */
+    applyDelete(ch: any): Promise<void>;
+}
+export default LocalChangeApplier;
+//# sourceMappingURL=localChangeApplier.d.ts.map

package/dist/virtualfs/localChangeApplier.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localChangeApplier.d.ts","sourceRoot":"","sources":["../../src/virtualfs/localChangeApplier.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAEzD;;GAEG;AACH,qBAAa,kBAAkB;IAC7B,OAAO,CAAC,OAAO,CAAgB;IAE/B;;OAEG;gBACS,OAAO,EAAE,cAAc;IAInC;;OAEG;IACG,mBAAmB,CAAC,EAAE,EAAE,GAAG;IAOjC;;OAEG;IACG,WAAW,CAAC,EAAE,EAAE,GAAG;CAM1B;AAED,eAAe,kBAAkB,CAAA"}

package/dist/virtualfs/localFileManager.d.ts

@@ -0,0 +1,58 @@
+import type { StorageBackend } from './storageBackend.ts';
+/**
+ * ローカルファイル操作のラッパー
+ */
+export declare class LocalFileManager {
+    private backend;
+    /**
+     * コンストラクタ
+     * @param {StorageBackend} backend - ストレージバックエンド
+     */
+    constructor(backend: StorageBackend);
+    /**
+     * ファイルを書き込む（workspace領域）
+     * @param {string} filepath - ファイルパス
+     * @param {string} content - 書き込む内容
+     * @returns {Promise<void>}
+     */
+    writeFile(filepath: string, content: string): Promise<void>;
+    /**
+     * git に残る info を元に workspace 用のトンブストーンを作成して書き込む
+     * @param {string} filepath - ファイルパス
+     * @returns {Promise<void>}
+     */
+    private _writeTombstoneFromGit;
+    /**
+     * ワークスペースの info をトンブストーン状態に更新して書き込む
+     * @param {string} filepath - ファイルパス
+     * @returns {Promise<void>}
+     */
+    private _writeWorkspaceTombstone;
+    /**
+     * info 関連のエントリを削除する（best-effort）
+     * @param {string} filepath - ファイルパス
+     * @returns {Promise<void>}
+     */
+    private _deleteInfos;
+    /**
+     * ファイルを削除する（workspace と info をクリア）
+     * @param {string} filepath - ファイルパス
+     * @returns {Promise<void>}
+     */
+    deleteFile(filepath: string): Promise<void>;
+    /**
+     * ワークスペースまたはベースからファイルを読み出す
+     * @param {string} filepath - ファイルパス
+     * @returns {Promise<string|null>} ファイル内容または null
+     */
+    readFile(filepath: string): Promise<string | null>;
+    /**
+     * ファイルをリネームする（内容をコピーして元を削除）
+     * @param {string} from - 元パス
+     * @param {string} to - 先パス
+     * @returns {Promise<void>}
+     */
+    renameFile(from: string, to: string): Promise<void>;
+}
+export default LocalFileManager;
+//# sourceMappingURL=localFileManager.d.ts.map

package/dist/virtualfs/localFileManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"localFileManager.d.ts","sourceRoot":"","sources":["../../src/virtualfs/localFileManager.ts"],"names":[],"mappings":"AAAA,OAAO,KAAK,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AAQzD;;GAEG;AACH,qBAAa,gBAAgB;IAC3B,OAAO,CAAC,OAAO,CAAgB;IAE/B;;;OAGG;gBACS,OAAO,EAAE,cAAc;IAInC;;;;;OAKG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAIjE;;;;OAIG;YACW,sBAAsB;IAepC;;;;OAIG;YACW,wBAAwB;IAetC;;;;OAIG;YACW,YAAY;IAK1B;;;;OAIG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IA2BjD;;;;OAIG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAQxD;;;;;OAKG;IACG,UAAU,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;CAM1D;AAED,eAAe,gBAAgB,CAAA"}

package/dist/virtualfs/metadataManager.d.ts

@@ -0,0 +1,14 @@
+/**
+ * Update in-memory info metadata when a blob is written to a segment.
+ * @param store in-memory store object
+ * @param filepath path key
+ * @param seg segment name ('workspace'|'base'|'conflict'|'info')
+ * @param content blob content
+ * @returns Promise<void>
+ */
+export declare function updateInfoForWrite(store: any, filepath: string, seg: string, content: string): Promise<void>;
+declare const _default: {
+    updateInfoForWrite: typeof updateInfoForWrite;
+};
+export default _default;
+//# sourceMappingURL=metadataManager.d.ts.map

package/dist/virtualfs/metadataManager.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"metadataManager.d.ts","sourceRoot":"","sources":["../../src/virtualfs/metadataManager.ts"],"names":[],"mappings":"AAuLA;;;;;;;GAOG;AACH,wBAAsB,kBAAkB,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,EAAE,MAAM,EAAE,GAAG,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC,CAqBlH;;;;AAgBD,wBAAqC"}

package/dist/virtualfs/opfsStorage.d.ts

@@ -1,66 +1,5 @@
-import { IndexFile } from './types';
-import { StorageBackend } from './storageBackend';
+import { StorageBackendConstructor } from './storageBackend.ts';
 /** OPFS (origin private file system) を利用する永続化実装 */
-export declare class OpfsStorage implements StorageBackend {
-    /**
-     * 同期的に OPFS 利用可否を判定します（レガシーヒントも含む）。
-     * @returns {boolean} 利用可能なら true
-     */
-    static canUse(): boolean;
-    /** コンストラクタ（OPFS は初期化不要） */
-    constructor();
-    /**
-     * 初期化（OPFS はランタイム判定のみ）
-     * @returns {Promise<void>} 初期化完了時に解決
-     */
-    init(): Promise<void>;
-    /**
-     * OPFS のルートディレクトリハンドルを取得します。失敗時は null を返す。
-     * @returns {Promise<any|null>} ルートハンドルまたは null
-     */
-    private getOpfsRoot;
-    /**
-     * 指定パスのディレクトリを再帰的に作成して返す
-     * @returns {Promise<any>} 生成されたディレクトリハンドル
-     */
-    private ensureDir;
-    /**
-     * index を読み出す
-     * @returns {Promise<IndexFile|null>} 読み出した IndexFile、存在しなければ null
-     */
-    readIndex(): Promise<IndexFile | null>;
-    /**
-     * index を書き込む
-     * @returns {Promise<void>} 書込完了時に解決
-     */
-    writeIndex(index: IndexFile): Promise<void>;
-    /**
-     * blob を書き込む
-     * @returns {Promise<void>} 書込完了時に解決
-     */
-    writeBlob(filepath: string, content: string): Promise<void>;
-    /**
-     * blob を読み出す
-     * @returns {Promise<string|null>} ファイル内容、存在しなければ null
-     */
-    readBlob(filepath: string): Promise<string | null>;
-    /**
-     * blob を削除する
-     * @returns {Promise<void>} 削除完了時に解決
-     */
-    deleteBlob(filepath: string): Promise<void>;
-    /**
-     * Traverse into nested directories without creating them.
-     * @param root The starting directory handle
-     * @param parts Path parts to traverse
-     * @returns The final directory handle
-     */
-    private traverseDir;
-    /**
-     * Try to remove a file via its file handle.
-     * @returns {Promise<boolean>} true when removed, false otherwise
-     */
-    private tryRemoveFileHandle;
-}
+export declare const OpfsStorage: StorageBackendConstructor;
 export default OpfsStorage;
 //# sourceMappingURL=opfsStorage.d.ts.map

package/dist/virtualfs/opfsStorage.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"opfsStorage.d.ts","sourceRoot":"","sources":["../../src/virtualfs/opfsStorage.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,SAAS,EAAE,MAAM,SAAS,CAAA;AACnC,OAAO,EAAE,cAAc,EAAE,MAAM,kBAAkB,CAAA;AAIjD,mDAAmD;AACnD,qBAAa,WAAY,YAAW,cAAc;IAChD;;;OAGG;IACH,MAAM,CAAC,MAAM,IAAI,OAAO;IAcxB,2BAA2B;;IAG3B;;;OAGG;IACG,IAAI,IAAI,OAAO,CAAC,IAAI,CAAC;IAM3B;;;OAGG;YACW,WAAW;IAmBzB;;;OAGG;YACW,SAAS;IAcvB;;;OAGG;IACG,SAAS,IAAI,OAAO,CAAC,SAAS,GAAG,IAAI,CAAC;IAa5C;;;OAGG;IACG,UAAU,CAAC,KAAK,EAAE,SAAS,GAAG,OAAO,CAAC,IAAI,CAAC;IASjD;;;OAGG;IACG,SAAS,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAmBjE;;;OAGG;IACG,QAAQ,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAexD;;;OAGG;IACG,UAAU,CAAC,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAoBjD;;;;;OAKG;YACW,WAAW;IAczB;;;OAGG;YACW,mBAAmB;CAYlC;AAED,eAAe,WAAW,CAAA"}
+{"version":3,"file":"opfsStorage.d.ts","sourceRoot":"","sources":["../../src/virtualfs/opfsStorage.ts"],"names":[],"mappings":"AACA,OAAO,EAAkB,yBAAyB,EAAE,MAAM,qBAAqB,CAAA;AAW/E,mDAAmD;AACnD,eAAO,MAAM,WAAW,EAAE,yBA64BzB,CAAA;AAED,eAAe,WAAW,CAAA"}

package/dist/virtualfs/remoteSynchronizer.d.ts

@@ -0,0 +1,192 @@
+import { StorageBackend } from './storageBackend.ts';
+import { IndexManager } from './indexManager.ts';
+import { ConflictManager } from './conflictManager.ts';
+import { LocalChangeApplier } from './localChangeApplier.ts';
+type RemoteSnapshotDescriptor = {
+    headSha: string;
+    shas: Record<string, string>;
+    fetchContent: (_paths: string[]) => Promise<Record<string, string>>;
+};
+/**
+ * リモート同期を行うクラス
+ */
+export declare class RemoteSynchronizer {
+    private _backend;
+    private _indexManager;
+    private _conflictManager;
+    private _applier;
+    /**
+     * コンストラクタ
+     * @param {StorageBackend} backend - ストレージバックエンド
+     * @param {IndexManager} indexManager - インデックス管理
+     * @param {ConflictManager} conflictManager - コンフリクト管理
+     * @param {LocalChangeApplier} applier - ローカル適用器
+     */
+    constructor(_backend: StorageBackend, _indexManager: IndexManager, _conflictManager: ConflictManager, _applier: LocalChangeApplier);
+    /**
+     * リモートのスナップショットをpullしてローカルを同期する
+     * @param {RemoteSnapshotDescriptor|string} remote - リモートスナップショットまたはheadSha
+     * @param {Record<string,string>=} baseSnapshot - オプションのベーススナップショット
+     * @returns {Promise<object>} conflicts, fetchedPaths, reconciledPaths を含む結果オブジェクト
+     */
+    pull(remote: RemoteSnapshotDescriptor | string, baseSnapshot?: Record<string, string>, adapterInstance?: any): Promise<object>;
+    /**
+     * ローカルの変更をpushする（インデックス更新を行う）
+     * @param {any} input - push 入力（parentSha, changes 等）
+     * @param {any=} adapter - オプションのアダプタ
+     * @returns {Promise<object>} commitSha を含むオブジェクト
+     */
+    push(input: any, _adapter?: any): Promise<object>;
+    /**
+     * ベーススナップショットを適用してローカルを置き換える
+     * @param {Record<string,string>} snapshot - パス->内容のマップ
+     * @param {string} headSha - 適用後のhead
+     * @returns {Promise<void>}
+     */
+    applyBaseSnapshot(snapshot: Record<string, string>, headSha: string): Promise<void>;
+    /**
+     * remote 引数を標準の RemoteSnapshotDescriptor に変換する
+     * @returns {Promise<RemoteSnapshotDescriptor>}
+     */
+    private _normalizeRemoteInput;
+    /**
+     * 追加/更新対象のパス一覧を計算する
+     * @returns {Promise<string[]>}
+     */
+    private _computeToAddOrUpdate;
+    /**
+     * 削除対象のパス一覧を計算する
+     * @returns {Promise<string[]>}
+     */
+    private _computeToRemove;
+    /**
+     * 指定パスの削除を適用する
+     * @param {string[]} toRemove - 削除対象パス配列
+     * @returns {Promise<void>}
+     */
+    private _applyRemovals;
+    /**
+     * 追加/更新を適用する
+     * @returns {Promise<void>}
+     */
+    private _applyAddsOrUpdates;
+    /**
+     * リモートの追加/更新を処理する
+     * @returns {Promise<void>}
+     */
+    private _processRemoteAddsAndUpdates;
+    /**
+     * リモートの削除を処理する
+     * @returns {Promise<void>}
+     */
+    private _processRemoteDeletions;
+    /**
+     * プル時に個別パスが既に整合済みか判定する
+     * @returns {Promise<boolean>} 整合済みならtrue
+     */
+    private _classifyRemotePathForPull;
+    /**
+     * 個別のリモートパスを処理する（新規/既存の振り分けを行う）
+     * @returns {Promise<void>}
+     */
+    private _handleRemotePath;
+    /**
+     * 新規ファイルに対する処理（追加 or conflict）
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteNew;
+    /**
+     * 新規でコンフリクトが発生した場合の処理
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteNewConflict;
+    /**
+     * 新規追加を処理する
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteNewAdd;
+    /**
+     * 既存ファイルに対する更新/競合処理
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteExisting;
+    /**
+     * 既存ファイルの更新処理
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteExistingUpdate;
+    /**
+     * 既存ファイルで競合が発生した場合の処理
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteExistingConflict;
+    /**
+     * リモートで削除されたパスの処理
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteDeletion;
+    /**
+     * 変更をローカルに適用する（create/update/delete）
+     * @returns {Promise<void>}
+     */
+    private _applyChangeLocally;
+    /**
+     * On-demand: fetch and store base content for a single path when missing.
+     * @param {string} path
+     * @param {any=} adapterInstance optional adapter instance to fetch remote content
+     * @returns {Promise<string|null>} fetched content or null
+     */
+    fetchBaseIfMissing(path: string, adapterInstance?: any): Promise<string | null>;
+    /**
+     * Read and parse the stored info entry for `path`.
+     * Returns parsed object or null when missing/invalid.
+     * @returns {Promise<any|null>} parsed object or null
+     */
+    private _readInfoEntry;
+    /**
+     * Attempt to fetch base content using adapterInstance.getBlob.
+     * Returns string when fetched, null when fetch attempted but failed, or undefined when adapter not supported.
+     * @returns {Promise<string|null|undefined>} fetched content, null, or undefined
+     */
+    private _tryFetchBaseWithAdapter;
+    /**
+     * Handle a fetched blob-like object: decode if base64 and persist into backend.
+     * Returns decoded content string, or null on failure.
+     * @returns {Promise<string|null>} decoded content or null on failure
+     */
+    private _handleFetchedBlob;
+    /**
+     * Attempt to fetch raw file using adapterInstance._fetchFileRaw if available.
+     * Returns string when fetched, null when attempted but failed, or undefined when adapter not supported.
+     * @returns {Promise<string|null|undefined>} fetched content, null, or undefined
+     */
+    private _tryFetchRawFile;
+    /**
+     * Decode a base64 string into UTF-8 text. Uses global Buffer when available,
+     * falls back to atob/TextDecoder for browsers.
+     * @returns {string} decoded UTF-8 string
+     */
+    private _decodeBase64ToString;
+    /**
+     * Convert a binary string (result of atob) into a UTF-8 string.
+     * @param bin binary string
+     * @returns {string} decoded UTF-8 string
+     */
+    private _binToUtf8;
+    /**
+     * Try to decode base64 using a global Buffer if available.
+     * Returns decoded string or undefined when Buffer not available.
+     * @param safe base64 string
+     * @returns {string|undefined}
+     */
+    private _tryDecodeWithBuffer;
+    /**
+     * Try to decode base64 using atob/TextDecoder in browser.
+     * Returns decoded string or undefined when atob not available or parse fails.
+     * @param safe base64 string
+     * @returns {string|undefined}
+     */
+    private _tryDecodeWithAtob;
+}
+export default RemoteSynchronizer;
+//# sourceMappingURL=remoteSynchronizer.d.ts.map

package/dist/virtualfs/remoteSynchronizer.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"remoteSynchronizer.d.ts","sourceRoot":"","sources":["../../src/virtualfs/remoteSynchronizer.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,cAAc,EAAE,MAAM,qBAAqB,CAAA;AACpD,OAAO,EAAE,YAAY,EAAE,MAAM,mBAAmB,CAAA;AAChD,OAAO,EAAE,eAAe,EAAE,MAAM,sBAAsB,CAAA;AACtD,OAAO,EAAE,kBAAkB,EAAE,MAAM,yBAAyB,CAAA;AAE5D,KAAK,wBAAwB,GAAG;IAC9B,OAAO,EAAE,MAAM,CAAA;IACf,IAAI,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAA;IAC5B,YAAY,EAAE,CAAC,MAAM,EAAE,MAAM,EAAE,KAAK,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;CACpE,CAAA;AAED;;GAEG;AACH,qBAAa,kBAAkB;IAS3B,OAAO,CAAC,QAAQ;IAChB,OAAO,CAAC,aAAa;IACrB,OAAO,CAAC,gBAAgB;IACxB,OAAO,CAAC,QAAQ;IAXlB;;;;;;OAMG;gBAEO,QAAQ,EAAE,cAAc,EACxB,aAAa,EAAE,YAAY,EAC3B,gBAAgB,EAAE,eAAe,EACjC,QAAQ,EAAE,kBAAkB;IAGtC;;;;;OAKG;IACG,IAAI,CAAC,MAAM,EAAE,wBAAwB,GAAG,MAAM,EAAE,YAAY,CAAC,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,eAAe,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IA8BpI;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,GAAG,EAAE,QAAQ,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,CAAC;IAwBvD;;;;;OAKG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,IAAI,CAAC;IAczF;;;OAGG;YACW,qBAAqB;IAoBnC;;;OAGG;YACW,qBAAqB;IAYnC;;;OAGG;YACW,gBAAgB;IAU9B;;;;OAIG;YACW,cAAc;IAY5B;;;OAGG;YACW,mBAAmB;IAmBjC;;;OAGG;YACW,4BAA4B;IAM1C;;;OAGG;YACW,uBAAuB;IAcrC;;;OAGG;YACW,0BAA0B;IAsBxC;;;OAGG;YACW,iBAAiB;IAoB/B;;;OAGG;YACW,gBAAgB;IAS9B;;;OAGG;YACW,wBAAwB;IActC;;;OAGG;YACW,mBAAmB;IAOjC;;;OAGG;YACW,qBAAqB;IAUnC;;;OAGG;YACW,2BAA2B;IASzC;;;OAGG;YACW,6BAA6B;IAW3C;;;OAGG;YACW,qBAAqB;IAmBnC;;;OAGG;YACW,mBAAmB;IAkBjC;;;;;OAKG;IACG,kBAAkB,CAAC,IAAI,EAAE,MAAM,EAAE,eAAe,CAAC,EAAE,GAAG,GAAG,OAAO,CAAC,MAAM,GAAG,IAAI,CAAC;IAqBrF;;;;OAIG;YACW,cAAc;IAgB5B;;;;OAIG;YACW,wBAAwB;IAYtC;;;;OAIG;YACW,kBAAkB;IAYhC;;;;OAIG;YACW,gBAAgB;IAe9B;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAS7B;;;;OAIG;IACH,OAAO,CAAC,UAAU;IAOlB;;;;;OAKG;IACH,OAAO,CAAC,oBAAoB;IAY5B;;;;;OAKG;IACH,OAAO,CAAC,kBAAkB;CAU3B;AAED,eAAe,kBAAkB,CAAA"}