browser-git-ops 0.0.2 → 0.0.5

package/dist/git/githubAdapter.d.ts

@@ -1,50 +1,297 @@
-import { GitAdapter } from './adapter';
+import { GitAdapter } from './adapter.ts';
+import AbstractGitAdapter, { fetchWithRetry, classifyStatus, getDelayForResponse, processResponseWithDelay, mapWithConcurrency, shaOf } from './abstractAdapter.ts';
 type GHOptions = {
     owner: string;
     repo: string;
     token: string;
+    host?: string;
 };
 /**
- * リトライ可能なエラー。
+ * GitHub 向けの `GitAdapter` 実装。
+ * GitHub API をラップしてリポジトリ操作（コミット作成、ブランチ一覧、ファイル取得等）を提供します。
  */
-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;
+export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdapter {
     private _fetchWithRetry;
+    private repoMetadata;
     private blobCache;
-    constructor(opts: GHOptions);
+    /**
+     * GitHubAdapter を初期化します。
+     * @param {GHOptions} opts 設定オブジェクト
+     */
+    constructor(options: GHOptions);
+    /**
+     * List commits for a ref (GitHub commits API)
+     * @param {{ref:string,perPage?:number,page?:number}} query
+     * @returns {Promise<import('./adapter').CommitHistoryPage>} ページ情報を返します
+     */
+    listCommits(query: {
+        ref: string;
+        perPage?: number;
+        page?: number;
+    }): Promise<{
+        items: {
+            sha: any;
+            message: any;
+            author: any;
+            date: any;
+            parents: any;
+        }[];
+        nextPage: number | undefined;
+        lastPage: number | undefined;
+    }>;
+    /**
+     * 応答テキストを JSON 配列として解析します（失敗時は空配列を返す）。
+     * @param {string} text 応答テキスト
+     * @returns {any[]}
+     */
+    private _parseJsonArray;
+    /**
+     * GitHub の Link ヘッダを解析して next/last ページを返します。
+     * @param {string|undefined} linkHdr Link ヘッダ文字列
+      * @returns {{nextPage?: number, lastPage?: number}} ページ番号情報
+     */
+    private _parseLinkHeaderString;
+    /**
+     * Map a raw GitHub commit object to CommitSummary shape used by the adapter.
+     * @param {any} c Raw commit object
+     * @returns {import('./adapter').CommitSummary}
+     */
+    private _mapGithubCommitToSummary;
+    /**
+     * ブロブを作成またはキャッシュから取得します。
+     * @param {any[]} changes 変更一覧（create/update を含む）
+     * @param {number} [concurrency=5] 同時実行数
+     * @returns {Promise<Record<string,string>>} パス→blobSha のマップ
+     */
     createBlobs(changes: any[], concurrency?: number): Promise<Record<string, string>>;
+    /**
+     * Create a blob for a change or return cached blobSha.
+     * @param {any} ch change entry
+     * @returns {Promise<{path:string,sha:string}>}
+     */
+    private _createBlobForChange;
+    /**
+     * 互換用のツリー作成。
+     * @param {any[]} changes 変更一覧
+     * @param {string} [baseTreeSha] ベースツリー
+     * @returns {Promise<string>} 作成されたツリーの sha
+     */
     createTree(changes: any[], baseTreeSha?: string): Promise<string>;
+    /**
+     * コミットを作成します。
+     * @param {string} message コミットメッセージ
+     * @param {string} parentSha 親コミット SHA
+     * @param {string} treeSha ツリー SHA
+     * @returns {Promise<string>} 新規コミット SHA
+     */
     createCommit(message: string, parentSha: string, treeSha: string): Promise<string>;
-    updateRef(ref: string, commitSha: string, force?: boolean): Promise<void>;
+    /**
+     * Retrieve repository metadata (default branch, name, id) and cache it.
+     * @returns {Promise<import('../virtualfs/types.ts').RepositoryMetadata>} repository metadata
+     */
+    getRepositoryMetadata(): Promise<import('../virtualfs/types.ts').RepositoryMetadata>;
+    /**
+     * Build repository metadata object from API response body.
+     * @param data API response body
+     * @returns {import('../virtualfs/types.ts').RepositoryMetadata}
+     */
+    private _makeRepoMetadata;
+    /**
+     * List branches via GitHub API and map to BranchListPage.
+      * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
+     */
+    listBranches(query?: import('../virtualfs/types.ts').BranchListQuery): Promise<{
+        items: {
+            name: any;
+            commit: {
+                sha: any;
+                url: any;
+            };
+            protected: boolean;
+            isDefault: boolean;
+        }[];
+        nextPage: number | undefined;
+        lastPage: number | undefined;
+    }>;
+    /**
+     * Map raw branch objects returned by API to adapter Branch item shape.
+     * @param {any[]} parsed raw branch array
+     * @param {any} repoMeta repository metadata
+     * @returns {any[]}
+     */
+    private _mapBranchItems;
+    /**
+     * 参照を更新します。
+     * @param {string} ref 参照名（例: heads/main）
+     * @param {string} commitSha コミット SHA
+     * @param {boolean} force 強制更新フラグ
+     */
+    updateRef(reference: string, commitSha: string, force?: boolean): Promise<void>;
+    /**
+     * Create a branch (ref) on the remote repository.
+     * @param branchName branch name to create
+     * @param fromSha commit sha to point the new branch at
+     * @returns {Promise<import('../virtualfs/types.ts').CreateBranchResult>} created branch info
+     */
+    createBranch(branchName: string, fromSha: string): Promise<import('../virtualfs/types.ts').CreateBranchResult>;
+    /**
+     * Normalize common createBranch error messages into thrown NonRetryableError/Error.
+     * @param {string} message error message text
+     * @param {string} branchName branch attempted
+     * @returns {never}
+     */
+    private _handleCreateBranchError;
+    /**
+     * 指定コミットの tree SHA を取得します。
+     * @param commitSha コミット SHA
+      * @returns {Promise<string>} tree の SHA
+     */
+    getCommitTreeSha(commitSha: string): Promise<string>;
+    /**
+     * 指定 ref の先頭コミット SHA を取得します。
+     * @param ref 例: `heads/main`
+      * @returns {Promise<string>} 参照先のコミット SHA
+     */
+    getRef(reference: string): Promise<string>;
+    /**
+     * Fetch a ref URL and extract a SHA if present.
+     * @param {string} url API URL to fetch
+     * @returns {Promise<string|null>} sha string when found, otherwise null
+     */
+    private _getRefShaFromUrl;
+    /**
+     * Determine the head SHA for a branch; fallback to branch name if unavailable.
+     * @param {string} branch branch name
+     * @returns {Promise<string>} head SHA or branch
+     */
+    private _determineHeadSha;
+    /**
+     * Get commit SHA from the branches API for a branch name.
+     * @param {string} branch branch name
+     * @returns {Promise<string|null>} commit SHA or null when not found
+     */
+    private _getBranchCommitSha;
+    /**
+     * Get commit SHA from the commits endpoint for a given reference.
+     * @param {string} reference commit-ish reference
+     * @returns {Promise<string|null>} commit SHA or null when not found
+     */
+    private _getCommitEndpointSha;
+    /**
+     * tree を取得します（必要なら再帰取得）。
+     * @param treeSha tree の SHA
+     * @param recursive 再帰フラグ
+      * @returns {Promise<any[]>} tree の配列
+     */
+    getTree(treeSha: string, recursive?: boolean): Promise<any[]>;
+    /**
+     * blob を取得してデコードして返します。
+     * @param blobSha blob の SHA
+      * @returns {Promise<{content:string,encoding:string}>} デコード済みコンテンツとエンコーディング
+     */
+    getBlob(blobSha: string): Promise<{
+        content: any;
+        encoding: any;
+    }>;
+    /**
+     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
+     * Resolution order: branch -> tag -> commit endpoint -> treat as SHA
+     * Throws if resolution fails.
+     * @param {string} reference commit-ish to resolve
+     * @returns {Promise<string>} resolved commit SHA
+     */
+    resolveRef(reference: string): Promise<string>;
+    /**
+     * Run resolver functions in order and return the first non-null result.
+     * @param {string} reference commit-ish to resolve
+     * @param {Array<(_reference: string) => Promise<string | null>>} resolvers resolver functions
+     * @returns {Promise<string|null>} resolved sha or null
+     */
+    private _runResolvers;
+    /**
+     * Try to resolve a branch name to a commit SHA.
+     * @param {string} reference branch name
+     * @returns {Promise<string|null>}
+     */
+    private _tryResolveByBranch;
+    /**
+     * Try to resolve a tag name to a commit SHA.
+     * @param {string} reference tag name
+     * @returns {Promise<string|null>}
+     */
+    private _tryResolveByTag;
+    /**
+     * Try to resolve via commits endpoint (may accept SHA or other forms).
+     * @param {string} reference commit-ish
+     * @returns {Promise<string|null>}
+     */
+    private _tryResolveByCommitEndpoint;
+    /**
+     * Fetch a blob's content; return null content on failure.
+     * @param {any} f blob metadata
+     * @returns {Promise<{path:string,content:string|null}>}
+     */
+    private _fetchBlobContentOrNull;
+    /**
+     * 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;
+    /**
+     * Fetch repository snapshot: headSha, shas map and a fetchContent helper.
+     * @param {string} branch branch name
+     * @param {number} concurrency fetch concurrency
+     * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:Function,snapshot:Record<string,string>}>}
+     */
+    fetchSnapshot(branch?: string, concurrency?: number): Promise<any>;
+    /**
+     * Bound helper used to construct the `fetchContent` function returned by `fetchSnapshot`.
+     * @param {Map<string, any>} fileMap file metadata map
+     * @param {Map<string,string>} contentCache cache map
+     * @param {Record<string,string>} snapshot snapshot map to populate
+     * @param {number} concurrency concurrency level
+     * @param {string[]} paths requested paths
+     * @returns {Promise<Record<string,string>>}
+     */
+    private _fetchSnapshotForFileMap;
+    /**
+     * Build file map and shas from a head SHA by fetching the tree.
+     * @param {string} headSha head commit SHA
+     * @returns {Promise<{shas:Record<string,string>,fileMap:Map<string,any>}>}
+     */
+    private _buildFileMapFromHead;
+    /**
+     * Fetch contents for given paths from a file map with caching and concurrency.
+     * @param {Map<string, any>} fileMap map of file metadata
+     * @param {Map<string,string>} contentCache cache map
+     * @param {Record<string,string>} snapshot output snapshot
+     * @param {string[]} paths requested paths
+     * @param {number} concurrency concurrency level
+     * @returns {Promise<Record<string,string>>}
+     */
+    private _fetchContentFromMap;
+    /**
+     * Mapper used by _fetchContentFromMap when fetching multiple files.
+     * @param {Map<string, any>} fileMap file metadata map
+     * @param {Map<string,string>} contentCache cache map
+     * @param {Record<string,string>} snapshot snapshot map to populate
+     * @param {Record<string,string>} out output map to collect results
+     * @param {string} p requested path
+     * @returns {Promise<null>}
+     */
+    private _mapperForFetch;
+    /**
+     * Fetch single path content, update cache and snapshot.
+     * @param {Map<string, any>} fileMap file map
+     * @param {Map<string,string>} contentCache cache map
+     * @param {Record<string,string>} snapshot snapshot map
+     * @param {string} p path to fetch
+     * @returns {Promise<string|null>}
+     */
+    private _fetchContentForPath;
 }
-export { fetchWithRetry, classifyStatus, getDelayForResponse, processResponseWithDelay, mapWithConcurrency };
+export { fetchWithRetry, classifyStatus, getDelayForResponse, processResponseWithDelay, mapWithConcurrency, shaOf };
+export { RetryableError, NonRetryableError } from './abstractAdapter.ts';
 export default GitHubAdapter;
 //# sourceMappingURL=githubAdapter.d.ts.map

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

@@ -1 +1 @@
-{"version":3,"file":"githubAdapter.d.ts","sourceRoot":"","sources":["../../src/git/githubAdapter.ts"],"names":[],"mappings":"AAAA,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;IAwB3C,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"}
+{"version":3,"file":"githubAdapter.d.ts","sourceRoot":"","sources":["../../src/git/githubAdapter.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,UAAU,EAAE,MAAM,cAAc,CAAA;AACzC,OAAO,kBAAkB,EAAE,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,KAAK,EAAqB,MAAM,sBAAsB,CAAA;AAEtL,KAAK,SAAS,GAAG;IACf,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,EAAE,MAAM,CAAA;IACZ,KAAK,EAAE,MAAM,CAAA;IACb,IAAI,CAAC,EAAE,MAAM,CAAA;CACd,CAAA;AAGD;;;GAGG;AACH,qBAAa,aAAc,SAAQ,kBAAmB,YAAW,UAAU;IACzE,OAAO,CAAC,eAAe,CAAqF;IAC5G,OAAO,CAAC,YAAY,CAAkE;IAEtF,OAAO,CAAC,SAAS,CAAiC;IAElD;;;OAGG;gBACS,OAAO,EAAE,SAAS;IAgB9B;;;;OAIG;IACG,WAAW,CAAC,KAAK,EAAE;QAAE,GAAG,EAAE,MAAM,CAAC;QAAC,OAAO,CAAC,EAAE,MAAM,CAAC;QAAC,IAAI,CAAC,EAAE,MAAM,CAAA;KAAE;;;;;;;;;;;IAgBzE;;;;OAIG;IACH,OAAO,CAAC,eAAe;IASvB;;;;OAIG;IACH,OAAO,CAAC,sBAAsB;IAc9B;;;;OAIG;IACH,OAAO,CAAC,yBAAyB;IAWjC;;;;;OAKG;IACG,WAAW,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,SAAI;IAQjD;;;;OAIG;YACW,oBAAoB;IAiBlC;;;;;OAKG;IACG,UAAU,CAAC,OAAO,EAAE,GAAG,EAAE,EAAE,WAAW,CAAC,EAAE,MAAM;IAkBrD;;;;;;OAMG;IACG,YAAY,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM;IAYtE;;;OAGG;IACG,qBAAqB,IAAI,OAAO,CAAC,OAAO,uBAAuB,EAAE,kBAAkB,CAAC;IAc1F;;;;OAIG;IACH,OAAO,CAAC,iBAAiB;IAQzB;;;OAGG;IACG,YAAY,CAAC,KAAK,CAAC,EAAE,OAAO,uBAAuB,EAAE,eAAe;;;;;;;;;;;;;IAgB1E;;;;;OAKG;IACH,OAAO,CAAC,eAAe;IASvB;;;;;OAKG;IACG,SAAS,CAAC,SAAS,EAAE,MAAM,EAAE,SAAS,EAAE,MAAM,EAAE,KAAK,UAAQ;IASnE;;;;;OAKG;IACG,YAAY,CAAC,UAAU,EAAE,MAAM,EAAE,OAAO,EAAE,MAAM,GAAG,OAAO,CAAC,OAAO,uBAAuB,EAAE,kBAAkB,CAAC;IAcpH;;;;;OAKG;IACH,OAAO,CAAC,wBAAwB;IAUhC;;;;OAIG;IACG,gBAAgB,CAAC,SAAS,EAAE,MAAM;IAOxC;;;;OAIG;IACG,MAAM,CAAC,SAAS,EAAE,MAAM;IAmB9B;;;;OAIG;YACW,iBAAiB;IAS/B;;;;OAIG;YACW,iBAAiB;IAwB/B;;;;OAIG;YACW,mBAAmB;IAQjC;;;;OAIG;YACW,qBAAqB;IAQnC;;;;;OAKG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM,EAAE,SAAS,UAAQ;IAQhD;;;;OAIG;IACG,OAAO,CAAC,OAAO,EAAE,MAAM;;;;IAU7B;;;;;;OAMG;IACG,UAAU,CAAC,SAAS,EAAE,MAAM,GAAG,OAAO,CAAC,MAAM,CAAC;IAepD;;;;;OAKG;YACW,aAAa;IAY3B;;;;OAIG;YACW,mBAAmB;IAKjC;;;;OAIG;YACW,gBAAgB;IAK9B;;;;OAIG;YACW,2BAA2B;IAUzC;;;;OAIG;YACW,uBAAuB;IAgBrC;;;;OAIG;IACH,OAAO,CAAC,qBAAqB;IAe7B;;;;;OAKG;IACG,aAAa,CAAC,MAAM,SAAS,EAAE,WAAW,SAAI,GAAG,OAAO,CAAC,GAAG,CAAC;IAWnE;;;;;;;;OAQG;YACW,wBAAwB;IAItC;;;;OAIG;YACW,qBAAqB;IAanC;;;;;;;;OAQG;YACW,oBAAoB;IAalC;;;;;;;;OAQG;YACW,eAAe;IAM7B;;;;;;;OAOG;YACW,oBAAoB;CAenC;AAED,OAAO,EAAE,cAAc,EAAE,cAAc,EAAE,mBAAmB,EAAE,wBAAwB,EAAE,kBAAkB,EAAE,KAAK,EAAE,CAAA;AAEnH,OAAO,EAAE,cAAc,EAAE,iBAAiB,EAAE,MAAM,sBAAsB,CAAA;AACxE,eAAe,aAAa,CAAA"}

package/dist/git/gitlabAdapter.d.ts

@@ -1,30 +1,60 @@
-import { GitAdapter } from './adapter';
-type GLOpts = {
+import { GitAdapter } from './adapter.ts';
+import AbstractGitAdapter from './abstractAdapter.ts';
+type GLOptions = {
     projectId: string;
     token: string;
     host?: string;
 };
 /**
- *
+ * GitLab 向けの GitAdapter 実装です。
+ * GitLab の API をラップして、リポジトリスナップショットの取得や
+ * commits API の呼び出しをサポートします。
  */
-export declare class GitLabAdapter implements GitAdapter {
-    private opts;
-    private baseUrl;
-    private headers;
+export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdapter {
     private pendingActions;
-    private maxRetries;
-    private baseBackoff;
+    private projectMetadata;
     /**
      * GitLabAdapter を初期化します。
      * @param {GLOpts} opts 設定オブジェクト
      */
-    constructor(opts: GLOpts);
+    constructor(options: GLOptions);
     /**
-     * コンテンツから sha1 を算出します。
-     * @param {string} content コンテンツ
-     * @returns {string} sha1 ハッシュ
+     * List commits for a ref (GitLab commits API)
+     * @param {{ref:string,perPage?:number,page?:number}} query
+     * @returns {Promise<import('./adapter').CommitHistoryPage>} ページ情報を返します
      */
-    private shaOf;
+    listCommits(query: {
+        ref: string;
+        perPage?: number;
+        page?: number;
+    }): Promise<{
+        items: {
+            sha: any;
+            message: any;
+            author: any;
+            date: any;
+            parents: any;
+        }[];
+        nextPage: number | undefined;
+        lastPage: number | undefined;
+    }>;
+    /**
+     * 応答テキストを JSON 配列として解析します（失敗時は空配列を返す）。
+     * @param {string} text 応答テキスト
+     * @returns {any[]}
+     */
+    private _parseJsonArray;
+    /**
+     * GitLab のページングヘッダを解析します（x-next-page / x-total-pages）。
+     * @returns {{nextPage?: number, lastPage?: number}} ページ番号情報
+     */
+    private _parsePagingHeaders;
+    /**
+     * Map a raw GitLab commit object to CommitSummary.
+     * @param {any} c Raw commit object
+     * @returns {import('./adapter').CommitSummary}
+     */
+    private _mapGitLabCommitToSummary;
     /**
      * 変更一覧から blob sha のマップを作成します（疑似実装）。
      * @param {any[]} changes 変更一覧
@@ -46,6 +76,14 @@ export declare class GitLabAdapter implements GitAdapter {
      * @returns {Promise<string>} 新規コミット SHA または parentSha
      */
     createCommit(message: string, parentSha: string, _treeSha: string): Promise<any>;
+    /**
+     * リファレンス更新は不要なため noop 実装です。
+     * @param {string} _ref ref 名
+     * @param {string} _commitSha コミット SHA
+     * @param {boolean} [_force]
+     * @returns {Promise<void>}
+     */
+    updateRef(_reference: string, _commitSha: string, _force?: boolean): Promise<void>;
     /**
      * actions を用いて GitLab のコミット API を呼び出します。
      * @param {string} branch ブランチ名
@@ -57,35 +95,183 @@ export declare class GitLabAdapter implements GitAdapter {
         type: string;
         path: string;
         content?: string;
-    }>): Promise<any>;
+    }>, expectedParentSha?: string): Promise<any>;
     /**
-     * fetch をリトライ付きで実行します。
-     * @param {string} url リクエスト URL
-     * @param {RequestInit} opts fetch オプション
-     * @param {number} [retries] 最大リトライ回数
-     * @returns {Promise<Response>} レスポンス
+     * Retrieve project metadata (default branch, name, id) and cache it.
+     * @returns {Promise<import('../virtualfs/types.ts').RepositoryMetadata>} repository metadata
      */
-    private fetchWithRetry;
+    getRepositoryMetadata(): Promise<import('../virtualfs/types.ts').RepositoryMetadata>;
     /**
-     * ステータスが再試行対象か判定します。
-     * @param {number} status ステータスコード
-     * @returns {boolean}
+     * Build project metadata from API response.
+     * @param data API response body
+     * @returns {import('../virtualfs/types.ts').RepositoryMetadata}
      */
-    private isRetryableStatus;
+    private _makeProjectMetadata;
     /**
-     * バックオフ時間を計算します。
-     * @param {number} attempt 試行回数（1..）
-     * @returns {number} ミリ秒
+     * List branches via GitLab API and map to BranchListPage.
+     * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
      */
-    private backoffMs;
+    listBranches(query?: import('../virtualfs/types.ts').BranchListQuery): Promise<{
+        items: {
+            name: any;
+            commit: {
+                sha: any;
+                url: any;
+            };
+            protected: boolean;
+            isDefault: boolean;
+        }[];
+        nextPage: number | undefined;
+        lastPage: number | undefined;
+    }>;
     /**
-     * リファレンス更新は不要なため noop 実装です。
-     * @param {string} _ref ref 名
-     * @param {string} _commitSha コミット SHA
-     * @param {boolean} [_force]
+     * Create a branch in GitLab: POST /projects/{projectId}/repository/branches
+     * @param branchName name of branch to create
+     * @param fromSha branch/tag name or SHA to base the new branch on
+     * @returns {Promise<import('../virtualfs/types.ts').CreateBranchResult>} created branch info
+     */
+    createBranch(branchName: string, fromSha: string): Promise<import('../virtualfs/types.ts').CreateBranchResult>;
+    /**
+     * Normalize common createBranch error messages into thrown Errors.
+     * @param {string} message error message text
+     * @param {string} branchName branch name attempted
+     * @returns {never}
+     */
+    private _handleCreateBranchError;
+    /**
+     * Map raw GitLab branch objects to adapter Branch item shape.
+     * @param {any[]} parsed raw branch array
+     * @param {any} repoMeta repository metadata
+     * @returns {any[]}
+     */
+    private _mapBranchItems;
+    /**
+     * Convert change descriptors to GitLab API actions
+     * @returns {Array<any>} API-compatible actions array
+     */
+    private createActions;
+    /**
+     * Verify that remote branch head matches expected parent SHA.
+     * Throws when non-fast-forward detected.
+     * @param {string} expectedParentSha expected parent SHA
+     * @param {string} branch branch name
      * @returns {Promise<void>}
      */
-    updateRef(_ref: string, _commitSha: string, _force?: boolean): Promise<void>;
+    private verifyParent;
+    /**
+     * Parse and validate commit API response text
+     * @param {string} text 応答テキスト
+     * @returns {any} parsed commit id/object
+     */
+    private parseCommitResponse;
+    /**
+     * Post commit request and return parsed commit response.
+     * @param {string} url endpoint URL
+     * @param {string} body request body
+     * @returns {Promise<any>} parsed commit response
+     */
+    private postCommit;
+    /**
+     * Wait helper for retry backoff.
+     * @param {number} attempt attempt number
+     * @returns {Promise<void>}
+     */
+    private _waitAttempt;
+    /**
+     * Prepare JSON body for commit API call.
+     * @returns {string} JSON body
+     */
+    private _prepareCommitBody;
+    /**
+     * Optionally verify parent SHA; rethrow errors after logging.
+     * @param {string} expectedParentSha expected SHA
+     * @param {string} branch branch name
+     * @returns {Promise<void>}
+     */
+    private _maybeVerifyParent;
+    /**
+     * リポジトリのスナップショットを取得します。
+     * @param {string} branch ブランチ名 (default: 'main')
+     * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:(paths:string[])=>Promise<Record<string,string>>}>}
+     */
+    fetchSnapshot(branch?: string, concurrency?: number): Promise<any>;
+    /**
+     * Determine the head SHA for a branch; fallback to branch name if unavailable.
+     * @param {string} branch branch name
+     * @returns {Promise<string>} head SHA or branch
+     */
+    private _determineHeadSha;
+    /**
+     * Fetch repository tree and build shas map and fileSet.
+     * @param {string} branch branch name
+     * @returns {Promise<{shas:Record<string,string>,fileSet:Set<string>}>}
+     */
+    private _fetchTreeAndBuildShas;
+    /**
+     * Fetch contents for requested paths from a FileSet with caching.
+     * @param {Set<string>} fileSet set of available files
+     * @param {Map<string,string>} cache content cache
+     * @param {Record<string,string>} snapshot snapshot output
+     * @param {string[]} paths requested paths
+     * @param {string} branch branch name
+     * @param {number} concurrency concurrency level
+     * @returns {Promise<Record<string,string>>}
+     */
+    private _fetchContentFromFileSet;
+    /**
+     * Fetch the content for a single file path, updating cache and snapshot.
+     * @param {Map<string,string>} cache cache map
+     * @param {Record<string,string>} snapshot snapshot map
+     * @param {string} p file path
+     * @param {string} branch branch
+     * @returns {Promise<string|null>} file content or null
+     */
+    private _fetchFileContentForPath;
+    /**
+     * Fetch raw file content from GitLab; return null on failure.
+     * @param {string} path file path
+     * @param {string} branch branch name
+     * @returns {Promise<string|null>} file content or null
+     */
+    private _fetchFileRaw;
+    /**
+     * Build shas map and fileSet from tree entries
+     * @returns {{shas:Record<string,string>,fileSet:Set<string>}}
+     */
+    private _buildShasAndFileSet;
+    /**
+     * Resolve a commit-ish (branch, tag, or SHA) to a commit SHA.
+     * Resolution order: branch -> tag -> commits endpoint -> treat as SHA
+     * Throws if not resolvable.
+     * @param {string} reference commit-ish to resolve
+     * @returns {Promise<string>} resolved commit SHA
+     */
+    resolveRef(reference: string): Promise<string>;
+    /**
+     * Run resolver functions in order and return the first non-null result.
+     * @param {string} reference commit-ish to resolve
+     * @param {Array<(_reference: string) => Promise<string | null>>} resolvers resolver functions
+     * @returns {Promise<string|null>} resolved sha or null
+     */
+    private _runResolvers;
+    /**
+     * Try to resolve a branch name to its commit SHA.
+     * @param {string} reference branch name
+     * @returns {Promise<string|null>} resolved sha or null
+     */
+    private _tryResolveBranch;
+    /**
+     * Try to resolve a tag name to a commit SHA.
+     * @param {string} reference tag name
+     * @returns {Promise<string|null>} resolved SHA or null
+     */
+    private _tryResolveTag;
+    /**
+     * Try to resolve a commit via commits endpoint.
+     * @param {string} reference commit-ish
+     * @returns {Promise<string|null>} resolved SHA or null
+     */
+    private _tryResolveCommit;
 }
 export default GitLabAdapter;
 //# sourceMappingURL=gitlabAdapter.d.ts.map

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

@@ -1 +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;YACW,KAAK;IAOnB;;;;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"}
+{"version":3,"file":"gitlabAdapter.d.ts","sourceRoot":"","sources":["../../src/git/gitlabAdapter.ts"],"names":[],"mappings":"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"}

package/dist/index.d.ts

@@ -1,7 +1,8 @@
-export { default as VirtualFS } from './virtualfs/virtualfs';
-export { default as IndexedDbStorage } from './virtualfs/indexedDbStorage';
-export { default as OpfsStorage } from './virtualfs/opfsStorage';
-export { default as GitHubAdapter } from './git/githubAdapter';
-export { default as GitLabAdapter } from './git/gitlabAdapter';
-export { default } from './virtualfs/virtualfs';
+export { default as VirtualFS } from './virtualfs/virtualfs.ts';
+export { default as IndexedDatabaseStorage } from './virtualfs/indexedDatabaseStorage.ts';
+export { default as OpfsStorage } from './virtualfs/opfsStorage.ts';
+export { default as InMemoryStorage } from './virtualfs/inmemoryStorage.ts';
+export { default as GitHubAdapter } from './git/githubAdapter.ts';
+export { default as GitLabAdapter } from './git/gitlabAdapter.ts';
+export { default } from './virtualfs/virtualfs.ts';
 //# sourceMappingURL=index.d.ts.map

package/dist/index.d.ts.map

@@ -1 +1 @@
-{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,uBAAuB,CAAA;AAC5D,OAAO,EAAE,OAAO,IAAI,gBAAgB,EAAE,MAAM,8BAA8B,CAAA;AAC1E,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,yBAAyB,CAAA;AAChE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,qBAAqB,CAAA;AAC9D,OAAO,EAAE,OAAO,EAAE,MAAM,uBAAuB,CAAA"}
+{"version":3,"file":"index.d.ts","sourceRoot":"","sources":["../src/index.ts"],"names":[],"mappings":"AAAA,OAAO,EAAE,OAAO,IAAI,SAAS,EAAE,MAAM,0BAA0B,CAAA;AAC/D,OAAO,EAAE,OAAO,IAAI,sBAAsB,EAAE,MAAM,uCAAuC,CAAA;AACzF,OAAO,EAAE,OAAO,IAAI,WAAW,EAAE,MAAM,4BAA4B,CAAA;AACnE,OAAO,EAAE,OAAO,IAAI,eAAe,EAAE,MAAM,gCAAgC,CAAA;AAC3E,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,IAAI,aAAa,EAAE,MAAM,wBAAwB,CAAA;AACjE,OAAO,EAAE,OAAO,EAAE,MAAM,0BAA0B,CAAA"}