browser-git-ops 0.0.5 → 0.0.8

package/README.md

@@ -35,6 +35,8 @@ A browser-native Git operations library that provides a VirtualFS and platform a
 - ✅ Persistence backends for OPFS and IndexedDB
 - ✅ GitHubAdapter with primary push/pull flows
 - ✅ GitLabAdapter with primary push/pull flows
+- ✅ GitLab tree API pagination (offset-based, per_page=100) for repositories with 100+ files
+- ✅ GitHub truncated tree detection with warning log for repositories exceeding 100,000 entries / 7 MB
 
 ## Installation
 
@@ -61,20 +63,23 @@ import { VirtualFS, OpfsStorage, GitHubAdapter } from 'browser-git-ops'
 
 async function example() {
   // 1. Initialize VirtualFS with OPFS backend
-  const backend = new OpfsStorage('my-workspace')
+  const backend = new OpfsStorage('appname','my-workspace')
   const vfs = new VirtualFS({ backend })
   await vfs.init()
 
   // 2. Configure adapter (GitHub or GitLab)
-  await vfs.setAdapter(null, {
+  await vfs.setAdapter({
     type: 'github',
+    branch: 'main',
+    token: 'your-github-token',
     opts: {
       owner: 'your-username',
       repo: 'your-repo',
-      token: 'your-github-token',
-      branch: 'main'
     }
   })
+  // Alternative overloads:
+  //   await vfs.setAdapter('github', 'https://github.com/your-username/your-repo', 'main', 'your-github-token')
+  //   await vfs.setAdapter('https://github.com/your-username/your-repo', 'main', 'your-github-token')
 
   // 3. Pull latest content from remote
   await vfs.pull()
@@ -88,8 +93,13 @@ async function example() {
   await vfs.writeFile('docs/guide.md', '## Getting Started')
 
   // 6. Stat a file (Stats includes gitBlobSha/gitCommitSha when available)
+  // 6. Stat a file — returned object implements fs.Stats-like shape
+  //    When the file is tracked by a configured adapter, the returned
+  //    stats may include Git-specific identifiers: gitBlobSha, gitCommitSha, gitRef.
   const s = await vfs.stat('README.md')
   console.log('size=', s.size, 'isFile=', s.isFile())
+  // Git-specific fields (may be undefined for non-tracked files):
+  console.log('gitBlobSha=', s.gitBlobSha, 'gitCommitSha=', s.gitCommitSha, 'gitRef=', s.gitRef)
 
   // 7. Delete a file (use unlink instead of deleteFile)
   await vfs.unlink('docs/guide.md')
@@ -124,15 +134,18 @@ await vfs.init()
 ### Using GitLab Adapter
 
 ```typescript
-await vfs.setAdapter(null, {
+await vfs.setAdapter({
   type: 'gitlab',
+  branch: 'main',
+  token: 'your-gitlab-token',
   opts: {
     projectId: 'username/project',
     host: 'gitlab.com',
-    token: 'your-gitlab-token',
-    branch: 'main'
   }
 })
+// Alternative overloads:
+//   await vfs.setAdapter('gitlab', 'https://gitlab.com/username/project', 'main', 'your-gitlab-token')
+//   await vfs.setAdapter('https://gitlab.com/username/project', 'main', 'your-gitlab-token')
 ```
 
 ## Development
@@ -197,6 +210,7 @@ To use the GitHub adapter, you need:
 - **Personal Access Token** with `repo` scope
 - Repository owner and name
 - Target branch (default: `main`)
+- **Large repositories**: If the recursive tree response exceeds 100,000 entries or 7 MB, the `truncated` flag is detected and a warning is logged. Files within the returned tree are still available.
 
 ### GitLab Adapter
 
@@ -205,6 +219,7 @@ To use the GitLab adapter, you need:
 - Project ID (format: `username/project` or numeric ID)
 - GitLab instance host (default: `gitlab.com`)
 - Target branch (default: `main`)
+- **Large repositories**: Tree listing is automatically paginated (offset-based, `per_page=100`) so that repositories with any number of files are fully fetched during `pull`.
 
 ### Browser Compatibility
 
@@ -238,8 +253,13 @@ class VirtualFS {
   async getChangeSet(): Promise<ChangeItem[]>
   async revertChanges(): Promise<void>
   
-  // Remote Synchronization
-  async setAdapter(adapter: any, meta?: any): Promise<void>
+  // Remote Synchronization (overloads)
+  async setAdapter(meta: AdapterMeta): Promise<void>
+  async setAdapter(type: string, url: string, branch?: string, token?: string): Promise<void>
+  async setAdapter(url: string, branch?: string, token?: string): Promise<void>
+  async getAdapter(): Promise<AdapterMeta | null>
+  async getAdapterInstance(): Promise<any | null>
+  getAdapterMeta(): AdapterMeta | null
   async pull(reference?: string, baseSnapshot?: Record<string, string>): Promise<any>
   async push(input: CommitInput): Promise<any>
   
@@ -251,24 +271,88 @@ class VirtualFS {
   async getIndex(): Promise<IndexFile>
   async saveIndex(): Promise<void>
 }
+
+// AdapterMeta and related types:
+// interface AdapterMeta {
+//   type: string;
+//   url?: string;        // Repository URL (can be derived from opts)
+//   branch?: string;     // Target branch (default: 'main')
+//   token?: string;
+//   opts?: {
+//     host?: string;
+//     owner?: string;     // GitHub
+//     projectId?: string; // GitLab
+//     repo?: string;
+//   }
+// }
+// Stored (normalized) format in indexManager:
+// { type, url, branch, token, opts: { host, owner, projectId, repo } }
+// When branch is omitted it defaults to 'main'.
+
+// Stats-like object returned by `vfs.stat(path)` includes standard fields
+// similar to Node.js `fs.Stats` and may include Git identifiers when available.
+// Example Type (informational):
+// interface FsStatsLike {
+//   dev: number; ino: number; mode: number; nlink: number; uid: number; gid: number;
+//   size: number; atime: Date; mtime: Date; ctime: Date; birthtime: Date;
+//   isFile(): boolean; isDirectory(): boolean;
+//   // Git-specific (optional):
+//   gitBlobSha?: string; // blob SHA for tracked file
+//   gitCommitSha?: string; // latest commit SHA touching this path
+//   gitRef?: string; // reference/branch used to derive these values
+// }
 ```
 
+#### Adapter Retrieval and Management
+
+```typescript
+// Get persisted adapter metadata (configuration, not instance)
+async getAdapter(): Promise<AdapterMeta | null>
+// Example:
+const meta = await vfs.getAdapter()
+if (meta) {
+  console.log('Adapter type:', meta.type)
+  console.log('Branch:', meta.branch)   // top-level field (default: 'main')
+  console.log('Token:', meta.token)
+  console.log('Owner:', meta.opts?.owner) // GitHub case
+}
+
+// Get cached adapter metadata synchronously
+getAdapterMeta(): AdapterMeta | null
+// Example:
+const meta = vfs.getAdapterMeta()
+
+// Get or create adapter instance (lazy initialization)
+async getAdapterInstance(): Promise<any | null>
+// Example:
+const adapter = await vfs.getAdapterInstance()
+if (adapter) {
+  // adapter.resolveRef, adapter.push, etc. are now available
+}
+```
+
+**Note**: 
+- `getAdapter()` and `getAdapterInstance()` serve different purposes
+- `getAdapter()` returns persisted metadata (type, url, branch, token, opts)
+- `getAdapterInstance()` creates/retrieves the adapter instance from metadata
+- `getAdapterMeta()` synchronously returns cached metadata (no Promise)
+
 ### Storage Backends
 
 ```typescript
 // OPFS Backend
 class OpfsStorage implements StorageBackend {
-  constructor(rootName?: string)
+  constructor(namespace: string, rootName?: string)
 }
 
 // IndexedDB Backend
 class IndexedDatabaseStorage implements StorageBackend {
-  constructor(rootName?: string)
+  constructor(namespace: string, rootName?: string)
 }
 
 // In-Memory Backend (for testing)
 class InMemoryStorage implements StorageBackend {
-  constructor()
+  constructor(namespace: string, rootName?: string)
 }
 ```
 
@@ -276,22 +360,28 @@ class InMemoryStorage implements StorageBackend {
 
 ```typescript
 // GitHub Adapter
+// Truncated tree responses (100,000+ entries) are automatically detected
+// and logged as a warning; fetched files are still returned.
 class GitHubAdapter {
   constructor(options: {
     owner: string
     repo: string
     token: string
-    branch: string
+    branch?: string
+    host?: string   // GitHub Enterprise host (optional)
   })
 }
 
 // GitLab Adapter
+// Tree listing is automatically paginated (per_page=100) to support
+// repositories with any number of files.
 class GitLabAdapter {
   constructor(options: {
     projectId: string
     host: string
     token: string
-    branch: string
+    branch?: string
+    host?: string   // Self-hosted GitLab instance (optional)
   })
 }
 ```

package/dist/git/abstractAdapter.d.ts

@@ -58,6 +58,18 @@ export declare class RetryableError extends Error {
  */
 export declare class NonRetryableError extends Error {
 }
+/**
+ * Error indicating that retry attempts were exhausted and no further retries will be made.
+ */
+export declare class RetryExhaustedError extends RetryableError {
+    code: string;
+    cause?: any;
+    /**
+     * @param {string} message error message
+     * @param {any} [cause] original cause
+     */
+    constructor(message: string, cause?: any);
+}
 /**
  * Map items with limited concurrency
  * @template T,R
@@ -66,7 +78,44 @@ export declare class NonRetryableError extends Error {
  * @param concurrency concurrency limit
  * @returns Promise resolving to array of mapped results
  */
-export declare function mapWithConcurrency<T, R>(items: T[], mapper: (_t: T) => Promise<R>, concurrency?: number): Promise<R[]>;
+export type MapWithConcurrencyOptions = {
+    controller?: AbortController;
+};
+/**
+ * Process a single item from the items array.
+ * @template T,R
+ * @param {T[]} items source items
+ * @param {Function} mapper async mapper
+ * @param {R[]} results results array
+ * @param {number} index_ item index
+ * @param {AbortController} [controller] optional abort controller
+ * @returns {Promise<void>}
+ */
+export declare function processOne<T, R>(items: T[], mapper: (_t: T) => Promise<R>, results: R[], index_: number, controller?: AbortController): Promise<void>;
+/**
+ * Worker that processes items sequentially from a shared index.
+ * @template T,R
+ * @param {T[]} items source items
+ * @param {Function} mapper async mapper
+ * @param {R[]} results results array
+ * @param {{value:number}} indexReference shared index reference
+ * @param {number} indexReference.value current index value
+ * @param {AbortController} [controller] optional abort controller
+ * @returns {Promise<void>}
+ */
+export declare function queueRunWorker<T, R>(items: T[], mapper: (_t: T) => Promise<R>, results: R[], indexReference: {
+    value: number;
+}, controller?: AbortController): Promise<void>;
+/**
+ * Map items with limited concurrency.
+ * @template T,R
+ * @param {T[]} items items to map
+ * @param {Function} mapper async mapper function
+ * @param {number} concurrency concurrency limit
+ * @param {MapWithConcurrencyOptions} [options] options with optional controller
+ * @returns {Promise<R[]>} mapped results
+ */
+export declare function mapWithConcurrency<T, R>(items: T[], mapper: (_t: T) => Promise<R>, concurrency?: number, options?: MapWithConcurrencyOptions): Promise<R[]>;
 /**
  * Abstract base class providing shared utilities for Git adapters
  */
@@ -102,17 +151,17 @@ export declare abstract class AbstractGitAdapter {
     protected logDebug(..._messages: any[]): void;
     /**
      * Log an informational message if a logger is present.
-     * @param args items to log
+     * @param _messages items to log
      */
     protected logInfo(..._messages: any[]): void;
     /**
      * Log a warning message if a logger is present.
-     * @param args items to log
+     * @param _messages items to log
      */
     protected logWarn(..._messages: any[]): void;
     /**
      * Log an error message if a logger is present.
-     * @param args items to log
+     * @param _messages items to log
      */
     protected logError(..._messages: any[]): void;
     /**
@@ -123,11 +172,16 @@ export declare abstract class AbstractGitAdapter {
     private normalizeHeaders;
     /**
      * Format a fetch request into a minimal object suitable for logging.
+     * @param input fetch input (URL or Request)
+     * @param init fetch initialization options
+     * @param attempts retry attempts count
+     * @param baseDelay base delay in milliseconds
      * @returns formatted request log object
      */
     private formatRequestForLog;
     /**
      * Format a fetch Response into a minimal object suitable for logging.
+     * @param response HTTP response object
      * @returns formatted response log object
      */
     private formatResponseForLog;
@@ -159,9 +213,10 @@ export declare abstract class AbstractGitAdapter {
      * @param items items to map
      * @param mapper async mapper
      * @param concurrency concurrency limit
+     * @param [options] options with optional controller
      * @returns Promise resolving to mapped results
      */
-    protected mapWithConcurrency<T, R>(items: T[], mapper: (_t: T) => Promise<R>, concurrency?: number): Promise<R[]>;
+    protected mapWithConcurrency<T, R>(items: T[], mapper: (_t: T) => Promise<R>, concurrency?: number, options?: MapWithConcurrencyOptions): Promise<R[]>;
 }
 export default AbstractGitAdapter;
 //# sourceMappingURL=abstractAdapter.d.ts.map

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

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

package/dist/git/githubAdapter.d.ts

@@ -1,6 +1,6 @@
 import { GitAdapter } from './adapter.ts';
 import AbstractGitAdapter, { fetchWithRetry, classifyStatus, getDelayForResponse, processResponseWithDelay, mapWithConcurrency, shaOf } from './abstractAdapter.ts';
-type GHOptions = {
+export type GHOptions = {
     owner: string;
     repo: string;
     token: string;
@@ -16,12 +16,15 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     private blobCache;
     /**
      * GitHubAdapter を初期化します。
-     * @param {GHOptions} opts 設定オブジェクト
+     * @param {GHOptions} options 設定オブジェクト
      */
     constructor(options: GHOptions);
     /**
      * List commits for a ref (GitHub commits API)
-     * @param {{ref:string,perPage?:number,page?:number}} query
+     * @param {Object} query query parameters
+     * @param {string} query.ref reference name (branch/tag/SHA)
+     * @param {number} [query.perPage] items per page
+     * @param {number} [query.page] page number
      * @returns {Promise<import('./adapter').CommitHistoryPage>} ページ情報を返します
      */
     listCommits(query: {
@@ -98,7 +101,8 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     private _makeRepoMetadata;
     /**
      * List branches via GitHub API and map to BranchListPage.
-      * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
+     * @param {import('../virtualfs/types.ts').BranchListQuery} [query] query parameters
+     * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
      */
     listBranches(query?: import('../virtualfs/types.ts').BranchListQuery): Promise<{
         items: {
@@ -122,15 +126,15 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     private _mapBranchItems;
     /**
      * 参照を更新します。
-     * @param {string} ref 参照名（例: heads/main）
+     * @param {string} reference 参照名（例: 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
+     * @param {string} branchName branch name to create
+     * @param {string} 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>;
@@ -149,8 +153,8 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     getCommitTreeSha(commitSha: string): Promise<string>;
     /**
      * 指定 ref の先頭コミット SHA を取得します。
-     * @param ref 例: `heads/main`
-      * @returns {Promise<string>} 参照先のコミット SHA
+     * @param {string} reference 䉶: `heads/main`
+     * @returns {Promise<string>} 参照先のコミット SHA
      */
     getRef(reference: string): Promise<string>;
     /**
@@ -235,6 +239,7 @@ export declare class GitHubAdapter extends AbstractGitAdapter implements GitAdap
     /**
      * Decode a base64 string into UTF-8 text. Uses global Buffer when available,
      * falls back to atob/TextDecoder for browsers.
+     * @param {string} safe base64 string to decode
      * @returns {string} decoded UTF-8 string
      */
     private _decodeBase64ToString;

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

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

package/dist/git/gitlabAdapter.d.ts

@@ -1,6 +1,6 @@
 import { GitAdapter } from './adapter.ts';
 import AbstractGitAdapter from './abstractAdapter.ts';
-type GLOptions = {
+export type GLOptions = {
     projectId: string;
     token: string;
     host?: string;
@@ -15,12 +15,15 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private projectMetadata;
     /**
      * GitLabAdapter を初期化します。
-     * @param {GLOpts} opts 設定オブジェクト
+     * @param {GLOptions} options 設定オブジェクト
      */
     constructor(options: GLOptions);
     /**
      * List commits for a ref (GitLab commits API)
-     * @param {{ref:string,perPage?:number,page?:number}} query
+     * @param {Object} query query parameters
+     * @param {string} query.ref reference name
+     * @param {number} [query.perPage] items per page
+     * @param {number} [query.page] page number
      * @returns {Promise<import('./adapter').CommitHistoryPage>} ページ情報を返します
      */
     listCommits(query: {
@@ -46,6 +49,7 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private _parseJsonArray;
     /**
      * GitLab のページングヘッダを解析します（x-next-page / x-total-pages）。
+     * @param {Response} resp HTTP レスポンス
      * @returns {{nextPage?: number, lastPage?: number}} ページ番号情報
      */
     private _parsePagingHeaders;
@@ -78,9 +82,9 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     createCommit(message: string, parentSha: string, _treeSha: string): Promise<any>;
     /**
      * リファレンス更新は不要なため noop 実装です。
-     * @param {string} _ref ref 名
+     * @param {string} _reference ref 名
      * @param {string} _commitSha コミット SHA
-     * @param {boolean} [_force]
+     * @param {boolean} [_force] 強制フラグ
      * @returns {Promise<void>}
      */
     updateRef(_reference: string, _commitSha: string, _force?: boolean): Promise<void>;
@@ -88,7 +92,8 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * actions を用いて GitLab のコミット API を呼び出します。
      * @param {string} branch ブランチ名
      * @param {string} message コミットメッセージ
-     * @param {{type:string,path:string,content?:string}[]} changes 変更一覧
+     * @param {Array<{type:string,path:string,content?:string}>} changes 変更一覧
+     * @param {string} [expectedParentSha] 下発コミット SHA
      * @returns {Promise<any>} コミット応答（id など）
      */
     createCommitWithActions(branch: string, message: string, changes: Array<{
@@ -109,6 +114,7 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private _makeProjectMetadata;
     /**
      * List branches via GitLab API and map to BranchListPage.
+     * @param {import('../virtualfs/types.ts').BranchListQuery} [query] query parameters
      * @returns {Promise<{items:any[],nextPage?:number,lastPage?:number}>}
      */
     listBranches(query?: import('../virtualfs/types.ts').BranchListQuery): Promise<{
@@ -126,11 +132,18 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     }>;
     /**
      * 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
+     * @param {string} branchName name of branch to create
+     * @param {string} 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>;
+    /**
+     * Extract SHA from commit response text.
+     * @param {string} text response text
+     * @param {string} fallback fallback SHA value
+     * @returns {string} extracted SHA or fallback
+     */
+    private _extractShaFromCommitResponseText;
     /**
      * Normalize common createBranch error messages into thrown Errors.
      * @param {string} message error message text
@@ -147,6 +160,7 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private _mapBranchItems;
     /**
      * Convert change descriptors to GitLab API actions
+     * @param {Array<{type:string,path:string,content?:string}>} changes change descriptors
      * @returns {Array<any>} API-compatible actions array
      */
     private createActions;
@@ -179,6 +193,9 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     private _waitAttempt;
     /**
      * Prepare JSON body for commit API call.
+     * @param {string} branch branch name
+     * @param {string} message commit message
+     * @param {any[]} actions commit actions
      * @returns {string} JSON body
      */
     private _prepareCommitBody;
@@ -192,6 +209,7 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
     /**
      * リポジトリのスナップショットを取得します。
      * @param {string} branch ブランチ名 (default: 'main')
+     * @param {number} concurrency fetch concurrency level
      * @returns {Promise<{headSha:string,shas:Record<string,string>,fetchContent:(paths:string[])=>Promise<Record<string,string>>}>}
      */
     fetchSnapshot(branch?: string, concurrency?: number): Promise<any>;
@@ -201,8 +219,15 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<string>} head SHA or branch
      */
     private _determineHeadSha;
+    /**
+     * Safely fetch branch head SHA, returning null on failure.
+     * @param {string} branch branch name
+     * @returns {Promise<string|null>} head SHA or null
+     */
+    private _safeGetBranchHead;
     /**
      * Fetch repository tree and build shas map and fileSet.
+     * Paginates through all pages using offset-based pagination (per_page=100).
      * @param {string} branch branch name
      * @returns {Promise<{shas:Record<string,string>,fileSet:Set<string>}>}
      */
@@ -224,6 +249,7 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @param {Record<string,string>} snapshot snapshot map
      * @param {string} p file path
      * @param {string} branch branch
+     * @param {AbortSignal} [signal] optional abort signal
      * @returns {Promise<string|null>} file content or null
      */
     private _fetchFileContentForPath;
@@ -231,11 +257,13 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * Fetch raw file content from GitLab; return null on failure.
      * @param {string} path file path
      * @param {string} branch branch name
+     * @param {AbortSignal} [signal] optional abort signal
      * @returns {Promise<string|null>} file content or null
      */
     private _fetchFileRaw;
     /**
      * Build shas map and fileSet from tree entries
+     * @param {any[]} files tree file entries
      * @returns {{shas:Record<string,string>,fileSet:Set<string>}}
      */
     private _buildShasAndFileSet;
@@ -254,6 +282,13 @@ export declare class GitLabAdapter extends AbstractGitAdapter implements GitAdap
      * @returns {Promise<string|null>} resolved sha or null
      */
     private _runResolvers;
+    /**
+     * Try running a single resolver, returning null on failure.
+     * @param {Function} r resolver function
+     * @param {string} reference commit-ish to resolve
+     * @returns {Promise<string|null>} resolved sha or null
+     */
+    private _tryRunResolver;
     /**
      * Try to resolve a branch name to its commit SHA.
      * @param {string} reference branch name

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

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

package/dist/index.d.ts

@@ -5,4 +5,11 @@ 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';
+export type { IndexFile, AdapterMeta, AdapterOptions, AdapterOptionsBase, GitHubAdapterOptions, GitLabAdapterOptions, CommitInput, BranchListQuery, BranchListPage, RepositoryMetadata, CreateBranchInput, CreateBranchResult, IndexEntry, BranchInfo, Change as VfsChange, FileState } from './virtualfs/types.ts';
+export type { StorageBackend, StorageBackendConstructor, Segment } from './virtualfs/storageBackend.ts';
+export type { Logger } from './git/abstractAdapter.ts';
+export type { CommitHistoryQuery, CommitHistoryPage, CommitSummary, CommitResult, GitAdapter, Change as GitChange } from './git/adapter.ts';
+export type { GHOptions } from './git/githubAdapter.ts';
+export type { GLOptions } from './git/gitlabAdapter.ts';
+export type { RemoteSnapshotDescriptor } 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,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"}
+{"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;AAGlD,YAAY,EAAE,SAAS,EAAE,WAAW,EAAE,cAAc,EAAE,kBAAkB,EAAE,oBAAoB,EAAE,oBAAoB,EAAE,WAAW,EAAE,eAAe,EAAE,cAAc,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,kBAAkB,EAAE,UAAU,EAAE,UAAU,EAAE,MAAM,IAAI,SAAS,EAAE,SAAS,EAAE,MAAM,sBAAsB,CAAA;AACnT,YAAY,EAAE,cAAc,EAAE,yBAAyB,EAAE,OAAO,EAAE,MAAM,+BAA+B,CAAA;AACvG,YAAY,EAAE,MAAM,EAAE,MAAM,0BAA0B,CAAA;AACtD,YAAY,EAAE,kBAAkB,EAAE,iBAAiB,EAAE,aAAa,EAAE,YAAY,EAAE,UAAU,EAAE,MAAM,IAAI,SAAS,EAAE,MAAM,kBAAkB,CAAA;AAC3I,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,SAAS,EAAE,MAAM,wBAAwB,CAAA;AACvD,YAAY,EAAE,wBAAwB,EAAE,MAAM,0BAA0B,CAAA"}