browser-git-ops 0.0.0

package/dist/virtualfs/persistence.js

@@ -0,0 +1,294 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.BrowserStorage = exports.NodeFsStorage = void 0;
+const promises_1 = __importDefault(require("fs/promises"));
+const path_1 = __importDefault(require("path"));
+/**
+ * ファイルシステム上にデータを永続化する実装
+ */
+class NodeFsStorage {
+    dir;
+    indexPath;
+    /**
+     * NodeFsStorage を初期化します。
+     * @param {string} dir 永続化ディレクトリ
+     */
+    constructor(dir) {
+        this.dir = dir;
+        this.indexPath = path_1.default.join(this.dir, 'index.json');
+    }
+    /**
+     * ストレージ用ディレクトリを作成します。
+     * @returns {Promise<void>}
+     */
+    async init() {
+        await promises_1.default.mkdir(this.dir, { recursive: true });
+    }
+    /**
+     * index.json を読み込みます。存在しなければ null を返します。
+     * @returns {Promise<IndexFile|null>} 読み込んだ Index ファイル、または null
+     */
+    async readIndex() {
+        try {
+            const raw = await promises_1.default.readFile(this.indexPath, 'utf8');
+            return JSON.parse(raw);
+        }
+        catch (err) {
+            return null;
+        }
+    }
+    /**
+     * index.json を書き込みます。
+     * @param {IndexFile} index 書き込む Index データ
+     * @returns {Promise<void>}
+     */
+    async writeIndex(index) {
+        const data = JSON.stringify(index, null, 2);
+        await promises_1.default.writeFile(this.indexPath, data, 'utf8');
+    }
+    /**
+     * 指定パスへファイルを保存します。
+     * @param {string} filepath ファイルパス
+     * @param {string} content ファイル内容
+     * @returns {Promise<void>}
+     */
+    async writeBlob(filepath, content) {
+        const full = path_1.default.join(this.dir, filepath);
+        await promises_1.default.mkdir(path_1.default.dirname(full), { recursive: true });
+        await promises_1.default.writeFile(full, content, 'utf8');
+    }
+    /**
+     * 指定パスのファイルを読み出します。存在しなければ null を返します。
+     * @param {string} filepath ファイルパス
+     * @returns {Promise<string|null>} ファイル内容または null
+     */
+    async readBlob(filepath) {
+        try {
+            const full = path_1.default.join(this.dir, filepath);
+            return await promises_1.default.readFile(full, 'utf8');
+        }
+        catch (err) {
+            return null;
+        }
+    }
+    /**
+     * 指定パスのファイルを削除します。存在しない場合は無視されます。
+     * @param {string} filepath ファイルパス
+     * @returns {Promise<void>}
+     */
+    async deleteBlob(filepath) {
+        try {
+            const full = path_1.default.join(this.dir, filepath);
+            await promises_1.default.unlink(full);
+        }
+        catch (err) {
+            // ignore
+        }
+    }
+}
+exports.NodeFsStorage = NodeFsStorage;
+// BrowserStorage: use OPFS when available, otherwise IndexedDB
+/**
+ * ブラウザ環境向けの永続化実装: OPFS を優先し、無ければ IndexedDB を使用する
+ */
+class BrowserStorage {
+    dbName = 'apigit_storage';
+    dbPromise;
+    /**
+     * BrowserStorage を初期化します。内部で IndexedDB 接続を開始します。
+     */
+    constructor() {
+        this.dbPromise = this.openDb();
+    }
+    /**
+     * 初期化を待機します（IndexedDB の準備完了を待つ）。
+     * @returns {Promise<void>}
+     */
+    async init() {
+        await this.dbPromise;
+    }
+    /**
+     * IndexedDB を開き、データベースインスタンスを返します。
+     * @returns {Promise<IDBDatabase>}
+     */
+    openDb() {
+        return new Promise((resolve, reject) => {
+            const idb = globalThis.indexedDB;
+            if (!idb)
+                return reject(new Error('IndexedDB is not available'));
+            const req = idb.open(this.dbName, 1);
+            /**
+             * データベーススキーマの初期化
+             */
+            req.onupgradeneeded = (ev) => {
+                const db = ev.target.result;
+                if (!db.objectStoreNames.contains('blobs'))
+                    db.createObjectStore('blobs');
+                if (!db.objectStoreNames.contains('index'))
+                    db.createObjectStore('index');
+            };
+            // 成功時ハンドラ
+            /**
+             * ハンドラ（成功時） - 戻り値なし
+             * @returns {void}
+             */
+            req.onsuccess = () => resolve(req.result);
+            // エラー時ハンドラ
+            /**
+             * ハンドラ（エラー時） - 戻り値なし
+             * @returns {void}
+             */
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /**
+     * IndexedDB トランザクションをラップしてコールバックを実行します。
+     * @param {string} storeName ストア名
+     * @param {IDBTransactionMode} mode トランザクションモード
+     * @param {(store: IDBObjectStore)=>void|Promise<void>} cb 実行コールバック
+     * @returns {Promise<void>}
+     */
+    async tx(storeName, mode, cb) {
+        const db = await this.dbPromise;
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction(storeName, mode);
+            const storeObj = tx.objectStore(storeName);
+            Promise.resolve(cb(storeObj)).then(() => {
+                // トランザクション完了時ハンドラ
+                /**
+                 * トランザクション完了時のコールバック（内部処理）
+                 * @returns {void}
+                 */
+                tx.oncomplete = () => resolve();
+                // トランザクションエラー時ハンドラ
+                /**
+                 * トランザクションエラー時のコールバック（内部処理）
+                 * @returns {void}
+                 */
+                tx.onerror = () => reject(tx.error);
+            }).catch(reject);
+        });
+    }
+    /**
+     * index を IndexedDB から読み出します。
+     * @returns {Promise<IndexFile|null>} 読み込んだ Index ファイル、または null
+     */
+    async readIndex() {
+        const db = await this.dbPromise;
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction('index', 'readonly');
+            const store = tx.objectStore('index');
+            const req = store.get('index');
+            // onsuccess handler
+            /**
+             * onsuccess ハンドラ（内部処理） - 戻り値なし
+             * @returns {void}
+             */
+            req.onsuccess = () => resolve(req.result ?? null);
+            // onerror handler
+            /**
+             * onerror ハンドラ（内部処理） - 戻り値なし
+             * @returns {void}
+             */
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /**
+     * index を IndexedDB に書き込みます。
+     * @param {IndexFile} index 書き込むデータ
+     * @returns {Promise<void>}
+     */
+    async writeIndex(index) {
+        await this.tx('index', 'readwrite', (store) => { store.put(index, 'index'); });
+    }
+    /**
+     * blob を書き込みます。OPFS がある場合は OPFS を優先して使用します。
+     * @param {string} filepath ファイルパス
+     * @param {string} content ファイル内容
+     * @returns {Promise<void>}
+     */
+    async writeBlob(filepath, content) {
+        // try OPFS if available
+        // @ts-ignore
+        const opfs = globalThis.originPrivateFileSystem;
+        if (opfs && opfs.getFileHandle) {
+            try {
+                // naive OPFS write
+                // @ts-ignore
+                const root = await opfs.getDirectory();
+                const parts = filepath.split('/');
+                let dir = root;
+                for (let i = 0; i < parts.length - 1; i++) {
+                    dir = await dir.getDirectory(parts[i]);
+                }
+                const fh = await dir.getFileHandle(parts[parts.length - 1], { create: true });
+                const writable = await fh.createWritable();
+                await writable.write(content);
+                await writable.close();
+                return;
+            }
+            catch (e) {
+                // fallthrough to indexeddb
+            }
+        }
+        await this.tx('blobs', 'readwrite', (store) => { store.put(content, filepath); });
+    }
+    /**
+     * 指定パスの blob を読み出します。存在しなければ null を返します。
+     * @param {string} filepath ファイルパス
+     * @returns {Promise<string|null>} ファイル内容または null
+     */
+    async readBlob(filepath) {
+        // try OPFS read
+        // @ts-ignore
+        const opfs = globalThis.originPrivateFileSystem;
+        if (opfs && opfs.getFileHandle) {
+            try {
+                // @ts-ignore
+                const root = await opfs.getDirectory();
+                const parts = filepath.split('/');
+                let dir = root;
+                for (let i = 0; i < parts.length - 1; i++) {
+                    dir = await dir.getDirectory(parts[i]);
+                }
+                const fh = await dir.getFileHandle(parts[parts.length - 1]);
+                const file = await fh.getFile();
+                return await file.text();
+            }
+            catch (e) {
+                // fallback
+            }
+        }
+        const db = await this.dbPromise;
+        return new Promise((resolve, reject) => {
+            const tx = db.transaction('blobs', 'readonly');
+            const store = tx.objectStore('blobs');
+            const req = store.get(filepath);
+            // onsuccess handler
+            /**
+             * onsuccess ハンドラ（内部処理） - 戻り値なし
+             * @returns {void}
+             */
+            req.onsuccess = () => resolve(req.result ?? null);
+            // onerror handler
+            /**
+             * onerror ハンドラ（内部処理） - 戻り値なし
+             * @returns {void}
+             */
+            req.onerror = () => reject(req.error);
+        });
+    }
+    /**
+     * 指定パスの blob を削除します。
+     * @param {string} filepath ファイルパス
+     * @returns {Promise<void>}
+     */
+    async deleteBlob(filepath) {
+        // delete from IndexedDB
+        await this.tx('blobs', 'readwrite', (store) => { store.delete(filepath); });
+    }
+}
+exports.BrowserStorage = BrowserStorage;

package/dist/virtualfs/types.d.ts

@@ -0,0 +1,46 @@
+export type FileState = 'base' | 'modified' | 'added' | 'deleted' | 'conflict';
+export interface IndexEntry {
+    path: string;
+    state: FileState;
+    baseSha?: string;
+    workspaceSha?: string;
+    updatedAt: number;
+}
+export interface IndexFile {
+    head: string;
+    lastCommitKey?: string;
+    entries: Record<string, IndexEntry>;
+}
+export interface TombstoneEntry {
+    path: string;
+    baseSha: string;
+    deletedAt: number;
+}
+export interface ConflictEntry {
+    path: string;
+    baseSha?: string;
+    remoteSha?: string;
+    workspaceSha?: string;
+}
+export type Change = {
+    type: 'create';
+    path: string;
+    content: string;
+} | {
+    type: 'update';
+    path: string;
+    content: string;
+    baseSha: string;
+} | {
+    type: 'delete';
+    path: string;
+    baseSha: string;
+};
+export interface CommitInput {
+    message: string;
+    parentSha: string;
+    changes: Change[];
+    ref?: string;
+    commitKey?: string;
+}
+//# sourceMappingURL=types.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"types.d.ts","sourceRoot":"","sources":["../../src/virtualfs/types.ts"],"names":[],"mappings":"AAAA,MAAM,MAAM,SAAS,GAAG,MAAM,GAAG,UAAU,GAAG,OAAO,GAAG,SAAS,GAAG,UAAU,CAAA;AAE9E,MAAM,WAAW,UAAU;IACzB,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,SAAS,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,YAAY,CAAC,EAAE,MAAM,CAAA;IACrB,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,SAAS;IACxB,IAAI,EAAE,MAAM,CAAA;IAEZ,aAAa,CAAC,EAAE,MAAM,CAAA;IACtB,OAAO,EAAE,MAAM,CAAC,MAAM,EAAE,UAAU,CAAC,CAAA;CACpC;AAED,MAAM,WAAW,cAAc;IAC7B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,aAAa;IAC5B,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,SAAS,CAAC,EAAE,MAAM,CAAA;IAClB,YAAY,CAAC,EAAE,MAAM,CAAA;CACtB;AAED,MAAM,MAAM,MAAM,GACd;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GACjD;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,GAClE;IAAE,IAAI,EAAE,QAAQ,CAAC;IAAC,IAAI,EAAE,MAAM,CAAC;IAAC,OAAO,EAAE,MAAM,CAAA;CAAE,CAAA;AAErD,MAAM,WAAW,WAAW;IAC1B,OAAO,EAAE,MAAM,CAAA;IACf,SAAS,EAAE,MAAM,CAAA;IACjB,OAAO,EAAE,MAAM,EAAE,CAAA;IACjB,GAAG,CAAC,EAAE,MAAM,CAAA;IAEZ,SAAS,CAAC,EAAE,MAAM,CAAA;CACnB"}

package/dist/virtualfs/types.js

@@ -0,0 +1,2 @@
+"use strict";
+Object.defineProperty(exports, "__esModule", { value: true });

package/dist/virtualfs/virtualfs.d.ts

@@ -0,0 +1,189 @@
+import { IndexFile, TombstoneEntry } from './types';
+import { StorageBackend } from './persistence';
+/**
+ *
+ */
+export declare class VirtualFS {
+    private storageDir;
+    private base;
+    private workspace;
+    private tombstones;
+    private index;
+    private backend;
+    /**
+     *
+     */
+    constructor(options?: {
+        storageDir?: string;
+        backend?: StorageBackend;
+    });
+    /**
+     * コンテンツから SHA1 を計算します。
+     * @param {string} content コンテンツ
+     * @returns {string} 計算された SHA
+     */
+    private shaOf;
+    /**
+     * VirtualFS の初期化を行います（バックエンド初期化と index 読み込み）。
+     * @returns {Promise<void>}
+     */
+    init(): Promise<void>;
+    /**
+     * 永続化レイヤーから index を読み込み、内部マップを初期化します。
+     * @returns {Promise<void>}
+     */
+    private loadIndex;
+    /**
+     * 内部インデックスを永続化します。
+     * @returns {Promise<void>}
+     */
+    private saveIndex;
+    /**
+     *
+     */
+    /**
+     * ワークスペースにファイルを書き込みます（ローカル編集）。
+     * @param {string} filepath ファイルパス
+     * @param {string} content コンテンツ
+     * @returns {Promise<void>}
+     */
+    writeWorkspace(filepath: string, content: string): Promise<void>;
+    /**
+     * ワークスペース上のファイルを削除します（トゥームストーン作成を含む）。
+     * @param {string} filepath ファイルパス
+     * @returns {Promise<void>}
+     */
+    deleteWorkspace(filepath: string): Promise<void>;
+    /**
+     * rename を delete + create の合成で行うヘルパ
+     * @param from 元パス
+     * @param to 新パス
+     */
+    renameWorkspace(from: string, to: string): Promise<void>;
+    /**
+     * ワークスペース/ベースからファイル内容を読み出します。
+     * @param {string} filepath ファイルパス
+     * @returns {Promise<string|null>} ファイル内容または null
+     */
+    readWorkspace(filepath: string): Promise<string | null>;
+    /**
+     * リモートのベーススナップショットを適用します。
+     * @param {{[path:string]:string}} snapshot path->content のマップ
+     * @param {string} headSha リモート HEAD
+     * @returns {Promise<void>}
+     */
+    applyBaseSnapshot(snapshot: Record<string, string>, headSha: string): Promise<void>;
+    /**
+     * インデックス情報を返します。
+     * @returns {IndexFile}
+     */
+    getIndex(): IndexFile;
+    /**
+     * 登録されているパス一覧を返します。
+     * @returns {string[]}
+     */
+    listPaths(): string[];
+    /**
+     * tombstone を返します。
+     * @returns {TombstoneEntry[]}
+     */
+    getTombstones(): TombstoneEntry[];
+    /**
+     * tombstone を返します。
+     * @returns {TombstoneEntry[]}
+     */
+    /**
+     *
+     */
+    getChangeSet(): Promise<({
+        type: 'create';
+        path: string;
+        content: string;
+    } | {
+        type: 'update';
+        path: string;
+        content: string;
+        baseSha?: string | undefined;
+    } | {
+        type: 'delete';
+        path: string;
+        baseSha: string;
+    })[]>;
+    /**
+     * tombstone からの削除変更リストを生成します。
+     * @returns {Array<{type:'delete',path:string,baseSha:string}>}
+     */
+    private _changesFromTombstones;
+    /**
+     * index entries から create/update の変更リストを生成します。
+     * @returns {Array<{type:'create'|'update',path:string,content:string,baseSha?:string}>}
+     */
+    private _changesFromIndexEntries;
+    /**
+     * 追加状態のエントリから create 変更を生成します。
+     * @returns {Array<{type:'create',path:string,content:string}>}
+     */
+    private _changesFromAddedEntries;
+    /**
+     * 変更状態のエントリから update 変更を生成します。
+     * @returns {Array<{type:'update',path:string,content:string,baseSha:string}>}
+     */
+    private _changesFromModifiedEntries;
+    /**
+     * リモートスナップショットからの差分取り込み時に、単一パスを評価して
+     * 必要なら conflicts に追加、もしくは base を更新します。
+     * @returns {Promise<void>}
+     */
+    private _handleRemotePath;
+    /**
+     * リモートに存在するがローカルにないパスを処理します。
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteNew;
+    /**
+     * リモートに存在し、かつローカルにエントリがあるパスを処理します。
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteExisting;
+    /**
+     * ローカルに対する変更（create/update/delete）を適用するヘルパー
+     * @param {any} ch 変更オブジェクト
+     * @returns {Promise<void>}
+     */
+    private _applyChangeLocally;
+    /**
+     * リモート側で削除されたエントリをローカルに反映します。
+     * @returns {Promise<void>}
+     */
+    private _handleRemoteDeletion;
+    /**
+     * GitLab 風の actions ベースコミットフローで push を実行します。
+     * @returns {Promise<{commitSha:string}>}
+     */
+    private _pushWithActions;
+    /**
+     * GitHub 風の blob/tree/commit フローで push を実行します。
+     * @returns {Promise<{commitSha:string}>}
+     */
+    private _pushWithGitHubFlow;
+    /**
+     * リモートのスナップショットを取り込み、コンフリクト情報を返します。
+     * @param {string} remoteHead リモート HEAD
+     * @param {{[path:string]:string}} baseSnapshot path->content マップ
+     * @returns {Promise<{conflicts:Array<import('./types').ConflictEntry>}>}
+     */
+    pull(remoteHead: string, baseSnapshot: Record<string, string>): Promise<{
+        conflicts: import("./types").ConflictEntry[];
+    }>;
+    /**
+     * 変更をコミットしてリモートへ反映します。adapter が無ければローカルシミュレーションします。
+     * @param {import('./types').CommitInput} input コミット入力
+     * @param {import('../git/adapter').GitAdapter} [adapter] 任意のアダプタ
+     * @returns {Promise<{commitSha:string}>}
+     */
+    push(input: import('./types').CommitInput, adapter?: import('../git/adapter').GitAdapter): Promise<{
+        commitSha: any;
+    }>;
+}
+export default VirtualFS;
+//# sourceMappingURL=virtualfs.d.ts.map

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

@@ -0,0 +1 @@
+{"version":3,"file":"virtualfs.d.ts","sourceRoot":"","sources":["../../src/virtualfs/virtualfs.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,SAAS,EAAE,cAAc,EAAE,MAAM,SAAS,CAAA;AACnD,OAAO,EAAE,cAAc,EAAiB,MAAM,eAAe,CAAA;AAE7D;;GAEG;AACH,qBAAa,SAAS;IACpB,OAAO,CAAC,UAAU,CAAoB;IACtC,OAAO,CAAC,IAAI,CAAsD;IAClE,OAAO,CAAC,SAAS,CAAsD;IACvE,OAAO,CAAC,UAAU,CAAoC;IACtD,OAAO,CAAC,KAAK,CAAuC;IACpD,OAAO,CAAC,OAAO,CAAgB;IAE/B;;OAEG;gBACS,OAAO,CAAC,EAAE;QAAE,UAAU,CAAC,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,cAAc,CAAA;KAAE;IAOvE;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;OAGG;IACG,IAAI;IAKV;;;OAGG;YACW,SAAS;IAmBvB;;;OAGG;YACW,SAAS;IAIvB;;OAEG;IACH;;;;;OAKG;IACG,cAAc,CAAC,QAAQ,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAkBtD;;;;OAIG;IACG,eAAe,CAAC,QAAQ,EAAE,MAAM;IAqBtC;;;;OAIG;IACG,eAAe,CAAC,IAAI,EAAE,MAAM,EAAE,EAAE,EAAE,MAAM;IAa9C;;;;OAIG;IACG,aAAa,CAAC,QAAQ,EAAE,MAAM;IAWpC;;;;;OAKG;IACG,iBAAiB,CAAC,QAAQ,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,EAAE,MAAM;IA2BzE;;;OAGG;IACH,QAAQ,IAAI,SAAS;IAIrB;;;OAGG;IACH,SAAS,IAAI,MAAM,EAAE;IAIrB;;;OAGG;IACH,aAAa,IAAI,cAAc,EAAE;IAIjC;;;OAGG;IAEH;;OAEG;IACG,YAAY;cAGJ,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;cACvC,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;;cACvC,QAAQ;cAAQ,MAAM;iBAAW,MAAM;;IAQrD;;;OAGG;IACH,OAAO,CAAC,sBAAsB;IAM9B;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAOhC;;;OAGG;IACH,OAAO,CAAC,wBAAwB;IAWhC;;;OAGG;IACH,OAAO,CAAC,2BAA2B;IAWnC;;;;OAIG;YACW,iBAAiB;IAS/B;;;OAGG;YACW,gBAAgB;IAa9B;;;OAGG;YACW,qBAAqB;IAkBnC;;;;OAIG;YACW,mBAAmB;IAqBjC;;;OAGG;YACW,qBAAqB;IAYnC;;;OAGG;YACW,gBAAgB;IAe9B;;;OAGG;YACW,mBAAmB;IAkBjC;;;;;OAKG;IACG,IAAI,CAAC,UAAU,EAAE,MAAM,EAAE,YAAY,EAAE,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC;;;IA6BnE;;;;;OAKG;IACG,IAAI,CAAC,KAAK,EAAE,OAAO,SAAS,EAAE,WAAW,EAAE,OAAO,CAAC,EAAE,OAAO,gBAAgB,EAAE,UAAU;;;CAkD/F;AAED,eAAe,SAAS,CAAA"}