browser-git-ops 0.0.0

package/LICENSE

@@ -0,0 +1,21 @@
+MIT License
+
+Copyright (c) 2026 nojaja
+
+Permission is hereby granted, free of charge, to any person obtaining a copy
+of this software and associated documentation files (the "Software"), to deal
+in the Software without restriction, including without limitation the rights
+to use, copy, modify, merge, publish, distribute, sublicense, and/or sell
+copies of the Software, and to permit persons to whom the Software is
+furnished to do so, subject to the following conditions:
+
+The above copyright notice and this permission notice shall be included in all
+copies or substantial portions of the Software.
+
+THE SOFTWARE IS PROVIDED "AS IS", WITHOUT WARRANTY OF ANY KIND, EXPRESS OR
+IMPLIED, INCLUDING BUT NOT LIMITED TO THE WARRANTIES OF MERCHANTABILITY,
+FITNESS FOR A PARTICULAR PURPOSE AND NONINFRINGEMENT. IN NO EVENT SHALL THE
+AUTHORS OR COPYRIGHT HOLDERS BE LIABLE FOR ANY CLAIM, DAMAGES OR OTHER
+LIABILITY, WHETHER IN AN ACTION OF CONTRACT, TORT OR OTHERWISE, ARISING FROM,
+OUT OF OR IN CONNECTION WITH THE SOFTWARE OR THE USE OR OTHER DEALINGS IN THE
+SOFTWARE.

package/README.md

@@ -0,0 +1,146 @@
+# browser-git-ops
+
+**目的**: ブラウザネイティブ環境（OPFS + Github/Gitlab APIs）で動作する軽量な Git 操作ライブラリを提供します。VirtualFS によるローカル差分生成と、GitHub/GitLab 向けのアダプタを通じたリモート操作を抽象化します。
+
+**主な特徴**
+- **仮想ファイルシステム (VirtualFS)**: ローカルワークスペースとベーススナップショットを管理し、変更セット（create/update/delete）を生成します。
+- **Git アダプタ抽象**: `GitAdapter` インターフェースに準拠するアダプタで GitHub/GitLab API を操作できます（サンプル実装あり）。
+- **Idempotent push**: commitKey による冪等処理サポート。
+- **衝突検知とマージ補助**: リモート差分取り込み時にローカルの未コミット変更を検出して conflicts を報告します。
+
+**注意（⚠️）**: 実装はユーティリティ/ライブラリ向けで、環境やアクセストークンの管理、エラーハンドリング方針は利用側で制御してください。
+
+**プロジェクト構成（抜粋）**
+- **src/virtualfs/virtualfs.ts**: VirtualFS 本体（初期化、read/write、push/pull、差分生成） - [src/virtualfs/virtualfs.ts](src/virtualfs/virtualfs.ts)
+- **src/virtualfs/persistence.ts**: ストレージバックエンドの抽象と Node 用実装 - [src/virtualfs/persistence.ts](src/virtualfs/persistence.ts)
+- **src/git/adapter.ts**: `GitAdapter` インターフェース定義 - [src/git/adapter.ts](src/git/adapter.ts)
+- **src/git/githubAdapter.ts**: GitHub 用アダプタ（blob/tree/commit フロー、再試行ロジック） - [src/git/githubAdapter.ts](src/git/githubAdapter.ts)
+- **test/**: ユニット／E2E テスト群（Jest / Playwright） - [test](test)
+
+**技術スタック**
+- TypeScript 5.x
+- Node.js (ESM, `type: "module"`)
+- テスト: Jest（unit） / Playwright（E2E）
+- ビルド: `tsc`
+
+--------------------------------------------------
+**クイックスタート（開発用）**
+
+1. 依存インストール
+
+```bash
+npm ci
+```
+
+2. ユニットテスト実行
+
+```bash
+npm run test
+```
+
+3. E2E テスト（Playwright）
+
+```bash
+npm run test:e2e
+```
+
+4. ビルド
+
+```bash
+npm run build
+```
+
+--------------------------------------------------
+**ライブラリ利用ガイド（Library Usage）**
+
+下記はライブラリの代表的な使い方（TypeScript）です。詳しい実装は各ファイルを参照してください。
+
+例: `VirtualFS` を初期化してローカル編集を push する
+
+```ts
+import VirtualFS from './src/virtualfs/virtualfs'
+import GitHubAdapter from './src/git/githubAdapter'
+
+async function example() {
+  const vfs = new VirtualFS({ storageDir: '.apigit' })
+  await vfs.init()
+
+  // ワークスペース編集
+  await vfs.writeWorkspace('foo.txt', 'hello')
+
+  // 変更セット取得
+  const changes = await vfs.getChangeSet()
+
+  // GitHub アダプタを使って push
+  const gh = new GitHubAdapter({ owner: 'ORG', repo: 'REPO', token: process.env.GH_TOKEN })
+  const res = await vfs.push({ parentSha: vfs.getIndex().head, message: 'update', changes }, gh as any)
+  console.log('commitSha', res.commitSha)
+}
+```
+
+API の概略（主要メソッド）
+- `new VirtualFS(options?)` - オプション: `{ storageDir?: string, backend?: StorageBackend }`
+- `init()` - バックエンド初期化と index 読み込み
+- `writeWorkspace(filepath, content)` - ワークスペースにファイルを書き込む
+- `deleteWorkspace(filepath)` - ワークスペース上のファイルを削除（トゥームストーン管理）
+- `renameWorkspace(from, to)` - rename（内部では delete + create）
+- `readWorkspace(filepath)` - ワークスペース/ベースから内容を読み出す
+- `applyBaseSnapshot(snapshot, headSha)` - リモートスナップショットを適用
+- `getIndex()` - 現在の index を返す
+- `listPaths()` - 登録パス一覧
+- `getChangeSet()` - create/update/delete の配列を生成
+- `pull(remoteHead, baseSnapshot)` - リモート差分取り込み（conflicts を返す）
+- `push(input, adapter?)` - 変更をコミットし（adapter があれば）リモートへ反映
+
+GitAdapter インターフェース（`src/git/adapter.ts`）
+- `createBlobs(changes, concurrency?)` -> Promise<Record<string,string>>
+- `createTree(changes, baseTreeSha?)` -> Promise<string>
+- `createCommit(message, parentSha, treeSha)` -> Promise<string>
+- `updateRef(ref, commitSha, force?)` -> Promise<void>
+
+実装済みアダプタの注意点:
+- `GitHubAdapter` は `blob/tree/commit` フローを実装し、HTTP 再試行ロジックを内蔵しています（5xx, 429 のリトライ等）。実装は [src/git/githubAdapter.ts](src/git/githubAdapter.ts) を参照してください。
+- GitLab 用実装はリポジトリ内に存在しますが、環境差異により API の振る舞いが異なるため本番運用前に検証してください。⚠️
+
+--------------------------------------------------
+**開発セットアップ**
+- Node: 任意の recent Node.js（ESM サポート済み）
+- 実行手順
+
+```bash
+git clone <repo>
+cd APIGitWorkspace01
+npm ci
+```
+
+- コマンド一覧
+  - `npm run test` : ユニットテスト（Jest）
+  - `npm run test:e2e` : Playwright E2E
+  - `npm run lint` : ESLint
+  - `npm run build` : TypeScript ビルド
+
+テスト関連の注意:
+- Jest は ESM を扱うため `node --experimental-vm-modules` を使用するスクリプトが package.json に設定されています。
+
+--------------------------------------------------
+**現在のステータス**
+- 実装済み: `VirtualFS` のコア機能（差分生成、push/pull シミュレーション、index 管理）、`GitHubAdapter` の主要な API 呼び出し。
+- テスト: unit テストと一部の E2E テストが含まれています（`test/` 配下）。
+- 未確定/要検証: 外部サービス（GitLab）の細かい API 挙動、production 用のエラー・認可ポリシー。
+
+--------------------------------------------------
+**ライセンスとメタデータ**
+- package name: `browser-git-ops`
+- version: `0.0.0`
+- module type: CommonJS (`type: commonjs`)
+- License: MIT License
+
+--------------------------------------------------
+追加で欲しいもの
+- サンプルユースケースを示す小さなサンプルリポジトリまたは `examples/` ディレクトリ
+
+
+--------------------------------------------------
+貢献・問い合わせ
+- PR/Issue を歓迎します。まず issue を立て、簡単な実装提案（変更点の概要）を添えてください。
+

package/dist/git/adapter.d.ts

@@ -0,0 +1,16 @@
+export interface Change {
+    type: 'create' | 'update' | 'delete';
+    path: string;
+    content?: string;
+    baseSha?: string;
+}
+export interface CommitResult {
+    commitSha: string;
+}
+export interface GitAdapter {
+    createBlobs(_changes: Change[], _concurrency?: number): Promise<Record<string, string>>;
+    createTree(_changes: Change[], _baseTreeSha?: string): Promise<string>;
+    createCommit(_message: string, _parentSha: string, _treeSha: string): Promise<string>;
+    updateRef(_ref: string, _commitSha: string, _force?: boolean): Promise<void>;
+}
+//# sourceMappingURL=adapter.d.ts.map

package/dist/git/adapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"adapter.d.ts","sourceRoot":"","sources":["../../src/git/adapter.ts"],"names":[],"mappings":"AAAA,MAAM,WAAW,MAAM;IACrB,IAAI,EAAE,QAAQ,GAAG,QAAQ,GAAG,QAAQ,CAAA;IACpC,IAAI,EAAE,MAAM,CAAA;IACZ,OAAO,CAAC,EAAE,MAAM,CAAA;IAChB,OAAO,CAAC,EAAE,MAAM,CAAA;CACjB;AAED,MAAM,WAAW,YAAY;IAC3B,SAAS,EAAE,MAAM,CAAA;CAClB;AAED,MAAM,WAAW,UAAU;IAEzB,WAAW,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,MAAM,EAAE,MAAM,CAAC,CAAC,CAAA;IAEvF,UAAU,CAAC,QAAQ,EAAE,MAAM,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAEtE,YAAY,CAAC,QAAQ,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC,CAAA;IAErF,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,CAAC,EAAE,OAAO,GAAG,OAAO,CAAC,IAAI,CAAC,CAAA;CAC7E"}

package/dist/git/adapter.js

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

package/dist/git/githubAdapter.d.ts

@@ -0,0 +1,50 @@
+import { GitAdapter } from './adapter';
+type GHOptions = {
+    owner: string;
+    repo: string;
+    token: string;
+};
+/**
+ * リトライ可能なエラー。
+ */
+export declare class RetryableError extends Error {
+}
+/**
+ * リトライ不可能なエラー。
+ */
+export declare class NonRetryableError extends Error {
+}
+/**
+ * fetch を再試行付きで実行するユーティリティ。
+ * 5xx や 429 はリトライ対象、それ以外は NonRetryableError を投げる。
+ * @param input RequestInfo
+ * @param init RequestInit
+ * @param attempts 試行回数
+ * @param baseDelay ベースの遅延(ms)
+ */
+declare function fetchWithRetry(input: RequestInfo, init: RequestInit, attempts?: number, baseDelay?: number): Promise<Response>;
+declare function classifyStatus(status: number): boolean;
+declare function getDelayForResponse(res: Response | null, i: number, baseDelay: number): number;
+declare function processResponseWithDelay(res: Response, i: number, baseDelay: number): Promise<Response>;
+/**
+ * 非同期マップを並列実行するユーティリティ
+ * @param items 入力配列
+ * @param mapper マッピング関数
+ * @param concurrency 同時実行数
+ */
+declare function mapWithConcurrency<T, R>(items: T[], mapper: (_t: T) => Promise<R>, concurrency?: number): Promise<R[]>;
+export declare class GitHubAdapter implements GitAdapter {
+    private opts;
+    private baseUrl;
+    private headers;
+    private _fetchWithRetry;
+    private blobCache;
+    constructor(opts: GHOptions);
+    createBlobs(changes: any[], concurrency?: number): Promise<Record<string, string>>;
+    createTree(changes: any[], baseTreeSha?: string): Promise<string>;
+    createCommit(message: string, parentSha: string, treeSha: string): Promise<string>;
+    updateRef(ref: string, commitSha: string, force?: boolean): Promise<void>;
+}
+export { fetchWithRetry, classifyStatus, getDelayForResponse, processResponseWithDelay, mapWithConcurrency };
+export default GitHubAdapter;
+//# sourceMappingURL=githubAdapter.d.ts.map

package/dist/git/githubAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"githubAdapter.d.ts","sourceRoot":"","sources":["../../src/git/githubAdapter.ts"],"names":[],"mappings":"AACA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAGtC,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;CACd,CAAA;AAED;;GAEG;AACH,qBAAa,cAAe,SAAQ,KAAK;CAAG;AAE5C;;GAEG;AACH,qBAAa,iBAAkB,SAAQ,KAAK;CAAG;AAU/C;;;;;;;GAOG;AAEH,iBAAe,cAAc,CAAC,KAAK,EAAE,WAAW,EAAE,IAAI,EAAE,WAAW,EAAE,QAAQ,SAAI,EAAE,SAAS,SAAM,qBAcjG;AAED,iBAAS,cAAc,CAAC,MAAM,EAAE,MAAM,WAErC;AAED,iBAAS,mBAAmB,CAAC,GAAG,EAAE,QAAQ,GAAG,IAAI,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,UAI9E;AAED,iBAAe,wBAAwB,CAAC,GAAG,EAAE,QAAQ,EAAE,CAAC,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,qBAQlF;AAED;;;;;GAKG;AAEH,iBAAS,kBAAkB,CAAC,CAAC,EAAE,CAAC,EAAE,KAAK,EAAE,CAAC,EAAE,EAAE,MAAM,EAAE,CAAC,EAAE,EAAE,CAAC,KAAK,OAAO,CAAC,CAAC,CAAC,EAAE,WAAW,SAAI,gBAc3F;AAED,qBAAa,aAAc,YAAW,UAAU;IAMlC,OAAO,CAAC,IAAI;IALxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,eAAe,CAAqF;IAE5G,OAAO,CAAC,SAAS,CAAiC;gBAC9B,IAAI,EAAE,SAAS;IAU7B,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,SAAI;IAqB3C,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM;IAkB/C,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAQhE,SAAS,CAAC,GAAG,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,UAAQ;CAQ9D;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,CAAA;AAC5G,eAAe,aAAa,CAAA"}

package/dist/git/githubAdapter.js

@@ -0,0 +1,179 @@
+"use strict";
+var __importDefault = (this && this.__importDefault) || function (mod) {
+    return (mod && mod.__esModule) ? mod : { "default": mod };
+};
+Object.defineProperty(exports, "__esModule", { value: true });
+exports.mapWithConcurrency = exports.processResponseWithDelay = exports.getDelayForResponse = exports.classifyStatus = exports.fetchWithRetry = exports.GitHubAdapter = exports.NonRetryableError = exports.RetryableError = void 0;
+const crypto_1 = __importDefault(require("crypto"));
+/**
+ * リトライ可能なエラー。
+ */
+class RetryableError extends Error {
+}
+exports.RetryableError = RetryableError;
+/**
+ * リトライ不可能なエラー。
+ */
+class NonRetryableError extends Error {
+}
+exports.NonRetryableError = NonRetryableError;
+/**
+ * 指定ミリ秒だけ sleep するユーティリティ
+ * @param ms ミリ秒
+ */
+function sleep(ms) {
+    return new Promise((res) => setTimeout(res, ms));
+}
+/**
+ * fetch を再試行付きで実行するユーティリティ。
+ * 5xx や 429 はリトライ対象、それ以外は NonRetryableError を投げる。
+ * @param input RequestInfo
+ * @param init RequestInit
+ * @param attempts 試行回数
+ * @param baseDelay ベースの遅延(ms)
+ */
+/* istanbul ignore next */
+async function fetchWithRetry(input, init, attempts = 4, baseDelay = 300) {
+    let lastErr;
+    for (let i = 0; i < attempts; i++) {
+        try {
+            const res = await fetch(input, init);
+            return await processResponseWithDelay(res, i, baseDelay);
+            /* istanbul ignore next */
+        }
+        catch (err) {
+            if (err instanceof NonRetryableError)
+                throw err;
+            lastErr = err;
+            await sleep(getDelayForResponse(null, i, baseDelay));
+        }
+    }
+    throw new RetryableError(`Failed after ${attempts} attempts: ${lastErr}`);
+}
+exports.fetchWithRetry = fetchWithRetry;
+function classifyStatus(status) {
+    return status >= 500 || status === 429;
+}
+exports.classifyStatus = classifyStatus;
+function getDelayForResponse(res, i, baseDelay) {
+    if (!res)
+        return baseDelay * Math.pow(2, i) + Math.random() * 100;
+    const retryAfter = res.headers.get('Retry-After');
+    return retryAfter ? Number(retryAfter) * 1000 : baseDelay * Math.pow(2, i) + Math.random() * 100;
+}
+exports.getDelayForResponse = getDelayForResponse;
+async function processResponseWithDelay(res, i, baseDelay) {
+    if (res.ok)
+        return res;
+    if (classifyStatus(res.status)) {
+        await sleep(getDelayForResponse(res, i, baseDelay));
+        throw new RetryableError(`HTTP ${res.status}`);
+    }
+    const txt = await res.text().catch(() => '');
+    throw new NonRetryableError(`HTTP ${res.status}: ${txt}`);
+}
+exports.processResponseWithDelay = processResponseWithDelay;
+/**
+ * 非同期マップを並列実行するユーティリティ
+ * @param items 入力配列
+ * @param mapper マッピング関数
+ * @param concurrency 同時実行数
+ */
+/* istanbul ignore next */
+function mapWithConcurrency(items, mapper, concurrency = 5) {
+    const results = [];
+    let idx = 0;
+    const runners = [];
+    const run = async () => {
+        while (idx < items.length) {
+            const i = idx++;
+            if (i >= items.length)
+                break;
+            const r = await mapper(items[i]);
+            results[i] = r;
+        }
+    };
+    for (let i = 0; i < Math.min(concurrency, items.length); i++)
+        runners.push(run());
+    return Promise.all(runners).then(() => results);
+}
+exports.mapWithConcurrency = mapWithConcurrency;
+class GitHubAdapter {
+    opts;
+    baseUrl;
+    headers;
+    _fetchWithRetry;
+    // simple in-memory blob cache: contentSha -> blobSha
+    blobCache = new Map();
+    constructor(opts) {
+        this.opts = opts;
+        this.baseUrl = `https://api.github.com/repos/${opts.owner}/${opts.repo}`;
+        this.headers = {
+            Authorization: `token ${opts.token}`,
+            Accept: 'application/vnd.github+json',
+            'Content-Type': 'application/json',
+        };
+        this._fetchWithRetry = fetchWithRetry;
+    }
+    async createBlobs(changes, concurrency = 5) {
+        const tasks = changes.filter((c) => c.type === 'create' || c.type === 'update');
+        const mapper = async (ch) => {
+            // compute simple content hash to enable cache lookup
+            const contentHash = crypto_1.default.createHash('sha1').update(ch.content || '', 'utf8').digest('hex');
+            const cached = this.blobCache.get(contentHash);
+            if (cached)
+                return { path: ch.path, sha: cached };
+            const body = JSON.stringify({ content: ch.content, encoding: 'utf-8' });
+            const res = await this._fetchWithRetry(`${this.baseUrl}/git/blobs`, { method: 'POST', headers: this.headers, body }, 4, 300);
+            const j = await res.json();
+            if (!j.sha)
+                throw new NonRetryableError('blob response missing sha');
+            this.blobCache.set(contentHash, j.sha);
+            return { path: ch.path, sha: j.sha };
+        };
+        const results = await mapWithConcurrency(tasks, mapper, concurrency);
+        const map = {};
+        for (const r of results)
+            map[r.path] = r.sha;
+        return map;
+    }
+    async createTree(changes, baseTreeSha) {
+        const tree = [];
+        for (const c of changes) {
+            if (c.type === 'delete') {
+                tree.push({ path: c.path, mode: '100644', sha: null });
+            }
+            else {
+                if (!c.blobSha)
+                    throw new NonRetryableError(`missing blobSha for ${c.path}`);
+                tree.push({ path: c.path, mode: '100644', type: 'blob', sha: c.blobSha });
+            }
+        }
+        const body = { tree };
+        if (baseTreeSha)
+            body.base_tree = baseTreeSha;
+        const res = await this._fetchWithRetry(`${this.baseUrl}/git/trees`, { method: 'POST', headers: this.headers, body: JSON.stringify(body) }, 4, 300);
+        const j = await res.json();
+        if (!j.sha)
+            throw new NonRetryableError('createTree response missing sha');
+        return j.sha;
+    }
+    async createCommit(message, parentSha, treeSha) {
+        const body = JSON.stringify({ message, tree: treeSha, parents: [parentSha] });
+        const res = await this._fetchWithRetry(`${this.baseUrl}/git/commits`, { method: 'POST', headers: this.headers, body }, 4, 300);
+        const j = await res.json();
+        if (!j.sha)
+            throw new NonRetryableError('createCommit response missing sha');
+        return j.sha;
+    }
+    async updateRef(ref, commitSha, force = false) {
+        const body = JSON.stringify({ sha: commitSha, force });
+        const res = await this._fetchWithRetry(`${this.baseUrl}/git/refs/${ref}`, { method: 'PATCH', headers: this.headers, body }, 4, 300);
+        if (!res.ok) {
+            const txt = await res.text().catch(() => '');
+            throw new NonRetryableError(`updateRef failed: ${res.status} ${txt}`);
+        }
+    }
+}
+exports.GitHubAdapter = GitHubAdapter;
+exports.default = GitHubAdapter;

package/dist/git/gitlabAdapter.d.ts

@@ -0,0 +1,91 @@
+import { GitAdapter } from './adapter';
+type GLOpts = {
+    projectId: string;
+    token: string;
+    host?: string;
+};
+/**
+ *
+ */
+export declare class GitLabAdapter implements GitAdapter {
+    private opts;
+    private baseUrl;
+    private headers;
+    private pendingActions;
+    private maxRetries;
+    private baseBackoff;
+    /**
+     * GitLabAdapter を初期化します。
+     * @param {GLOpts} opts 設定オブジェクト
+     */
+    constructor(opts: GLOpts);
+    /**
+     * コンテンツから sha1 を算出します。
+     * @param {string} content コンテンツ
+     * @returns {string} sha1 ハッシュ
+     */
+    private shaOf;
+    /**
+     * 変更一覧から blob sha のマップを作成します（疑似実装）。
+     * @param {any[]} changes 変更一覧
+     * @returns {Promise<Record<string,string>>} path->sha マップ
+     */
+    createBlobs(changes: any[]): Promise<Record<string, string>>;
+    /**
+     * 互換用のツリー作成。実際には actions を保持しておき、マーカーを返します。
+     * @param {any[]} _changes 変更一覧
+     * @param {string} [_baseTreeSha] ベースツリー（未使用）
+     * @returns {Promise<string>} マーカー文字列
+     */
+    createTree(_changes: any[], _baseTreeSha?: string): Promise<string>;
+    /**
+     * createTree で保持した actions があればコミットし、なければ parentSha を返します。
+     * @param {string} message コミットメッセージ
+     * @param {string} parentSha 親コミット SHA
+     * @param {string} _treeSha ツリー SHA（未使用）
+     * @returns {Promise<string>} 新規コミット SHA または parentSha
+     */
+    createCommit(message: string, parentSha: string, _treeSha: string): Promise<any>;
+    /**
+     * actions を用いて GitLab のコミット API を呼び出します。
+     * @param {string} branch ブランチ名
+     * @param {string} message コミットメッセージ
+     * @param {{type:string,path:string,content?:string}[]} changes 変更一覧
+     * @returns {Promise<any>} コミット応答（id など）
+     */
+    createCommitWithActions(branch: string, message: string, changes: Array<{
+        type: string;
+        path: string;
+        content?: string;
+    }>): Promise<any>;
+    /**
+     * fetch をリトライ付きで実行します。
+     * @param {string} url リクエスト URL
+     * @param {RequestInit} opts fetch オプション
+     * @param {number} [retries] 最大リトライ回数
+     * @returns {Promise<Response>} レスポンス
+     */
+    private fetchWithRetry;
+    /**
+     * ステータスが再試行対象か判定します。
+     * @param {number} status ステータスコード
+     * @returns {boolean}
+     */
+    private isRetryableStatus;
+    /**
+     * バックオフ時間を計算します。
+     * @param {number} attempt 試行回数（1..）
+     * @returns {number} ミリ秒
+     */
+    private backoffMs;
+    /**
+     * リファレンス更新は不要なため noop 実装です。
+     * @param {string} _ref ref 名
+     * @param {string} _commitSha コミット SHA
+     * @param {boolean} [_force]
+     * @returns {Promise<void>}
+     */
+    updateRef(_ref: string, _commitSha: string, _force?: boolean): Promise<void>;
+}
+export default GitLabAdapter;
+//# sourceMappingURL=gitlabAdapter.d.ts.map

package/dist/git/gitlabAdapter.d.ts.map

@@ -0,0 +1 @@
+{"version":3,"file":"gitlabAdapter.d.ts","sourceRoot":"","sources":["../../src/git/gitlabAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,WAAW,CAAA;AAGtC,KAAK,MAAM,GAAG;IAAE,SAAS,EAAE,MAAM,CAAC;IAAC,KAAK,EAAE,MAAM,CAAC;IAAC,IAAI,CAAC,EAAE,MAAM,CAAA;CAAE,CAAA;AAEjE;;GAEG;AACH,qBAAa,aAAc,YAAW,UAAU;IAWlC,OAAO,CAAC,IAAI;IAVxB,OAAO,CAAC,OAAO,CAAQ;IACvB,OAAO,CAAC,OAAO,CAAwB;IACvC,OAAO,CAAC,cAAc,CAA8E;IACpG,OAAO,CAAC,UAAU,CAAI;IACtB,OAAO,CAAC,WAAW,CAAM;IAEzB;;;OAGG;gBACiB,IAAI,EAAE,MAAM;IAMhC;;;;OAIG;IACH,OAAO,CAAC,KAAK;IAIb;;;;OAIG;IACG,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE;IAOhC;;;;;OAKG;IACG,UAAU,CAAC,QAAQ,EAAE,GAAG,EAAE,EAAE,YAAY,CAAC,EAAE,MAAM;IAWvD;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,QAAQ,EAAE,MAAM;IAgBvE;;;;;;OAMG;IACG,uBAAuB,CAAC,MAAM,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,EAAE,OAAO,EAAE,KAAK,CAAC;QAAE,IAAI,EAAE,MAAM,CAAC;QAAC,IAAI,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAA;KAAE,CAAC;IAgC/H;;;;;;OAMG;YACW,cAAc;IAkB5B;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAIzB;;;;OAIG;IACH,OAAO,CAAC,SAAS;IAMjB;;;;;;OAMG;IACG,SAAS,CAAC,IAAI,EAAE,MAAM,EAAE,UAAU,EAAE,MAAM,EAAE,MAAM,UAAQ;CAGjE;AAED,eAAe,aAAa,CAAA"}