@feng0531/dsh-vcs 0.3.56 → 0.3.59

package/git-history.mjs

@@ -15,6 +15,17 @@ export function historySearchArgs(search){
  return {args,paths};
 }
 // Each line-porcelain record carries its own metadata; never interpret filename as an access path.
+export function decodeBlamePath(value){
+ if(!value.startsWith('"'))return value;
+ if(!value.endsWith('"'))throw Error('Invalid quoted blame path');
+ const bytes=[];const escapes={a:7,b:8,t:9,n:10,v:11,f:12,r:13,'"':34,'\\':92};
+ for(let i=1;i<value.length-1;i++){
+  if(value[i]!=='\\'){bytes.push(...Buffer.from(value[i],'utf8'));continue;}
+  const c=value[++i];if(Object.hasOwn(escapes,c)){bytes.push(escapes[c]);continue;}
+  const octal=value.slice(i,i+3);if(!/^[0-3][0-7]{2}$/.test(octal))throw Error('Invalid blame path escape');bytes.push(parseInt(octal,8));i+=2;
+ }
+ return new TextDecoder('utf-8',{fatal:true}).decode(Uint8Array.from(bytes));
+}
 export function parseBlame(text,maxLines=500){
  if(typeof text!=='string'||Buffer.byteLength(text,'utf8')>2*1024*1024)throw new Error('Invalid blame output size');
  if(!Number.isInteger(maxLines)||maxLines<1||maxLines>500)throw new Error('Invalid blame line limit');
@@ -35,7 +46,7 @@ export function parseBlame(text,maxLines=500){
   }
   if(i===fields.length||!['author','author-time','author-tz','summary','filename'].every(k=>Object.hasOwn(metadata,k)))throw new Error('Incomplete blame record');
   if(!/^-?[0-9]+$/.test(metadata['author-time'])||!Number.isSafeInteger(Number(metadata['author-time']))||! /^[+-][0-9]{4}$/.test(metadata['author-tz']))throw new Error('Invalid blame timestamp');
-  rows.push({commit:header[1],originalLine,line,author:metadata.author,authorTime:Number(metadata['author-time']),authorTimezone:metadata['author-tz'],summary:metadata.summary,text:fields[i++].slice(1)});
+  rows.push({commit:header[1],originalLine,line,author:metadata.author,authorTime:Number(metadata['author-time']),authorTimezone:metadata['author-tz'],summary:metadata.summary,path:decodeBlamePath(metadata.filename),text:fields[i++].slice(1)});
   if(rows.length>maxLines)throw new Error('Blame line limit exceeded');
  }
  return rows;

package/index.mjs

@@ -25,7 +25,7 @@ const rediscover = () => Object.assign(new Error('Repository authorization is mi
 import {historySearchArgs} from './git-history.mjs';
 function validatePayload(endpoint, payload) {
   if (!payload || typeof payload !== 'object' || Array.isArray(payload)) throw invalid('An object payload is required.');
-  const fields = endpoint==='vcs/tree-file'?['sessionId','repositoryId','commit','path'] : endpoint==='vcs/references'?['sessionId','repositoryId'] : endpoint==='vcs/commit-image'?['sessionId','repositoryId','commit','parentIndex','id','side'] : endpoint==='vcs/tree'?['sessionId','repositoryId','commit'] : endpoint==='vcs/file-history'?['sessionId','repositoryId','commit','parentIndex','id','offset','limit','follow'] : ['vcs/revision-changes','vcs/revision-compare'].includes(endpoint) ? ['sessionId','repositoryId','base','target',...(endpoint==='vcs/revision-compare'?['id']:[])] : ['vcs/commit-compare','vcs/blame'].includes(endpoint) ? ['sessionId','repositoryId','commit','parentIndex','id'] : endpoint === 'vcs/commit' ? ['sessionId','repositoryId','commit','parentIndex'] : endpoint === 'vcs/history' ? ['sessionId','repositoryId','snapshot','offset','limit','search'] : endpoint === 'vcs/repositories' ? ['sessionId', 'subdirectory'] : ['sessionId', 'repositoryId', 'mode', ...(endpoint === 'vcs/compare' ? ['id'] : [])];
+  const fields = endpoint==='vcs/workspace-image'?['sessionId','repositoryId','mode','id','side']:endpoint==='vcs/revision-image'?['sessionId','repositoryId','base','target','id','side'] : endpoint==='vcs/tree-file'?['sessionId','repositoryId','commit','path'] : endpoint==='vcs/references'?['sessionId','repositoryId'] : endpoint==='vcs/commit-image'?['sessionId','repositoryId','commit','parentIndex','id','side'] : endpoint==='vcs/tree'?['sessionId','repositoryId','commit'] : endpoint==='vcs/file-history'?['sessionId','repositoryId','commit','parentIndex','id','offset','limit','follow'] : ['vcs/revision-changes','vcs/revision-compare','vcs/revision-image'].includes(endpoint) ? ['sessionId','repositoryId','base','target',...(endpoint==='vcs/revision-compare'?['id']:[])] : ['vcs/commit-compare','vcs/blame'].includes(endpoint) ? ['sessionId','repositoryId','commit','parentIndex','id',...(endpoint==='vcs/blame'?['startLine','lineLimit']:[])] : endpoint === 'vcs/commit' ? ['sessionId','repositoryId','commit','parentIndex'] : endpoint === 'vcs/history' ? ['sessionId','repositoryId','snapshot','offset','limit','search'] : endpoint === 'vcs/repositories' ? ['sessionId', 'subdirectory'] : ['sessionId', 'repositoryId', 'mode', ...(endpoint === 'vcs/compare' ? ['id'] : [])];
   if (Object.keys(payload).some(key => !fields.includes(key))) throw invalid('Only Session-addressed repository requests are supported; unknown payload field.');
   if (endpoint === 'vcs/repositories') {
     if (payload.subdirectory !== undefined) {
@@ -35,16 +35,17 @@ function validatePayload(endpoint, payload) {
   } else {
     if (typeof payload.repositoryId !== 'string' || !payload.repositoryId || payload.repositoryId.length > 1024) throw invalid('A discovered repositoryId is required.');
     if(endpoint==='vcs/tree-file'&&(typeof payload.path!=='string'||!payload.path||payload.path.length>32768||payload.path.includes('\0')||payload.path.startsWith('/')||payload.path.split('/').some(part=>!part||part==='.'||part==='..')))throw invalid('Invalid historical file path.');
-    if(endpoint==='vcs/commit-image'&&payload.side!==undefined&&!['left','right'].includes(payload.side))throw invalid('Invalid image side.');
-    if(['vcs/revision-changes','vcs/revision-compare'].includes(endpoint)){
+    if(['vcs/commit-image','vcs/revision-image','vcs/workspace-image'].includes(endpoint)&&payload.side!==undefined&&!['left','right'].includes(payload.side))throw invalid('Invalid image side.');
+    if(['vcs/revision-changes','vcs/revision-compare','vcs/revision-image'].includes(endpoint)){
       for(const oid of [payload.base,payload.target])if(typeof oid!=='string'||!/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(oid))throw invalid('Invalid revision commit id.');
-      if(endpoint==='vcs/revision-compare'&&(typeof payload.id!=='string'||!/^[a-f0-9]{64}$/.test(payload.id)))throw invalid('Invalid revision change id.');
+      if(['vcs/revision-compare','vcs/revision-image'].includes(endpoint)&&(typeof payload.id!=='string'||!/^[a-f0-9]{64}$/.test(payload.id)))throw invalid('Invalid revision change id.');
     }
     if(['vcs/commit-compare','vcs/file-history','vcs/blame','vcs/commit-image'].includes(endpoint)&&(typeof payload.id!=='string'||!/^[a-f0-9]{64}$/.test(payload.id)))throw invalid('Invalid historical change id.');
     if(['vcs/commit','vcs/commit-compare','vcs/file-history','vcs/blame','vcs/tree','vcs/tree-file','vcs/commit-image'].includes(endpoint)){
       if(typeof payload.commit!=='string'||!/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(payload.commit))throw invalid('Invalid commit id.');
       if(payload.parentIndex!==undefined&&(!Number.isInteger(payload.parentIndex)||payload.parentIndex<0||payload.parentIndex>100))throw invalid('Invalid parent index.');
     }
+    if(endpoint==='vcs/blame'&&((payload.startLine!==undefined&&(!Number.isInteger(payload.startLine)||payload.startLine<1||payload.startLine>100001))||(payload.lineLimit!==undefined&&(!Number.isInteger(payload.lineLimit)||payload.lineLimit<1||payload.lineLimit>500))))throw invalid('Invalid blame line window.');
     if(endpoint==='vcs/file-history'&&payload.follow!==undefined&&typeof payload.follow!=='boolean')throw invalid('Invalid rename follow mode.');
     if(endpoint==='vcs/history'){try{historySearchArgs(payload.search);}catch{throw invalid('Invalid history search.');}}
     if(['vcs/history','vcs/file-history'].includes(endpoint)){
@@ -52,8 +53,9 @@ function validatePayload(endpoint, payload) {
       if(payload.snapshot!==undefined&&(typeof payload.snapshot!=='string'||!/^(?:[a-f0-9]{40}|[a-f0-9]{64})$/.test(payload.snapshot)))throw invalid('Invalid history snapshot.');
       if(!Number.isInteger(payload.offset??0)||(payload.offset??0)<0||(payload.offset??0)>10000||!Number.isInteger(payload.limit??50)||(payload.limit??50)<1||(payload.limit??50)>100)throw invalid('Invalid history pagination.');
     }
+    if(endpoint==='vcs/workspace-image'&&(typeof payload.id!=='string'||!/^[a-f0-9]{64}$/.test(payload.id)))throw invalid('Invalid workspace image change id.');
     if (!['all', 'unstaged', 'staged'].includes(payload.mode ?? 'all')) throw invalid('Unsupported comparison mode.');
-    if (endpoint === 'vcs/compare' && (typeof payload.id !== 'string' || !payload.id || payload.id.length > 32768)) throw invalid('A change id is required.');
+    if (['vcs/compare','vcs/workspace-image'].includes(endpoint) && (typeof payload.id !== 'string' || !payload.id || payload.id.length > 32768)) throw invalid('A change id is required.');
   }
 }
 
@@ -73,7 +75,7 @@ export function createHandler(ctx, api = adapter, maxActive = 4, { now = Date.no
     if (current(sessionId, latest) !== entry || latest !== cwd) throw rediscover();
   }
   return async (endpoint, payload, signal) => {
-    if (!['vcs/repositories', 'vcs/status', 'vcs/compare', 'vcs/history', 'vcs/commit', 'vcs/commit-compare', 'vcs/revision-changes', 'vcs/revision-compare', 'vcs/file-history', 'vcs/blame', 'vcs/tree', 'vcs/tree-file', 'vcs/commit-image', 'vcs/references'].includes(endpoint)) return failure('vcs/not-found', 'Unknown VCS endpoint.');
+    if (!['vcs/repositories', 'vcs/status', 'vcs/compare', 'vcs/history', 'vcs/commit', 'vcs/commit-compare', 'vcs/revision-changes', 'vcs/revision-compare', 'vcs/file-history', 'vcs/blame', 'vcs/tree', 'vcs/tree-file', 'vcs/commit-image', 'vcs/revision-image', 'vcs/workspace-image', 'vcs/references'].includes(endpoint)) return failure('vcs/not-found', 'Unknown VCS endpoint.');
     if (active >= maxActive) return failure('vcs/busy', 'Too many VCS requests. Please retry.');
     active++;
     let imageSlot=false;
@@ -119,12 +121,16 @@ export function createHandler(ctx, api = adapter, maxActive = 4, { now = Date.no
       if (repository.type === 'svn' && mode !== 'all') throw invalid('SVN supports only all mode.');
       // Both adapter operations revalidate the canonical root; comparison also validates
       // the change ID against fresh status, so do not duplicate a full status scan here.
-      if(['vcs/history','vcs/commit','vcs/commit-compare','vcs/revision-changes','vcs/revision-compare','vcs/file-history','vcs/blame','vcs/tree','vcs/tree-file','vcs/commit-image','vcs/references'].includes(endpoint)&&repository.type!=='git')throw invalid('History currently supports Git only.');
-      if(endpoint==='vcs/commit-image'){
+      if(['vcs/history','vcs/commit','vcs/commit-compare','vcs/revision-changes','vcs/revision-compare','vcs/file-history','vcs/blame','vcs/tree','vcs/tree-file','vcs/commit-image','vcs/revision-image','vcs/workspace-image','vcs/references'].includes(endpoint)&&repository.type!=='git')throw invalid('History currently supports Git only.');
+      if(['vcs/commit-image','vcs/revision-image','vcs/workspace-image'].includes(endpoint)){
         if(activeImages>=2)return failure('vcs/busy','Too many image requests. Please retry.');
         activeImages++;imageSlot=true;
       }
-      const value = endpoint === 'vcs/references'
+      const value = endpoint === 'vcs/workspace-image'
+        ? await api.getWorkspaceImage({...repository},{mode,id:payload.id,side:payload.side??'right',signal})
+        : endpoint === 'vcs/revision-image'
+        ? await api.getRevisionImage({...repository},{base:payload.base,target:payload.target,id:payload.id,side:payload.side??'right',signal})
+        : endpoint === 'vcs/references'
         ? await api.listReferences({...repository},{signal})
         : endpoint === 'vcs/commit-image'
         ? await api.getCommitImage({...repository},{commit:payload.commit,parentIndex:payload.parentIndex??0,id:payload.id,side:payload.side??'right',signal})
@@ -133,7 +139,7 @@ export function createHandler(ctx, api = adapter, maxActive = 4, { now = Date.no
         : endpoint === 'vcs/tree'
         ? await api.getHistoricalTree({...repository},{commit:payload.commit,signal})
         : endpoint === 'vcs/blame'
-        ? await api.getFileBlame({...repository},{commit:payload.commit,parentIndex:payload.parentIndex??0,id:payload.id,signal})
+        ? await api.getFileBlame({...repository},{commit:payload.commit,parentIndex:payload.parentIndex??0,id:payload.id,...(payload.startLine!==undefined?{startLine:payload.startLine}:{}),...(payload.lineLimit!==undefined?{lineLimit:payload.lineLimit}:{}),signal})
         : endpoint === 'vcs/file-history'
         ? await api.listFileHistory({...repository},{commit:payload.commit,parentIndex:payload.parentIndex??0,id:payload.id,offset:payload.offset??0,limit:payload.limit??50,...(payload.follow!==undefined?{follow:payload.follow}:{}),signal})
         : endpoint === 'vcs/revision-changes'

package/package.json

@@ -1,6 +1,6 @@
 {
   "name": "@feng0531/dsh-vcs",
-  "version": "0.3.56",
+  "version": "0.3.59",
   "private": false,
   "publishConfig": { "access": "public", "registry": "https://registry.npmjs.org/" },
   "type": "module",

package/vcs.mjs

@@ -2,6 +2,7 @@ import {preparePng} from './image-preview.mjs';
 import { spawn } from 'node:child_process';
 import {parseHistory,parseFollowHistory,HISTORY_FORMAT,historyPage,historySearchArgs,parseBlame,parseReferences,REFS_FORMAT} from './git-history.mjs';
 import * as fs from 'node:fs/promises';
+import {constants as fileFlags} from 'node:fs';
 import path from 'node:path';
 import { createHash } from 'node:crypto';
 import { XMLParser, XMLValidator } from 'fast-xml-parser';
@@ -322,6 +323,9 @@ export async function getCommitImage(repo,{commit,parentIndex=0,id,side='right',
  if(!entry)throw new Error('Change is not part of selected commit');
  const revision=side==='left'?details.parent:commit,file=side==='left'?(entry.oldPath||entry.path):entry.path;
  if(!revision||(side==='left'&&entry.status==='added')||(side==='right'&&entry.status==='deleted'))return {commit:revision,path:file,absent:true};
+ return historicalImage(repo,revision,file,signal);
+}
+async function historicalImage(repo,revision,file,signal){
  const listing=(await git(repo.root,['--literal-pathspecs','ls-tree','-z',revision,'--',file],MAX_TEXT,{signal})).toString('utf8');
  const record=listing.split(String.fromCharCode(0)).find(row=>row.slice(row.indexOf('\t')+1)===file);
  if(!record)throw new Error('Historical path missing');
@@ -331,21 +335,71 @@ export async function getCommitImage(repo,{commit,parentIndex=0,id,side='right',
  const {data,...metadata}=await preparePng(raw,{signal});
  return {commit:revision,path:file,oid,...metadata,base64:data.toString('base64')};
 }
-export async function getFileBlame(repo,{commit,parentIndex=0,id,signal}={}){
+async function workspacePng(buffer,signal){const {data,...metadata}=await preparePng(buffer,{signal});return {...metadata,base64:data.toString('base64')};}
+// Workspace image reads use immutable HEAD/index blobs and a checked regular-file handle.
+export async function getWorkspaceImage(repo,{mode='all',id,side='right',signal}={}){
+ if(typeof id!=='string'||!/^[a-f0-9]{64}$/.test(id)||!['left','right'].includes(side))throw Error('Invalid workspace image selection');
+ repo=await checkedRepo(repo,signal);if(repo.type!=='git')throw Error('Workspace PNG supports Git only');modeFor(repo,mode);
+ const entry=(await changes(repo,mode)).find(row=>row.id===id);if(!entry)throw Error('Change no longer exists; refresh repository status.');
+ if(entry.status==='conflicted')throw Error('Conflicted images are not supported');
+ const head=async()=>{try{return (await git(repo.root,['rev-parse','--verify','HEAD'],MAX_TEXT,{signal})).toString('utf8').trim();}catch(e){if(e.code==='VCS_COMMAND')return null;throw e;}};
+ const revision=await head();const index=await git(repo.root,['--literal-pathspecs','ls-files','--stage','-z','--',entry.path],MAX_TEXT,{signal});
+ const file=side==='left'&&mode!=='unstaged'?(entry.oldPath||entry.path):entry.path;
+ let result,verifyWorking;
+ const absent=()=>({path:file,commit:null,absent:true});
+ const readIndex=async()=>{
+  const rows=index.toString('utf8').split('\0').filter(Boolean);if(!rows.length)return absent();
+  if(rows.length!==1)throw Error('Unmerged index image');const match=/^(100644|100755) ([a-f0-9]{40}|[a-f0-9]{64}) 0\t/.exec(rows[0]);if(!match)throw Error('Image preview requires a regular file');
+  const buffer=await git(repo.root,['cat-file','blob',match[2]],MAX_TEXT,{signal});return {path:file,commit:'Index',...await workspacePng(buffer,signal)};
+ };
+ if(side==='left'){
+  if(entry.indexStatus==='?'||(mode==='unstaged'&&entry.indexStatus==='D')||(mode!=='unstaged'&&(!revision||['A','C'].includes(entry.indexStatus))))result=absent();
+  else result=mode==='unstaged'?await readIndex():await historicalImage(repo,revision,file,signal);
+ }else if(mode==='staged')result=entry.indexStatus==='D'?absent():await readIndex();
+ else{
+  const target=await confined(repo.root,file);let component=repo.root;for(const part of path.relative(repo.root,target).split(path.sep)){component=path.join(component,part);try{if((await fs.lstat(component)).isSymbolicLink())throw Error('Workspace image links are not supported');}catch(e){if(e.code!=='ENOENT')throw e;}}let before;try{before=await fs.lstat(target);}catch(e){if(e.code!=='ENOENT')throw e;}
+  if(!before)result=absent();else{
+   if(!before.isFile()||before.isSymbolicLink())throw Error('Image preview requires a regular file');if(before.size>MAX_TEXT)throw Error('Image exceeds 2 MiB limit');
+   const handle=await fs.open(target,fileFlags.O_RDONLY|(fileFlags.O_NOFOLLOW||0));try{
+    const fingerprint=s=>JSON.stringify([s.dev,s.ino,s.size,s.mtimeMs,s.ctimeMs]);const opened=await handle.stat();if(!opened.isFile()||fingerprint(opened)!==fingerprint(before))throw Error('Working image changed during read');
+    const buffer=Buffer.alloc(MAX_TEXT+1);const {bytesRead}=await handle.read(buffer,0,buffer.length,0);signal?.throwIfAborted();const after=await handle.stat(),named=await fs.lstat(target);await confined(repo.root,file);
+    if(named.isSymbolicLink()||fingerprint(after)!==fingerprint(before)||fingerprint(named)!==fingerprint(before)||bytesRead!==before.size)throw Error('Working image changed during read');
+    result={path:file,commit:'Working tree',...await workspacePng(buffer.subarray(0,bytesRead),signal)};
+    verifyWorking=async()=>{await confined(repo.root,file);const validated=await fs.lstat(target);if(validated.isSymbolicLink()||fingerprint(validated)!==fingerprint(before))throw Error('Working image changed during validation');};await verifyWorking();
+   }finally{await handle.close();}
+  }
+ }
+ signal?.throwIfAborted();const afterIndex=await git(repo.root,['--literal-pathspecs','ls-files','--stage','-z','--',entry.path],MAX_TEXT,{signal});
+ if(!index.equals(afterIndex)||revision!==await head()||!(await changes(repo,mode)).some(row=>row.id===id))throw Error('Workspace image selection changed; refresh repository status.');
+ await verifyWorking?.();signal?.throwIfAborted();return result;
+}
+export async function getRevisionImage(repo,{base,target,id,side='right',signal}={}){
+ if(!['left','right'].includes(side))throw Error('Invalid image side');
+ if(typeof id!=='string'||!/^[a-f0-9]{64}$/.test(id))throw Error('Invalid revision change id');
+ const details=await getRevisionChanges(repo,{base,target,signal}),entry=details.changes.find(row=>row.id===id);
+ if(!entry)throw Error('Change is not part of selected revision pair');
+ const revision=side==='left'?base:target,file=side==='left'?(entry.oldPath||entry.path):entry.path;
+ if((side==='left'&&entry.status==='added')||(side==='right'&&entry.status==='deleted'))return {commit:revision,path:file,absent:true};
+ repo=await checkedRepo(repo,signal);return historicalImage(repo,revision,file,signal);
+}
+export async function getFileBlame(repo,{commit,parentIndex=0,id,startLine=1,lineLimit=500,signal}={}){
+ if(!Number.isInteger(startLine)||startLine<1||startLine>100001||!Number.isInteger(lineLimit)||lineLimit<1||lineLimit>500)throw Error('Invalid blame line window');
  if(typeof id!=='string'||!/^[a-f0-9]{64}$/.test(id))throw new Error('Invalid historical change id');
  const details=await commitDetails(repo,{commit,parentIndex,signal});
  const entry=details.changes.find(row=>row.id===id);if(!entry)throw new Error('Change is not part of selected commit');
- const result={commit,path:entry.path,lines:[],truncated:false};
+ const result={commit,path:entry.path,lines:[],truncated:false,startLine,nextLine:null};
  if(entry.status==='deleted')return {...result,notice:'File is deleted at this commit; blame unavailable.'};
  const blob=await historicalBlob(repo.root,commit,entry.path,signal);
  if(blob.notice||blob.binary||blob.encoding!=='UTF-8')return {...result,notice:blob.notice||'Blame supports UTF-8 regular text only.'};
  if(!blob.text)return result;
- const count=blob.text.split('\n').length-(blob.text.endsWith('\n')?1:0),limit=Math.min(count,500);
+ const count=blob.text.split('\n').length-(blob.text.endsWith('\n')?1:0);
+ if(startLine>count)return {...result,totalLines:count};
+ const endLine=Math.min(count,startLine+lineLimit-1),limit=endLine-startLine+1;
  let ignored;
  try{ignored=(await git(repo.root,['config','--null','--get-all','blame.ignoreRevsFile'],MAX_TEXT,{signal})).toString('utf8');}catch(e){if(e.code!=='VCS_COMMAND'||e.exitCode!==1)throw e;}
  if(ignored?.split(String.fromCharCode(0)).some(value=>value.length>0))return {...result,notice:'Blame unavailable while blame.ignoreRevsFile is configured; external revision files are not read.'};
- const output=await git(repo.root,['--literal-pathspecs','blame','--ignore-revs-file=','--line-porcelain','--no-textconv','--encoding=UTF-8','-L','1,'+limit,commit,'--',entry.path],MAX_TEXT,{signal});
- return {...result,lines:parseBlame(output.toString('utf8'),limit),truncated:count>limit};
+ const output=await git(repo.root,['--literal-pathspecs','blame','--ignore-revs-file=','--line-porcelain','--no-textconv','--encoding=UTF-8','-L',startLine+','+endLine,commit,'--',entry.path],MAX_TEXT,{signal});
+ return {...result,lines:parseBlame(output.toString('utf8'),limit),totalLines:count,nextLine:endLine<count&&endLine<100001?endLine+1:null,truncated:endLine<count};
 }
 export async function listFileHistory(repo,{commit,parentIndex=0,id,offset=0,limit=50,follow=false,signal}={}){
   if(!Number.isInteger(offset)||offset<0||offset>10000||!Number.isInteger(limit)||limit<1||limit>100)throw new Error('Invalid history pagination');